@wowok/agent-mcp 2.5.0 → 2.5.1

package/dist/tools/index.js

@@ -259,29 +259,53 @@ export const TOOL_REGISTRY = [
         name: "project_operation",
         handler: handleProjectOperation,
         config: {
-            title: "🗂️ Project - Namespace & Object Graph",
-            description: "Phase 2 project namespace service — manage and query the local object dependency graph (DAG) " +
-                "built on top of local_mark tags. No on-chain writes; all data comes from local marks tagged " +
+            title: "🗂️ Project - 5-Stage Deployment & Object Graph",
+            description: "Project-based deployment service — manage the local object dependency graph (DAG) AND guide users " +
+                "through the 5-stage project deployment workflow. All data comes from local marks tagged " +
                 "`project:<prefix>` (auto-injected by the ProjectService when enabled, default ON).\n\n" +
-                "Actions:\n" +
-                "  • list_projects — List all discovered projects (grouped by `project:<prefix>` tag) with object counts.\n" +
+                "═══════════════════════════════════════════════════════════════\n" +
+                "  PROJECT-BASED DEPLOYMENT — 5-STAGE WORKFLOW (C1-C4)\n" +
+                "═══════════════════════════════════════════════════════════════\n" +
+                "When a user wants to build/deploy a service, follow these 5 stages IN ORDER. " +
+                "Each stage's output tells you the next action to call:\n\n" +
+                "  Stage 1: Project Naming\n" +
+                "    → Use `project` + `version` params to name the project (e.g. myshop_v1).\n" +
+                "  Stage 2: Business Puzzle (action='analyze_intent')\n" +
+                "    → Input: user_intent (natural language), industry hint.\n" +
+                "    → Output: ODG (object dependency graph), puzzles, missing fields, next_step.\n" +
+                "    → Guide user to fill missing fields, then proceed to Stage 3.\n" +
+                "  Stage 3: Risk Calibration (action='aggregate_risks')\n" +
+                "    → Input: puzzles from Stage 2.\n" +
+                "    → Output: risk findings, can_proceed flag.\n" +
+                "    → CRITICAL risks block; HIGH/MEDIUM/LOW only warn. Fix CRITICAL before proceeding.\n" +
+                "  Stage 4: Deployment Doc (action='generate_deployment_doc')\n" +
+                "    → Input: objects, edges, steps (topological plan from Stage 2-3).\n" +
+                "    → Output: markdown deployment doc, D-01..D-18 scanner checks, can_proceed.\n" +
+                "    → 0 D-errors required before Stage 5.\n" +
+                "  Stage 5: Substep Trace (action='trace_substeps')\n" +
+                "    → Input: substeps (from deployment doc), network (testnet/mainnet).\n" +
+                "    → Output: coherence check, D-10 substep linkage, can_proceed.\n" +
+                "    → Execute each substep via onchain_operations, record outcomes.\n\n" +
+                "Correct object creation order (topological): Permission → Allocation → Guard → Machine → Service.\n" +
+                "All objects created as draft (publish=false) first; publish Machine before Service (last).\n\n" +
+                "═══════════════════════════════════════════════════════════════\n" +
+                "  GRAPH QUERY ACTIONS (10)\n" +
+                "═══════════════════════════════════════════════════════════════\n" +
+                "  • list_projects — List all discovered projects with object counts.\n" +
                 "  • list_objects — List objects in a project (requires `project` param).\n" +
-                "  • shareable — List objects tagged `shareable:true` (cross-project reusable: common Permission, 3rd-party Arb).\n" +
-                "  • dependencies — Trace forward dependencies of an object (BFS transitive closure + dangling refs).\n" +
+                "  • shareable — List cross-project reusable objects (common Permission, 3rd-party Arb).\n" +
+                "  • dependencies — Trace forward dependencies of an object (BFS + dangling refs).\n" +
                 "  • referenced_by — Reverse query: who references this object?\n" +
-                "  • pre_publish_check — Pre-publish sanity check for a service (dangling deps + cycles).\n" +
-                "  • cross_project_refs — Find edges that cross project boundaries.\n" +
+                "  • pre_publish_check — Pre-publish sanity check (dangling deps + cycles).\n" +
+                "  • cross_project_refs — Find edges crossing project boundaries.\n" +
                 "  • graph_stats — Graph statistics (node/edge counts, cycles, dangling deps).\n" +
-                "  • save_graph — Save the in-memory graph to ~/.wowok/project-graph.json (persist across sessions).\n" +
-                "  • load_graph — Load the graph from file (restore after restart).\n\n" +
-                "NOTE: The graph is in-memory by default. Use save_graph/load_graph for cross-session persistence " +
-                "(or toggle graph_persist via config_operation for auto-save). " +
-                "list_projects/shareable always query local_mark (persistent).\n\n" +
-                "💡 Schema hint: Use schema_query with action='get' and name='project_operation' to retrieve the exact parameter schema with all actions and field definitions.",
+                "  • save_graph — Save graph to ~/.wowok/project-graph.json.\n" +
+                "  • load_graph — Load graph from file (restore after restart).\n\n" +
+                "💡 Schema hint: Use schema_query with action='get' and name='project_operation' for exact field definitions.",
             inputSchema: ProjectOperationInputSchema,
             outputSchema: ProjectOperationOutputSchema,
-            annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-            _meta: createToolMeta("project", ["project", "namespace", "graph", "dag", "dependency", "reference", "organization"]),
+            annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+            _meta: createToolMeta("project", ["project", "namespace", "graph", "dag", "dependency", "reference", "organization", "deployment", "5-stage", "analyze_intent", "aggregate_risks", "deployment_doc", "trace_substeps", "puzzle", "risk", "odg"]),
         },
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",