claude-mycelium 2.0.0 → 2.2.0

package/dist/index.d.ts

@@ -9,10 +9,11 @@
  * - LLM: Anthropic integration
  * - Trace: Event tracking
  * - Cost: Token and cost tracking
+ * - Task: LLM-based task planning and execution (Phase 5)
  * - Utils: Logging, file I/O, configuration
  * - Types: Complete TypeScript interfaces
  *
- * Per initial-spec and Phase 2 spec.
+ * Per initial-spec, Phase 2 spec, and Phase 5 (Task System).
  *
  * Usage:
  * ```typescript
@@ -22,6 +23,8 @@
  *   createAnthropicClient,
  *   recordTraceEvent,
  *   calculateCost,
+ *   planTask,
+ *   executeTask,
  * } from 'claude-mycelium';
  * ```
  */
@@ -30,6 +33,7 @@ export * from './coordination/index.js';
 export { createAnthropicClient, type LLMRequest, type LLMResponse, LLMError } from './llm/index.js';
 export * from './trace/index.js';
 export * from './cost/index.js';
+export * from './task/index.js';
 export * from './utils/index.js';
 export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AAIxC,OAAO,EAAE,qBAAqB,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpG,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AAIxC,OAAO,EAAE,qBAAqB,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpG,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -9,10 +9,11 @@
  * - LLM: Anthropic integration
  * - Trace: Event tracking
  * - Cost: Token and cost tracking
+ * - Task: LLM-based task planning and execution (Phase 5)
  * - Utils: Logging, file I/O, configuration
  * - Types: Complete TypeScript interfaces
  *
- * Per initial-spec and Phase 2 spec.
+ * Per initial-spec, Phase 2 spec, and Phase 5 (Task System).
  *
  * Usage:
  * ```typescript
@@ -22,6 +23,8 @@
  *   createAnthropicClient,
  *   recordTraceEvent,
  *   calculateCost,
+ *   planTask,
+ *   executeTask,
  * } from 'claude-mycelium';
  * ```
  */
@@ -33,6 +36,8 @@ export * from './coordination/index.js';
 export { createAnthropicClient, LLMError } from './llm/index.js';
 export * from './trace/index.js';
 export * from './cost/index.js';
+// Phase 5: Task System
+export * from './task/index.js';
 // Utilities
 export * from './utils/index.js';
 // Types

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,uBAAuB;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AAExC,sEAAsE;AACtE,2EAA2E;AAC3E,OAAO,EAAE,qBAAqB,EAAqC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpG,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,uBAAuB;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AAExC,sEAAsE;AACtE,2EAA2E;AAC3E,OAAO,EAAE,qBAAqB,EAAqC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpG,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAEhC,uBAAuB;AACvB,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,cAAc,kBAAkB,CAAC"}

package/dist/prompts/index.d.ts

@@ -5,7 +5,8 @@
  * Mode-specific prompts for guiding agents.
  * Each prompt provides context and instructions for a specific improvement mode.
  */
-import type { Mode, GradientScore } from '../types/index.js';
+import type { Mode } from '../types/index.js';
+import type { GradientScore } from '../core/gradient.js';
 export { generatePrompt as generateErrorReducerPrompt } from './error-reducer.js';
 export { generatePrompt as generateComplexityReducerPrompt } from './complexity-reducer.js';
 export { generatePrompt as generateDebtPayerPrompt } from './debt-payer.js';

package/dist/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkE3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkE3C"}

package/dist/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAI7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,IAAU,EACV,QAAuB;IAEvB,oBAAoB;IACpB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE9C,gBAAgB;IAChB,MAAM,OAAO,GAAkB;QAC7B,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,IAAI;KACL,CAAC;IAEF,gCAAgC;IAChC,IAAI,UAAkB,CAAC;IACvB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC9D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACnE,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC3D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC3D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,iDAAiD;YACjD,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM;QACR,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,2CAA2C;IAC3C,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;oCAea,CAAC;IAEnC,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,UAAU;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAsB;IACjD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE5C,OAAO;sBACa,IAAI;;;gBAGV,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;sBACnB,QAAQ,CAAC,cAAc,CAAC,IAAI,MAAM,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;EAgB9F,OAAO;;;;6EAIoE,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAI7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,IAAU,EACV,QAAuB;IAEvB,oBAAoB;IACpB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE9C,gBAAgB;IAChB,MAAM,OAAO,GAAkB;QAC7B,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,IAAI;KACL,CAAC;IAEF,gCAAgC;IAChC,IAAI,UAAkB,CAAC;IACvB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC9D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACnE,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC3D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC3D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,iDAAiD;YACjD,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM;QACR,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,2CAA2C;IAC3C,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;oCAea,CAAC;IAEnC,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,UAAU;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAsB;IACjD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE5C,OAAO;sBACa,IAAI;;;gBAGV,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;sBACnB,QAAQ,CAAC,cAAc,CAAC,IAAI,MAAM,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;EAgB9F,OAAO;;;;6EAIoE,CAAC;AAC9E,CAAC"}

package/dist/quarantine/explorer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Explorer Mode Spawning for Claude-Mycelium
+ * Adaptive probability based on system efficiency and centrality
+ * Reference: initial-spec §7, second-spec §10
+ */
+import type { Gradient, TraceEvent } from '../types/index.js';
+export interface ExplorerConfig {
+    baseProbability: number;
+    maxProbability: number;
+    efficiencyThreshold: number;
+    lookbackRuns: number;
+}
+/**
+ * Determine if explorer should spawn based on system-wide efficiency
+ * Probability increases as efficiency drops
+ *
+ * Formula from spec:
+ * - efficiency >= 0.3 → 5% chance
+ * - efficiency = 0.15 → 15% chance
+ * - efficiency = 0.0 → 25% chance
+ */
+export declare function shouldSpawnExplorer(getRecentTraces: (limit: number) => Promise<TraceEvent[]>, config?: ExplorerConfig): Promise<boolean>;
+/**
+ * Select target for explorer mode
+ * Priority:
+ * 1. Quarantined files with explorer attempts remaining
+ * 2. Highest gradient non-quarantined file
+ */
+export declare function selectExplorerTarget(gradients: Gradient[], isFileLocked: (file: string) => Promise<boolean>): Promise<string | null>;
+/**
+ * Calculate explorer spawn probability for a specific file
+ * Based on centrality: 0.1 × (1 + centrality)
+ *
+ * Examples from spec:
+ * - centrality 0.0 → 10% chance
+ * - centrality 0.5 → 15% chance
+ * - centrality 1.0 → 20% chance
+ */
+export declare function calculateExplorerProbability(centrality: number): number;
+/**
+ * Check if explorer should be spawned for a specific file
+ * Uses centrality-based probability
+ */
+export declare function shouldSpawnExplorerForFile(centrality: number): boolean;
+/**
+ * Execute explorer mode with different system prompt
+ * Explorer has:
+ * - Higher temperature (more creative)
+ * - Different instruction set (exploratory)
+ * - Less constrained by patterns
+ */
+export interface ExplorerPromptConfig {
+    temperature: number;
+    systemPromptAddition: string;
+}
+export declare const EXPLORER_PROMPT_CONFIG: ExplorerPromptConfig;
+/**
+ * Get explorer mode configuration
+ */
+export declare function getExplorerConfig(): ExplorerPromptConfig;
+/**
+ * Format explorer instructions for prompt
+ */
+export declare function formatExplorerInstructions(file: string, isQuarantined: boolean, explorerAttempts: number): string;
+//# sourceMappingURL=explorer.d.ts.map

package/dist/quarantine/explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.d.ts","sourceRoot":"","sources":["../../src/quarantine/explorer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ9D,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AASD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,EACzD,MAAM,GAAE,cAA+B,GACtC,OAAO,CAAC,OAAO,CAAC,CA0ClB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,QAAQ,EAAE,EACrB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC/C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,sBAAsB,EAAE,oBAsBpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,CAExD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,OAAO,EACtB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAqBR"}

package/dist/quarantine/explorer.js

@@ -0,0 +1,175 @@
+/**
+ * Explorer Mode Spawning for Claude-Mycelium
+ * Adaptive probability based on system efficiency and centrality
+ * Reference: initial-spec §7, second-spec §10
+ */
+import { logInfo, logDebug, logError } from '../utils/logger.js';
+import { getQuarantinedFiles, canExplorerAttempt, recordExplorerAttempt, isQuarantined, } from './manager.js';
+const DEFAULT_CONFIG = {
+    baseProbability: 0.05, // 5% base chance
+    maxProbability: 0.25, // 25% max chance
+    efficiencyThreshold: 0.3, // Below this, increase probability
+    lookbackRuns: 20,
+};
+/**
+ * Determine if explorer should spawn based on system-wide efficiency
+ * Probability increases as efficiency drops
+ *
+ * Formula from spec:
+ * - efficiency >= 0.3 → 5% chance
+ * - efficiency = 0.15 → 15% chance
+ * - efficiency = 0.0 → 25% chance
+ */
+export async function shouldSpawnExplorer(getRecentTraces, config = DEFAULT_CONFIG) {
+    try {
+        const recentTraces = await getRecentTraces(config.lookbackRuns);
+        if (recentTraces.length < 10) {
+            // Not enough data
+            return false;
+        }
+        // Calculate system-wide efficiency
+        const efficiencies = recentTraces.map(t => t.efficiency || 0);
+        const avgEfficiency = efficiencies.reduce((a, b) => a + b, 0) / efficiencies.length;
+        // Probability increases as efficiency drops
+        const efficiencyFactor = Math.max(0, config.efficiencyThreshold - avgEfficiency) / config.efficiencyThreshold;
+        const probability = config.baseProbability +
+            (config.maxProbability - config.baseProbability) * efficiencyFactor;
+        const shouldSpawn = Math.random() < probability;
+        if (shouldSpawn) {
+            logInfo('Explorer spawn triggered', {
+                avgEfficiency: avgEfficiency.toFixed(3),
+                probability: (probability * 100).toFixed(1) + '%',
+            });
+        }
+        else {
+            logDebug('Explorer spawn skipped', {
+                avgEfficiency: avgEfficiency.toFixed(3),
+                probability: (probability * 100).toFixed(1) + '%',
+            });
+        }
+        return shouldSpawn;
+    }
+    catch (error) {
+        logError('Failed to check explorer spawn', error);
+        return false;
+    }
+}
+/**
+ * Select target for explorer mode
+ * Priority:
+ * 1. Quarantined files with explorer attempts remaining
+ * 2. Highest gradient non-quarantined file
+ */
+export async function selectExplorerTarget(gradients, isFileLocked) {
+    try {
+        // First, try quarantined files that still have explorer attempts
+        const quarantined = await getQuarantinedFiles();
+        for (const entry of quarantined) {
+            if (await canExplorerAttempt(entry.file)) {
+                const locked = await isFileLocked(entry.file);
+                if (!locked) {
+                    logInfo('Explorer targeting quarantined file', {
+                        file: entry.file,
+                        attempts: entry.explorer_attempts,
+                        max: entry.max_explorer_attempts,
+                    });
+                    // Record the attempt
+                    await recordExplorerAttempt(entry.file);
+                    return entry.file;
+                }
+            }
+        }
+        // Otherwise, pick highest gradient non-quarantined file
+        const sorted = [...gradients].sort((a, b) => b.score - a.score);
+        for (const g of sorted) {
+            const quarantinedCheck = await isQuarantined(g.file);
+            const lockedCheck = await isFileLocked(g.file);
+            if (!quarantinedCheck && !lockedCheck) {
+                logInfo('Explorer targeting high-gradient file', {
+                    file: g.file,
+                    gradient: g.score.toFixed(3),
+                });
+                return g.file;
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        logError('Failed to select explorer target', error);
+        return null;
+    }
+}
+/**
+ * Calculate explorer spawn probability for a specific file
+ * Based on centrality: 0.1 × (1 + centrality)
+ *
+ * Examples from spec:
+ * - centrality 0.0 → 10% chance
+ * - centrality 0.5 → 15% chance
+ * - centrality 1.0 → 20% chance
+ */
+export function calculateExplorerProbability(centrality) {
+    return 0.1 * (1 + centrality);
+}
+/**
+ * Check if explorer should be spawned for a specific file
+ * Uses centrality-based probability
+ */
+export function shouldSpawnExplorerForFile(centrality) {
+    const probability = calculateExplorerProbability(centrality);
+    return Math.random() < probability;
+}
+export const EXPLORER_PROMPT_CONFIG = {
+    temperature: 0.8, // More creative than normal modes
+    systemPromptAddition: `
+## Explorer Mode
+
+You are in EXPLORER mode. This file has resisted conventional approaches.
+
+Your goal is to try creative, unconventional solutions that other modes might not consider:
+- Radical refactoring
+- Complete rewrites of problematic sections
+- Alternative algorithms or patterns
+- Breaking changes if necessary
+
+Don't be constrained by existing patterns. Think outside the box.
+
+Success criteria:
+- Meaningful gradient improvement (efficiency > 0.2)
+- CI passes
+- Code quality maintained or improved
+
+Be bold but careful.
+`,
+};
+/**
+ * Get explorer mode configuration
+ */
+export function getExplorerConfig() {
+    return { ...EXPLORER_PROMPT_CONFIG };
+}
+/**
+ * Format explorer instructions for prompt
+ */
+export function formatExplorerInstructions(file, isQuarantined, explorerAttempts) {
+    if (isQuarantined) {
+        return `
+## 🔬 Explorer Mode: Quarantined File
+
+File: ${file}
+Status: QUARANTINED (${explorerAttempts} explorer attempts made)
+
+This file has failed ${explorerAttempts > 0 ? 'multiple' : 'many'} conventional improvement attempts.
+Try creative, unconventional approaches. Don't be afraid to make bold changes.
+`;
+    }
+    return `
+## 🔬 Explorer Mode: Creative Exploration
+
+File: ${file}
+Status: Selected for exploratory improvement
+
+Try innovative approaches that might not be obvious. Think creatively.
+`;
+}
+//# sourceMappingURL=explorer.js.map

package/dist/quarantine/explorer.js.map

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

package/dist/quarantine/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Quarantine System for Claude-Mycelium
+ * Exports quarantine manager and explorer mode
+ */
+export * from './manager.js';
+export * from './explorer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/quarantine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quarantine/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/quarantine/index.js

@@ -0,0 +1,7 @@
+/**
+ * Quarantine System for Claude-Mycelium
+ * Exports quarantine manager and explorer mode
+ */
+export * from './manager.js';
+export * from './explorer.js';
+//# sourceMappingURL=index.js.map

package/dist/quarantine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/quarantine/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/quarantine/manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Quarantine Manager for Claude-Mycelium
+ * Full withdrawal mechanism when files resist all approaches
+ * Storage: .agent-meta/_quarantine.json
+ * Reference: initial-spec §6, second-spec §9
+ */
+import type { TraceEvent } from '../types/index.js';
+export interface QuarantineEntry {
+    file: string;
+    quarantined_at: string;
+    reason: string;
+    attempts_before_quarantine: number;
+    explorer_attempts: number;
+    max_explorer_attempts: number;
+}
+export interface QuarantineState {
+    updated_at: string;
+    entries: QuarantineEntry[];
+}
+export interface QuarantineConfig {
+    minSamplesBeforeQuarantine: number;
+    efficiencyThreshold: number;
+    maxExplorerAttempts: number;
+}
+/**
+ * Check if a file should be quarantined
+ * Trigger: 10+ samples, all with efficiency < 0.02
+ */
+export declare function shouldQuarantine(file: string, getTracesForFile: (file: string) => Promise<TraceEvent[]>, config?: QuarantineConfig): Promise<boolean>;
+/**
+ * Add a file to quarantine
+ */
+export declare function addToQuarantine(entry: QuarantineEntry): Promise<void>;
+/**
+ * Check if a file is quarantined
+ */
+export declare function isQuarantined(file: string): Promise<boolean>;
+/**
+ * Get quarantine entry for a file
+ */
+export declare function getQuarantineEntry(file: string): Promise<QuarantineEntry | null>;
+/**
+ * Check if explorer can attempt quarantined file
+ */
+export declare function canExplorerAttempt(file: string): Promise<boolean>;
+/**
+ * Record an explorer attempt on quarantined file
+ */
+export declare function recordExplorerAttempt(file: string): Promise<void>;
+/**
+ * Check if quarantine should be released after explorer success
+ * Only explorer mode with efficiency >= 0.2 can release
+ */
+export declare function checkQuarantineRelease(file: string, trace: TraceEvent): Promise<boolean>;
+/**
+ * Remove a file from quarantine
+ */
+export declare function removeFromQuarantine(file: string): Promise<void>;
+/**
+ * Get all quarantined files
+ */
+export declare function getQuarantinedFiles(): Promise<QuarantineEntry[]>;
+/**
+ * Check and potentially quarantine a file after agent run
+ */
+export declare function checkAndQuarantine(file: string, getTracesForFile: (file: string) => Promise<TraceEvent[]>, config?: QuarantineConfig): Promise<boolean>;
+/**
+ * Get quarantine statistics
+ */
+export declare function getQuarantineStats(): Promise<{
+    total: number;
+    withExplorerAttempts: number;
+    exhausted: number;
+}>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/quarantine/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/quarantine/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B,EAAE,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B,EAAE,MAAM,CAAC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAQD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,EACzD,MAAM,GAAE,gBAAiC,GACxC,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B3E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQtF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUvE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBvE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAQtE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,EACzD,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAoCD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAeD"}