@wowok/agent-mcp 2.4.3 → 2.5.1

package/dist/schemas/project_operation.schema.json

@@ -20,17 +20,488 @@
             "cross_project_refs",
             "graph_stats",
             "save_graph",
-            "load_graph"
+            "load_graph",
+            "analyze_intent",
+            "aggregate_risks",
+            "generate_deployment_doc",
+            "trace_substeps"
           ],
-          "description": "Query/action to perform"
+          "description": "Action to perform. Two categories:\n1. Graph Query (10): list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.\n2. Project-Based Deployment 5-Stage (4): Call IN ORDER — analyze_intent (Stage 2) → aggregate_risks (Stage 3) → generate_deployment_doc (Stage 4) → trace_substeps (Stage 5). Each action's output includes `next_action` telling you which action to call next. Stage 1 (Project Naming) uses the `project` + `version` params."
         },
         "project": {
           "type": "string",
-          "description": "Project prefix (for list_objects)"
+          "description": "Project prefix (for list_objects and C1-C4 actions)"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v\\d+$",
+          "description": "Project version (e.g. 'v1'). Required for C1-C4 actions."
         },
         "object": {
           "type": "string",
           "description": "Object name or address (for dependencies / referenced_by / pre_publish_check)"
+        },
+        "user_intent": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000,
+          "description": "Natural-language business intent for analyze_intent (stage 2). Required when action='analyze_intent'."
+        },
+        "industry": {
+          "type": "string",
+          "enum": [
+            "general",
+            "retail",
+            "service",
+            "rental",
+            "freelance",
+            "education",
+            "travel",
+            "subscription",
+            "custom"
+          ],
+          "description": "Industry hint — drives template defaults. Used by analyze_intent and aggregate_risks."
+        },
+        "target_objects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Optional explicit target objects (entry_ids or object_type names) for analyze_intent."
+        },
+        "puzzles": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "puzzle": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Per-object puzzle snapshot. Shape varies per object_type — see knowledge/<obj>-puzzle.ts."
+              },
+              "completeness": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Completeness assessment from checkPuzzleCompleteness(). Shape varies per object."
+              },
+              "missing_dimensions": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Dimensions still missing for this object (e.g. ['A','B'])."
+              }
+            },
+            "required": [
+              "puzzle",
+              "completeness",
+              "missing_dimensions"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Per-object puzzle snapshots keyed by object_type. Required for aggregate_risks and generate_deployment_doc."
+        },
+        "severity_threshold": {
+          "type": "string",
+          "enum": [
+            "CRITICAL",
+            "HIGH",
+            "MEDIUM",
+            "LOW",
+            "INFO"
+          ],
+          "description": "Severity threshold for aggregate_risks. Risks at or above this level are flagged."
+        },
+        "user_confirmed_high_risks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "IDs of HIGH risks the user has already confirmed (suppressed in subsequent aggregate_risks)."
+        },
+        "business_intent": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "One-line business intent description for the deployment doc. Required when action='generate_deployment_doc'."
+        },
+        "author": {
+          "type": "string",
+          "description": "Optional author name for the deployment doc meta section."
+        },
+        "objects": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "entry_id": {
+                "type": "string",
+                "description": "Stable id '<object_type>:<name>'"
+              },
+              "object_type": {
+                "type": "string",
+                "enum": [
+                  "service",
+                  "machine",
+                  "guard",
+                  "permission",
+                  "reward",
+                  "arb",
+                  "progress",
+                  "treasury",
+                  "demand",
+                  "repository",
+                  "contact",
+                  "order",
+                  "allocation",
+                  "personal",
+                  "payment",
+                  "proof"
+                ]
+              },
+              "name": {
+                "type": "string"
+              },
+              "reused_from": {
+                "type": "string",
+                "description": "Existing on-chain address or local name if reused"
+              },
+              "publish_required": {
+                "type": "boolean",
+                "description": "Whether publish is required (only Service/Machine)"
+              },
+              "description": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "entry_id",
+              "object_type",
+              "name",
+              "publish_required"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Deployment objects for generate_deployment_doc."
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "from": {
+                "type": "string"
+              },
+              "to": {
+                "type": "string"
+              },
+              "edge_kind": {
+                "type": "string",
+                "enum": [
+                  "machine",
+                  "order_allocators",
+                  "arbitrations",
+                  "compensation_fund",
+                  "rewards",
+                  "buy_guard",
+                  "permission",
+                  "guard",
+                  "prev",
+                  "next",
+                  "forward",
+                  "parent",
+                  "service",
+                  "progress",
+                  "arbitration",
+                  "sub_order",
+                  "references"
+                ]
+              },
+              "field_path": {
+                "type": "string"
+              },
+              "required_at_publish": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "from",
+              "to",
+              "edge_kind",
+              "field_path",
+              "required_at_publish"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Dependency graph edges for generate_deployment_doc."
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step": {
+                "type": "integer",
+                "exclusiveMinimum": 0
+              },
+              "object_type": {
+                "$ref": "#/definitions/project_operation/properties/objects/items/properties/object_type"
+              },
+              "operation": {
+                "type": "string"
+              },
+              "substep_count": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "depends_on": {
+                "type": "array",
+                "items": {
+                  "type": "integer"
+                }
+              },
+              "entry_id": {
+                "type": "string"
+              },
+              "network_phase": {
+                "type": "string",
+                "enum": [
+                  "testnet",
+                  "mainnet",
+                  "both"
+                ]
+              }
+            },
+            "required": [
+              "step",
+              "object_type",
+              "operation",
+              "substep_count",
+              "depends_on",
+              "entry_id",
+              "network_phase"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Topological execution plan for generate_deployment_doc."
+        },
+        "scenarios": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "scenario_id": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              },
+              "primary_object": {
+                "type": "string"
+              },
+              "supporting_objects": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "test_step_refs": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "scenario_id",
+              "description",
+              "primary_object",
+              "supporting_objects"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Business scenarios for generate_deployment_doc §7."
+        },
+        "risk_status": {
+          "type": "string",
+          "enum": [
+            "RISK_PASSED",
+            "RISK_BLOCKED",
+            "RISK_PENDING_CONFIRM",
+            "RISK_CANCELLED"
+          ],
+          "description": "Risk status from aggregate_risks (for D-16 check)."
+        },
+        "risk_critical_count": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "CRITICAL risk count from aggregate_risks."
+        },
+        "risk_high_count": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "HIGH risk count from aggregate_risks."
+        },
+        "run_scanner": {
+          "type": "boolean",
+          "description": "Whether to run deployment-scanner validation after generating the doc. Defaults to true."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Target network for trace_substeps."
+        },
+        "substeps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step_id": {
+                "type": "string",
+                "pattern": "^T\\d+\\.\\d+$"
+              },
+              "parent_step": {
+                "type": "string",
+                "pattern": "^T\\d+$"
+              },
+              "object_type": {
+                "$ref": "#/definitions/project_operation/properties/objects/items/properties/object_type"
+              },
+              "entry_id": {
+                "type": "string"
+              },
+              "operation_type": {
+                "type": "string"
+              },
+              "network": {
+                "type": "string",
+                "enum": [
+                  "testnet",
+                  "mainnet"
+                ]
+              },
+              "input": {
+                "type": "object",
+                "properties": {
+                  "data": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "input_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "required": [
+                  "data",
+                  "input_refs"
+                ],
+                "additionalProperties": false
+              },
+              "output": {
+                "type": "object",
+                "properties": {
+                  "object_id": {
+                    "type": "string"
+                  },
+                  "tx_digest": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false
+              },
+              "timestamp": {
+                "type": "integer"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "PENDING",
+                  "SUCCESS",
+                  "FAILED",
+                  "SKIPPED"
+                ]
+              },
+              "failure_reason": {
+                "type": "string"
+              },
+              "dependencies": {
+                "type": "object",
+                "properties": {
+                  "input_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "output_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "substep_id": {
+                          "type": "string"
+                        },
+                        "field_path": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "substep_id",
+                        "field_path"
+                      ],
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "required": [
+                  "input_refs",
+                  "output_refs"
+                ],
+                "additionalProperties": false
+              },
+              "retry_info": {
+                "type": "object",
+                "properties": {
+                  "original_step_id": {
+                    "type": "string"
+                  },
+                  "retry_count": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "retry_reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "original_step_id",
+                  "retry_count",
+                  "retry_reason"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "step_id",
+              "parent_step",
+              "object_type",
+              "entry_id",
+              "operation_type",
+              "network",
+              "input",
+              "timestamp",
+              "status",
+              "dependencies"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Substep records for trace_substeps."
         }
       },
       "required": [