opencode-swarm 6.33.9 → 6.34.0

package/dist/telemetry.d.ts

@@ -0,0 +1,53 @@
+export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'phase_changed' | 'budget_updated' | 'model_fallback' | 'hard_limit_hit' | 'revision_limit_hit' | 'loop_detected' | 'scope_violation' | 'qa_skip_violation' | 'heartbeat' | 'turbo_mode_changed';
+export type TelemetryListener = (event: TelemetryEvent, data: Record<string, unknown>) => void;
+/** @internal - For testing only */
+export declare function resetTelemetryForTesting(): void;
+/**
+ * Initialize telemetry with the project directory.
+ * Creates `.swarm/` if it doesn't exist and opens `telemetry.jsonl` for appending.
+ * Idempotent — calling multiple times has no effect after the first successful call.
+ * @param projectDirectory - Absolute path to the project root
+ */
+export declare function initTelemetry(projectDirectory: string): void;
+/**
+ * Emit a telemetry event.
+ * Writes a JSONL line to `.swarm/telemetry.jsonl` and notifies all registered listeners.
+ * Fire-and-forget — errors are silently swallowed and never propagate to the caller.
+ * @param event - The event type
+ * @param data - Arbitrary event payload (sessionId always required by convention)
+ */
+export declare function emit(event: TelemetryEvent, data: Record<string, unknown>): void;
+/**
+ * Register a listener for telemetry events.
+ * Listeners receive every event that is emitted (if telemetry is not disabled).
+ * Listener errors are silently swallowed — they never break execution.
+ * @param callback - Function called with (event, data) on each emit
+ */
+export declare function addTelemetryListener(callback: TelemetryListener): void;
+/**
+ * Rotate telemetry file if it exceeds maxBytes.
+ * Renames `telemetry.jsonl` → `telemetry.jsonl.1` and reopens a fresh stream.
+ * Errors are silently swallowed.
+ * @param maxBytes - Size threshold in bytes (default: 10MB)
+ */
+export declare function rotateTelemetryIfNeeded(maxBytes?: number): void;
+export declare const telemetry: {
+    sessionStarted(sessionId: string, agentName: string): void;
+    sessionEnded(sessionId: string, reason: string): void;
+    agentActivated(sessionId: string, agentName: string, oldName?: string): void;
+    delegationBegin(sessionId: string, agentName: string, taskId: string): void;
+    delegationEnd(sessionId: string, agentName: string, taskId: string, result: string): void;
+    taskStateChanged(sessionId: string, taskId: string, newState: string, oldState?: string): void;
+    gatePassed(sessionId: string, gate: string, taskId: string): void;
+    gateFailed(sessionId: string, gate: string, taskId: string, reason: string): void;
+    phaseChanged(sessionId: string, oldPhase: number, newPhase: number): void;
+    budgetUpdated(sessionId: string, budgetPct: number, agentName: string): void;
+    modelFallback(sessionId: string, agentName: string, fromModel: string, toModel: string, reason: string): void;
+    hardLimitHit(sessionId: string, agentName: string, limitType: string, value: number): void;
+    revisionLimitHit(sessionId: string, agentName: string): void;
+    loopDetected(sessionId: string, agentName: string, loopType: string): void;
+    scopeViolation(sessionId: string, agentName: string, file: string, reason: string): void;
+    qaSkipViolation(sessionId: string, agentName: string, skipCount: number): void;
+    heartbeat(sessionId: string): void;
+    turboModeChanged(sessionId: string, enabled: boolean, agentName: string): void;
+};

package/dist/telemetry.test.d.ts

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

package/dist/tools/completion-verify.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Completion verification tool - deterministic pre-check verifying that plan task
+ * identifiers exist in their target source files before phase completion.
+ * Blocks if obviously incomplete.
+ */
+import { type ToolDefinition } from '@opencode-ai/plugin';
+/**
+ * Arguments for the completion_verify tool
+ */
+export interface CompletionVerifyArgs {
+    /** The phase number to check */
+    phase: number;
+    /** Session ID (optional, auto-provided by plugin context) */
+    sessionID?: string;
+}
+/**
+ * Execute the completion verification check
+ */
+export declare function executeCompletionVerify(args: CompletionVerifyArgs, directory: string): Promise<string>;
+/**
+ * Tool definition for completion_verify
+ */
+export declare const completion_verify: ToolDefinition;

package/dist/tools/index.d.ts

@@ -1,6 +1,7 @@
 export { build_check } from './build-check';
 export { check_gate_status } from './check-gate-status';
 export { checkpoint } from './checkpoint';
+export { completion_verify } from './completion-verify';
 export { complexity_hotspots } from './complexity-hotspots';
 export { curator_analyze } from './curator-analyze';
 export { declare_scope } from './declare-scope';

package/dist/tools/tool-names.d.ts

@@ -3,7 +3,7 @@
  * Used for constants and agent setup references.
  */
 /** Union type of all valid tool names */
-export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'check_gate_status' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'write_retro' | 'declare_scope' | 'knowledge_query';
+export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'check_gate_status' | 'completion_verify' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'write_retro' | 'declare_scope' | 'knowledge_query';
 /** Readonly array of all tool names */
 export declare const TOOL_NAMES: readonly ToolName[];
 /** Set for O(1) tool name validation */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "6.33.9",
+	"version": "6.34.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",