@wowok/agent-mcp 2.5.5 → 2.6.1

package/dist/schemas/project_operation.output.json

@@ -122,6 +122,10 @@
                         "type": "number",
                         "description": "Number of objects in this project (from project_objects table)."
                       },
+                      "evaluationCount": {
+                        "type": "number",
+                        "description": "Number of stored evaluations for this project (from evaluations table)."
+                      },
                       "objectTypes": {
                         "type": "array",
                         "items": {
@@ -147,6 +151,7 @@
                       "updatedAt",
                       "metadata",
                       "objectCount",
+                      "evaluationCount",
                       "objectTypes"
                     ],
                     "additionalProperties": false
@@ -240,11 +245,102 @@
                   ],
                   "additionalProperties": false,
                   "description": "The created project."
+                },
+                "recommended_creation_order": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "step": {
+                        "type": "number",
+                        "description": "Step number (1-based)."
+                      },
+                      "object": {
+                        "type": "string",
+                        "description": "Object type to create (e.g. 'Permission', 'Service (unpublished)')."
+                      },
+                      "reason": {
+                        "type": "string",
+                        "description": "Why this step is here, including dependencies and irreversibility notes."
+                      },
+                      "required": {
+                        "type": "boolean",
+                        "description": "Whether this step is mandatory for a working deployment."
+                      }
+                    },
+                    "required": [
+                      "step",
+                      "object",
+                      "reason",
+                      "required"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Canonical deployment sequence satisfying dependency constraints. All industries share this base order; see IndustryMode.build_notes for industry-specific deviations."
+                },
+                "blueprint": {
+                  "type": "object",
+                  "properties": {
+                    "objects_count": {
+                      "type": "number",
+                      "description": "Number of draft objects created from the template."
+                    },
+                    "edges_count": {
+                      "type": "number",
+                      "description": "Number of graph edges from the template."
+                    },
+                    "industry_source": {
+                      "type": "string",
+                      "description": "Industry mode name that sourced the template."
+                    },
+                    "applied_template": {
+                      "type": "string",
+                      "description": "Template identifier applied."
+                    },
+                    "steps_count": {
+                      "type": "number",
+                      "description": "Number of deployment steps in the template."
+                    },
+                    "scenarios_count": {
+                      "type": "number",
+                      "description": "Number of scenarios in the template."
+                    },
+                    "key_risk": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "description": "Industry-specific key risk note (or null)."
+                    }
+                  },
+                  "required": [
+                    "objects_count",
+                    "edges_count",
+                    "industry_source",
+                    "applied_template",
+                    "steps_count",
+                    "scenarios_count"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Blueprint summary — present when industry template applied successfully. Objects have status='draft' and address='draft:<name>'."
+                },
+                "blueprint_warning": {
+                  "type": "string",
+                  "description": "Warning message — present when industry template application failed. Project is created without blueprint; use add_object to manually add objects."
+                },
+                "blueprint_skipped": {
+                  "type": "boolean",
+                  "description": "True when skip_templates=true was passed — no industry blueprint objects were created."
+                },
+                "hint": {
+                  "type": "string",
+                  "description": "User-facing hint — guides to next action (e.g. add_object, generate_deployment_doc)."
                 }
               },
               "required": [
                 "action",
-                "project"
+                "project",
+                "recommended_creation_order"
               ],
               "additionalProperties": false
             },
@@ -339,7 +435,7 @@
                       },
                       "objectAddress": {
                         "type": "string",
-                        "description": "On-chain object address (0x...)."
+                        "description": "On-chain object address (0x...) or 'draft:<name>' sentinel for blueprint objects."
                       },
                       "objectType": {
                         "type": [
@@ -357,12 +453,7 @@
                       },
                       "role": {
                         "type": "string",
-                        "enum": [
-                          "core",
-                          "dependency",
-                          "reference"
-                        ],
-                        "description": "Object role in project."
+                        "description": "Object role in project. Valid values: 'core' (the Service), 'dependency' (required binding), 'reference' (optional/auxiliary). Other values indicate data corruption — see objectGroups.other bucket."
                       },
                       "tags": {
                         "anyOf": [
@@ -586,12 +677,128 @@
                   "items": {
                     "$ref": "#/definitions/project_operation/properties/result/anyOf/2/properties/objects/items"
                   },
-                  "description": "Project objects (rigid relationships)."
+                  "description": "Project objects (rigid relationships). Flat list — use objectGroups for role-based navigation."
+                },
+                "objectGroups": {
+                  "type": "object",
+                  "properties": {
+                    "core": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/project_operation/properties/result/anyOf/2/properties/objects/items"
+                      },
+                      "description": "Core objects (the Service) — the primary deliverable of the project."
+                    },
+                    "dependency": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/project_operation/properties/result/anyOf/2/properties/objects/items"
+                      },
+                      "description": "Dependency objects (Permission, Machine, Guard, Allocation, Treasury, etc.) — required for the Service to function."
+                    },
+                    "reference": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/project_operation/properties/result/anyOf/2/properties/objects/items"
+                      },
+                      "description": "Reference objects (read-only or external) — tracked but not owned by this project."
+                    },
+                    "other": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/definitions/project_operation/properties/result/anyOf/2/properties/objects/items"
+                      },
+                      "description": "Objects with invalid or missing role (data corruption, legacy data). Grouped here for visibility — should normally be empty. Check server logs for warnings."
+                    },
+                    "stats": {
+                      "type": "object",
+                      "properties": {
+                        "total": {
+                          "type": "number",
+                          "description": "Total object count."
+                        },
+                        "core_count": {
+                          "type": "number",
+                          "description": "Number of core objects."
+                        },
+                        "dependency_count": {
+                          "type": "number",
+                          "description": "Number of dependency objects."
+                        },
+                        "reference_count": {
+                          "type": "number",
+                          "description": "Number of reference objects."
+                        },
+                        "other_count": {
+                          "type": "number",
+                          "description": "Number of objects with invalid/missing role (in 'other' bucket). Normally 0."
+                        },
+                        "by_type": {
+                          "type": "object",
+                          "additionalProperties": {
+                            "type": "number"
+                          },
+                          "description": "Object count grouped by objectType prefix (e.g. {'service': 1, 'permission': 1, 'guard': 5})."
+                        }
+                      },
+                      "required": [
+                        "total",
+                        "core_count",
+                        "dependency_count",
+                        "reference_count",
+                        "other_count",
+                        "by_type"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Aggregate counts for quick project sizing."
+                    }
+                  },
+                  "required": [
+                    "core",
+                    "dependency",
+                    "reference",
+                    "other",
+                    "stats"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Objects grouped by role (core/dependency/reference/other) for easier navigation. The 'other' bucket captures objects with invalid roles (H-05 fix). The flat `objects` array is preserved for backward compatibility."
                 },
                 "graphEdgeCount": {
                   "type": "number",
                   "description": "Number of persisted graph edges."
                 },
+                "serviceStatus": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "published": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "description": "Whether the on-chain Service is published (live). null = unknown / query failed."
+                        },
+                        "paused": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "description": "Whether the on-chain Service is paused (not accepting orders). null = unknown."
+                        }
+                      },
+                      "required": [
+                        "published",
+                        "paused"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "On-chain Service status (published / paused). Separate from the project's local lifecycle status. null if the project has no serviceAddress or the on-chain query failed."
+                },
                 "evaluations": {
                   "type": "array",
                   "items": {
@@ -622,6 +829,101 @@
                           "null"
                         ]
                       },
+                      "details": {
+                        "anyOf": [
+                          {
+                            "type": "object",
+                            "properties": {
+                              "criterionScores": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "name": {
+                                      "type": "string",
+                                      "description": "Criterion name (e.g. 'Service Published', 'Governance Present')."
+                                    },
+                                    "score": {
+                                      "type": "number",
+                                      "description": "Per-criterion score (0-100, higher = better)."
+                                    },
+                                    "weight": {
+                                      "type": "number",
+                                      "description": "Weight in the overall score (0-1)."
+                                    },
+                                    "rationale": {
+                                      "type": "string",
+                                      "description": "Why this score was assigned."
+                                    }
+                                  },
+                                  "required": [
+                                    "name",
+                                    "score",
+                                    "weight",
+                                    "rationale"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                "description": "Per-criterion scores with rationale."
+                              },
+                              "findings": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "criterion": {
+                                      "type": "string",
+                                      "description": "Criterion this finding relates to."
+                                    },
+                                    "severity": {
+                                      "type": "string",
+                                      "enum": [
+                                        "critical",
+                                        "warning",
+                                        "info"
+                                      ],
+                                      "description": "Severity level: critical (blocks deployment), warning (should fix), info (advisory)."
+                                    },
+                                    "message": {
+                                      "type": "string",
+                                      "description": "Human-readable finding description."
+                                    },
+                                    "deduction": {
+                                      "type": "number",
+                                      "description": "Score deduction applied (negative number, e.g. -20)."
+                                    }
+                                  },
+                                  "required": [
+                                    "criterion",
+                                    "severity",
+                                    "message",
+                                    "deduction"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                "description": "Negative findings (warnings/critical issues) with deductions."
+                              },
+                              "strengths": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                },
+                                "description": "Positive evidence explaining high scores."
+                              }
+                            },
+                            "required": [
+                              "criterionScores",
+                              "findings",
+                              "strengths"
+                            ],
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Structured inspection content (criterion scores, findings, strengths). Null for evaluations created before details were stored."
+                      },
                       "evaluatedAt": {
                         "type": "number"
                       }
@@ -631,6 +933,7 @@
                       "evalType",
                       "score",
                       "summary",
+                      "details",
                       "evaluatedAt"
                     ],
                     "additionalProperties": false
@@ -669,7 +972,9 @@
                 "action",
                 "project",
                 "objects",
+                "objectGroups",
                 "graphEdgeCount",
+                "serviceStatus",
                 "evaluations",
                 "versions"
               ],
@@ -857,37 +1162,157 @@
                   "type": "string",
                   "const": "build_graph"
                 },
+                "async_mode": {
+                  "type": "boolean",
+                  "description": "True when graph is building asynchronously (background task). When true, call query_task_status with task_id to retrieve the result."
+                },
+                "task_id": {
+                  "type": "string",
+                  "description": "Async task id — present only when async_mode=true. Use with query_task_status."
+                },
                 "nodeCount": {
                   "type": "number",
-                  "description": "Total nodes in the constructed graph."
+                  "description": "Total nodes in the constructed graph (sync mode only)."
                 },
                 "edgeCount": {
                   "type": "number",
-                  "description": "Total edges (after conflict resolution + dedup)."
+                  "description": "Total edges (after conflict resolution + dedup) (sync mode only)."
                 },
                 "edgesBySource": {
                   "type": "object",
                   "additionalProperties": {
                     "type": "number"
                   },
-                  "description": "Edge counts by source: { internal: N, registrar: N, potential: N }."
+                  "description": "Edge counts by source: { internal: N, registrar: N, potential: N } (sync mode only)."
                 },
                 "reputationCount": {
                   "type": "number",
-                  "description": "Number of objects with Registrar reputation data."
+                  "description": "Number of objects with Registrar reputation data (sync mode only)."
                 },
                 "builtAt": {
                   "type": "number",
-                  "description": "Build timestamp (ms)."
+                  "description": "Build timestamp in ms (sync mode only)."
+                },
+                "binding_verification": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "service": {
+                          "type": "string",
+                          "description": "Service object address that was verified."
+                        },
+                        "bindings": {
+                          "type": "object",
+                          "additionalProperties": {
+                            "type": "object",
+                            "properties": {
+                              "expected": {
+                                "type": "string",
+                                "description": "Expected target object type."
+                              },
+                              "actual": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ],
+                                "description": "Actual on-chain value (address or null)."
+                              },
+                              "count": {
+                                "type": "number",
+                                "description": "Item count for array fields (order_allocators, arbitrations)."
+                              },
+                              "verified": {
+                                "type": "boolean",
+                                "description": "Whether the binding exists on-chain."
+                              }
+                            },
+                            "required": [
+                              "expected",
+                              "actual",
+                              "verified"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "description": "Per-field binding verification result."
+                        },
+                        "all_verified": {
+                          "type": "boolean",
+                          "description": "True when all critical bindings exist on-chain."
+                        }
+                      },
+                      "required": [
+                        "service",
+                        "bindings",
+                        "all_verified"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "On-chain verification of Service bindings (F-15). Null when no Service address or query failed. Sync mode only."
+                },
+                "topEdges": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "description": "Source object address."
+                      },
+                      "target": {
+                        "type": "string",
+                        "description": "Target object address."
+                      },
+                      "fieldName": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "Field name on the source object (or null)."
+                      },
+                      "relationshipType": {
+                        "type": "string",
+                        "description": "Relationship type (bind, create, trigger, etc.)."
+                      },
+                      "weight": {
+                        "type": [
+                          "number",
+                          "null"
+                        ],
+                        "description": "Edge weight (0-1, higher = more important)."
+                      },
+                      "verified": {
+                        "type": "boolean",
+                        "description": "Whether the edge has been verified on-chain."
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "target",
+                      "fieldName",
+                      "relationshipType",
+                      "weight",
+                      "verified"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Top 5 critical edges by weight (sync mode only). Preview of the most important relationships — call get_graph for the full list."
+                },
+                "visualization": {
+                  "type": "string",
+                  "description": "Mermaid-style ASCII visualization of top edges (sync mode only). Compact format: 'source --field--> target'."
+                },
+                "hint": {
+                  "type": "string",
+                  "description": "User-facing hint — guides to next action (e.g. call get_graph for full list, or query_task_status for async result)."
                 }
               },
               "required": [
-                "action",
-                "nodeCount",
-                "edgeCount",
-                "edgesBySource",
-                "reputationCount",
-                "builtAt"
+                "action"
               ],
               "additionalProperties": false
             },
@@ -1381,6 +1806,913 @@
                 "next_action"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "generate_deployment_doc"
+                },
+                "markdown": {
+                  "type": "string",
+                  "description": "Generated deployment document markdown content (follows 71-deployment-list-spec)."
+                },
+                "validation": {
+                  "type": "object",
+                  "properties": {
+                    "valid": {
+                      "type": "boolean",
+                      "description": "True iff no D-check FAIL."
+                    },
+                    "checks": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "check_id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "PASS",
+                              "FAIL",
+                              "WARN"
+                            ]
+                          },
+                          "notes": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "check_id",
+                          "description",
+                          "status"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "D-01..D-20 check results (20 deployment checks including D-19 Machine entry-node forward and D-20 Service compensation_fund)."
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "List of FAIL error messages."
+                    }
+                  },
+                  "required": [
+                    "valid",
+                    "checks",
+                    "errors"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Deployment doc validation result against D-01..D-20."
+                },
+                "saved": {
+                  "type": "boolean",
+                  "description": "Whether the markdown was persisted to SQLite project_documents table."
+                },
+                "detail_level": {
+                  "type": "string",
+                  "enum": [
+                    "summary",
+                    "detailed",
+                    "full"
+                  ],
+                  "description": "Effective detail level used to render the deployment doc. 'summary' (default) shows only key bindings; 'detailed' adds sale/arbitration lists; 'full' shows complete config."
+                },
+                "stage_gate": {
+                  "type": "object",
+                  "properties": {
+                    "stage": {
+                      "type": "number",
+                      "description": "The stage that was validated (4 = deployment doc generation gate)."
+                    },
+                    "passed": {
+                      "type": "boolean",
+                      "description": "True iff no FAIL checks exist — gate allows advancing to Stage 5."
+                    },
+                    "can_proceed": {
+                      "type": "boolean",
+                      "description": "Alias for `passed` — whether the stage gate allows advancement."
+                    },
+                    "blocking_issues": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "FAIL status messages — must be resolved before deploying."
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "WARN status messages — non-blocking, user may proceed at own risk."
+                    },
+                    "checks": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "dimension": {
+                            "type": "string",
+                            "enum": [
+                              "semantic",
+                              "tools",
+                              "reversibility",
+                              "risk",
+                              "isolation",
+                              "gas_budget"
+                            ],
+                            "description": "The validation dimension."
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "PASS",
+                              "WARN",
+                              "FAIL"
+                            ],
+                            "description": "Check result status."
+                          },
+                          "message": {
+                            "type": "string",
+                            "description": "Human-readable check result message."
+                          }
+                        },
+                        "required": [
+                          "dimension",
+                          "status",
+                          "message"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "Per-dimension check results."
+                    }
+                  },
+                  "required": [
+                    "stage",
+                    "passed",
+                    "can_proceed",
+                    "blocking_issues",
+                    "warnings",
+                    "checks"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Stage gate validation (GLM6 5-stage lifecycle 衔接). Validates Stage 3 risk score threshold (>=80 PASS, >=50 WARN, <50 FAIL) and Stage 4 deployment doc generation prerequisite."
+                },
+                "deployment_scan": {
+                  "type": "object",
+                  "properties": {
+                    "overall_readiness": {
+                      "type": "string",
+                      "enum": [
+                        "ready",
+                        "blocked",
+                        "warnings"
+                      ],
+                      "description": "'ready' = all 20 checks pass; 'blocked' = any critical fail; 'warnings' = only warning fails."
+                    },
+                    "critical_count": {
+                      "type": "number",
+                      "description": "Number of critical findings (blocks deployment)."
+                    },
+                    "warning_count": {
+                      "type": "number",
+                      "description": "Number of warning findings (non-blocking)."
+                    },
+                    "findings": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "check_id": {
+                            "type": "string",
+                            "description": "D-XX check id (e.g. 'D-19') or sub-id (e.g. 'D-10a')."
+                          },
+                          "severity": {
+                            "type": "string",
+                            "enum": [
+                              "critical",
+                              "warning",
+                              "info"
+                            ],
+                            "description": "Finding severity."
+                          },
+                          "message": {
+                            "type": "string",
+                            "description": "Human-readable finding message."
+                          },
+                          "location": {
+                            "type": "string",
+                            "description": "Document location (section, line, or step id)."
+                          },
+                          "suggestion": {
+                            "type": "string",
+                            "description": "Suggested fix."
+                          }
+                        },
+                        "required": [
+                          "check_id",
+                          "severity",
+                          "message"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "All findings from the 20 D-XX deployment checks."
+                    },
+                    "checks": {
+                      "type": "object",
+                      "properties": {
+                        "D01_object_defined": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D02_dependency_complete": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D03_scenario_covered": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D04_testnet_topo_order": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D05_testnet_network": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D06_testnet_replace": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D07_permission_index": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D08_guard_gen_passport": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D09_machine_node_count": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D10_substep_coherence": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D11_mainnet_testnet_match": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D12_mainnet_network": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D13_mainnet_replace": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D14_testnet_verification": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D15_mainnet_verification": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D16_no_critical_risk": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D17_no_high_risk": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D18_completeness_checklist": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ]
+                        },
+                        "D19_machine_entry_forward": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ],
+                          "description": "Machine entry node (prev_node='') forwards non-empty — avoids Progress stuck at current=''."
+                        },
+                        "D20_service_compensation_fund": {
+                          "type": "string",
+                          "enum": [
+                            "pass",
+                            "fail"
+                          ],
+                          "description": "Service compensation_fund (Balance<T>) present or industry-exempt — ensures arbitration refund capability."
+                        }
+                      },
+                      "required": [
+                        "D01_object_defined",
+                        "D02_dependency_complete",
+                        "D03_scenario_covered",
+                        "D04_testnet_topo_order",
+                        "D05_testnet_network",
+                        "D06_testnet_replace",
+                        "D07_permission_index",
+                        "D08_guard_gen_passport",
+                        "D09_machine_node_count",
+                        "D10_substep_coherence",
+                        "D11_mainnet_testnet_match",
+                        "D12_mainnet_network",
+                        "D13_mainnet_replace",
+                        "D14_testnet_verification",
+                        "D15_mainnet_verification",
+                        "D16_no_critical_risk",
+                        "D17_no_high_risk",
+                        "D18_completeness_checklist",
+                        "D19_machine_entry_forward",
+                        "D20_service_compensation_fund"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Per-check pass/fail status for all 20 D-XX checks."
+                    }
+                  },
+                  "required": [
+                    "overall_readiness",
+                    "critical_count",
+                    "warning_count",
+                    "findings",
+                    "checks"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Deployment scanner result — 20 D-XX checks including D-19 (Machine entry forward) and D-20 (Service compensation_fund)."
+                }
+              },
+              "required": [
+                "action",
+                "markdown",
+                "validation",
+                "saved",
+                "detail_level",
+                "stage_gate",
+                "deployment_scan"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "pre_evaluate_check"
+                },
+                "ready": {
+                  "type": "boolean",
+                  "description": "True if evaluate_project will produce meaningful results (no hard blockers). If false, address the items in `missing` first."
+                },
+                "missing": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Check ID (e.g. PE-01, PE-06)."
+                      },
+                      "description": {
+                        "type": "string",
+                        "description": "What is missing."
+                      },
+                      "impact": {
+                        "type": "string",
+                        "description": "How it affects the evaluation, and how to fix it."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "description",
+                      "impact"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Hard blockers — must be resolved before evaluation."
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Check ID (e.g. PE-02, PE-03)."
+                      },
+                      "description": {
+                        "type": "string",
+                        "description": "What is suboptimal."
+                      },
+                      "impact": {
+                        "type": "string",
+                        "description": "How it affects the evaluation, and how to improve it."
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "description",
+                      "impact"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Soft issues — evaluation runs but quality may be reduced."
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "One-line human-readable status."
+                },
+                "counts": {
+                  "type": "object",
+                  "properties": {
+                    "objects": {
+                      "type": "number",
+                      "description": "Total project_objects count."
+                    },
+                    "edges": {
+                      "type": "number",
+                      "description": "Total graph_edges count."
+                    },
+                    "uncached": {
+                      "type": "number",
+                      "description": "Objects with no cached on-chain data."
+                    },
+                    "stale": {
+                      "type": "number",
+                      "description": "Objects with cache older than 24 hours."
+                    },
+                    "dangling_edges": {
+                      "type": "number",
+                      "description": "Edges referencing objects not in project_objects."
+                    },
+                    "drafts": {
+                      "type": "number",
+                      "description": "Objects still in draft (not yet on-chain)."
+                    }
+                  },
+                  "required": [
+                    "objects",
+                    "edges",
+                    "uncached",
+                    "stale",
+                    "dangling_edges",
+                    "drafts"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Quick-scan counts for triage."
+                }
+              },
+              "required": [
+                "action",
+                "ready",
+                "missing",
+                "warnings",
+                "summary",
+                "counts"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "verify_deployment"
+                },
+                "verifiedCount": {
+                  "type": "number",
+                  "description": "Number of objects actually verified (excludes drafts and unreachable)."
+                },
+                "matched": {
+                  "type": "number",
+                  "description": "Objects whose on-chain state matches SQLite."
+                },
+                "mismatched": {
+                  "type": "number",
+                  "description": "Objects whose on-chain state differs from SQLite (see `results[].differences`)."
+                },
+                "missing": {
+                  "type": "number",
+                  "description": "Objects that no longer exist on-chain (deleted or never deployed)."
+                },
+                "unreachable": {
+                  "type": "number",
+                  "description": "Objects that could not be queried (network error)."
+                },
+                "results": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "objectAddress": {
+                        "type": "string"
+                      },
+                      "objectName": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "objectType": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "matched",
+                          "mismatched",
+                          "missing",
+                          "unreachable"
+                        ],
+                        "description": "Verification status: 'matched' = on-chain matches SQLite; 'mismatched' = on-chain differs (see differences); 'missing' = object no longer exists on-chain; 'unreachable' = query failed (network error or rate limit)."
+                      },
+                      "differences": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "field": {
+                              "type": "string",
+                              "description": "Field path that differs."
+                            },
+                            "sqlite": {
+                              "description": "Value recorded in SQLite."
+                            },
+                            "onchain": {
+                              "description": "Value observed on-chain."
+                            }
+                          },
+                          "required": [
+                            "field"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Per-field differences (only for status='mismatched')."
+                      },
+                      "bindings": {
+                        "type": "object",
+                        "properties": {
+                          "machine": {
+                            "type": "boolean"
+                          },
+                          "permission": {
+                            "type": "boolean"
+                          },
+                          "buy_guard": {
+                            "type": "boolean"
+                          },
+                          "order_allocators": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "machine",
+                          "permission",
+                          "buy_guard",
+                          "order_allocators"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Critical binding status (only for Service objects). Each boolean indicates whether the binding is set to a non-null value on-chain."
+                      },
+                      "error": {
+                        "type": "string",
+                        "description": "Error message (only for status='unreachable')."
+                      }
+                    },
+                    "required": [
+                      "objectAddress",
+                      "objectName",
+                      "objectType",
+                      "status"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Per-object verification results."
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "One-line human-readable summary."
+                }
+              },
+              "required": [
+                "action",
+                "verifiedCount",
+                "matched",
+                "mismatched",
+                "missing",
+                "unreachable",
+                "results",
+                "summary"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_machine_graph"
+                },
+                "machineAddress": {
+                  "type": "string",
+                  "description": "The Machine object address."
+                },
+                "machineName": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "The Machine's local name (from LocalMark) if available."
+                },
+                "nodes": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "description": "Node name."
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "Node description if set, else null."
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "description"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Workflow nodes (states)."
+                },
+                "edges": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "from": {
+                        "type": "string",
+                        "description": "Source node name (prev_node)."
+                      },
+                      "to": {
+                        "type": "string",
+                        "description": "Target node name (next_node)."
+                      },
+                      "threshold": {
+                        "type": "number",
+                        "description": "Minimum weighted forward count required to advance."
+                      },
+                      "forwards": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string",
+                              "description": "Forward name."
+                            },
+                            "weight": {
+                              "type": "number",
+                              "description": "Forward weight (for weighted threshold)."
+                            },
+                            "guard": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "Guard object address if the forward is guard-gated, else null."
+                            },
+                            "named_operator": {
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "description": "Named operator if set, else null."
+                            },
+                            "permission_index": {
+                              "type": [
+                                "number",
+                                "null"
+                              ],
+                              "description": "Permission index if set, else null."
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "weight",
+                            "guard",
+                            "named_operator",
+                            "permission_index"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "Forwards within this pair — each is an advance operation."
+                      }
+                    },
+                    "required": [
+                      "from",
+                      "to",
+                      "threshold",
+                      "forwards"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Directed edges (pairs) connecting nodes. Each edge has a threshold and forwards."
+                },
+                "published": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Whether the Machine is published (locked for production). null = unknown."
+                },
+                "paused": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Whether the Machine is paused (not generating new Progress). null = unknown."
+                }
+              },
+              "required": [
+                "action",
+                "machineAddress",
+                "machineName",
+                "nodes",
+                "edges",
+                "published",
+                "paused"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "clone_project_to_network"
+                },
+                "new_project_id": {
+                  "type": "string",
+                  "description": "The newly created project's UUID."
+                },
+                "new_prefix": {
+                  "type": "string",
+                  "description": "New project prefix ('<source_prefix>_<target_network>')."
+                },
+                "target_network": {
+                  "type": "string",
+                  "enum": [
+                    "testnet",
+                    "mainnet"
+                  ],
+                  "description": "The target network the new project is bound to."
+                },
+                "cloned_objects_count": {
+                  "type": "number",
+                  "description": "Number of object metadata entries copied (objectAddress is empty — await on-chain deployment)."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable summary of the clone operation."
+                },
+                "next_steps": {
+                  "type": "string",
+                  "description": "Instructions for deploying the cloned objects on the target network."
+                }
+              },
+              "required": [
+                "action",
+                "new_project_id",
+                "new_prefix",
+                "target_network",
+                "cloned_objects_count",
+                "message",
+                "next_steps"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "migrate_network"
+                },
+                "new_project_id": {
+                  "type": "string",
+                  "description": "The newly created project's UUID."
+                },
+                "new_prefix": {
+                  "type": "string",
+                  "description": "New project prefix ('<source_prefix>_<target_network>')."
+                },
+                "target_network": {
+                  "type": "string",
+                  "enum": [
+                    "testnet",
+                    "mainnet"
+                  ],
+                  "description": "The target network the new project is bound to."
+                },
+                "cloned_objects_count": {
+                  "type": "number",
+                  "description": "Number of object metadata entries copied (objectAddress is empty — await on-chain deployment)."
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable summary of the migration operation."
+                },
+                "next_steps": {
+                  "type": "string",
+                  "description": "Instructions for deploying the migrated objects on the target network."
+                }
+              },
+              "required": [
+                "action",
+                "new_project_id",
+                "new_prefix",
+                "target_network",
+                "cloned_objects_count",
+                "message",
+                "next_steps"
+              ],
+              "additionalProperties": false
             }
           ],
           "description": "Query result — shape depends on action"