opencode-swarm 7.76.2 → 7.77.0

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

@@ -0,0 +1,49 @@
+/**
+ * Scheduled skill-improver consolidation.
+ *
+ * This module owns cadence state only. The actual queue draining, proposal
+ * writing, and draft-skill generation stays in `runSkillImprover`.
+ */
+import type { EnrichmentQuotaOptions } from '../hooks/knowledge-curator.js';
+import type { SkillImproveResult, SkillImproverConfigInput } from './skill-improver.js';
+export interface SkillConsolidationState {
+    last_consolidation_at?: string;
+    last_source?: SkillConsolidationSource;
+    last_ran?: boolean;
+    last_reason?: string;
+}
+export type SkillConsolidationSource = 'startup' | 'phase_complete' | 'manual';
+export interface SkillConsolidationRequest {
+    directory: string;
+    config: SkillImproverConfigInput;
+    source: SkillConsolidationSource;
+    sessionId?: string;
+    force?: boolean;
+    now?: Date;
+    enrichmentQuota?: EnrichmentQuotaOptions;
+    evaluateDrafts?: boolean;
+}
+export interface SkillConsolidationResult {
+    started: boolean;
+    reason?: string;
+    statePath: string;
+    result?: SkillImproveResult;
+}
+export declare function consolidationStatePath(directory: string): string;
+declare function readState(directory: string): Promise<SkillConsolidationState>;
+declare function writeState(directory: string, state: SkillConsolidationState): Promise<void>;
+declare function intervalElapsed(state: SkillConsolidationState, intervalHours: number, now: Date): boolean;
+export declare function shouldRunSkillConsolidation(req: SkillConsolidationRequest): Promise<{
+    shouldRun: boolean;
+    reason?: string;
+    state: SkillConsolidationState;
+}>;
+export declare function runSkillConsolidation(req: SkillConsolidationRequest): Promise<SkillConsolidationResult>;
+export declare function runSkillConsolidationFireAndForget(req: SkillConsolidationRequest, onComplete?: (result: SkillConsolidationResult) => void, onError?: (error: unknown) => void): void;
+export declare const _internals: {
+    readState: typeof readState;
+    writeState: typeof writeState;
+    intervalElapsed: typeof intervalElapsed;
+    runningByDirectory: Map<string, Promise<SkillConsolidationResult>>;
+};
+export {};

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

@@ -0,0 +1,77 @@
+/**
+ * Generated-skill validation gate.
+ *
+ * Eval fixtures live under `.swarm/skills/evals/<slug>/*.json`. Each fixture can
+ * be either a single case, an array of cases, or `{ "cases": [...] }`.
+ *
+ * This service is deterministic and fail-open only when no eval set exists.
+ * Malformed eval files fail closed so a broken gate cannot silently approve a
+ * promotion.
+ */
+export interface SkillEvalCase {
+    id?: string;
+    task?: string;
+    required_phrases?: string[];
+    forbidden_phrases?: string[];
+}
+export interface SkillCaseEvaluation {
+    id: string;
+    candidateScore: number;
+    incumbentScore: number;
+    candidateFailures: string[];
+    incumbentFailures: string[];
+}
+export type SkillEvaluationStatus = 'unevaluated' | 'passed' | 'rejected' | 'invalid_eval_set';
+export interface SkillEvaluationResult {
+    status: SkillEvaluationStatus;
+    passed: boolean;
+    reason: string;
+    evalFiles: string[];
+    caseCount: number;
+    candidateScore: number;
+    incumbentScore: number;
+    caseResults: SkillCaseEvaluation[];
+}
+export interface EvaluateSkillChangeRequest {
+    directory: string;
+    slug: string;
+    candidateContent: string;
+    incumbentContent?: string;
+    operation: string;
+}
+export interface RejectedSkillEditRecord {
+    timestamp: string;
+    slug: string;
+    operation: string;
+    reason: string;
+    candidateHash: string;
+    candidateNormalizedHash?: string;
+    incumbentHash?: string;
+    candidateScore: number;
+    incumbentScore: number;
+    evalFiles: string[];
+    caseCount: number;
+    candidatePreview: string;
+}
+export declare function rejectedEditsPath(directory: string): string;
+declare function loadEvalSet(directory: string, slug: string): Promise<{
+    status: 'missing' | 'loaded' | 'invalid';
+    files: string[];
+    cases: SkillEvalCase[];
+    reason?: string;
+}>;
+declare function evaluateContent(content: string, testCase: SkillEvalCase): {
+    score: number;
+    failures: string[];
+};
+declare function hashNormalizedContent(content: string | undefined): string | undefined;
+export declare function evaluateSkillChange(req: EvaluateSkillChangeRequest): Promise<SkillEvaluationResult>;
+export declare function appendRejectedSkillEdit(req: EvaluateSkillChangeRequest, evaluation: SkillEvaluationResult): Promise<void>;
+export declare function isRejectedSkillContent(directory: string, slug: string, content: string): Promise<boolean>;
+export declare const _internals: {
+    loadEvalSet: typeof loadEvalSet;
+    evaluateContent: typeof evaluateContent;
+    rejectedEditsPath: typeof rejectedEditsPath;
+    hashNormalizedContent: typeof hashNormalizedContent;
+};
+export {};

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

@@ -14,6 +14,7 @@
  */
 import { unlinkSync } from 'node:fs';
 import type { KnowledgeEntryBase } from '../hooks/knowledge-types.js';
+import { type SkillEvaluationResult } from './skill-evaluator.js';
 export declare function sanitizeSlug(input: string): string;
 export declare function isValidSlug(slug: string): boolean;
 export declare function proposalPath(directory: string, slug: string): string;
@@ -59,6 +60,7 @@ export interface GenerateRequest {
     slug?: string;
     sourceKnowledgeIds?: string[];
     force?: boolean;
+    evaluate?: boolean;
     minConfidence?: number;
     minConfirmations?: number;
 }
@@ -69,10 +71,12 @@ export interface GenerateResult {
         mode: GenerateMode;
         sourceKnowledgeIds: string[];
         preserved: boolean;
+        evaluation?: SkillEvaluationResult;
     }>;
     skipped: Array<{
         slug: string;
         reason: string;
+        evaluation?: SkillEvaluationResult;
     }>;
 }
 export declare function generateSkills(req: GenerateRequest): Promise<GenerateResult>;
@@ -95,17 +99,22 @@ export declare function parseDraftFrontmatter(content: string): {
     status?: string;
     generatedAt?: string;
     sourceKnowledgeIds: string[];
+    triggers: string[];
     version?: number;
     skillOrigin?: string;
     skillType?: 'directive' | 'workflow';
 } | null;
-export declare function activateProposal(directory: string, slug: string, force?: boolean): Promise<{
+export declare function activateProposal(directory: string, slug: string, force?: boolean, options?: {
+    evaluate?: boolean;
+    operation?: string;
+}): Promise<{
     activated: boolean;
     from: string;
     to: string;
     reason?: string;
     stamped?: boolean;
     stampedIds?: string[];
+    evaluation?: SkillEvaluationResult;
 }>;
 export declare function listSkills(directory: string): Promise<{
     proposals: Array<{
@@ -140,12 +149,15 @@ export declare function retireSkill(directory: string, slug: string, reason?: st
     markerPath: string;
     reason?: string;
 }>;
-export declare function regenerateSkill(directory: string, slug: string): Promise<{
+export declare function regenerateSkill(directory: string, slug: string, options?: {
+    evaluate?: boolean;
+}): Promise<{
     regenerated: boolean;
     path: string;
     entryCount: number;
     reason?: string;
     retired?: boolean;
+    evaluation?: SkillEvaluationResult;
 }>;
 export declare const _internals: {
     sanitizeSlug: typeof sanitizeSlug;

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

@@ -27,6 +27,8 @@ export interface SkillImproverConfigInput {
     fallback_models: string[];
     max_calls_per_day: number;
     trigger: 'manual' | 'scheduled';
+    consolidation_interval_hours?: number;
+    consolidation_max_calls_per_run?: number;
     targets: Array<'skills' | 'spec' | 'architect_prompt' | 'knowledge'>;
     write_mode: 'proposal' | 'draft_skills';
     require_user_approval: boolean;
@@ -50,6 +52,10 @@ export interface SkillImproveRequest {
     /** Dedicated quota for hardening quarantined knowledge entries. This is
      *  separate from the skill_improver proposal quota above. */
     enrichmentQuota?: EnrichmentQuotaOptions;
+    /** Validate generated draft skills when write_mode is draft_skills. */
+    evaluateDrafts?: boolean;
+    /** Consolidation callers stage proposals only and must never auto-apply. */
+    allowAutoApply?: boolean;
 }
 export interface SkillImproveResult {
     ran: boolean;

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

@@ -46,6 +46,12 @@ declare function buildLLMPrompt(currentContent: string, currentVersion: number,
     userPrompt: string;
 };
 declare function validateLLMOutput(output: string): boolean;
+declare function validateRevisionCandidate(params: ReviseSkillParams, candidateContent: string, operation: string): Promise<{
+    passed: true;
+} | {
+    passed: false;
+    reason: string;
+}>;
 export declare function reviseSkill(params: ReviseSkillParams): Promise<SkillRevisionResult>;
 export declare const _internals: {
     reviseSkill: typeof reviseSkill;
@@ -53,6 +59,7 @@ export declare const _internals: {
     buildDeterministicRevision: typeof buildDeterministicRevision;
     buildLLMPrompt: typeof buildLLMPrompt;
     validateLLMOutput: typeof validateLLMOutput;
+    validateRevisionCandidate: typeof validateRevisionCandidate;
     REVISION_VIOLATION_THRESHOLD: number;
     MAX_REVISION_CALLS_PER_PHASE: number;
 };

package/package.json

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