@wowok/agent-mcp 2.5.1 → 2.5.3

package/dist/schemas/project_operation.output.json

@@ -356,6 +356,13 @@
                 "next_step": {
                   "type": "string"
                 },
+                "recommended_creation_order": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Recommended object creation order based on dependency topology (e.g. ['permission','progress','guard','allocation','machine','service'])."
+                },
                 "next_action": {
                   "type": "string",
                   "enum": [
@@ -369,6 +376,81 @@
                   "items": {
                     "type": "string"
                   }
+                },
+                "gate_validation": {
+                  "type": "object",
+                  "properties": {
+                    "stage": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 5
+                    },
+                    "passed": {
+                      "type": "boolean",
+                      "description": "True when no FAIL checks exist."
+                    },
+                    "checks": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "dimension": {
+                            "type": "string",
+                            "enum": [
+                              "semantic",
+                              "tools",
+                              "reversibility",
+                              "risk",
+                              "isolation",
+                              "gas_budget"
+                            ]
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "PASS",
+                              "FAIL",
+                              "WARN"
+                            ]
+                          },
+                          "message": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "dimension",
+                          "status",
+                          "message"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "blocking_issues": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "can_proceed": {
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "stage",
+                    "passed",
+                    "checks",
+                    "blocking_issues",
+                    "warnings",
+                    "can_proceed"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Stage gate validation result (6 dimensions: semantic/tools/reversibility/risk/isolation/gas_budget)."
                 }
               },
               "required": [
@@ -377,6 +459,7 @@
                 "puzzles",
                 "overall_completeness",
                 "next_step",
+                "recommended_creation_order",
                 "next_action",
                 "warnings"
               ],
@@ -530,6 +613,48 @@
                     "additionalProperties": false
                   }
                 },
+                "fix_suggestions_grouped": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "risk_rule_id": {
+                          "type": "string"
+                        },
+                        "severity": {
+                          "type": "string",
+                          "enum": [
+                            "CRITICAL",
+                            "HIGH",
+                            "MEDIUM",
+                            "LOW",
+                            "INFO"
+                          ]
+                        },
+                        "message": {
+                          "type": "string"
+                        },
+                        "fix_suggestion": {
+                          "type": "string"
+                        },
+                        "entry_id": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "risk_rule_id",
+                        "severity",
+                        "message",
+                        "fix_suggestion",
+                        "entry_id"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "description": "Fix suggestions grouped by object_type for better readability."
+                },
                 "calibrated_at": {
                   "type": "integer"
                 },
@@ -555,6 +680,9 @@
                 "user_action_required": {
                   "type": "string",
                   "description": "Human-readable next-step guidance."
+                },
+                "gate_validation": {
+                  "$ref": "#/definitions/project_operation/properties/result/anyOf/10/properties/gate_validation"
                 }
               },
               "required": [
@@ -663,6 +791,75 @@
                   "additionalProperties": false,
                   "description": "Scanner validation result. Present when run_scanner=true."
                 },
+                "estimated_gas": {
+                  "type": "object",
+                  "properties": {
+                    "total_gas_mist": {
+                      "type": "integer",
+                      "description": "Estimated total gas in MIST (1 WOW = 10^9 MIST)."
+                    },
+                    "per_object": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "entry_id": {
+                            "type": "string"
+                          },
+                          "object_type": {
+                            "type": "string"
+                          },
+                          "create_gas_mist": {
+                            "type": "integer"
+                          },
+                          "publish_gas_mist": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "entry_id",
+                          "object_type",
+                          "create_gas_mist",
+                          "publish_gas_mist"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "publish_gas_mist": {
+                      "type": "integer",
+                      "description": "Gas for publish operations only."
+                    }
+                  },
+                  "required": [
+                    "total_gas_mist",
+                    "per_object",
+                    "publish_gas_mist"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Gas cost estimate for deploying all objects."
+                },
+                "persisted": {
+                  "type": "object",
+                  "properties": {
+                    "all_files": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Project-relative paths of all generated files (27 total)."
+                    },
+                    "all_stages_passed": {
+                      "type": "boolean",
+                      "description": "Whether all 5 stage gates passed validation."
+                    }
+                  },
+                  "required": [
+                    "all_files",
+                    "all_stages_passed"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Nested-autonomy doc set persistence result (§11). Present when the doc set was successfully written to disk."
+                },
                 "can_proceed": {
                   "type": "boolean",
                   "description": "Whether the user can proceed to stage 5. False when D-errors exist."
@@ -678,6 +875,9 @@
                 },
                 "user_action_required": {
                   "type": "string"
+                },
+                "gate_validation": {
+                  "$ref": "#/definitions/project_operation/properties/result/anyOf/10/properties/gate_validation"
                 }
               },
               "required": [
@@ -903,6 +1103,9 @@
                 },
                 "user_action_required": {
                   "type": "string"
+                },
+                "gate_validation": {
+                  "$ref": "#/definitions/project_operation/properties/result/anyOf/10/properties/gate_validation"
                 }
               },
               "required": [
@@ -922,6 +1125,1758 @@
                 "user_action_required"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_project_status"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "stage": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "stage_name": {
+                  "type": "string"
+                },
+                "stage_description": {
+                  "type": "string"
+                },
+                "next_action": {
+                  "type": "string",
+                  "description": "The next project_operation action to call."
+                },
+                "can_proceed": {
+                  "type": "boolean"
+                },
+                "last_updated": {
+                  "type": "integer",
+                  "description": "Timestamp of last stage update (ms)."
+                },
+                "risk_status": {
+                  "type": "string"
+                },
+                "risk_can_proceed": {
+                  "type": "boolean"
+                },
+                "doc_generated": {
+                  "type": "boolean"
+                },
+                "trace_coherent": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "stage",
+                "stage_name",
+                "stage_description",
+                "next_action",
+                "can_proceed"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "load_project"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "prefix": {
+                        "type": "string"
+                      },
+                      "version": {
+                        "type": "string"
+                      },
+                      "dir_name": {
+                        "type": "string"
+                      },
+                      "initialized": {
+                        "type": "boolean"
+                      },
+                      "archived": {
+                        "type": "boolean"
+                      },
+                      "needs_migration": {
+                        "type": "boolean",
+                        "description": "Whether schema_version differs from current."
+                      },
+                      "forked_from": {
+                        "type": "string"
+                      },
+                      "chain_exists": {
+                        "type": "boolean",
+                        "description": "Whether the project prefix exists on-chain."
+                      },
+                      "sync_status": {
+                        "type": "string",
+                        "enum": [
+                          "synced",
+                          "local_only",
+                          "archived",
+                          "uninitialized"
+                        ],
+                        "description": "Cross-validation of local filesystem vs chain truth."
+                      }
+                    },
+                    "required": [
+                      "prefix",
+                      "version",
+                      "dir_name",
+                      "initialized",
+                      "archived",
+                      "needs_migration",
+                      "chain_exists",
+                      "sync_status"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "total": {
+                  "type": "integer"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "local_exists": {
+                  "type": "boolean"
+                },
+                "manifest": {
+                  "type": "object",
+                  "properties": {
+                    "schema_version": {
+                      "type": "string"
+                    },
+                    "mcp_version": {
+                      "type": "string"
+                    },
+                    "prefix": {
+                      "type": "string"
+                    },
+                    "version": {
+                      "type": "string"
+                    },
+                    "created_at": {
+                      "type": "string"
+                    },
+                    "updated_at": {
+                      "type": "string"
+                    },
+                    "forked_from": {
+                      "type": "string"
+                    },
+                    "needs_recalibration": {
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "schema_version",
+                    "mcp_version",
+                    "prefix",
+                    "version",
+                    "created_at",
+                    "updated_at"
+                  ],
+                  "additionalProperties": false
+                },
+                "stage_state": {
+                  "type": "object",
+                  "properties": {
+                    "stage": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 5
+                    },
+                    "updated_at": {
+                      "type": "integer"
+                    },
+                    "has_published_object": {
+                      "type": "boolean"
+                    },
+                    "archived": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "sync_status": {
+                  "type": "object",
+                  "properties": {
+                    "local_exists": {
+                      "type": "boolean"
+                    },
+                    "initialized": {
+                      "type": "boolean"
+                    },
+                    "needs_migration": {
+                      "type": "boolean"
+                    },
+                    "archived": {
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "local_exists",
+                    "initialized",
+                    "needs_migration",
+                    "archived"
+                  ],
+                  "additionalProperties": false
+                },
+                "migration": {
+                  "type": "object",
+                  "properties": {
+                    "migrated": {
+                      "type": "boolean",
+                      "description": "Whether a migration was performed."
+                    },
+                    "from_version": {
+                      "type": "string"
+                    },
+                    "to_version": {
+                      "type": "string"
+                    },
+                    "steps_executed": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "backup_path": {
+                      "type": "string"
+                    },
+                    "needs_recalibration": {
+                      "type": "boolean"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "migrated",
+                    "from_version",
+                    "to_version",
+                    "steps_executed",
+                    "needs_recalibration",
+                    "message"
+                  ],
+                  "additionalProperties": false
+                },
+                "message": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "action"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "fork_project"
+                },
+                "new_prefix": {
+                  "type": "string"
+                },
+                "new_version": {
+                  "type": "string"
+                },
+                "new_path": {
+                  "type": "string",
+                  "description": "Absolute filesystem path of the new project directory."
+                },
+                "forked_from": {
+                  "type": "string",
+                  "description": "Absolute path of the source project directory."
+                },
+                "copied_files": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Project-relative paths of copied files (excludes stage.json + audit.jsonl)."
+                },
+                "copied_file_count": {
+                  "type": "integer"
+                },
+                "warning": {
+                  "type": "string",
+                  "description": "Project isolation notice — forked project must re-create its own objects."
+                },
+                "next_action": {
+                  "type": "string",
+                  "const": "analyze_intent",
+                  "description": "The forked project starts at stage 2 (analyze_intent)."
+                }
+              },
+              "required": [
+                "action",
+                "new_prefix",
+                "new_version",
+                "new_path",
+                "forked_from",
+                "copied_files",
+                "copied_file_count",
+                "warning",
+                "next_action"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "export_project"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "files": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "path": {
+                        "type": "string",
+                        "description": "Project-relative file path."
+                      },
+                      "size": {
+                        "type": "integer",
+                        "description": "File size in bytes."
+                      },
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "json",
+                          "markdown",
+                          "jsonl",
+                          "other"
+                        ]
+                      },
+                      "content": {
+                        "type": "string",
+                        "description": "File content (text)."
+                      }
+                    },
+                    "required": [
+                      "path",
+                      "size",
+                      "kind",
+                      "content"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "total_files": {
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "files",
+                "total_files"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_project_files"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "files": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "path": {
+                        "type": "string",
+                        "description": "Project-relative file path."
+                      },
+                      "size": {
+                        "type": "integer",
+                        "description": "File size in bytes."
+                      },
+                      "kind": {
+                        "type": "string",
+                        "enum": [
+                          "json",
+                          "markdown",
+                          "jsonl",
+                          "other"
+                        ]
+                      },
+                      "mtime": {
+                        "type": "integer",
+                        "description": "Last modified time (ms)."
+                      }
+                    },
+                    "required": [
+                      "path",
+                      "size",
+                      "kind",
+                      "mtime"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "total_files": {
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "files",
+                "total_files"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "validate_stage_unit"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "stage": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "valid": {
+                  "type": "boolean",
+                  "description": "True when all 4 stage unit files exist and pass consistency checks."
+                },
+                "missing_files": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Project-relative paths of missing stage unit files (empty if all present)."
+                },
+                "checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "check_id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pass",
+                          "fail",
+                          "warn"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "check_id",
+                      "status",
+                      "message"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "blocking_issues": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "stage_passed": {
+                  "type": "boolean",
+                  "description": "From verification.json stage_passed field (undefined if file missing)."
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "stage",
+                "valid",
+                "missing_files",
+                "checks",
+                "blocking_issues"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_stage_assessment"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "stage": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "found": {
+                  "type": "boolean"
+                },
+                "assessment": {
+                  "type": "object",
+                  "properties": {
+                    "stage": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 5
+                    },
+                    "assessed_at": {
+                      "type": "integer"
+                    },
+                    "goal_completion": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "number"
+                      }
+                    },
+                    "findings": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "finding_id": {
+                            "type": "string"
+                          },
+                          "severity": {
+                            "type": "string",
+                            "enum": [
+                              "info",
+                              "warn",
+                              "critical"
+                            ]
+                          },
+                          "criterion_id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "evidence": {}
+                        },
+                        "required": [
+                          "finding_id",
+                          "severity",
+                          "criterion_id",
+                          "description"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "recommendations": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "stage",
+                    "assessed_at",
+                    "goal_completion",
+                    "findings",
+                    "recommendations"
+                  ],
+                  "additionalProperties": false,
+                  "description": "The stage assessment object (from assessment.json)."
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "stage",
+                "found"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_stage_risk_policy"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "stage": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "found": {
+                  "type": "boolean"
+                },
+                "risk_policy": {
+                  "type": "object",
+                  "properties": {
+                    "stage": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 5
+                    },
+                    "risks": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "risk_id": {
+                            "type": "string"
+                          },
+                          "category": {
+                            "type": "string",
+                            "enum": [
+                              "naming",
+                              "dependency",
+                              "operational",
+                              "financial",
+                              "security"
+                            ]
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "likelihood": {
+                            "type": "string",
+                            "enum": [
+                              "low",
+                              "medium",
+                              "high"
+                            ]
+                          },
+                          "impact": {
+                            "type": "string",
+                            "enum": [
+                              "low",
+                              "medium",
+                              "high",
+                              "critical"
+                            ]
+                          },
+                          "mitigation": {
+                            "type": "string"
+                          },
+                          "owner": {
+                            "type": "string",
+                            "enum": [
+                              "ai",
+                              "user",
+                              "system"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "risk_id",
+                          "category",
+                          "description",
+                          "likelihood",
+                          "impact",
+                          "mitigation",
+                          "owner"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "active_controls": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "control_id": {
+                            "type": "string"
+                          },
+                          "control_type": {
+                            "type": "string",
+                            "enum": [
+                              "preventive",
+                              "detective",
+                              "corrective"
+                            ]
+                          },
+                          "target_risk": {
+                            "type": "string"
+                          },
+                          "implementation": {
+                            "type": "string"
+                          },
+                          "verified": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "control_id",
+                          "control_type",
+                          "target_risk",
+                          "implementation",
+                          "verified"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "residual_risks": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "stage",
+                    "risks",
+                    "active_controls",
+                    "residual_risks"
+                  ],
+                  "additionalProperties": false,
+                  "description": "The stage risk policy object (from risk-policy.json)."
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "stage",
+                "found"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_doc_relations"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "found": {
+                  "type": "boolean"
+                },
+                "relations": {
+                  "type": "object",
+                  "properties": {
+                    "version": {
+                      "type": "string"
+                    },
+                    "generated_at": {
+                      "type": "integer"
+                    },
+                    "project_invariants": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "invariant_id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "verified_by_stages": {
+                            "type": "array",
+                            "items": {
+                              "type": "integer"
+                            }
+                          }
+                        },
+                        "required": [
+                          "invariant_id",
+                          "description",
+                          "verified_by_stages"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "stage_units": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "stage": {
+                            "type": "integer",
+                            "minimum": 1,
+                            "maximum": 5
+                          },
+                          "goal_id": {
+                            "type": "string"
+                          },
+                          "assessment_id": {
+                            "type": "string"
+                          },
+                          "risk_policy_id": {
+                            "type": "string"
+                          },
+                          "verification_id": {
+                            "type": "string"
+                          },
+                          "artifacts": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "required": [
+                          "stage",
+                          "goal_id",
+                          "assessment_id",
+                          "risk_policy_id",
+                          "verification_id",
+                          "artifacts"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "derivations": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "source_type": {
+                            "type": "string",
+                            "enum": [
+                              "project_invariant",
+                              "project_goal"
+                            ]
+                          },
+                          "source_id": {
+                            "type": "string"
+                          },
+                          "target_type": {
+                            "type": "string",
+                            "enum": [
+                              "stage_goal",
+                              "stage_risk",
+                              "stage_verification"
+                            ]
+                          },
+                          "target_stage": {
+                            "type": "integer",
+                            "minimum": 1,
+                            "maximum": 5
+                          },
+                          "target_id": {
+                            "type": "string"
+                          },
+                          "derivation_logic": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "source_type",
+                          "source_id",
+                          "target_type",
+                          "target_stage",
+                          "target_id",
+                          "derivation_logic"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "propagation_rules": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "rule_id": {
+                            "type": "string"
+                          },
+                          "trigger": {
+                            "type": "object",
+                            "properties": {
+                              "stage": {
+                                "type": "integer"
+                              },
+                              "event": {
+                                "type": "string",
+                                "enum": [
+                                  "verification_passed",
+                                  "verification_failed"
+                                ]
+                              }
+                            },
+                            "required": [
+                              "stage",
+                              "event"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "effect": {
+                            "type": "object",
+                            "properties": {
+                              "target": {
+                                "type": "string",
+                                "enum": [
+                                  "project_invariant",
+                                  "next_stage"
+                                ]
+                              },
+                              "action": {
+                                "type": "string",
+                                "enum": [
+                                  "verify",
+                                  "block"
+                                ]
+                              }
+                            },
+                            "required": [
+                              "target",
+                              "action"
+                            ],
+                            "additionalProperties": false
+                          }
+                        },
+                        "required": [
+                          "rule_id",
+                          "trigger",
+                          "effect"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "impact_map": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  "required": [
+                    "version",
+                    "generated_at",
+                    "project_invariants",
+                    "stage_units",
+                    "derivations",
+                    "propagation_rules",
+                    "impact_map"
+                  ],
+                  "additionalProperties": false,
+                  "description": "The validation chain graph (from relations.json)."
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "found"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "update_deployment_doc"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "updated": {
+                  "type": "boolean",
+                  "description": "Whether the deployment doc set was regenerated."
+                },
+                "updated_files": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Project-relative paths of regenerated files."
+                },
+                "updated_file_count": {
+                  "type": "integer"
+                },
+                "all_stages_passed": {
+                  "type": "boolean",
+                  "description": "Whether all stages passed their D-checks after the update."
+                },
+                "impact_summary": {
+                  "type": "object",
+                  "properties": {
+                    "stages_affected": {
+                      "type": "array",
+                      "items": {
+                        "type": "integer"
+                      },
+                      "description": "Stage numbers whose content changed."
+                    },
+                    "relations_rebuilt": {
+                      "type": "boolean",
+                      "description": "Whether relations.json was regenerated."
+                    }
+                  },
+                  "required": [
+                    "stages_affected",
+                    "relations_rebuilt"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Summary of what changed (based on relations.json impact analysis)."
+                },
+                "next_action": {
+                  "type": "string",
+                  "enum": [
+                    "validate_validation_chain",
+                    "trace_substeps",
+                    "none"
+                  ],
+                  "description": "Next action: validate the chain after update, or proceed to trace_substeps."
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "updated",
+                "updated_files",
+                "updated_file_count",
+                "all_stages_passed",
+                "impact_summary",
+                "next_action"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "validate_validation_chain"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": "string"
+                },
+                "valid": {
+                  "type": "boolean",
+                  "description": "True when derivation, propagation, cross-stage, and impact-map checks all pass."
+                },
+                "derivation_checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "check_id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pass",
+                          "fail",
+                          "warn"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "check_id",
+                      "status",
+                      "message"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "propagation_checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "check_id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pass",
+                          "fail",
+                          "warn"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "check_id",
+                      "status",
+                      "message"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "cross_stage_checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "check_id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pass",
+                          "fail",
+                          "warn"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "check_id",
+                      "status",
+                      "message"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "impact_map_checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "check_id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "pass",
+                          "fail",
+                          "warn"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "check_id",
+                      "status",
+                      "message"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "blocking_issues": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "action",
+                "project",
+                "version",
+                "valid",
+                "derivation_checks",
+                "propagation_checks",
+                "cross_stage_checks",
+                "impact_map_checks",
+                "blocking_issues",
+                "warnings"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "apply_improvement"
+                },
+                "proposal_id": {
+                  "type": "string"
+                },
+                "previous_status": {
+                  "type": "string"
+                },
+                "new_status": {
+                  "type": "string"
+                },
+                "applied": {
+                  "type": "boolean",
+                  "description": "Whether the proposal was applied (true for approved+config_override, true for approved+source_patch producing patch file)."
+                },
+                "apply_mode": {
+                  "type": "string",
+                  "enum": [
+                    "config_override",
+                    "source_patch"
+                  ]
+                },
+                "override_file": {
+                  "type": "string",
+                  "description": "Path of the override file written (config_override only)."
+                },
+                "patch_file": {
+                  "type": "string",
+                  "description": "Path of the patch file written (source_patch only)."
+                },
+                "message": {
+                  "type": "string"
+                },
+                "next_action": {
+                  "type": "string",
+                  "enum": [
+                    "get_improvement_queue",
+                    "get_flywheel_config",
+                    "none"
+                  ],
+                  "description": "Next action: check more proposals or view flywheel status."
+                }
+              },
+              "required": [
+                "action",
+                "proposal_id",
+                "previous_status",
+                "new_status",
+                "applied",
+                "apply_mode",
+                "message",
+                "next_action"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_improvement_queue"
+                },
+                "total": {
+                  "type": "integer"
+                },
+                "filtered_count": {
+                  "type": "integer"
+                },
+                "proposals": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "proposal_id": {
+                        "type": "string"
+                      },
+                      "source_diagnosis_id": {
+                        "type": "string"
+                      },
+                      "type": {
+                        "type": "string"
+                      },
+                      "priority": {
+                        "type": "string"
+                      },
+                      "automation": {
+                        "type": "string",
+                        "enum": [
+                          "full",
+                          "semi",
+                          "manual"
+                        ]
+                      },
+                      "apply_mode": {
+                        "type": "string",
+                        "enum": [
+                          "config_override",
+                          "source_patch"
+                        ]
+                      },
+                      "override_category": {
+                        "type": "string"
+                      },
+                      "title": {
+                        "type": "string"
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "target": {
+                        "type": "string"
+                      },
+                      "review_status": {
+                        "type": "string",
+                        "enum": [
+                          "pending",
+                          "approved",
+                          "rejected",
+                          "applied"
+                        ]
+                      },
+                      "ab_test_recommended": {
+                        "type": "boolean"
+                      },
+                      "persisted_at": {
+                        "type": "string"
+                      },
+                      "reviewed_at": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "proposal_id",
+                      "source_diagnosis_id",
+                      "type",
+                      "priority",
+                      "automation",
+                      "apply_mode",
+                      "title",
+                      "description",
+                      "target",
+                      "review_status",
+                      "ab_test_recommended"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "summary": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "action",
+                "total",
+                "filtered_count",
+                "proposals",
+                "summary"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_flywheel_config"
+                },
+                "queue_path": {
+                  "type": "string"
+                },
+                "overrides_dir": {
+                  "type": "string"
+                },
+                "patches_dir": {
+                  "type": "string"
+                },
+                "total_proposals": {
+                  "type": "integer"
+                },
+                "pending_count": {
+                  "type": "integer"
+                },
+                "approved_count": {
+                  "type": "integer"
+                },
+                "applied_count": {
+                  "type": "integer"
+                },
+                "rejected_count": {
+                  "type": "integer"
+                },
+                "override_files": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "recent_proposals": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "proposal_id": {
+                        "type": "string"
+                      },
+                      "type": {
+                        "type": "string"
+                      },
+                      "priority": {
+                        "type": "string"
+                      },
+                      "review_status": {
+                        "type": "string",
+                        "enum": [
+                          "pending",
+                          "approved",
+                          "rejected",
+                          "applied"
+                        ]
+                      },
+                      "title": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "proposal_id",
+                      "type",
+                      "priority",
+                      "review_status",
+                      "title"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "reflow_status": {
+                  "type": "string",
+                  "enum": [
+                    "active",
+                    "idle",
+                    "blocked"
+                  ],
+                  "description": "active=pending proposals exist; idle=no proposals; blocked=approved but not applied."
+                }
+              },
+              "required": [
+                "action",
+                "queue_path",
+                "overrides_dir",
+                "patches_dir",
+                "total_proposals",
+                "pending_count",
+                "approved_count",
+                "applied_count",
+                "rejected_count",
+                "override_files",
+                "recent_proposals",
+                "reflow_status"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "rollback_stage"
+                },
+                "success": {
+                  "type": "boolean",
+                  "description": "Whether the rollback was executed (or would be, if dry_run=false)."
+                },
+                "dry_run": {
+                  "type": "boolean",
+                  "description": "Whether this was a policy evaluation only (no execution)."
+                },
+                "target_stage": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "previous_stage": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 5
+                },
+                "allowed": {
+                  "type": "boolean",
+                  "description": "Whether the rollback is allowed by policy."
+                },
+                "block_reason": {
+                  "type": "string",
+                  "description": "Present when allowed=false — explains why rollback is blocked."
+                },
+                "files_to_clean": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Files/directories that will be (or were) deleted during rollback."
+                },
+                "files_cleaned": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Files/directories actually deleted (empty in dry_run mode)."
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Non-blocking warnings (e.g., data loss reminder)."
+                },
+                "iteration_strategy": {
+                  "type": "object",
+                  "properties": {
+                    "strategy": {
+                      "type": "string",
+                      "enum": [
+                        "in_place",
+                        "fork"
+                      ]
+                    },
+                    "reason": {
+                      "type": "string"
+                    },
+                    "fork_to_version": {
+                      "type": "string"
+                    },
+                    "published_objects": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "strategy",
+                    "reason"
+                  ],
+                  "additionalProperties": false
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Human-readable summary."
+                }
+              },
+              "required": [
+                "action",
+                "success",
+                "dry_run",
+                "target_stage",
+                "previous_stage",
+                "allowed",
+                "files_to_clean",
+                "files_cleaned",
+                "warnings",
+                "iteration_strategy",
+                "message"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "get_reversibility"
+                },
+                "query": {
+                  "type": "object",
+                  "properties": {
+                    "object_type": {
+                      "type": "string"
+                    },
+                    "lifecycle_state": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "The query parameters used (empty = full matrix returned)."
+                },
+                "entries": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "object_type": {
+                        "type": "string"
+                      },
+                      "lifecycle_state": {
+                        "type": "string",
+                        "enum": [
+                          "created",
+                          "referenced",
+                          "published",
+                          "bound"
+                        ]
+                      },
+                      "struct_reversible": {
+                        "type": "string",
+                        "enum": [
+                          "reversible",
+                          "limited",
+                          "immutable"
+                        ]
+                      },
+                      "behavior_reversible": {
+                        "type": "boolean"
+                      },
+                      "gas_impact": {
+                        "type": "string",
+                        "enum": [
+                          "low",
+                          "medium",
+                          "high",
+                          "none"
+                        ]
+                      },
+                      "explanation": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "object_type",
+                      "lifecycle_state",
+                      "struct_reversible",
+                      "behavior_reversible",
+                      "gas_impact",
+                      "explanation"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "total": {
+                  "type": "integer",
+                  "description": "Number of matrix entries returned."
+                }
+              },
+              "required": [
+                "action",
+                "query",
+                "entries",
+                "total"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "assemble_context"
+                },
+                "objects": {
+                  "type": "array",
+                  "items": {},
+                  "description": "Current on-chain states of the requested objects (from query_objects)."
+                },
+                "events": {
+                  "type": "array",
+                  "items": {},
+                  "description": "Recent state-transition events (only when include_events=true). Includes NewOrderEvent, ProgressEvent, ArbEvent, etc."
+                },
+                "embedded_history": {
+                  "type": "object",
+                  "additionalProperties": {},
+                  "description": "Operation history extracted from object states — NOT from tx queries. Progress objects: session.forwards (who did what, when, accomplished). Order objects: disputes, claimed_by, progress_object. This is the CORRECT history source: convergent, no infinite recursion."
+                },
+                "semantic_summary": {
+                  "description": "Business semantic annotations generated by buildDataSemantic — maps raw object fields to business-meaningful concepts for LLM consumption."
+                },
+                "context_digest": {
+                  "type": "string",
+                  "description": "Unique digest for this assembled context (SHA of object IDs + versions + timestamp). Use for caching or to detect state changes between two assembly calls."
+                },
+                "next_action": {
+                  "type": "string",
+                  "description": "Suggested next action: use onchain_transaction to verify a specific past tx, or proceed with onchain_operations to modify state, or re-call assemble_context after state changes."
+                },
+                "flywheel_collected": {
+                  "type": "object",
+                  "properties": {
+                    "signature_recorded": {
+                      "type": "boolean",
+                      "description": "Whether the experience signature was recorded in the real-time experience layer."
+                    },
+                    "proposal_created": {
+                      "type": "boolean",
+                      "description": "Whether an improvement proposal was created for the offline distillation flywheel."
+                    },
+                    "proposal_id": {
+                      "type": "string",
+                      "description": "The proposal ID, if created."
+                    }
+                  },
+                  "required": [
+                    "signature_recorded",
+                    "proposal_created"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Distillation flywheel collection result. Non-blocking — may be undefined if collection fails. When present, the assembled context has been fed back into the experience layer and/or improvement queue."
+                }
+              },
+              "required": [
+                "action",
+                "objects",
+                "context_digest",
+                "next_action"
+              ],
+              "additionalProperties": false
             }
           ],
           "description": "Query result — shape depends on action"