develop

.github/workflows/release.yml

@@ -58,6 +58,9 @@ jobs:
         working-directory: dist/
         run: sha256sum convctl-* > checksums.txt
 
+      - name: Generate discovery files
+        run: python3 scripts/generate-discovery.py
+
       - name: Attest binary provenance
         uses: actions/attest-build-provenance@v2
         with:
@@ -90,3 +93,5 @@ jobs:
           files: |
             dist/convctl-*
             dist/checksums.txt
+            public/llms.txt
+            public/.well-known/skills/index.json

CLAUDE.md

@@ -35,23 +35,27 @@ cd plugins/corezoid/mcp-server && npx @modelcontextprotocol/inspector go run . m
 plugins/corezoid/
   mcp-server/                     — Go MCP server source (starts automatically via .mcp.json)
   skills/
-    corezoid/                     — Main skill: platform overview, MCP tools, routing
-      SKILL.md
-      references/                 — Lookup documents (variables guide, env setup)
-    corezoid-init/                — Sub-skill: environment setup and workspace pull
-      SKILL.md
-    corezoid-create/              — Sub-skill: create a new process from scratch
-      SKILL.md
-    corezoid-edit/                — Sub-skill: modify an existing process
-      SKILL.md
-    corezoid-review/              — Sub-skill: audit and analyze a process
+    corezoid/                       — Main skill: platform overview, MCP tools, routing
       SKILL.md
+      references/                   — Lookup documents (variables guide, env setup)
+    corezoid-init/                  — Sub-skill: environment setup and workspace pull
+    corezoid-create/                — Sub-skill: create a new process from scratch
+    corezoid-edit/                  — Sub-skill: modify an existing process
+    corezoid-state-diagram-create/  — Sub-skill: create a new state diagram (conv_type "state") from scratch
+    corezoid-state-diagram-edit/    — Sub-skill: modify an existing state diagram
+    corezoid-review/                — Sub-skill: audit and analyze a single process
+    corezoid-project-review/        — Sub-skill: audit a whole project / multiple processes
+    corezoid-dashboard-manager/     — Sub-skill: create and edit Corezoid dashboards
+    corezoid-process-tech-writer/   — Sub-skill: generate technical documentation for processes
+    corezoid-access/                — Sub-skill: share processes/folders, manage groups/API keys
+    marketplace-publish-validation/ — Sub-skill: validation checklist for marketplace publishing
   docs/
     nodes/                        — Per-node-type documentation (24 node types)
     process/                      — Process structure, validation rules, error handling
+    state-diagrams/               — State diagram concepts, node structures, process interaction
     tasks/                        — Task metadata and examples
     node-structures.md            — JSON schemas for all node types (canonical reference)
-  samples/                        — Example .conv.json processes
+  samples/                        — Example .conv.json processes (state-diagrams/ holds state-diagram samples)
 ```
 
 ### How skills work

README.md

@@ -199,6 +199,7 @@ validation errors, and summarize what each process does.
 | `delete-task`       | Remove a task from a node                          |
 | `modify-task`       | Update task parameters                             |
 | `create-process`    | Create a new empty process in a folder             |
+| `create-state-diagram` | Create a new empty state diagram (conv_type "state") in a folder |
 | `create-folder`     | Create a new subfolder                             |
 | `create-alias`      | Create a short alias for a process                 |
 | `create-variable`   | Create a Corezoid environment variable             |
@@ -208,6 +209,21 @@ validation errors, and summarize what each process does.
 | `modify-chart`      | Modify an existing chart (full series replace)     |
 | `get-chart`         | Get a single chart with its series data            |
 | `set-dashboard-layout` | Save chart positions on a dashboard grid        |
+| `share-object`      | Grant or revoke access on a process/folder/stage/project for a user, API key or group (use privs="none" to revoke) |
+| `list-shares`       | List principals with access to a shared object     |
+| `create-group`      | Create a new user group (optional description)     |
+| `modify-group`      | Rename a group or update its description           |
+| `list-group-objects`| List processes currently shared with a group       |
+| `delete-group`      | Delete a user group (refuses by default if shares active; force=true to override) |
+| `add-to-group`      | Add a user or API key to a group                   |
+| `remove-from-group` | Remove a user or API key from a group              |
+| `list-groups`       | List user groups in the workspace                  |
+| `create-api-key`    | Create a new API key (secret written to ~/.corezoid/api-keys/, never printed in chat) |
+| `modify-api-key`    | Rename or re-describe an API key                   |
+| `delete-api-key`    | Delete an API key (invalidates secret immediately) |
+| `list-api-keys`     | List API keys in the workspace                     |
+| `find-principal`    | Resolve user / group / API-key name to obj_id      |
+| `invite-user`       | Invite an external email and share an object in one call |
 
 ## Architecture
 
@@ -220,8 +236,13 @@ Claude Code / Codex
         │                 create-process, create-folder, create-alias, create-variable
         ├── Tasks         run-task, list-node-tasks, list-task-history
         │                 modify-task, delete-task
-        └── Dashboards    create-dashboard, get-dashboard, add-chart,
-                          modify-chart, get-chart, set-dashboard-layout
+        ├── Dashboards    create-dashboard, get-dashboard, add-chart,
+        │                 modify-chart, get-chart, set-dashboard-layout
+        └── Access        share-object, list-shares,
+                          create-group, modify-group, delete-group, list-group-objects,
+                          add-to-group, remove-from-group, list-groups,
+                          create-api-key, modify-api-key, delete-api-key, list-api-keys,
+                          find-principal, invite-user
 ```
 
 ## Project structure