opencode-swarm 6.17.3 → 6.18.1

package/dist/commands/index.d.ts

@@ -16,9 +16,12 @@ export { handlePlanCommand } from './plan';
 export { handlePreflightCommand } from './preflight';
 export { handleResetCommand } from './reset';
 export { handleRetrieveCommand } from './retrieve';
+export { handleRollbackCommand } from './rollback';
+export { handleSimulateCommand } from './simulate';
 export { handleSpecifyCommand } from './specify';
 export { handleStatusCommand } from './status';
 export { handleSyncPlanCommand } from './sync-plan';
+export { handleWriteRetroCommand } from './write_retro';
 /**
  * Creates a command.execute.before handler for /swarm commands.
  * Uses factory pattern to close over directory and agents.

package/dist/commands/reset.d.ts

@@ -1,6 +1,7 @@
 /**
  * Handles the /swarm reset command.
  * Clears plan.md and context.md from .swarm/ directory.
+ * Stops background automation and resets in-memory queues.
  * Requires --confirm flag as a safety gate.
  */
 export declare function handleResetCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/rollback.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handle /swarm rollback command
+ * Restores .swarm/ state from a checkpoint using direct overwrite
+ */
+export declare function handleRollbackCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/simulate.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handle /swarm simulate command
+ * Performs read-only impact analysis using existing tools
+ */
+export declare function handleSimulateCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/write_retro.d.ts

@@ -0,0 +1 @@
+export declare function handleWriteRetroCommand(directory: string, args: string[]): Promise<string>;

package/dist/hooks/co-change-suggester.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Co-Change Suggester Hook
+ *
+ * Analyzes file modifications and suggests co-change partners based on
+ * historical co-change data from .swarm/co-change.json. This hook fires
+ * after file-write tools complete and logs suggestions when co-change
+ * partners are detected.
+ */
+/**
+ * Represents a single co-change entry from the JSON file
+ */
+export interface CoChangeJsonEntry {
+    /** First file in the co-change pair */
+    fileA: string;
+    /** Second file in the co-change pair */
+    fileB: string;
+    /** Number of times these files were changed together */
+    coChangeCount: number;
+    /** Normalized Pointwise Mutual Information score (0-1) */
+    npmi: number;
+}
+/**
+ * Root structure of the co-change JSON file
+ */
+export interface CoChangeJson {
+    /** File format version */
+    version: string;
+    /** ISO timestamp when the file was generated */
+    generated: string;
+    /** Array of co-change entries */
+    entries: CoChangeJsonEntry[];
+}
+/**
+ * Reads and parses the .swarm/co-change.json file
+ * @param directory - The project directory containing .swarm folder
+ * @returns Parsed CoChangeJson or null if not found/invalid
+ */
+export declare function readCoChangeJson(directory: string): Promise<CoChangeJson | null>;
+/**
+ * Finds co-change partners for a given file
+ * @param entries - Array of co-change entries to search
+ * @param filePath - The file path to find partners for
+ * @returns Array of entries where the file appears as fileA or fileB
+ */
+export declare function getCoChangePartnersForFile(entries: CoChangeJsonEntry[], filePath: string): CoChangeJsonEntry[];
+/**
+ * Creates the co-change suggester hook
+ * @param directory - The project directory containing .swarm folder
+ * @returns A hook function that analyzes file writes for co-change suggestions
+ */
+export declare function createCoChangeSuggesterHook(directory: string): (input: unknown, output: unknown) => Promise<void>;

package/dist/hooks/dark-matter-detector.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Dark Matter Detector Hook
+ *
+ * This hook reads `.swarm/dark-matter.md` — a markdown file that lists
+ * unresolved coupling gaps. When unconsumed items exist in this file,
+ * the hook logs a reminder hint to the user.
+ */
+/**
+ * Parses dark matter gaps from markdown content
+ *
+ * @param content - The markdown content to parse
+ * @returns Object containing arrays of unresolved and resolved gap descriptions
+ */
+export declare function parseDarkMatterGaps(content: string): {
+    unresolved: string[];
+    resolved: string[];
+};
+/**
+ * Reads and parses the dark matter gaps file
+ *
+ * @param directory - The project directory containing .swarm folder
+ * @returns Object with unresolved and resolved gaps, or null if file not found/empty
+ */
+export declare function readDarkMatterMd(directory: string): Promise<{
+    unresolved: string[];
+    resolved: string[];
+} | null>;
+/**
+ * Creates the dark matter detector hook
+ *
+ * This hook fires on `toolAfter` and checks for unresolved coupling gaps
+ * in `.swarm/dark-matter.md`. It logs a reminder hint when gaps exist,
+ * with rate-limiting to avoid excessive file I/O.
+ *
+ * @param directory - The project directory containing .swarm folder
+ * @returns Hook function that checks for unresolved dark matter gaps
+ */
+export declare function createDarkMatterDetectorHook(directory: string): (input: unknown, output: unknown) => Promise<void>;

package/dist/hooks/guardrails.d.ts

@@ -9,10 +9,11 @@
 import { type GuardrailsConfig } from '../config/schema';
 /**
  * Creates guardrails hooks for circuit breaker protection
+ * @param directory Working directory (from plugin init context)
  * @param config Guardrails configuration
  * @returns Tool before/after hooks and messages transform hook
  */
-export declare function createGuardrailsHooks(config: GuardrailsConfig): {
+export declare function createGuardrailsHooks(directory: string, config: GuardrailsConfig): {
     toolBefore: (input: {
         tool: string;
         sessionID: string;

package/dist/hooks/knowledge-curator.d.ts

@@ -1,5 +1,10 @@
 /** Knowledge curator hook for opencode-swarm v6.17 two-tier knowledge system. */
 import type { KnowledgeConfig } from './knowledge-types.js';
+/**
+ * Check if the input is a write operation targeting an evidence file.
+ * Exported for testing purposes only.
+ */
+export declare function isWriteToEvidenceFile(input: unknown): boolean;
 /**
  * Curate and store swarm knowledge entries from lessons.
  */

package/dist/hooks/steering-consumed.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Steering consumed hook for OpenCode Swarm
+ *
+ * Provides mechanisms for recording and tracking steering directive consumption.
+ * Writes steering-consumed events to .swarm/events.jsonl for health check verification.
+ */
+/**
+ * Event written to .swarm/events.jsonl when a steering directive is consumed
+ */
+export interface SteeringConsumedEvent {
+    type: 'steering-consumed';
+    directiveId: string;
+    timestamp: string;
+}
+/**
+ * Records a steering-consumed event to the events.jsonl file.
+ * Synchronous function that appends a single JSON line.
+ *
+ * @param directory - The project directory containing the .swarm folder
+ * @param directiveId - The ID of the steering directive that was consumed
+ */
+export declare function recordSteeringConsumed(directory: string, directiveId: string): void;
+/**
+ * Creates a hook that records steering-consumed events for any unconsumed directives.
+ * Reads events.jsonl to find steering-directive events without matching consumed events.
+ *
+ * @param directory - The project directory containing the .swarm folder
+ * @returns A fire-and-forget hook function
+ */
+export declare function createSteeringConsumedHook(directory: string): (input: unknown, output: unknown) => Promise<void>;