opencode-swarm 7.97.0 → 7.98.0

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-xdv74tfk.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-a9ghr5cx.js";
-import"./index-sgdr2e4n.js";
-import"./index-b223mczb.js";
+} from "./index-wmm21nsk.js";
+import"./index-pc10e4d7.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-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-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-byb9tgay.js → index-h6h8qfsh.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-a9ghr5cx.js";
+} from "./index-wmm21nsk.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-pc10e4d7.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-sgdr2e4n.js → index-pc10e4d7.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.0",
   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",
@@ -13070,7 +13070,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 +16793,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 +31857,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-h6h8qfsh.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -31866,7 +31866,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-h6h8qfsh.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -31999,7 +31999,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-t6svvtmn.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-xdv74tfk.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 +32009,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-a9ghr5cx.js → index-wmm21nsk.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-sgdr2e4n.js";
+} from "./index-pc10e4d7.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-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-pc10e4d7.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';

package/dist/evidence/normalize-verdict.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared verdict normalization utilities for evidence writers.
+ *
+ * Centralizes the uppercase→lowercase verdict mapping that was previously
+ * duplicated across write_drift_evidence, write_hallucination_evidence,
+ * and write_mutation_evidence.
+ *
+ * Two distinct verdict sets are supported:
+ * - 2-value (drift / hallucination): APPROVED ↔ approved, NEEDS_REVISION ↔ rejected
+ * - 4-value (mutation): PASS/WARN/FAIL/SKIP ↔ pass/warn/fail/skip
+ *
+ * All functions are pure and throw on invalid input, matching the original
+ * per-file behavior exactly.
+ */
+/**
+ * Normalize a 2-value drift/hallucination verdict to lowercase.
+ * @param verdict - Raw verdict from VERDICT_SET_2 (base: 'APPROVED' | 'NEEDS_REVISION'; extensible)
+ * @returns Normalized verdict: 'approved' | 'rejected' | lowercase form for extended verdicts
+ * @throws Error if verdict is not one of the allowed values in the live set
+ */
+export declare function normalizeVerdict2(verdict: 'APPROVED'): 'approved';
+export declare function normalizeVerdict2(verdict: 'NEEDS_REVISION'): 'rejected';
+export declare function normalizeVerdict2(verdict: 'APPROVED' | 'NEEDS_REVISION'): 'approved' | 'rejected';
+export declare function normalizeVerdict2(verdict: string): string;
+/**
+ * Normalize a 4-value mutation verdict to lowercase.
+ * @param verdict - Raw verdict from VERDICT_SET_4 (base: 'PASS' | 'WARN' | 'FAIL' | 'SKIP'; extensible)
+ * @returns Normalized verdict: 'pass' | 'warn' | 'fail' | 'skip' | lowercase form for extended verdicts
+ * @throws Error if verdict is not one of the allowed values in the live set
+ */
+export declare function normalizeVerdict4(verdict: 'PASS'): 'pass';
+export declare function normalizeVerdict4(verdict: 'WARN'): 'warn';
+export declare function normalizeVerdict4(verdict: 'FAIL'): 'fail';
+export declare function normalizeVerdict4(verdict: 'SKIP'): 'skip';
+export declare function normalizeVerdict4(verdict: 'PASS' | 'WARN' | 'FAIL' | 'SKIP'): 'pass' | 'warn' | 'fail' | 'skip';
+export declare function normalizeVerdict4(verdict: string): string;
+/**
+ * Dependency-injection seam for testing. Tests can temporarily replace these
+ * to verify that evidence writers delegate to the shared normalize-verdict module.
+ * Restore each entry in afterEach via the saved original reference.
+ *
+ * VERDICT_SET_* are the single source of truth. Writers import VERDICT_SET_2 / _4
+ * for their Zod schemas and isAcceptedVerdict* for runtime checks. Adding a value
+ * here (or via _internals for tests) makes all three writers accept it with no
+ * per-writer edits.
+ */
+declare const LIVE_VERDICT_SET_2: string[];
+declare const LIVE_VERDICT_SET_4: string[];
+export declare const VERDICT_SET_2: readonly string[];
+export type Verdict2 = (typeof LIVE_VERDICT_SET_2)[number];
+export declare const VERDICT_SET_4: readonly string[];
+export type Verdict4 = (typeof LIVE_VERDICT_SET_4)[number];
+export declare function isAcceptedVerdict2(v: string): v is Verdict2;
+export declare function isAcceptedVerdict4(v: string): v is Verdict4;
+export declare const _internals: {
+    normalizeVerdict2: typeof normalizeVerdict2;
+    normalizeVerdict4: typeof normalizeVerdict4;
+    VERDICT_SET_2: string[];
+    VERDICT_SET_4: string[];
+    isAcceptedVerdict2: typeof isAcceptedVerdict2;
+    isAcceptedVerdict4: typeof isAcceptedVerdict4;
+    setVerdictSet2: (values: string[]) => void;
+    setVerdictSet4: (values: string[]) => void;
+    getVerdictSet2: () => string[];
+    getVerdictSet4: () => string[];
+};
+export {};

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

@@ -87,7 +87,7 @@ export declare function matchesDelegateScope(entry: Pick<RankedEntry, 'applies_t
  * @param config - Knowledge system configuration
  * @returns A hook function that injects knowledge into messages
  */
-export declare function createKnowledgeInjectorHook(directory: string, config: KnowledgeConfig, modelLimitOverrides?: Record<string, number>): (input: Record<string, never>, output: {
+export declare function createKnowledgeInjectorHook(directory: string, config: KnowledgeConfig, modelLimitOverrides?: Record<string, number>, unifiedInjectionTokens?: number | undefined): (input: Record<string, never>, output: {
     messages?: MessageWithParts[];
 }) => Promise<void>;
 export declare const _internals: {