opencode-swarm 6.71.1 → 6.72.0

package/dist/cli/index.js

@@ -19162,7 +19162,10 @@ var KnowledgeConfigSchema = exports_external.object({
   min_encounter_score: exports_external.number().min(0).max(1).default(0.1),
   initial_encounter_score: exports_external.number().min(0).max(5).default(1),
   encounter_increment: exports_external.number().min(0).max(1).default(0.1),
-  max_encounter_score: exports_external.number().min(1).max(20).default(10)
+  max_encounter_score: exports_external.number().min(1).max(20).default(10),
+  default_max_phases: exports_external.number().int().positive().default(10),
+  todo_max_phases: exports_external.number().int().positive().default(3),
+  sweep_enabled: exports_external.boolean().default(true)
 });
 var CuratorConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(true),
@@ -33188,7 +33191,8 @@ async function rewriteKnowledge(filePath, entries) {
   let release = null;
   try {
     release = await import_proper_lockfile2.default.lock(dir, {
-      retries: { retries: 3, minTimeout: 100 }
+      retries: { retries: 5, minTimeout: 100, maxTimeout: 500 },
+      stale: 5000
     });
     const content = entries.map((e) => JSON.stringify(e)).join(`
 `) + (entries.length > 0 ? `
@@ -33257,6 +33261,8 @@ function computeConfidence(confirmedByCount, autoGenerated) {
 function inferTags(lesson) {
   const lower = lesson.toLowerCase();
   const tags = [];
+  if (/(^|\s)(?:todo|remember|don't?(?:\s+)?forget)(?:\s|:|,|$)/i.test(lesson))
+    tags.push("todo");
   if (/\b(?:typescript|ts)\b/.test(lower))
     tags.push("typescript");
   if (/\b(?:javascript|js)\b/.test(lower))
@@ -33341,6 +33347,7 @@ var VALID_CATEGORIES = new Set([
   "debugging",
   "performance",
   "integration",
+  "todo",
   "other"
 ]);
 var TECH_REFERENCE_WORDS = new Set([
@@ -33659,7 +33666,8 @@ async function curateAndStoreSwarm(lessons, projectName, phaseInfo, directory, c
     ["debugging", "debugging"],
     ["performance", "performance"],
     ["integration", "integration"],
-    ["other", "other"]
+    ["other", "other"],
+    ["todo", "todo"]
   ]);
   for (const lesson of lessons) {
     const tags = inferTags(lesson);

package/dist/config/schema.d.ts

@@ -437,6 +437,9 @@ export declare const KnowledgeConfigSchema: z.ZodObject<{
     initial_encounter_score: z.ZodDefault<z.ZodNumber>;
     encounter_increment: z.ZodDefault<z.ZodNumber>;
     max_encounter_score: z.ZodDefault<z.ZodNumber>;
+    default_max_phases: z.ZodDefault<z.ZodNumber>;
+    todo_max_phases: z.ZodDefault<z.ZodNumber>;
+    sweep_enabled: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type KnowledgeConfig = z.infer<typeof KnowledgeConfigSchema>;
 export declare const CuratorConfigSchema: z.ZodObject<{
@@ -826,6 +829,9 @@ export declare const PluginConfigSchema: z.ZodObject<{
         initial_encounter_score: z.ZodDefault<z.ZodNumber>;
         encounter_increment: z.ZodDefault<z.ZodNumber>;
         max_encounter_score: z.ZodDefault<z.ZodNumber>;
+        default_max_phases: z.ZodDefault<z.ZodNumber>;
+        todo_max_phases: z.ZodDefault<z.ZodNumber>;
+        sweep_enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
     curator: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;

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

@@ -1,5 +1,5 @@
 /** Core storage layer for the opencode-swarm v6.17 two-tier knowledge system. */
-import type { RejectedLesson } from './knowledge-types.js';
+import type { KnowledgeEntryBase, RejectedLesson } from './knowledge-types.js';
 export declare function getPlatformConfigDir(): string;
 export declare function resolveSwarmKnowledgePath(directory: string): string;
 export declare function resolveSwarmRejectedPath(directory: string): string;
@@ -10,6 +10,15 @@ export declare function readRejectedLessons(directory: string): Promise<Rejected
 export declare function appendKnowledge<T>(filePath: string, entry: T): Promise<void>;
 export declare function rewriteKnowledge<T>(filePath: string, entries: T[]): Promise<void>;
 export declare function enforceKnowledgeCap<T>(filePath: string, maxEntries: number): Promise<void>;
+export interface SweepResult {
+    scanned: number;
+    aged: number;
+    archived: number;
+    removed: number;
+    skipped_promoted: number;
+}
+export declare function sweepAgedEntries<T extends KnowledgeEntryBase>(filePath: string, defaultMaxPhases: number): Promise<SweepResult>;
+export declare function sweepStaleTodos<T extends KnowledgeEntryBase>(filePath: string, todoMaxPhases: number): Promise<SweepResult>;
 export declare function appendRejectedLesson(directory: string, lesson: RejectedLesson): Promise<void>;
 export declare function normalize(text: string): string;
 export declare function wordBigrams(text: string): Set<string>;

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

@@ -1,5 +1,5 @@
 /** Type definitions for the opencode-swarm v6.17 two-tier knowledge system. */
-export type KnowledgeCategory = 'process' | 'architecture' | 'tooling' | 'security' | 'testing' | 'debugging' | 'performance' | 'integration' | 'other';
+export type KnowledgeCategory = 'process' | 'architecture' | 'tooling' | 'security' | 'testing' | 'debugging' | 'performance' | 'integration' | 'todo' | 'other';
 export interface PhaseConfirmationRecord {
     phase_number: number;
     confirmed_at: string;
@@ -32,6 +32,8 @@ export interface KnowledgeEntryBase {
     updated_at: string;
     hive_eligible?: boolean;
     auto_generated?: boolean;
+    phases_alive?: number;
+    max_phases?: number;
 }
 export interface SwarmKnowledgeEntry extends KnowledgeEntryBase {
     tier: 'swarm';
@@ -103,6 +105,12 @@ export interface KnowledgeConfig {
     encounter_increment: number;
     /** Weighted scoring: maximum encounter score cap. Default: 10.0 */
     max_encounter_score: number;
+    /** Default N-phase TTL for knowledge entries. Default: 10 */
+    default_max_phases: number;
+    /** N-phase TTL for 'todo' category entries. Default: 3 */
+    todo_max_phases: number;
+    /** Enable age-based sweep of knowledge entries. Default: true */
+    sweep_enabled: boolean;
 }
 export interface MessageInfo {
     role: string;

package/dist/index.js

@@ -15101,7 +15101,10 @@ var init_schema = __esm(() => {
     min_encounter_score: exports_external.number().min(0).max(1).default(0.1),
     initial_encounter_score: exports_external.number().min(0).max(5).default(1),
     encounter_increment: exports_external.number().min(0).max(1).default(0.1),
-    max_encounter_score: exports_external.number().min(1).max(20).default(10)
+    max_encounter_score: exports_external.number().min(1).max(20).default(10),
+    default_max_phases: exports_external.number().int().positive().default(10),
+    todo_max_phases: exports_external.number().int().positive().default(3),
+    sweep_enabled: exports_external.boolean().default(true)
   });
   CuratorConfigSchema = exports_external.object({
     enabled: exports_external.boolean().default(true),
@@ -38935,7 +38938,8 @@ async function rewriteKnowledge(filePath, entries) {
   let release = null;
   try {
     release = await import_proper_lockfile2.default.lock(dir, {
-      retries: { retries: 3, minTimeout: 100 }
+      retries: { retries: 5, minTimeout: 100, maxTimeout: 500 },
+      stale: 5000
     });
     const content = entries.map((e) => JSON.stringify(e)).join(`
 `) + (entries.length > 0 ? `
@@ -38956,6 +38960,103 @@ async function enforceKnowledgeCap(filePath, maxEntries) {
     await rewriteKnowledge(filePath, trimmed);
   }
 }
+async function sweepAgedEntries(filePath, defaultMaxPhases) {
+  let release = null;
+  try {
+    const dir = path13.dirname(filePath);
+    await mkdir2(dir, { recursive: true });
+    release = await import_proper_lockfile2.default.lock(dir, {
+      retries: { retries: 5, minTimeout: 100, maxTimeout: 500 },
+      stale: 5000
+    });
+    const entries = await readKnowledge(filePath);
+    const result = {
+      scanned: entries.length,
+      aged: 0,
+      archived: 0,
+      removed: 0,
+      skipped_promoted: 0
+    };
+    if (entries.length === 0)
+      return result;
+    const now = new Date().toISOString();
+    let mutated = false;
+    for (const entry of entries) {
+      if (entry.status === "archived")
+        continue;
+      if (entry.status === "promoted") {
+        result.skipped_promoted++;
+        continue;
+      }
+      entry.phases_alive = (entry.phases_alive ?? 0) + 1;
+      result.aged++;
+      mutated = true;
+      const ttl = entry.max_phases ?? defaultMaxPhases;
+      if (entry.phases_alive > ttl) {
+        entry.status = "archived";
+        entry.updated_at = now;
+        result.archived++;
+      }
+    }
+    if (mutated) {
+      const content = entries.map((e) => JSON.stringify(e)).join(`
+`) + (entries.length > 0 ? `
+` : "");
+      await writeFile2(filePath, content, "utf-8");
+    }
+    return result;
+  } finally {
+    if (release) {
+      try {
+        await release();
+      } catch {}
+    }
+  }
+}
+async function sweepStaleTodos(filePath, todoMaxPhases) {
+  let release = null;
+  try {
+    const dir = path13.dirname(filePath);
+    await mkdir2(dir, { recursive: true });
+    release = await import_proper_lockfile2.default.lock(dir, {
+      retries: { retries: 5, minTimeout: 100, maxTimeout: 500 },
+      stale: 5000
+    });
+    const entries = await readKnowledge(filePath);
+    const result = {
+      scanned: entries.length,
+      aged: 0,
+      archived: 0,
+      removed: 0,
+      skipped_promoted: 0
+    };
+    if (entries.length === 0)
+      return result;
+    const kept = entries.filter((e) => {
+      if (e.category !== "todo" || e.status === "promoted")
+        return true;
+      const age = e.phases_alive ?? 0;
+      if (age > todoMaxPhases) {
+        result.removed++;
+        return false;
+      }
+      return true;
+    });
+    if (result.removed > 0) {
+      const content = kept.map((e) => JSON.stringify(e)).join(`
+`) + (kept.length > 0 ? `
+` : "");
+      await writeFile2(filePath, content, "utf-8");
+    }
+    return result;
+  } finally {
+    if (release) {
+      try {
+        await release();
+      } catch {}
+    }
+  }
+}
 async function appendRejectedLesson(directory, lesson) {
   const filePath = resolveSwarmRejectedPath(directory);
   const existing = await readRejectedLessons(directory);
@@ -39004,6 +39105,8 @@ function computeConfidence(confirmedByCount, autoGenerated) {
 function inferTags(lesson) {
   const lower = lesson.toLowerCase();
   const tags = [];
+  if (/(^|\s)(?:todo|remember|don't?(?:\s+)?forget)(?:\s|:|,|$)/i.test(lesson))
+    tags.push("todo");
   if (/\b(?:typescript|ts)\b/.test(lower))
     tags.push("typescript");
   if (/\b(?:javascript|js)\b/.test(lower))
@@ -39142,7 +39245,7 @@ async function readMergedKnowledge(directory, config3, context) {
     });
   }
   const scopeFilter = config3.scope_filter ?? ["global"];
-  const filtered = merged.filter((entry) => scopeFilter.some((pattern) => (entry.scope ?? "global") === pattern));
+  const filtered = merged.filter((entry) => scopeFilter.some((pattern) => (entry.scope ?? "global") === pattern) && entry.status !== "archived");
   const ranked = filtered.map((entry) => {
     let categoryScore = 0;
     if (context?.currentPhase) {
@@ -39562,6 +39665,7 @@ var init_knowledge_validator = __esm(() => {
     "debugging",
     "performance",
     "integration",
+    "todo",
     "other"
   ]);
   TECH_REFERENCE_WORDS = new Set([
@@ -39759,7 +39863,8 @@ async function curateAndStoreSwarm(lessons, projectName, phaseInfo, directory, c
     ["debugging", "debugging"],
     ["performance", "performance"],
     ["integration", "integration"],
-    ["other", "other"]
+    ["other", "other"],
+    ["todo", "todo"]
   ]);
   for (const lesson of lessons) {
     const tags = inferTags(lesson);
@@ -73586,7 +73691,7 @@ var knowledge_query = createSwarmTool({
   args: {
     tier: tool.schema.string().optional().describe("Knowledge tier to query: 'swarm', 'hive', or 'all' (default: 'all')"),
     status: tool.schema.string().optional().describe("Filter by status: 'candidate', 'established', or 'promoted'"),
-    category: tool.schema.string().optional().describe("Filter by category: 'process', 'architecture', 'tooling', 'security', 'testing', 'debugging', 'performance', 'integration', or 'other'"),
+    category: tool.schema.string().optional().describe("Filter by category: 'process', 'architecture', 'tooling', 'security', 'testing', 'debugging', 'performance', 'integration', 'todo', or 'other'"),
     min_score: tool.schema.number().optional().describe("Minimum confidence score filter (0.0-1.0)"),
     limit: tool.schema.number().optional().describe(`Maximum number of results to return (default: ${DEFAULT_LIMIT}, max: 100)`)
   },
@@ -73749,6 +73854,7 @@ import * as fs60 from "fs";
 import * as path74 from "path";
 init_knowledge_curator();
 init_knowledge_reader();
+init_knowledge_store();
 init_review_receipt();
 init_utils2();
 init_checkpoint3();
@@ -74058,7 +74164,13 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
       safeWarn(`[phase_complete] Drift verifier error (non-blocking):`, driftError);
     }
   }
-  const knowledgeConfig = KnowledgeConfigSchema.parse(config3.knowledge ?? {});
+  let knowledgeConfig;
+  try {
+    knowledgeConfig = KnowledgeConfigSchema.parse(config3.knowledge ?? {});
+  } catch (parseErr) {
+    warnings.push(`Knowledge config validation failed: ${String(parseErr)}`);
+    knowledgeConfig = KnowledgeConfigSchema.parse({});
+  }
   if (retroFound && retroEntry?.lessons_learned && retroEntry.lessons_learned.length > 0) {
     try {
       const projectName = path74.basename(dir);
@@ -74280,6 +74392,28 @@ async function executePhaseComplete(args2, workingDirectory, directory) {
         telemetry.phaseChanged(contributorSessionId, oldPhase ?? 0, phase);
       }
     }
+    try {
+      if (knowledgeConfig.sweep_enabled) {
+        const swarmPath = resolveSwarmKnowledgePath(dir);
+        await sweepAgedEntries(swarmPath, knowledgeConfig.default_max_phases);
+        await sweepStaleTodos(swarmPath, knowledgeConfig.todo_max_phases);
+        if (knowledgeConfig.hive_enabled) {
+          const hivePath = resolveHiveKnowledgePath();
+          await sweepAgedEntries(hivePath, knowledgeConfig.default_max_phases);
+          await sweepStaleTodos(hivePath, knowledgeConfig.todo_max_phases);
+        }
+      }
+    } catch (err2) {
+      let detail = String(err2);
+      if (detail.includes("ELOCKED")) {
+        detail = "lock timeout (stale lock detected)";
+      } else if (detail.includes("ENOSPC")) {
+        detail = "disk full";
+      } else if (detail.includes("EACCES")) {
+        detail = "permission denied";
+      }
+      warnings.push(`Knowledge sweep failed for phase ${phase}: ${detail}`);
+    }
     try {
       const plan = await loadPlan(dir);
       if (plan === null) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "6.71.1",
+	"version": "6.72.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",