@claude-flow/cli 3.17.0 → 3.18.0

package/dist/src/mcp-tools/hooks-tools.d.ts

@@ -48,6 +48,7 @@ export declare const hooksWorkerDetect: MCPTool;
 export declare const hooksModelRoute: MCPTool;
 export declare const hooksModelOutcome: MCPTool;
 export declare const hooksModelStats: MCPTool;
+export declare const hooksModelVerify: MCPTool;
 export declare const hooksCodemod: MCPTool;
 export declare const hooksWorkerCancel: MCPTool;
 export declare const hooksTeammateIdle: MCPTool;

package/dist/src/mcp-tools/hooks-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/hooks-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,YAAY,CAAC;AAiBzD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASzD;AAwqBD,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAyE3B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OA6C7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAgF9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,OAgLxB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAoE1B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,OA8CvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OA2F1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OA6L3B,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,OA4E1B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OA4K3B,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAoE9B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OA+E3B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuI/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuF7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAyCjC,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,OA+BzB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,OAsCvB,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkI/B,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAmEpC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OAyDlC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAmEjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OA+QhC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OA4E/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAwGhC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAsapC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAiGpC,CAAC;AAGF,eAAO,MAAM,0BAA0B,EAAE,OA8MxC,CAAC;AAgQF,eAAO,MAAM,eAAe,EAAE,OA8C7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAwIjC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuD/B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkE/B,CAAC;AAiBF,eAAO,MAAM,eAAe,EAAE,OA+C7B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAgC/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuB7B,CAAC;AAeF,eAAO,MAAM,YAAY,EAAE,OAmI1B,CAAC;AAqBF,eAAO,MAAM,iBAAiB,EAAE,OA0C/B,CAAC;AAOF,eAAO,MAAM,iBAAiB,EAAE,OAwB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAoFhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAc3C,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,OAAO,EA6C/B,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hooks-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/hooks-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,YAAY,CAAC;AAiBzD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASzD;AAwqBD,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAyE3B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OA6C7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAgF9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,OAgLxB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAoE1B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,OA8CvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OA2F1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OA6L3B,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,OA4E1B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OA4K3B,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAoE9B,CAAC;AAGF,eAAO,MAAM,aAAa,EAAE,OA+E3B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuI/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuF7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAyCjC,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,OA+BzB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,OAsCvB,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkI/B,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAmEpC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OAmElC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAyEjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAqRhC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OA4E/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OA8IhC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAsapC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAiGpC,CAAC;AAGF,eAAO,MAAM,0BAA0B,EAAE,OA8MxC,CAAC;AAgQF,eAAO,MAAM,eAAe,EAAE,OA8C7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAwIjC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAuD/B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAkE/B,CAAC;AAiBF,eAAO,MAAM,eAAe,EAAE,OA+C7B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAgC/B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuB7B,CAAC;AAWF,eAAO,MAAM,gBAAgB,EAAE,OAmD9B,CAAC;AAeF,eAAO,MAAM,YAAY,EAAE,OAmI1B,CAAC;AAqBF,eAAO,MAAM,iBAAiB,EAAE,OA0C/B,CAAC;AAOF,eAAO,MAAM,iBAAiB,EAAE,OAwB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAoFhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAc3C,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,OAAO,EA8C/B,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/src/mcp-tools/hooks-tools.js

@@ -2384,12 +2384,14 @@ export const hooksTrajectoryStart = {
         properties: {
             task: { type: 'string', description: 'Task description' },
             agent: { type: 'string', description: 'Agent type' },
+            sessionId: { type: 'string', description: 'Session id for the execution-state tree (default: CLAUDE_FLOW_SESSION_ID or "default")' },
         },
         required: ['task'],
     },
     handler: async (params) => {
         const task = params.task;
         const agent = params.agent || 'coder';
+        const sessionId = params.sessionId || process.env.CLAUDE_FLOW_SESSION_ID || 'default';
         {
             const v = validateText(task, 'task');
             if (!v.valid)
@@ -2400,6 +2402,11 @@ export const hooksTrajectoryStart = {
             if (!v.valid)
                 return { success: false, error: v.error };
         }
+        if (params.sessionId) {
+            const v = validateIdentifier(params.sessionId, 'sessionId');
+            if (!v.valid)
+                return { success: false, error: v.error };
+        }
         const trajectoryId = `traj-${Date.now()}-${Math.random().toString(36).substring(7)}`;
         const startedAt = new Date().toISOString();
         // Create real trajectory entry in memory
@@ -2411,6 +2418,13 @@ export const hooksTrajectoryStart = {
             startedAt,
         };
         activeTrajectories.set(trajectoryId, trajectory);
+        // MAGE-style execution-state-tree mirror (prototype, ruvector/trajectory-tree.ts).
+        // Non-fatal by design — the semantic trajectory path below is untouched.
+        try {
+            const { getTrajectoryTree } = await import('../ruvector/trajectory-tree.js');
+            getTrajectoryTree().openTrajectory({ sessionId, trajectoryId, task, agent });
+        }
+        catch { /* prototype path — never blocks trajectory recording */ }
         // Persist pending trajectory to disk so it survives MCP restarts
         const storeFn = await getRealStoreFunction();
         if (storeFn) {
@@ -2479,6 +2493,12 @@ export const hooksTrajectoryStep = {
                 timestamp,
             });
         }
+        // MAGE-style execution-state-tree mirror (prototype, non-fatal)
+        try {
+            const { getTrajectoryTree } = await import('../ruvector/trajectory-tree.js');
+            getTrajectoryTree().appendStep({ trajectoryId, stepId, action, quality });
+        }
+        catch { /* prototype path — never blocks step recording */ }
         // ADR-130 Phase 3: fire-and-forget causal edge write
         // trajectory context node → step node (relation: "trajectory-caused")
         if (result) {
@@ -2563,6 +2583,12 @@ export const hooksTrajectoryEnd = {
             // Remove from active trajectories
             activeTrajectories.delete(trajectoryId);
         }
+        // MAGE-style execution-state-tree mirror (prototype, non-fatal)
+        try {
+            const { getTrajectoryTree } = await import('../ruvector/trajectory-tree.js');
+            getTrajectoryTree().closeTrajectory({ trajectoryId, success });
+        }
+        catch { /* prototype path — never blocks trajectory finalization */ }
         // SONA Learning - process trajectory outcome for routing optimization
         let sonaResult = {
             learned: false, patternKey: '', confidence: 0
@@ -2866,6 +2892,9 @@ export const hooksPatternSearch = {
             topK: { type: 'number', description: 'Number of results' },
             minConfidence: { type: 'number', description: 'Minimum similarity threshold (0-1)' },
             namespace: { type: 'string', description: 'Namespace to search (default: pattern)' },
+            strategy: { type: 'string', enum: ['semantic', 'state-tree'], description: 'Retrieval strategy. Default "semantic" (unchanged behavior). "state-tree" returns the MAGE-style root→current execution-state path for a session instead of embedding search (prototype).' },
+            sessionId: { type: 'string', description: 'Session id for strategy="state-tree" (default: CLAUDE_FLOW_SESSION_ID or "default")' },
+            depth: { type: 'number', description: 'For strategy="state-tree": max path nodes returned, counted from the current node upward' },
         },
         required: ['query'],
     },
@@ -2874,6 +2903,7 @@ export const hooksPatternSearch = {
         const topK = params.topK || 5;
         const minConfidence = params.minConfidence || 0.3;
         const namespace = params.namespace || 'pattern';
+        const strategy = params.strategy || 'semantic';
         {
             const v = validateText(query, 'query');
             if (!v.valid)
@@ -2884,6 +2914,44 @@ export const hooksPatternSearch = {
             if (!v.valid)
                 return { success: false, error: v.error };
         }
+        // Opt-in MAGE-style positional retrieval (prototype). Default stays the
+        // semantic vector path below — zero behavior change unless requested.
+        if (strategy === 'state-tree') {
+            const sessionId = params.sessionId || process.env.CLAUDE_FLOW_SESSION_ID || 'default';
+            if (params.sessionId) {
+                const v = validateIdentifier(params.sessionId, 'sessionId');
+                if (!v.valid)
+                    return { success: false, error: v.error };
+            }
+            try {
+                const { getTrajectoryTree } = await import('../ruvector/trajectory-tree.js');
+                const recall = getTrajectoryTree().recallPath({
+                    sessionId,
+                    depth: typeof params.depth === 'number' ? params.depth : undefined,
+                    siblingWindow: topK,
+                });
+                return {
+                    query,
+                    strategy: 'state-tree',
+                    backend: 'state-tree',
+                    sessionId: recall.sessionId,
+                    currentId: recall.currentId,
+                    path: recall.path,
+                    siblings: recall.siblings,
+                    note: 'Positional root→current execution-state path (no embedding search). Prototype — see ruvector/trajectory-tree.ts limitations.',
+                };
+            }
+            catch (error) {
+                return {
+                    query,
+                    strategy: 'state-tree',
+                    backend: 'state-tree-unavailable',
+                    path: [],
+                    siblings: [],
+                    error: String(error),
+                };
+            }
+        }
         // Phase 3: Try ReasoningBank search via bridge first
         try {
             const bridge = await import('../memory/memory-bridge.js');
@@ -4293,6 +4361,68 @@ export const hooksModelStats = {
         };
     },
 };
+// Model verify — confidence-gated tier escalation (post-generation).
+// The heuristics live in ruvector/output-verifier.ts; this wrapper adds the
+// MCP surface and feeds the verdict into the SAME learning stream that
+// hooks_model-outcome uses (ModelRouter.recordOutcome → Thompson priors), so
+// the router learns from escalations. A dedicated tool (rather than a
+// "verify mode" on hooks_model-outcome) was chosen because outcome recording
+// is a terminal write while verify is a MID-LOOP decision point that returns
+// a verdict the agent acts on — overloading outcome would conflate the two
+// and break the route → generate → verify → (escalate) → outcome sequence.
+export const hooksModelVerify = {
+    name: 'hooks_model-verify',
+    description: 'Verify a generated output with CHEAP structural signals ($0, no LLM call) and get an escalation verdict — the post-generation half of confidence-gated tier routing (route → generate → verify → escalate on failure). Checks: empty/truncated output, refusal patterns, degenerate repetition, and real syntax parsing for code/JSON tasks (TypeScript compiler / JSON.parse). Returns {confident, reasons[], suggestedTier, suggestedModel, escalate}. By default the verdict is recorded into the model-routing learning stream (success when confident, escalated when not) so the bandit learns which task shapes the cheap tier fails on. Use when you just generated with the tier hooks_model-route picked and must decide accept-vs-escalate BEFORE acting on the output; accepting cheap-tier output unverified is wrong because structurally unusable results (refusals, truncation, unparseable code) silently propagate downstream, and pre-generation routing alone cannot catch them. Not a semantic-quality judge — it only catches structurally unusable outputs.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task: { type: 'string', description: 'The task the output was generated for' },
+            output: { type: 'string', description: 'The generated output to verify' },
+            model: { type: 'string', enum: ['haiku', 'sonnet', 'opus'], description: 'Model that produced the output (drives the escalation ladder; default haiku)' },
+            tierUsed: { type: 'number', enum: [1, 2, 3], description: 'Tier that produced the output; derived from model when absent' },
+            taskKind: { type: 'string', enum: ['code', 'json', 'text', 'auto'], description: 'Force the task kind; default auto-detect' },
+            record: { type: 'boolean', description: 'Record the verdict into the routing learning stream (default true; requires model)' },
+        },
+        required: ['task', 'output'],
+    },
+    handler: async (params) => {
+        const task = params.task;
+        const output = params.output;
+        const model = params.model;
+        {
+            const v = validateText(task, 'task');
+            if (!v.valid)
+                return { success: false, error: v.error };
+        }
+        if (typeof output !== 'string')
+            return { success: false, error: 'output must be a string' };
+        const { verifyAndEscalate } = await import('../ruvector/output-verifier.js');
+        const verdict = await verifyAndEscalate({
+            task,
+            output,
+            model,
+            tierUsed: params.tierUsed,
+            taskKind: params.taskKind,
+        });
+        // Feed the verdict into the existing outcome/learning stream (same path
+        // as hooks_model-outcome) so escalations update the Thompson priors.
+        let recorded = false;
+        if (params.record !== false && model) {
+            const router = await getModelRouterInstance();
+            if (router) {
+                router.recordOutcome(task, model, verdict.confident ? 'success' : 'escalated');
+                recorded = true;
+            }
+        }
+        return {
+            ...verdict,
+            model: model ?? 'haiku',
+            recorded,
+            recordedOutcome: recorded ? (verdict.confident ? 'success' : 'escalated') : null,
+            timestamp: new Date().toISOString(),
+        };
+    },
+};
 // Supported source extensions for codemods.
 const CODEMOD_EXTENSIONS = new Set(['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs', '.mts', '.cts']);
 const CODEMOD_MAX_FILES = 2000;
@@ -4686,6 +4816,7 @@ export const hooksTools = [
     hooksModelRoute,
     hooksModelOutcome,
     hooksModelStats,
+    hooksModelVerify,
     // Deterministic Tier-1 codemod execution (ADR-143)
     hooksCodemod,
 ];