@wowok/agent-mcp 2.4.3 → 2.5.1

package/dist/schemas/project_operation.output.json

@@ -9,9 +9,927 @@
       "type": "object",
       "properties": {
         "result": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "list_projects"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "description": "List of result items. Each item is an untyped record — shape varies per query."
+                }
+              },
+              "required": [
+                "action",
+                "items"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "list_objects"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "description": "List of result items. Each item is an untyped record — shape varies per query."
+                }
+              },
+              "required": [
+                "action",
+                "items"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "shareable"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "description": "List of result items. Each item is an untyped record — shape varies per query."
+                }
+              },
+              "required": [
+                "action",
+                "items"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "dependencies"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "description": "List of result items. Each item is an untyped record — shape varies per query."
+                }
+              },
+              "required": [
+                "action",
+                "items"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "referenced_by"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "description": "List of result items. Each item is an untyped record — shape varies per query."
+                }
+              },
+              "required": [
+                "action",
+                "items"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "pre_publish_check"
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Pre-publish warnings. Empty array means no issues detected."
+                }
+              },
+              "required": [
+                "action",
+                "warnings"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "cross_project_refs"
+                },
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": {}
+                  },
+                  "description": "List of result items. Each item is an untyped record — shape varies per query."
+                }
+              },
+              "required": [
+                "action",
+                "items"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "graph_stats"
+                },
+                "stats": {
+                  "type": "object",
+                  "additionalProperties": {},
+                  "description": "Object dependency graph statistics (counts, depth, etc.)."
+                }
+              },
+              "required": [
+                "action",
+                "stats"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "save_graph"
+                },
+                "saved": {
+                  "type": "boolean",
+                  "const": true,
+                  "description": "Always true — confirms the graph was saved."
+                },
+                "path": {
+                  "type": "string",
+                  "description": "Filesystem path where the graph was saved."
+                }
+              },
+              "required": [
+                "action",
+                "saved",
+                "path"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "load_graph"
+                },
+                "loaded": {
+                  "type": "boolean",
+                  "description": "Whether the graph was successfully loaded from disk."
+                }
+              },
+              "required": [
+                "action",
+                "loaded"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "analyze_intent"
+                },
+                "intent_parsed": {
+                  "type": "object",
+                  "properties": {
+                    "primary_object": {
+                      "type": "string"
+                    },
+                    "secondary_objects": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "detected_scenes": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "object": {
+                            "type": "string"
+                          },
+                          "scene_id": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "object",
+                          "scene_id"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "industry": {
+                      "type": "string"
+                    },
+                    "keyword_matches": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "keyword": {
+                            "type": "string"
+                          },
+                          "category": {
+                            "type": "string"
+                          },
+                          "matched_objects": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "required_level": {
+                            "type": "string",
+                            "enum": [
+                              "R",
+                              "C",
+                              "OPTIONAL"
+                            ]
+                          },
+                          "match_count": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "keyword",
+                          "category",
+                          "matched_objects",
+                          "required_level",
+                          "match_count"
+                        ],
+                        "additionalProperties": false
+                      }
+                    }
+                  },
+                  "required": [
+                    "primary_object",
+                    "secondary_objects",
+                    "detected_scenes",
+                    "industry",
+                    "keyword_matches"
+                  ],
+                  "additionalProperties": false
+                },
+                "puzzles": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                      "puzzle": {
+                        "type": "object",
+                        "additionalProperties": {},
+                        "description": "Per-object puzzle snapshot. Shape varies per object_type — see knowledge/<obj>-puzzle.ts."
+                      },
+                      "completeness": {
+                        "type": "object",
+                        "additionalProperties": {},
+                        "description": "Completeness assessment from checkPuzzleCompleteness(). Shape varies per object."
+                      },
+                      "missing_dimensions": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Dimensions still missing for this object (e.g. ['A','B'])."
+                      }
+                    },
+                    "required": [
+                      "puzzle",
+                      "completeness",
+                      "missing_dimensions"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "overall_completeness": {
+                  "type": "string",
+                  "enum": [
+                    "complete",
+                    "partial",
+                    "empty"
+                  ]
+                },
+                "next_step": {
+                  "type": "string"
+                },
+                "next_action": {
+                  "type": "string",
+                  "enum": [
+                    "aggregate_risks",
+                    "none"
+                  ],
+                  "description": "Next project_operation action to call. 'aggregate_risks' when puzzles are complete enough; 'none' if user must fill missing fields first."
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "action",
+                "intent_parsed",
+                "puzzles",
+                "overall_completeness",
+                "next_step",
+                "next_action",
+                "warnings"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "aggregate_risks"
+                },
+                "namespace": {
+                  "type": "object",
+                  "properties": {
+                    "prefix": {
+                      "type": "string"
+                    },
+                    "version": {
+                      "type": "string"
+                    },
+                    "industry": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "prefix",
+                    "version"
+                  ],
+                  "additionalProperties": false
+                },
+                "findings": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "risk_rule_id": {
+                        "type": "string"
+                      },
+                      "object_type": {
+                        "type": "string"
+                      },
+                      "entry_id": {
+                        "type": "string"
+                      },
+                      "severity": {
+                        "type": "string",
+                        "enum": [
+                          "CRITICAL",
+                          "HIGH",
+                          "MEDIUM",
+                          "LOW",
+                          "INFO"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      },
+                      "fix_suggestion": {
+                        "type": "string"
+                      },
+                      "details": {
+                        "type": "object",
+                        "properties": {
+                          "field_path": {
+                            "type": "string"
+                          },
+                          "rule_source": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "required": [
+                      "risk_rule_id",
+                      "object_type",
+                      "entry_id",
+                      "severity",
+                      "message",
+                      "fix_suggestion"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "severity_summary": {
+                  "type": "object",
+                  "properties": {
+                    "CRITICAL": {
+                      "type": "integer"
+                    },
+                    "HIGH": {
+                      "type": "integer"
+                    },
+                    "MEDIUM": {
+                      "type": "integer"
+                    },
+                    "LOW": {
+                      "type": "integer"
+                    },
+                    "INFO": {
+                      "type": "integer"
+                    }
+                  },
+                  "required": [
+                    "CRITICAL",
+                    "HIGH",
+                    "MEDIUM",
+                    "LOW",
+                    "INFO"
+                  ],
+                  "additionalProperties": false
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "RISK_PASSED",
+                    "RISK_BLOCKED",
+                    "RISK_PENDING_CONFIRM",
+                    "RISK_CANCELLED"
+                  ]
+                },
+                "pending_confirmations": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "risk_rule_id": {
+                        "type": "string"
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "fix_suggestion": {
+                        "type": "string"
+                      },
+                      "object_type": {
+                        "type": "string"
+                      },
+                      "entry_id": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "risk_rule_id",
+                      "description",
+                      "fix_suggestion",
+                      "object_type",
+                      "entry_id"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "calibrated_at": {
+                  "type": "integer"
+                },
+                "warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "can_proceed": {
+                  "type": "boolean",
+                  "description": "Whether the user can proceed to the next stage. False only when CRITICAL risks exist."
+                },
+                "next_action": {
+                  "type": "string",
+                  "enum": [
+                    "generate_deployment_doc",
+                    "fix_risks",
+                    "none"
+                  ],
+                  "description": "Next project_operation action. 'generate_deployment_doc' when can_proceed=true; 'fix_risks' when CRITICAL risks exist; 'none' for other cases."
+                },
+                "user_action_required": {
+                  "type": "string",
+                  "description": "Human-readable next-step guidance."
+                }
+              },
+              "required": [
+                "action",
+                "namespace",
+                "findings",
+                "severity_summary",
+                "status",
+                "calibrated_at",
+                "warnings",
+                "can_proceed",
+                "next_action",
+                "user_action_required"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "generate_deployment_doc"
+                },
+                "markdown": {
+                  "type": "string",
+                  "description": "Complete deployment MD document (§0-§7)"
+                },
+                "meta": {
+                  "type": "object",
+                  "properties": {
+                    "project_prefix": {
+                      "type": "string"
+                    },
+                    "version": {
+                      "type": "string"
+                    },
+                    "generated_at": {
+                      "type": "string",
+                      "description": "ISO timestamp"
+                    },
+                    "object_count": {
+                      "type": "integer"
+                    },
+                    "step_count": {
+                      "type": "integer"
+                    }
+                  },
+                  "required": [
+                    "project_prefix",
+                    "version",
+                    "generated_at",
+                    "object_count",
+                    "step_count"
+                  ],
+                  "additionalProperties": false
+                },
+                "validation": {
+                  "type": "object",
+                  "properties": {
+                    "valid": {
+                      "type": "boolean"
+                    },
+                    "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
+                      }
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "valid",
+                    "checks",
+                    "errors"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Scanner validation result. Present when run_scanner=true."
+                },
+                "can_proceed": {
+                  "type": "boolean",
+                  "description": "Whether the user can proceed to stage 5. False when D-errors exist."
+                },
+                "next_action": {
+                  "type": "string",
+                  "enum": [
+                    "trace_substeps",
+                    "fix_doc_errors",
+                    "none"
+                  ],
+                  "description": "Next project_operation action. 'trace_substeps' when can_proceed=true; 'fix_doc_errors' when D-errors exist; 'none' for other cases."
+                },
+                "user_action_required": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "action",
+                "markdown",
+                "meta",
+                "can_proceed",
+                "next_action",
+                "user_action_required"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "trace_substeps"
+                },
+                "namespace": {
+                  "type": "object",
+                  "properties": {
+                    "prefix": {
+                      "type": "string"
+                    },
+                    "version": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "prefix",
+                    "version"
+                  ],
+                  "additionalProperties": false
+                },
+                "network": {
+                  "type": "string",
+                  "enum": [
+                    "testnet",
+                    "mainnet"
+                  ]
+                },
+                "coherent": {
+                  "type": "boolean",
+                  "description": "True when no dangling/circular/missing/cross-step issues."
+                },
+                "dangling_inputs": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "substep_id": {
+                        "type": "string"
+                      },
+                      "missing_ref": {
+                        "type": "string"
+                      },
+                      "field_path": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "substep_id",
+                      "missing_ref",
+                      "field_path"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "circular_refs": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "cycle": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "cycle"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "missing_outputs": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "substep_id": {
+                        "type": "string"
+                      },
+                      "expected_field": {
+                        "type": "string"
+                      },
+                      "dependent_substeps": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "substep_id",
+                      "expected_field",
+                      "dependent_substeps"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "cross_step_breaks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "source_step": {
+                        "type": "string"
+                      },
+                      "target_step": {
+                        "type": "string"
+                      },
+                      "missing_field": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "source_step",
+                      "target_step",
+                      "missing_field"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "step_details": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "parent_step": {
+                        "type": "string"
+                      },
+                      "total_substeps": {
+                        "type": "integer"
+                      },
+                      "successful": {
+                        "type": "integer"
+                      },
+                      "failed": {
+                        "type": "integer"
+                      },
+                      "pending": {
+                        "type": "integer"
+                      },
+                      "skipped": {
+                        "type": "integer"
+                      },
+                      "substep_ids": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "parent_step",
+                      "total_substeps",
+                      "successful",
+                      "failed",
+                      "pending",
+                      "skipped",
+                      "substep_ids"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "topological_order": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "d10_check": {
+                  "type": "object",
+                  "properties": {
+                    "check_id": {
+                      "type": "string",
+                      "const": "D-10"
+                    },
+                    "description": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "PASS",
+                        "FAIL",
+                        "WARN"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "check_id",
+                    "description",
+                    "status"
+                  ],
+                  "additionalProperties": false
+                },
+                "can_proceed": {
+                  "type": "boolean",
+                  "description": "Whether deployment can complete. False when D-10 fails or substeps FAILED."
+                },
+                "next_action": {
+                  "type": "string",
+                  "enum": [
+                    "deploy",
+                    "fix_substeps",
+                    "none"
+                  ],
+                  "description": "Next action. 'deploy' when can_proceed=true (execute substeps via onchain_operations); 'fix_substeps' when issues exist; 'none' when done."
+                },
+                "user_action_required": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "action",
+                "namespace",
+                "network",
+                "coherent",
+                "dangling_inputs",
+                "circular_refs",
+                "missing_outputs",
+                "cross_step_breaks",
+                "step_details",
+                "topological_order",
+                "d10_check",
+                "can_proceed",
+                "next_action",
+                "user_action_required"
+              ],
+              "additionalProperties": false
+            }
+          ],
           "description": "Query result — shape depends on action"
         }
       },
+      "required": [
+        "result"
+      ],
       "additionalProperties": false
     }
   }