opencode-swarm 7.114.3 → 7.114.5

package/dist/background/candidate-parser.d.ts

@@ -27,6 +27,11 @@ declare const ParseFlagsSchema: z.ZodObject<{
     degraded: z.ZodBoolean;
     row_format_version: z.ZodNumber;
     producer: z.ZodOptional<z.ZodString>;
+    expected_family: z.ZodOptional<z.ZodEnum<{
+        micro_lane: "micro_lane";
+        base_explorer: "base_explorer";
+    }>>;
+    expected_micro_lane: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type ArtifactInput = z.infer<typeof ArtifactInputSchema>;
 export type ParseFlags = z.infer<typeof ParseFlagsSchema>;
@@ -66,6 +71,28 @@ export interface CandidateRecord {
     invariant_violated: string | null;
     confidence: string | null;
 }
+/** A machine-readable attestation that a complete micro-lane found no candidates. */
+export interface CleanAttestationRecord {
+    record_type: 'clean_attestation';
+    row_format_family: 'micro_lane';
+    row_format_version: number;
+    record_version: {
+        major: number;
+        minor: number;
+    };
+    source_output_ref: string;
+    source_batch_id: string;
+    source_lane_id: string;
+    source_agent: string;
+    source_digest: string;
+    extracted_from_partial_source: false;
+    sessionId?: string;
+    parentSessionId?: string;
+    producer?: string;
+    micro_lane: string;
+    coverage_scope: string;
+    evidence: string;
+}
 /**
  * One invocation-envelope record per parseCandidates call.
  * Part of the return value but not persisted to a sidecar in this phase.
@@ -90,6 +117,7 @@ export interface InvocationEnvelope {
     candidate_count: number;
     parse_errors: number;
     malformed_rows: number;
+    clean_attestation_count: number;
 }
 /**
  * Detail record for a required-field violation inside a data row.
@@ -119,6 +147,7 @@ export interface DiagnosticsSummary {
     degraded_source_count: number;
     incomplete_source_count: number;
     format_families_detected: string[];
+    clean_attestation_count: number;
     format_mismatch_hint?: string;
 }
 /**
@@ -128,6 +157,7 @@ export interface ParseResult {
     error?: string;
     error_code?: string;
     candidates: CandidateRecord[];
+    clean_attestation?: CleanAttestationRecord;
     invocation_envelope: InvocationEnvelope;
     diagnostics: DiagnosticsSummary;
 }

package/dist/background/candidate-sidecar-store.d.ts

@@ -30,8 +30,8 @@ export interface SidecarStoreOptions {
  */
 export declare function sanitizeString(value: string): string;
 /**
- * Append an invocation envelope followed by zero or more candidate records
- * to the sidecar JSONL file for the given batch.
+ * Append an invocation envelope, an optional CLEAN attestation, and zero or
+ * more candidate records to the sidecar JSONL file for the given batch.
  *
  * The envelope is always the first record in the append batch (SC-015).
  * Cross-skill coexistence is enabled via the `producer` field on the
@@ -51,6 +51,7 @@ export declare function sanitizeString(value: string): string;
  * @param batchId  The batch identifier (used to derive batchDigest when not provided).
  * @param envelope The invocation envelope record (validated before write).
  * @param candidates Candidate records to append after the envelope (validated before write).
+ * @param cleanAttestation Optional CLEAN attestation written after the envelope.
  * @throws If schema validation fails, lock acquisition fails, or the filesystem write fails.
  */
-export declare function appendToSidecar(options: SidecarStoreOptions, batchId: string, envelope: unknown, candidates: unknown[]): void;
+export declare function appendToSidecar(options: SidecarStoreOptions, batchId: string, envelope: unknown, candidates: unknown[], cleanAttestation?: unknown): void;

package/dist/cli/{config-doctor-xbdfrbwt.js → config-doctor-jy3mdh9t.js}

@@ -12,8 +12,8 @@ import {
   shouldRunOnStartup,
   writeBackupArtifact,
   writeDoctorArtifact
-} from "./index-2148358e.js";
-import"./index-147ja18h.js";
+} from "./index-9bsmzfk3.js";
+import"./index-a45jq4b7.js";
 import"./index-bfwt3abw.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{curator-68rn0ss8.js → curator-2cnthj9n.js}

@@ -14,11 +14,11 @@ import {
   runCuratorInit,
   runCuratorPhase,
   writeCuratorSummary
-} from "./index-e8zaze89.js";
-import"./index-g6va6n3t.js";
+} from "./index-fc35yaah.js";
+import"./index-yfedche9.js";
 import"./index-c8s9a3zh.js";
-import"./index-2148358e.js";
-import"./index-147ja18h.js";
+import"./index-9bsmzfk3.js";
+import"./index-a45jq4b7.js";
 import"./index-f6y341yk.js";
 import"./index-scww5b77.js";
 import"./index-ga4ta3cr.js";
@@ -30,7 +30,7 @@ import"./index-qzqx2qky.js";
 import"./index-0q7rrh59.js";
 import"./index-bfwt3abw.js";
 import"./index-g40r5d08.js";
-import"./index-jt58s751.js";
+import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";

package/dist/cli/{curator-llm-factory-fpzm8j0g.js → curator-llm-factory-asqhpq08.js}

@@ -1,11 +1,11 @@
 // @bun
 import {
   createCuratorLLMDelegate
-} from "./index-e8zaze89.js";
-import"./index-g6va6n3t.js";
+} from "./index-fc35yaah.js";
+import"./index-yfedche9.js";
 import"./index-c8s9a3zh.js";
-import"./index-2148358e.js";
-import"./index-147ja18h.js";
+import"./index-9bsmzfk3.js";
+import"./index-a45jq4b7.js";
 import"./index-f6y341yk.js";
 import"./index-scww5b77.js";
 import"./index-ga4ta3cr.js";
@@ -17,7 +17,7 @@ import"./index-qzqx2qky.js";
 import"./index-0q7rrh59.js";
 import"./index-bfwt3abw.js";
 import"./index-g40r5d08.js";
-import"./index-jt58s751.js";
+import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";

package/dist/cli/{explorer-t5srbq64.js → explorer-jp0nen03.js}

@@ -6,7 +6,7 @@ import {
   CURATOR_POSTMORTEM_PROMPT,
   EXPLORER_PROMPT,
   createExplorerAgent
-} from "./index-jt58s751.js";
+} from "./index-vxv732ex.js";
 import"./index-a76rekgs.js";
 export {
   createExplorerAgent,

package/dist/cli/{guardrail-explain-k3bb68q5.js → guardrail-explain-xt6skemq.js}

@@ -1,12 +1,12 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-hnv7rrf9.js";
-import"./index-e8zaze89.js";
-import"./index-g6va6n3t.js";
+} from "./index-s8se9nt5.js";
+import"./index-fc35yaah.js";
+import"./index-yfedche9.js";
 import"./index-c8s9a3zh.js";
-import"./index-2148358e.js";
-import"./index-147ja18h.js";
+import"./index-9bsmzfk3.js";
+import"./index-a45jq4b7.js";
 import"./index-f6y341yk.js";
 import"./index-scww5b77.js";
 import"./index-ga4ta3cr.js";
@@ -18,7 +18,7 @@ import"./index-qzqx2qky.js";
 import"./index-0q7rrh59.js";
 import"./index-bfwt3abw.js";
 import"./index-g40r5d08.js";
-import"./index-jt58s751.js";
+import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";

package/dist/cli/{guardrail-log-qfc2j0tb.js → guardrail-log-84wnx273.js}

@@ -1,9 +1,9 @@
 // @bun
 import {
   handleGuardrailLog
-} from "./index-xbe1wtme.js";
-import"./index-g6va6n3t.js";
-import"./index-147ja18h.js";
+} from "./index-7jmrbp68.js";
+import"./index-yfedche9.js";
+import"./index-a45jq4b7.js";
 import"./index-bfwt3abw.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";

package/dist/cli/{hive-promoter-h3jcrdh0.js → hive-promoter-n9qt3sth.js}

@@ -6,11 +6,11 @@ import {
   isHiveEligible,
   promoteFromSwarm,
   promoteToHive
-} from "./index-e8zaze89.js";
-import"./index-g6va6n3t.js";
+} from "./index-fc35yaah.js";
+import"./index-yfedche9.js";
 import"./index-c8s9a3zh.js";
-import"./index-2148358e.js";
-import"./index-147ja18h.js";
+import"./index-9bsmzfk3.js";
+import"./index-a45jq4b7.js";
 import"./index-f6y341yk.js";
 import"./index-scww5b77.js";
 import"./index-ga4ta3cr.js";
@@ -22,7 +22,7 @@ import"./index-qzqx2qky.js";
 import"./index-0q7rrh59.js";
 import"./index-bfwt3abw.js";
 import"./index-g40r5d08.js";
-import"./index-jt58s751.js";
+import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";

package/dist/cli/{index-xbe1wtme.js → index-7jmrbp68.js}

@@ -2,7 +2,7 @@
 import {
   redactPath,
   redactShellCommand
-} from "./index-g6va6n3t.js";
+} from "./index-yfedche9.js";
 
 // src/services/guardrail-log-service.ts
 import * as fs from "fs/promises";

package/dist/cli/{index-2148358e.js → index-9bsmzfk3.js}

@@ -5,7 +5,7 @@ import {
   GateConfigSchema,
   PluginConfigSchema,
   stripKnownSwarmPrefix
-} from "./index-147ja18h.js";
+} from "./index-a45jq4b7.js";
 import {
   log
 } from "./index-zgwm4ryv.js";

package/dist/cli/{index-147ja18h.js → index-a45jq4b7.js}

@@ -191,6 +191,10 @@ var TOOL_METADATA = {
     description: "Parse [CANDIDATE] rows from a dispatch_lanes or collect_lane_results artifact (by output_ref), produce structured records with provenance, optionally persist to a per-batch sidecar JSONL. Pure-parser variant exists as internal module.",
     agents: ["architect"]
   },
+  write_pr_review_trigger_eval: {
+    description: "persist the complete PR-review trigger evaluation with exact-set validation and dispatch provenance",
+    agents: ["architect"]
+  },
   test_runner: {
     description: "auto-detect and run tests",
     agents: ["architect", "reviewer", "test_engineer"]

package/dist/cli/{index-e8zaze89.js → index-fc35yaah.js}

@@ -7,7 +7,7 @@ import {
   readDoctorArtifact,
   removeStraySwarmDir,
   runConfigDoctor
-} from "./index-2148358e.js";
+} from "./index-9bsmzfk3.js";
 import {
   AGENT_TOOL_MAP,
   ALL_SUBAGENT_NAMES,
@@ -23,7 +23,7 @@ import {
   getCanonicalAgentRole,
   resolveExternalSkillsConfig,
   stripKnownSwarmPrefix
-} from "./index-147ja18h.js";
+} from "./index-a45jq4b7.js";
 import {
   MAX_TRANSIENT_RETRIES,
   PlanSchema,
@@ -175,7 +175,7 @@ import {
   CURATOR_INIT_PROMPT,
   CURATOR_PHASE_PROMPT,
   READ_ONLY_LANE_GUIDANCE
-} from "./index-jt58s751.js";
+} from "./index-vxv732ex.js";
 import {
   SandboxCapabilityProbe,
   init_capability_probe
@@ -10298,7 +10298,7 @@ async function runCuratorPostMortem(directory, options = {}) {
     let actionResult;
     if (options.llmDelegate) {
       try {
-        const { CURATOR_POSTMORTEM_PROMPT } = await import("./explorer-t5srbq64.js");
+        const { CURATOR_POSTMORTEM_PROMPT } = await import("./explorer-jp0nen03.js");
         const userInput = assembleLLMInput(effectivePlanId, scope, options.sessionID, planSummary, knowledgeSummary, curatorDigest, proposals, unactionable, retrospectives, driftReports);
         const ac = new AbortController;
         const timer = setTimeout(() => ac.abort(), options.llmTimeoutMs ?? 300000);
@@ -10428,15 +10428,15 @@ var _internals12 = {
   verifyPostMortemKnowledgeActions,
   repairPostMortemActions,
   loadDefaultKnowledgeConfig: async () => {
-    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-e5kd993s.js");
+    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-aymfdrsb.js");
     return KnowledgeConfigSchema2.parse({});
   },
   applyCuratorKnowledgeUpdates: async (directory, recommendations, knowledgeConfig) => {
-    const { applyCuratorKnowledgeUpdates: applyCuratorKnowledgeUpdates2 } = await import("./curator-68rn0ss8.js");
+    const { applyCuratorKnowledgeUpdates: applyCuratorKnowledgeUpdates2 } = await import("./curator-2cnthj9n.js");
     return applyCuratorKnowledgeUpdates2(directory, recommendations, knowledgeConfig);
   },
   checkHivePromotions: async (entries, knowledgeConfig) => {
-    const { checkHivePromotions } = await import("./hive-promoter-h3jcrdh0.js");
+    const { checkHivePromotions } = await import("./hive-promoter-n9qt3sth.js");
     return checkHivePromotions(entries, knowledgeConfig);
   },
   applyProposalTriage: async (directory, triage) => {
@@ -15482,7 +15482,7 @@ async function runFinalizeStage(ctx) {
     }
   }
   try {
-    const { CuratorConfigSchema: CCS } = await import("./schema-e5kd993s.js");
+    const { CuratorConfigSchema: CCS } = await import("./schema-aymfdrsb.js");
     const { config: pmLoadedConfig } = _internals20.loadPluginConfigWithMeta(ctx.directory);
     const curatorCfg = CCS.parse(pmLoadedConfig.curator ?? {});
     if (curatorCfg.enabled && curatorCfg.postmortem_enabled) {
@@ -17596,9 +17596,9 @@ var _internals24 = {
   readSwarmFileAsync,
   loadCuratorDeps: async () => {
     const [{ CuratorConfigSchema }, curator, { createCuratorLLMDelegate: createCuratorLLMDelegate2 }] = await Promise.all([
-      import("./schema-e5kd993s.js"),
-      import("./curator-68rn0ss8.js"),
-      import("./curator-llm-factory-fpzm8j0g.js")
+      import("./schema-aymfdrsb.js"),
+      import("./curator-2cnthj9n.js"),
+      import("./curator-llm-factory-asqhpq08.js")
     ]);
     return { CuratorConfigSchema, curator, createCuratorLLMDelegate: createCuratorLLMDelegate2 };
   }
@@ -18094,7 +18094,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.114.3",
+  version: "7.114.5",
   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",
@@ -19563,7 +19563,7 @@ async function handleDoctorCommand(directory, args) {
   const result = runConfigDoctor(config, directory);
   let output;
   if (enableAutoFix && result.hasAutoFixableIssues) {
-    const { runConfigDoctorWithFixes } = await import("./config-doctor-xbdfrbwt.js");
+    const { runConfigDoctorWithFixes } = await import("./config-doctor-jy3mdh9t.js");
     const fixResult = await runConfigDoctorWithFixes(directory, config, true);
     output = formatDoctorMarkdown(fixResult.result);
   } else {
@@ -32984,7 +32984,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-by2gt09c.js");
+    const { buildHelpText } = await import("./index-s0h4kf1t.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -32993,7 +32993,7 @@ async function handleHelpCommand(ctx) {
     return _internals49.buildDetailedHelp(resolved.key, resolved.entry);
   }
   const similar = _internals49.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-by2gt09c.js");
+  const { buildHelpText: fullHelp } = await import("./index-s0h4kf1t.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -33126,7 +33126,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-k3bb68q5.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-xt6skemq.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -33136,7 +33136,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-k3bb68q5.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-xt6skemq.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -33146,7 +33146,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-log": {
     handler: async (ctx) => {
-      const { handleGuardrailLog } = await import("./guardrail-log-qfc2j0tb.js");
+      const { handleGuardrailLog } = await import("./guardrail-log-84wnx273.js");
       return handleGuardrailLog(ctx.directory, ctx.args);
     },
     description: "Read the guardrail decision log (use --blocks-only for blocks)",

package/dist/cli/{index-by2gt09c.js → index-s0h4kf1t.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-hnv7rrf9.js";
+} from "./index-s8se9nt5.js";
 import {
   handleGuardrailLog
-} from "./index-xbe1wtme.js";
+} from "./index-7jmrbp68.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -81,15 +81,15 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-e8zaze89.js";
-import"./index-g6va6n3t.js";
+} from "./index-fc35yaah.js";
+import"./index-yfedche9.js";
 import"./index-c8s9a3zh.js";
-import"./index-2148358e.js";
+import"./index-9bsmzfk3.js";
 import {
   AGENT_TOOL_MAP,
   ORCHESTRATOR_NAME,
   stripKnownSwarmPrefix
-} from "./index-147ja18h.js";
+} from "./index-a45jq4b7.js";
 import"./index-f6y341yk.js";
 import"./index-scww5b77.js";
 import"./index-ga4ta3cr.js";
@@ -101,7 +101,7 @@ import"./index-qzqx2qky.js";
 import"./index-0q7rrh59.js";
 import"./index-bfwt3abw.js";
 import"./index-g40r5d08.js";
-import"./index-jt58s751.js";
+import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";

package/dist/cli/{index-hnv7rrf9.js → index-s8se9nt5.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-e8zaze89.js";
+} from "./index-fc35yaah.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-g6va6n3t.js";
+} from "./index-yfedche9.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-jt58s751.js → index-vxv732ex.js}

@@ -126,7 +126,8 @@ src/tools/declare-scope.ts \u2014 function has 12 parameters, consider splitting
 Activates when your prompt contains "[CANDIDATE]" anywhere in its text.
 
 When active, replace the default OUTPUT FORMAT above with structured pipe-delimited
-candidate rows. Emit exactly one row per finding:
+candidate rows. Emit the marker-bearing header, then exactly one unprefixed data
+row per finding:
 
 [CANDIDATE] | candidate_id | lane | severity | category | file:line | claim | evidence_summary | impact_context | confidence
 
@@ -141,11 +142,14 @@ Field rules:
 - impact_context: who or what is affected downstream
 - confidence: LOW | MEDIUM | HIGH
 
-Emit a header row first, then one [CANDIDATE] row per finding. Use pipe (|) to
+Emit a header row first, then one unprefixed data row per finding. Use pipe (|) to
 separate fields; escape literal pipe characters inside field values as \\|.
 
-If you find zero issues, emit the header row with no data rows. Do NOT fall back
-to the default PROJECT/STRUCTURE format when in candidate reporting mode.
+If a standard explorer finds zero issues, emit the header row with no data rows.
+If a micro-lane finds zero issues, emit the header followed by exactly:
+[CLEAN] | micro_lane | coverage_scope | evidence
+Fill every CLEAN field with the assigned micro-lane, checks completed, and the
+negative evidence. Do NOT fall back to the default PROJECT/STRUCTURE format.
 
 For micro-lane dispatches, use the micro-lane variant:
 [CANDIDATE] | candidate_id | micro_lane | severity | category | file:line | claim | invariant_violated | evidence_summary | confidence

package/dist/cli/{index-g6va6n3t.js → index-yfedche9.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   stripKnownSwarmPrefix
-} from "./index-147ja18h.js";
+} from "./index-a45jq4b7.js";
 import {
   init_logger,
   warn

package/dist/cli/index.js

@@ -7,13 +7,13 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-e8zaze89.js";
-import"./index-g6va6n3t.js";
+} from "./index-fc35yaah.js";
+import"./index-yfedche9.js";
 import"./index-c8s9a3zh.js";
-import"./index-2148358e.js";
+import"./index-9bsmzfk3.js";
 import {
   DEFAULT_AGENT_CONFIGS
-} from "./index-147ja18h.js";
+} from "./index-a45jq4b7.js";
 import"./index-f6y341yk.js";
 import"./index-scww5b77.js";
 import"./index-ga4ta3cr.js";
@@ -25,7 +25,7 @@ import"./index-qzqx2qky.js";
 import"./index-0q7rrh59.js";
 import"./index-bfwt3abw.js";
 import"./index-g40r5d08.js";
-import"./index-jt58s751.js";
+import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";

package/dist/cli/{schema-e5kd993s.js → schema-aymfdrsb.js}

@@ -86,7 +86,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-147ja18h.js";
+} from "./index-a45jq4b7.js";
 import"./index-bfwt3abw.js";
 import"./index-p0arc26j.js";
 import"./index-293f68mj.js";

package/dist/hooks/skill-injection.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Skill auto-injection for subagent delegations.
+ *
+ * Extracted from the `tool.execute.before` hook in `src/index.ts` (issue #1770)
+ * so the injection + usage-recording path is exercised by tests against the
+ * REAL implementation rather than a parallel re-implementation.
+ *
+ * Two correctness fixes over the pre-extraction inline block:
+ *
+ *  1. Attribution — usage entries are now recorded with the **target subagent**
+ *     as `agentName` and a real taskID (via `extractTaskIdFromPrompt`,
+ *     falling back to the literal `'auto-injected'` when the prompt carries no
+ *     task marker). Previously the inline block recorded the **architect**
+ *     with the synthetic `taskID: 'injection'`, which (a) was inconsistent with
+ *     the three other recording sites in `skill-propagation-gate.ts`, (b) broke
+ *     the SKILL_COMPLIANCE round-trip join except by coincidence, and (c)
+ *     inflated frequency / taskID-diversity scoring. The fallback is
+ *     `'auto-injected'` rather than `'unknown'` so the compliance resolver's
+ *     `resolvedTaskID !== 'unknown'` guard at `skill-propagation-gate.ts:1302`
+ *     continues to fire and populate fallback skill paths.
+ *
+ *  2. Observability — a `skill_injection_decision` event is emitted to
+ *     `.swarm/events.jsonl` for BOTH the qualified-injection and the
+ *     `SKILLS: none` branches. Previously only the qualified branch produced a
+ *     `console.warn`, and the `SKILLS: none` branch produced no durable signal,
+ *     so a project whose skills all scored below the 0.5 threshold appeared
+ *     indistinguishable from "the gate never ran." Usage entries are NOT written
+ *     for the `SKILLS: none` branch: recording a phantom skillPath would corrupt
+ *     per-skill scoring, and the absence of `skill-usage.jsonl` when no skill is
+ *     injected is the correct semantic (there is no usage to record).
+ */
+import { extractSkillsFieldFromPrompt } from './skill-propagation-gate.js';
+/** A recommended skill as returned by `skillPropagationGateBefore`. */
+export interface RecommendedSkill {
+    skillPath: string;
+    score: number;
+    usageCount: number;
+}
+/** Options controlling console verbosity (mirrors the plugin `quiet` flag). */
+export interface SkillInjectionOptions {
+    /** When true, suppresses console.warn output (does not affect event emission). */
+    quiet?: boolean;
+}
+/** Result of an injection attempt. */
+export interface SkillInjectionResult {
+    /** `true` if a `SKILLS:` (or `SKILLS_USED_BY_CODER:`) line was added to the prompt. */
+    injected: boolean;
+    /** The skills that were actually injected (empty for the `SKILLS: none` and skip paths). */
+    injectedSkills: Array<{
+        skillPath: string;
+        score: number;
+    }>;
+}
+/** Relevance-score threshold a recommended skill must meet to be injected. */
+export declare const SKILL_INJECTION_THRESHOLD = 0.5;
+/** Maximum number of skills injected into a single delegation prompt. */
+export declare const SKILL_INJECTION_TOP_N = 5;
+/**
+ * Auto-inject a `SKILLS:` field into a delegation prompt when one is missing.
+ *
+ * Mutates `args.prompt` in place (preserving the pre-extraction hook contract)
+ * and records one usage entry per injected skill to `.swarm/skill-usage.jsonl`.
+ * Best-effort: recording/event failures are swallowed and never throw.
+ *
+ * @param directory           - Project root (`.swarm/` is created here).
+ * @param args                - The Task tool args; `args.prompt` is mutated.
+ * @param recommendedSkills   - From `skillPropagationGateBefore`. `undefined` / empty skips injection.
+ * @param targetAgent         - The subagent being delegated to (parsed via `parseDelegationArgs`).
+ *                              Used as the usage-entry `agentName` so the entry joins correctly
+ *                              with later reviewer compliance verdicts.
+ * @param sessionID           - The orchestrating session id.
+ * @param options             - `{ quiet }` verbosity flag.
+ * @returns `{ injected, injectedSkills }`.
+ */
+export declare function injectSkillsIntoDelegation(directory: string, args: Record<string, unknown>, recommendedSkills: ReadonlyArray<RecommendedSkill> | undefined, targetAgent: string, sessionID: string, options?: SkillInjectionOptions): SkillInjectionResult;
+/**
+ * Extract the SKILLS field from a prompt. Re-exported for tests that need to
+ * inspect the post-injection prompt without re-parsing manually.
+ */
+export { extractSkillsFieldFromPrompt };