opencode-swarm 7.41.1 → 7.43.0

package/dist/config/constants.d.ts

@@ -2,8 +2,8 @@ import type { ToolName } from '../tools/tool-names';
 export declare const QA_AGENTS: readonly ["reviewer", "critic", "critic_oversight"];
 export declare const PIPELINE_AGENTS: readonly ["explorer", "coder", "test_engineer"];
 export declare const ORCHESTRATOR_NAME: "architect";
-export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
-export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "critic_architecture_supervisor", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "critic_architecture_supervisor", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "skill_improver", "spec_writer", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
 export declare const OPENCODE_NATIVE_AGENTS: Set<"compaction" | "title" | "build" | "general" | "plan" | "explore" | "summary">;
 export declare const CLAUDE_CODE_NATIVE_COMMANDS: ReadonlySet<string>;
 export type QAAgentName = (typeof QA_AGENTS)[number];

package/dist/config/schema.d.ts

@@ -557,6 +557,30 @@ export declare const CuratorConfigSchema: z.ZodObject<{
     min_skill_confirmations: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type CuratorConfig = z.infer<typeof CuratorConfigSchema>;
+/**
+ * Architectural supervision (issue #893): hierarchical summary review. Agents emit
+ * short structured summaries (summarize_work) that roll up per phase; an expensive
+ * read-only critic (critic_architecture_supervisor) reviews the compressed summaries to
+ * catch cross-task contradictions, drift, and repeated failure loops. The agent itself
+ * is configured via the normal critic override flow; this block configures the feature
+ * and the cheap aggregation pass (not an agent model).
+ */
+export declare const ArchitecturalSupervisionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        gate: "gate";
+        advisory: "advisory";
+    }>>;
+    run_on: z.ZodDefault<z.ZodEnum<{
+        phase_complete: "phase_complete";
+    }>>;
+    summary_model: z.ZodOptional<z.ZodString>;
+    max_agent_summary_words: z.ZodDefault<z.ZodNumber>;
+    max_phase_summary_words: z.ZodDefault<z.ZodNumber>;
+    allow_concerns_to_complete: z.ZodDefault<z.ZodBoolean>;
+    persist_knowledge_recommendations: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ArchitecturalSupervisionConfig = z.infer<typeof ArchitecturalSupervisionConfigSchema>;
 export declare const KnowledgeApplicationConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     mode: z.ZodDefault<z.ZodEnum<{
@@ -566,6 +590,7 @@ export declare const KnowledgeApplicationConfigSchema: z.ZodObject<{
     min_confidence: z.ZodDefault<z.ZodNumber>;
     critical_requires_ack: z.ZodDefault<z.ZodBoolean>;
     require_skill_refs: z.ZodDefault<z.ZodBoolean>;
+    high_risk_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type KnowledgeApplicationConfig = z.infer<typeof KnowledgeApplicationConfigSchema>;
 export declare const SkillImproverConfigSchema: z.ZodObject<{
@@ -1224,6 +1249,21 @@ export declare const PluginConfigSchema: z.ZodObject<{
         min_skill_confidence: z.ZodDefault<z.ZodNumber>;
         min_skill_confirmations: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    architectural_supervision: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            gate: "gate";
+            advisory: "advisory";
+        }>>;
+        run_on: z.ZodDefault<z.ZodEnum<{
+            phase_complete: "phase_complete";
+        }>>;
+        summary_model: z.ZodOptional<z.ZodString>;
+        max_agent_summary_words: z.ZodDefault<z.ZodNumber>;
+        max_phase_summary_words: z.ZodDefault<z.ZodNumber>;
+        allow_concerns_to_complete: z.ZodDefault<z.ZodBoolean>;
+        persist_knowledge_recommendations: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     knowledge_application: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         mode: z.ZodDefault<z.ZodEnum<{
@@ -1233,6 +1273,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         min_confidence: z.ZodDefault<z.ZodNumber>;
         critical_requires_ack: z.ZodDefault<z.ZodBoolean>;
         require_skill_refs: z.ZodDefault<z.ZodBoolean>;
+        high_risk_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     skill_improver: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;

package/dist/hooks/curator-types.d.ts

@@ -94,6 +94,8 @@ export interface CuratorPhaseResult {
     compliance: ComplianceObservation[];
     knowledge_recommendations: KnowledgeRecommendation[];
     summary_updated: boolean;
+    /** True when this phase was already digested in a prior call. */
+    already_digested?: boolean;
     /** v2: per-knowledge-entry application audit (applied/ignored/violated/n/a). */
     knowledge_application_findings?: KnowledgeApplicationFinding[];
     /** v2: candidate clusters the curator suggests compiling into SKILL.md. */

package/dist/hooks/curator.d.ts

@@ -24,8 +24,11 @@
  * This dual dispatch means agent lists are incomplete — they capture factory-dispatched
  * curators but omit hook-dispatched ones. This is by design for hook-internal operations.
  */
+import { listSkills, parseDraftFrontmatter, retireSkill } from '../services/skill-generator.js';
 import type { ComplianceObservation, CuratorConfig, CuratorInitResult, CuratorPhaseResult, CuratorSummary, KnowledgeRecommendation } from './curator-types.js';
+import { readKnowledge } from './knowledge-store.js';
 import type { KnowledgeConfig } from './knowledge-types.js';
+import { readSkillUsageEntries } from './skill-usage-log.js';
 /**
  * Optional LLM delegate callback type.
  * Takes a system prompt and user input, returns the LLM output text.
@@ -39,7 +42,22 @@ export declare const _internals: {
     filterPhaseEvents: typeof filterPhaseEvents;
     checkPhaseCompliance: typeof checkPhaseCompliance;
     normalizeAgentName: typeof normalizeAgentName;
+    autoRetireSkills: typeof autoRetireSkills;
+    readSkillUsageEntries: typeof readSkillUsageEntries;
+    listSkills: typeof listSkills;
+    parseDraftFrontmatter: typeof parseDraftFrontmatter;
+    retireSkill: typeof retireSkill;
+    readFileAsync: (filePath: string, encoding: string) => Promise<string>;
+    readKnowledge: typeof readKnowledge;
 };
+/**
+ * Auto-retire generated skills whose violation rate exceeds 30% or
+ * whose source knowledge entries are all archived.
+ *
+ * Non-blocking: errors are caught and logged but never propagated.
+ * Returns an array of observation strings to include in the phase digest.
+ */
+declare function autoRetireSkills(directory: string, curatorKnowledgePath: string): Promise<string[]>;
 /**
  * Parse OBSERVATIONS section from curator LLM output.
  * Expected format per line: "- entry <uuid> (<observable>): [text]"

package/dist/hooks/knowledge-application.d.ts

@@ -65,6 +65,7 @@ export interface KnowledgeApplicationConfig {
     min_confidence: number;
     critical_requires_ack: boolean;
     require_skill_refs: boolean;
+    high_risk_tools?: string[];
 }
 export declare const DEFAULT_KNOWLEDGE_APPLICATION_CONFIG: KnowledgeApplicationConfig;
 export interface GateResult {

package/dist/hooks/knowledge-curator.d.ts

@@ -11,7 +11,9 @@ export declare function isWriteToEvidenceFile(input: unknown): boolean;
  */
 export declare function curateAndStoreSwarm(lessons: string[], projectName: string, phaseInfo: {
     phase_number: number;
-}, directory: string, config: KnowledgeConfig): Promise<{
+}, directory: string, config: KnowledgeConfig, options?: {
+    skipAutoPromotion?: boolean;
+}): Promise<{
     stored: number;
     skipped: number;
     rejected: number;

package/dist/hooks/knowledge-store.d.ts

@@ -41,6 +41,26 @@ export declare function findNearDuplicate<T extends {
 }>(candidate: string, entries: T[], threshold?: number): T | undefined;
 export declare function computeConfidence(confirmedByCount: number, autoGenerated: boolean): number;
 export declare function inferTags(lesson: string): string[];
+/**
+ * Batch-update confidence scores on knowledge entries identified by their UUIDs.
+ *
+ * For each delta, the function:
+ * 1. Searches the swarm knowledge file for an entry with the given `id`.
+ * 2. Falls back to the hive knowledge file if not found in swarm.
+ * 3. Clamps the resulting confidence to [0.1, 1.0].
+ * 4. Updates `confidence` and `updated_at`, then rewrites the file.
+ *
+ * The full read-modify-write cycle is atomic under a directory lock
+ * (same pattern as `enforceKnowledgeCap`). Errors are logged but never
+ * thrown — the function is fail-open.
+ *
+ * @param directory - Project root directory (used to resolve `.swarm/knowledge.jsonl`).
+ * @param deltas    - Array of {id, delta} tuples. Delta may be positive (boost) or negative (decay).
+ */
+export declare function bumpKnowledgeConfidenceBatch(directory: string, deltas: Array<{
+    id: string;
+    delta: number;
+}>): Promise<void>;
 export declare const _internals: {
     getPlatformConfigDir: typeof getPlatformConfigDir;
     resolveSwarmKnowledgePath: typeof resolveSwarmKnowledgePath;
@@ -61,4 +81,5 @@ export declare const _internals: {
     findNearDuplicate: typeof findNearDuplicate;
     computeConfidence: typeof computeConfidence;
     inferTags: typeof inferTags;
+    bumpKnowledgeConfidenceBatch: typeof bumpKnowledgeConfidenceBatch;
 };

package/dist/hooks/skill-usage-log.d.ts

@@ -66,6 +66,9 @@ export declare const _internals: {
     openSync: typeof fs.openSync;
     readSync: typeof fs.readSync;
     closeSync: typeof fs.closeSync;
+    resolveSourceKnowledgeIds: typeof resolveSourceKnowledgeIds;
+    applySkillUsageFeedback: typeof applySkillUsageFeedback;
+    parseGeneratedFromKnowledge: typeof parseGeneratedFromKnowledge;
 };
 /**
  * Validate and append a single skill-usage entry to the JSONL log.
@@ -107,3 +110,48 @@ export declare function readSkillUsageEntriesTail(directory: string, filters: {
  * @returns Stats about how many entries were pruned and how many remain.
  */
 export declare function pruneSkillUsageLog(directory: string, maxEntriesPerSkill?: number): PruneResult;
+/**
+ * Read a SKILL.md file and extract the `generated_from_knowledge` UUIDs
+ * from its YAML frontmatter.
+ *
+ * Expected frontmatter shape:
+ * ```yaml
+ * ---
+ * name: some-skill
+ * generated_from_knowledge:
+ *   - uuid-1
+ *   - uuid-2
+ * ---
+ * ```
+ *
+ * Returns an empty array if the file doesn't exist, has no frontmatter,
+ * or the `generated_from_knowledge` key is absent.
+ */
+export declare function resolveSourceKnowledgeIds(directory: string, skillPath: string): Promise<string[]>;
+/**
+ * Pure helper: parse `generated_from_knowledge:` YAML list from frontmatter.
+ * Uses a minimal regex-based parser — the SKILL.md format is well-known and narrow.
+ * Does NOT use a full YAML parser to avoid adding a dependency.
+ */
+declare function parseGeneratedFromKnowledge(content: string): string[];
+/**
+ * Read skill-usage entries, resolve source knowledge IDs for each skill,
+ * and apply confidence bumps/decays to the originating knowledge entries.
+ *
+ * For each unique skillPath with at least one compliance or violation entry:
+ * 1. Resolve source knowledge UUIDs from the skill's SKILL.md frontmatter.
+ * 2. Count compliant and violation events for that skill.
+ * 3. Compute net delta: if compliant count > violation count → +0.05; else → -0.1.
+ * 4. Call `bumpKnowledgeConfidenceBatch` with the aggregated deltas.
+ *
+ * @param directory       - Project root directory.
+ * @param options.sinceTimestamp - Optional ISO 8601 cutoff; only process entries after this time.
+ * @returns Count of processed skills and total confidence bumps/decays applied.
+ */
+export declare function applySkillUsageFeedback(directory: string, options?: {
+    sinceTimestamp?: string;
+}): Promise<{
+    processed: number;
+    bumps: number;
+}>;
+export {};