@claude-flow/cli 3.32.1 → 3.32.3

package/.claude/helpers/.helpers-version

@@ -1 +1 @@
-3.30.0
+3.32.2

package/.claude/helpers/helpers.manifest.json

@@ -1,13 +1,13 @@
 {
   "manifest": {
-    "version": "3.32.1",
+    "version": "3.32.3",
     "files": {
       "auto-memory-hook.mjs": "e3e1033b24704992ddef6b31c7fa9dd7fcd9e1af7935dd77ef73402b916b31e6",
       "hook-handler.cjs": "f87ec28684bfc5fd0a54c46bd2a53a3fb037defe71d0ea4b8a5cb88a2cd87a3f",
       "intelligence.cjs": "5a55d979cb7ba5c8c4f27f3b2e6d686fbb1045d180023b803da672a37e05b915",
-      "statusline.cjs": "7d7bdee732e1c75b863e409afb86ce0d712f4919245e990d806da6752015bffa"
+      "statusline.cjs": "af2703bdd710fb52af3221669266771ba1684157f34d77de21373890b5c2a126"
     }
   },
-  "signature": "CYSsp2OyERA+JF2szVX7ciFLjnZ07biWZDJ0u6rUH06HbQECCHdAmmZwSbYiW2XrdN9G6Zrp8MJA56GLX8I1Ag==",
+  "signature": "D2Utlq4bUJe8VgqtibmGrASrFEyzPh5/MQLn2peimcmNuQT8qHN6uMfmgosF1Q9TCi3G4TkZ2iKMYbZ5U/iaAQ==",
   "algorithm": "ed25519"
 }

package/.claude/helpers/statusline.cjs

@@ -28,6 +28,9 @@ const os = require('os');
 // Configuration
 const CONFIG = {
   maxAgents: 15,
+  // Header identity defaults to project/repository name. Set `author` to
+  // retain the previous `git config user.name` display (#2682).
+  identityMode: (process.env.RUFLO_STATUSLINE_IDENTITY || 'project').toLowerCase(),
   // Session-cost display. Claude Code's cost.total_cost_usd is a client-side
   // estimate that "may differ from your actual bill" and reads as misleading on
   // subscription plans, where token usage is not billed per dollar. These let
@@ -210,7 +213,9 @@ function getStatuslineData() {
   // 60s TTL (#2337 — don't re-spawn the CLI on every rapid re-render) AND the
   // tighter promo-rotation clock (this fix — don't let a still-fresh 60s
   // cache silently freeze the promo/insight row across multiple 20s slots).
-  if (cache.fresh && cache.promoFresh) return overlayMemoPromo(cache.data);
+  if (cache.fresh && cache.promoFresh) {
+    return applyLocalOverlays(overlayMemoPromo(cache.data));
+  }
 
   // #2337: prefer an already-installed CLI bin via direct `node` invocation —
   // no npx, no registry round-trip, no @latest re-resolve per render. Try
@@ -417,7 +422,7 @@ function buildLocalFallback() {
   return applyLocalOverlays({
     user: { name: 'user', gitBranch: '', modelName: 'Claude Code' },
     v3Progress: { domainsCompleted: 0, totalDomains: 5, dddProgress: 0, patternsLearned: 0, sessionsCompleted: 0 },
-    security: { status: 'NONE', cvesFixed: 0, totalCves: 0 },
+    security: { status: 'NONE', findings: 0, cvesFixed: 0, totalCves: 0 },
     swarm: { activeAgents: 0, maxAgents: CONFIG.maxAgents, coordinationActive: false },
     system: { memoryMB: memMB, contextPct: 0, intelligencePct: 0, subAgents: 0 },
     lastUpdated: new Date().toISOString(),
@@ -476,11 +481,13 @@ function readJSON(filePath) {
 
 function getGitInfo() {
   const result = {
-    name: 'user', gitBranch: '', modified: 0, untracked: 0,
+    name: path.basename(CWD) || 'project', gitBranch: '', modified: 0, untracked: 0,
     staged: 0, ahead: 0, behind: 0,
   };
 
   const script = [
+    'git rev-parse --show-toplevel 2>/dev/null || pwd',
+    'echo "---SEP---"',
     'git config user.name 2>/dev/null || echo user',
     'echo "---SEP---"',
     'git branch --show-current 2>/dev/null',
@@ -494,12 +501,14 @@ function getGitInfo() {
   if (!raw) return result;
 
   const parts = raw.split('---SEP---').map(function(s) { return s.trim(); });
-  if (parts.length >= 4) {
-    result.name = parts[0] || 'user';
-    result.gitBranch = parts[1] || '';
-
-    if (parts[2]) {
-      for (const line of parts[2].split('\n')) {
+  if (parts.length >= 5) {
+    const projectName = path.basename(parts[0] || CWD) || path.basename(CWD) || 'project';
+    const authorName = parts[1] || 'user';
+    result.name = CONFIG.identityMode === 'author' ? authorName : projectName;
+    result.gitBranch = parts[2] || '';
+
+    if (parts[3]) {
+      for (const line of parts[3].split('\n')) {
         if (!line || line.length < 2) continue;
         const x = line[0], y = line[1];
         if (x === '?' && y === '?') { result.untracked++; continue; }
@@ -508,7 +517,7 @@ function getGitInfo() {
       }
     }
 
-    const ab = (parts[3] || '0 0').split(/\s+/);
+    const ab = (parts[4] || '0 0').split(/\s+/);
     result.ahead = parseInt(ab[0]) || 0;
     result.behind = parseInt(ab[1]) || 0;
   }
@@ -722,8 +731,7 @@ function generateStatusline() {
   const intelligencePct = system.intelligencePct || 0;
   const memoryMB = system.memoryMB || 0;
   const subAgents = system.subAgents || 0;
-  const cvesFixed = security.cvesFixed || 0;
-  const totalCves = security.totalCves || 0;
+  const findings = Math.max(0, security.findings || 0);
   const secStatus = security.status || 'NONE';
   const adrCount = adrs.count || 0;
   const adrImpl = adrs.implemented || 0;
@@ -778,8 +786,7 @@ function generateStatusline() {
   const hooksColor = hooksEnabled > 0 ? c.brightGreen : c.dim;
   const intellColor = intelligencePct >= 80 ? c.brightGreen : intelligencePct >= 40 ? c.brightYellow : c.dim;
   const swarmInd = coordinationActive ? c.brightGreen + '◉' + c.reset + ' ' : c.dim + '○' + c.reset + ' ';
-  const cvesClean = totalCves === 0 || cvesFixed === totalCves;
-  const healthAllGreen = (secStatus === 'CLEAN' || secStatus === 'NONE') && cvesClean;
+  const healthAllGreen = (secStatus === 'CLEAN' || secStatus === 'NONE') && findings === 0;
   const opsParts = [];
   opsParts.push(c.cyan + 'Swarm ' + swarmInd + agentsColor + activeAgents + c.reset + '/' + c.brightWhite + maxAgents + c.reset);
   if (subAgents > 0) opsParts.push(c.brightPurple + '👥 ' + subAgents + c.reset);
@@ -792,11 +799,11 @@ function generateStatusline() {
   } else {
     if (secStatus === 'PENDING') opsParts.push(c.brightYellow + '🛡 scan pending' + c.reset);
     else if (secStatus === 'IN_PROGRESS') opsParts.push(c.brightYellow + '🛡 scanning…' + c.reset);
+    else if (secStatus === 'ISSUES') opsParts.push(c.brightRed + '🛡 findings' + c.reset);
     else if (secStatus === 'STALE') opsParts.push(c.brightYellow + '🛡 scan stale' + c.reset);
     else if (secStatus !== 'NONE' && secStatus !== 'CLEAN') opsParts.push(c.brightRed + '🛡 ' + secStatus.toLowerCase() + c.reset);
-    if (totalCves > 0 && cvesFixed < totalCves) {
-      const unfixed = totalCves - cvesFixed;
-      opsParts.push(c.brightRed + '⚠ ' + unfixed + ' CVE' + (unfixed === 1 ? '' : 's') + c.reset);
+    if (findings > 0) {
+      opsParts.push(c.brightRed + '⚠ ' + findings + ' finding' + (findings === 1 ? '' : 's') + c.reset);
     }
   }
   lines.push(opsParts.join('  ' + c.dim + '·' + c.reset + '  '));

package/.claude/helpers/statusline.js

@@ -167,39 +167,27 @@ function getV3Progress() {
 
 // Get security status based on actual scans
 function getSecurityStatus() {
-  // Check for security scan results in memory
+  // ponytail: read the NEWEST scan in .claude/security-scans/ and surface its
+  // real findings count. Previously hardcoded totalCves=3 and counted scan
+  // *files* as "CVEs fixed", fabricating "⚠ 3 CVEs" for every project.
   const scanResultsPath = path.join(process.cwd(), '.claude', 'security-scans');
-  let cvesFixed = 0;
-  const totalCves = 3;
-
-  if (fs.existsSync(scanResultsPath)) {
-    try {
-      const scans = fs.readdirSync(scanResultsPath).filter(f => f.endsWith('.json'));
-      // Each successful scan file = 1 CVE addressed
-      cvesFixed = Math.min(totalCves, scans.length);
-    } catch (e) {
-      // Ignore
-    }
-  }
-
-  // Also check .swarm/security for audit results
-  const auditPath = path.join(process.cwd(), '.swarm', 'security');
-  if (fs.existsSync(auditPath)) {
-    try {
-      const audits = fs.readdirSync(auditPath).filter(f => f.includes('audit'));
-      cvesFixed = Math.min(totalCves, Math.max(cvesFixed, audits.length));
-    } catch (e) {
-      // Ignore
+  if (!fs.existsSync(scanResultsPath)) return { status: 'PENDING', findings: 0, cvesFixed: 0, totalCves: 0 };
+  try {
+    const files = fs.readdirSync(scanResultsPath).filter(f => f.endsWith('.json'));
+    if (files.length === 0) return { status: 'PENDING', findings: 0, cvesFixed: 0, totalCves: 0 };
+    let newest = files[0];
+    let newestMtime = -1;
+    for (const f of files) {
+      const st = fs.statSync(path.join(scanResultsPath, f));
+      if (st.mtimeMs > newestMtime) { newestMtime = st.mtimeMs; newest = f; }
     }
+    const scan = JSON.parse(fs.readFileSync(path.join(scanResultsPath, newest), 'utf-8'));
+    const findings = Math.max(0, scan.summary?.total ?? scan.totalFindings ?? scan.findings?.length ?? 0);
+    const status = findings > 0 ? 'ISSUES' : 'CLEAN';
+    return { status, findings, scannedAt: scan.timestamp, cvesFixed: 0, totalCves: 0 };
+  } catch (e) {
+    return { status: 'PENDING', findings: 0, cvesFixed: 0, totalCves: 0 };
   }
-
-  const status = cvesFixed >= totalCves ? 'CLEAN' : cvesFixed > 0 ? 'IN_PROGRESS' : 'PENDING';
-
-  return {
-    status,
-    cvesFixed,
-    totalCves,
-  };
 }
 
 // Get swarm status
@@ -306,7 +294,7 @@ function generateStatusline() {
   lines.push(
     `${c.brightYellow}🤖 Swarm${c.reset}  ${swarmIndicator} [${agentsColor}${String(swarm.activeAgents).padStart(2)}${c.reset}/${c.brightWhite}${swarm.maxAgents}${c.reset}]  ` +
     `${c.brightPurple}👥 ${system.subAgents}${c.reset}    ` +
-    `${securityIcon} ${securityColor}CVE ${security.cvesFixed}${c.reset}/${c.brightWhite}${security.totalCves}${c.reset}    ` +
+    `${securityIcon} ${securityColor}Findings ${security.findings || 0}${c.reset}    ` +
     `${c.brightCyan}💾 ${system.memoryMB}MB${c.reset}    ` +
     `${c.brightGreen}📂 ${String(system.contextPct).padStart(3)}%${c.reset}    ` +
     `${c.dim}🧠 ${String(system.intelligencePct).padStart(3)}%${c.reset}`

package/catalog-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 1,
-  "generatedAt": "2026-07-16T23:50:36.870Z",
-  "gitSha": "81447ce7",
+  "generatedAt": "2026-07-17T19:02:35.545Z",
+  "gitSha": "099b8df1",
   "catalog": {
     "agents": 164,
     "tools": 387,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.32.1",
+  "version": "3.32.3",
   "type": "module",
   "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",

package/plugins/ruflo-metaharness/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ruflo-metaharness",
   "description": "MetaHarness integration for ruflo — surfaces score/genome/mint/mcp-scan/threat-model via skills; pairs with @metaharness/router (ADR-148/149) for cost-optimal model routing; honors ADR-150's architectural constraint that MetaHarness remains an optional augmentation, never a required runtime dependency",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "author": {
     "name": "ruvnet",
     "url": "https://github.com/ruvnet"

package/plugins/ruflo-metaharness/scripts/smoke.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Structural smoke test for ruflo-metaharness v0.1.0 (ADR-150 Phase 1).
+# Structural smoke test for ruflo-metaharness v0.1.1 (ADR-150 Phase 1).
 set -u
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 PASS=0
@@ -31,10 +31,10 @@ else
   bad "extraction-regex-rot: EXPECTED_TOOLS=$EXPECTED_TOOLS EXPECTED_SUBS=$EXPECTED_SUBS"
 fi
 
-step "1. plugin.json declares 0.1.0 with adr-150 keywords"
+step "1. plugin.json declares 0.1.1 with adr-150 keywords"
 v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.1.0" ]]; then
-  bad "expected 0.1.0, got '$v'"
+if [[ "$v" != "0.1.1" ]]; then
+  bad "expected 0.1.1, got '$v'"
 else
   miss=""
   for k in ruflo metaharness harness scorecard genome mcp-scan threat-model router adr-150 adr-148 adr-149 optional-dependency graceful-degradation subprocess phase-1-mvp; do
@@ -799,7 +799,7 @@ TOOLS=$(grep -oE "name: 'metaharness_[a-z_]+'" "$WRAPPER" 2>/dev/null \
 COUNT=0
 for t in $TOOLS; do
   COUNT=$((COUNT + 1))
-  # Look for `mcp__claude-flow__metaharness_X` (the agent-facing name form)
+  # audit-allow: standalone-mcp-prefix — this checks the repository CLAUDE.md, not a plugin skill.
   grep -q "mcp__claude-flow__${t}" "$CMD" 2>/dev/null \
     || miss="$miss ${t}-not-in-claude-md"
 done
@@ -1521,6 +1521,7 @@ grep -q "drift-from-history.mjs" "$WRAPPER" 2>/dev/null || miss="$miss no-script
 grep -q "baselineSince" "$WRAPPER" 2>/dev/null || miss="$miss no-baseline-since-input"
 # CLAUDE.md mentions both surfaces
 CMD="$ROOT/../../CLAUDE.md"
+# audit-allow: standalone-mcp-prefix — this checks the repository CLAUDE.md, not a plugin skill.
 grep -q "mcp__claude-flow__metaharness_drift_from_history" "$CMD" 2>/dev/null || miss="$miss claude-md-no-mcp"
 grep -q "ruflo metaharness drift-from-history" "$CMD" 2>/dev/null || miss="$miss claude-md-no-subcommand"
 # Phase 4 includes the new positive-case assertions
@@ -1806,6 +1807,7 @@ grep -q "Graceful fallback when fingerprint missing" "$F" 2>/dev/null || miss="$
 grep -q "Distance alert gate exits 1" "$F" 2>/dev/null || miss="$miss no-alert-step"
 # CLAUDE.md documents the new MCP tool + subcommand
 CMD="$ROOT/../../CLAUDE.md"
+# audit-allow: standalone-mcp-prefix — this checks the repository CLAUDE.md, not a plugin skill.
 grep -q "mcp__claude-flow__metaharness_similarity" "$CMD" 2>/dev/null || miss="$miss claude-md-no-mcp-tool"
 grep -q "ruflo metaharness similarity" "$CMD" 2>/dev/null || miss="$miss claude-md-no-subcommand"
 grep -q -- "--alert-on-distance-below" "$CMD" 2>/dev/null || miss="$miss claude-md-no-distance-flag"
@@ -2123,6 +2125,7 @@ grep -q "Ruflo remains operational if every MetaHarness package is removed" "$F"
 grep -q "no-metaharness-smoke.yml" "$F" || miss="$miss no-ci-gate-ref"
 # Command surface + tool surface enumerated
 grep -q "npx ruflo metaharness score" "$F" || miss="$miss no-cli-example"
+# audit-allow: standalone-mcp-prefix — this checks the repository CLAUDE.md, not a plugin skill.
 grep -q "mcp__claude-flow__metaharness_" "$F" || miss="$miss no-mcp-tool-list"
 # Routing + parallel-log integration both mentioned
 grep -q "CLAUDE_FLOW_ROUTER_NEURAL\|CLAUDE_FLOW_ROUTER_PARALLEL_LOG" "$F" || miss="$miss no-routing-flags"

package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md

@@ -63,5 +63,5 @@ npx ruflo metaharness similarity --a a.json --b b.json --alert-below 0.5
 
 Production module: [`scripts/_similarity.mjs`](../../scripts/_similarity.mjs)
 CLI skill: [`scripts/similarity.mjs`](../../scripts/similarity.mjs)
-MCP tool: `mcp__claude-flow__metaharness_similarity` (registered in `v3/@claude-flow/cli/src/mcp-tools/metaharness-tools.ts`)
+MCP tool: `mcp__plugin_ruflo-core_ruflo__metaharness_similarity` (registered in `v3/@claude-flow/cli/src/mcp-tools/metaharness-tools.ts`)
 Spike anchor: [`scripts/_spike-similarity.mjs`](../../scripts/_spike-similarity.mjs) (regression suite — invariants locked here)

package/dist/src/agenticow/speculative-exploration.d.ts

@@ -1,148 +0,0 @@
-/**
- * Speculative branch-and-promote — parallel A/B solution exploration over
- * COW memory branches (agenticow step 4).
- *
- * Concept (from agenticow's examples/ab-branches + promotion-pipeline):
- *   Fan out N candidate approaches, each on its own Copy-On-Write branch of a
- *   shared base `.rvf` memory. Each candidate explores/writes independently
- *   against its own branch handle. Score the results, PROMOTE the winner's
- *   branch back into base, and DISCARD the losers — which for agenticow means
- *   deleting the branch files (162 bytes each), not re-copying GB of state.
- *
- *   This is the memory-state analogue of the git-worktree-per-agent pattern
- *   used for parallel code agents: cheap speculative forks, keep one, throw the
- *   rest away at near-zero cost.
- *
- * This module is intentionally COMPOSED ON TOP of the existing agenticow verbs
- * (`fork` / `promote`) and the shared `_agenticow.ts` helpers — it does not
- * reimplement COW semantics. It is generic over the candidate result type so
- * callers supply their own `fn` (what to do on each branch) and `score`
- * (how good the branch turned out).
- *
- * @module @claude-flow/cli/agenticow/speculative-exploration
- */
-import { type AgenticowApi } from '../mcp-tools/agenticow-loader.js';
-/** A COW memory handle (agenticow `AgenticMemory`), kept `any` to avoid a hard type dep. */
-export type MemoryHandle = any;
-export interface SpeculativeCandidate<TResult> {
-    /** Human-readable branch label (validated: `[A-Za-z0-9_.\-:/@]`). */
-    label: string;
-    /**
-     * The exploration to run against this candidate's isolated branch handle.
-     * Receives the forked branch (read-through of base ∪ its own edits). May
-     * ingest, delete, query, etc. Its return value is fed to `score`.
-     */
-    fn: (branch: MemoryHandle) => TResult | Promise<TResult>;
-}
-export interface ExploreOptions {
-    /**
-     * Maps a candidate label to the on-disk path for its branch `.rvf` file.
-     * Loser paths are deleted after scoring.
-     */
-    branchPath: (label: string) => string;
-    /** Persist winner-branch + save manifests. Default true. */
-    persist?: boolean;
-    /**
-     * Tie-break: when two candidates tie on score, the earlier one (lower index)
-     * wins by default (stable). Set `'last'` to prefer the later candidate.
-     */
-    tieBreak?: 'first' | 'last';
-    /**
-     * PROMOTION GATE (ADR-171). A branch is promote-INELIGIBLE unless cleared by a
-     * real evaluation oracle, or by an explicitly-accepted Fable judge. When
-     * provided, the top-scoring candidate is promoted ONLY if this returns
-     * `{cleared:true, by:'oracle:test-exec'}` or `{cleared:true, by:'judge:fable'}`.
-     * `proxy:structural` can NEVER clear a promote — score rank alone does not
-     * graduate work into base. Omit for legacy score-only promotion (unverified).
-     */
-    clearance?: (winnerResult: unknown, label: string) => Promise<{
-        cleared: boolean;
-        by: PromotionProvenance;
-        reason?: string;
-    }>;
-    /**
-     * Force the clearance gate even without a `clearance` fn — a missing gate then
-     * means the winner is ineligible (fail-closed). Default: gate enforced iff
-     * `clearance` is supplied.
-     */
-    requireClearance?: boolean;
-}
-/** Provenance of a promotion decision (ADR-171 trust tiers). */
-export type PromotionProvenance = 'oracle:test-exec' | 'judge:fable' | 'proxy:structural' | 'unverified';
-/**
- * Causal failure receipt (ADR-171). Emitted for every discarded loser and for
- * an ineligible/failed winner — a rollback that loses *why* is half-useful.
- */
-export interface SpeculativeReceipt {
-    label: string;
-    score: number;
-    /** What the branch changed vs its lineage, when introspectable. */
-    diff: {
-        added: number[];
-        overridden: number[];
-        deleted: number[];
-    } | null;
-    /** Why this branch did not graduate. */
-    outcome: 'discarded-loser' | 'winner-ineligible' | 'winner-failed';
-    provenance: PromotionProvenance;
-    reason?: string;
-}
-export interface SpeculativeBranchOutcome<TResult> {
-    label: string;
-    path: string;
-    score: number;
-    result: TResult;
-    /** true for the promoted winner, false for discarded losers. */
-    kept: boolean;
-}
-export interface SpeculativeResult<TResult> {
-    /** Label of the winning (promoted) candidate. */
-    winner: string;
-    /** label → score for every candidate. */
-    scores: Record<string, number>;
-    /** Whether the winner was successfully promoted into base. */
-    promoted: boolean;
-    /** How the promotion decision was reached (ADR-171 provenance). */
-    promotedBy: PromotionProvenance;
-    /** Human-readable promotion decision, e.g. 'promoted:oracle:test-exec' or 'ineligible:proxy-cannot-clear'. */
-    promotionDecision: string;
-    /** agenticow promote() stats for the winner ({ ingested, deleted }). */
-    promoteStats: {
-        ingested: number;
-        deleted: number;
-    } | null;
-    /** Labels of the discarded losers whose branch files were deleted. */
-    discarded: string[];
-    /** Causal failure receipts for discarded losers + an ineligible winner. */
-    receipts: SpeculativeReceipt[];
-    /** Per-candidate detail (score, path, result, kept). */
-    branches: SpeculativeBranchOutcome<TResult>[];
-}
-/**
- * Fork one branch per candidate off `base`, run each `fn` against its own
- * branch handle, score the results, PROMOTE the best branch back into `base`,
- * and DISCARD (delete the files of) the rest.
- *
- * The caller owns `base`: this function mutates it in-memory via `promote()`
- * but does NOT save it (only the caller knows the base file path). Persist the
- * base yourself after this resolves (e.g. `base.save(manifestFor(basePath))`).
- *
- * @param base       An opened agenticow memory handle to branch from.
- * @param candidates The A/B candidates — each `{label, fn}`.
- * @param score      Scores a candidate's result; higher wins.
- * @param opts       Branch-path mapping + persistence knobs.
- */
-export declare function explore<TResult>(base: MemoryHandle, candidates: SpeculativeCandidate<TResult>[], score: (result: TResult, label: string) => number, opts: ExploreOptions): Promise<SpeculativeResult<TResult>>;
-/**
- * Convenience wrapper that owns the whole lifecycle for a file-path base:
- * loads agenticow (returns `null` when the optional dep is absent), opens the
- * base with its lineage, runs {@link explore}, then persists the mutated base.
- *
- * Returns `null` when agenticow is not installed so callers can emit the
- * standard `{degraded:true}` contract.
- */
-export declare function exploreFromPath<TResult>(basePath: string, candidates: SpeculativeCandidate<TResult>[], score: (result: TResult, label: string) => number, opts: ExploreOptions & {
-    dimension?: number;
-    api?: AgenticowApi;
-}): Promise<SpeculativeResult<TResult> | null>;
-//# sourceMappingURL=speculative-exploration.d.ts.map

package/dist/src/agenticow/speculative-exploration.js

@@ -1,218 +0,0 @@
-/**
- * Speculative branch-and-promote — parallel A/B solution exploration over
- * COW memory branches (agenticow step 4).
- *
- * Concept (from agenticow's examples/ab-branches + promotion-pipeline):
- *   Fan out N candidate approaches, each on its own Copy-On-Write branch of a
- *   shared base `.rvf` memory. Each candidate explores/writes independently
- *   against its own branch handle. Score the results, PROMOTE the winner's
- *   branch back into base, and DISCARD the losers — which for agenticow means
- *   deleting the branch files (162 bytes each), not re-copying GB of state.
- *
- *   This is the memory-state analogue of the git-worktree-per-agent pattern
- *   used for parallel code agents: cheap speculative forks, keep one, throw the
- *   rest away at near-zero cost.
- *
- * This module is intentionally COMPOSED ON TOP of the existing agenticow verbs
- * (`fork` / `promote`) and the shared `_agenticow.ts` helpers — it does not
- * reimplement COW semantics. It is generic over the candidate result type so
- * callers supply their own `fn` (what to do on each branch) and `score`
- * (how good the branch turned out).
- *
- * @module @claude-flow/cli/agenticow/speculative-exploration
- */
-import { existsSync, rmSync } from 'node:fs';
-import { loadAgenticow, openWithLineage, manifestFor, resolveMemoryPath, validateLabel, } from '../mcp-tools/agenticow-loader.js';
-function safeDiff(branch) {
-    try {
-        const d = branch.diff?.();
-        return d ? { added: d.added ?? [], overridden: d.overridden ?? [], deleted: d.deleted ?? [] } : null;
-    }
-    catch {
-        return null;
-    }
-}
-function deleteBranchFiles(path) {
-    for (const p of [path, manifestFor(path)]) {
-        try {
-            if (existsSync(p))
-                rmSync(p, { recursive: true, force: true });
-        }
-        catch {
-            /* best-effort discard; a leftover 162-byte file is not fatal */
-        }
-    }
-}
-/**
- * Fork one branch per candidate off `base`, run each `fn` against its own
- * branch handle, score the results, PROMOTE the best branch back into `base`,
- * and DISCARD (delete the files of) the rest.
- *
- * The caller owns `base`: this function mutates it in-memory via `promote()`
- * but does NOT save it (only the caller knows the base file path). Persist the
- * base yourself after this resolves (e.g. `base.save(manifestFor(basePath))`).
- *
- * @param base       An opened agenticow memory handle to branch from.
- * @param candidates The A/B candidates — each `{label, fn}`.
- * @param score      Scores a candidate's result; higher wins.
- * @param opts       Branch-path mapping + persistence knobs.
- */
-export async function explore(base, candidates, score, opts) {
-    if (!base)
-        throw new Error('base memory handle is required');
-    if (!Array.isArray(candidates) || candidates.length === 0) {
-        throw new Error('at least one candidate is required');
-    }
-    if (typeof score !== 'function')
-        throw new Error('score function is required');
-    if (!opts || typeof opts.branchPath !== 'function') {
-        throw new Error('opts.branchPath(label) is required');
-    }
-    const persist = opts.persist !== false;
-    const tieBreak = opts.tieBreak ?? 'first';
-    // Reject duplicate labels up front — two branches to the same file would clash.
-    const seen = new Set();
-    const live = [];
-    // 1) Fork + explore each candidate on its own isolated branch.
-    for (const c of candidates) {
-        const label = validateLabel(c.label);
-        if (seen.has(label))
-            throw new Error(`duplicate candidate label: ${label}`);
-        seen.add(label);
-        if (typeof c.fn !== 'function')
-            throw new Error(`candidate ${label} is missing fn()`);
-        const path = resolveMemoryPath(opts.branchPath(label));
-        const branch = base.fork(label, path);
-        const result = await c.fn(branch);
-        const s = Number(score(result, label));
-        live.push({ label, path, branch, result, score: Number.isFinite(s) ? s : -Infinity });
-    }
-    // 2) Pick the winner (highest score; stable tie-break).
-    let winnerIdx = 0;
-    for (let i = 1; i < live.length; i++) {
-        const better = tieBreak === 'last'
-            ? live[i].score >= live[winnerIdx].score
-            : live[i].score > live[winnerIdx].score;
-        if (better)
-            winnerIdx = i;
-    }
-    const scores = {};
-    for (const l of live)
-        scores[l.label] = l.score;
-    const winner = live[winnerIdx];
-    const receipts = [];
-    // 3) PROMOTION GATE (ADR-171). The top score is a *nominee*, not a promotion.
-    //    A branch graduates into base only when cleared by a real oracle or an
-    //    explicitly-accepted Fable judge. proxy:structural / score-only never
-    //    clears. Fail-closed: requireClearance with no gate = ineligible.
-    const gate = opts.clearance;
-    const enforce = opts.requireClearance ?? !!gate;
-    let promoted = false;
-    let promotedBy = 'unverified';
-    let promotionDecision;
-    let promoteStats = null;
-    let clearance;
-    if (gate) {
-        try {
-            clearance = await gate(winner.result, winner.label);
-        }
-        catch (e) {
-            clearance = { cleared: false, by: 'proxy:structural', reason: `clearance threw: ${e?.message ?? e}` };
-        }
-    }
-    else if (enforce) {
-        clearance = { cleared: false, by: 'proxy:structural', reason: 'requireClearance set but no clearance gate provided' };
-    }
-    else {
-        clearance = { cleared: true, by: 'unverified', reason: 'legacy score-only promotion (no gate configured)' };
-    }
-    // proxy:structural can NEVER clear a promote, regardless of `cleared`.
-    const cleared = clearance.cleared
-        && (clearance.by === 'oracle:test-exec' || clearance.by === 'judge:fable' || (!enforce && clearance.by === 'unverified'));
-    if (cleared) {
-        promoteStats = winner.branch.promote(base);
-        if (persist)
-            winner.branch.save?.(manifestFor(winner.path));
-        winner.branch.close?.();
-        promoted = true;
-        promotedBy = clearance.by;
-        promotionDecision = `promoted:${clearance.by}`;
-    }
-    else {
-        // Winner is ineligible — base stays UNCHANGED. Emit a causal receipt and
-        // discard the branch (it did not earn graduation).
-        promotedBy = clearance.by;
-        promotionDecision = `ineligible:${clearance.by === 'proxy:structural' ? 'proxy-cannot-clear' : clearance.by}`;
-        receipts.push({
-            label: winner.label,
-            score: winner.score,
-            diff: safeDiff(winner.branch),
-            outcome: 'winner-ineligible',
-            provenance: clearance.by,
-            reason: clearance.reason ?? 'not cleared by oracle or accepted Fable judge',
-        });
-        winner.branch.close?.();
-        deleteBranchFiles(winner.path);
-    }
-    // 4) Discard the losers — receipt each, close handle, delete files.
-    const discarded = [];
-    for (let i = 0; i < live.length; i++) {
-        if (i === winnerIdx)
-            continue;
-        receipts.push({
-            label: live[i].label,
-            score: live[i].score,
-            diff: safeDiff(live[i].branch),
-            outcome: 'discarded-loser',
-            provenance: 'proxy:structural',
-            reason: `lower score than winner (${live[i].score} < ${winner.score})`,
-        });
-        live[i].branch.close?.();
-        deleteBranchFiles(live[i].path);
-        discarded.push(live[i].label);
-    }
-    const branches = live.map((l, i) => ({
-        label: l.label,
-        path: l.path,
-        score: l.score,
-        result: l.result,
-        kept: i === winnerIdx && promoted,
-    }));
-    return {
-        winner: winner.label,
-        scores,
-        promoted,
-        promotedBy,
-        promotionDecision,
-        promoteStats,
-        discarded,
-        receipts,
-        branches,
-    };
-}
-/**
- * Convenience wrapper that owns the whole lifecycle for a file-path base:
- * loads agenticow (returns `null` when the optional dep is absent), opens the
- * base with its lineage, runs {@link explore}, then persists the mutated base.
- *
- * Returns `null` when agenticow is not installed so callers can emit the
- * standard `{degraded:true}` contract.
- */
-export async function exploreFromPath(basePath, candidates, score, opts) {
-    const api = opts.api ?? (await loadAgenticow());
-    if (!api)
-        return null;
-    const resolvedBase = resolveMemoryPath(basePath);
-    const base = await openWithLineage(api, resolvedBase, opts.dimension);
-    try {
-        const result = await explore(base, candidates, score, opts);
-        if (opts.persist !== false) {
-            base.save?.(manifestFor(resolvedBase));
-        }
-        return result;
-    }
-    finally {
-        base.close?.();
-    }
-}
-//# sourceMappingURL=speculative-exploration.js.map