opencode-swarm 7.67.0 → 7.68.0

package/dist/mutation/engine.d.ts

@@ -1,6 +1,17 @@
 import { spawnSync } from 'node:child_process';
 type SpawnSyncFn = typeof spawnSync;
 export type MutationOutcome = 'killed' | 'survived' | 'timeout' | 'error' | 'equivalent' | 'skipped';
+/**
+ * Known test runner executables permitted as the first element of testCommand.
+ * Validated as the basename (without extension) to support platform-specific
+ * variants like `bun.exe` on Windows or full paths like `/usr/local/bin/jest`.
+ */
+export declare const ALLOWED_TEST_RUNNERS: Set<string>;
+/**
+ * Validate that testCommand[0] is a known test runner.
+ * Returns an error string if invalid, or null if valid.
+ */
+export declare function validateTestCommand(testCommand: string[]): string | null;
 export interface MutationPatch {
     id: string;
     filePath: string;
@@ -50,7 +61,7 @@ export declare const _internals: {
     executeMutationSuite: typeof executeMutationSuite;
     spawnSync: SpawnSyncFn;
 };
-export declare function executeMutation(patch: MutationPatch, testCommand: string[], _testFiles: string[], workingDir: string): Promise<MutationResult>;
+export declare function executeMutation(patch: MutationPatch, testCommand: string[], testFiles: string[], workingDir: string): Promise<MutationResult>;
 export declare function computeReport(results: MutationResult[], durationMs: number, budgetMs?: number): MutationReport;
 export declare function executeMutationSuite(patches: MutationPatch[], testCommand: string[], testFiles: string[], workingDir: string, budgetMs?: number, onProgress?: (completed: number, total: number, result: MutationResult) => void, sourceFiles?: Map<string, string>): Promise<MutationReport>;
 export {};

package/dist/services/learning-metrics.d.ts

@@ -0,0 +1,63 @@
+export interface LearningMetrics {
+    violationTrends: ViolationTrend[];
+    overallViolationRate: {
+        window7d: number;
+        window30d: number;
+    };
+    applicationRateByPriority: Record<string, {
+        applied: number;
+        total: number;
+        rate: number;
+    }>;
+    timeToLatestApplication: TimeToApply[];
+    escalationFrequency: {
+        total: number;
+        last7d: number;
+        last30d: number;
+    };
+    unacknowledgedCriticalCount: number;
+    entryROI: EntryROI[];
+    neverApplied: NeverAppliedEntry[];
+    learningSummary: string;
+    sessionCount: number;
+}
+export interface ViolationTrend {
+    entryId: string;
+    lesson: string;
+    priority: string;
+    violationRate7d: number;
+    violationRate30d: number;
+    trend: 'improving' | 'worsening' | 'stable' | 'no_data';
+}
+export interface EntryROI {
+    entryId: string;
+    lesson: string;
+    appliedCount: number;
+    shownCount: number;
+    succeededCount: number;
+    failedCount: number;
+    roi: 'high' | 'medium' | 'low' | 'unused';
+}
+export interface TimeToApply {
+    entryId: string;
+    lesson: string;
+    daysToApply: number | null;
+}
+export interface NeverAppliedEntry {
+    entryId: string;
+    lesson: string;
+    phasesAlive: number;
+}
+export declare function computeLearningMetrics(directory: string, options?: {
+    now?: Date;
+    currentPhase?: number;
+}): Promise<LearningMetrics>;
+export declare function formatLearningMarkdown(metrics: LearningMetrics): string;
+export declare function formatLearningJSON(metrics: LearningMetrics): object;
+export declare function formatLearningSummary(metrics: LearningMetrics): string;
+export declare const _internals: {
+    computeLearningMetrics: typeof computeLearningMetrics;
+    formatLearningMarkdown: typeof formatLearningMarkdown;
+    formatLearningJSON: typeof formatLearningJSON;
+    formatLearningSummary: typeof formatLearningSummary;
+};

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

@@ -0,0 +1,21 @@
+export declare const MAX_CHANGELOG_ENTRIES_PER_SKILL = 200;
+export interface SkillChangelogEntry {
+    version: number;
+    timestamp: string;
+    action: 'generated' | 'regenerated' | 'revised' | 'promoted';
+    reason: string;
+    triggeringVerdicts?: {
+        taskId: string;
+        verdict: string;
+        agent: string;
+    }[];
+    sectionsChanged?: string[];
+}
+export declare function resolveSkillChangelogPath(directory: string, slug: string): string;
+export declare function appendSkillChangelog(directory: string, slug: string, entry: SkillChangelogEntry): Promise<void>;
+export declare function readSkillChangelog(directory: string, slug: string): Promise<SkillChangelogEntry[]>;
+export declare const _internals: {
+    resolveSkillChangelogPath: typeof resolveSkillChangelogPath;
+    appendSkillChangelog: typeof appendSkillChangelog;
+    readSkillChangelog: typeof readSkillChangelog;
+};

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

@@ -42,7 +42,11 @@ export declare function selectCandidateEntries(directory: string, opts: Candidat
  */
 declare function jaccardSimilarity(setA: string[], setB: string[]): number;
 export declare function clusterEntries(entries: KnowledgeEntryBase[]): KnowledgeCluster[];
-export declare function renderSkillMarkdown(cluster: KnowledgeCluster, mode?: GenerateMode, generatedAt?: string): string;
+export interface SkillFrontmatterOverrides {
+    version?: number;
+    skillOrigin?: 'generated' | 'promoted_external';
+}
+export declare function renderSkillMarkdown(cluster: KnowledgeCluster, mode?: GenerateMode, generatedAt?: string, overrides?: SkillFrontmatterOverrides): string;
 export type GenerateMode = 'draft' | 'active';
 export interface GenerateRequest {
     directory: string;
@@ -86,6 +90,8 @@ export declare function parseDraftFrontmatter(content: string): {
     status?: string;
     generatedAt?: string;
     sourceKnowledgeIds: string[];
+    version?: number;
+    skillOrigin?: string;
 } | null;
 export declare function activateProposal(directory: string, slug: string, force?: boolean): Promise<{
     activated: boolean;

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

@@ -0,0 +1,59 @@
+/**
+ * Skill revision service.
+ *
+ * When a skill's violation rate crosses a soft threshold (>15% but ≤30%),
+ * produces a revised version by feeding violation contexts into a bounded
+ * LLM rewrite of the violated sections. Reuses the skill_improver.max_calls_per_day
+ * quota budget but is capped to max 3 LLM calls per curator phase to avoid
+ * starving manual skill-improve runs.
+ *
+ * Falls back to deterministic revision (append revision notes) when no LLM
+ * delegate is available or quota is exhausted.
+ */
+import type { SkillImproverLLMDelegate } from '../hooks/skill-improver-llm-factory.js';
+import type { QuotaWindow } from './skill-improver-quota.js';
+export declare const REVISION_VIOLATION_THRESHOLD = 0.15;
+export declare const MAX_REVISION_CALLS_PER_PHASE = 3;
+export interface ViolationContext {
+    taskId: string;
+    agent: string;
+    verdict: string;
+    reviewerNotes?: string;
+    timestamp: string;
+}
+export interface SkillRevisionResult {
+    revised: boolean;
+    reason: string;
+    newVersion?: number;
+    quotaConsumed: boolean;
+}
+export interface ReviseSkillParams {
+    directory: string;
+    slug: string;
+    skillPath: string;
+    violationContexts: ViolationContext[];
+    currentContent: string;
+    currentVersion: number;
+    maxCalls?: number;
+    quotaWindow?: QuotaWindow;
+    delegate?: SkillImproverLLMDelegate;
+    now?: Date;
+}
+export declare function getSkillVersion(skillPath: string): Promise<number>;
+export declare function buildDeterministicRevision(currentContent: string, currentVersion: number, violationContexts: ViolationContext[]): string;
+declare function buildLLMPrompt(currentContent: string, currentVersion: number, violationContexts: ViolationContext[]): {
+    systemPrompt: string;
+    userPrompt: string;
+};
+declare function validateLLMOutput(output: string): boolean;
+export declare function reviseSkill(params: ReviseSkillParams): Promise<SkillRevisionResult>;
+export declare const _internals: {
+    reviseSkill: typeof reviseSkill;
+    getSkillVersion: typeof getSkillVersion;
+    buildDeterministicRevision: typeof buildDeterministicRevision;
+    buildLLMPrompt: typeof buildLLMPrompt;
+    validateLLMOutput: typeof validateLLMOutput;
+    REVISION_VIOLATION_THRESHOLD: number;
+    MAX_REVISION_CALLS_PER_PHASE: number;
+};
+export {};

package/package.json

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