opencode-swarm 7.97.0 → 7.98.1

package/README.md

@@ -561,6 +561,8 @@ The Context Budget Guard monitors how much context Swarm is injecting into the c
 
 To disable entirely, set `context_budget.enabled: false` in your swarm config.
 
+**On-demand status check:** architects can invoke the `context_status` tool at any time to read current context-window headroom (tokens used, model limit, usage percent, threshold state, model ID, provider) without triggering advisory warnings or mutating state. Works even when `context_budget.enabled` is false.
+
 ---
 
 ### Skill Propagation
@@ -614,7 +616,9 @@ Routing skills are merged with scored recommendations, with explicitly routed sk
 
 ### Skill Lifecycle Management
 
-Swarm provides tools for managing generated skill lifecycles:
+Seven skill-management tools (`skill_generate`, `skill_list`, `skill_apply`, `skill_inspect`, `skill_regenerate`, `skill_retire`, `skill_improve`) are **opt-in** via the `skills.enabled` config flag (default `false`). With the flag off, the architect does not see them; with the flag on, they reappear. Tools remain exported and registered — only the merged architect tool map is gated.
+
+ Swarm provides tools for managing generated skill lifecycles:
 
 - **`skill_retire`** — Retires an active generated skill by creating a `retired.marker` file in its directory. Retired skills are excluded from discovery, scoring, and injection. The SKILL.md file is preserved for auditability. Use `skill_retire(slug, reason?)` to retire a skill, or pass a reason for tracking purposes.
 
@@ -699,7 +703,9 @@ Every candidate passes a 3-gate pipeline before entering quarantine:
 | `context_budget.tracked_agents` | string[] | `['architect']` | Agents to track for context budget warnings |
 | `context_budget.enforce_on_agent_switch` | boolean | `true` | Enforce budget limits when switching agents |
 | `context_budget.model_limits` | record | `{ default: 128000 }` | Per-model token limits (model name -> max tokens) |
+| `context_budget.unified_injection_tokens` | number | `undefined` | Opt-in unified ceiling (tokens) for combined system-enhancer + knowledge-injector injection per turn. When set, both hooks share this budget with proportional split |
 | `context_budget.tool_output_mask_threshold` | number | `2000` | Threshold for masking tool outputs (chars) |
+| `skills.enabled` | boolean | `false` | Gates the 7 skill-management tools (`skill_generate`, `skill_list`, `skill_apply`, `skill_inspect`, `skill_regenerate`, `skill_retire`, `skill_improve`) behind an opt-in flag. When `false` (default), these tools are hidden from the architect's tool map. |
 | `context_budget.scoring.enabled` | boolean | `false` | Enable context scoring/ranking |
 | `context_budget.scoring.max_candidates` | number | `100` | Maximum items to score (10-500) |
 | `context_budget.scoring.weights` | object | `{ recency: 0.3, ... }` | Scoring weights for priority |

package/dist/agents/architect.d.ts

@@ -71,4 +71,4 @@ export declare function buildCouncilWorkflow(council?: CouncilWorkflowConfig): s
  * BRAINSTORM, and PLAN inline paths stay in lockstep.
  */
 export declare function buildQaGateSelectionDialogue(modeLabel: 'BRAINSTORM' | 'SPECIFY' | 'PLAN'): string;
-export declare function createArchitectAgent(model: string, customPrompt?: string, customAppendPrompt?: string, adversarialTesting?: AdversarialTestingConfig, council?: CouncilWorkflowConfig, uiReview?: UIReviewConfig, memoryEnabled?: boolean, architecturalSupervision?: ArchitectureSupervisionWorkflowConfig, designDocsEnabled?: boolean, externalSkillsEnabled?: boolean, turboEnabled?: boolean): AgentDefinition;
+export declare function createArchitectAgent(model: string, customPrompt?: string, customAppendPrompt?: string, adversarialTesting?: AdversarialTestingConfig, council?: CouncilWorkflowConfig, uiReview?: UIReviewConfig, memoryEnabled?: boolean, architecturalSupervision?: ArchitectureSupervisionWorkflowConfig, designDocsEnabled?: boolean, externalSkillsEnabled?: boolean, turboEnabled?: boolean, skillsEnabled?: boolean): AgentDefinition;

package/dist/cli/{config-doctor-h1xrvq83.js → config-doctor-7yrxfa6b.js}

@@ -12,8 +12,8 @@ import {
   shouldRunOnStartup,
   writeBackupArtifact,
   writeDoctorArtifact
-} from "./index-xx3sv77e.js";
-import"./index-tqbb2jx6.js";
+} from "./index-zy22fg5h.js";
+import"./index-471qxz9g.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{guardrail-explain-t6svvtmn.js → guardrail-explain-cm08h4mt.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-a9ghr5cx.js";
-import"./index-sgdr2e4n.js";
-import"./index-b223mczb.js";
+} from "./index-0rgde8qc.js";
+import"./index-zgba613y.js";
+import"./index-5z2e78tv.js";
 import"./index-2a6ppa65.js";
 import"./index-fjxjb66n.js";
 import"./index-hb10a2g8.js";
-import"./index-xx3sv77e.js";
-import"./index-tqbb2jx6.js";
+import"./index-zy22fg5h.js";
+import"./index-471qxz9g.js";
 import"./index-4c5jpmn9.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";

package/dist/cli/{guardrail-log-9yyeccv5.js → guardrail-log-53z1cf46.js}

@@ -1,9 +1,9 @@
 // @bun
 import {
   handleGuardrailLog
-} from "./index-rdc6nvmw.js";
-import"./index-b223mczb.js";
-import"./index-tqbb2jx6.js";
+} from "./index-gnd1280x.js";
+import"./index-5z2e78tv.js";
+import"./index-471qxz9g.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{index-a9ghr5cx.js → index-0rgde8qc.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-sgdr2e4n.js";
+} from "./index-zgba613y.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-b223mczb.js";
+} from "./index-5z2e78tv.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-tqbb2jx6.js → index-471qxz9g.js}

@@ -365,6 +365,10 @@ var TOOL_METADATA = {
     description: "detect hidden couplings by analyzing git history",
     agents: ["architect"]
   },
+  context_status: {
+    description: "report current context-window headroom for the active session \u2014 returns tokens-used, model-limit, usage-percent, threshold-state (none/warn/critical), model name, and provider. Pure read-only: no state mutation, no warning injection. Works whether context_budget.enabled is true or false.",
+    agents: ["architect"]
+  },
   search: {
     description: "Workspace-scoped ripgrep-style text search with structured JSON output. Supports literal and regex modes, glob filtering, and result limits. NOTE: This is text search, not structural AST search \u2014 use symbols and imports tools for structural queries.",
     agents: [
@@ -481,19 +485,19 @@ var TOOL_METADATA = {
   },
   skill_generate: {
     description: "compile knowledge entries into a structured SKILL.md draft",
-    agents: ["architect", "skill_improver"]
+    agents: ["skill_improver"]
   },
   skill_list: {
     description: "list generated skill files and their status",
-    agents: ["architect", "skill_improver"]
+    agents: ["skill_improver"]
   },
   skill_apply: {
     description: "activate a draft skill proposal",
-    agents: ["architect"]
+    agents: []
   },
   skill_inspect: {
     description: "inspect the content and source entries of a skill file",
-    agents: ["architect", "skill_improver"]
+    agents: ["skill_improver"]
   },
   run_stale_reconciliation: {
     description: "reconcile skills against the knowledge store: mark skills stale when source knowledge is archived or deleted, or clear stale markers",
@@ -501,15 +505,15 @@ var TOOL_METADATA = {
   },
   skill_regenerate: {
     description: "regenerate an active skill by re-clustering its source knowledge entries and updating the SKILL.md in place",
-    agents: ["architect"]
+    agents: []
   },
   skill_retire: {
     description: "retire a generated skill by adding a retired.marker file; retired skills are excluded from scoring and injection",
-    agents: ["architect"]
+    agents: []
   },
   skill_improve: {
     description: "run the skill_improver agent to review and refine skills",
-    agents: ["architect", "skill_improver"]
+    agents: ["skill_improver"]
   },
   spec_write: {
     description: "author or update .swarm/spec.md for the current project",
@@ -851,6 +855,18 @@ var TURBO_TOOL_NAMES = [
 var TURBO_AGENT_TOOL_MAP = {
   architect: [...TURBO_TOOL_NAMES]
 };
+var SKILL_TOOL_NAMES = [
+  "skill_generate",
+  "skill_list",
+  "skill_apply",
+  "skill_inspect",
+  "skill_regenerate",
+  "skill_retire",
+  "skill_improve"
+];
+var SKILL_AGENT_TOOL_MAP = {
+  architect: [...SKILL_TOOL_NAMES]
+};
 var DEFAULT_AGENT_CONFIGS = {
   coder: {
     model: "opencode/minimax-m2.5-free",
@@ -1049,6 +1065,7 @@ var ContextBudgetConfigSchema = exports_external.object({
   critical_threshold: exports_external.number().min(0).max(1).default(0.9),
   model_limits: exports_external.record(exports_external.string(), exports_external.number().min(1000)).default({ default: 128000 }),
   max_injection_tokens: exports_external.number().min(100).max(50000).default(4000),
+  unified_injection_tokens: exports_external.number().min(100).max(50000).optional(),
   tracked_agents: exports_external.array(exports_external.string()).default(["architect"]),
   scoring: ScoringConfigSchema.optional(),
   enforce: exports_external.boolean().default(true),
@@ -1688,6 +1705,9 @@ var SkillImproverConfigSchema = exports_external.object({
   quota_window: exports_external.enum(["utc", "local"]).default("utc"),
   allow_deterministic_fallback: exports_external.boolean().default(true)
 });
+var SkillsConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(false)
+});
 var SpecWriterConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(true),
   model: exports_external.string().nullable().default(null),
@@ -1948,6 +1968,9 @@ var DEFAULT_EXTERNAL_SKILLS_CONFIG = {
   max_concurrent_fetches: 5,
   fetch_timeout_ms: 30000
 };
+var DEFAULT_SKILLS_CONFIG = {
+  enabled: false
+};
 function resolveExternalSkillsConfig(input) {
   if (input === undefined || input === null || typeof input !== "object" || Array.isArray(input)) {
     return { ...DEFAULT_EXTERNAL_SKILLS_CONFIG };
@@ -2194,7 +2217,8 @@ var PluginConfigSchema = exports_external.object({
     }
   })),
   pr_monitor: PrMonitorConfigSchema.optional(),
-  external_skills: ExternalSkillsConfigSchema.optional()
+  external_skills: ExternalSkillsConfigSchema.optional(),
+  skills: SkillsConfigSchema.optional()
 });
 
-export { ORCHESTRATOR_NAME, ALL_SUBAGENT_NAMES, ALL_AGENT_NAMES, TOOL_NAMES, TOOL_NAME_SET, AGENT_TOOL_MAP, DEFAULT_AGENT_CONFIGS, _internals, isKnownCanonicalRole, getCanonicalAgentRole, resolveGeneratedAgentRole, stripKnownSwarmPrefix, AgentReasoningConfigSchema, AgentThinkingConfigSchema, AgentOverrideConfigSchema, SwarmConfigSchema, HooksConfigSchema, ScoringWeightsSchema, DecisionDecaySchema, TokenRatiosSchema, ScoringConfigSchema, ContextBudgetConfigSchema, EvidenceConfigSchema, GateFeatureSchema, PlaceholderScanConfigSchema, QualityBudgetConfigSchema, GateConfigSchema, PipelineConfigSchema, PhaseCompleteConfigSchema, SummaryConfigSchema, ReviewPassesConfigSchema, AutoReviewConfigSchema, AdversarialDetectionConfigSchema, AdversarialTestingConfigSchema, IntegrationAnalysisConfigSchema, DocsConfigSchema, DesignDocsConfigSchema, UIReviewConfigSchema, CompactionAdvisoryConfigSchema, LintConfigSchema, SecretscanConfigSchema, GuardrailsProfileSchema, DEFAULT_AGENT_PROFILES, DEFAULT_ARCHITECT_PROFILE, GuardrailsConfigSchema, WatchdogConfigSchema, SelfReviewConfigSchema, resolveGuardrailsConfig, ToolFilterConfigSchema, PlanCursorConfigSchema, ContextMapConfigSchema, RepoGraphConfigSchema, CheckpointConfigSchema, AutomationModeSchema, AutomationCapabilitiesSchema, AutomationConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, CuratorConfigSchema, ArchitecturalSupervisionConfigSchema, KnowledgeApplicationConfigSchema, SkillPropagationConfigSchema, SkillImproverConfigSchema, SpecWriterConfigSchema, SlopDetectorConfigSchema, IncrementalVerifyConfigSchema, CompactionConfigSchema, PrmConfigSchema, AgentAuthorityRuleSchema, AuthorityConfigSchema, GeneralCouncilConfigSchema, CouncilConfigSchema, PrMonitorConfigSchema, ParallelizationConfigSchema, WorktreeIsolationConfigSchema, LeanTurboConfigSchema, EpicConfigSchema, StandardTurboConfigSchema, LeanTurboStrategyConfigSchema, TurboConfigSchema, ExternalSkillCandidateSourceTypeSchema, ExternalSkillCandidateEvaluationVerdictSchema, DiscoverySourceSchema, ExternalSkillCandidateSchema, ExternalSkillsConfigSchema, DEFAULT_EXTERNAL_SKILLS_CONFIG, resolveExternalSkillsConfig, PluginConfigSchema };
+export { ORCHESTRATOR_NAME, ALL_SUBAGENT_NAMES, ALL_AGENT_NAMES, TOOL_NAMES, TOOL_NAME_SET, AGENT_TOOL_MAP, DEFAULT_AGENT_CONFIGS, _internals, isKnownCanonicalRole, getCanonicalAgentRole, resolveGeneratedAgentRole, stripKnownSwarmPrefix, AgentReasoningConfigSchema, AgentThinkingConfigSchema, AgentOverrideConfigSchema, SwarmConfigSchema, HooksConfigSchema, ScoringWeightsSchema, DecisionDecaySchema, TokenRatiosSchema, ScoringConfigSchema, ContextBudgetConfigSchema, EvidenceConfigSchema, GateFeatureSchema, PlaceholderScanConfigSchema, QualityBudgetConfigSchema, GateConfigSchema, PipelineConfigSchema, PhaseCompleteConfigSchema, SummaryConfigSchema, ReviewPassesConfigSchema, AutoReviewConfigSchema, AdversarialDetectionConfigSchema, AdversarialTestingConfigSchema, IntegrationAnalysisConfigSchema, DocsConfigSchema, DesignDocsConfigSchema, UIReviewConfigSchema, CompactionAdvisoryConfigSchema, LintConfigSchema, SecretscanConfigSchema, GuardrailsProfileSchema, DEFAULT_AGENT_PROFILES, DEFAULT_ARCHITECT_PROFILE, GuardrailsConfigSchema, WatchdogConfigSchema, SelfReviewConfigSchema, resolveGuardrailsConfig, ToolFilterConfigSchema, PlanCursorConfigSchema, ContextMapConfigSchema, RepoGraphConfigSchema, CheckpointConfigSchema, AutomationModeSchema, AutomationCapabilitiesSchema, AutomationConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, CuratorConfigSchema, ArchitecturalSupervisionConfigSchema, KnowledgeApplicationConfigSchema, SkillPropagationConfigSchema, SkillImproverConfigSchema, SkillsConfigSchema, SpecWriterConfigSchema, SlopDetectorConfigSchema, IncrementalVerifyConfigSchema, CompactionConfigSchema, PrmConfigSchema, AgentAuthorityRuleSchema, AuthorityConfigSchema, GeneralCouncilConfigSchema, CouncilConfigSchema, PrMonitorConfigSchema, ParallelizationConfigSchema, WorktreeIsolationConfigSchema, LeanTurboConfigSchema, EpicConfigSchema, StandardTurboConfigSchema, LeanTurboStrategyConfigSchema, TurboConfigSchema, ExternalSkillCandidateSourceTypeSchema, ExternalSkillCandidateEvaluationVerdictSchema, DiscoverySourceSchema, ExternalSkillCandidateSchema, ExternalSkillsConfigSchema, DEFAULT_EXTERNAL_SKILLS_CONFIG, DEFAULT_SKILLS_CONFIG, resolveExternalSkillsConfig, PluginConfigSchema };

package/dist/cli/{index-b223mczb.js → index-5z2e78tv.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   stripKnownSwarmPrefix
-} from "./index-tqbb2jx6.js";
+} from "./index-471qxz9g.js";
 import {
   init_logger,
   warn

package/dist/cli/{index-byb9tgay.js → index-attgb1ma.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-a9ghr5cx.js";
+} from "./index-0rgde8qc.js";
 import {
   handleGuardrailLog
-} from "./index-rdc6nvmw.js";
+} from "./index-gnd1280x.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -78,17 +78,17 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-sgdr2e4n.js";
-import"./index-b223mczb.js";
+} from "./index-zgba613y.js";
+import"./index-5z2e78tv.js";
 import"./index-2a6ppa65.js";
 import"./index-fjxjb66n.js";
 import"./index-hb10a2g8.js";
-import"./index-xx3sv77e.js";
+import"./index-zy22fg5h.js";
 import {
   AGENT_TOOL_MAP,
   ORCHESTRATOR_NAME,
   stripKnownSwarmPrefix
-} from "./index-tqbb2jx6.js";
+} from "./index-471qxz9g.js";
 import"./index-4c5jpmn9.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";

package/dist/cli/{index-rdc6nvmw.js → index-gnd1280x.js}

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

package/dist/cli/{index-sgdr2e4n.js → index-zgba613y.js}

@@ -57,7 +57,7 @@ import {
   readDoctorArtifact,
   removeStraySwarmDir,
   runConfigDoctor
-} from "./index-xx3sv77e.js";
+} from "./index-zy22fg5h.js";
 import {
   AGENT_TOOL_MAP,
   ALL_SUBAGENT_NAMES,
@@ -70,7 +70,7 @@ import {
   TOOL_NAME_SET,
   resolveExternalSkillsConfig,
   stripKnownSwarmPrefix
-} from "./index-tqbb2jx6.js";
+} from "./index-471qxz9g.js";
 import {
   MAX_TRANSIENT_RETRIES,
   PlanSchema,
@@ -909,7 +909,7 @@ var init_executor = __esm(() => {
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.97.0",
+  version: "7.98.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",
@@ -10193,48 +10193,49 @@ function recordSeenRetroSection(key, value, timestamp) {
 function hashContent(content) {
   return createHash3("sha1").update(content).digest("hex");
 }
-function isWriteToSwarmPlan(input) {
-  if (typeof input !== "object" || input === null)
-    return false;
-  const record = input;
-  const toolName = record.toolName;
-  if (typeof toolName !== "string")
-    return false;
-  if (!["write", "edit", "apply_patch", "swarm_apply_patch"].includes(toolName))
-    return false;
-  const rawPath = record.path;
-  const rawFile = record.file;
-  const pathField = typeof rawPath === "string" ? rawPath.replace(/\\/g, "/") : undefined;
-  const fileField = typeof rawFile === "string" ? rawFile.replace(/\\/g, "/") : undefined;
-  if (typeof pathField === "string" && pathField.includes(".swarm/plan.md")) {
-    return true;
-  }
-  if (typeof fileField === "string" && fileField.includes(".swarm/plan.md")) {
-    return true;
-  }
-  return false;
-}
 function isWriteToEvidenceFile(input) {
-  if (typeof input !== "object" || input === null)
-    return false;
-  const record = input;
-  const toolName = record.toolName;
-  if (typeof toolName !== "string")
-    return false;
-  if (!["write", "edit", "apply_patch", "swarm_apply_patch"].includes(toolName))
+  const trigger = normalizeWriteTrigger(input);
+  return isEvidencePath(trigger?.filePath);
+}
+var WRITE_TOOLS = new Set([
+  "write",
+  "edit",
+  "apply_patch",
+  "swarm_apply_patch"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function normalizePathField(value) {
+  return typeof value === "string" ? value.replace(/\\/g, "/") : null;
+}
+function firstPathFromRecord(record) {
+  return normalizePathField(record.path) ?? normalizePathField(record.filePath) ?? normalizePathField(record.file);
+}
+function normalizeWriteTrigger(input, output) {
+  if (!isRecord(input))
+    return null;
+  const toolName = typeof input.toolName === "string" ? input.toolName : typeof input.tool === "string" ? input.tool : null;
+  if (!toolName || !WRITE_TOOLS.has(toolName))
+    return null;
+  const inputArgs = isRecord(input.args) ? input.args : null;
+  const outputArgs = isRecord(output) && isRecord(output.args) ? output.args : null;
+  const filePath = firstPathFromRecord(input) ?? (inputArgs ? firstPathFromRecord(inputArgs) : null) ?? (outputArgs ? firstPathFromRecord(outputArgs) : null);
+  if (!filePath)
+    return null;
+  return {
+    toolName,
+    filePath,
+    sessionID: typeof input.sessionID === "string" ? input.sessionID : "default"
+  };
+}
+function isEvidencePath(filePath) {
+  if (!filePath)
     return false;
-  const rawPath = record.path;
-  const rawFile = record.file;
-  const pathField = typeof rawPath === "string" ? rawPath.replace(/\\/g, "/") : undefined;
-  const fileField = typeof rawFile === "string" ? rawFile.replace(/\\/g, "/") : undefined;
-  const evidenceRegex = /\.swarm\/+evidence\/+/i;
-  if (typeof pathField === "string" && evidenceRegex.test(pathField)) {
-    return true;
-  }
-  if (typeof fileField === "string" && evidenceRegex.test(fileField)) {
-    return true;
-  }
-  return false;
+  return /(?:^|\/)\.swarm\/+evidence\//i.test(filePath);
+}
+function isPlanPath(filePath) {
+  return filePath?.includes(".swarm/plan.md") ?? false;
 }
 function extractRetrospectiveSection(planContent) {
   const headingRegex = /^###\s+Lessons\s+Learned$/m;
@@ -10941,24 +10942,22 @@ async function runAutoPromotion(directory, config) {
   }
 }
 function createKnowledgeCuratorHook(directory, config, options = {}) {
-  const handler = async (input, _output) => {
+  const handler = async (input, output) => {
     pruneSeenRetroSections();
     if (!config.enabled)
       return;
-    if (!isWriteToSwarmPlan(input) && !isWriteToEvidenceFile(input))
+    const trigger = normalizeWriteTrigger(input, output);
+    if (!trigger)
+      return;
+    const isPlanTrigger = isPlanPath(trigger.filePath);
+    const isEvidenceTrigger = isEvidencePath(trigger.filePath) && !isPlanTrigger;
+    if (!isPlanTrigger && !isEvidenceTrigger)
       return;
-    const sessionID = input?.sessionID ?? "default";
-    const isEvidenceTrigger = isWriteToEvidenceFile(input) && !isWriteToSwarmPlan(input);
     if (isEvidenceTrigger) {
-      const record = input;
-      const rawPath = record.path;
-      const rawFile = record.file;
-      const filePath = typeof rawPath === "string" ? rawPath.replace(/\\/g, "/") : typeof rawFile === "string" ? rawFile.replace(/\\/g, "/") : null;
-      if (!filePath)
-        return;
-      const evidenceKey = `evidence:${sessionID}:${filePath}`;
+      const relativeEvidencePath = trigger.filePath.replace(/^.*\.swarm\//, "");
+      const evidenceKey = `evidence:${trigger.sessionID}:${relativeEvidencePath}`;
       const lastSeenEvidence = seenRetroSections.get(evidenceKey);
-      const evidenceContent = await readSwarmFileAsync(directory, filePath.replace(/^.*\.swarm\//, ""));
+      const evidenceContent = await readSwarmFileAsync(directory, relativeEvidencePath);
       if (!evidenceContent)
         return;
       let evidenceData;
@@ -10986,7 +10985,7 @@ function createKnowledgeCuratorHook(directory, config, options = {}) {
       const projectName2 = evidenceData.project_name ?? "unknown";
       const phaseNumber2 = typeof evidenceData.phase_number === "number" ? evidenceData.phase_number : 1;
       await _internals17.curateAndStoreSwarm(lessons, projectName2, { phase_number: phaseNumber2 }, directory, config, {
-        llmDelegate: options.llmDelegateFactory?.(sessionID),
+        llmDelegate: options.llmDelegateFactory?.(trigger.sessionID),
         enrichmentQuota: options.enrichmentQuota
       });
       return;
@@ -10997,7 +10996,7 @@ function createKnowledgeCuratorHook(directory, config, options = {}) {
     const section = extractRetrospectiveSection(planContent);
     if (!section)
       return;
-    if (!checkRetroChanged(sessionID, section))
+    if (!checkRetroChanged(trigger.sessionID, section))
       return;
     const allLessons = extractLessonsFromRetro(section);
     if (allLessons.length === 0)
@@ -11011,7 +11010,7 @@ function createKnowledgeCuratorHook(directory, config, options = {}) {
     const phaseMatch = /^Phase:\s*(\d+)/m.exec(planContent);
     const phaseNumber = phaseMatch ? parseInt(phaseMatch[1], 10) : 1;
     await _internals17.curateAndStoreSwarm(normalLessons, projectName, { phase_number: phaseNumber }, directory, config, {
-      llmDelegate: options.llmDelegateFactory?.(sessionID),
+      llmDelegate: options.llmDelegateFactory?.(trigger.sessionID),
       enrichmentQuota: options.enrichmentQuota
     });
   };
@@ -13070,7 +13069,7 @@ async function runFinalizeStage(ctx) {
     }
   }
   try {
-    const { CuratorConfigSchema: CCS } = await import("./schema-a8fneygm.js");
+    const { CuratorConfigSchema: CCS } = await import("./schema-mygkbbe9.js");
     const { config: pmLoadedConfig } = _internals20.loadPluginConfigWithMeta(ctx.directory);
     const curatorCfg = CCS.parse(pmLoadedConfig.curator ?? {});
     if (curatorCfg.enabled && curatorCfg.postmortem_enabled) {
@@ -16793,7 +16792,7 @@ async function handleDoctorCommand(directory, args) {
   const result = runConfigDoctor(config, directory);
   let output;
   if (enableAutoFix && result.hasAutoFixableIssues) {
-    const { runConfigDoctorWithFixes } = await import("./config-doctor-h1xrvq83.js");
+    const { runConfigDoctorWithFixes } = await import("./config-doctor-7yrxfa6b.js");
     const fixResult = await runConfigDoctorWithFixes(directory, config, true);
     output = formatDoctorMarkdown(fixResult.result);
   } else {
@@ -31857,7 +31856,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-byb9tgay.js");
+    const { buildHelpText } = await import("./index-attgb1ma.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -31866,7 +31865,7 @@ async function handleHelpCommand(ctx) {
     return _internals45.buildDetailedHelp(resolved.key, resolved.entry);
   }
   const similar = _internals45.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-byb9tgay.js");
+  const { buildHelpText: fullHelp } = await import("./index-attgb1ma.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -31999,7 +31998,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-t6svvtmn.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-cm08h4mt.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -32009,7 +32008,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-log": {
     handler: async (ctx) => {
-      const { handleGuardrailLog } = await import("./guardrail-log-9yyeccv5.js");
+      const { handleGuardrailLog } = await import("./guardrail-log-53z1cf46.js");
       return handleGuardrailLog(ctx.directory, ctx.args);
     },
     description: "Read the guardrail decision log (use --blocks-only for blocks)",

package/dist/cli/{index-xx3sv77e.js → index-zy22fg5h.js}

@@ -3,7 +3,7 @@ import {
   ALL_AGENT_NAMES,
   PluginConfigSchema,
   stripKnownSwarmPrefix
-} from "./index-tqbb2jx6.js";
+} from "./index-471qxz9g.js";
 import {
   log
 } from "./index-zgwm4ryv.js";

package/dist/cli/index.js

@@ -7,15 +7,15 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-sgdr2e4n.js";
-import"./index-b223mczb.js";
+} from "./index-zgba613y.js";
+import"./index-5z2e78tv.js";
 import"./index-2a6ppa65.js";
 import"./index-fjxjb66n.js";
 import"./index-hb10a2g8.js";
-import"./index-xx3sv77e.js";
+import"./index-zy22fg5h.js";
 import {
   DEFAULT_AGENT_CONFIGS
-} from "./index-tqbb2jx6.js";
+} from "./index-471qxz9g.js";
 import"./index-4c5jpmn9.js";
 import"./index-adz3nk9b.js";
 import"./index-v4fcn4tr.js";

package/dist/cli/{schema-a8fneygm.js → schema-mygkbbe9.js}

@@ -22,6 +22,7 @@ import {
   DEFAULT_AGENT_PROFILES,
   DEFAULT_ARCHITECT_PROFILE,
   DEFAULT_EXTERNAL_SKILLS_CONFIG,
+  DEFAULT_SKILLS_CONFIG,
   DecisionDecaySchema,
   DesignDocsConfigSchema,
   DiscoverySourceSchema,
@@ -63,6 +64,7 @@ import {
   SelfReviewConfigSchema,
   SkillImproverConfigSchema,
   SkillPropagationConfigSchema,
+  SkillsConfigSchema,
   SlopDetectorConfigSchema,
   SpecWriterConfigSchema,
   StandardTurboConfigSchema,
@@ -81,7 +83,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-tqbb2jx6.js";
+} from "./index-471qxz9g.js";
 import"./index-p0arc26j.js";
 import"./index-293f68mj.js";
 import"./index-a76rekgs.js";
@@ -104,6 +106,7 @@ export {
   StandardTurboConfigSchema,
   SpecWriterConfigSchema,
   SlopDetectorConfigSchema,
+  SkillsConfigSchema,
   SkillPropagationConfigSchema,
   SkillImproverConfigSchema,
   SelfReviewConfigSchema,
@@ -145,6 +148,7 @@ export {
   DiscoverySourceSchema,
   DesignDocsConfigSchema,
   DecisionDecaySchema,
+  DEFAULT_SKILLS_CONFIG,
   DEFAULT_EXTERNAL_SKILLS_CONFIG,
   DEFAULT_ARCHITECT_PROFILE,
   DEFAULT_AGENT_PROFILES,

package/dist/config/constants.d.ts

@@ -15,6 +15,8 @@ export declare const GENERAL_COUNCIL_TOOL_NAMES: readonly ["convene_general_coun
 export declare const GENERAL_COUNCIL_AGENT_TOOL_MAP: Partial<Record<AgentName, ToolName[]>>;
 export declare const TURBO_TOOL_NAMES: readonly ["lean_turbo_plan_lanes", "lean_turbo_acquire_locks", "lean_turbo_runner_status", "lean_turbo_review", "lean_turbo_run_phase", "lean_turbo_status"];
 export declare const TURBO_AGENT_TOOL_MAP: Partial<Record<AgentName, ToolName[]>>;
+export declare const SKILL_TOOL_NAMES: readonly ["skill_generate", "skill_list", "skill_apply", "skill_inspect", "skill_regenerate", "skill_retire", "skill_improve"];
+export declare const SKILL_AGENT_TOOL_MAP: Partial<Record<AgentName, ToolName[]>>;
 /**
  * Human-readable descriptions for tools shown in the architect Available Tools block.
  * Used to generate the Available Tools section of the architect prompt at construction time.
@@ -36,6 +38,8 @@ export declare function isQAAgent(name: string): name is QAAgentName;
 export declare function isSubagent(name: string): boolean;
 import type { LeanTurboConfig, ScoringConfig, WorktreeIsolationConfig } from './schema';
 export declare const DEFAULT_SCORING_CONFIG: ScoringConfig;
+/** Unified injection budget is now configured only at the top level (context_budget.unified_injection_tokens). */
+export declare const KNOWLEDGE_UNIFIED_INJECTION_TOKENS_DEFAULT: number | null;
 /**
  * Resolve scoring configuration by deep-merging user config with defaults.
  * Missing scoring block → use defaults; partial weights → merge with defaults.

package/dist/config/schema.d.ts

@@ -204,6 +204,7 @@ export declare const ContextBudgetConfigSchema: z.ZodObject<{
     critical_threshold: z.ZodDefault<z.ZodNumber>;
     model_limits: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     max_injection_tokens: z.ZodDefault<z.ZodNumber>;
+    unified_injection_tokens: z.ZodOptional<z.ZodNumber>;
     tracked_agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
     scoring: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -757,6 +758,10 @@ export declare const SkillImproverConfigSchema: z.ZodObject<{
     allow_deterministic_fallback: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type SkillImproverConfig = z.infer<typeof SkillImproverConfigSchema>;
+export declare const SkillsConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SkillsConfig = z.infer<typeof SkillsConfigSchema>;
 export declare const SpecWriterConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -1341,6 +1346,8 @@ export declare const ExternalSkillsConfigSchema: z.ZodObject<{
 export type ExternalSkillsConfig = z.infer<typeof ExternalSkillsConfigSchema>;
 /** Default external skills configuration (all subsystems disabled). */
 export declare const DEFAULT_EXTERNAL_SKILLS_CONFIG: ExternalSkillsConfig;
+/** Default skills configuration (tools gated off). */
+export declare const DEFAULT_SKILLS_CONFIG: SkillsConfig;
 /**
  * Resolve the external_skills config section, merging user-provided values
  * over defaults.  Returns the default (all-disabled) config when
@@ -1474,6 +1481,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         critical_threshold: z.ZodDefault<z.ZodNumber>;
         model_limits: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
         max_injection_tokens: z.ZodDefault<z.ZodNumber>;
+        unified_injection_tokens: z.ZodOptional<z.ZodNumber>;
         tracked_agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
         scoring: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -2183,6 +2191,9 @@ export declare const PluginConfigSchema: z.ZodObject<{
         max_concurrent_fetches: z.ZodDefault<z.ZodNumber>;
         fetch_timeout_ms: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    skills: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginConfig = z.infer<typeof PluginConfigSchema>;
 export type { AgentName, PipelineAgentName, QAAgentName, } from './constants';