opencode-swarm 7.93.1 → 7.94.0

package/dist/services/skill-generator.d.ts

@@ -133,6 +133,15 @@ export declare function activateProposal(directory: string, slug: string, force?
     stampedIds?: string[];
     evaluation?: SkillEvaluationResult;
 }>;
+export declare function findSkillsBySourceKnowledgeId(directory: string, sourceId: string): Promise<string[]>;
+/**
+ * Scan for stale skills (those with a stale.marker) whose ALL sourceKnowledgeIds
+ * are in the archivedIds set. These skills should be retired rather than left stale.
+ *
+ * This handles the case where a multi-source skill was marked stale after one
+ * source was archived, but all sources are now archived.
+ */
+export declare function findStaleSkillsBySourceKnowledgeId(directory: string, archivedIds: Set<string>): Promise<string[]>;
 export declare function listSkills(directory: string): Promise<{
     proposals: Array<{
         slug: string;
@@ -142,6 +151,10 @@ export declare function listSkills(directory: string): Promise<{
         slug: string;
         path: string;
     }>;
+    stale: Array<{
+        slug: string;
+        reason: string;
+    }>;
 }>;
 export interface AutoApplyResult {
     approved: string[];
@@ -159,6 +172,11 @@ export declare function inspectSkill(directory: string, slug: string, prefer?: '
     path?: string;
     content?: string;
     mode?: GenerateMode;
+    source_knowledge_status?: Array<{
+        id: string;
+        status: 'active' | 'archived' | 'deleted';
+    }>;
+    stale_reason?: string;
 }>;
 export declare function retireSkill(directory: string, slug: string, reason?: string): Promise<{
     retired: boolean;
@@ -166,6 +184,30 @@ export declare function retireSkill(directory: string, slug: string, reason?: st
     markerPath: string;
     reason?: string;
 }>;
+/**
+ * Mark a skill as stale by writing a stale.marker file in its directory.
+ */
+export declare function markSkillStale(skillDir: string, reason: string): Promise<void>;
+/**
+ * Remove the stale.marker file from a skill directory.
+ * Succeeds silently if the marker does not exist.
+ */
+export declare function clearSkillStale(skillDir: string): Promise<void>;
+/**
+ * Determine whether to retire or mark stale a skill whose source knowledge ID was archived,
+ * then perform the action.
+ *
+ * Reads the skill's SKILL.md frontmatter to check all its sourceKnowledgeIds.
+ * If ALL source knowledge IDs are now archived/deleted → retireSkill
+ * Otherwise → markSkillStale
+ *
+ * Returns { action: 'retire' | 'stale', slug, skillDir }
+ */
+export declare function retireOrMarkStale(directory: string, skillDir: string, archivedKnowledgeIds: Set<string>): Promise<{
+    action: 'retire' | 'stale';
+    slug: string;
+    skillDir: string;
+}>;
 export declare function regenerateSkill(directory: string, slug: string, options?: {
     evaluate?: boolean;
 }): Promise<{
@@ -187,11 +229,15 @@ export declare const _internals: {
     generateSkills: typeof generateSkills;
     activateProposal: typeof activateProposal;
     listSkills: typeof listSkills;
+    findSkillsBySourceKnowledgeId: typeof findSkillsBySourceKnowledgeId;
+    findStaleSkillsBySourceKnowledgeId: typeof findStaleSkillsBySourceKnowledgeId;
     inspectSkill: typeof inspectSkill;
     stampSourceEntries: typeof stampSourceEntries;
     parseDraftFrontmatter: typeof parseDraftFrontmatter;
     retireSkill: typeof retireSkill;
+    retireOrMarkStale: typeof retireOrMarkStale;
     regenerateSkill: typeof regenerateSkill;
+    clearSkillStale: typeof clearSkillStale;
     autoApplyProposals: typeof autoApplyProposals;
     unlinkSync: typeof unlinkSync;
 };

package/dist/tools/index.d.ts

@@ -66,6 +66,7 @@ export { skill_list } from './skill-list';
 export { skill_regenerate } from './skill-regenerate';
 export { skill_retire } from './skill-retire';
 export { spec_write } from './spec-write';
+export { run_stale_reconciliation } from './stale-reconciliation';
 export { submit_phase_council_verdicts } from './submit-phase-council-verdicts';
 export { summarize_work } from './summarize-work';
 export { createSwarmCommandTool, swarm_command } from './swarm-command';

package/dist/tools/manifest.d.ts

@@ -92,6 +92,7 @@ export declare const TOOL_MANIFEST: {
     skill_list: () => ToolDefinition;
     skill_apply: () => ToolDefinition;
     skill_inspect: () => ToolDefinition;
+    run_stale_reconciliation: () => ToolDefinition;
     skill_regenerate: () => ToolDefinition;
     skill_retire: () => ToolDefinition;
     skill_improve: () => ToolDefinition;

package/dist/tools/stale-reconciliation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * run_stale_reconciliation — Reconcile skills against the knowledge store.
+ * Marks skills stale when their source knowledge entries are archived or deleted.
+ */
+import { existsSync } from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import { getArchivedKnowledgeIds, readKnowledge, resolveHiveKnowledgePath, resolveSwarmKnowledgePath } from '../hooks/knowledge-store.js';
+import { clearSkillStale, parseDraftFrontmatter, retireOrMarkStale } from '../services/skill-generator.js';
+import { createSwarmTool } from './create-tool.js';
+export declare const run_stale_reconciliation: ReturnType<typeof createSwarmTool>;
+export declare const _internals: {
+    run_stale_reconciliation: typeof run_stale_reconciliation;
+    clearSkillStale: typeof clearSkillStale;
+    retireOrMarkStale: typeof retireOrMarkStale;
+    parseDraftFrontmatter: typeof parseDraftFrontmatter;
+    getArchivedKnowledgeIds: typeof getArchivedKnowledgeIds;
+    readKnowledge: typeof readKnowledge;
+    resolveSwarmKnowledgePath: typeof resolveSwarmKnowledgePath;
+    resolveHiveKnowledgePath: typeof resolveHiveKnowledgePath;
+    readdir: typeof readdir;
+    readFile: typeof readFile;
+    existsSync: typeof existsSync;
+};

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

@@ -299,6 +299,10 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: ("architect" | "skill_improver")[];
     };
+    run_stale_reconciliation: {
+        description: string;
+        agents: "architect"[];
+    };
     skill_regenerate: {
         description: string;
         agents: "architect"[];

package/package.json

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