@wrongstack/core 0.308.7 → 0.309.1

package/dist/coordination/director/director-toolset.d.ts

@@ -1,7 +1,7 @@
 import type { SubagentConfig } from '../../types/multi-agent.js';
 import type { Tool } from '../../types/tool.js';
-import { makeAskResultTool, makeAskTool, makeAssignTool, makeAwaitTasksTool, makeCollabDebugTool, makeFleetEmitTool, makeFleetTool, makeKanbanQueueTool, makeQualityGateTool, makeRollUpTool, makeSpawnTool, makeTerminateAllTool, makeTerminateTool, makeWorkCompleteTool } from '../director-tools.js';
-type DirectorToolsetHost = Parameters<typeof makeSpawnTool>[0] & Parameters<typeof makeAssignTool>[0] & Parameters<typeof makeKanbanQueueTool>[0] & Parameters<typeof makeAwaitTasksTool>[0] & Parameters<typeof makeAskTool>[0] & Parameters<typeof makeAskResultTool>[0] & Parameters<typeof makeRollUpTool>[0] & Parameters<typeof makeQualityGateTool>[0] & Parameters<typeof makeTerminateTool>[0] & Parameters<typeof makeTerminateAllTool>[0] & Parameters<typeof makeFleetTool>[0] & Parameters<typeof makeCollabDebugTool>[0] & Parameters<typeof makeFleetEmitTool>[0] & Parameters<typeof makeWorkCompleteTool>[0];
+import { makeAskResultTool, makeAskTool, makeAssignTool, makeAwaitTasksTool, makeCollabDebugTool, makeFleetEmitTool, makeFleetTool, makeKanbanQueueTool, makeMutationTestTool, makeQualityGateTool, makeRollUpTool, makeSpawnTool, makeTerminateAllTool, makeTerminateTool, makeWorkCompleteTool } from '../director-tools.js';
+type DirectorToolsetHost = Parameters<typeof makeSpawnTool>[0] & Parameters<typeof makeAssignTool>[0] & Parameters<typeof makeKanbanQueueTool>[0] & Parameters<typeof makeAwaitTasksTool>[0] & Parameters<typeof makeAskTool>[0] & Parameters<typeof makeAskResultTool>[0] & Parameters<typeof makeRollUpTool>[0] & Parameters<typeof makeQualityGateTool>[0] & Parameters<typeof makeMutationTestTool>[0] & Parameters<typeof makeTerminateTool>[0] & Parameters<typeof makeTerminateAllTool>[0] & Parameters<typeof makeFleetTool>[0] & Parameters<typeof makeCollabDebugTool>[0] & Parameters<typeof makeFleetEmitTool>[0] & Parameters<typeof makeWorkCompleteTool>[0];
 export declare function buildDirectorToolset(director: DirectorToolsetHost, roster?: Record<string, SubagentConfig>): Tool[];
 export {};
 //# sourceMappingURL=director-toolset.d.ts.map

package/dist/coordination/director-mutation-test-tool.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `mutation_test` — director-facing tool behind the Chaos Monkey
+ * ("Kaos Maymunu") mutation-testing flow.
+ *
+ * Green tests prove nothing if they cannot detect sabotage. This tool:
+ *   1. Reads each target file in-process and computes a DETERMINISTIC
+ *      mutation plan (`mutation-engine.ts`) — boundary relax/tighten,
+ *      `+`↔`-`, boolean flips, `return null`.
+ *   2. Spawns ONE chaos-monkey subagent with the exact plan. The subagent
+ *      applies each mutant one at a time in its checkout, runs the test
+ *      command, records killed/survived, and restores byte-for-byte.
+ *   3. Parses the structured report and, when survivors exist and a
+ *      `repairSubagentId` was supplied, loops: strengthen-tests task →
+ *      re-run the surviving mutants only. A mutant that survives twice
+ *      is reported as `suspected-equivalent` — a code smell, not a test
+ *      bug — so the loop always terminates without ping-ponging.
+ *
+ * The LLM never invents mutants: the plan is mechanical, so two runs over
+ * the same source produce the same ids and the comparison is honest.
+ *
+ * @module coordination/director-mutation-test-tool
+ */
+import type { SubagentConfig } from '../types/multi-agent.js';
+import type { Tool } from '../types/tool.js';
+import type * as Host from './director-host-contracts.js';
+export declare function makeMutationTestTool(director: Host.DirectorRepairPort, roster?: Record<string, SubagentConfig>, opts?: {
+    projectRoot?: string | undefined;
+}): Tool;
+//# sourceMappingURL=director-mutation-test-tool.d.ts.map

package/dist/coordination/director-tools.d.ts

@@ -4,6 +4,8 @@ import type * as Host from './director-host-contracts.js';
 export { makeAskResultTool, makeAskTool, makeAssignTool, makeAwaitTasksTool, makeFleetTool, makeRollUpTool, makeTerminateAllTool, makeTerminateTool, } from './director-basic-tools.js';
 export { makeCollabDebugTool, makeFleetEmitTool, makeWorkCompleteTool, } from './director-collab-tools.js';
 export { makeQualityGateTool } from './director-quality-gate-tool.js';
+export { makeMutationTestTool } from './director-mutation-test-tool.js';
+export { applyMutation, type MutationKind, type MutationPlanItem, parseMutationReport, planMutations, } from './mutation-engine.js';
 export declare function makeSpawnTool(director: Host.DirectorAdmissionPort, roster?: Record<string, SubagentConfig>): Tool;
 export declare function makeKanbanQueueTool(director: Host.DirectorLeaseRecoveryPort, roster?: Record<string, SubagentConfig>): Tool;
 //# sourceMappingURL=director-tools.d.ts.map

package/dist/coordination/director.d.ts

@@ -56,6 +56,13 @@ export declare class Director implements DirectorFleetHost, ICoordinator {
     private readonly subagentIdleTimeoutMs;
     private readonly retireSubagentOnTaskComplete;
     private readonly subagentIdleTimers;
+    /**
+     * Effective idle window per subagent (spawn-time `idleTimeoutMs` override
+     * or the Director-wide default; undefined = no window). Internal-task
+     * completion re-arms with THIS value, not the Director-wide default, so
+     * a subagent-configured window survives its first internal probe.
+     */
+    private readonly subagentIdleDelayMs;
     readonly sharedScratchpadPath: string | null;
     readonly maxSpawns: number;
     readonly maxSpawnDepth: number;
@@ -92,6 +99,15 @@ export declare class Director implements DirectorFleetHost, ICoordinator {
     extensionsFor(subagentId: string): number;
     workComplete(): void;
     isWorkComplete(): boolean;
+    /**
+     * Ask every running background subagent that opted into `gracefulFinish`
+     * to finish its task in its own turn. In-band notification between tool
+     * batches — no interrupt, no abort; each subagent keeps its time budget and
+     * accelerates. Session shutdown calls this before draining Chimera work so
+     * the post-session reviewer is nudged to complete rather than killed.
+     * Returns the number of subagents notified.
+     */
+    requestFinish(reason: string): number;
     setLeaderBtwNote(note: string): number;
     getLeaderBtwNotes(): string[];
     peekLeaderBtwNotes(): string[];

package/dist/coordination/explore-companion.d.ts

@@ -76,12 +76,15 @@ export interface ExploreCompanionOptions {
     /** Project mailbox the companion polls for explicit asks and acks them. */
     mailbox: Mailbox;
     /**
-     * Leader session id used to filter out subagent events. The companion
-     * subscribes to global events (tool.executed, error, session.agents_updated)
-     * which fire for BOTH the leader and subagents. When set, any event whose
-     * `sessionId` differs from this value is skipped. Events without a
-     * `sessionId` field always pass through (backward compatibility). Pass a
-     * lazy getter when the session id may change at runtime.
+     * Leader session id used to filter events down to this leader only. The
+     * companion subscribes to global events (tool.executed, error,
+     * session.agents_updated) which fire for BOTH the leader and subagents.
+     * Strict, fail-closed: an event passes only when its `sessionId` equals
+     * this value — unstamped events are dropped (production emitters always
+     * stamp; an unstamped event is assumed to be a subagent's), and a
+     * transiently unresolved getter drops everything rather than probing on
+     * unattributed activity. Pass a lazy getter when the session id may
+     * change at runtime.
      */
     leaderSessionId: string | (() => string | undefined);
     /**

package/dist/coordination/fleet.d.ts

@@ -38,6 +38,18 @@ export declare const SECURITY_SCANNER_AGENT: SubagentConfig;
  * awaited; idle reaping comes from the FLEET_ROSTER_BUDGETS entry.
  */
 export declare const EXPLORE_COMPANION_AGENT: SubagentConfig;
+/**
+ * Chaos Monkey ("Kaos Maymunu") — one-shot mutation-testing saboteur.
+ * Use for: proving whether tests actually pin down the code they cover.
+ *
+ * Operational role — deliberately NOT in ALL_AGENT_DEFINITIONS (like
+ * `shadow-agent` and `explore-companion`), so the free-form dispatcher
+ * never routes to it and the phase-catalog count stays intact. The
+ * `mutation_test` director tool computes the deterministic mutation plan
+ * and hands this agent an exact apply/run/restore checklist; the agent
+ * never invents mutants.
+ */
+export declare const CHAOS_MONKEY_AGENT: SubagentConfig;
 /** Generic template used directly or cloned into project-specific roles. */
 export declare const GENERIC_AGENT: SubagentConfig;
 export declare const FLEET_ROSTER: Record<string, SubagentConfig>;

package/dist/coordination/index.d.ts

@@ -15,7 +15,7 @@ export { attachDepWatcherBridge, type DepWatcherBridgeOptions, } from './dep-wat
 export { Director, FleetCostCapError, FleetSpawnBudgetError, FleetTokenCapError, type TaskResultNotification, } from './director.js';
 export { composeDirectorPrompt, composeSubagentPrompt, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_SUBAGENT_BASELINE, type DirectorPromptParts, rosterSummaryFromConfigs, type SubagentPromptParts, } from './director-prompts.js';
 export { type DirectorSessionFactory, type DirectorSessionFactoryOptions, makeDirectorSessionFactory, } from './director-session.js';
-export { makeAskResultTool, makeAskTool, makeAssignTool, makeAwaitTasksTool, makeCollabDebugTool, makeFleetEmitTool, makeFleetTool, makeKanbanQueueTool, makeQualityGateTool, makeRollUpTool, makeSpawnTool, makeTerminateAllTool, makeTerminateTool, makeWorkCompleteTool, } from './director-tools.js';
+export { makeAskResultTool, makeAskTool, makeAssignTool, makeAwaitTasksTool, makeCollabDebugTool, makeFleetEmitTool, makeFleetTool, makeKanbanQueueTool, makeMutationTestTool, makeQualityGateTool, makeRollUpTool, makeSpawnTool, makeTerminateAllTool, makeTerminateTool, makeWorkCompleteTool, } from './director-tools.js';
 export { DEFAULT_DISPATCH_ROLE, type DispatchCandidate, type DispatchClassifier, type DispatchMethod, type DispatchOptions, type DispatchResult, dispatchAgent, makeLLMClassifier, scoreAgents, } from './dispatcher.js';
 export { type FileAuthorTrackerOptions, recordFileAction } from './file-author-tracker.js';
 export { ACP_AGENTS, ALL_FLEET_AGENTS, AUDIT_LOG_AGENT, applyRosterBudget, BUG_HUNTER_AGENT, FLEET_ROSTER, FLEET_ROSTER_BUDGETS, FLEET_ROSTER_WITHACP, type FleetRosterBudget, GENERIC_AGENT, REFACTOR_PLANNER_AGENT, SECURITY_SCANNER_AGENT, } from './fleet.js';