@wowok/agent-mcp 2.5.1 → 2.5.2

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": [
@@ -377,6 +384,7 @@
                 "puzzles",
                 "overall_completeness",
                 "next_step",
+                "recommended_creation_order",
                 "next_action",
                 "warnings"
               ],
@@ -530,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"
                 },
@@ -663,6 +713,53 @@
                   "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."
@@ -922,6 +1019,66 @@
                 "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,7 +24,8 @@
             "analyze_intent",
             "aggregate_risks",
             "generate_deployment_doc",
-            "trace_substeps"
+            "trace_substeps",
+            "get_project_status"
           ],
           "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."
         },

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,19 @@ 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,
@@ -112,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,
@@ -119,6 +131,7 @@ 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,
@@ -165,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,
@@ -176,6 +195,7 @@ 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
@@ -196,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`);
@@ -287,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)}`);
     }