@wowok/agent-mcp 2.5.0 → 2.5.2

package/dist/schemas/project_operation.output.json

@@ -356,6 +356,21 @@
                 "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": [
+                    "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": {
@@ -369,6 +384,8 @@
                 "puzzles",
                 "overall_completeness",
                 "next_step",
+                "recommended_creation_order",
+                "next_action",
                 "warnings"
               ],
               "additionalProperties": false
@@ -521,6 +538,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"
                 },
@@ -534,6 +593,15 @@
                   "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."
@@ -548,6 +616,7 @@
                 "calibrated_at",
                 "warnings",
                 "can_proceed",
+                "next_action",
                 "user_action_required"
               ],
               "additionalProperties": false
@@ -644,10 +713,66 @@
                   "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."
+                },
                 "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"
                 }
@@ -657,6 +782,7 @@
                 "markdown",
                 "meta",
                 "can_proceed",
+                "next_action",
                 "user_action_required"
               ],
               "additionalProperties": false
@@ -863,6 +989,15 @@
                   "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"
                 }
@@ -880,9 +1015,70 @@
                 "topological_order",
                 "d10_check",
                 "can_proceed",
+                "next_action",
                 "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
             }
           ],
           "description": "Query result — shape depends on action"

package/dist/schemas/project_operation.schema.json

@@ -24,9 +24,10 @@
             "analyze_intent",
             "aggregate_risks",
             "generate_deployment_doc",
-            "trace_substeps"
+            "trace_substeps",
+            "get_project_status"
           ],
-          "description": "Query/action to perform"
+          "description": "Action to perform. Two categories:\n1. Graph Query (10): list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.\n2. Project-Based Deployment 5-Stage (4): Call IN ORDER — analyze_intent (Stage 2) → aggregate_risks (Stage 3) → generate_deployment_doc (Stage 4) → trace_substeps (Stage 5). Each action's output includes `next_action` telling you which action to call next. Stage 1 (Project Naming) uses the `project` + `version` params."
         },
         "project": {
           "type": "string",

package/dist/tools/handlers/project.js

@@ -1,7 +1,7 @@
-import { queryProjects, queryProjectObjects, queryShareableObjects, queryDependencies, queryReferencedBy, queryPrePublishCheck, queryCrossProjectReferences, queryGraphStats, saveGraph, loadGraph, } from "../../project/index.js";
+import { queryProjects, queryProjectObjects, queryShareableObjects, queryDependencies, queryReferencedBy, queryPrePublishCheck, queryCrossProjectReferences, queryGraphStats, saveGraph, loadGraph, updateStageCache, getProjectStatus, } from "../../project/index.js";
 import { analyzeBusinessIntent } from "../../project/business-puzzle.js";
 import { aggregateProjectRisks } from "../../project/risk-aggregator.js";
-import { generateDeploymentDoc, validateDeploymentDoc, } from "../../project/deployment-doc.js";
+import { generateDeploymentDoc, validateDeploymentDoc, estimateDeploymentGas, } from "../../project/deployment-doc.js";
 import { traceSubsteps } from "../../project/substep-trace.js";
 import { strictParse } from "../../schema/index.js";
 import { ProjectOperationInputSchema } from "../../schema/project/index.js";
@@ -87,12 +87,20 @@ async function handleAnalyzeIntent(validated) {
     catch {
         experienceFeedback = undefined;
     }
+    updateStageCache(prefix, version, {
+        stage: 2,
+        puzzles: result.puzzles,
+        business_intent: userIntent,
+        industry,
+    });
     return {
         action: "analyze_intent",
         intent_parsed: result.intent_parsed,
         puzzles: result.puzzles,
         overall_completeness: result.overall_completeness,
         next_step: result.next_step,
+        recommended_creation_order: result.recommended_creation_order,
+        next_action: result.overall_completeness === "complete" ? "aggregate_risks" : "none",
         warnings: result.warnings,
         evolution_context: evolutionContext,
         experience_feedback: experienceFeedback,
@@ -111,6 +119,11 @@ async function handleAggregateRisks(validated) {
     });
     const hasCritical = result.severity_summary.CRITICAL > 0;
     const unconfirmedHigh = result.findings.filter((r) => r.severity === "HIGH").length;
+    updateStageCache(prefix, version, {
+        stage: 3,
+        risk_status: result.status,
+        risk_can_proceed: !hasCritical,
+    });
     return {
         action: "aggregate_risks",
         namespace: result.namespace,
@@ -118,9 +131,11 @@ async function handleAggregateRisks(validated) {
         severity_summary: result.severity_summary,
         status: result.status,
         pending_confirmations: result.pending_confirmations,
+        fix_suggestions_grouped: result.fix_suggestions_grouped,
         calibrated_at: result.calibrated_at,
         warnings: result.warnings,
         can_proceed: !hasCritical,
+        next_action: hasCritical ? "fix_risks" : "generate_deployment_doc",
         user_action_required: hasCritical
             ? `Fix ${result.severity_summary.CRITICAL} CRITICAL risk(s) before proceeding`
             : unconfirmedHigh > 0
@@ -163,6 +178,12 @@ async function handleGenerateDeploymentDoc(validated) {
     const warningCount = validationResult
         ? validationResult.checks.filter((c) => c.status === "WARN").length
         : 0;
+    const gasEstimate = estimateDeploymentGas({ objects: required.objects });
+    updateStageCache(prefix, version, {
+        stage: 4,
+        doc_generated: true,
+        doc_error_count: errorCount,
+    });
     return {
         action: "generate_deployment_doc",
         markdown,
@@ -174,7 +195,9 @@ async function handleGenerateDeploymentDoc(validated) {
             step_count: required.steps.length,
         },
         validation: validationResult,
+        estimated_gas: gasEstimate,
         can_proceed: errorCount === 0,
+        next_action: errorCount === 0 ? "trace_substeps" : "fix_doc_errors",
         user_action_required: errorCount > 0
             ? `Fix ${errorCount} D-error(s) before deploying`
             : warningCount > 0
@@ -193,6 +216,11 @@ async function handleTraceSubsteps(validated) {
     });
     const hasFailedSubstep = substeps.some((s) => s.status === "FAILED");
     const canProceed = result.coherent && !hasFailedSubstep;
+    updateStageCache(prefix, version, {
+        stage: 5,
+        trace_coherent: result.coherent,
+        trace_can_proceed: canProceed,
+    });
     const issueParts = [];
     if (result.dangling_inputs.length > 0) {
         issueParts.push(`${result.dangling_inputs.length} dangling inputs`);
@@ -223,6 +251,7 @@ async function handleTraceSubsteps(validated) {
         topological_order: result.topological_order,
         d10_check: result.d10_check,
         can_proceed: canProceed,
+        next_action: canProceed ? "deploy" : "fix_substeps",
         user_action_required: issueParts.length > 0
             ? `Fix: ${issueParts.join(", ")}`
             : "All substeps passed. Deployment complete.",
@@ -283,6 +312,26 @@ export async function handleProjectOperation(args) {
         case "trace_substeps":
             result = await handleTraceSubsteps(validated);
             break;
+        case "get_project_status": {
+            const { prefix: gpPrefix, version: gpVersion } = requireProject(validated);
+            const status = getProjectStatus(gpPrefix, gpVersion);
+            result = {
+                action: "get_project_status",
+                project: gpPrefix,
+                version: gpVersion,
+                stage: status.stage,
+                stage_name: status.stage_name,
+                stage_description: status.stage_description,
+                next_action: status.next_action,
+                can_proceed: status.can_proceed,
+                last_updated: status.details?.updated_at,
+                risk_status: status.details?.risk_status,
+                risk_can_proceed: status.details?.risk_can_proceed,
+                doc_generated: status.details?.doc_generated,
+                trace_coherent: status.details?.trace_coherent,
+            };
+            break;
+        }
         default:
             throw new Error(`Unknown project_operation action: ${String(action)}`);
     }