opencode-swarm 7.93.1 → 7.94.0

package/dist/hooks/curator.d.ts

@@ -24,10 +24,10 @@
  * This dual dispatch means agent lists are incomplete — they capture factory-dispatched
  * curators but omit hook-dispatched ones. This is by design for hook-internal operations.
  */
-import { listSkills, parseDraftFrontmatter, retireSkill } from '../services/skill-generator.js';
+import { listSkills, parseDraftFrontmatter, retireOrMarkStale, retireSkill } from '../services/skill-generator.js';
 import { getSkillVersion, reviseSkill } from '../services/skill-reviser.js';
 import type { ComplianceObservation, CuratorConfig, CuratorInitResult, CuratorPhaseResult, CuratorSummary, KnowledgeRecommendation } from './curator-types.js';
-import { readKnowledge } from './knowledge-store.js';
+import { getArchivedKnowledgeIds, readKnowledge } from './knowledge-store.js';
 import type { KnowledgeConfig } from './knowledge-types.js';
 import { readSkillUsageEntries } from './skill-usage-log.js';
 /**
@@ -48,7 +48,9 @@ export declare const _internals: {
     readSkillUsageEntries: typeof readSkillUsageEntries;
     listSkills: typeof listSkills;
     parseDraftFrontmatter: typeof parseDraftFrontmatter;
+    retireOrMarkStale: typeof retireOrMarkStale;
     retireSkill: typeof retireSkill;
+    getArchivedKnowledgeIds: typeof getArchivedKnowledgeIds;
     readFileAsync: (filePath: string, encoding: string) => Promise<string>;
     readKnowledge: typeof readKnowledge;
     reviseSkill: typeof reviseSkill;
@@ -63,10 +65,13 @@ export interface RecommendationParseDiagnostic {
  * Auto-retire generated skills whose violation rate exceeds 30% or
  * whose source knowledge entries are all archived.
  *
+ * Also marks skills stale when some (but not all) source knowledge entries
+ * are archived.
+ *
  * Non-blocking: errors are caught and logged but never propagated.
  * Returns an array of observation strings to include in the phase digest.
  */
-declare function autoRetireSkills(directory: string, curatorKnowledgePath: string, excludeSlugs?: ReadonlySet<string>): Promise<string[]>;
+declare function autoRetireSkills(directory: string, _curatorKnowledgePath: string, excludeSlugs?: ReadonlySet<string>): Promise<string[]>;
 /**
  * Parse OBSERVATIONS section from curator LLM output.
  * Expected format per line: "- entry <uuid> (<observable>): [text]"

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

@@ -132,7 +132,18 @@ export interface EscalationEvent {
     reason: string;
     enforcement_mode?: string;
 }
-export type KnowledgeEvent = RetrievedEvent | ReceiptEvent | OutcomeEvent | ArchivedEvent | EscalationEvent;
+/** A batch of skills were invalidated after a knowledge entry was archived/purged. */
+export interface SkillStaleBatchEvent {
+    type: 'skill-stale-batch';
+    schema_version?: number;
+    event_id?: string;
+    timestamp?: string;
+    skillIds: string[];
+    archivedIds: string[];
+    retiredCount: number;
+    staleCount: number;
+}
+export type KnowledgeEvent = RetrievedEvent | ReceiptEvent | OutcomeEvent | ArchivedEvent | EscalationEvent | SkillStaleBatchEvent;
 export type KnowledgeEventType = KnowledgeEvent['type'];
 /**
  * Event shape accepted by {@link appendKnowledgeEvent} / {@link recordKnowledgeEvent}.

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

@@ -26,6 +26,7 @@ export declare function appendKnowledge<T>(filePath: string, entry: T): Promise<
 export declare function rewriteKnowledge<T>(filePath: string, entries: T[]): Promise<void>;
 export declare function transactFile<T>(filePath: string, read: (filePath: string) => Promise<T>, write: (filePath: string, data: T) => Promise<void>, mutate: (data: T) => T | null): Promise<boolean>;
 export declare function transactKnowledge<T>(filePath: string, mutate: (entries: T[]) => T[] | null): Promise<boolean>;
+export declare function getArchivedKnowledgeIds(directory: string): Promise<Set<string>>;
 export declare function appendKnowledgeWithCapEnforcement<T>(filePath: string, entry: T, maxEntries: number): Promise<boolean>;
 export declare function enforceKnowledgeCap<T>(filePath: string, maxEntries: number): Promise<void>;
 declare function selectKnowledgeCapSurvivors<T>(entries: T[], maxEntries: number): T[];
@@ -95,5 +96,6 @@ export declare const _internals: {
     selectKnowledgeCapSurvivors: typeof selectKnowledgeCapSurvivors;
     inferTags: typeof inferTags;
     bumpKnowledgeConfidenceBatch: typeof bumpKnowledgeConfidenceBatch;
+    getArchivedKnowledgeIds: typeof getArchivedKnowledgeIds;
 };
 export {};