opencode-swarm 7.43.1 → 7.44.0

package/dist/services/knowledge-diagnostics.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Knowledge-system diagnostics: a reusable debug-metadata helper that any
+ * knowledge tool can surface, plus a `/swarm diagnose` health summary.
+ *
+ * Path/version drift is a documented diagnostic concern (a stale plugin cache or
+ * a mismatched resolved directory can make the knowledge store look broken).
+ * This module reports the exact resolved paths, raw-vs-normalized entry counts,
+ * status breakdown, event volume, and cache freshness so those issues surface.
+ */
+export interface KnowledgeDebugMeta {
+    plugin_version: string;
+    directory: string;
+    swarm_path: string;
+    hive_path: string;
+    events_path: string;
+    raw_entry_count: number;
+    normalized_entry_count: number;
+    corrupt_line_count: number;
+    schema_versions: Record<string, number>;
+    entries_missing_v2_counters: number;
+    status_breakdown: {
+        active: number;
+        archived: number;
+        quarantined: number;
+        rejected: number;
+    };
+    event_count: number;
+    retrieval_events_7d: number;
+    cache_status: 'fresh' | 'stale' | 'unknown';
+}
+/**
+ * Compute the debug-metadata block for the knowledge system. Best-effort: never
+ * throws (each I/O step degrades to zero/empty). Aggregates swarm + hive tiers.
+ */
+export declare function computeKnowledgeDebug(directory: string): Promise<KnowledgeDebugMeta>;
+export interface KnowledgeHealth {
+    name: string;
+    status: '✅' | '❌' | '⚠️' | '⬜';
+    detail: string;
+}
+/**
+ * Build the "Knowledge health" diagnose check from the debug metadata. Warns on
+ * raw-vs-normalized mismatch (corrupt lines), entries missing v2 counters, or a
+ * stale plugin cache; otherwise reports a healthy summary.
+ */
+export declare function checkKnowledgeHealth(directory: string): Promise<KnowledgeHealth>;

package/dist/tools/index.d.ts

@@ -22,8 +22,10 @@ export { fetchGitingest, type GitingestArgs, gitingest } from './gitingest';
 export { imports } from './imports';
 export { knowledge_ack } from './knowledge-ack';
 export { knowledge_add } from './knowledge-add';
+export { knowledge_archive } from './knowledge-archive';
 export { knowledge_query } from './knowledge-query';
 export { knowledge_recall } from './knowledge-recall';
+export { knowledge_receipt } from './knowledge-receipt';
 export { knowledge_remove } from './knowledge-remove';
 export { lint } from './lint';
 export { phase_complete } from './phase-complete';

package/dist/tools/knowledge-archive.d.ts

@@ -0,0 +1,18 @@
+/**
+ * knowledge_archive — archival-by-default removal with audit tombstones.
+ *
+ * Unlike knowledge_remove (which hard-deletes a swarm entry), this tool defaults
+ * to a reversible status transition and always appends an immutable `archived`
+ * event to `.swarm/knowledge-events.jsonl` recording the actor, reason, evidence,
+ * and previous status.
+ *
+ * Modes:
+ *  - 'archive'    (default): set status='archived' — TTL-exempt, hidden from recall.
+ *  - 'quarantine':           set status='quarantined' — suspected-bad, hidden from recall.
+ *  - 'purge':                hard-delete the JSONL line. Requires allow_purge:true.
+ */
+import { createSwarmTool } from './create-tool.js';
+export declare const knowledge_archive: ReturnType<typeof createSwarmTool>;
+export declare const _internals: {
+    knowledge_archive: typeof knowledge_archive;
+};

package/dist/tools/knowledge-receipt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * knowledge_receipt — the strong successor to knowledge_ack.
+ *
+ * An agent files a single receipt summarizing how it considered the knowledge
+ * surfaced by a retrieval (referenced by `trace_id`): which entries were
+ * applied, which were ignored (with a reason), which were contradicted by
+ * current evidence (with a proposed remediation), and any new lessons learned.
+ *
+ * Each applied/ignored/contradicted item becomes one immutable event in
+ * `.swarm/knowledge-events.jsonl`. New lessons are persisted through the normal
+ * knowledge_add validation/dedup path. When a retrieval surfaced nothing
+ * relevant, the receipt can set `no_relevant_knowledge: true` — the point is to
+ * force explicit consideration, not fake usage.
+ */
+import { createSwarmTool } from './create-tool.js';
+export declare const knowledge_receipt: ReturnType<typeof createSwarmTool>;
+export declare const _internals: {
+    knowledge_receipt: typeof knowledge_receipt;
+};

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' | 'diff_summary' | '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' | 'submit_council_verdicts' | 'submit_phase_council_verdicts' | 'declare_council_criteria' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'test_impact' | 'mutation_test' | 'generate_mutants' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'lint_spec' | 'write_retro' | 'write_drift_evidence' | 'write_hallucination_evidence' | 'write_mutation_evidence' | 'declare_scope' | 'knowledge_query' | 'doc_scan' | 'doc_extract' | 'curator_analyze' | 'knowledge_add' | 'knowledge_recall' | 'knowledge_remove' | 'co_change_analyzer' | 'search' | 'batch_symbols' | 'suggest_patch' | 'req_coverage' | 'get_approved_plan' | 'repo_map' | 'get_qa_gate_profile' | 'set_qa_gates' | 'web_search' | 'convene_general_council' | 'write_final_council_evidence' | 'skill_generate' | 'skill_list' | 'skill_apply' | 'skill_inspect' | 'skill_regenerate' | 'skill_retire' | 'skill_improve' | 'spec_write' | 'knowledge_ack' | 'swarm_memory_recall' | 'swarm_memory_propose' | 'swarm_command' | 'summarize_work' | 'write_architecture_supervisor_evidence' | 'lean_turbo_plan_lanes' | 'lean_turbo_acquire_locks' | 'lean_turbo_runner_status' | 'lean_turbo_review' | 'lean_turbo_run_phase' | 'lean_turbo_status';
+export type ToolName = 'diff' | 'diff_summary' | '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' | 'submit_council_verdicts' | 'submit_phase_council_verdicts' | 'declare_council_criteria' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'test_impact' | 'mutation_test' | 'generate_mutants' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'lint_spec' | 'write_retro' | 'write_drift_evidence' | 'write_hallucination_evidence' | 'write_mutation_evidence' | 'declare_scope' | 'knowledge_query' | 'doc_scan' | 'doc_extract' | 'curator_analyze' | 'knowledge_add' | 'knowledge_recall' | 'knowledge_remove' | 'co_change_analyzer' | 'search' | 'batch_symbols' | 'suggest_patch' | 'req_coverage' | 'get_approved_plan' | 'repo_map' | 'get_qa_gate_profile' | 'set_qa_gates' | 'web_search' | 'convene_general_council' | 'write_final_council_evidence' | 'skill_generate' | 'skill_list' | 'skill_apply' | 'skill_inspect' | 'skill_regenerate' | 'skill_retire' | 'skill_improve' | 'spec_write' | 'knowledge_ack' | 'knowledge_receipt' | 'knowledge_archive' | 'swarm_memory_recall' | 'swarm_memory_propose' | 'swarm_command' | 'summarize_work' | 'write_architecture_supervisor_evidence' | 'lean_turbo_plan_lanes' | 'lean_turbo_acquire_locks' | 'lean_turbo_runner_status' | 'lean_turbo_review' | 'lean_turbo_run_phase' | 'lean_turbo_status';
 /** 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": "7.43.1",
+	"version": "7.44.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",