opencode-swarm 7.67.0 → 7.68.0

package/dist/commands/index.d.ts

@@ -27,6 +27,7 @@ export { handleFullAutoCommand } from './full-auto';
 export { handleHandoffCommand } from './handoff';
 export { handleHistoryCommand } from './history';
 export { handleKnowledgeListCommand, handleKnowledgeMigrateCommand, handleKnowledgeQuarantineCommand, handleKnowledgeRestoreCommand, } from './knowledge';
+export { handleLearningCommand } from './learning';
 export { handleMemoryCommand, handleMemoryExportCommand, handleMemoryImportCommand, handleMemoryMigrateCommand, handleMemoryStatusCommand, } from './memory';
 export { handlePlanCommand } from './plan';
 export { handlePreflightCommand } from './preflight';

package/dist/commands/learning.d.ts

@@ -0,0 +1 @@
+export declare function handleLearningCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -146,6 +146,13 @@ export declare const COMMAND_REGISTRY: {
         readonly args: "--cumulative, --ci-gate";
         readonly category: "diagnostics";
     };
+    readonly learning: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Show learning metrics and violation trends";
+        readonly args: "--json, --phase <N>";
+        readonly details: "Computes aggregate learning metrics from knowledge events: violation-rate trends, directive application rates, escalation frequency, per-entry ROI, and never-applied entries. Surfaces a learning summary for the curator digest.";
+        readonly category: "diagnostics";
+    };
     readonly export: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Export plan and context as JSON";

package/dist/config/evidence-schema.d.ts

@@ -16,9 +16,14 @@ export declare const EvidenceTypeSchema: z.ZodEnum<{
     syntax: "syntax";
     sast: "sast";
     sbom: "sbom";
+    "mutation-gate": "mutation-gate";
+    "drift-verification": "drift-verification";
+    "hallucination-verification": "hallucination-verification";
 }>;
 export type EvidenceType = z.infer<typeof EvidenceTypeSchema>;
 export declare const EvidenceVerdictSchema: z.ZodEnum<{
+    warn: "warn";
+    skip: "skip";
     rejected: "rejected";
     pass: "pass";
     fail: "fail";
@@ -42,10 +47,15 @@ export declare const BaseEvidenceSchema: z.ZodObject<{
         syntax: "syntax";
         sast: "sast";
         sbom: "sbom";
+        "mutation-gate": "mutation-gate";
+        "drift-verification": "drift-verification";
+        "hallucination-verification": "hallucination-verification";
     }>;
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -61,6 +71,8 @@ export declare const ReviewEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -93,6 +105,8 @@ export declare const TestEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -116,6 +130,8 @@ export declare const DiffEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -136,6 +152,8 @@ export declare const ApprovalEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -152,6 +170,8 @@ export declare const NoteEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -168,6 +188,8 @@ export declare const RetrospectiveEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -233,6 +255,8 @@ export declare const SyntaxEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -263,6 +287,8 @@ export declare const PlaceholderEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -310,6 +336,8 @@ export declare const SastEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -387,6 +415,8 @@ export declare const SbomEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -421,6 +451,8 @@ export declare const BuildEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -454,6 +486,8 @@ export declare const QualityBudgetEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -497,6 +531,8 @@ export declare const SecretscanEvidenceSchema: z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -512,11 +548,59 @@ export declare const SecretscanEvidenceSchema: z.ZodObject<{
     skipped_files: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type SecretscanEvidence = z.infer<typeof SecretscanEvidenceSchema>;
+export declare const MutationGateEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"mutation-gate">;
+    verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
+        pass: "pass";
+        fail: "fail";
+    }>;
+    killRate: z.ZodOptional<z.ZodNumber>;
+    adjustedKillRate: z.ZodOptional<z.ZodNumber>;
+    survivedMutants: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MutationGateEvidence = z.infer<typeof MutationGateEvidenceSchema>;
+export declare const DriftVerificationEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"drift-verification">;
+    verdict: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+    }>;
+    requirementCoverage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DriftVerificationEvidence = z.infer<typeof DriftVerificationEvidenceSchema>;
+export declare const HallucinationVerificationEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"hallucination-verification">;
+    verdict: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+    }>;
+    findings: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HallucinationVerificationEvidence = z.infer<typeof HallucinationVerificationEvidenceSchema>;
 export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     task_id: z.ZodString;
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -547,6 +631,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -568,6 +654,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -586,6 +674,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -600,6 +690,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -614,6 +706,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -677,6 +771,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -705,6 +801,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -734,6 +832,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -809,6 +909,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -841,6 +943,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -872,6 +976,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -913,6 +1019,8 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     timestamp: z.ZodString;
     agent: z.ZodString;
     verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
         rejected: "rejected";
         pass: "pass";
         fail: "fail";
@@ -926,6 +1034,46 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     scan_directory: z.ZodOptional<z.ZodString>;
     files_scanned: z.ZodDefault<z.ZodNumber>;
     skipped_files: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"mutation-gate">;
+    verdict: z.ZodEnum<{
+        warn: "warn";
+        skip: "skip";
+        pass: "pass";
+        fail: "fail";
+    }>;
+    killRate: z.ZodOptional<z.ZodNumber>;
+    adjustedKillRate: z.ZodOptional<z.ZodNumber>;
+    survivedMutants: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"drift-verification">;
+    verdict: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+    }>;
+    requirementCoverage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"hallucination-verification">;
+    verdict: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+    }>;
+    findings: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 export type Evidence = z.infer<typeof EvidenceSchema>;
 export declare const EvidenceBundleSchema: z.ZodObject<{
@@ -936,6 +1084,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -966,6 +1116,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -987,6 +1139,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1005,6 +1159,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1019,6 +1175,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1033,6 +1191,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1096,6 +1256,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1124,6 +1286,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1153,6 +1317,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1228,6 +1394,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1260,6 +1428,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1291,6 +1461,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1332,6 +1504,8 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         timestamp: z.ZodString;
         agent: z.ZodString;
         verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
             rejected: "rejected";
             pass: "pass";
             fail: "fail";
@@ -1345,6 +1519,46 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         scan_directory: z.ZodOptional<z.ZodString>;
         files_scanned: z.ZodDefault<z.ZodNumber>;
         skipped_files: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"mutation-gate">;
+        verdict: z.ZodEnum<{
+            warn: "warn";
+            skip: "skip";
+            pass: "pass";
+            fail: "fail";
+        }>;
+        killRate: z.ZodOptional<z.ZodNumber>;
+        adjustedKillRate: z.ZodOptional<z.ZodNumber>;
+        survivedMutants: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"drift-verification">;
+        verdict: z.ZodEnum<{
+            rejected: "rejected";
+            approved: "approved";
+        }>;
+        requirementCoverage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"hallucination-verification">;
+        verdict: z.ZodEnum<{
+            rejected: "rejected";
+            approved: "approved";
+        }>;
+        findings: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "type">>>;
     created_at: z.ZodString;
     updated_at: z.ZodString;

package/dist/hooks/curator.d.ts

@@ -25,6 +25,7 @@
  * curators but omit hook-dispatched ones. This is by design for hook-internal operations.
  */
 import { listSkills, parseDraftFrontmatter, 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 type { KnowledgeConfig } from './knowledge-types.js';
@@ -49,6 +50,8 @@ export declare const _internals: {
     retireSkill: typeof retireSkill;
     readFileAsync: (filePath: string, encoding: string) => Promise<string>;
     readKnowledge: typeof readKnowledge;
+    reviseSkill: typeof reviseSkill;
+    getSkillVersion: typeof getSkillVersion;
 };
 /**
  * Auto-retire generated skills whose violation rate exceeds 30% or
@@ -57,7 +60,7 @@ export declare const _internals: {
  * 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): 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/skill-usage-log.d.ts

@@ -23,6 +23,8 @@ export interface SkillUsageEntry {
     reviewerNotes?: string;
     /** Session identifier. */
     sessionID: string;
+    /** Skill version at the time of this usage event (omitted for pre-versioning entries). */
+    skillVersion?: number;
 }
 /** Filter options for reading skill-usage entries. */
 export interface SkillUsageFilterOptions {
@@ -70,6 +72,7 @@ export declare const _internals: {
     resolveSourceKnowledgeIds: typeof resolveSourceKnowledgeIds;
     applySkillUsageFeedback: typeof applySkillUsageFeedback;
     parseGeneratedFromKnowledge: typeof parseGeneratedFromKnowledge;
+    computeComplianceByVersion: typeof computeComplianceByVersion;
 };
 /**
  * Validate and append a single skill-usage entry to the JSONL log.
@@ -102,6 +105,13 @@ export declare const MAX_TAIL_BYTES: number;
 export declare function readSkillUsageEntriesTail(directory: string, filters: {
     sessionID?: string;
 }, maxBytes?: number): SkillUsageEntry[];
+export interface VersionComplianceStats {
+    compliant: number;
+    violation: number;
+    total: number;
+    rate: number;
+}
+export declare function computeComplianceByVersion(entries: SkillUsageEntry[], skillPath: string): Map<number | undefined, VersionComplianceStats>;
 /**
  * Prune the skill-usage log, keeping at most `maxEntriesPerSkill` entries
  * per unique skillPath. Oldest entries beyond the limit are removed.