@mcp-graph-workflow/mcp-graph 5.1.4 → 5.2.0

package/dist/core/validator/status-flow-checker.js

@@ -0,0 +1,26 @@
+/**
+ * Status Flow Checker — validates that done tasks went through proper status transitions.
+ */
+import { logger } from "../utils/logger.js";
+const TASK_TYPES = new Set(["task", "subtask"]);
+export function checkStatusFlow(doc) {
+    const violations = [];
+    const doneTasks = doc.nodes.filter((n) => TASK_TYPES.has(n.type) && n.status === "done");
+    for (const task of doneTasks) {
+        // Heuristic: if updatedAt === createdAt, the task never transitioned through statuses
+        if (task.updatedAt === task.createdAt) {
+            violations.push({
+                nodeId: task.id,
+                title: task.title,
+                currentStatus: task.status,
+                details: `Task "${task.title}" marcada como done sem transição de status (createdAt === updatedAt)`,
+            });
+        }
+    }
+    const complianceRate = doneTasks.length === 0
+        ? 100
+        : Math.round(((doneTasks.length - violations.length) / doneTasks.length) * 100);
+    logger.info("status-flow-check", { complianceRate, violationCount: violations.length });
+    return { violations, complianceRate };
+}
+//# sourceMappingURL=status-flow-checker.js.map

package/dist/core/validator/status-flow-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-flow-checker.js","sourceRoot":"","sources":["../../../src/core/validator/status-flow-checker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAEhD,MAAM,UAAU,eAAe,CAAC,GAAkB;IAChD,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAEzF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,sFAAsF;QACtF,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,aAAa,EAAE,IAAI,CAAC,MAAM;gBAC1B,OAAO,EAAE,SAAS,IAAI,CAAC,KAAK,uEAAuE;aACpG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC;QAC3C,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAElF,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAExF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AACxC,CAAC"}

package/dist/mcp/app-factory.d.ts

@@ -9,6 +9,7 @@ export interface AppFactoryOptions {
     eventBus: GraphEventBus;
     mcp?: McpServer;
     storeManager?: StoreManager;
+    gitnexusPort?: number;
 }
 export declare function createApp(options: AppFactoryOptions): Express;
 //# sourceMappingURL=app-factory.d.ts.map

package/dist/mcp/app-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-factory.d.ts","sourceRoot":"","sources":["../../src/mcp/app-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAMjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CA6B7D"}
+{"version":3,"file":"app-factory.d.ts","sourceRoot":"","sources":["../../src/mcp/app-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAMjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CA6B7D"}

package/dist/mcp/app-factory.js

@@ -6,7 +6,7 @@ import { createApiRouter } from "../api/router.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const publicDir = path.join(__dirname, "..", "web", "dashboard", "dist");
 export function createApp(options) {
-    const { store, basePath, eventBus, mcp, storeManager } = options;
+    const { store, basePath, eventBus, mcp, storeManager, gitnexusPort } = options;
     const app = express();
     app.use(express.json());
     // MCP HTTP transport (optional — only when MCP server is provided)
@@ -20,7 +20,7 @@ export function createApp(options) {
         });
     }
     // REST API
-    app.use("/api/v1", createApiRouter({ store, basePath, eventBus, storeManager }));
+    app.use("/api/v1", createApiRouter({ store, basePath, eventBus, storeManager, gitnexusPort }));
     // Static files (dashboard)
     app.use(express.static(publicDir));
     // Health check

package/dist/mcp/app-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-factory.js","sourceRoot":"","sources":["../../src/mcp/app-factory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAInG,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAUzE,MAAM,UAAU,SAAS,CAAC,OAA0B;IAClD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjE,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,mEAAmE;IACnE,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAClD,kBAAkB,EAAE,SAAS;aAC9B,CAAC,CAAC;YACH,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;IACX,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAEjF,2BAA2B;IAC3B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAEnC,eAAe;IACf,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"app-factory.js","sourceRoot":"","sources":["../../src/mcp/app-factory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAInG,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAWzE,MAAM,UAAU,SAAS,CAAC,OAA0B;IAClD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAE/E,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,mEAAmE;IACnE,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAClD,kBAAkB,EAAE,SAAS;aAC9B,CAAC,CAAC;YACH,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;IACX,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAE/F,2BAA2B;IAC3B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAEnC,eAAe;IACf,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mcp/lifecycle-wrapper.d.ts

@@ -1,7 +1,13 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { SqliteStore } from "../core/store/sqlite-store.js";
 import type { GraphDocument } from "../core/graph/graph-types.js";
-import { type LifecyclePhase, type LifecycleWarning, type McpAgentSuggestion } from "../core/planner/lifecycle-phase.js";
+import { type LifecyclePhase, type LifecycleWarning, type McpAgentSuggestion, type StrictnessMode } from "../core/planner/lifecycle-phase.js";
+export interface PhaseKnowledgeSnippet {
+    title: string;
+    sourceType: string;
+    snippet: string;
+    phase?: string;
+}
 export interface LifecycleBlock {
     phase: LifecyclePhase;
     reminder: string;
@@ -9,14 +15,18 @@ export interface LifecycleBlock {
     principles: string[];
     warnings: LifecycleWarning[];
     suggestedMcpAgents?: McpAgentSuggestion[];
+    phaseKnowledge?: PhaseKnowledgeSnippet[];
 }
 export interface LifecycleBlockOptions {
     toolName?: string;
     hasSnapshots?: boolean;
     phaseOverride?: LifecyclePhase | null;
+    mode?: StrictnessMode;
+    store?: SqliteStore;
 }
 /**
  * Build the _lifecycle block to append to MCP tool responses.
+ * Optionally includes top-3 knowledge snippets relevant to the current phase.
  */
 export declare function buildLifecycleBlock(doc: GraphDocument, options?: LifecycleBlockOptions): LifecycleBlock;
 /**
@@ -25,9 +35,9 @@ export declare function buildLifecycleBlock(doc: GraphDocument, options?: Lifecy
  */
 export declare function appendLifecycleToResponse(responseJson: string, doc: GraphDocument): string;
 /**
- * Wrap all registered MCP tool handlers to append _lifecycle context to responses.
- * Iterates over already-registered tools and replaces each handler with a wrapper
- * that appends lifecycle info after the original handler returns.
+ * Wrap all registered MCP tool handlers to enforce lifecycle gates and append lifecycle context.
+ * Pre-execution: checks tool gates and status gates (blocks in strict mode).
+ * Post-execution: appends _lifecycle block to responses.
  */
 export declare function wrapToolsWithLifecycle(server: McpServer, store: SqliteStore): void;
 //# sourceMappingURL=lifecycle-wrapper.d.ts.map

package/dist/mcp/lifecycle-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-wrapper.d.ts","sourceRoot":"","sources":["../../src/mcp/lifecycle-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAwD,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAG/K,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAoBvG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAU1F;AAaD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA0ClF"}
+{"version":3,"file":"lifecycle-wrapper.d.ts","sourceRoot":"","sources":["../../src/mcp/lifecycle-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAI5C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1C,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CA0CvG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAU1F;AA6DD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAkFlF"}

package/dist/mcp/lifecycle-wrapper.js

@@ -1,7 +1,9 @@
-import { detectCurrentPhase, getPhaseGuidance, detectWarnings } from "../core/planner/lifecycle-phase.js";
+import { detectCurrentPhase, getPhaseGuidance, detectWarnings, checkToolGate, checkStatusGate, } from "../core/planner/lifecycle-phase.js";
+import { KnowledgeStore } from "../core/store/knowledge-store.js";
 import { logger } from "../core/utils/logger.js";
 /**
  * Build the _lifecycle block to append to MCP tool responses.
+ * Optionally includes top-3 knowledge snippets relevant to the current phase.
  */
 export function buildLifecycleBlock(doc, options) {
     const phase = detectCurrentPhase(doc, {
@@ -10,8 +12,29 @@ export function buildLifecycleBlock(doc, options) {
     });
     const guidance = getPhaseGuidance(phase);
     const warnings = options?.toolName
-        ? detectWarnings(doc, phase, options.toolName)
+        ? detectWarnings(doc, phase, options.toolName, options?.mode)
         : [];
+    // Fetch top-3 phase-relevant knowledge snippets
+    let phaseKnowledge;
+    if (options?.store) {
+        try {
+            const knowledgeStore = new KnowledgeStore(options.store.getDb());
+            const phaseQuery = `phase ${phase} context`;
+            const results = knowledgeStore.searchWithPhaseBoost(phaseQuery, phase, 3);
+            if (results.length > 0) {
+                phaseKnowledge = results.map((r) => ({
+                    title: r.title,
+                    sourceType: r.sourceType,
+                    snippet: r.content.length > 200 ? r.content.slice(0, 200) + "..." : r.content,
+                    phase: r.metadata?.phase ?? undefined,
+                }));
+            }
+        }
+        catch {
+            // Knowledge search may fail — not critical
+            logger.debug("lifecycle-wrapper: phase knowledge search skipped");
+        }
+    }
     return {
         phase,
         reminder: guidance.reminder,
@@ -21,6 +44,7 @@ export function buildLifecycleBlock(doc, options) {
         ...(guidance.suggestedMcpAgents && guidance.suggestedMcpAgents.length > 0
             ? { suggestedMcpAgents: guidance.suggestedMcpAgents }
             : {}),
+        ...(phaseKnowledge && phaseKnowledge.length > 0 ? { phaseKnowledge } : {}),
     };
 }
 /**
@@ -40,9 +64,48 @@ export function appendLifecycleToResponse(responseJson, doc) {
     }
 }
 /**
- * Wrap all registered MCP tool handlers to append _lifecycle context to responses.
- * Iterates over already-registered tools and replaces each handler with a wrapper
- * that appends lifecycle info after the original handler returns.
+ * Build a blocked response for when a tool is gated by lifecycle enforcement.
+ */
+function buildBlockedResponse(toolName, phase, warnings) {
+    const errorWarnings = warnings.filter((w) => w.severity === "error");
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    error: "lifecycle_gate_blocked",
+                    phase,
+                    tool: toolName,
+                    reason: errorWarnings.map((w) => w.message).join("; "),
+                    warnings: errorWarnings,
+                    hint: "Use set_phase com force:true para bypass, ou mude para mode:'advisory' com set_phase({phase:'auto', mode:'advisory'})",
+                }, null, 2),
+            }],
+        isError: true,
+    };
+}
+/**
+ * Extract node ID and new status from tool call args for status gate checks.
+ */
+function extractStatusArgs(toolName, args) {
+    if (toolName !== "update_status") {
+        return {};
+    }
+    // MCP tool args are passed as the first argument (an object)
+    const toolArgs = args[0];
+    if (!toolArgs)
+        return {};
+    if (toolName === "update_status") {
+        return {
+            nodeId: toolArgs.nodeId,
+            newStatus: toolArgs.status,
+        };
+    }
+    return {};
+}
+/**
+ * Wrap all registered MCP tool handlers to enforce lifecycle gates and append lifecycle context.
+ * Pre-execution: checks tool gates and status gates (blocks in strict mode).
+ * Post-execution: appends _lifecycle block to responses.
  */
 export function wrapToolsWithLifecycle(server, store) {
     const registeredTools = server._registeredTools;
@@ -53,15 +116,51 @@ export function wrapToolsWithLifecycle(server, store) {
     for (const [name, tool] of Object.entries(registeredTools)) {
         const originalHandler = tool.handler;
         tool.handler = async (...args) => {
+            // ── Pre-execution gate check ──
+            try {
+                const doc = store.toGraphDocument();
+                const phaseOverrideValue = store.getProjectSetting("lifecycle_phase_override");
+                const snapshots = store.listSnapshots();
+                const modeValue = store.getProjectSetting("lifecycle_strictness_mode");
+                const mode = (modeValue === "strict" || modeValue === "advisory") ? modeValue : "strict";
+                const phase = detectCurrentPhase(doc, {
+                    hasSnapshots: snapshots.length > 0,
+                    phaseOverride: phaseOverrideValue ? phaseOverrideValue : null,
+                });
+                // Check tool gate
+                const gateWarnings = checkToolGate(doc, phase, name, mode);
+                // Check status-specific gate for update_status
+                const statusArgs = extractStatusArgs(name, args);
+                if (statusArgs.nodeId && statusArgs.newStatus) {
+                    const statusResult = checkStatusGate(doc, phase, statusArgs.nodeId, statusArgs.newStatus, mode);
+                    gateWarnings.push(...statusResult.warnings);
+                }
+                // If any warning has severity "error" → block execution
+                const hasErrors = gateWarnings.some((w) => w.severity === "error");
+                if (hasErrors) {
+                    logger.warn("lifecycle-wrapper: tool blocked by gate", { tool: name, phase, mode });
+                    return buildBlockedResponse(name, phase, gateWarnings);
+                }
+            }
+            catch {
+                // If store has no project loaded (e.g., for `init`), skip gate check
+                logger.debug("lifecycle-wrapper: skipped gate check for tool", { tool: name });
+            }
+            // ── Execute original handler ──
             const result = await originalHandler(...args);
+            // ── Post-execution: append _lifecycle block ──
             try {
                 const doc = store.toGraphDocument();
                 const phaseOverrideValue = store.getProjectSetting("lifecycle_phase_override");
                 const snapshots = store.listSnapshots();
+                const modeValue = store.getProjectSetting("lifecycle_strictness_mode");
+                const mode = (modeValue === "strict" || modeValue === "advisory") ? modeValue : "strict";
                 const lifecycleBlock = buildLifecycleBlock(doc, {
                     toolName: name,
                     hasSnapshots: snapshots.length > 0,
                     phaseOverride: phaseOverrideValue ? phaseOverrideValue : null,
+                    mode,
+                    store,
                 });
                 // Append lifecycle as an additional text content item
                 if (result && Array.isArray(result.content)) {

package/dist/mcp/lifecycle-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-wrapper.js","sourceRoot":"","sources":["../../src/mcp/lifecycle-wrapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lifecycle-wrapper.js","sourceRoot":"","sources":["../../src/mcp/lifecycle-wrapper.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.js

@@ -19,14 +19,15 @@ registerAllTools(mcp, storeManager.store);
 // ── Express app ──────────────────────────────────────────
 const app = createApp({
     store: storeManager.store,
-    basePath: process.cwd(),
+    basePath: storeManager.basePath,
     eventBus,
     mcp,
     storeManager,
+    gitnexusPort: config.integrations.gitnexusPort,
 });
 // ── GitNexus auto-start ──────────────────────────────────
 if (config.integrations.gitnexusAutoStart) {
-    const basePath = process.cwd();
+    const basePath = storeManager.basePath;
     const gitnexusPort = config.integrations.gitnexusPort;
     ensureGitNexusAnalyzed(basePath).then(() => {
         return startGitNexusServe(basePath, gitnexusPort);

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACrH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;AAEzB,4DAA4D;AAC5D,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACxD,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;AACrC,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAEvC,4DAA4D;AAC5D,MAAM,GAAG,GAAG,IAAI,SAAS,CACvB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EACvC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,GAAG,GAAG,SAAS,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC,KAAK;IACzB,QAAQ,EAAE,YAAY,CAAC,QAAQ;IAC/B,QAAQ;IACR,GAAG;IACH,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,YAAY;CAC/C,CAAC,CAAC;AAEH,4DAA4D;AAC5D,IAAI,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC;IAEtD,sBAAsB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACzC,OAAO,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE;YACvD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,SAAS,OAAO,CAAC,MAAc;IAC7B,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/B,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAChD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE9C,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,MAAM,CAAC,IAAI,CAAC,kDAAkD,IAAI,MAAM,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC"}

package/dist/mcp/tools/{stats.d.ts → analyze.d.ts}

@@ -1,4 +1,4 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { SqliteStore } from "../../core/store/sqlite-store.js";
-export declare function registerStats(server: McpServer, store: SqliteStore): void;
-//# sourceMappingURL=stats.d.ts.map
+export declare function registerAnalyze(server: McpServer, store: SqliteStore): void;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/mcp/tools/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/analyze.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AA4DpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA+N3E"}

package/dist/mcp/tools/analyze.js

@@ -0,0 +1,272 @@
+import { z } from "zod/v4";
+import { analyzePrdQuality } from "../../core/analyzer/prd-quality.js";
+import { analyzeScope } from "../../core/analyzer/scope-analyzer.js";
+import { checkDefinitionOfReady } from "../../core/analyzer/definition-of-ready.js";
+import { assessRisks } from "../../core/analyzer/risk-assessment.js";
+import { findTransitiveBlockers, detectCycles, findCriticalPath, } from "../../core/planner/dependency-chain.js";
+import { detectLargeTasks } from "../../core/planner/decompose.js";
+import { validateAdrs } from "../../core/designer/adr-validator.js";
+import { buildTraceabilityMatrix } from "../../core/designer/traceability-matrix.js";
+import { analyzeCoupling } from "../../core/designer/coupling-analyzer.js";
+import { checkInterfaces } from "../../core/designer/interface-checker.js";
+import { assessTechRisks } from "../../core/designer/tech-risk-assessor.js";
+import { checkDesignReadiness } from "../../core/designer/definition-of-ready.js";
+import { checkValidationReadiness } from "../../core/validator/definition-of-ready.js";
+import { checkDoneIntegrity } from "../../core/validator/done-integrity-checker.js";
+import { checkStatusFlow } from "../../core/validator/status-flow-checker.js";
+import { checkReviewReadiness } from "../../core/reviewer/review-readiness.js";
+import { checkHandoffReadiness } from "../../core/handoff/delivery-checklist.js";
+import { checkDocCompleteness } from "../../core/handoff/doc-completeness.js";
+import { checkListeningReadiness } from "../../core/listener/feedback-readiness.js";
+import { analyzeBacklogHealth } from "../../core/listener/backlog-health.js";
+import { KnowledgeStore } from "../../core/store/knowledge-store.js";
+import { detectCurrentPhase } from "../../core/planner/lifecycle-phase.js";
+import { checkDefinitionOfDone } from "../../core/implementer/definition-of-done.js";
+import { checkTddAdherence } from "../../core/implementer/tdd-checker.js";
+import { calculateSprintProgress } from "../../core/implementer/sprint-progress.js";
+import { logger } from "../../core/utils/logger.js";
+const ANALYZE_MODES = z.enum([
+    "prd_quality",
+    "scope",
+    "ready",
+    "risk",
+    "blockers",
+    "cycles",
+    "critical_path",
+    "decompose",
+    "adr",
+    "traceability",
+    "coupling",
+    "interfaces",
+    "tech_risk",
+    "design_ready",
+    "implement_done",
+    "tdd_check",
+    "progress",
+    "validate_ready",
+    "done_integrity",
+    "status_flow",
+    "review_ready",
+    "handoff_ready",
+    "doc_completeness",
+    "listening_ready",
+    "backlog_health",
+]);
+export function registerAnalyze(server, store) {
+    server.tool("analyze", "Analyze the project graph. Modes: prd_quality, scope, ready, risk, blockers, cycles, critical_path, decompose, adr, traceability, coupling, interfaces, tech_risk, design_ready (DESIGN→PLAN gate), implement_done, tdd_check, progress, validate_ready (IMPLEMENT→VALIDATE gate), done_integrity, status_flow, review_ready (VALIDATE→REVIEW gate), handoff_ready (REVIEW→HANDOFF gate), doc_completeness, listening_ready (HANDOFF→LISTENING gate), backlog_health.", {
+        mode: ANALYZE_MODES.describe("Analysis mode"),
+        nodeId: z.string().optional().describe("Node ID (required for 'blockers'/'implement_done', optional for 'decompose'/'tdd_check'. For 'progress' mode, used as sprint name filter)"),
+    }, async ({ mode, nodeId }) => {
+        logger.debug("tool:analyze", { mode, nodeId });
+        const doc = store.toGraphDocument();
+        switch (mode) {
+            case "prd_quality": {
+                const report = analyzePrdQuality(doc);
+                logger.info("tool:analyze:prd_quality:ok", { score: report.score, grade: report.grade });
+                return jsonResponse({ ok: true, mode, ...report });
+            }
+            case "scope": {
+                const analysis = analyzeScope(doc);
+                logger.info("tool:analyze:scope:ok", { orphans: analysis.orphans.length });
+                return jsonResponse({ ok: true, mode, ...analysis });
+            }
+            case "ready": {
+                const readiness = checkDefinitionOfReady(doc);
+                logger.info("tool:analyze:ready:ok", { ready: readiness.readyForNextPhase });
+                return jsonResponse({ ok: true, mode, ...readiness });
+            }
+            case "risk": {
+                const matrix = assessRisks(doc);
+                logger.info("tool:analyze:risk:ok", { total: matrix.summary.total });
+                return jsonResponse({ ok: true, mode, ...matrix });
+            }
+            case "blockers": {
+                if (!nodeId) {
+                    return errorResponse("nodeId is required for 'blockers' mode");
+                }
+                const blockers = findTransitiveBlockers(doc, nodeId);
+                logger.info("tool:analyze:blockers:ok", { nodeId, blockerCount: blockers.length });
+                return jsonResponse({ ok: true, mode, nodeId, blockers });
+            }
+            case "cycles": {
+                const cycles = detectCycles(doc);
+                logger.info("tool:analyze:cycles:ok", { cycleCount: cycles.length });
+                return jsonResponse({ ok: true, mode, cycles });
+            }
+            case "critical_path": {
+                const path = findCriticalPath(doc);
+                logger.info("tool:analyze:critical_path:ok", { pathLength: path.length });
+                return jsonResponse({ ok: true, mode, criticalPath: path });
+            }
+            case "decompose": {
+                let results = detectLargeTasks(doc);
+                if (nodeId) {
+                    results = results.filter((r) => r.node.id === nodeId);
+                }
+                logger.info("tool:analyze:decompose:ok", { count: results.length });
+                return jsonResponse({ ok: true, mode, results });
+            }
+            case "adr": {
+                const phase = detectCurrentPhase(doc);
+                const adrReport = validateAdrs(doc);
+                logger.info("tool:analyze:adr:ok", { grade: adrReport.overallGrade });
+                const response = { ok: true, mode, ...adrReport };
+                if (phase !== "DESIGN")
+                    response._info = `Modo adr é específico da fase DESIGN (fase atual: ${phase})`;
+                return jsonResponse(response);
+            }
+            case "traceability": {
+                const phase = detectCurrentPhase(doc);
+                const traceReport = buildTraceabilityMatrix(doc);
+                logger.info("tool:analyze:traceability:ok", { coverageRate: traceReport.coverageRate });
+                const response = { ok: true, mode, ...traceReport };
+                if (phase !== "DESIGN")
+                    response._info = `Modo traceability é específico da fase DESIGN (fase atual: ${phase})`;
+                return jsonResponse(response);
+            }
+            case "coupling": {
+                const phase = detectCurrentPhase(doc);
+                const couplingReport = analyzeCoupling(doc);
+                logger.info("tool:analyze:coupling:ok", { highCoupling: couplingReport.highCouplingNodes.length });
+                const response = { ok: true, mode, ...couplingReport };
+                if (phase !== "DESIGN")
+                    response._info = `Modo coupling é específico da fase DESIGN (fase atual: ${phase})`;
+                return jsonResponse(response);
+            }
+            case "interfaces": {
+                const phase = detectCurrentPhase(doc);
+                const ifReport = checkInterfaces(doc);
+                logger.info("tool:analyze:interfaces:ok", { overallScore: ifReport.overallScore });
+                const response = { ok: true, mode, ...ifReport };
+                if (phase !== "DESIGN")
+                    response._info = `Modo interfaces é específico da fase DESIGN (fase atual: ${phase})`;
+                return jsonResponse(response);
+            }
+            case "tech_risk": {
+                const phase = detectCurrentPhase(doc);
+                const techRiskReport = assessTechRisks(doc);
+                logger.info("tool:analyze:tech_risk:ok", { riskScore: techRiskReport.riskScore });
+                const response = { ok: true, mode, ...techRiskReport };
+                if (phase !== "DESIGN")
+                    response._info = `Modo tech_risk é específico da fase DESIGN (fase atual: ${phase})`;
+                return jsonResponse(response);
+            }
+            case "design_ready": {
+                const phase = detectCurrentPhase(doc);
+                const readinessReport = checkDesignReadiness(doc);
+                logger.info("tool:analyze:design_ready:ok", { ready: readinessReport.ready, grade: readinessReport.grade });
+                const response = { ok: true, mode, ...readinessReport };
+                if (phase !== "DESIGN")
+                    response._info = `Modo design_ready é específico da fase DESIGN (fase atual: ${phase})`;
+                return jsonResponse(response);
+            }
+            case "implement_done": {
+                if (!nodeId) {
+                    return errorResponse("nodeId is required for 'implement_done' mode");
+                }
+                const phase = detectCurrentPhase(doc);
+                const dodReport = checkDefinitionOfDone(doc, nodeId);
+                logger.info("tool:analyze:implement_done:ok", { nodeId, ready: dodReport.ready, grade: dodReport.grade });
+                const dodResponse = { ok: true, mode, ...dodReport };
+                if (phase !== "IMPLEMENT")
+                    dodResponse._info = `Modo implement_done é específico da fase IMPLEMENT (fase atual: ${phase})`;
+                return jsonResponse(dodResponse);
+            }
+            case "tdd_check": {
+                const phase = detectCurrentPhase(doc);
+                const tddReport = checkTddAdherence(doc, nodeId);
+                logger.info("tool:analyze:tdd_check:ok", { tasks: tddReport.tasks.length, overallTestability: tddReport.overallTestability });
+                const tddResponse = { ok: true, mode, ...tddReport };
+                if (phase !== "IMPLEMENT")
+                    tddResponse._info = `Modo tdd_check é específico da fase IMPLEMENT (fase atual: ${phase})`;
+                return jsonResponse(tddResponse);
+            }
+            case "progress": {
+                const phase = detectCurrentPhase(doc);
+                const progressReport = calculateSprintProgress(doc, nodeId);
+                logger.info("tool:analyze:progress:ok", { done: progressReport.burndown.done, total: progressReport.burndown.total });
+                const progressResponse = { ok: true, mode, ...progressReport };
+                if (phase !== "IMPLEMENT")
+                    progressResponse._info = `Modo progress é específico da fase IMPLEMENT (fase atual: ${phase})`;
+                return jsonResponse(progressResponse);
+            }
+            case "validate_ready": {
+                const phase = detectCurrentPhase(doc);
+                const valReport = checkValidationReadiness(doc);
+                logger.info("tool:analyze:validate_ready:ok", { ready: valReport.ready, grade: valReport.grade });
+                const valResponse = { ok: true, mode, ...valReport };
+                if (phase !== "VALIDATE" && phase !== "IMPLEMENT")
+                    valResponse._info = `Modo validate_ready é específico das fases IMPLEMENT/VALIDATE (fase atual: ${phase})`;
+                return jsonResponse(valResponse);
+            }
+            case "done_integrity": {
+                const doneReport = checkDoneIntegrity(doc);
+                logger.info("tool:analyze:done_integrity:ok", { passed: doneReport.passed, issues: doneReport.issues.length });
+                return jsonResponse({ ok: true, mode, ...doneReport });
+            }
+            case "status_flow": {
+                const flowReport = checkStatusFlow(doc);
+                logger.info("tool:analyze:status_flow:ok", { complianceRate: flowReport.complianceRate });
+                return jsonResponse({ ok: true, mode, ...flowReport });
+            }
+            case "review_ready": {
+                const phase = detectCurrentPhase(doc);
+                const revReport = checkReviewReadiness(doc);
+                logger.info("tool:analyze:review_ready:ok", { ready: revReport.ready, grade: revReport.grade });
+                const revResponse = { ok: true, mode, ...revReport };
+                if (phase !== "REVIEW" && phase !== "VALIDATE")
+                    revResponse._info = `Modo review_ready é específico das fases VALIDATE/REVIEW (fase atual: ${phase})`;
+                return jsonResponse(revResponse);
+            }
+            case "handoff_ready": {
+                const phase = detectCurrentPhase(doc);
+                const ks = new KnowledgeStore(store.getDb());
+                const knowledgeCount = ks.count();
+                const hoReport = checkHandoffReadiness(doc, { knowledgeCount });
+                logger.info("tool:analyze:handoff_ready:ok", { ready: hoReport.ready, grade: hoReport.grade });
+                const hoResponse = { ok: true, mode, ...hoReport };
+                if (phase !== "HANDOFF" && phase !== "REVIEW")
+                    hoResponse._info = `Modo handoff_ready é específico das fases REVIEW/HANDOFF (fase atual: ${phase})`;
+                return jsonResponse(hoResponse);
+            }
+            case "doc_completeness": {
+                const docReport = checkDocCompleteness(doc);
+                logger.info("tool:analyze:doc_completeness:ok", { coverageRate: docReport.coverageRate });
+                return jsonResponse({ ok: true, mode, ...docReport });
+            }
+            case "listening_ready": {
+                const phase = detectCurrentPhase(doc);
+                const snapshots = store.listSnapshots();
+                const hasSnapshots = snapshots.length > 0;
+                const ksL = new KnowledgeStore(store.getDb());
+                const knowledgeCountL = ksL.count();
+                const lisReport = checkListeningReadiness(doc, { hasSnapshots, knowledgeCount: knowledgeCountL });
+                logger.info("tool:analyze:listening_ready:ok", { ready: lisReport.ready, grade: lisReport.grade });
+                const lisResponse = { ok: true, mode, ...lisReport };
+                if (phase !== "LISTENING" && phase !== "HANDOFF")
+                    lisResponse._info = `Modo listening_ready é específico das fases HANDOFF/LISTENING (fase atual: ${phase})`;
+                return jsonResponse(lisResponse);
+            }
+            case "backlog_health": {
+                const healthReport = analyzeBacklogHealth(doc);
+                logger.info("tool:analyze:backlog_health:ok", { clean: healthReport.cleanForNewCycle, stale: healthReport.staleTasks.length });
+                return jsonResponse({ ok: true, mode, ...healthReport });
+            }
+            default: {
+                return errorResponse(`Unknown analyze mode: ${mode}`);
+            }
+        }
+    });
+}
+function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=analyze.js.map