opencode-swarm 7.66.3 → 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/dist/state.d.ts

@@ -46,6 +46,19 @@ export interface DelegationEntry {
  * Used by delegation-tracker.ts to record why a delegation occurred.
  */
 export type DelegationReason = 'normal_delegation' | 'review_rejected' | 'critic_consultation' | 'retry_circuit_breaker' | 'conflict_escalation' | 'stale_recovery';
+/**
+ * Per-session PR subscription state for the background PR poller.
+ * Keyed by `${repoFullName}::${prNumber}` within the session's prSubscriptions Map.
+ */
+export interface PrSubscriptionState {
+    prNumber: number;
+    repoFullName: string;
+    prUrl: string;
+    lastKnownStatus: string;
+    lastPollTime: number;
+    errorCount: number;
+    isWatching: boolean;
+}
 /**
  * Per-task workflow state for gate progression tracking.
  * Transitions must be forward-only: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
@@ -226,6 +239,8 @@ export interface AgentSessionState {
     prmHardStopPending: boolean;
     /** Per-session escalation tracker instance (set lazily by PRM hook) */
     prmEscalationTracker?: EscalationTracker;
+    /** Active PR subscriptions for the background poller, keyed by `${repoFullName}::${prNumber}` */
+    prSubscriptions: Map<string, PrSubscriptionState>;
 }
 /**
  * Represents a single agent invocation window with isolated guardrail budgets.
@@ -628,6 +643,16 @@ export declare function clearCriticalShownIds(sessionID: string): boolean;
 /** Add a knowledge ack dedup key, FIFO-evicting the oldest if the cap is
  * exceeded. Sets preserve insertion order in JS. */
 export declare function addKnowledgeAckDedup(key: string): void;
+/**
+ * Rehydrate PR subscriptions for a given session from durable storage.
+ * Reads active subscriptions from the JSONL store and filters to those
+ * belonging to the specified sessionID, converting each to a PrSubscriptionState.
+ *
+ * @param sessionID - The session identifier to filter subscriptions by
+ * @param directory - Project root containing .swarm/ subdirectory
+ * @returns Map of PrSubscriptionState keyed by `${repoFullName}::${prNumber}`
+ */
+export declare function rehydratePrSubscriptions(sessionID: string, directory: string): Promise<Map<string, PrSubscriptionState>>;
 /**
  * Test-only dependency-injection seam. Production code calls
  * `_internals.*` for key exported functions and objects so tests can replace

package/package.json

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