opencode-swarm 6.8.1 → 6.9.0

package/dist/config/loader.d.ts

@@ -0,0 +1,32 @@
+import { type PluginConfig } from './schema';
+export declare const MAX_CONFIG_FILE_BYTES = 102400;
+export { deepMerge, MAX_MERGE_DEPTH } from '../utils/merge';
+/**
+ * Load plugin configuration from user and project config files.
+ *
+ * Config locations:
+ * 1. User config: ~/.config/opencode/opencode-swarm.json
+ * 2. Project config: <directory>/.opencode/opencode-swarm.json
+ *
+ * Project config takes precedence. Nested objects are deep-merged.
+ * IMPORTANT: Raw configs are merged BEFORE Zod parsing so that
+ * Zod defaults don't override explicit user values.
+ */
+export declare function loadPluginConfig(directory: string): PluginConfig;
+/**
+ * Internal variant of loadPluginConfig that also returns loader metadata.
+ * Used only by src/index.ts to determine guardrails fallback behavior.
+ * NOT part of the public API — use loadPluginConfig() for all other callers.
+ */
+export declare function loadPluginConfigWithMeta(directory: string): {
+    config: PluginConfig;
+    loadedFromFile: boolean;
+};
+/**
+ * Load custom prompt for an agent from the prompts directory.
+ * Checks for {agent}.md (replaces default) and {agent}_append.md (appends).
+ */
+export declare function loadAgentPrompt(agentName: string): {
+    prompt?: string;
+    appendPrompt?: string;
+};

package/dist/{src/config → config}/schema.d.ts

@@ -120,6 +120,57 @@ export declare const EvidenceConfigSchema: z.ZodObject<{
     auto_archive: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type EvidenceConfig = z.infer<typeof EvidenceConfigSchema>;
+export declare const GateFeatureSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GateFeature = z.infer<typeof GateFeatureSchema>;
+export declare const PlaceholderScanConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    deny_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    allow_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    max_allowed_findings: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type PlaceholderScanConfig = z.infer<typeof PlaceholderScanConfigSchema>;
+export declare const QualityBudgetConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    max_complexity_delta: z.ZodDefault<z.ZodNumber>;
+    max_public_api_delta: z.ZodDefault<z.ZodNumber>;
+    max_duplication_ratio: z.ZodDefault<z.ZodNumber>;
+    min_test_to_code_ratio: z.ZodDefault<z.ZodNumber>;
+    enforce_on_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    exclude_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type QualityBudgetConfig = z.infer<typeof QualityBudgetConfigSchema>;
+export declare const GateConfigSchema: z.ZodObject<{
+    syntax_check: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    placeholder_scan: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        deny_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        allow_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        max_allowed_findings: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    sast_scan: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    sbom_generate: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    build_check: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    quality_budget: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        max_complexity_delta: z.ZodDefault<z.ZodNumber>;
+        max_public_api_delta: z.ZodDefault<z.ZodNumber>;
+        max_duplication_ratio: z.ZodDefault<z.ZodNumber>;
+        min_test_to_code_ratio: z.ZodDefault<z.ZodNumber>;
+        enforce_on_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        exclude_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type GateConfig = z.infer<typeof GateConfigSchema>;
 export declare const SummaryConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     threshold_bytes: z.ZodDefault<z.ZodNumber>;
@@ -245,11 +296,6 @@ export declare const CheckpointConfigSchema: z.ZodObject<{
     auto_checkpoint_threshold: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type CheckpointConfig = z.infer<typeof CheckpointConfigSchema>;
-export declare const GitingestConfigSchema: z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    endpoint: z.ZodDefault<z.ZodString>;
-}, z.core.$strip>;
-export type GitingestConfig = z.infer<typeof GitingestConfigSchema>;
 export declare const AutomationModeSchema: z.ZodEnum<{
     auto: "auto";
     manual: "manual";
@@ -282,7 +328,7 @@ declare const AutomationConfigSchemaBase: z.ZodObject<{
 }, z.core.$strip>;
 export type AutomationConfig = z.infer<typeof AutomationConfigSchemaBase>;
 export declare const AutomationConfigSchema: z.ZodType<AutomationConfig>;
-export declare const pluginConfigShape: {
+export declare const PluginConfigSchema: z.ZodObject<{
     agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
         temperature: z.ZodOptional<z.ZodNumber>;
@@ -308,167 +354,34 @@ export declare const pluginConfigShape: {
         delegation_gate: z.ZodDefault<z.ZodBoolean>;
         delegation_max_chars: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
-    context_budget: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        warn_threshold: z.ZodDefault<z.ZodNumber>;
-        critical_threshold: z.ZodDefault<z.ZodNumber>;
-        model_limits: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        max_injection_tokens: z.ZodDefault<z.ZodNumber>;
-        scoring: z.ZodOptional<z.ZodObject<{
+    gates: z.ZodOptional<z.ZodObject<{
+        syntax_check: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
-            max_candidates: z.ZodDefault<z.ZodNumber>;
-            weights: z.ZodOptional<z.ZodObject<{
-                phase: z.ZodDefault<z.ZodNumber>;
-                current_task: z.ZodDefault<z.ZodNumber>;
-                blocked_task: z.ZodDefault<z.ZodNumber>;
-                recent_failure: z.ZodDefault<z.ZodNumber>;
-                recent_success: z.ZodDefault<z.ZodNumber>;
-                evidence_presence: z.ZodDefault<z.ZodNumber>;
-                decision_recency: z.ZodDefault<z.ZodNumber>;
-                dependency_proximity: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip>>;
-            decision_decay: z.ZodOptional<z.ZodObject<{
-                mode: z.ZodDefault<z.ZodEnum<{
-                    linear: "linear";
-                    exponential: "exponential";
-                }>>;
-                half_life_hours: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip>>;
-            token_ratios: z.ZodOptional<z.ZodObject<{
-                prose: z.ZodDefault<z.ZodNumber>;
-                code: z.ZodDefault<z.ZodNumber>;
-                markdown: z.ZodDefault<z.ZodNumber>;
-                json: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    guardrails: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        max_tool_calls: z.ZodDefault<z.ZodNumber>;
-        max_duration_minutes: z.ZodDefault<z.ZodNumber>;
-        max_repetitions: z.ZodDefault<z.ZodNumber>;
-        max_consecutive_errors: z.ZodDefault<z.ZodNumber>;
-        warning_threshold: z.ZodDefault<z.ZodNumber>;
-        idle_timeout_minutes: z.ZodDefault<z.ZodNumber>;
-        profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            max_tool_calls: z.ZodOptional<z.ZodNumber>;
-            max_duration_minutes: z.ZodOptional<z.ZodNumber>;
-            max_repetitions: z.ZodOptional<z.ZodNumber>;
-            max_consecutive_errors: z.ZodOptional<z.ZodNumber>;
-            warning_threshold: z.ZodOptional<z.ZodNumber>;
-            idle_timeout_minutes: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    evidence: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        max_age_days: z.ZodDefault<z.ZodNumber>;
-        max_bundles: z.ZodDefault<z.ZodNumber>;
-        auto_archive: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    summaries: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        threshold_bytes: z.ZodDefault<z.ZodNumber>;
-        max_summary_chars: z.ZodDefault<z.ZodNumber>;
-        max_stored_bytes: z.ZodDefault<z.ZodNumber>;
-        retention_days: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    review_passes: z.ZodOptional<z.ZodObject<{
-        always_security_review: z.ZodDefault<z.ZodBoolean>;
-        security_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    integration_analysis: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    docs: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        doc_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    gitingest: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        endpoint: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
-    ui_review: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        trigger_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        trigger_keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    compaction_advisory: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        thresholds: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
-        message: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
-    lint: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        mode: z.ZodDefault<z.ZodEnum<{
-            check: "check";
-            fix: "fix";
-        }>>;
-        linter: z.ZodDefault<z.ZodEnum<{
-            biome: "biome";
-            eslint: "eslint";
-            auto: "auto";
-        }>>;
-        patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    secretscan: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        extensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    checkpoint: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        auto_checkpoint_threshold: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    automation: z.ZodOptional<z.ZodType<{
-        mode: "auto" | "manual" | "hybrid";
-        capabilities: {
-            plan_sync: boolean;
-            phase_preflight: boolean;
-            config_doctor_on_startup: boolean;
-            config_doctor_autofix: boolean;
-            evidence_auto_summaries: boolean;
-            decision_drift_detection: boolean;
-        };
-    }, unknown, z.core.$ZodTypeInternals<{
-        mode: "auto" | "manual" | "hybrid";
-        capabilities: {
-            plan_sync: boolean;
-            phase_preflight: boolean;
-            config_doctor_on_startup: boolean;
-            config_doctor_autofix: boolean;
-            evidence_auto_summaries: boolean;
-            decision_drift_detection: boolean;
-        };
-    }, unknown>>>;
-};
-export declare const PLUGIN_CONFIG_ALLOWED_KEYS: Set<string>;
-export declare const PluginConfigSchema: z.ZodObject<{
-    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        model: z.ZodOptional<z.ZodString>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        disabled: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>>;
-    swarms: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        name: z.ZodOptional<z.ZodString>;
-        agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            model: z.ZodOptional<z.ZodString>;
-            temperature: z.ZodOptional<z.ZodNumber>;
-            disabled: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>>;
-    max_iterations: z.ZodDefault<z.ZodNumber>;
-    qa_retry_limit: z.ZodDefault<z.ZodNumber>;
-    inject_phase_reminders: z.ZodDefault<z.ZodBoolean>;
-    hooks: z.ZodOptional<z.ZodObject<{
-        system_enhancer: z.ZodDefault<z.ZodBoolean>;
-        compaction: z.ZodDefault<z.ZodBoolean>;
-        agent_activity: z.ZodDefault<z.ZodBoolean>;
-        delegation_tracker: z.ZodDefault<z.ZodBoolean>;
-        agent_awareness_max_chars: z.ZodDefault<z.ZodNumber>;
-        delegation_gate: z.ZodDefault<z.ZodBoolean>;
-        delegation_max_chars: z.ZodDefault<z.ZodNumber>;
+        placeholder_scan: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            deny_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            allow_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            max_allowed_findings: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        sast_scan: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        sbom_generate: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        build_check: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        quality_budget: z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            max_complexity_delta: z.ZodDefault<z.ZodNumber>;
+            max_public_api_delta: z.ZodDefault<z.ZodNumber>;
+            max_duplication_ratio: z.ZodDefault<z.ZodNumber>;
+            min_test_to_code_ratio: z.ZodDefault<z.ZodNumber>;
+            enforce_on_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            exclude_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
     }, z.core.$strip>>;
     context_budget: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -545,10 +458,6 @@ export declare const PluginConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         doc_patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
-    gitingest: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        endpoint: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
     ui_review: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         trigger_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;

package/dist/{src/evidence → evidence}/manager.d.ts

@@ -1,4 +1,22 @@
-import { type Evidence, type EvidenceBundle } from '../config/evidence-schema';
+import { type BuildEvidence, type Evidence, type EvidenceBundle, type PlaceholderEvidence, type QualityBudgetEvidence, type SastEvidence, type SbomEvidence, type SyntaxEvidence } from '../config/evidence-schema';
+/**
+ * All valid evidence types (12 total)
+ */
+export declare const VALID_EVIDENCE_TYPES: readonly ["review", "test", "diff", "approval", "note", "retrospective", "syntax", "placeholder", "sast", "sbom", "build", "quality_budget"];
+/**
+ * Check if a string is a valid evidence type.
+ * Returns true if the type is recognized, false otherwise.
+ */
+export declare function isValidEvidenceType(type: string): type is (typeof VALID_EVIDENCE_TYPES)[number];
+/**
+ * Type guards for new evidence types
+ */
+export declare function isSyntaxEvidence(evidence: Evidence): evidence is SyntaxEvidence;
+export declare function isPlaceholderEvidence(evidence: Evidence): evidence is PlaceholderEvidence;
+export declare function isSastEvidence(evidence: Evidence): evidence is SastEvidence;
+export declare function isSbomEvidence(evidence: Evidence): evidence is SbomEvidence;
+export declare function isBuildEvidence(evidence: Evidence): evidence is BuildEvidence;
+export declare function isQualityBudgetEvidence(evidence: Evidence): evidence is QualityBudgetEvidence;
 /**
  * Validate and sanitize task ID.
  * Must match regex ^[\w-]+(\.[\w-]+)*$

package/dist/{src/index.d.ts → index.d.ts}

@@ -1,4 +1,14 @@
 import type { Plugin } from '@opencode-ai/plugin';
+/**
+ * OpenCode Swarm Plugin
+ *
+ * Architect-centric agentic swarm for code generation.
+ * Hub-and-spoke architecture with:
+ * - Architect as central orchestrator
+ * - Dynamic SME consultation (serial)
+ * - Code generation with QA review
+ * - Iterative refinement with triage
+ */
 declare const OpenCodeSwarm: Plugin;
 export default OpenCodeSwarm;
 export type { AgentDefinition } from './agents';