opencode-swarm 7.0.0-beta.1 → 7.0.1

package/dist/hooks/self-review.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * self-review.test.ts
+ *
+ * Tests for self-review hook (Task 4.1):
+ * 1. Advisory injected when architect calls update_task_status with status=in_progress
+ * 2. NOT injected when status=completed (not in_progress)
+ * 3. NOT injected when calling session is not architect
+ * 4. Turbo-skip: NOT injected when session.turboMode=true and skip_in_turbo=true
+ * 5. Disabled: NOT injected when enabled=false
+ * 6. Advisory text contains self-review focus items
+ * 7. injectAdvisory errors are caught (non-blocking)
+ * 8. No advisory for other tools (not update_task_status)
+ */
+export {};

package/dist/hooks/semantic-diff-injection.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Semantic diff injection for the system-enhancer hook.
+ *
+ * Computes a semantic AST diff summary for changed files and produces
+ * a markdown block for injection into the reviewer agent's context.
+ *
+ * Failure mode: silent. If git is unavailable or AST diff fails,
+ * returns null — the reviewer simply doesn't get the extra context.
+ */
+/**
+ * Build a semantic diff summary block for the given changed files.
+ *
+ * For each file:
+ * 1. Gets old content from git HEAD (cat-file -e check first)
+ * 2. Gets new content from working tree
+ * 3. Runs computeASTDiff
+ * 4. Collects all AST diffs
+ * 5. Builds fileConsumers map from repo graph (getImporters().length per file)
+ * 6. Runs classifyChanges with fileConsumers
+ * 7. Runs generateSummary + generateSummaryMarkdown
+ *
+ * Returns null if no changes are detected or on failure.
+ */
+export declare function buildSemanticDiffBlock(directory: string, changedFiles: string[], maxFiles?: number): Promise<string | null>;

package/dist/hooks/slop-detector.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/slop-detector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Slop detector — PostToolUse hook that checks for AI code quality anti-patterns.
+ * Fires after Write and Edit tool calls. Runs 4 heuristics and emits an advisory
+ * system message when findings are detected. Non-blocking, <500ms.
+ */
+import type { SlopDetectorConfig } from '../config/schema';
+export type { SlopDetectorConfig };
+export interface SlopDetectorHook {
+    toolAfter: (input: {
+        tool: string;
+        sessionID: string;
+    }, output: {
+        output?: unknown;
+        args?: unknown;
+    }) => Promise<void>;
+}
+export declare function createSlopDetectorHook(config: SlopDetectorConfig, projectDir: string, injectSystemMessage: (sessionId: string, message: string) => void): SlopDetectorHook;

package/dist/hooks/slop-detector.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/spawn-helper.d.ts

@@ -0,0 +1,5 @@
+export declare function spawnAsync(command: string[], cwd: string, timeoutMs: number): Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+} | null>;

package/dist/hooks/spawn-helper.test.d.ts

@@ -0,0 +1 @@
+export {};

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>;

package/dist/hooks/system-enhancer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * System Enhancer Hook
+ *
+ * Enhances the system prompt with current phase information from the plan
+ * and cross-agent context from the activity log.
+ * Reads plan.md and injects phase context into the system prompt.
+ */
+import type { PluginConfig } from '../config';
+/**
+ * Build a retrospective injection string for the architect system message.
+ * Tier 1: direct phase-scoped lookup for same-plan previous phase.
+ * Tier 2: cross-project historical lessons (Phase 1 only).
+ * Returns null if no valid retrospective found.
+ */
+export declare function buildRetroInjection(directory: string, currentPhaseNumber: number, currentPlanTitle?: string): Promise<string | null>;
+/**
+ * Creates the experimental.chat.system.transform hook for system enhancement.
+ */
+export declare function createSystemEnhancerHook(config: PluginConfig, directory: string): Record<string, unknown>;
+/**
+ * Architect operational mode derived from plan state.
+ */
+export type ArchitectMode = 'DISCOVER' | 'PLAN' | 'EXECUTE' | 'PHASE-WRAP' | 'UNKNOWN';
+/**
+ * Detect the current architect operational mode based on plan state.
+ *
+ * @param directory - The project directory to check
+ * @returns The current architect mode based on plan state
+ */
+export declare function detectArchitectMode(directory: string): Promise<ArchitectMode>;

package/dist/hooks/tool-summarizer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool Output Summarizer Hook
+ *
+ * Intercepts oversized tool outputs in tool.execute.after,
+ * stores the full content to .swarm/summaries/, and replaces
+ * the output with a compact summary containing a retrieval ID.
+ */
+import type { SummaryConfig } from '../config/schema';
+/**
+ * Reset the summary ID counter. Used for testing.
+ */
+export declare function resetSummaryIdCounter(): void;
+/**
+ * Creates a tool.execute.after hook that summarizes oversized tool outputs.
+ *
+ * @param config - Summary configuration including enabled, thresholds, and limits
+ * @param directory - Base directory for storing full outputs
+ * @returns Async hook function for tool.execute.after
+ */
+export declare function createToolSummarizerHook(config: SummaryConfig, directory: string): (input: {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}, output: {
+    title: string;
+    output: string;
+    metadata: unknown;
+}) => Promise<void>;

package/dist/hooks/trajectory-logger.d.ts

@@ -0,0 +1,69 @@
+/**
+ * TRAJECTORY LOGGER (v6.31 Task 3.2)
+ *
+ * tool.execute.after hook that appends per-task tool call trajectories to a
+ * .swarm/evidence/{taskId}/trajectory.jsonl file. Only logs INSIDE delegation
+ * scope (when delegationActive is true on the session).
+ *
+ * Trajectories are used for post-hoc analysis, audit trails, and replay.
+ */
+export interface TrajectoryConfig {
+    enabled: boolean;
+    max_lines: number;
+}
+export interface TrajectoryEntry {
+    step: number;
+    agent: string;
+    action: string;
+    target: string;
+    intent: string;
+    timestamp: string;
+    result: 'success' | 'failure' | 'pending';
+    tool: string;
+    args_summary: string;
+    verdict: string;
+    elapsed_ms: number;
+}
+/**
+ * Truncates a trajectory file to the newest half when maxLines is exceeded.
+ * Reads all lines, keeps the newest half, rewrites the file.
+ *
+ * @param filePath - Absolute path to the trajectory.jsonl file
+ * @param maxLines - Maximum number of lines to retain
+ */
+export declare function truncateTrajectoryFile(filePath: string, maxLines: number): Promise<void>;
+/**
+ * Creates the trajectory logger hook pair.
+ *
+ * @param config - TrajectoryConfig { enabled: boolean (default true), max_lines: number (default 500) }
+ * @param _directory - Reserved for future use (evidence path derived from session taskId)
+ * @returns Object with toolAfter handler
+ */
+export declare function createTrajectoryLoggerHook(config: Partial<TrajectoryConfig>, _directory: string): {
+    toolAfter: (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+        args?: Record<string, unknown>;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+};
+/**
+ * Resets the step counter for a session. Called when a new session starts
+ * or when trajectory tracking should restart from step 1.
+ *
+ * @param sessionId - Session identifier
+ */
+export declare function resetTrajectoryStep(sessionId: string): void;
+/**
+ * Records the start time for a tool call (called from toolBefore).
+ * Stored in a module-level Map for correlation with toolAfter.
+ *
+ * @param sessionId - Session identifier
+ * @param callID - Tool call identifier
+ * @param startTime - Start timestamp in milliseconds
+ */
+export declare function recordToolCallStart(sessionId: string, callID: string, startTime: number): void;

package/dist/hooks/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared hook utilities for OpenCode Swarm
+ *
+ * This module provides common utilities for working with hooks,
+ * including error handling, handler composition, file I/O, and
+ * token estimation for swarm-related operations.
+ */
+export declare function safeHook<I, O>(fn: (input: I, output: O) => Promise<void>): (input: I, output: O) => Promise<void>;
+export declare function composeHandlers<I, O>(...fns: Array<(input: I, output: O) => Promise<void>>): (input: I, output: O) => Promise<void>;
+/**
+ * Validates that a filename is safe to use within the .swarm directory
+ *
+ * @param directory - The base directory containing the .swarm folder
+ * @param filename - The filename to validate
+ * @returns The resolved absolute path if validation passes
+ * @throws Error if the filename is invalid or attempts path traversal
+ */
+export declare function validateSwarmPath(directory: string, filename: string): string;
+export declare function readSwarmFileAsync(directory: string, filename: string): Promise<string | null>;
+export declare function estimateTokens(text: string): number;

package/dist/hooks/watchdog.integration.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WATCHDOG INTEGRATION TEST (v6.31 Task 3.5)
+ *
+ * Integration test covering coordinated watchdog behaviour across:
+ * - scope-guard (3.1): toolBefore hook blocks out-of-scope writes by throwing
+ * - delegation-ledger (3.2): toolAfter hook records tool calls, onArchitectResume generates DELEGATION SUMMARY
+ * - loop-detector enhancement (3.3): at count=3, structured escalation message includes loop pattern + accomplishment + alternative suggestion
+ */
+export {};

package/dist/index.adversarial-bootstrap.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.bootstrap-adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.bootstrap-directory.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1 +1,8 @@
-export * from '@opencode-swarm/core';
+import type { Plugin } from '@opencode-ai/plugin';
+declare const _default: {
+    id: "opencode-swarm";
+    server: Plugin;
+};
+export default _default;
+export type { AgentDefinition } from './agents';
+export type { AgentName, AutomationCapabilities, AutomationConfig, AutomationMode, PipelineAgentName, PluginConfig, QAAgentName, } from './config';