opencode-swarm 6.67.1 → 6.68.1

package/dist/mutation/__tests__/engine.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mutation/__tests__/engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mutation/__tests__/equivalence.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mutation/__tests__/equivalence.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mutation/__tests__/gate.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mutation/__tests__/gate.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mutation/engine.d.ts

@@ -0,0 +1,47 @@
+export type MutationOutcome = 'killed' | 'survived' | 'timeout' | 'error' | 'equivalent' | 'skipped';
+export interface MutationPatch {
+    id: string;
+    filePath: string;
+    functionName: string;
+    mutationType: string;
+    patch: string;
+    lineNumber?: number;
+}
+export interface MutationResult {
+    patchId: string;
+    filePath: string;
+    functionName: string;
+    mutationType: string;
+    outcome: MutationOutcome;
+    testOutput?: string;
+    durationMs: number;
+    error?: string;
+}
+export interface MutationReport {
+    totalMutants: number;
+    killed: number;
+    survived: number;
+    timeout: number;
+    equivalent: number;
+    skipped: number;
+    errors: number;
+    killRate: number;
+    adjustedKillRate: number;
+    perFunction: Map<string, {
+        killed: number;
+        survived: number;
+        total: number;
+        equivalent: number;
+        skipped: number;
+        killRate: number;
+    }>;
+    results: MutationResult[];
+    durationMs: number;
+    budgetMs: number;
+    budgetExceeded: boolean;
+    timestamp: string;
+}
+export declare const MAX_MUTATIONS_PER_FUNCTION = 10;
+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>;

package/dist/mutation/equivalence.d.ts

@@ -0,0 +1,35 @@
+import type { MutationPatch } from './engine.js';
+/** Result of equivalence check for a single mutant */
+export interface EquivalenceResult {
+    patchId: string;
+    isEquivalent: boolean;
+    method: 'static' | 'llm_judge' | 'skipped';
+    confidence: number;
+    reason: string;
+}
+/** Callback signature for LLM judge — injected by caller */
+export type LLMJudgeCallback = (original: string, mutated: string, context: string) => Promise<{
+    isEquivalent: boolean;
+    confidence: number;
+    reason: string;
+}>;
+/**
+ * Stage 1: Static equivalence filter.
+ * Strips comments (single-line // and multi-line /* *\/), console.log/debugger statements,
+ * trailing whitespace, and blank lines. Returns true if the stripped versions are identical.
+ */
+export declare function isStaticallyEquivalent(originalCode: string, mutatedCode: string): boolean;
+/**
+ * Check a single mutant for equivalence using two-stage approach.
+ * Stage 1: static analysis. Stage 2: LLM judge (if provided and Stage 1 didn't determine equivalence).
+ */
+export declare function checkEquivalence(patch: MutationPatch, originalCode: string, mutatedCode: string, llmJudge?: LLMJudgeCallback): Promise<EquivalenceResult>;
+/**
+ * Batch check multiple mutants for equivalence.
+ * Returns results for all patches.
+ */
+export declare function batchCheckEquivalence(patches: Array<{
+    patch: MutationPatch;
+    originalCode: string;
+    mutatedCode: string;
+}>, llmJudge?: LLMJudgeCallback): Promise<EquivalenceResult[]>;

package/dist/mutation/gate.d.ts

@@ -0,0 +1,28 @@
+import type { MutationReport, MutationResult } from './engine.js';
+export type MutationGateVerdict = 'pass' | 'warn' | 'fail';
+export interface MutationGateResult {
+    verdict: MutationGateVerdict;
+    killRate: number;
+    adjustedKillRate: number;
+    totalMutants: number;
+    killed: number;
+    survived: number;
+    threshold: number;
+    warnThreshold: number;
+    message: string;
+    /** Survived mutants that need test improvements */
+    survivedMutants: MutationResult[];
+    /** Prompt for targeted test improvement (non-empty when verdict is 'warn' or 'fail') */
+    testImprovementPrompt: string;
+}
+/** Default thresholds */
+export declare const PASS_THRESHOLD = 0.8;
+export declare const WARN_THRESHOLD = 0.6;
+/**
+ * Evaluate a mutation report against quality gate thresholds.
+ * @param report - The mutation report to evaluate
+ * @param passThreshold - Kill rate at or above this passes (default: 0.80)
+ * @param warnThreshold - Kill rate at or above this warns (default: 0.60)
+ * @returns MutationGateResult with verdict and details
+ */
+export declare function evaluateMutationGate(report: MutationReport, passThreshold?: number, warnThreshold?: number): MutationGateResult;

package/dist/state.d.ts

@@ -7,6 +7,7 @@
  * and delegation chains.
  */
 import type { OpencodeClient } from '@opencode-ai/sdk';
+import type { QaGates } from './db/qa-gate-profile.js';
 import { type EnvironmentProfile } from './environment/profile.js';
 /**
  * Represents a single tool call entry for tracking purposes
@@ -133,6 +134,12 @@ export interface AgentSessionState {
     modelFallbackExhausted: boolean;
     /** Session-scoped Turbo Mode flag for controlling LLM inference speed */
     turboMode: boolean;
+    /** Session-level QA gate overrides layered on top of the spec-level profile.
+     *  Overrides can only enable gates (true); false values are ignored by
+     *  getEffectiveGates. Cleared on session reset. Optional for backwards
+     *  compatibility with pre-existing session state fixtures; consumers
+     *  should read via `session.qaGateSessionOverrides ?? {}`. */
+    qaGateSessionOverrides?: Partial<QaGates>;
     /** Session-scoped Full Auto flag for autonomous multi-agent oversight */
     fullAutoMode: boolean;
     /** Count of full-auto interactions this phase (for max_interactions_per_phase limit) */

package/dist/test-impact/__tests__/analyzer-import-fix.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/analyzer-import-fix.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/analyzer.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/analyzer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/council-fixes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/failure-classifier.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/failure-classifier.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/flaky-detector.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/flaky-detector.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/history-store.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/history-store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/test-impact.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/__tests__/test-impact.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-impact/analyzer.d.ts

@@ -0,0 +1,9 @@
+export interface TestImpactResult {
+    impactedTests: string[];
+    unrelatedTests: string[];
+    untestedFiles: string[];
+    impactMap: Record<string, string[]>;
+}
+export declare function buildImpactMap(cwd: string): Promise<Record<string, string[]>>;
+export declare function loadImpactMap(cwd: string): Promise<Record<string, string[]>>;
+export declare function analyzeImpact(changedFiles: string[], cwd: string): Promise<TestImpactResult>;

package/dist/test-impact/failure-classifier.d.ts

@@ -0,0 +1,26 @@
+import type { TestRunRecord } from './history-store.js';
+export type FailureClassification = 'new_regression' | 'pre_existing' | 'flaky' | 'unknown';
+export interface ClassifiedFailure {
+    testFile: string;
+    testName: string;
+    classification: FailureClassification;
+    errorMessage?: string;
+    stackPrefix?: string;
+    durationMs: number;
+    confidence: number;
+}
+export interface FailureCluster {
+    clusterId: string;
+    rootCause: string;
+    stackPrefix?: string;
+    errorMessage?: string;
+    failures: ClassifiedFailure[];
+    classification: FailureClassification;
+    affectedTestFiles: string[];
+}
+export declare function classifyFailure(currentResult: TestRunRecord, history: TestRunRecord[]): ClassifiedFailure;
+export declare function clusterFailures(failures: ClassifiedFailure[]): FailureCluster[];
+export declare function classifyAndCluster(testResults: TestRunRecord[], history: TestRunRecord[]): {
+    classified: ClassifiedFailure[];
+    clusters: FailureCluster[];
+};

package/dist/test-impact/flaky-detector.d.ts

@@ -0,0 +1,14 @@
+import type { TestRunRecord } from './history-store.js';
+export interface FlakyTestEntry {
+    testFile: string;
+    testName: string;
+    flakyScore: number;
+    totalRuns: number;
+    alternationCount: number;
+    isQuarantined: boolean;
+    recentResults: Array<'pass' | 'fail' | 'skip'>;
+    recommendation?: string;
+}
+export declare function computeFlakyScore(history: TestRunRecord[]): number;
+export declare function detectFlakyTests(allHistory: TestRunRecord[]): FlakyTestEntry[];
+export declare function isTestQuarantined(testFile: string, testName: string, allHistory: TestRunRecord[]): boolean;

package/dist/test-impact/history-store.d.ts

@@ -0,0 +1,15 @@
+export type TestRunResult = 'pass' | 'fail' | 'skip';
+export interface TestRunRecord {
+    timestamp: string;
+    taskId: string;
+    testFile: string;
+    testName: string;
+    result: TestRunResult;
+    durationMs: number;
+    errorMessage?: string;
+    stackPrefix?: string;
+    changedFiles: string[];
+}
+export declare function appendTestRun(record: TestRunRecord, workingDir?: string): void;
+export declare function getTestHistory(testFile: string, workingDir?: string): TestRunRecord[];
+export declare function getAllHistory(workingDir?: string): TestRunRecord[];

package/dist/tools/__tests__/barrel-exports.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/diff-ast-fallback.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/diff-markdown-summary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/diff-semantic.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/diff-summary.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/diff-summary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/mutation-test.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/mutation-test.sourcefiles.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/mutation-test.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/test-runner-history.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/test-runner-impact.adversarial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/test-runner-impact.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/test-runner-source-files.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/diff-summary.d.ts

@@ -0,0 +1,12 @@
+import { type ChangeCategory, type RiskLevel } from '../diff/semantic-classifier.js';
+import { createSwarmTool } from './create-tool';
+export interface DiffSummaryArgs {
+    files: string[];
+    classification?: ChangeCategory;
+    riskLevel?: RiskLevel;
+}
+/**
+ * Standalone tool that wraps the semantic classifier + summary generator
+ * to produce a filtered SemanticDiffSummary.
+ */
+export declare const diff_summary: ReturnType<typeof createSwarmTool>;

package/dist/tools/diff.d.ts

@@ -1,4 +1,5 @@
 import { type ASTDiffResult } from '../diff/ast-diff.js';
+import { type SemanticDiffSummary } from '../diff/summary-generator.js';
 import { createSwarmTool } from './create-tool';
 export interface DiffResult {
     files: Array<{
@@ -10,6 +11,8 @@ export interface DiffResult {
     hasContractChanges: boolean;
     summary: string;
     astDiffs?: ASTDiffResult[];
+    semanticSummary?: SemanticDiffSummary;
+    markdownSummary?: string;
 }
 export interface DiffErrorResult {
     error: string;

package/dist/tools/get-approved-plan.d.ts

@@ -22,6 +22,10 @@ interface GetApprovedPlanResult {
     current_plan?: CurrentPlanPayload | null;
     drift_detected?: boolean | 'unknown';
     current_plan_error?: string;
+    /** SHA-256 hex digest over {plan_id, gates} of the current QA gate profile,
+     *  or null when no profile exists for this plan. Used by the critic to
+     *  detect silent gate mutations post-approval. */
+    qa_profile_hash?: string | null;
 }
 interface ApprovedPlanPayload {
     plan: unknown;

package/dist/tools/get-qa-gate-profile.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tool to retrieve the QA gate profile for the current plan.
+ *
+ * Read-only: derives plan_id from plan.json, then looks up the profile in the
+ * per-project DB. Returns the spec-level profile gates, lock state, and profile
+ * hash. Callers layering session overrides should combine with
+ * `getEffectiveGates` themselves — this tool intentionally returns the
+ * persisted/locked spec-level view.
+ */
+import type { tool } from '@opencode-ai/plugin';
+interface GetQaGateProfileResult {
+    success: boolean;
+    reason?: string;
+    plan_id?: string;
+    profile?: {
+        plan_id: string;
+        project_type: string | null;
+        gates: Record<string, boolean>;
+        locked_at: string | null;
+        locked_by_snapshot_seq: number | null;
+        created_at: string;
+        profile_hash: string;
+    };
+}
+export declare function executeGetQaGateProfile(_args: Record<string, unknown>, directory: string): Promise<GetQaGateProfileResult>;
+export declare const get_qa_gate_profile: ReturnType<typeof tool>;
+export {};

package/dist/tools/index.d.ts

@@ -10,11 +10,13 @@ export { curator_analyze } from './curator-analyze';
 export { declare_council_criteria } from './declare-council-criteria';
 export { declare_scope } from './declare-scope';
 export { type DiffErrorResult, type DiffResult, diff } from './diff';
+export { diff_summary } from './diff-summary';
 export { doc_extract, doc_scan } from './doc-scan';
 export { detect_domains } from './domain-detector';
 export { evidence_check } from './evidence-check';
 export { extract_code_blocks } from './file-extractor';
 export { get_approved_plan } from './get-approved-plan';
+export { get_qa_gate_profile } from './get-qa-gate-profile';
 export { fetchGitingest, type GitingestArgs, gitingest } from './gitingest';
 export { imports } from './imports';
 export { knowledge_add } from './knowledge-add';
@@ -38,13 +40,20 @@ export { type SbomGenerateInput, type SbomGenerateResult, sbom_generate, } from
 export { schema_drift } from './schema-drift';
 export { search } from './search';
 export { type SecretFinding, type SecretscanResult, secretscan, } from './secretscan';
+export { set_qa_gates } from './set-qa-gates';
 import { suggestPatch } from './suggest-patch';
 export { suggestPatch };
 export type { SuggestPatchArgs } from './suggest-patch';
 export declare const suggest_patch: typeof suggestPatch;
+export type { ClassifiedFailure, FailureClassification, FailureCluster, } from '../test-impact/failure-classifier.js';
+export { classifyAndCluster, classifyFailure, clusterFailures, } from '../test-impact/failure-classifier.js';
+export type { FlakyTestEntry } from '../test-impact/flaky-detector.js';
+export { computeFlakyScore, detectFlakyTests, isTestQuarantined, } from '../test-impact/flaky-detector.js';
 export { lint_spec } from './lint-spec';
+export { mutation_test } from './mutation-test';
 export { symbols } from './symbols';
 export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntax_check, syntaxCheck, } from './syntax-check';
+export { test_impact } from './test-impact';
 export { test_runner } from './test-runner';
 export { todo_extract } from './todo-extract';
 export { executeUpdateTaskStatus, type UpdateTaskStatusArgs, type UpdateTaskStatusResult, update_task_status, } from './update-task-status';

package/dist/tools/mutation-test.d.ts

@@ -0,0 +1,2 @@
+import { createSwarmTool } from './create-tool';
+export declare const mutation_test: ReturnType<typeof createSwarmTool>;

package/dist/tools/mutation-test.security.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/set-qa-gates.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tool to configure the QA gate profile for the current plan.
+ *
+ * Architect-only: invoked during the QA GATE SELECTION phase of brainstorm
+ * mode (or equivalent). Ratchet-tighter only — cannot disable gates that are
+ * already enabled. Rejects all writes once the profile is locked.
+ *
+ * Creates the profile with defaults if missing, then applies the requested
+ * partial update.
+ */
+import { tool } from '@opencode-ai/plugin';
+export interface SetQaGatesArgs {
+    reviewer?: boolean;
+    test_engineer?: boolean;
+    council_mode?: boolean;
+    sme_enabled?: boolean;
+    critic_pre_plan?: boolean;
+    hallucination_guard?: boolean;
+    sast_enabled?: boolean;
+    project_type?: string;
+}
+interface SetQaGatesResult {
+    success: boolean;
+    reason?: string;
+    message?: string;
+    plan_id?: string;
+    profile?: {
+        plan_id: string;
+        gates: Record<string, boolean>;
+        locked_at: string | null;
+        locked_by_snapshot_seq: number | null;
+        profile_hash: string;
+    };
+}
+export declare function executeSetQaGates(args: SetQaGatesArgs, directory: string): Promise<SetQaGatesResult>;
+export declare const set_qa_gates: ReturnType<typeof tool>;
+export {};

package/dist/tools/test-impact.d.ts

@@ -0,0 +1,2 @@
+import { createSwarmTool } from './create-tool';
+export declare const test_impact: ReturnType<typeof createSwarmTool>;

package/dist/tools/test-runner.d.ts

@@ -7,7 +7,7 @@ export declare const MAX_SAFE_TEST_FILES = 50;
 export declare const SUPPORTED_FRAMEWORKS: readonly ["bun", "vitest", "jest", "mocha", "pytest", "cargo", "pester", "go-test", "maven", "gradle", "dotnet-test", "ctest", "swift-test", "dart-test", "rspec", "minitest"];
 export type TestFramework = (typeof SUPPORTED_FRAMEWORKS)[number] | 'none';
 export interface TestRunnerArgs {
-    scope?: 'all' | 'convention' | 'graph';
+    scope?: 'all' | 'convention' | 'graph' | 'impact';
     files?: string[];
     coverage?: boolean;
     timeout_ms?: number;
@@ -23,7 +23,7 @@ export interface TestTotals {
 export interface TestSuccessResult {
     success: true;
     framework: TestFramework;
-    scope: 'all' | 'convention' | 'graph';
+    scope: 'all' | 'convention' | 'graph' | 'impact';
     command: string[];
     timeout_ms: number;
     duration_ms: number;
@@ -36,7 +36,7 @@ export interface TestSuccessResult {
 export interface TestErrorResult {
     success: false;
     framework: TestFramework;
-    scope: 'all' | 'convention' | 'graph';
+    scope: 'all' | 'convention' | 'graph' | 'impact';
     command?: string[];
     timeout_ms?: number;
     duration_ms?: number;
@@ -50,5 +50,5 @@ export interface TestErrorResult {
 }
 export type TestResult = TestSuccessResult | TestErrorResult;
 export declare function detectTestFramework(cwd: string): Promise<TestFramework>;
-export declare function runTests(framework: TestFramework, scope: 'all' | 'convention' | 'graph', files: string[], coverage: boolean, timeout_ms: number, cwd: string): Promise<TestResult>;
+export declare function runTests(framework: TestFramework, scope: 'all' | 'convention' | 'graph' | 'impact', files: string[], coverage: boolean, timeout_ms: number, cwd: string): Promise<TestResult>;
 export declare const test_runner: ReturnType<typeof tool>;

package/dist/tools/tool-names.d.ts

@@ -3,7 +3,7 @@
  * Used for constants and agent setup references.
  */
 /** Union type of all valid tool names */
-export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'check_gate_status' | 'completion_verify' | 'convene_council' | 'declare_council_criteria' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'lint_spec' | 'write_retro' | 'write_drift_evidence' | 'declare_scope' | 'knowledge_query' | 'doc_scan' | 'doc_extract' | 'curator_analyze' | 'knowledge_add' | 'knowledge_recall' | 'knowledge_remove' | 'co_change_analyzer' | 'search' | 'batch_symbols' | 'suggest_patch' | 'req_coverage' | 'get_approved_plan' | 'repo_map';
+export type ToolName = 'diff' | 'diff_summary' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'check_gate_status' | 'completion_verify' | 'convene_council' | 'declare_council_criteria' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'test_impact' | 'mutation_test' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'lint_spec' | 'write_retro' | 'write_drift_evidence' | 'declare_scope' | 'knowledge_query' | 'doc_scan' | 'doc_extract' | 'curator_analyze' | 'knowledge_add' | 'knowledge_recall' | 'knowledge_remove' | 'co_change_analyzer' | 'search' | 'batch_symbols' | 'suggest_patch' | 'req_coverage' | 'get_approved_plan' | 'repo_map' | 'get_qa_gate_profile' | 'set_qa_gates';
 /** Readonly array of all tool names */
 export declare const TOOL_NAMES: readonly ToolName[];
 /** Set for O(1) tool name validation */

package/package.json

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