@wairon/cli 5.1.1-dev.54 → 5.1.1-dev.56

package/dist/index.js

@@ -1233,7 +1233,7 @@ var init_defaults = __esm({
       copilot: ".github/prompts",
       codex: ".codex/agents"
     };
-    WAIRON_VERSION = "5.1.1-dev.54";
+    WAIRON_VERSION = "5.1.1-dev.56";
     GITHUB_REPO = "SYW-Apps/Waffle-AIron";
     ARCHITECT_AGENT_ID = "agent-architect";
     ARCHITECT_TEMPLATE_ID = "architect";
@@ -3053,204 +3053,97 @@ var init_models = __esm({
   }
 });
 
-// src/core/templates.ts
-function builtinTemplatesDir() {
-  return path6.resolve(__dirname, "..", "templates");
-}
-function loadTemplate(id, globalOverride) {
-  const dirs = templateSearchDirs(globalOverride);
-  for (const dir of dirs) {
-    const filePath = path6.join(dir, `${id}.yaml`);
-    if (pathExists(filePath)) {
-      const raw = readYamlFile(filePath);
-      return { ...TemplateSchema.parse(raw), templateName: id };
-    }
-  }
-  throw new TemplateNotFoundError(id);
+// src/config/paths.ts
+function aiPathsAt(rootDir) {
+  const resolvedRoot = path6.resolve(rootDir);
+  const aiDirAt2 = (...segments) => {
+    const waiPath = path6.join(resolvedRoot, ".wai");
+    const waironPath = path6.join(resolvedRoot, ".wairon");
+    const base = !fs4.existsSync(waiPath) && fs4.existsSync(waironPath) ? waironPath : waiPath;
+    return path6.join(base, ...segments);
+  };
+  const specsDir = () => projectConfigRepositoryAt(resolvedRoot).specsDir();
+  return {
+    root: () => aiDirAt2(),
+    projectConfig: () => aiDirAt2("project.yaml"),
+    topologyConfig: () => aiDirAt2("topology.yaml"),
+    templatesDir: () => aiDirAt2("templates"),
+    rulesDir: () => aiDirAt2("rules"),
+    docsDir: () => aiDirAt2("docs"),
+    generatedDir: () => aiDirAt2("generated"),
+    contextDir: () => aiDirAt2("context"),
+    contextProjectMd: () => aiDirAt2("context", "project.md"),
+    contextArchitectureMd: () => aiDirAt2("context", "architecture.md"),
+    contextDomainsMd: () => aiDirAt2("context", "domains.md"),
+    contextWaironGuideMd: () => aiDirAt2("context", "wairon-guide.md"),
+    specsDir,
+    specsSystem: () => path6.join(specsDir(), ".index.yaml"),
+    specsSubsystemsDir: () => path6.join(specsDir(), "subsystems"),
+    specsComponentsDir: () => path6.join(specsDir(), "components"),
+    specsInterfacesDir: () => path6.join(specsDir(), "interfaces"),
+    specsImplementationsDir: () => path6.join(specsDir(), "implementations"),
+    specsTypesDir: () => path6.join(specsDir(), "types")
+  };
 }
-function loadAgentOverride(agentId) {
-  const filePath = path6.join(AI_PATHS.root(), "agents", `${agentId}.md`);
-  return readFileOrNull(filePath);
+function isProjectInitialized() {
+  return projectConfigRepository.exists();
 }
-function listTemplateIds(globalOverride) {
-  const seen = /* @__PURE__ */ new Set();
-  for (const dir of templateSearchDirs(globalOverride)) {
-    for (const file of listFiles(dir, ".yaml")) {
-      seen.add(path6.basename(file, ".yaml"));
-    }
+function assertProjectInitialized() {
+  if (!isProjectInitialized()) {
+    throw new ProjectNotInitializedError();
   }
-  return Array.from(seen).sort();
-}
-function templateSearchDirs(globalOverride) {
-  return [
-    AI_PATHS.templatesDir(),
-    // 1. project-local
-    globalTemplatesDir(globalOverride),
-    // 2. global user/org
-    builtinTemplatesDir()
-    // 3. built-in fallback
-  ];
-}
-function renderTemplateInstructions(template, vars) {
-  return template.instructions.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
-    return key in vars ? vars[key] : `{{${key}}}`;
-  });
-}
-function parseTemplate(yamlContent) {
-  return TemplateSchema.parse(parseYaml(yamlContent));
 }
-var path6;
-var init_templates = __esm({
-  "src/core/templates.ts"() {
+var fs4, path6, AI_PATHS;
+var init_paths = __esm({
+  "src/config/paths.ts"() {
     "use strict";
+    fs4 = __toESM(require("fs"));
     path6 = __toESM(require("path"));
     init_fs();
-    init_yaml();
     init_errors();
-    init_template();
-    init_loader();
-    init_defaults();
-  }
-});
-
-// src/core/execution_profile.ts
-function isSweeping(p) {
-  return p === "**" || p === "**/*" || p.startsWith("**/");
-}
-function deriveBreadth(agent) {
-  if (agent.readPaths.some(isSweeping)) {
-    return MANAGER_TEMPLATES.has(agent.template) || READ_ONLY_TEMPLATES.has(agent.template) ? "wide" : "moderate";
-  }
-  const owned = agent.ownedPaths.length;
-  if (owned >= WIDE_PATH_COUNT) return "wide";
-  if (owned >= MODERATE_PATH_COUNT) return "moderate";
-  return "narrow";
-}
-function deriveReasoningDepth(agent) {
-  for (const tag of agent.tags) {
-    if (DEEP_STEREOTYPES.has(tag)) return "deep";
-    if (MECHANICAL_STEREOTYPES.has(tag)) return "mechanical";
-  }
-  if (MANAGER_TEMPLATES.has(agent.template)) return "deep";
-  if (agent.template === "reviewer") return "deep";
-  if (agent.template === "tester") return "standard";
-  return "standard";
-}
-function deriveWrites(agent) {
-  return !READ_ONLY_TEMPLATES.has(agent.template);
-}
-function deriveExecutionProfile(agent) {
-  const breadth = deriveBreadth(agent);
-  const reasoningDepth = deriveReasoningDepth(agent);
-  const writes = deriveWrites(agent);
-  const delegates = MANAGER_TEMPLATES.has(agent.template);
-  const because = [];
-  if (delegates) {
-    because.push(`${agent.template} routes work rather than performing it`);
-  }
-  const stereotype = agent.tags.find(
-    (t) => MECHANICAL_STEREOTYPES.has(t) || DEEP_STEREOTYPES.has(t)
-  );
-  if (stereotype) {
-    because.push(
-      MECHANICAL_STEREOTYPES.has(stereotype) ? `${stereotype} work is specified by its contract and narrative` : `${stereotype} carries decision logic`
-    );
-  }
-  because.push(
-    breadth === "wide" ? "reads broadly across the tree" : breadth === "moderate" ? `spans ${agent.ownedPaths.length} owned path(s)` : "scoped to a small owned set"
-  );
-  if (!writes) because.push("read-only");
-  return {
-    breadth,
-    writes,
-    reasoningDepth,
-    delegates,
-    rationale: because.join("; ")
-  };
-}
-var MECHANICAL_STEREOTYPES, DEEP_STEREOTYPES, MANAGER_TEMPLATES, READ_ONLY_TEMPLATES, WIDE_PATH_COUNT, MODERATE_PATH_COUNT;
-var init_execution_profile = __esm({
-  "src/core/execution_profile.ts"() {
-    "use strict";
-    MECHANICAL_STEREOTYPES = /* @__PURE__ */ new Set(["store", "index", "registry", "adapter"]);
-    DEEP_STEREOTYPES = /* @__PURE__ */ new Set(["orchestrator", "supervisor", "specialist"]);
-    MANAGER_TEMPLATES = /* @__PURE__ */ new Set(["architect", "domain-owner"]);
-    READ_ONLY_TEMPLATES = /* @__PURE__ */ new Set(["reviewer", "guardian"]);
-    WIDE_PATH_COUNT = 12;
-    MODERATE_PATH_COUNT = 4;
+    init_project_config();
+    AI_PATHS = {
+      root: () => aiPathsAt(getProjectRoot()).root(),
+      projectConfig: () => aiPathsAt(getProjectRoot()).projectConfig(),
+      topologyConfig: () => aiPathsAt(getProjectRoot()).topologyConfig(),
+      templatesDir: () => aiPathsAt(getProjectRoot()).templatesDir(),
+      rulesDir: () => aiPathsAt(getProjectRoot()).rulesDir(),
+      docsDir: () => aiPathsAt(getProjectRoot()).docsDir(),
+      generatedDir: () => aiPathsAt(getProjectRoot()).generatedDir(),
+      contextDir: () => aiPathsAt(getProjectRoot()).contextDir(),
+      contextProjectMd: () => aiPathsAt(getProjectRoot()).contextProjectMd(),
+      contextArchitectureMd: () => aiPathsAt(getProjectRoot()).contextArchitectureMd(),
+      contextDomainsMd: () => aiPathsAt(getProjectRoot()).contextDomainsMd(),
+      contextWaironGuideMd: () => aiPathsAt(getProjectRoot()).contextWaironGuideMd(),
+      specsDir: () => aiPathsAt(getProjectRoot()).specsDir(),
+      specsSystem: () => aiPathsAt(getProjectRoot()).specsSystem(),
+      specsSubsystemsDir: () => aiPathsAt(getProjectRoot()).specsSubsystemsDir(),
+      specsComponentsDir: () => aiPathsAt(getProjectRoot()).specsComponentsDir(),
+      specsInterfacesDir: () => aiPathsAt(getProjectRoot()).specsInterfacesDir(),
+      specsImplementationsDir: () => aiPathsAt(getProjectRoot()).specsImplementationsDir(),
+      specsTypesDir: () => aiPathsAt(getProjectRoot()).specsTypesDir()
+    };
   }
 });
 
-// src/core/budget_policy.ts
-function atLeast(tier, floor) {
-  return TIER_ORDER.indexOf(tier) >= TIER_ORDER.indexOf(floor);
-}
-function baseModelTier(profile) {
-  switch (profile.reasoningDepth) {
-    case "mechanical":
-      return "small";
-    case "standard":
-      return "standard";
-    case "deep":
-      return "large";
-  }
-}
-function stepDown(tier, steps) {
-  const i = TIER_STEPS.indexOf(tier);
-  return TIER_STEPS[Math.max(0, i - steps)];
-}
-function maxTurnsFor(profile, tier) {
-  if (!atLeast(tier, "default")) return void 0;
-  const ceiling = profile.breadth === "wide" ? 60 : profile.breadth === "moderate" ? 40 : 25;
-  return atLeast(tier, "aggressive") ? Math.round(ceiling / 2) : ceiling;
-}
-function effortFor(profile, tier) {
-  if (!atLeast(tier, "trade")) return void 0;
-  if (profile.reasoningDepth === "mechanical") {
-    return atLeast(tier, "aggressive") ? "low" : "medium";
-  }
-  return void 0;
-}
-function toolClassFor(profile) {
-  return profile.writes ? "implement" : "read-only";
-}
-function mcpFor(profile, tier) {
-  if (!atLeast(tier, "free")) return "all";
-  if (profile.delegates) return "project";
-  return profile.breadth === "wide" ? "project" : "none";
+// src/config/loader.ts
+function loadTopologyConfig() {
+  assertProjectInitialized();
+  if (!pathExists(AI_PATHS.topologyConfig())) return createEmptyTopologyConfig();
+  const raw = readYamlFile(AI_PATHS.topologyConfig());
+  if (!raw) return createEmptyTopologyConfig();
+  return TopologyConfigSchema.parse(raw);
 }
-function resolveBudget(profile, config, agentId) {
-  const tier = config.tier;
-  if (tier === "off") return void 0;
-  let modelTier = baseModelTier(profile);
-  if (atLeast(tier, "trade") && profile.reasoningDepth === "standard") {
-    modelTier = stepDown(modelTier, 1);
-  }
-  if (atLeast(tier, "aggressive") && profile.reasoningDepth !== "deep") {
-    modelTier = "small";
-  }
-  const budget = {
-    // At `free` no model selection is expressed at all — that tier is defined
-    // as having no quality tradeoff, and choosing a model is a quality
-    // decision. Leaving it absent is not the same as choosing a default.
-    modelTier: atLeast(tier, "default") ? modelTier : void 0,
-    effort: effortFor(profile, tier),
-    maxTurns: maxTurnsFor(profile, tier),
-    toolClass: toolClassFor(profile),
-    // Only managers may spawn. Withholding the tool from workers is what stops
-    // a worker quietly becoming a second orchestrator three levels down.
-    allowNestedDelegation: profile.delegates,
-    mcp: mcpFor(profile, tier)
-  };
-  const override = config.overrides[agentId];
-  return override ? { ...budget, ...override } : budget;
+function saveTopologyConfig(config) {
+  writeYamlFile(AI_PATHS.topologyConfig(), config);
 }
-var TIER_ORDER, TIER_STEPS;
-var init_budget_policy = __esm({
-  "src/core/budget_policy.ts"() {
+var init_loader = __esm({
+  "src/config/loader.ts"() {
     "use strict";
-    TIER_ORDER = ["off", "free", "default", "trade", "aggressive"];
-    TIER_STEPS = ["small", "standard", "large", "frontier"];
+    init_fs();
+    init_yaml();
+    init_models();
+    init_paths();
   }
 });
 
@@ -3329,14 +3222,14 @@ function describeApprover(who) {
 }
 function readLockRecord() {
   try {
-    return normalizeRecord(JSON.parse(fs4.readFileSync(lockPath(), "utf8")));
+    return normalizeRecord(JSON.parse(fs5.readFileSync(lockPath(), "utf8")));
   } catch {
     return null;
   }
 }
 function readLockRecordAt(root) {
   try {
-    return normalizeRecord(JSON.parse(fs4.readFileSync(aiDirAt(root, "lock.json"), "utf8")));
+    return normalizeRecord(JSON.parse(fs5.readFileSync(aiDirAt(root, "lock.json"), "utf8")));
   } catch {
     return null;
   }
@@ -3347,10 +3240,10 @@ function normalizeRecord(raw) {
 }
 function writeLockRecord(record) {
   const p = lockPath();
-  fs4.mkdirSync(path7.dirname(p), { recursive: true });
+  fs5.mkdirSync(path7.dirname(p), { recursive: true });
   const tmp = `${p}.tmp`;
-  fs4.writeFileSync(tmp, JSON.stringify(withSortedMaps(record), null, 2) + "\n");
-  fs4.renameSync(tmp, p);
+  fs5.writeFileSync(tmp, JSON.stringify(withSortedMaps(record), null, 2) + "\n");
+  fs5.renameSync(tmp, p);
 }
 function withSortedMaps(record) {
   const sorted = (m) => {
@@ -3367,11 +3260,11 @@ function withSortedMaps(record) {
     ...children ? { children } : {}
   };
 }
-var fs4, path7;
+var fs5, path7;
 var init_lockfile = __esm({
   "src/core/lockfile.ts"() {
     "use strict";
-    fs4 = __toESM(require("fs"));
+    fs5 = __toESM(require("fs"));
     path7 = __toESM(require("path"));
     init_fs();
   }
@@ -3388,24 +3281,24 @@ function listSpecFiles(specsDir) {
   return listFilesRecursive(specsDir, SPEC_FILE_EXTENSION);
 }
 function removeSpecFile(filePath, specsRoot) {
-  if (!fs5.existsSync(filePath)) return false;
-  fs5.unlinkSync(filePath);
+  if (!fs6.existsSync(filePath)) return false;
+  fs6.unlinkSync(filePath);
   pruneEmptyDirs(path8.dirname(filePath), path8.resolve(specsRoot));
   return true;
 }
 function pruneEmptyDirs(dir, specsRoot) {
   let at = dir;
   while (at !== specsRoot && at.startsWith(specsRoot)) {
-    if (!fs5.existsSync(at) || fs5.readdirSync(at).length > 0) return;
-    fs5.rmdirSync(at);
+    if (!fs6.existsSync(at) || fs6.readdirSync(at).length > 0) return;
+    fs6.rmdirSync(at);
     at = path8.dirname(at);
   }
 }
-var fs5, path8, SPEC_FILE_EXTENSION;
+var fs6, path8, SPEC_FILE_EXTENSION;
 var init_spec_files = __esm({
   "src/core/spec-files.ts"() {
     "use strict";
-    fs5 = __toESM(require("fs"));
+    fs6 = __toESM(require("fs"));
     path8 = __toESM(require("path"));
     init_fs();
     init_yaml();
@@ -4157,8 +4050,8 @@ function loadCytoscapeLib() {
     // dist (library entry)
   ];
   for (const p of candidates) {
-    if (fs6.existsSync(p)) {
-      return fs6.readFileSync(p, "utf-8").replace(/<\/script/gi, "<\\/script");
+    if (fs7.existsSync(p)) {
+      return fs7.readFileSync(p, "utf-8").replace(/<\/script/gi, "<\\/script");
     }
   }
   throw new Error("Vendored cytoscape bundle not found (templates/canvas/cytoscape.min.js) \u2014 the wairon installation is incomplete.");
@@ -4170,11 +4063,11 @@ function renderCanvasHtml(model) {
 function escapeHtml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-var fs6, path9, CANVAS_TEMPLATE;
+var fs7, path9, CANVAS_TEMPLATE;
 var init_canvas = __esm({
   "src/core/canvas.ts"() {
     "use strict";
-    fs6 = __toESM(require("fs"));
+    fs7 = __toESM(require("fs"));
     path9 = __toESM(require("path"));
     init_specs2();
     init_models();
@@ -8370,7 +8263,7 @@ function packStoreDir() {
 function packFiles(dir, prefix = "") {
   let entries;
   try {
-    entries = fs7.readdirSync(dir, { withFileTypes: true });
+    entries = fs8.readdirSync(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -8388,7 +8281,7 @@ function computePackDigest(packDir) {
   const abs = path10.resolve(packDir);
   let isFile = false;
   try {
-    isFile = fs7.statSync(abs).isFile();
+    isFile = fs8.statSync(abs).isFile();
   } catch {
   }
   const entries = isFile ? [[path10.basename(abs), abs]] : packFiles(abs).map((rel2) => [rel2, path10.join(abs, rel2)]);
@@ -8396,7 +8289,7 @@ function computePackDigest(packDir) {
     hash.update(rel2);
     hash.update("\0");
     try {
-      hash.update(fs7.readFileSync(full));
+      hash.update(fs8.readFileSync(full));
     } catch {
     }
     hash.update("\0");
@@ -8435,7 +8328,7 @@ function installedFrom(location, name, version) {
 function versionedEntries(nameDir, fallbackName) {
   let versions;
   try {
-    versions = fs7.readdirSync(nameDir, { withFileTypes: true });
+    versions = fs8.readdirSync(nameDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -8465,7 +8358,7 @@ function listInstalledPacks() {
   const store = packStoreDir();
   let entries;
   try {
-    entries = fs7.readdirSync(store, { withFileTypes: true });
+    entries = fs8.readdirSync(store, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -8490,9 +8383,9 @@ function installPackFromDirectory(sourceDir, origin) {
   const manifest = readManifest(entryFile, path10.dirname(entryFile));
   const version = manifest.version && manifest.version.length > 0 ? manifest.version : UNVERSIONED;
   const dest = path10.join(packStoreDir(), manifest.name, version);
-  fs7.rmSync(dest, { recursive: true, force: true });
-  fs7.mkdirSync(path10.dirname(dest), { recursive: true });
-  fs7.cpSync(abs, dest, { recursive: true });
+  fs8.rmSync(dest, { recursive: true, force: true });
+  fs8.mkdirSync(path10.dirname(dest), { recursive: true });
+  fs8.cpSync(abs, dest, { recursive: true });
   const digest2 = computePackDigest(dest);
   const record = {
     origin,
@@ -8515,22 +8408,22 @@ function uninstallPack(name, version) {
   const targets = listInstalledPacks().filter((p) => p.name === name && (!version || p.version === version));
   if (targets.length === 0) return false;
   for (const target of targets) {
-    fs7.rmSync(target.path, { recursive: true, force: true });
+    fs8.rmSync(target.path, { recursive: true, force: true });
     const parent = path10.dirname(target.path);
     if (path10.resolve(parent) === path10.resolve(packStoreDir())) continue;
     try {
-      if (fs7.readdirSync(parent).length === 0) fs7.rmdirSync(parent);
+      if (fs8.readdirSync(parent).length === 0) fs8.rmdirSync(parent);
     } catch {
     }
   }
   return true;
 }
-var crypto2, fs7, path10, UNVERSIONED, INSTALL_RECORD, DIGEST_EXCLUDED, PACK_FILE_RE;
+var crypto2, fs8, path10, UNVERSIONED, INSTALL_RECORD, DIGEST_EXCLUDED, PACK_FILE_RE;
 var init_packstore = __esm({
   "src/core/packstore.ts"() {
     "use strict";
     crypto2 = __toESM(require("crypto"));
-    fs7 = __toESM(require("fs"));
+    fs8 = __toESM(require("fs"));
     path10 = __toESM(require("path"));
     init_yaml();
     init_defaults();
@@ -8563,14 +8456,14 @@ function globalPacksDir() {
 function packDirEntry(dir) {
   for (const name of PACK_DIR_ENTRIES) {
     const p = path11.join(dir, name);
-    if (fs8.existsSync(p)) return p;
+    if (fs9.existsSync(p)) return p;
   }
   return null;
 }
 function latestVersionDir(nameDir) {
   let versions;
   try {
-    versions = fs8.readdirSync(nameDir, { withFileTypes: true });
+    versions = fs9.readdirSync(nameDir, { withFileTypes: true });
   } catch {
     return null;
   }
@@ -8586,7 +8479,7 @@ function latestVersionDir(nameDir) {
 function discoverPacks(dir) {
   let entries;
   try {
-    entries = fs8.readdirSync(dir, { withFileTypes: true });
+    entries = fs9.readdirSync(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -8632,7 +8525,7 @@ function resolvePackRef(ref, projectRoot) {
   const pathLike = ref.startsWith(".") || path11.isAbsolute(ref) || isYamlPath(ref);
   if (!pathLike) return ref;
   const resolved = path11.resolve(projectRoot, ref);
-  if (fs8.existsSync(resolved) && fs8.statSync(resolved).isDirectory()) {
+  if (fs9.existsSync(resolved) && fs9.statSync(resolved).isDirectory()) {
     const entry = packDirEntry(resolved);
     if (!entry) throw new Error(`directory pack has no entry file (${PACK_DIR_ENTRIES.join(" | ")})`);
     return entry;
@@ -8858,7 +8751,7 @@ function findBundledPack(projectRoot, selection) {
   if (packDirEntry(base)) return base;
   let versions;
   try {
-    versions = fs8.readdirSync(base, { withFileTypes: true });
+    versions = fs9.readdirSync(base, { withFileTypes: true });
   } catch {
     return null;
   }
@@ -8871,11 +8764,11 @@ function findBundledPack(projectRoot, selection) {
   }
   return best?.dir ?? null;
 }
-var fs8, os2, path11, import_module, import_zod9, ProfileDefSchema, LanguagePackDefSchema, PackSkillSchema, PackInstructionBlockSchema, PackInstructionsSchema, PatternDefSchema, AssertionSelectorSchema, assertionBase, PackAssertionSchema, DeclarativePackSchema, EXTENDABLE_BUILTIN_SKILLS, GLOBAL_PACKS_DEFAULT, PACK_DIR_ENTRIES, isYamlPath;
+var fs9, os2, path11, import_module, import_zod9, ProfileDefSchema, LanguagePackDefSchema, PackSkillSchema, PackInstructionBlockSchema, PackInstructionsSchema, PatternDefSchema, AssertionSelectorSchema, assertionBase, PackAssertionSchema, DeclarativePackSchema, EXTENDABLE_BUILTIN_SKILLS, GLOBAL_PACKS_DEFAULT, PACK_DIR_ENTRIES, isYamlPath;
 var init_extensions = __esm({
   "src/core/extensions.ts"() {
     "use strict";
-    fs8 = __toESM(require("fs"));
+    fs9 = __toESM(require("fs"));
     os2 = __toESM(require("os"));
     path11 = __toESM(require("path"));
     import_module = require("module");
@@ -16101,7 +15994,7 @@ function resolveRelativeModule(fromFile, specifier) {
   ];
   for (const c of candidates) {
     try {
-      if (fs9.statSync(c).isFile()) return c;
+      if (fs10.statSync(c).isFile()) return c;
     } catch {
     }
   }
@@ -16113,7 +16006,7 @@ function reexportTarget(ts, filePath, specifier, projectRoot, visited, exactCach
   let targetFacts = exactCache.get(target);
   if (targetFacts === void 0) {
     try {
-      targetFacts = walkExact(ts, fs9.readFileSync(target, "utf8"), target);
+      targetFacts = walkExact(ts, fs10.readFileSync(target, "utf8"), target);
     } catch {
       targetFacts = null;
     }
@@ -16170,7 +16063,7 @@ function walkDeclaredRoots(roots, exclude, projectRoot) {
   const descend = (dir) => {
     let entries;
     try {
-      entries = fs9.readdirSync(dir, { withFileTypes: true });
+      entries = fs10.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -16193,7 +16086,7 @@ function walkDeclaredRoots(roots, exclude, projectRoot) {
     if (isExcluded(key)) continue;
     let stat;
     try {
-      stat = fs9.statSync(absolute);
+      stat = fs10.statSync(absolute);
     } catch {
       continue;
     }
@@ -16230,12 +16123,12 @@ function buildCodeModel(implementations, types, projectRoot, sourceRoots = [], e
     }
     let buffer;
     try {
-      const stat = fs9.statSync(absolute);
+      const stat = fs10.statSync(absolute);
       if (!stat.isFile()) {
         files.push({ path: sourcePath, status: "missing", ...empty });
         continue;
       }
-      buffer = fs9.readFileSync(absolute);
+      buffer = fs10.readFileSync(absolute);
     } catch {
       files.push({ path: sourcePath, status: "missing", ...empty });
       continue;
@@ -16289,7 +16182,7 @@ function readTestFiles(testRoots, projectRoot) {
   for (const key of walkDeclaredRoots(testRoots, [], projectRoot)) {
     let text;
     try {
-      const buffer = fs9.readFileSync(path12.resolve(projectRoot, key));
+      const buffer = fs10.readFileSync(path12.resolve(projectRoot, key));
       if (looksBinary(buffer)) continue;
       text = buffer.toString("utf8");
     } catch {
@@ -16326,11 +16219,11 @@ function findTestsReferencing(methods, projectRoot, testRoots = []) {
   }
   return found;
 }
-var fs9, path12, import_module2, EXTENSION_LANGUAGE, C_FAMILY_COMMENTS, NAMED_IMPORT_BINDINGS_RE, JS_PATTERNS, LANGUAGE_PATTERNS, PATTERN_ANALYSIS_MAX_BYTES, IDENTIFIER_RE, STRING_RE, tsResolutionCache, TS_RESOLUTION_RETRY_MS;
+var fs10, path12, import_module2, EXTENSION_LANGUAGE, C_FAMILY_COMMENTS, NAMED_IMPORT_BINDINGS_RE, JS_PATTERNS, LANGUAGE_PATTERNS, PATTERN_ANALYSIS_MAX_BYTES, IDENTIFIER_RE, STRING_RE, tsResolutionCache, TS_RESOLUTION_RETRY_MS;
 var init_source_analysis = __esm({
   "src/core/source-analysis.ts"() {
     "use strict";
-    fs9 = __toESM(require("fs"));
+    fs10 = __toESM(require("fs"));
     path12 = __toESM(require("path"));
     import_module2 = require("module");
     init_models();
@@ -17107,7 +17000,7 @@ function builtinVariantsDir() {
     path13.resolve(__dirname, "templates", "variants")
     // dist (library entry)
   ];
-  return candidates.find((dir) => fs10.existsSync(dir)) ?? candidates[0];
+  return candidates.find((dir) => fs11.existsSync(dir)) ?? candidates[0];
 }
 function projectVariantsDir() {
   return path13.join(getProjectRoot(), ".wai", "variants");
@@ -17115,7 +17008,7 @@ function projectVariantsDir() {
 function variantFiles(dir) {
   let entries;
   try {
-    entries = fs10.readdirSync(dir, { withFileTypes: true });
+    entries = fs11.readdirSync(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -17228,11 +17121,11 @@ function rebasedText(content, fromBase, toBase, rebasedContent) {
   }
   return serializeYaml(rebasedContent);
 }
-var fs10, os3, path13, import_zod10, VariantDefSchema;
+var fs11, os3, path13, import_zod10, VariantDefSchema;
 var init_variants = __esm({
   "src/core/variants.ts"() {
     "use strict";
-    fs10 = __toESM(require("fs"));
+    fs11 = __toESM(require("fs"));
     os3 = __toESM(require("os"));
     path13 = __toESM(require("path"));
     import_zod10 = require("zod");
@@ -17782,9 +17675,9 @@ function projectSubsystemSurface(subsystemId) {
 }
 function listSnapshots(rootDir = getProjectRoot()) {
   const dir = surfacesDir(rootDir);
-  if (!fs11.existsSync(dir)) return [];
+  if (!fs12.existsSync(dir)) return [];
   const out = [];
-  for (const file of fs11.readdirSync(dir)) {
+  for (const file of fs12.readdirSync(dir)) {
     if (!file.endsWith(".yaml") && !file.endsWith(".yml")) continue;
     try {
       out.push(SurfaceSnapshotSchema.parse(readYamlFile(path14.join(dir, file))));
@@ -17801,10 +17694,10 @@ function snapshotFilename(projectName) {
 }
 function writeSnapshotIfChanged(snapshot, rootDir) {
   const dir = surfacesDir(rootDir);
-  fs11.mkdirSync(dir, { recursive: true });
+  fs12.mkdirSync(dir, { recursive: true });
   const p = path14.join(dir, snapshotFilename(snapshot.projectName));
   const next = SurfaceSnapshotSchema.parse(snapshot);
-  if (fs11.existsSync(p)) {
+  if (fs12.existsSync(p)) {
     try {
       const existing = SurfaceSnapshotSchema.parse(readYamlFile(p));
       if (surfaceContentKey(existing) === surfaceContentKey(next)) {
@@ -17822,18 +17715,18 @@ function saveSnapshot(snapshot, rootDir = getProjectRoot()) {
 function removeSnapshot(projectName, rootDir = getProjectRoot()) {
   const dir = surfacesDir(rootDir);
   const direct = path14.join(dir, snapshotFilename(projectName));
-  if (fs11.existsSync(direct)) {
-    fs11.unlinkSync(direct);
+  if (fs12.existsSync(direct)) {
+    fs12.unlinkSync(direct);
     return true;
   }
-  if (!fs11.existsSync(dir)) return false;
-  for (const file of fs11.readdirSync(dir)) {
+  if (!fs12.existsSync(dir)) return false;
+  for (const file of fs12.readdirSync(dir)) {
     if (!file.endsWith(".yaml") && !file.endsWith(".yml")) continue;
     const p = path14.join(dir, file);
     try {
       const snap = SurfaceSnapshotSchema.parse(readYamlFile(p));
       if (snap.projectName === projectName) {
-        fs11.unlinkSync(p);
+        fs12.unlinkSync(p);
         return true;
       }
     } catch {
@@ -17873,18 +17766,18 @@ function perPortalPath(resolvedOut, portalId) {
 }
 function writeSurfaceFile(outPath, snapshot, renderedSet) {
   const resolved = path14.resolve(outPath);
-  fs11.mkdirSync(path14.dirname(resolved), { recursive: true });
+  fs12.mkdirSync(path14.dirname(resolved), { recursive: true });
   if (!renderedSet || renderedSet.length === 0) {
     writeYamlFile(resolved, snapshot);
     return [resolved];
   }
   if (renderedSet.length === 1) {
-    fs11.writeFileSync(resolved, renderedSet[0].document);
+    fs12.writeFileSync(resolved, renderedSet[0].document);
     return [resolved];
   }
   return renderedSet.map((spec) => {
     const target = perPortalPath(resolved, spec.portalId);
-    fs11.writeFileSync(target, spec.document);
+    fs12.writeFileSync(target, spec.document);
     return target;
   });
 }
@@ -17907,10 +17800,10 @@ function exportSurface(maxAudience, format, outPath, portalId) {
 }
 function importSurface(sourcePath, origin) {
   const resolved = path14.resolve(sourcePath);
-  if (!fs11.existsSync(resolved)) {
+  if (!fs12.existsSync(resolved)) {
     throw new Error(`Surface document not found: ${resolved}`);
   }
-  const body = fs11.readFileSync(resolved, "utf8");
+  const body = fs12.readFileSync(resolved, "utf8");
   let snapshot;
   if (isOpenApiDocument(body)) {
     const projectName = path14.basename(resolved).replace(/\.(json|ya?ml)$/i, "");
@@ -17976,11 +17869,11 @@ function surfaceContentKey(snapshot) {
   const { stateId, generatedAt, origin, ...content } = snapshot;
   return JSON.stringify(content);
 }
-var fs11, path14, SURFACES_DIRNAME, CROSS_BOUNDARY_TARGETS;
+var fs12, path14, SURFACES_DIRNAME, CROSS_BOUNDARY_TARGETS;
 var init_surfaces = __esm({
   "src/core/surfaces.ts"() {
     "use strict";
-    fs11 = __toESM(require("fs"));
+    fs12 = __toESM(require("fs"));
     path14 = __toESM(require("path"));
     init_fs();
     init_yaml();
@@ -19048,7 +18941,7 @@ function canonicalPath(target) {
   const rest = [];
   for (; ; ) {
     try {
-      fs12.lstatSync(existing);
+      fs13.lstatSync(existing);
       break;
     } catch {
       const up = path16.dirname(existing);
@@ -19058,7 +18951,7 @@ function canonicalPath(target) {
     }
   }
   try {
-    return path16.join(fs12.realpathSync.native(existing), ...rest);
+    return path16.join(fs13.realpathSync.native(existing), ...rest);
   } catch {
     return null;
   }
@@ -19150,7 +19043,7 @@ function inspectChainedRoots(rootDir = getProjectRoot()) {
       let reason;
       if (projectPathEscapesRoot(projectDir, projectPath, childDir)) reason = "escapes";
       else if (ancestors.has(chainDirKey(childDir))) reason = "cyclic";
-      else if (!fs12.existsSync(childDir)) reason = "missing";
+      else if (!fs13.existsSync(childDir)) reason = "missing";
       else if (depth >= 32) reason = "too-deep";
       if (reason) {
         const mount = prefix ? qualifyDeclaredId(localId, prefix, true) : localId;
@@ -19284,9 +19177,9 @@ function findOwner(id, components) {
 }
 function moveComponentFolder(fromDir, toDir) {
   if (path16.normalize(fromDir) === path16.normalize(toDir)) return false;
-  if (!fs12.existsSync(fromDir) || fs12.existsSync(toDir)) return false;
+  if (!fs13.existsSync(fromDir) || fs13.existsSync(toDir)) return false;
   ensureDir(path16.dirname(toDir));
-  fs12.renameSync(fromDir, toDir);
+  fs13.renameSync(fromDir, toDir);
   return true;
 }
 function formatZodIssues(error) {
@@ -19302,13 +19195,13 @@ function parseOrThrow(schema, value, kind, id) {
 function computeSpecTreeSignature(dirs) {
   const parts = [];
   for (const dir of dirs) {
-    if (!fs12.existsSync(dir)) {
+    if (!fs13.existsSync(dir)) {
       parts.push(`${dir}:missing`);
       continue;
     }
     for (const f of listSpecFiles(dir)) {
       try {
-        const st = fs12.statSync(f);
+        const st = fs13.statSync(f);
         parts.push(`${f}:${st.mtimeMs}:${st.size}`);
       } catch {
         parts.push(`${f}:gone`);
@@ -19834,7 +19727,7 @@ function consumedSurfaceInputsAt(rootDir) {
   const dir = path16.join(rootDir, ".wai", "surfaces");
   if (!pathExists(dir)) return [];
   const keys = [];
-  for (const file of fs12.readdirSync(dir)) {
+  for (const file of fs13.readdirSync(dir)) {
     if (!file.endsWith(".yaml") && !file.endsWith(".yml")) continue;
     try {
       keys.push(snapshotInputKey(SurfaceSnapshotSchema.parse(readYamlFile(path16.join(dir, file)))));
@@ -19919,7 +19812,7 @@ function snapshotSpecFiles() {
 }
 function restoreSpecFiles(snapshot) {
   for (const [file, content] of snapshot) {
-    fs12.writeFileSync(file, content);
+    fs13.writeFileSync(file, content);
   }
 }
 function findLegacySpecFiles() {
@@ -19931,13 +19824,13 @@ function updateSpec(kind, id, delta, hooks, dryRun) {
 function moveMethods(from, to, methods, hooks, dryRun) {
   return current().moveMethods(from, to, methods, hooks, dryRun);
 }
-var fs12, path16, NO_ROOT_SUBSYSTEMS, SIGNATURE_TTL_MS, COMPONENT_AUTH_SOURCE, DELTA_VERBS, JUMP_LABEL_TWINS, LABEL_TWIN_CONTAINERS, SpecWorkspace, DEFAULT_DEPENDENCY_LIMIT, PROSE_FIELDS, workspaces;
+var fs13, path16, NO_ROOT_SUBSYSTEMS, SIGNATURE_TTL_MS, COMPONENT_AUTH_SOURCE, DELTA_VERBS, JUMP_LABEL_TWINS, LABEL_TWIN_CONTAINERS, SpecWorkspace, DEFAULT_DEPENDENCY_LIMIT, PROSE_FIELDS, workspaces;
 var init_specs2 = __esm({
   "src/core/specs.ts"() {
     "use strict";
-    fs12 = __toESM(require("fs"));
+    fs13 = __toESM(require("fs"));
     path16 = __toESM(require("path"));
-    init_loader();
+    init_paths();
     init_project_config();
     init_fs();
     init_statehash();
@@ -20218,7 +20111,7 @@ var init_specs2 = __esm({
               });
               continue;
             }
-            if (!fs12.existsSync(childDir)) {
+            if (!fs13.existsSync(childDir)) {
               this.loaderIssues.push({
                 severity: "error",
                 code: "SUBPROJECT_NOT_FOUND",
@@ -21152,8 +21045,8 @@ var init_specs2 = __esm({
           }
         }
         for (const file of files) {
-          if (fs12.existsSync(file)) {
-            snapshot.set(file, fs12.readFileSync(file, "utf8"));
+          if (fs13.existsSync(file)) {
+            snapshot.set(file, fs13.readFileSync(file, "utf8"));
           }
         }
         return snapshot;
@@ -22183,567 +22076,135 @@ var init_specs2 = __esm({
   }
 });
 
-// src/core/agent_resolver.ts
-var agent_resolver_exports = {};
-__export(agent_resolver_exports, {
-  UnknownAgentError: () => UnknownAgentError,
-  composeAgentBrief: () => composeAgentBrief,
-  resolveAgentTopology: () => resolveAgentTopology
+// src/core/domains.ts
+var domains_exports = {};
+__export(domains_exports, {
+  addFreeStandingDomain: () => addFreeStandingDomain,
+  deriveSubsystemDomains: () => deriveSubsystemDomains,
+  findDomain: () => findDomain,
+  listFreeStandingDomains: () => listFreeStandingDomains,
+  removeFreeStandingDomain: () => removeFreeStandingDomain,
+  resolveDomains: () => resolveDomains
 });
-function listFilesRecursiveSafe(dirPath, ext) {
-  if (!fs13.existsSync(dirPath)) return [];
-  const nameLower = path17.basename(dirPath).toLowerCase();
-  const IGNORED_DIRS = /* @__PURE__ */ new Set([
-    "node_modules",
-    "target",
-    "dist",
-    "build",
-    ".git",
-    ".wai",
-    ".claude",
-    ".gemini",
-    ".codex",
-    ".agents",
-    ".vscode"
-  ]);
-  if (IGNORED_DIRS.has(nameLower)) return [];
-  const entries = fs13.readdirSync(dirPath, { withFileTypes: true });
-  const files = [];
-  for (const entry of entries) {
-    const fullPath = path17.join(dirPath, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...listFilesRecursiveSafe(fullPath, ext));
-    } else if (entry.isFile() && entry.name.endsWith(ext)) {
-      files.push(fullPath);
-    }
+function rel(p) {
+  return path17.relative(process.cwd(), p).replace(/\\/g, "/");
+}
+function deriveSubsystemDomains() {
+  const subsystems = loadSubsystemSpecs();
+  const components = loadComponentSpecs();
+  return subsystems.map((sub) => {
+    const ownedPaths = [
+      rel(getSubsystemPath(sub.id)),
+      ...components.filter((c) => c.subsystem === sub.id).map((c) => rel(getComponentPath(c.id, sub.id)))
+    ];
+    return {
+      id: sub.id,
+      name: sub.name,
+      description: sub.description,
+      boundTo: sub.id,
+      ownedPaths
+    };
+  });
+}
+function listFreeStandingDomains() {
+  return loadTopologyConfig().domains;
+}
+function resolveDomains() {
+  return [...deriveSubsystemDomains(), ...listFreeStandingDomains()];
+}
+function findDomain(id) {
+  return resolveDomains().find((d) => d.id === id);
+}
+function addFreeStandingDomain(domain) {
+  const config = loadTopologyConfig();
+  if (config.domains.some((d) => d.id === domain.id)) {
+    throw new WaironError(`A free-standing domain "${domain.id}" already exists in .wai/topology.yaml.`);
   }
-  return files;
+  if (deriveSubsystemDomains().some((d) => d.id === domain.id)) {
+    throw new WaironError(`Domain id "${domain.id}" collides with a subsystem-derived domain.`);
+  }
+  config.domains.push(domain);
+  saveTopologyConfig(config);
 }
-function getProjectFiles(projectDir) {
-  let files = projectFilesCache.get(projectDir);
-  if (!files) {
-    files = [];
-    const srcDir = path17.join(projectDir, "src");
-    const legacySrcDir = path17.join(projectDir, "legacy-src");
-    let searchDir = projectDir;
-    if (pathExists(srcDir)) {
-      searchDir = srcDir;
-    } else if (pathExists(legacySrcDir)) {
-      searchDir = legacySrcDir;
-    } else if (projectDir === getProjectRoot()) {
-      projectFilesCache.set(projectDir, []);
-      return [];
-    }
-    const extensions = [".rs", ".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".c", ".cpp", ".cs", ".java", ".kt", ".swift", ".rb", ".php", ".lua"];
-    for (const ext of extensions) {
-      files.push(...listFilesRecursiveSafe(searchDir, ext));
-    }
-    const rootDir = getProjectRoot();
-    files = files.map((f) => path17.relative(rootDir, f).replace(/\\/g, "/"));
-    projectFilesCache.set(projectDir, files);
+function removeFreeStandingDomain(id) {
+  const config = loadTopologyConfig();
+  const idx = config.domains.findIndex((d) => d.id === id);
+  if (idx === -1) {
+    throw new WaironError(
+      `"${id}" is not a free-standing domain. Subsystem-backed domains are derived from the spec tree and cannot be removed here.`
+    );
   }
-  return files;
+  config.domains.splice(idx, 1);
+  saveTopologyConfig(config);
 }
-function inferSourcePathForComponent(comp, subsystems) {
-  try {
-    const projectDir = resolveSubprojectForNamespace(comp.subsystem) || getProjectRoot();
-    const files = getProjectFiles(projectDir);
-    if (files.length === 0) return null;
-    const compRelativeId = comp.id.split("::").pop() || comp.id;
-    const subRelativeId = comp.subsystem.split("::").pop() || comp.subsystem;
-    let cleanName = compRelativeId;
-    if (cleanName.startsWith(`${subRelativeId}-`)) {
-      cleanName = cleanName.slice(subRelativeId.length + 1);
+var path17;
+var init_domains = __esm({
+  "src/core/domains.ts"() {
+    "use strict";
+    path17 = __toESM(require("path"));
+    init_loader();
+    init_specs2();
+    init_errors();
+  }
+});
+
+// src/core/templates.ts
+function builtinTemplatesDir() {
+  return path18.resolve(__dirname, "..", "templates");
+}
+function loadTemplate(id, globalOverride) {
+  const dirs = templateSearchDirs(globalOverride);
+  for (const dir of dirs) {
+    const filePath = path18.join(dir, `${id}.yaml`);
+    if (pathExists(filePath)) {
+      const raw = readYamlFile(filePath);
+      return { ...TemplateSchema.parse(raw), templateName: id };
     }
-    const candidates = /* @__PURE__ */ new Set();
-    candidates.add(cleanName.toLowerCase());
-    candidates.add(cleanName.replace(/-/g, "_").toLowerCase());
-    candidates.add(compRelativeId.toLowerCase());
-    candidates.add(compRelativeId.replace(/-/g, "_").toLowerCase());
-    candidates.add(comp.componentType.toLowerCase());
-    let bestFile = null;
-    let bestScore = -1;
-    for (const f of files) {
-      const ext = path17.extname(f);
-      const base = path17.basename(f, ext).toLowerCase();
-      if (candidates.has(base)) {
-        let score = 0;
-        const normalizedPath = f.toLowerCase();
-        const subPattern1 = `/${subRelativeId.toLowerCase()}/`;
-        const subPattern2 = `/${subRelativeId.replace(/-/g, "_").toLowerCase()}/`;
-        const hasSubsystemSegmentMatch = subRelativeId.split(/[-_]/).some((seg) => seg.length >= 3 && normalizedPath.includes(`/${seg.toLowerCase()}/`));
-        const hasSubsystemMatch = normalizedPath.includes(subPattern1) || normalizedPath.includes(subPattern2) || hasSubsystemSegmentMatch;
-        if (hasSubsystemMatch) {
-          score += 10;
-        }
-        let belongsToOtherSubsystem = false;
-        for (const otherSub of subsystems) {
-          if (otherSub.id === comp.subsystem) continue;
-          const otherSubRelativeId = otherSub.id.split("::").pop() || otherSub.id;
-          const otherPattern1 = `/${otherSubRelativeId.toLowerCase()}/`;
-          const otherPattern2 = `/${otherSubRelativeId.replace(/-/g, "_").toLowerCase()}/`;
-          const otherSegmentMatch = otherSubRelativeId.split(/[-_]/).some((seg) => seg.length >= 3 && normalizedPath.includes(`/${seg.toLowerCase()}/`));
-          if (normalizedPath.includes(otherPattern1) || normalizedPath.includes(otherPattern2) || otherSegmentMatch) {
-            belongsToOtherSubsystem = true;
-            break;
-          }
-        }
-        if (belongsToOtherSubsystem) {
-          continue;
-        }
-        const isCleanNameMatch = base === cleanName.toLowerCase() || base === cleanName.replace(/-/g, "_").toLowerCase();
-        if (isCleanNameMatch) {
-          score += 5;
-        }
-        const isIdMatch = base === compRelativeId.toLowerCase() || base === compRelativeId.replace(/-/g, "_").toLowerCase();
-        if (isIdMatch) {
-          score += 3;
-        }
-        const isSpecificNameMatch = isCleanNameMatch && cleanName.toLowerCase() !== comp.componentType.toLowerCase();
-        if (!hasSubsystemMatch && !isSpecificNameMatch && !isIdMatch) {
-          continue;
-        }
-        if (normalizedPath.startsWith("src/") || normalizedPath.includes("/src/") || normalizedPath.startsWith("legacy-src/") || normalizedPath.includes("/legacy-src/")) {
-          score += 2;
-        }
-        if (base === comp.componentType.toLowerCase()) {
-          score += 1;
-        }
-        if (score > bestScore) {
-          bestScore = score;
-          bestFile = f;
-        }
-      }
+  }
+  throw new TemplateNotFoundError(id);
+}
+function loadAgentOverride(agentId) {
+  const filePath = path18.join(AI_PATHS.root(), "agents", `${agentId}.md`);
+  return readFileOrNull(filePath);
+}
+function listTemplateIds(globalOverride) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const dir of templateSearchDirs(globalOverride)) {
+    for (const file of listFiles(dir, ".yaml")) {
+      seen.add(path18.basename(file, ".yaml"));
     }
-    return bestFile;
-  } catch {
-    return null;
   }
+  return Array.from(seen).sort();
 }
-function summarize(text, max = 140) {
-  const clean = text.replace(/\s+/g, " ").trim();
-  const period = clean.indexOf(". ");
-  const firstSentence = period > 0 ? clean.slice(0, period + 1) : clean;
-  if (firstSentence.length <= max) return firstSentence;
-  return `${firstSentence.slice(0, max - 1).trimEnd()}\u2026`;
+function templateSearchDirs(globalOverride) {
+  return [
+    AI_PATHS.templatesDir(),
+    // 1. project-local
+    globalTemplatesDir(globalOverride),
+    // 2. global user/org
+    builtinTemplatesDir()
+    // 3. built-in fallback
+  ];
 }
-function buildVariantGuidance(comps, allComponents, variantsById) {
-  return composeVariantGuidance(comps, allComponents, variantsById);
+function renderTemplateInstructions(template, vars) {
+  return template.instructions.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+    return key in vars ? vars[key] : `{{${key}}}`;
+  });
 }
-function resolveAgentTopology() {
-  projectFilesCache.clear();
-  const system = loadSystemSpec();
-  if (!system) return [];
-  const isLocal = (id) => !id.includes("::");
-  const subsystems = loadSubsystemSpecs().filter((s) => isLocal(s.id));
-  const components = loadComponentSpecs().filter((c) => isLocal(c.id) && isLocal(c.subsystem));
-  const interfaces = loadInterfaceSpecs();
-  const implementations = loadImplementationSpecs();
-  const variantsById = new Map(loadProjectVariants().map((v) => [v.id, v]));
-  const config = projectConfigRepository.load();
-  if (!config) throw new ProjectNotInitializedError();
-  const activeTargets = config.targets.filter((t) => !("enabled" in t) || t.enabled).map((t) => typeof t === "string" ? t : t.type);
-  const agents = [];
-  agents.push({
-    id: "system-architect",
-    name: `${system.name} Architect`,
-    description: `Global architect for ${system.name} \u2014 owns the spec tree and topology. ${summarize(system.vision)}`,
-    template: "architect",
-    creationReason: "Automatically inferred from L0 system spec",
-    ownedPaths: [".wai/specs/**"],
-    readPaths: ["**"],
-    writePaths: [".wai/specs/**"],
-    tags: ["architect", "global", "sdd"],
-    dependencies: subsystems.map((s) => `${s.id}-owner`),
-    status: "active",
-    targets: activeTargets,
-    createdAt: system.createdAt,
-    updatedAt: system.updatedAt
-  });
-  for (const sub of subsystems) {
-    if (sub.projectPath) {
-      const mountSpecPath = path17.relative(getProjectRoot(), getSubsystemPath(sub.id)).replace(/\\/g, "/");
-      agents.push({
-        id: `${sub.id}-owner`,
-        name: `${sub.name} (chained subproject)`,
-        description: `Delegates into the "${sub.id}" chained subproject at ${sub.projectPath}. Its own agents live in that subproject's .wai \u2014 run \`wairon generate\` there (or spawn from ${sub.projectPath}/.claude/agents). Do not implement its internals from this layer.`,
-        template: "domain-owner",
-        creationReason: `Automatically inferred from a chained subproject subsystem: ${sub.id}`,
-        domainRoot: sub.id,
-        ownedPaths: [mountSpecPath],
-        readPaths: ["**"],
-        writePaths: [mountSpecPath],
-        tags: ["owner", "subproject", "delegate", "sdd"],
-        dependencies: [],
-        status: "active",
-        targets: activeTargets,
-        createdAt: sub.createdAt,
-        updatedAt: sub.updatedAt
-      });
-      continue;
-    }
-    const subComponents = components.filter((c) => c.subsystem === sub.id);
-    const ownedPaths = [];
-    ownedPaths.push(path17.relative(getProjectRoot(), getSubsystemPath(sub.id)).replace(/\\/g, "/"));
-    for (const c of subComponents) {
-      ownedPaths.push(path17.relative(getProjectRoot(), getComponentPath(c.id, sub.id)).replace(/\\/g, "/"));
-    }
-    if (!config.rules.generateComponentImplementers) {
-      for (const comp of subComponents) {
-        const compInterfaces = interfaces.filter((i) => i.component === comp.id);
-        const compInterfaceIds = compInterfaces.map((i) => i.id);
-        const compImpls = implementations.filter((impl) => compInterfaceIds.includes(impl.contract));
-        let hasExplicitSource = false;
-        for (const impl of compImpls) {
-          const files = implementationSourceFiles(impl);
-          if (files.length > 0) hasExplicitSource = true;
-          for (const file of files) {
-            if (!ownedPaths.includes(file)) ownedPaths.push(file);
-          }
-        }
-        if (!hasExplicitSource) {
-          const inferred = inferSourcePathForComponent(comp, subsystems);
-          if (inferred && !ownedPaths.includes(inferred)) {
-            ownedPaths.push(inferred);
-          }
-        }
-      }
-    }
-    let dependencies = [];
-    if (config.rules.generateComponentImplementers) {
-      dependencies = subComponents.map((c) => `${c.id}-implementer`);
-    } else {
-      const depSubsystems = /* @__PURE__ */ new Set();
-      for (const c of subComponents) {
-        for (const depId of c.dependsOn) {
-          const depComp = components.find((other) => other.id === depId);
-          if (depComp && depComp.subsystem !== sub.id) {
-            depSubsystems.add(`${depComp.subsystem}-owner`);
-          }
-        }
-      }
-      dependencies = Array.from(depSubsystems);
-    }
-    agents.push({
-      id: `${sub.id}-owner`,
-      name: `${sub.name} Owner`,
-      description: `Owns the ${sub.id} subsystem. ${summarize(sub.description)}`,
-      template: "domain-owner",
-      creationReason: `Automatically inferred from L1 subsystem spec: ${sub.id}`,
-      domainRoot: sub.id,
-      ownedPaths,
-      readPaths: ["**"],
-      writePaths: ownedPaths,
-      tags: ["owner", "domain", "sdd"],
-      dependencies,
-      variantGuidance: buildVariantGuidance(subComponents, components, variantsById),
-      status: "active",
-      targets: activeTargets,
-      createdAt: sub.createdAt,
-      updatedAt: sub.updatedAt
-    });
-  }
-  if (config.rules.generateComponentImplementers) {
-    for (const comp of components) {
-      const compInterfaces = interfaces.filter((i) => i.component === comp.id);
-      const compInterfaceIds = compInterfaces.map((i) => i.id);
-      const compImpls = implementations.filter((impl) => compInterfaceIds.includes(impl.contract));
-      const ownedPaths = [];
-      for (const impl of compImpls) {
-        for (const file of implementationSourceFiles(impl)) {
-          if (!ownedPaths.includes(file)) ownedPaths.push(file);
-        }
-      }
-      if (ownedPaths.length === 0) {
-        const inferred = inferSourcePathForComponent(comp, subsystems);
-        if (inferred) {
-          ownedPaths.push(inferred);
-        }
-      }
-      const dependencies = comp.dependsOn.map((depId) => `${depId}-implementer`);
-      const readPaths = [
-        path17.relative(getProjectRoot(), AI_PATHS.specsSystem()).replace(/\\/g, "/"),
-        path17.relative(getProjectRoot(), getComponentPath(comp.id, comp.subsystem)).replace(/\\/g, "/"),
-        ...compInterfaces.map((i) => path17.relative(getProjectRoot(), getInterfacePath(i.id, comp.id)).replace(/\\/g, "/")),
-        ...compImpls.map((impl) => path17.relative(getProjectRoot(), getImplementationPath(impl.id, impl.contract)).replace(/\\/g, "/"))
-      ];
-      agents.push({
-        id: `${comp.id}-implementer`,
-        name: `${comp.name} Implementer`,
-        description: `Developer agent implementing ${comp.name} (${comp.componentType})`,
-        template: "implementer",
-        creationReason: `Automatically inferred from L2 component spec: ${comp.id}`,
-        domainRoot: comp.subsystem,
-        ownedPaths,
-        readPaths,
-        writePaths: ownedPaths,
-        tags: ["implementer", "component", "sdd", comp.componentType.toLowerCase()],
-        dependencies,
-        variantGuidance: buildVariantGuidance([comp], components, variantsById),
-        status: "active",
-        targets: activeTargets,
-        createdAt: comp.createdAt,
-        updatedAt: comp.updatedAt
-      });
-    }
-  }
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  for (const dom of loadTopologyConfig().domains) {
-    agents.push({
-      id: `${dom.id}-owner`,
-      name: `${dom.name ?? dom.id} Owner`,
-      description: dom.description ? summarize(dom.description) : `Owner agent for the free-standing "${dom.id}" domain.`,
-      template: "domain-owner",
-      creationReason: "Inferred from a free-standing domain in .wai/topology.yaml",
-      domainRoot: dom.id,
-      ownedPaths: dom.ownedPaths,
-      readPaths: ["**"],
-      writePaths: dom.ownedPaths,
-      tags: ["owner", "domain"],
-      dependencies: [],
-      status: "active",
-      targets: activeTargets,
-      createdAt: now,
-      updatedAt: now
-    });
-  }
-  return agents;
-}
-function composeAgentBrief(agentId) {
-  const records = resolveAgentTopology();
-  const record = records.find((r) => r.id === agentId);
-  if (!record) {
-    throw new UnknownAgentError(agentId, records.map((r) => r.id));
-  }
-  const config = projectConfigRepository.load();
-  if (!config) throw new ProjectNotInitializedError();
-  const template = loadTemplate(record.template, config.globalTemplatesDir);
-  let instructions = renderTemplateInstructions(template, {
-    agentId: record.id,
-    agentName: record.name,
-    agentDescription: record.description,
-    ownedPaths: record.ownedPaths.join("\n"),
-    tags: record.tags.join(", "),
-    renderContext: "root",
-    contextNote: "",
-    domainPath: ".",
-    domainName: "",
-    variantGuidance: record.variantGuidance ?? ""
-  });
-  const guidance = loadAgentOverride(agentId);
-  if (guidance !== null) {
-    instructions = `${instructions.trimEnd()}
-
-## Project guidance
-
-${guidance.trim()}
-`;
-  }
-  const profile = deriveExecutionProfile(record);
-  const budget = resolveBudget(profile, config.execution, record.id);
-  return {
-    agentId: record.id,
-    name: record.name,
-    template: record.template,
-    domainRoot: record.domainRoot,
-    ownedPaths: record.ownedPaths,
-    readPaths: record.readPaths,
-    instructions,
-    variantGuidance: record.variantGuidance || void 0,
-    profile: budget ? profile : void 0,
-    budget
-  };
-}
-var path17, fs13, projectFilesCache, UnknownAgentError;
-var init_agent_resolver = __esm({
-  "src/core/agent_resolver.ts"() {
-    "use strict";
-    path17 = __toESM(require("path"));
-    fs13 = __toESM(require("fs"));
-    init_loader();
-    init_project_config();
-    init_fs();
-    init_errors();
-    init_templates();
-    init_execution_profile();
-    init_budget_policy();
-    init_specs2();
-    init_specs();
-    init_variants();
-    projectFilesCache = /* @__PURE__ */ new Map();
-    UnknownAgentError = class extends WaironError {
-      constructor(agentId, knownIds) {
-        super(`Unknown agent id: "${agentId}". Known agent ids: ${knownIds.join(", ")}`);
-        this.name = "UnknownAgentError";
-      }
-    };
-  }
-});
-
-// src/config/loader.ts
-function aiPathsAt(rootDir) {
-  const resolvedRoot = path18.resolve(rootDir);
-  const aiDirAt2 = (...segments) => {
-    const waiPath = path18.join(resolvedRoot, ".wai");
-    const waironPath = path18.join(resolvedRoot, ".wairon");
-    const base = !fs14.existsSync(waiPath) && fs14.existsSync(waironPath) ? waironPath : waiPath;
-    return path18.join(base, ...segments);
-  };
-  const specsDir = () => projectConfigRepositoryAt(resolvedRoot).specsDir();
-  return {
-    root: () => aiDirAt2(),
-    projectConfig: () => aiDirAt2("project.yaml"),
-    topologyConfig: () => aiDirAt2("topology.yaml"),
-    templatesDir: () => aiDirAt2("templates"),
-    rulesDir: () => aiDirAt2("rules"),
-    docsDir: () => aiDirAt2("docs"),
-    generatedDir: () => aiDirAt2("generated"),
-    contextDir: () => aiDirAt2("context"),
-    contextProjectMd: () => aiDirAt2("context", "project.md"),
-    contextArchitectureMd: () => aiDirAt2("context", "architecture.md"),
-    contextDomainsMd: () => aiDirAt2("context", "domains.md"),
-    contextWaironGuideMd: () => aiDirAt2("context", "wairon-guide.md"),
-    specsDir,
-    specsSystem: () => path18.join(specsDir(), ".index.yaml"),
-    specsSubsystemsDir: () => path18.join(specsDir(), "subsystems"),
-    specsComponentsDir: () => path18.join(specsDir(), "components"),
-    specsInterfacesDir: () => path18.join(specsDir(), "interfaces"),
-    specsImplementationsDir: () => path18.join(specsDir(), "implementations"),
-    specsTypesDir: () => path18.join(specsDir(), "types")
-  };
-}
-function isProjectInitialized() {
-  return projectConfigRepository.exists();
-}
-function assertProjectInitialized() {
-  if (!isProjectInitialized()) {
-    throw new ProjectNotInitializedError();
-  }
-}
-function loadRegistry() {
-  assertProjectInitialized();
-  if (!pathExists(AI_PATHS.specsSystem())) return createEmptyRegistry();
-  const { resolveAgentTopology: resolveAgentTopology2 } = (init_agent_resolver(), __toCommonJS(agent_resolver_exports));
-  return {
-    schemaVersion: "1.0.0",
-    agents: resolveAgentTopology2(),
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function loadTopologyConfig() {
-  assertProjectInitialized();
-  if (!pathExists(AI_PATHS.topologyConfig())) return createEmptyTopologyConfig();
-  const raw = readYamlFile(AI_PATHS.topologyConfig());
-  if (!raw) return createEmptyTopologyConfig();
-  return TopologyConfigSchema.parse(raw);
-}
-function saveTopologyConfig(config) {
-  writeYamlFile(AI_PATHS.topologyConfig(), config);
-}
-var fs14, path18, AI_PATHS;
-var init_loader = __esm({
-  "src/config/loader.ts"() {
-    "use strict";
-    fs14 = __toESM(require("fs"));
-    path18 = __toESM(require("path"));
-    init_fs();
-    init_yaml();
-    init_errors();
-    init_models();
-    init_project_config();
-    AI_PATHS = {
-      root: () => aiPathsAt(getProjectRoot()).root(),
-      projectConfig: () => aiPathsAt(getProjectRoot()).projectConfig(),
-      topologyConfig: () => aiPathsAt(getProjectRoot()).topologyConfig(),
-      templatesDir: () => aiPathsAt(getProjectRoot()).templatesDir(),
-      rulesDir: () => aiPathsAt(getProjectRoot()).rulesDir(),
-      docsDir: () => aiPathsAt(getProjectRoot()).docsDir(),
-      generatedDir: () => aiPathsAt(getProjectRoot()).generatedDir(),
-      contextDir: () => aiPathsAt(getProjectRoot()).contextDir(),
-      contextProjectMd: () => aiPathsAt(getProjectRoot()).contextProjectMd(),
-      contextArchitectureMd: () => aiPathsAt(getProjectRoot()).contextArchitectureMd(),
-      contextDomainsMd: () => aiPathsAt(getProjectRoot()).contextDomainsMd(),
-      contextWaironGuideMd: () => aiPathsAt(getProjectRoot()).contextWaironGuideMd(),
-      specsDir: () => aiPathsAt(getProjectRoot()).specsDir(),
-      specsSystem: () => aiPathsAt(getProjectRoot()).specsSystem(),
-      specsSubsystemsDir: () => aiPathsAt(getProjectRoot()).specsSubsystemsDir(),
-      specsComponentsDir: () => aiPathsAt(getProjectRoot()).specsComponentsDir(),
-      specsInterfacesDir: () => aiPathsAt(getProjectRoot()).specsInterfacesDir(),
-      specsImplementationsDir: () => aiPathsAt(getProjectRoot()).specsImplementationsDir(),
-      specsTypesDir: () => aiPathsAt(getProjectRoot()).specsTypesDir()
-    };
-  }
-});
-
-// src/core/domains.ts
-var domains_exports = {};
-__export(domains_exports, {
-  addFreeStandingDomain: () => addFreeStandingDomain,
-  deriveSubsystemDomains: () => deriveSubsystemDomains,
-  findDomain: () => findDomain,
-  listFreeStandingDomains: () => listFreeStandingDomains,
-  removeFreeStandingDomain: () => removeFreeStandingDomain,
-  resolveDomains: () => resolveDomains
-});
-function rel(p) {
-  return path19.relative(process.cwd(), p).replace(/\\/g, "/");
-}
-function deriveSubsystemDomains() {
-  const subsystems = loadSubsystemSpecs();
-  const components = loadComponentSpecs();
-  return subsystems.map((sub) => {
-    const ownedPaths = [
-      rel(getSubsystemPath(sub.id)),
-      ...components.filter((c) => c.subsystem === sub.id).map((c) => rel(getComponentPath(c.id, sub.id)))
-    ];
-    return {
-      id: sub.id,
-      name: sub.name,
-      description: sub.description,
-      boundTo: sub.id,
-      ownedPaths
-    };
-  });
-}
-function listFreeStandingDomains() {
-  return loadTopologyConfig().domains;
-}
-function resolveDomains() {
-  return [...deriveSubsystemDomains(), ...listFreeStandingDomains()];
-}
-function findDomain(id) {
-  return resolveDomains().find((d) => d.id === id);
-}
-function addFreeStandingDomain(domain) {
-  const config = loadTopologyConfig();
-  if (config.domains.some((d) => d.id === domain.id)) {
-    throw new WaironError(`A free-standing domain "${domain.id}" already exists in .wai/topology.yaml.`);
-  }
-  if (deriveSubsystemDomains().some((d) => d.id === domain.id)) {
-    throw new WaironError(`Domain id "${domain.id}" collides with a subsystem-derived domain.`);
-  }
-  config.domains.push(domain);
-  saveTopologyConfig(config);
-}
-function removeFreeStandingDomain(id) {
-  const config = loadTopologyConfig();
-  const idx = config.domains.findIndex((d) => d.id === id);
-  if (idx === -1) {
-    throw new WaironError(
-      `"${id}" is not a free-standing domain. Subsystem-backed domains are derived from the spec tree and cannot be removed here.`
-    );
-  }
-  config.domains.splice(idx, 1);
-  saveTopologyConfig(config);
+function parseTemplate(yamlContent) {
+  return TemplateSchema.parse(parseYaml(yamlContent));
 }
-var path19;
-var init_domains = __esm({
-  "src/core/domains.ts"() {
+var path18;
+var init_templates = __esm({
+  "src/core/templates.ts"() {
     "use strict";
-    path19 = __toESM(require("path"));
-    init_loader();
-    init_specs2();
+    path18 = __toESM(require("path"));
+    init_fs();
+    init_yaml();
     init_errors();
+    init_template();
+    init_paths();
+    init_defaults();
   }
 });
 
@@ -22795,7 +22256,7 @@ function provisionProject(name) {
 function ensureProjectInitialized(fallbackName) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const paths = aiPathsAt(getProjectRoot());
-  const hasSystem = fs15.existsSync(paths.specsSystem());
+  const hasSystem = fs14.existsSync(paths.specsSystem());
   let name = fallbackName;
   if (hasSystem) {
     const existing = loadSystemSpec();
@@ -22817,11 +22278,11 @@ function ensureProjectInitialized(fallbackName) {
 function walkChainedSubprojects(projectRoot, onChild) {
   const visited = /* @__PURE__ */ new Set();
   const walk2 = (dir) => {
-    const resolved = path20.resolve(dir);
+    const resolved = path19.resolve(dir);
     if (visited.has(resolved)) return;
     visited.add(resolved);
     const specsDir = aiPathsAt(dir).specsDir();
-    if (!fs15.existsSync(specsDir)) return;
+    if (!fs14.existsSync(specsDir)) return;
     for (const file of listFilesRecursive(specsDir, ".yaml")) {
       let raw;
       try {
@@ -22839,497 +22300,1040 @@ function walkChainedSubprojects(projectRoot, onChild) {
         continue;
       }
       const id = raw.id;
-      onChild(childDir, typeof id === "string" ? id : path20.basename(childDir));
+      onChild(childDir, typeof id === "string" ? id : path19.basename(childDir));
       walk2(childDir);
     }
-  };
-  walk2(projectRoot);
+  };
+  walk2(projectRoot);
+}
+function listDirectChainedSubprojects(projectRoot) {
+  const out = [];
+  const specsDir = aiPathsAt(projectRoot).specsDir();
+  if (!fs14.existsSync(specsDir)) return out;
+  for (const file of listFilesRecursive(specsDir, ".yaml")) {
+    let raw;
+    try {
+      raw = readYamlFile(file);
+    } catch {
+      continue;
+    }
+    if (!(raw && typeof raw === "object" && "parentSystem" in raw)) continue;
+    const pp = raw.projectPath;
+    if (typeof pp !== "string" || pp.trim() === "") continue;
+    let dir;
+    try {
+      dir = assertContainedProjectPath(projectRoot, pp);
+    } catch {
+      continue;
+    }
+    const id = raw.id;
+    out.push({ dir, subsystemId: typeof id === "string" ? id : path19.basename(dir) });
+  }
+  return out;
+}
+function childHasSpecsButNoConfig(childDir) {
+  return fs14.existsSync(aiPathsAt(childDir).specsDir()) && !projectConfigRepositoryAt(childDir).exists();
+}
+function findChainingSubprojectsMissingConfig(projectRoot) {
+  const missing = [];
+  walkChainedSubprojects(projectRoot, (childDir) => {
+    if (childHasSpecsButNoConfig(childDir)) missing.push(childDir);
+  });
+  return missing;
+}
+function backfillChainedSubprojectConfigs(projectRoot) {
+  const backfilled = [];
+  walkChainedSubprojects(projectRoot, (childDir, subsystemId) => {
+    if (childHasSpecsButNoConfig(childDir)) {
+      runWithProjectRoot(childDir, () => {
+        ensureProjectInitialized(subsystemId);
+      });
+      backfilled.push(childDir);
+    }
+  });
+  return backfilled;
+}
+function createChainedSubsystem(subsystem, projectName) {
+  if (!subsystem.projectPath || subsystem.projectPath.trim() === "") {
+    throw new WaironError("projectPath is required to create a chained subsystem.");
+  }
+  const projectPath = toPosixPath(subsystem.projectPath);
+  saveSubsystemSpec({ ...subsystem, projectPath });
+  const childDir = assertContainedProjectPath(getProjectRoot(), projectPath);
+  runWithProjectRoot(childDir, () => {
+    ensureDir(aiPathsAt(childDir).specsDir());
+    ensureProjectInitialized(projectName);
+  });
+  invalidateSpecCache();
+}
+function moveSubsystemProject(subsystemId, newProjectPath) {
+  const sub = loadSubsystemSpec(subsystemId);
+  if (!sub) {
+    throw new WaironError(`Subsystem "${subsystemId}" does not exist.`);
+  }
+  if (!sub.projectPath || sub.projectPath.trim() === "") {
+    throw new WaironError(
+      `Subsystem "${subsystemId}" has no projectPath to move (not an external subproject).`
+    );
+  }
+  const nextPath = toPosixPath(newProjectPath);
+  const root = getProjectRoot();
+  const oldDir = assertContainedProjectPath(root, sub.projectPath);
+  const newDir = assertContainedProjectPath(root, nextPath);
+  if (oldDir !== newDir) {
+    if (!fs14.existsSync(oldDir)) {
+      throw new WaironError(`Subproject directory not found at its current path: ${oldDir}`);
+    }
+    if (fs14.existsSync(newDir)) {
+      throw new WaironError(`Target directory already exists: ${newDir}`);
+    }
+    ensureDir(path19.dirname(newDir));
+    fs14.renameSync(oldDir, newDir);
+  }
+  saveSubsystemSpec({ ...sub, projectPath: nextPath, updatedAt: (/* @__PURE__ */ new Date()).toISOString() });
+  invalidateSpecCache();
+}
+function toPosixPath(p) {
+  return p.replace(/\\/g, "/");
+}
+function isWithinDir(dir, file) {
+  const d = path19.resolve(dir);
+  const f = path19.resolve(file);
+  return f === d || f.startsWith(d + path19.sep);
+}
+function externalizeSubsystem(subsystemId, projectPath) {
+  if (subsystemId.includes("::")) {
+    throw new WaironError("cannot externalize a nested/namespaced subsystem; run from its owning project.");
+  }
+  const foo = loadSubsystemSpec(subsystemId);
+  if (!foo || foo.projectPath) {
+    throw new WaironError(`cannot externalize: subsystem "${subsystemId}" is missing or already external.`);
+  }
+  const parentRoot = getProjectRoot();
+  const parentSpecsDir = aiPathsAt(parentRoot).specsDir();
+  const fooDir = path19.join(parentSpecsDir, subsystemId);
+  if (!fs14.existsSync(fooDir)) {
+    throw new WaironError(`subsystem specs directory not found: ${fooDir}`);
+  }
+  const relPath = toPosixPath(projectPath);
+  const childDir = assertContainedProjectPath(parentRoot, relPath);
+  const childFooDir = path19.join(childDir, ".wai", "specs", subsystemId);
+  if (fs14.existsSync(childFooDir)) {
+    throw new WaironError(`target already contains a "${subsystemId}" subsystem: ${childFooDir}`);
+  }
+  const renameMap = buildRenameMap(
+    subsystemId,
+    /* externalize */
+    true
+  );
+  const childSystemName = foo.name || subsystemId;
+  runWithProjectRoot(childDir, () => {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    projectConfigRepository.create(defaultProjectConfig(childSystemName, now));
+    ensureDir(path19.join(childDir, ".wai", "specs"));
+    saveSystemSpec(bootstrapSystemSpec(childSystemName, now));
+  });
+  ensureDir(path19.dirname(childFooDir));
+  fs14.renameSync(fooDir, childFooDir);
+  rebaseImplementationPaths(childFooDir, parentRoot, childDir);
+  patchSubsystemIndex(path19.join(childFooDir, ".index.yaml"), (s) => {
+    s.parentSystem = childSystemName;
+    delete s.projectPath;
+  });
+  ensureDir(fooDir);
+  writeYamlFile(path19.join(fooDir, ".index.yaml"), {
+    id: subsystemId,
+    name: foo.name,
+    description: foo.description,
+    parentSystem: foo.parentSystem,
+    publicInterfaces: [],
+    projectPath: relPath,
+    trustedLinks: [],
+    status: foo.status ?? "draft",
+    createdAt: foo.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  rewriteRefsInDir(parentSpecsDir, renameMap, fooDir);
+  rebaseMovedRefs(childFooDir, subsystemId, "into");
+  invalidateSpecCache();
+}
+function internalizeSubsystem(subsystemId) {
+  if (subsystemId.includes("::")) {
+    throw new WaironError("cannot internalize a nested/namespaced subsystem; run from its owning project.");
+  }
+  const foo = loadSubsystemSpec(subsystemId);
+  if (!foo || !foo.projectPath) {
+    throw new WaironError(`cannot internalize: subsystem "${subsystemId}" is missing or not external.`);
+  }
+  const parentRoot = getProjectRoot();
+  const parentSpecsDir = aiPathsAt(parentRoot).specsDir();
+  const childDir = assertContainedProjectPath(parentRoot, foo.projectPath);
+  const childWai = path19.join(childDir, ".wai");
+  const childFooDir = path19.join(childDir, ".wai", "specs", subsystemId);
+  if (!fs14.existsSync(childFooDir)) {
+    throw new WaironError(`external subproject missing subsystem "${subsystemId}": ${childFooDir}`);
+  }
+  const childOwnSubs = runWithProjectRoot(childDir, () => loadSubsystemSpecs()).filter((s) => !s.id.includes("::"));
+  if (childOwnSubs.length !== 1 || childOwnSubs[0].id !== subsystemId) {
+    throw new WaironError(`cannot internalize: subproject is a multi-subsystem system, not a flat "${subsystemId}".`);
+  }
+  const renameMap = buildRenameMap(
+    subsystemId,
+    /* externalize */
+    false
+  );
+  const parentSystemName = loadSystemSpec()?.name ?? foo.parentSystem;
+  const fooDir = path19.join(parentSpecsDir, subsystemId);
+  fs14.rmSync(fooDir, { recursive: true, force: true });
+  ensureDir(path19.dirname(fooDir));
+  fs14.renameSync(childFooDir, fooDir);
+  rebaseImplementationPaths(fooDir, childDir, parentRoot);
+  patchSubsystemIndex(path19.join(fooDir, ".index.yaml"), (s) => {
+    s.parentSystem = parentSystemName;
+    delete s.projectPath;
+  });
+  fs14.rmSync(childWai, { recursive: true, force: true });
+  rewriteRefsInDir(parentSpecsDir, renameMap, fooDir);
+  rebaseMovedRefs(fooDir, subsystemId, "outOf");
+  invalidateSpecCache();
+}
+function buildRenameMap(subsystemId, externalize) {
+  const map = /* @__PURE__ */ new Map();
+  const prefix = `${subsystemId}::`;
+  const add = (bare, namespaced) => externalize ? map.set(bare, namespaced) : map.set(namespaced, bare);
+  const comps = loadComponentSpecs().filter((c) => c.subsystem === subsystemId);
+  const compIds = new Set(comps.map((c) => c.id));
+  for (const c of comps) {
+    const bare = c.id.startsWith(prefix) ? c.id.slice(prefix.length) : c.id;
+    add(bare, `${prefix}${bare}`);
+  }
+  for (const i of loadInterfaceSpecs()) {
+    if (!compIds.has(i.component)) continue;
+    const bare = i.id.startsWith(prefix) ? i.id.slice(prefix.length) : i.id;
+    add(bare, `${prefix}${bare}`);
+  }
+  for (const t of loadTypeSpecs()) {
+    if (t.subsystem !== subsystemId) continue;
+    const bare = t.id.startsWith(prefix) ? t.id.slice(prefix.length) : t.id;
+    add(bare, `${prefix}${bare}`);
+  }
+  return map;
+}
+function rewriteRefsInDir(specsDir, renameMap, excludeDir) {
+  if (renameMap.size === 0) return;
+  rewriteRefFields(specsDir, (ref) => renameMap.get(ref) ?? ref, excludeDir);
+}
+function rebaseMovedRefs(movedDir, mount, direction) {
+  const declared = componentIdsUnder(movedDir);
+  rewriteRefFields(movedDir, (ref, position) => position === "component" ? rebaseReference(ref, mount, direction, (id) => declared.has(id)) : ref);
+}
+function componentIdsUnder(dir) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const file of listFilesRecursive(dir, ".yaml")) {
+    let raw;
+    try {
+      raw = readYamlFile(file);
+    } catch {
+      continue;
+    }
+    if (raw && typeof raw === "object" && "componentType" in raw && typeof raw.id === "string") ids.add(raw.id);
+  }
+  return ids;
 }
-function listDirectChainedSubprojects(projectRoot) {
-  const out = [];
-  const specsDir = aiPathsAt(projectRoot).specsDir();
-  if (!fs15.existsSync(specsDir)) return out;
+function rewriteRefFields(specsDir, remap, excludeDir) {
+  const rewritten = [];
   for (const file of listFilesRecursive(specsDir, ".yaml")) {
+    if (excludeDir && isWithinDir(excludeDir, file)) continue;
     let raw;
     try {
       raw = readYamlFile(file);
     } catch {
       continue;
     }
-    if (!(raw && typeof raw === "object" && "parentSystem" in raw)) continue;
-    const pp = raw.projectPath;
-    if (typeof pp !== "string" || pp.trim() === "") continue;
-    let dir;
+    if (!raw || typeof raw !== "object") continue;
+    const kind = specKind(raw);
+    if (!rewriteSpecRefs(raw, remap) || !kind) continue;
+    writeYamlFile(file, raw);
+    rewritten.push({ kind, id: kind === "system" ? "system" : String(raw.id) });
+  }
+  return rewritten;
+}
+function rebaseImplementationPaths(specsDir, fromRoot, toRoot) {
+  for (const file of listFilesRecursive(specsDir, ".yaml")) {
+    let raw;
     try {
-      dir = assertContainedProjectPath(projectRoot, pp);
+      raw = readYamlFile(file);
     } catch {
       continue;
     }
-    const id = raw.id;
-    out.push({ dir, subsystemId: typeof id === "string" ? id : path20.basename(dir) });
+    if (!raw || typeof raw !== "object" || !("contract" in raw)) continue;
+    let changed = false;
+    const rebase = (holder, key) => {
+      const p = holder[key];
+      if (typeof p !== "string" || p === "" || path19.isAbsolute(p)) return;
+      const next = toPosixPath(path19.relative(toRoot, path19.resolve(fromRoot, p)));
+      if (next !== p) {
+        holder[key] = next;
+        changed = true;
+      }
+    };
+    for (const key of ["sourcePath", "simPath"]) rebase(raw, key);
+    if (Array.isArray(raw.methods)) {
+      for (const method of raw.methods) {
+        if (method && typeof method === "object") rebase(method, "sourcePath");
+      }
+    }
+    if (changed) writeYamlFile(file, raw);
   }
-  return out;
-}
-function childHasSpecsButNoConfig(childDir) {
-  return fs15.existsSync(aiPathsAt(childDir).specsDir()) && !projectConfigRepositoryAt(childDir).exists();
 }
-function findChainingSubprojectsMissingConfig(projectRoot) {
-  const missing = [];
-  walkChainedSubprojects(projectRoot, (childDir) => {
-    if (childHasSpecsButNoConfig(childDir)) missing.push(childDir);
-  });
-  return missing;
+function patchSubsystemIndex(indexPath, mutate) {
+  if (!fs14.existsSync(indexPath)) return;
+  const raw = readYamlFile(indexPath);
+  mutate(raw);
+  raw.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  writeYamlFile(indexPath, raw);
 }
-function backfillChainedSubprojectConfigs(projectRoot) {
-  const backfilled = [];
-  walkChainedSubprojects(projectRoot, (childDir, subsystemId) => {
-    if (childHasSpecsButNoConfig(childDir)) {
-      runWithProjectRoot(childDir, () => {
-        ensureProjectInitialized(subsystemId);
-      });
-      backfilled.push(childDir);
+function renameComponent(componentId, newId) {
+  const component = loadComponentSpec(componentId);
+  if (!component) {
+    throw new WaironError(`component-missing: no component has the id "${componentId}".`);
+  }
+  if (componentId.includes("::")) {
+    throw new WaironError(
+      `chained-component: "${componentId}" lives in a chained subproject; rename it from that project's own root.`
+    );
+  }
+  if (!SpecIdSchema.safeParse(newId).success) {
+    throw new WaironError(`invalid-id: "${newId}" is not a lowercase identifier with no namespace separator.`);
+  }
+  const components = loadComponentSpecs();
+  const interfaces = loadInterfaceSpecs();
+  const implementations = loadImplementationSpecs();
+  const interfaceId = `i${newId}`;
+  const implementationId = `${newId}_impl`;
+  const taken = [
+    components.some((c) => c.id === newId) ? `component "${newId}"` : null,
+    interfaces.some((i) => i.id === interfaceId) ? `interface "${interfaceId}"` : null,
+    implementations.some((impl) => impl.id === implementationId) ? `implementation "${implementationId}"` : null
+  ].filter((holder) => holder !== null);
+  if (taken.length > 0) {
+    throw new WaironError(`id-taken: the new id, or an id it implies, is already in use: ${taken.join(", ")}.`);
+  }
+  const contracts = interfaces.filter((i) => i.component === componentId);
+  const movingInterface = contracts.find((i) => i.id === `i${componentId}`);
+  const movingImplementation = implementations.find((impl) => impl.id === `${componentId}_impl` && contracts.some((i) => i.id === impl.contract));
+  const renamed = [
+    { kind: "component", from: componentId, to: newId },
+    ...movingInterface ? [{ kind: "interface", from: movingInterface.id, to: interfaceId }] : [],
+    ...movingImplementation ? [{ kind: "implementation", from: movingImplementation.id, to: implementationId }] : []
+  ];
+  const rewritten = rewriteRefFields(aiPathsAt(getProjectRoot()).specsDir(), (ref, position) => {
+    if (position === "component" || position === "entity-class" || position === "auth-source") {
+      return ref === componentId ? newId : ref;
     }
-  });
-  return backfilled;
+    if (position === "interface" && ref === movingInterface?.id) return interfaceId;
+    return ref;
+  }).filter((spec) => !renamed.some((moved) => moved.kind === spec.kind && moved.from === spec.id)).map((spec) => spec.id);
+  invalidateSpecCache();
+  moveRenamedSpecs(componentId, newId, component, movingInterface, movingImplementation);
+  return { renamed, rewritten };
 }
-function createChainedSubsystem(subsystem, projectName) {
-  if (!subsystem.projectPath || subsystem.projectPath.trim() === "") {
-    throw new WaironError("projectPath is required to create a chained subsystem.");
+function moveRenamedSpecs(componentId, newId, component, movingInterface, movingImplementation) {
+  const interfaceId = `i${newId}`;
+  const implementationId = `${newId}_impl`;
+  const movedComponent = loadComponentSpec(componentId) ?? component;
+  const movedInterface = movingInterface ? loadInterfaceSpec(movingInterface.id) ?? movingInterface : null;
+  const movedImplementation = movingImplementation ? loadImplementationSpec(movingImplementation.id) ?? movingImplementation : null;
+  saveComponentSpec({ ...movedComponent, id: newId });
+  if (movedInterface) saveInterfaceSpec({ ...movedInterface, id: interfaceId, component: newId });
+  if (movedImplementation) {
+    const oldFile = getImplementationPath(movedImplementation.id);
+    if (path19.resolve(getImplementationPath(implementationId, movedImplementation.contract)) === path19.resolve(oldFile)) {
+      fs14.unlinkSync(oldFile);
+    }
+    saveImplementationSpec({ ...movedImplementation, id: implementationId });
   }
-  const projectPath = toPosixPath(subsystem.projectPath);
-  saveSubsystemSpec({ ...subsystem, projectPath });
-  const childDir = assertContainedProjectPath(getProjectRoot(), projectPath);
-  runWithProjectRoot(childDir, () => {
-    ensureDir(aiPathsAt(childDir).specsDir());
-    ensureProjectInitialized(projectName);
-  });
+  removeSpecFile2(getComponentPath(componentId), componentId);
+  if (movingInterface) removeSpecFile2(getInterfacePath(movingInterface.id), movingInterface.id);
+  if (movingImplementation) removeSpecFile2(getImplementationPath(movingImplementation.id), movingImplementation.id);
   invalidateSpecCache();
 }
-function moveSubsystemProject(subsystemId, newProjectPath) {
-  const sub = loadSubsystemSpec(subsystemId);
-  if (!sub) {
-    throw new WaironError(`Subsystem "${subsystemId}" does not exist.`);
+function removeSpecFile2(file, id) {
+  if (!fs14.existsSync(file)) return;
+  try {
+    if (readYamlFile(file)?.id !== id) return;
+  } catch {
+    return;
   }
-  if (!sub.projectPath || sub.projectPath.trim() === "") {
+  fs14.unlinkSync(file);
+  const specsRoot = path19.resolve(aiPathsAt(getProjectRoot()).specsDir());
+  for (let dir = path19.dirname(path19.resolve(file)); dir !== specsRoot && isWithinDir(specsRoot, dir); dir = path19.dirname(dir)) {
+    if (fs14.readdirSync(dir).length > 0) break;
+    fs14.rmdirSync(dir);
+  }
+}
+function renameMethod(componentId, methodName, newName, pinSymbol) {
+  const component = loadComponentSpec(componentId);
+  if (!component) {
+    throw new WaironError(`component-missing: no component has the id "${componentId}".`);
+  }
+  if (componentId.includes("::")) {
     throw new WaironError(
-      `Subsystem "${subsystemId}" has no projectPath to move (not an external subproject).`
+      `chained-component: "${componentId}" lives in a chained subproject; rename its method from that project's own root.`
     );
   }
-  const nextPath = toPosixPath(newProjectPath);
-  const root = getProjectRoot();
-  const oldDir = assertContainedProjectPath(root, sub.projectPath);
-  const newDir = assertContainedProjectPath(root, nextPath);
-  if (oldDir !== newDir) {
-    if (!fs15.existsSync(oldDir)) {
-      throw new WaironError(`Subproject directory not found at its current path: ${oldDir}`);
-    }
-    if (fs15.existsSync(newDir)) {
-      throw new WaironError(`Target directory already exists: ${newDir}`);
-    }
-    ensureDir(path20.dirname(newDir));
-    fs15.renameSync(oldDir, newDir);
+  if (!METHOD_NAME.test(newName)) {
+    throw new WaironError(`invalid-name: "${newName}" is not a camel-case identifier.`);
+  }
+  const contracts = loadInterfaceSpecs().filter((i) => i.component === componentId);
+  const moving = contracts.filter((i) => i.methods.some((m) => m.name === methodName));
+  if (moving.length === 0) {
+    throw new WaironError(`method-missing: no contract of "${componentId}" declares the method "${methodName}".`);
+  }
+  const taken = moving.filter((i) => i.methods.some((m) => m.name === newName)).map((i) => `"${i.id}"`);
+  if (taken.length > 0) {
+    throw new WaironError(`name-taken: ${taken.join(", ")} already declares a method under the name "${newName}".`);
+  }
+  const implementations = loadImplementationSpecs();
+  const movingContracts = new Set(moving.map((i) => i.id));
+  const renamed = [];
+  for (const contract of moving) {
+    saveInterfaceSpec({
+      ...contract,
+      methods: contract.methods.map((m) => m.name === methodName ? { ...m, name: newName, signature: renameInSignature(m.signature, methodName, newName) } : m)
+    });
+    renamed.push(contract.id);
+  }
+  let pinnedSymbol;
+  for (const implementation of implementations) {
+    if (!movingContracts.has(implementation.contract)) continue;
+    const realization = implementation.methods.find((m) => m.name === methodName);
+    if (!realization) continue;
+    const pin = realization.symbol === void 0 && pinSymbol !== false;
+    if (pin) pinnedSymbol = methodName;
+    saveImplementationSpec({
+      ...implementation,
+      methods: implementation.methods.map((m) => m.name === methodName ? { ...m, name: newName, ...pin ? { symbol: methodName } : {} } : m)
+    });
+    renamed.push(implementation.id);
+  }
+  invalidateSpecCache();
+  const specsDir = aiPathsAt(getProjectRoot()).specsDir();
+  const rewritten = rewriteRefFields(specsDir, (ref, position, owner) => position === "method" && owner === componentId && ref === methodName ? newName : ref).map((spec) => spec.id);
+  const mentions = collectMentions(specsDir, methodName, moving);
+  return {
+    component: componentId,
+    from: methodName,
+    to: newName,
+    renamed,
+    rewritten,
+    mentions,
+    ...pinnedSymbol ? { pinnedSymbol } : {}
+  };
+}
+function renameInSignature(signature, from, to) {
+  return signature.replace(identifierPattern(from), to);
+}
+function collectMentions(specsDir, methodName, moved) {
+  const mentions = /* @__PURE__ */ new Set();
+  for (const contract of moved) {
+    const wireBound = contract.methods.some((m) => {
+      const endpoint = m.endpoint;
+      return endpoint?.transport === "gRPC" && endpoint.method === methodName;
+    });
+    if (wireBound) mentions.add(contract.id);
+  }
+  const named = identifierPattern(methodName);
+  const namesMethod = (value) => {
+    if (Array.isArray(value)) return value.some(namesMethod);
+    if (!value || typeof value !== "object") return false;
+    return Object.entries(value).some(([key, nested]) => typeof nested === "string" ? PROSE_FIELDS2.has(key) && named.test(nested) : namesMethod(nested));
+  };
+  for (const file of listFilesRecursive(specsDir, ".yaml")) {
+    let raw;
+    try {
+      raw = readYamlFile(file);
+    } catch {
+      continue;
+    }
+    if (!raw || typeof raw !== "object") continue;
+    const kind = specKind(raw);
+    if (!kind || !namesMethod(raw)) continue;
+    mentions.add(kind === "system" ? "system" : String(raw.id));
+  }
+  return [...mentions];
+}
+function identifierPattern(methodName) {
+  return new RegExp(`(?<![A-Za-z0-9_])${methodName}(?![A-Za-z0-9_])`);
+}
+var fs14, path19, METHOD_NAME, PROSE_FIELDS2;
+var init_provision = __esm({
+  "src/core/provision.ts"() {
+    "use strict";
+    fs14 = __toESM(require("fs"));
+    path19 = __toESM(require("path"));
+    init_specs2();
+    init_paths();
+    init_project_config();
+    init_fs();
+    init_yaml();
+    init_errors();
+    init_models();
+    METHOD_NAME = /^[a-z][a-zA-Z0-9]*$/;
+    PROSE_FIELDS2 = /* @__PURE__ */ new Set([
+      "description",
+      "intent",
+      "summary",
+      "condition",
+      "over",
+      "outcome",
+      "error",
+      "note",
+      "caller"
+    ]);
+  }
+});
+
+// src/core/execution_profile.ts
+function isSweeping(p) {
+  return p === "**" || p === "**/*" || p.startsWith("**/");
+}
+function deriveBreadth(agent) {
+  if (agent.readPaths.some(isSweeping)) {
+    return MANAGER_TEMPLATES.has(agent.template) || READ_ONLY_TEMPLATES.has(agent.template) ? "wide" : "moderate";
   }
-  saveSubsystemSpec({ ...sub, projectPath: nextPath, updatedAt: (/* @__PURE__ */ new Date()).toISOString() });
-  invalidateSpecCache();
+  const owned = agent.ownedPaths.length;
+  if (owned >= WIDE_PATH_COUNT) return "wide";
+  if (owned >= MODERATE_PATH_COUNT) return "moderate";
+  return "narrow";
 }
-function toPosixPath(p) {
-  return p.replace(/\\/g, "/");
+function deriveReasoningDepth(agent) {
+  for (const tag of agent.tags) {
+    if (DEEP_STEREOTYPES.has(tag)) return "deep";
+    if (MECHANICAL_STEREOTYPES.has(tag)) return "mechanical";
+  }
+  if (MANAGER_TEMPLATES.has(agent.template)) return "deep";
+  if (agent.template === "reviewer") return "deep";
+  if (agent.template === "tester") return "standard";
+  return "standard";
 }
-function isWithinDir(dir, file) {
-  const d = path20.resolve(dir);
-  const f = path20.resolve(file);
-  return f === d || f.startsWith(d + path20.sep);
+function deriveWrites(agent) {
+  return !READ_ONLY_TEMPLATES.has(agent.template);
 }
-function externalizeSubsystem(subsystemId, projectPath) {
-  if (subsystemId.includes("::")) {
-    throw new WaironError("cannot externalize a nested/namespaced subsystem; run from its owning project.");
-  }
-  const foo = loadSubsystemSpec(subsystemId);
-  if (!foo || foo.projectPath) {
-    throw new WaironError(`cannot externalize: subsystem "${subsystemId}" is missing or already external.`);
-  }
-  const parentRoot = getProjectRoot();
-  const parentSpecsDir = aiPathsAt(parentRoot).specsDir();
-  const fooDir = path20.join(parentSpecsDir, subsystemId);
-  if (!fs15.existsSync(fooDir)) {
-    throw new WaironError(`subsystem specs directory not found: ${fooDir}`);
-  }
-  const relPath = toPosixPath(projectPath);
-  const childDir = assertContainedProjectPath(parentRoot, relPath);
-  const childFooDir = path20.join(childDir, ".wai", "specs", subsystemId);
-  if (fs15.existsSync(childFooDir)) {
-    throw new WaironError(`target already contains a "${subsystemId}" subsystem: ${childFooDir}`);
+function deriveExecutionProfile(agent) {
+  const breadth = deriveBreadth(agent);
+  const reasoningDepth = deriveReasoningDepth(agent);
+  const writes = deriveWrites(agent);
+  const delegates = MANAGER_TEMPLATES.has(agent.template);
+  const because = [];
+  if (delegates) {
+    because.push(`${agent.template} routes work rather than performing it`);
   }
-  const renameMap = buildRenameMap(
-    subsystemId,
-    /* externalize */
-    true
+  const stereotype = agent.tags.find(
+    (t) => MECHANICAL_STEREOTYPES.has(t) || DEEP_STEREOTYPES.has(t)
   );
-  const childSystemName = foo.name || subsystemId;
-  runWithProjectRoot(childDir, () => {
-    const now = (/* @__PURE__ */ new Date()).toISOString();
-    projectConfigRepository.create(defaultProjectConfig(childSystemName, now));
-    ensureDir(path20.join(childDir, ".wai", "specs"));
-    saveSystemSpec(bootstrapSystemSpec(childSystemName, now));
-  });
-  ensureDir(path20.dirname(childFooDir));
-  fs15.renameSync(fooDir, childFooDir);
-  rebaseImplementationPaths(childFooDir, parentRoot, childDir);
-  patchSubsystemIndex(path20.join(childFooDir, ".index.yaml"), (s) => {
-    s.parentSystem = childSystemName;
-    delete s.projectPath;
-  });
-  ensureDir(fooDir);
-  writeYamlFile(path20.join(fooDir, ".index.yaml"), {
-    id: subsystemId,
-    name: foo.name,
-    description: foo.description,
-    parentSystem: foo.parentSystem,
-    publicInterfaces: [],
-    projectPath: relPath,
-    trustedLinks: [],
-    status: foo.status ?? "draft",
-    createdAt: foo.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  });
-  rewriteRefsInDir(parentSpecsDir, renameMap, fooDir);
-  rebaseMovedRefs(childFooDir, subsystemId, "into");
-  invalidateSpecCache();
-}
-function internalizeSubsystem(subsystemId) {
-  if (subsystemId.includes("::")) {
-    throw new WaironError("cannot internalize a nested/namespaced subsystem; run from its owning project.");
-  }
-  const foo = loadSubsystemSpec(subsystemId);
-  if (!foo || !foo.projectPath) {
-    throw new WaironError(`cannot internalize: subsystem "${subsystemId}" is missing or not external.`);
-  }
-  const parentRoot = getProjectRoot();
-  const parentSpecsDir = aiPathsAt(parentRoot).specsDir();
-  const childDir = assertContainedProjectPath(parentRoot, foo.projectPath);
-  const childWai = path20.join(childDir, ".wai");
-  const childFooDir = path20.join(childDir, ".wai", "specs", subsystemId);
-  if (!fs15.existsSync(childFooDir)) {
-    throw new WaironError(`external subproject missing subsystem "${subsystemId}": ${childFooDir}`);
-  }
-  const childOwnSubs = runWithProjectRoot(childDir, () => loadSubsystemSpecs()).filter((s) => !s.id.includes("::"));
-  if (childOwnSubs.length !== 1 || childOwnSubs[0].id !== subsystemId) {
-    throw new WaironError(`cannot internalize: subproject is a multi-subsystem system, not a flat "${subsystemId}".`);
+  if (stereotype) {
+    because.push(
+      MECHANICAL_STEREOTYPES.has(stereotype) ? `${stereotype} work is specified by its contract and narrative` : `${stereotype} carries decision logic`
+    );
   }
-  const renameMap = buildRenameMap(
-    subsystemId,
-    /* externalize */
-    false
+  because.push(
+    breadth === "wide" ? "reads broadly across the tree" : breadth === "moderate" ? `spans ${agent.ownedPaths.length} owned path(s)` : "scoped to a small owned set"
   );
-  const parentSystemName = loadSystemSpec()?.name ?? foo.parentSystem;
-  const fooDir = path20.join(parentSpecsDir, subsystemId);
-  fs15.rmSync(fooDir, { recursive: true, force: true });
-  ensureDir(path20.dirname(fooDir));
-  fs15.renameSync(childFooDir, fooDir);
-  rebaseImplementationPaths(fooDir, childDir, parentRoot);
-  patchSubsystemIndex(path20.join(fooDir, ".index.yaml"), (s) => {
-    s.parentSystem = parentSystemName;
-    delete s.projectPath;
-  });
-  fs15.rmSync(childWai, { recursive: true, force: true });
-  rewriteRefsInDir(parentSpecsDir, renameMap, fooDir);
-  rebaseMovedRefs(fooDir, subsystemId, "outOf");
-  invalidateSpecCache();
+  if (!writes) because.push("read-only");
+  return {
+    breadth,
+    writes,
+    reasoningDepth,
+    delegates,
+    rationale: because.join("; ")
+  };
 }
-function buildRenameMap(subsystemId, externalize) {
-  const map = /* @__PURE__ */ new Map();
-  const prefix = `${subsystemId}::`;
-  const add = (bare, namespaced) => externalize ? map.set(bare, namespaced) : map.set(namespaced, bare);
-  const comps = loadComponentSpecs().filter((c) => c.subsystem === subsystemId);
-  const compIds = new Set(comps.map((c) => c.id));
-  for (const c of comps) {
-    const bare = c.id.startsWith(prefix) ? c.id.slice(prefix.length) : c.id;
-    add(bare, `${prefix}${bare}`);
+var MECHANICAL_STEREOTYPES, DEEP_STEREOTYPES, MANAGER_TEMPLATES, READ_ONLY_TEMPLATES, WIDE_PATH_COUNT, MODERATE_PATH_COUNT;
+var init_execution_profile = __esm({
+  "src/core/execution_profile.ts"() {
+    "use strict";
+    MECHANICAL_STEREOTYPES = /* @__PURE__ */ new Set(["store", "index", "registry", "adapter"]);
+    DEEP_STEREOTYPES = /* @__PURE__ */ new Set(["orchestrator", "supervisor", "specialist"]);
+    MANAGER_TEMPLATES = /* @__PURE__ */ new Set(["architect", "domain-owner"]);
+    READ_ONLY_TEMPLATES = /* @__PURE__ */ new Set(["reviewer", "guardian"]);
+    WIDE_PATH_COUNT = 12;
+    MODERATE_PATH_COUNT = 4;
   }
-  for (const i of loadInterfaceSpecs()) {
-    if (!compIds.has(i.component)) continue;
-    const bare = i.id.startsWith(prefix) ? i.id.slice(prefix.length) : i.id;
-    add(bare, `${prefix}${bare}`);
+});
+
+// src/core/budget_policy.ts
+function atLeast(tier, floor) {
+  return TIER_ORDER.indexOf(tier) >= TIER_ORDER.indexOf(floor);
+}
+function baseModelTier(profile) {
+  switch (profile.reasoningDepth) {
+    case "mechanical":
+      return "small";
+    case "standard":
+      return "standard";
+    case "deep":
+      return "large";
   }
-  for (const t of loadTypeSpecs()) {
-    if (t.subsystem !== subsystemId) continue;
-    const bare = t.id.startsWith(prefix) ? t.id.slice(prefix.length) : t.id;
-    add(bare, `${prefix}${bare}`);
+}
+function stepDown(tier, steps) {
+  const i = TIER_STEPS.indexOf(tier);
+  return TIER_STEPS[Math.max(0, i - steps)];
+}
+function maxTurnsFor(profile, tier) {
+  if (!atLeast(tier, "default")) return void 0;
+  const ceiling = profile.breadth === "wide" ? 60 : profile.breadth === "moderate" ? 40 : 25;
+  return atLeast(tier, "aggressive") ? Math.round(ceiling / 2) : ceiling;
+}
+function effortFor(profile, tier) {
+  if (!atLeast(tier, "trade")) return void 0;
+  if (profile.reasoningDepth === "mechanical") {
+    return atLeast(tier, "aggressive") ? "low" : "medium";
   }
-  return map;
+  return void 0;
 }
-function rewriteRefsInDir(specsDir, renameMap, excludeDir) {
-  if (renameMap.size === 0) return;
-  rewriteRefFields(specsDir, (ref) => renameMap.get(ref) ?? ref, excludeDir);
+function toolClassFor(profile) {
+  return profile.writes ? "implement" : "read-only";
 }
-function rebaseMovedRefs(movedDir, mount, direction) {
-  const declared = componentIdsUnder(movedDir);
-  rewriteRefFields(movedDir, (ref, position) => position === "component" ? rebaseReference(ref, mount, direction, (id) => declared.has(id)) : ref);
+function mcpFor(profile, tier) {
+  if (!atLeast(tier, "free")) return "all";
+  if (profile.delegates) return "project";
+  return profile.breadth === "wide" ? "project" : "none";
 }
-function componentIdsUnder(dir) {
-  const ids = /* @__PURE__ */ new Set();
-  for (const file of listFilesRecursive(dir, ".yaml")) {
-    let raw;
-    try {
-      raw = readYamlFile(file);
-    } catch {
-      continue;
+function resolveBudget(profile, config, agentId) {
+  const tier = config.tier;
+  if (tier === "off") return void 0;
+  let modelTier = baseModelTier(profile);
+  if (atLeast(tier, "trade") && profile.reasoningDepth === "standard") {
+    modelTier = stepDown(modelTier, 1);
+  }
+  if (atLeast(tier, "aggressive") && profile.reasoningDepth !== "deep") {
+    modelTier = "small";
+  }
+  const budget = {
+    // At `free` no model selection is expressed at all — that tier is defined
+    // as having no quality tradeoff, and choosing a model is a quality
+    // decision. Leaving it absent is not the same as choosing a default.
+    modelTier: atLeast(tier, "default") ? modelTier : void 0,
+    effort: effortFor(profile, tier),
+    maxTurns: maxTurnsFor(profile, tier),
+    toolClass: toolClassFor(profile),
+    // Only managers may spawn. Withholding the tool from workers is what stops
+    // a worker quietly becoming a second orchestrator three levels down.
+    allowNestedDelegation: profile.delegates,
+    mcp: mcpFor(profile, tier)
+  };
+  const override = config.overrides[agentId];
+  return override ? { ...budget, ...override } : budget;
+}
+var TIER_ORDER, TIER_STEPS;
+var init_budget_policy = __esm({
+  "src/core/budget_policy.ts"() {
+    "use strict";
+    TIER_ORDER = ["off", "free", "default", "trade", "aggressive"];
+    TIER_STEPS = ["small", "standard", "large", "frontier"];
+  }
+});
+
+// src/core/agent_resolver.ts
+function listFilesRecursiveSafe(dirPath, ext) {
+  if (!fs15.existsSync(dirPath)) return [];
+  const nameLower = path20.basename(dirPath).toLowerCase();
+  const IGNORED_DIRS = /* @__PURE__ */ new Set([
+    "node_modules",
+    "target",
+    "dist",
+    "build",
+    ".git",
+    ".wai",
+    ".claude",
+    ".gemini",
+    ".codex",
+    ".agents",
+    ".vscode"
+  ]);
+  if (IGNORED_DIRS.has(nameLower)) return [];
+  const entries = fs15.readdirSync(dirPath, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const fullPath = path20.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listFilesRecursiveSafe(fullPath, ext));
+    } else if (entry.isFile() && entry.name.endsWith(ext)) {
+      files.push(fullPath);
     }
-    if (raw && typeof raw === "object" && "componentType" in raw && typeof raw.id === "string") ids.add(raw.id);
   }
-  return ids;
+  return files;
 }
-function rewriteRefFields(specsDir, remap, excludeDir) {
-  const rewritten = [];
-  for (const file of listFilesRecursive(specsDir, ".yaml")) {
-    if (excludeDir && isWithinDir(excludeDir, file)) continue;
-    let raw;
-    try {
-      raw = readYamlFile(file);
-    } catch {
-      continue;
+function getProjectFiles(projectDir) {
+  let files = projectFilesCache.get(projectDir);
+  if (!files) {
+    files = [];
+    const srcDir = path20.join(projectDir, "src");
+    const legacySrcDir = path20.join(projectDir, "legacy-src");
+    let searchDir = projectDir;
+    if (pathExists(srcDir)) {
+      searchDir = srcDir;
+    } else if (pathExists(legacySrcDir)) {
+      searchDir = legacySrcDir;
+    } else if (projectDir === getProjectRoot()) {
+      projectFilesCache.set(projectDir, []);
+      return [];
     }
-    if (!raw || typeof raw !== "object") continue;
-    const kind = specKind(raw);
-    if (!rewriteSpecRefs(raw, remap) || !kind) continue;
-    writeYamlFile(file, raw);
-    rewritten.push({ kind, id: kind === "system" ? "system" : String(raw.id) });
+    const extensions = [".rs", ".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".c", ".cpp", ".cs", ".java", ".kt", ".swift", ".rb", ".php", ".lua"];
+    for (const ext of extensions) {
+      files.push(...listFilesRecursiveSafe(searchDir, ext));
+    }
+    const rootDir = getProjectRoot();
+    files = files.map((f) => path20.relative(rootDir, f).replace(/\\/g, "/"));
+    projectFilesCache.set(projectDir, files);
   }
-  return rewritten;
+  return files;
 }
-function rebaseImplementationPaths(specsDir, fromRoot, toRoot) {
-  for (const file of listFilesRecursive(specsDir, ".yaml")) {
-    let raw;
-    try {
-      raw = readYamlFile(file);
-    } catch {
-      continue;
+function inferSourcePathForComponent(comp, subsystems) {
+  try {
+    const projectDir = resolveSubprojectForNamespace(comp.subsystem) || getProjectRoot();
+    const files = getProjectFiles(projectDir);
+    if (files.length === 0) return null;
+    const compRelativeId = comp.id.split("::").pop() || comp.id;
+    const subRelativeId = comp.subsystem.split("::").pop() || comp.subsystem;
+    let cleanName = compRelativeId;
+    if (cleanName.startsWith(`${subRelativeId}-`)) {
+      cleanName = cleanName.slice(subRelativeId.length + 1);
     }
-    if (!raw || typeof raw !== "object" || !("contract" in raw)) continue;
-    let changed = false;
-    const rebase = (holder, key) => {
-      const p = holder[key];
-      if (typeof p !== "string" || p === "" || path20.isAbsolute(p)) return;
-      const next = toPosixPath(path20.relative(toRoot, path20.resolve(fromRoot, p)));
-      if (next !== p) {
-        holder[key] = next;
-        changed = true;
-      }
-    };
-    for (const key of ["sourcePath", "simPath"]) rebase(raw, key);
-    if (Array.isArray(raw.methods)) {
-      for (const method of raw.methods) {
-        if (method && typeof method === "object") rebase(method, "sourcePath");
+    const candidates = /* @__PURE__ */ new Set();
+    candidates.add(cleanName.toLowerCase());
+    candidates.add(cleanName.replace(/-/g, "_").toLowerCase());
+    candidates.add(compRelativeId.toLowerCase());
+    candidates.add(compRelativeId.replace(/-/g, "_").toLowerCase());
+    candidates.add(comp.componentType.toLowerCase());
+    let bestFile = null;
+    let bestScore = -1;
+    for (const f of files) {
+      const ext = path20.extname(f);
+      const base = path20.basename(f, ext).toLowerCase();
+      if (candidates.has(base)) {
+        let score = 0;
+        const normalizedPath = f.toLowerCase();
+        const subPattern1 = `/${subRelativeId.toLowerCase()}/`;
+        const subPattern2 = `/${subRelativeId.replace(/-/g, "_").toLowerCase()}/`;
+        const hasSubsystemSegmentMatch = subRelativeId.split(/[-_]/).some((seg) => seg.length >= 3 && normalizedPath.includes(`/${seg.toLowerCase()}/`));
+        const hasSubsystemMatch = normalizedPath.includes(subPattern1) || normalizedPath.includes(subPattern2) || hasSubsystemSegmentMatch;
+        if (hasSubsystemMatch) {
+          score += 10;
+        }
+        let belongsToOtherSubsystem = false;
+        for (const otherSub of subsystems) {
+          if (otherSub.id === comp.subsystem) continue;
+          const otherSubRelativeId = otherSub.id.split("::").pop() || otherSub.id;
+          const otherPattern1 = `/${otherSubRelativeId.toLowerCase()}/`;
+          const otherPattern2 = `/${otherSubRelativeId.replace(/-/g, "_").toLowerCase()}/`;
+          const otherSegmentMatch = otherSubRelativeId.split(/[-_]/).some((seg) => seg.length >= 3 && normalizedPath.includes(`/${seg.toLowerCase()}/`));
+          if (normalizedPath.includes(otherPattern1) || normalizedPath.includes(otherPattern2) || otherSegmentMatch) {
+            belongsToOtherSubsystem = true;
+            break;
+          }
+        }
+        if (belongsToOtherSubsystem) {
+          continue;
+        }
+        const isCleanNameMatch = base === cleanName.toLowerCase() || base === cleanName.replace(/-/g, "_").toLowerCase();
+        if (isCleanNameMatch) {
+          score += 5;
+        }
+        const isIdMatch = base === compRelativeId.toLowerCase() || base === compRelativeId.replace(/-/g, "_").toLowerCase();
+        if (isIdMatch) {
+          score += 3;
+        }
+        const isSpecificNameMatch = isCleanNameMatch && cleanName.toLowerCase() !== comp.componentType.toLowerCase();
+        if (!hasSubsystemMatch && !isSpecificNameMatch && !isIdMatch) {
+          continue;
+        }
+        if (normalizedPath.startsWith("src/") || normalizedPath.includes("/src/") || normalizedPath.startsWith("legacy-src/") || normalizedPath.includes("/legacy-src/")) {
+          score += 2;
+        }
+        if (base === comp.componentType.toLowerCase()) {
+          score += 1;
+        }
+        if (score > bestScore) {
+          bestScore = score;
+          bestFile = f;
+        }
       }
     }
-    if (changed) writeYamlFile(file, raw);
+    return bestFile;
+  } catch {
+    return null;
   }
 }
-function patchSubsystemIndex(indexPath, mutate) {
-  if (!fs15.existsSync(indexPath)) return;
-  const raw = readYamlFile(indexPath);
-  mutate(raw);
-  raw.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  writeYamlFile(indexPath, raw);
+function summarize(text, max = 140) {
+  const clean = text.replace(/\s+/g, " ").trim();
+  const period = clean.indexOf(". ");
+  const firstSentence = period > 0 ? clean.slice(0, period + 1) : clean;
+  if (firstSentence.length <= max) return firstSentence;
+  return `${firstSentence.slice(0, max - 1).trimEnd()}\u2026`;
 }
-function renameComponent(componentId, newId) {
-  const component = loadComponentSpec(componentId);
-  if (!component) {
-    throw new WaironError(`component-missing: no component has the id "${componentId}".`);
-  }
-  if (componentId.includes("::")) {
-    throw new WaironError(
-      `chained-component: "${componentId}" lives in a chained subproject; rename it from that project's own root.`
-    );
-  }
-  if (!SpecIdSchema.safeParse(newId).success) {
-    throw new WaironError(`invalid-id: "${newId}" is not a lowercase identifier with no namespace separator.`);
-  }
-  const components = loadComponentSpecs();
+function buildVariantGuidance(comps, allComponents, variantsById) {
+  return composeVariantGuidance(comps, allComponents, variantsById);
+}
+function resolveAgentTopology() {
+  projectFilesCache.clear();
+  const system = loadSystemSpec();
+  if (!system) return [];
+  const isLocal = (id) => !id.includes("::");
+  const subsystems = loadSubsystemSpecs().filter((s) => isLocal(s.id));
+  const components = loadComponentSpecs().filter((c) => isLocal(c.id) && isLocal(c.subsystem));
   const interfaces = loadInterfaceSpecs();
   const implementations = loadImplementationSpecs();
-  const interfaceId = `i${newId}`;
-  const implementationId = `${newId}_impl`;
-  const taken = [
-    components.some((c) => c.id === newId) ? `component "${newId}"` : null,
-    interfaces.some((i) => i.id === interfaceId) ? `interface "${interfaceId}"` : null,
-    implementations.some((impl) => impl.id === implementationId) ? `implementation "${implementationId}"` : null
-  ].filter((holder) => holder !== null);
-  if (taken.length > 0) {
-    throw new WaironError(`id-taken: the new id, or an id it implies, is already in use: ${taken.join(", ")}.`);
-  }
-  const contracts = interfaces.filter((i) => i.component === componentId);
-  const movingInterface = contracts.find((i) => i.id === `i${componentId}`);
-  const movingImplementation = implementations.find((impl) => impl.id === `${componentId}_impl` && contracts.some((i) => i.id === impl.contract));
-  const renamed = [
-    { kind: "component", from: componentId, to: newId },
-    ...movingInterface ? [{ kind: "interface", from: movingInterface.id, to: interfaceId }] : [],
-    ...movingImplementation ? [{ kind: "implementation", from: movingImplementation.id, to: implementationId }] : []
-  ];
-  const rewritten = rewriteRefFields(aiPathsAt(getProjectRoot()).specsDir(), (ref, position) => {
-    if (position === "component" || position === "entity-class" || position === "auth-source") {
-      return ref === componentId ? newId : ref;
+  const variantsById = new Map(loadProjectVariants().map((v) => [v.id, v]));
+  const config = projectConfigRepository.load();
+  if (!config) throw new ProjectNotInitializedError();
+  const activeTargets = config.targets.filter((t) => !("enabled" in t) || t.enabled).map((t) => typeof t === "string" ? t : t.type);
+  const agents = [];
+  agents.push({
+    id: "system-architect",
+    name: `${system.name} Architect`,
+    description: `Global architect for ${system.name} \u2014 owns the spec tree and topology. ${summarize(system.vision)}`,
+    template: "architect",
+    creationReason: "Automatically inferred from L0 system spec",
+    ownedPaths: [".wai/specs/**"],
+    readPaths: ["**"],
+    writePaths: [".wai/specs/**"],
+    tags: ["architect", "global", "sdd"],
+    dependencies: subsystems.map((s) => `${s.id}-owner`),
+    status: "active",
+    targets: activeTargets,
+    createdAt: system.createdAt,
+    updatedAt: system.updatedAt
+  });
+  for (const sub of subsystems) {
+    if (sub.projectPath) {
+      const mountSpecPath = path20.relative(getProjectRoot(), getSubsystemPath(sub.id)).replace(/\\/g, "/");
+      agents.push({
+        id: `${sub.id}-owner`,
+        name: `${sub.name} (chained subproject)`,
+        description: `Delegates into the "${sub.id}" chained subproject at ${sub.projectPath}. Its own agents live in that subproject's .wai \u2014 run \`wairon generate\` there (or spawn from ${sub.projectPath}/.claude/agents). Do not implement its internals from this layer.`,
+        template: "domain-owner",
+        creationReason: `Automatically inferred from a chained subproject subsystem: ${sub.id}`,
+        domainRoot: sub.id,
+        ownedPaths: [mountSpecPath],
+        readPaths: ["**"],
+        writePaths: [mountSpecPath],
+        tags: ["owner", "subproject", "delegate", "sdd"],
+        dependencies: [],
+        status: "active",
+        targets: activeTargets,
+        createdAt: sub.createdAt,
+        updatedAt: sub.updatedAt
+      });
+      continue;
+    }
+    const subComponents = components.filter((c) => c.subsystem === sub.id);
+    const ownedPaths = [];
+    ownedPaths.push(path20.relative(getProjectRoot(), getSubsystemPath(sub.id)).replace(/\\/g, "/"));
+    for (const c of subComponents) {
+      ownedPaths.push(path20.relative(getProjectRoot(), getComponentPath(c.id, sub.id)).replace(/\\/g, "/"));
+    }
+    if (!config.rules.generateComponentImplementers) {
+      for (const comp of subComponents) {
+        const compInterfaces = interfaces.filter((i) => i.component === comp.id);
+        const compInterfaceIds = compInterfaces.map((i) => i.id);
+        const compImpls = implementations.filter((impl) => compInterfaceIds.includes(impl.contract));
+        let hasExplicitSource = false;
+        for (const impl of compImpls) {
+          const files = implementationSourceFiles(impl);
+          if (files.length > 0) hasExplicitSource = true;
+          for (const file of files) {
+            if (!ownedPaths.includes(file)) ownedPaths.push(file);
+          }
+        }
+        if (!hasExplicitSource) {
+          const inferred = inferSourcePathForComponent(comp, subsystems);
+          if (inferred && !ownedPaths.includes(inferred)) {
+            ownedPaths.push(inferred);
+          }
+        }
+      }
     }
-    if (position === "interface" && ref === movingInterface?.id) return interfaceId;
-    return ref;
-  }).filter((spec) => !renamed.some((moved) => moved.kind === spec.kind && moved.from === spec.id)).map((spec) => spec.id);
-  invalidateSpecCache();
-  moveRenamedSpecs(componentId, newId, component, movingInterface, movingImplementation);
-  return { renamed, rewritten };
-}
-function moveRenamedSpecs(componentId, newId, component, movingInterface, movingImplementation) {
-  const interfaceId = `i${newId}`;
-  const implementationId = `${newId}_impl`;
-  const movedComponent = loadComponentSpec(componentId) ?? component;
-  const movedInterface = movingInterface ? loadInterfaceSpec(movingInterface.id) ?? movingInterface : null;
-  const movedImplementation = movingImplementation ? loadImplementationSpec(movingImplementation.id) ?? movingImplementation : null;
-  saveComponentSpec({ ...movedComponent, id: newId });
-  if (movedInterface) saveInterfaceSpec({ ...movedInterface, id: interfaceId, component: newId });
-  if (movedImplementation) {
-    const oldFile = getImplementationPath(movedImplementation.id);
-    if (path20.resolve(getImplementationPath(implementationId, movedImplementation.contract)) === path20.resolve(oldFile)) {
-      fs15.unlinkSync(oldFile);
+    let dependencies = [];
+    if (config.rules.generateComponentImplementers) {
+      dependencies = subComponents.map((c) => `${c.id}-implementer`);
+    } else {
+      const depSubsystems = /* @__PURE__ */ new Set();
+      for (const c of subComponents) {
+        for (const depId of c.dependsOn) {
+          const depComp = components.find((other) => other.id === depId);
+          if (depComp && depComp.subsystem !== sub.id) {
+            depSubsystems.add(`${depComp.subsystem}-owner`);
+          }
+        }
+      }
+      dependencies = Array.from(depSubsystems);
     }
-    saveImplementationSpec({ ...movedImplementation, id: implementationId });
-  }
-  removeSpecFile2(getComponentPath(componentId), componentId);
-  if (movingInterface) removeSpecFile2(getInterfacePath(movingInterface.id), movingInterface.id);
-  if (movingImplementation) removeSpecFile2(getImplementationPath(movingImplementation.id), movingImplementation.id);
-  invalidateSpecCache();
-}
-function removeSpecFile2(file, id) {
-  if (!fs15.existsSync(file)) return;
-  try {
-    if (readYamlFile(file)?.id !== id) return;
-  } catch {
-    return;
-  }
-  fs15.unlinkSync(file);
-  const specsRoot = path20.resolve(aiPathsAt(getProjectRoot()).specsDir());
-  for (let dir = path20.dirname(path20.resolve(file)); dir !== specsRoot && isWithinDir(specsRoot, dir); dir = path20.dirname(dir)) {
-    if (fs15.readdirSync(dir).length > 0) break;
-    fs15.rmdirSync(dir);
-  }
-}
-function renameMethod(componentId, methodName, newName, pinSymbol) {
-  const component = loadComponentSpec(componentId);
-  if (!component) {
-    throw new WaironError(`component-missing: no component has the id "${componentId}".`);
-  }
-  if (componentId.includes("::")) {
-    throw new WaironError(
-      `chained-component: "${componentId}" lives in a chained subproject; rename its method from that project's own root.`
-    );
-  }
-  if (!METHOD_NAME.test(newName)) {
-    throw new WaironError(`invalid-name: "${newName}" is not a camel-case identifier.`);
-  }
-  const contracts = loadInterfaceSpecs().filter((i) => i.component === componentId);
-  const moving = contracts.filter((i) => i.methods.some((m) => m.name === methodName));
-  if (moving.length === 0) {
-    throw new WaironError(`method-missing: no contract of "${componentId}" declares the method "${methodName}".`);
-  }
-  const taken = moving.filter((i) => i.methods.some((m) => m.name === newName)).map((i) => `"${i.id}"`);
-  if (taken.length > 0) {
-    throw new WaironError(`name-taken: ${taken.join(", ")} already declares a method under the name "${newName}".`);
-  }
-  const implementations = loadImplementationSpecs();
-  const movingContracts = new Set(moving.map((i) => i.id));
-  const renamed = [];
-  for (const contract of moving) {
-    saveInterfaceSpec({
-      ...contract,
-      methods: contract.methods.map((m) => m.name === methodName ? { ...m, name: newName, signature: renameInSignature(m.signature, methodName, newName) } : m)
+    agents.push({
+      id: `${sub.id}-owner`,
+      name: `${sub.name} Owner`,
+      description: `Owns the ${sub.id} subsystem. ${summarize(sub.description)}`,
+      template: "domain-owner",
+      creationReason: `Automatically inferred from L1 subsystem spec: ${sub.id}`,
+      domainRoot: sub.id,
+      ownedPaths,
+      readPaths: ["**"],
+      writePaths: ownedPaths,
+      tags: ["owner", "domain", "sdd"],
+      dependencies,
+      variantGuidance: buildVariantGuidance(subComponents, components, variantsById),
+      status: "active",
+      targets: activeTargets,
+      createdAt: sub.createdAt,
+      updatedAt: sub.updatedAt
     });
-    renamed.push(contract.id);
   }
-  let pinnedSymbol;
-  for (const implementation of implementations) {
-    if (!movingContracts.has(implementation.contract)) continue;
-    const realization = implementation.methods.find((m) => m.name === methodName);
-    if (!realization) continue;
-    const pin = realization.symbol === void 0 && pinSymbol !== false;
-    if (pin) pinnedSymbol = methodName;
-    saveImplementationSpec({
-      ...implementation,
-      methods: implementation.methods.map((m) => m.name === methodName ? { ...m, name: newName, ...pin ? { symbol: methodName } : {} } : m)
+  if (config.rules.generateComponentImplementers) {
+    for (const comp of components) {
+      const compInterfaces = interfaces.filter((i) => i.component === comp.id);
+      const compInterfaceIds = compInterfaces.map((i) => i.id);
+      const compImpls = implementations.filter((impl) => compInterfaceIds.includes(impl.contract));
+      const ownedPaths = [];
+      for (const impl of compImpls) {
+        for (const file of implementationSourceFiles(impl)) {
+          if (!ownedPaths.includes(file)) ownedPaths.push(file);
+        }
+      }
+      if (ownedPaths.length === 0) {
+        const inferred = inferSourcePathForComponent(comp, subsystems);
+        if (inferred) {
+          ownedPaths.push(inferred);
+        }
+      }
+      const dependencies = comp.dependsOn.map((depId) => `${depId}-implementer`);
+      const readPaths = [
+        path20.relative(getProjectRoot(), AI_PATHS.specsSystem()).replace(/\\/g, "/"),
+        path20.relative(getProjectRoot(), getComponentPath(comp.id, comp.subsystem)).replace(/\\/g, "/"),
+        ...compInterfaces.map((i) => path20.relative(getProjectRoot(), getInterfacePath(i.id, comp.id)).replace(/\\/g, "/")),
+        ...compImpls.map((impl) => path20.relative(getProjectRoot(), getImplementationPath(impl.id, impl.contract)).replace(/\\/g, "/"))
+      ];
+      agents.push({
+        id: `${comp.id}-implementer`,
+        name: `${comp.name} Implementer`,
+        description: `Developer agent implementing ${comp.name} (${comp.componentType})`,
+        template: "implementer",
+        creationReason: `Automatically inferred from L2 component spec: ${comp.id}`,
+        domainRoot: comp.subsystem,
+        ownedPaths,
+        readPaths,
+        writePaths: ownedPaths,
+        tags: ["implementer", "component", "sdd", comp.componentType.toLowerCase()],
+        dependencies,
+        variantGuidance: buildVariantGuidance([comp], components, variantsById),
+        status: "active",
+        targets: activeTargets,
+        createdAt: comp.createdAt,
+        updatedAt: comp.updatedAt
+      });
+    }
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  for (const dom of loadTopologyConfig().domains) {
+    agents.push({
+      id: `${dom.id}-owner`,
+      name: `${dom.name ?? dom.id} Owner`,
+      description: dom.description ? summarize(dom.description) : `Owner agent for the free-standing "${dom.id}" domain.`,
+      template: "domain-owner",
+      creationReason: "Inferred from a free-standing domain in .wai/topology.yaml",
+      domainRoot: dom.id,
+      ownedPaths: dom.ownedPaths,
+      readPaths: ["**"],
+      writePaths: dom.ownedPaths,
+      tags: ["owner", "domain"],
+      dependencies: [],
+      status: "active",
+      targets: activeTargets,
+      createdAt: now,
+      updatedAt: now
     });
-    renamed.push(implementation.id);
   }
-  invalidateSpecCache();
-  const specsDir = aiPathsAt(getProjectRoot()).specsDir();
-  const rewritten = rewriteRefFields(specsDir, (ref, position, owner) => position === "method" && owner === componentId && ref === methodName ? newName : ref).map((spec) => spec.id);
-  const mentions = collectMentions(specsDir, methodName, moving);
-  return {
-    component: componentId,
-    from: methodName,
-    to: newName,
-    renamed,
-    rewritten,
-    mentions,
-    ...pinnedSymbol ? { pinnedSymbol } : {}
-  };
-}
-function renameInSignature(signature, from, to) {
-  return signature.replace(identifierPattern(from), to);
+  return agents;
 }
-function collectMentions(specsDir, methodName, moved) {
-  const mentions = /* @__PURE__ */ new Set();
-  for (const contract of moved) {
-    const wireBound = contract.methods.some((m) => {
-      const endpoint = m.endpoint;
-      return endpoint?.transport === "gRPC" && endpoint.method === methodName;
-    });
-    if (wireBound) mentions.add(contract.id);
+function composeAgentBrief(agentId) {
+  const records = resolveAgentTopology();
+  const record = records.find((r) => r.id === agentId);
+  if (!record) {
+    throw new UnknownAgentError(agentId, records.map((r) => r.id));
   }
-  const named = identifierPattern(methodName);
-  const namesMethod = (value) => {
-    if (Array.isArray(value)) return value.some(namesMethod);
-    if (!value || typeof value !== "object") return false;
-    return Object.entries(value).some(([key, nested]) => typeof nested === "string" ? PROSE_FIELDS2.has(key) && named.test(nested) : namesMethod(nested));
-  };
-  for (const file of listFilesRecursive(specsDir, ".yaml")) {
-    let raw;
-    try {
-      raw = readYamlFile(file);
-    } catch {
-      continue;
-    }
-    if (!raw || typeof raw !== "object") continue;
-    const kind = specKind(raw);
-    if (!kind || !namesMethod(raw)) continue;
-    mentions.add(kind === "system" ? "system" : String(raw.id));
+  const config = projectConfigRepository.load();
+  if (!config) throw new ProjectNotInitializedError();
+  const template = loadTemplate(record.template, config.globalTemplatesDir);
+  let instructions = renderTemplateInstructions(template, {
+    agentId: record.id,
+    agentName: record.name,
+    agentDescription: record.description,
+    ownedPaths: record.ownedPaths.join("\n"),
+    tags: record.tags.join(", "),
+    renderContext: "root",
+    contextNote: "",
+    domainPath: ".",
+    domainName: "",
+    variantGuidance: record.variantGuidance ?? ""
+  });
+  const guidance = loadAgentOverride(agentId);
+  if (guidance !== null) {
+    instructions = `${instructions.trimEnd()}
+
+## Project guidance
+
+${guidance.trim()}
+`;
   }
-  return [...mentions];
+  const profile = deriveExecutionProfile(record);
+  const budget = resolveBudget(profile, config.execution, record.id);
+  return {
+    agentId: record.id,
+    name: record.name,
+    template: record.template,
+    domainRoot: record.domainRoot,
+    ownedPaths: record.ownedPaths,
+    readPaths: record.readPaths,
+    instructions,
+    variantGuidance: record.variantGuidance || void 0,
+    profile: budget ? profile : void 0,
+    budget
+  };
 }
-function identifierPattern(methodName) {
-  return new RegExp(`(?<![A-Za-z0-9_])${methodName}(?![A-Za-z0-9_])`);
+function loadRegistry() {
+  assertProjectInitialized();
+  if (!pathExists(AI_PATHS.specsSystem())) return createEmptyRegistry();
+  return {
+    schemaVersion: "1.0.0",
+    agents: resolveAgentTopology(),
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
 }
-var fs15, path20, METHOD_NAME, PROSE_FIELDS2;
-var init_provision = __esm({
-  "src/core/provision.ts"() {
+var path20, fs15, projectFilesCache, UnknownAgentError;
+var init_agent_resolver = __esm({
+  "src/core/agent_resolver.ts"() {
     "use strict";
-    fs15 = __toESM(require("fs"));
     path20 = __toESM(require("path"));
-    init_specs2();
+    fs15 = __toESM(require("fs"));
     init_loader();
+    init_paths();
+    init_registry();
     init_project_config();
     init_fs();
-    init_yaml();
     init_errors();
-    init_models();
-    METHOD_NAME = /^[a-z][a-zA-Z0-9]*$/;
-    PROSE_FIELDS2 = /* @__PURE__ */ new Set([
-      "description",
-      "intent",
-      "summary",
-      "condition",
-      "over",
-      "outcome",
-      "error",
-      "note",
-      "caller"
-    ]);
+    init_templates();
+    init_execution_profile();
+    init_budget_policy();
+    init_specs2();
+    init_specs();
+    init_variants();
+    projectFilesCache = /* @__PURE__ */ new Map();
+    UnknownAgentError = class extends WaironError {
+      constructor(agentId, knownIds) {
+        super(`Unknown agent id: "${agentId}". Known agent ids: ${knownIds.join(", ")}`);
+        this.name = "UnknownAgentError";
+      }
+    };
   }
 });
 
@@ -27241,116 +27245,383 @@ function commitStagedTree(stagingDir, destDir, roots, backupExisting) {
     } else if (liveSpecDir && fs17.existsSync(liveSpecDir)) {
       fs17.rmSync(liveSpecDir, { recursive: true, force: true });
     }
-    const target = path22.join(root, relative9, ".wai");
-    fs17.mkdirSync(path22.dirname(target), { recursive: true });
-    if (fs17.existsSync(target)) fs17.rmSync(target, { recursive: true, force: true });
-    fs17.renameSync(stagedSpecDir, target);
-  }
-  if (backedUp) {
-    return backupDir;
+    const target = path22.join(root, relative9, ".wai");
+    fs17.mkdirSync(path22.dirname(target), { recursive: true });
+    if (fs17.existsSync(target)) fs17.rmSync(target, { recursive: true, force: true });
+    fs17.renameSync(stagedSpecDir, target);
+  }
+  if (backedUp) {
+    return backupDir;
+  }
+  return "";
+}
+function discardStagingDir(stagingDir) {
+  try {
+    fs17.rmSync(stagingDir, { recursive: true, force: true });
+  } catch {
+  }
+}
+function exportSpecTree(includeDerived, allowPartial) {
+  const system = loadSystemSpec();
+  if (!system) {
+    throw new Error("no spec tree to export at this project root");
+  }
+  const inspection = inspectChainedRoots();
+  const root = getProjectRoot();
+  const skipped = [...inspection.skipped];
+  const roots = [{ relativePath: ".", waiDir: aiPathsAt(root).root() }];
+  for (const rel2 of inspection.roots) {
+    const waiDir = aiPathsAt(path22.resolve(root, rel2)).root();
+    if (pathExists(waiDir)) {
+      roots.push({ relativePath: rel2, waiDir });
+    } else {
+      skipped.push({ mount: rel2, projectPath: rel2, reason: "no-spec-tree" });
+    }
+  }
+  if (skipped.length > 0 && !allowPartial) {
+    const detail = skipped.map((s) => `${s.mount} (${s.reason})`).join(", ");
+    throw new Error(
+      `cannot export the whole spec tree \u2014 skipped: ${detail}. Pass allowPartial to export the rest anyway.`
+    );
+  }
+  const stateId = computeStateId();
+  const built = buildTreeArchive2(roots, system.name, stateId.digest, includeDerived);
+  const result = {
+    archive: built.archive,
+    suggestedFileName: built.suggestedFileName,
+    projectName: built.manifest.projectName,
+    roots: built.manifest.roots,
+    fileCount: built.fileCount,
+    stateId: stateId.digest,
+    skipped
+  };
+  return result;
+}
+function importSpecTree(archive, options) {
+  const info = inspectTreeArchive2(archive);
+  if (!info.compatible) {
+    throw new Error("incompatible .waitree archive (format or minimum wairon version)");
+  }
+  const destDir = path22.resolve(options.destDir ?? getProjectRoot());
+  const occupied = hasSpecTree(destDir);
+  const authored = hasAuthoredSpecs(destDir);
+  if (authored && options.replaceExisting !== true) {
+    throw new Error(
+      "the destination already holds an authored spec tree; pass replaceExisting to move it aside and import over it"
+    );
+  }
+  const stagingDir = createStagingDir(destDir);
+  let extraction;
+  try {
+    extraction = extractTreeArchive2(archive, stagingDir, options.refuseExecutableEntries);
+  } catch (err) {
+    discardStagingDir(stagingDir);
+    throw err;
+  }
+  const backupPath = commitStagedTree(stagingDir, destDir, extraction.roots, occupied);
+  discardStagingDir(stagingDir);
+  invalidateSpecCache();
+  const result = {
+    destDir,
+    projectName: extraction.manifest.projectName,
+    roots: extraction.roots,
+    fileCount: extraction.writtenPaths.length,
+    replaced: occupied
+  };
+  if (backupPath) result.backupPath = backupPath;
+  if (extraction.manifest.stateId) result.stateId = extraction.manifest.stateId;
+  return result;
+}
+function liveSpecDirFor(rootDir) {
+  const modern = path22.join(rootDir, ".wai");
+  if (fs17.existsSync(modern)) return modern;
+  const legacy = path22.join(rootDir, ".wairon");
+  if (fs17.existsSync(legacy)) return legacy;
+  return null;
+}
+function timestampSlug() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+}
+var fs17, path22, sdkPortal, STAGING_PREFIX, BACKUP_DIR;
+var init_treetransfer = __esm({
+  "src/core/treetransfer.ts"() {
+    "use strict";
+    fs17 = __toESM(require("fs"));
+    path22 = __toESM(require("path"));
+    sdkPortal = __toESM(require_dist());
+    init_paths();
+    init_fs();
+    init_specs2();
+    init_statehash();
+    STAGING_PREFIX = ".wai-staging-";
+    BACKUP_DIR = ".wai-backups";
+  }
+});
+
+// src/exporters/claude.ts
+function toolsFor(budget) {
+  const base = TOOLS_BY_CLASS[budget.toolClass];
+  if (!base) return void 0;
+  if (budget.allowNestedDelegation && !base.includes("Agent")) {
+    return [...base, "Agent"];
+  }
+  if (!budget.allowNestedDelegation) {
+    return base.filter((t) => t !== "Agent");
+  }
+  return base;
+}
+function mcpServersFor(access) {
+  return access === "none" ? "[]" : void 0;
+}
+function yamlScalar(value) {
+  return /[:#\n]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value;
+}
+var path23, MODEL_BY_TIER, TOOLS_BY_CLASS, ClaudeExporter;
+var init_claude = __esm({
+  "src/exporters/claude.ts"() {
+    "use strict";
+    path23 = __toESM(require("path"));
+    init_fs();
+    MODEL_BY_TIER = {
+      small: "haiku",
+      standard: "sonnet",
+      large: "opus",
+      frontier: "fable"
+    };
+    TOOLS_BY_CLASS = {
+      "read-only": ["Read", "Grep", "Glob"],
+      implement: ["Read", "Grep", "Glob", "Edit", "Write", "Bash"],
+      orchestrate: ["Agent", "SendMessage", "TodoWrite"],
+      // `full` means "inherit everything" — expressed by omitting the field.
+      full: void 0
+    };
+    ClaudeExporter = class {
+      constructor(options = {}) {
+        this.options = options;
+        this.targetType = "claude";
+      }
+      outputPath(ctx) {
+        const { agent, target, projectRoot } = ctx;
+        const outputDir = "outputDir" in target ? target.outputDir : ".claude/agents";
+        return path23.resolve(projectRoot, outputDir, `${agent.id.replace(/::/g, "--")}.md`);
+      }
+      export(ctx) {
+        const { agent, renderedInstructions, budget } = ctx;
+        const filePath = this.outputPath(ctx);
+        const frontmatter = [
+          `name: ${agent.name}`,
+          `description: ${yamlScalar(agent.description)}`
+        ];
+        if (budget && this.options.emitBudget) {
+          if (budget.modelTier) frontmatter.push(`model: ${MODEL_BY_TIER[budget.modelTier]}`);
+          if (budget.effort) frontmatter.push(`effort: ${budget.effort}`);
+          if (budget.maxTurns !== void 0) frontmatter.push(`maxTurns: ${budget.maxTurns}`);
+          const tools = toolsFor(budget);
+          if (tools) frontmatter.push(`tools: ${tools.join(", ")}`);
+          const servers = mcpServersFor(budget.mcp);
+          if (servers) frontmatter.push(`mcpServers: ${servers}`);
+        }
+        const content = ["---", ...frontmatter, "---", "", renderedInstructions, ""].join("\n");
+        const changed = writeFileIfChanged(filePath, content);
+        return { outputPath: filePath, content, unchanged: !changed };
+      }
+    };
+  }
+});
+
+// src/exporters/custom.ts
+var path24, CustomExporter;
+var init_custom = __esm({
+  "src/exporters/custom.ts"() {
+    "use strict";
+    path24 = __toESM(require("path"));
+    init_fs();
+    CustomExporter = class {
+      constructor() {
+        this.targetType = "custom";
+      }
+      outputPath(ctx) {
+        const { agent, target, projectRoot } = ctx;
+        if (!("outputDir" in target)) {
+          throw new Error("CustomExporter requires target.outputDir");
+        }
+        return path24.resolve(projectRoot, target.outputDir, `${agent.id.replace(/::/g, "--")}.md`);
+      }
+      export(ctx) {
+        const { agent, target, renderedInstructions } = ctx;
+        const label = "label" in target ? target.label : "Custom";
+        const filePath = this.outputPath(ctx);
+        const content = [
+          "---",
+          `name: ${agent.name}`,
+          `description: ${agent.description}`,
+          `id: ${agent.id}`,
+          `target: ${label}`,
+          "---",
+          "",
+          renderedInstructions,
+          ""
+        ].join("\n");
+        const changed = writeFileIfChanged(filePath, content);
+        return { outputPath: filePath, content, unchanged: !changed };
+      }
+    };
+  }
+});
+
+// src/exporters/gemini.ts
+function yamlString(value) {
+  if (/[:#\[\]{},&*!|>'"%@`]/.test(value) || value.startsWith(" ") || value.endsWith(" ")) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+  }
+  return value;
+}
+var path25, GeminiExporter;
+var init_gemini = __esm({
+  "src/exporters/gemini.ts"() {
+    "use strict";
+    path25 = __toESM(require("path"));
+    init_fs();
+    GeminiExporter = class {
+      constructor() {
+        this.targetType = "gemini";
+      }
+      outputPath(ctx) {
+        const { agent, target, projectRoot } = ctx;
+        const outputDir = "outputDir" in target ? target.outputDir : ".gemini/agents";
+        return path25.resolve(projectRoot, outputDir, `${agent.id.replace(/::/g, "--")}.yaml`);
+      }
+      export(ctx) {
+        const { agent, renderedInstructions } = ctx;
+        const filePath = this.outputPath(ctx);
+        const indentedInstructions = renderedInstructions.split("\n").map((line) => line.length > 0 ? `  ${line}` : "").join("\n");
+        const content = [
+          `name: ${yamlString(agent.name)}`,
+          `description: ${yamlString(agent.description)}`,
+          `system_prompt: |`,
+          indentedInstructions,
+          ""
+        ].join("\n");
+        const changed = writeFileIfChanged(filePath, content);
+        return { outputPath: filePath, content, unchanged: !changed };
+      }
+    };
+  }
+});
+
+// src/exporters/registry.ts
+function getExporter(target) {
+  const type = typeof target === "string" ? target : target.type;
+  const exporter = EXPORTERS.get(type);
+  if (!exporter) {
+    throw new WaironError(`No exporter registered for target type: "${type}"`);
+  }
+  return exporter;
+}
+function registerExporter(type, exporter) {
+  EXPORTERS.set(type, exporter);
+}
+var EXPORTERS;
+var init_registry2 = __esm({
+  "src/exporters/registry.ts"() {
+    "use strict";
+    init_claude();
+    init_custom();
+    init_gemini();
+    init_errors();
+    EXPORTERS = /* @__PURE__ */ new Map([
+      ["claude", new ClaudeExporter({ emitBudget: true })],
+      ["gemini", new GeminiExporter()],
+      ["agy", new GeminiExporter()],
+      ["cursor", new ClaudeExporter()],
+      ["copilot", new ClaudeExporter()],
+      ["codex", new ClaudeExporter()],
+      ["custom", new CustomExporter()]
+    ]);
+  }
+});
+
+// src/exporters/base.ts
+var WAIRON_MANAGED_MARKER, WAIRON_MANAGED_BANNER;
+var init_base = __esm({
+  "src/exporters/base.ts"() {
+    "use strict";
+    WAIRON_MANAGED_MARKER = "wairon:managed";
+    WAIRON_MANAGED_BANNER = `<!-- ${WAIRON_MANAGED_MARKER} \u2014 generated by \`wairon generate\`; do not edit, changes are overwritten -->`;
+  }
+});
+
+// src/exporters/generate.ts
+function generateAgent(agent, projectConfig, options = {}) {
+  const projectRoot = options.projectRoot ?? getProjectRoot();
+  const template = loadTemplate(agent.template, projectConfig.globalTemplatesDir);
+  const rendered = `${WAIRON_MANAGED_BANNER}
+${composeAgentBrief(agent.id).instructions}`;
+  const results = [];
+  const budget = resolveBudget(
+    deriveExecutionProfile(agent),
+    projectConfig.execution,
+    agent.id
+  );
+  for (const agentTarget of agent.targets) {
+    const targetConfig = resolveTargetConfig(agentTarget, projectConfig);
+    if (!targetConfig) continue;
+    if (options.filterTargets) {
+      const type = "type" in targetConfig ? targetConfig.type : targetConfig;
+      if (!options.filterTargets.includes(type)) continue;
+    }
+    if (!options.dryRun) {
+      results.push(getExporter(targetConfig).export({
+        agent,
+        template,
+        renderedInstructions: rendered,
+        projectRoot,
+        target: targetConfig,
+        budget
+      }));
+    }
   }
-  return "";
+  return { agent, results };
 }
-function discardStagingDir(stagingDir) {
-  try {
-    fs17.rmSync(stagingDir, { recursive: true, force: true });
-  } catch {
+function generateAll(agents, projectConfig, options = {}) {
+  let pool = agents;
+  if (options.filterDomainIds && options.filterDomainIds.length > 0) {
+    const ids = new Set(options.filterDomainIds);
+    pool = agents.filter((a) => ids.has(a.domainRoot ?? "root"));
   }
+  return pool.map((agent) => generateAgent(agent, projectConfig, options));
 }
-function exportSpecTree(includeDerived, allowPartial) {
-  const system = loadSystemSpec();
-  if (!system) {
-    throw new Error("no spec tree to export at this project root");
-  }
-  const inspection = inspectChainedRoots();
-  const root = getProjectRoot();
-  const skipped = [...inspection.skipped];
-  const roots = [{ relativePath: ".", waiDir: aiPathsAt(root).root() }];
-  for (const rel2 of inspection.roots) {
-    const waiDir = aiPathsAt(path22.resolve(root, rel2)).root();
-    if (pathExists(waiDir)) {
-      roots.push({ relativePath: rel2, waiDir });
-    } else {
-      skipped.push({ mount: rel2, projectPath: rel2, reason: "no-spec-tree" });
+function resolveExpectedOutputPaths(agents, projectConfig, projectRoot = getProjectRoot()) {
+  const expected = /* @__PURE__ */ new Set();
+  for (const agent of agents) {
+    for (const agentTarget of agent.targets) {
+      const targetConfig = resolveTargetConfig(agentTarget, projectConfig);
+      if (!targetConfig) continue;
+      const ctx = { agent, projectRoot, target: targetConfig };
+      expected.add(path26.resolve(getExporter(targetConfig).outputPath(ctx)));
     }
   }
-  if (skipped.length > 0 && !allowPartial) {
-    const detail = skipped.map((s) => `${s.mount} (${s.reason})`).join(", ");
-    throw new Error(
-      `cannot export the whole spec tree \u2014 skipped: ${detail}. Pass allowPartial to export the rest anyway.`
-    );
-  }
-  const stateId = computeStateId();
-  const built = buildTreeArchive2(roots, system.name, stateId.digest, includeDerived);
-  const result = {
-    archive: built.archive,
-    suggestedFileName: built.suggestedFileName,
-    projectName: built.manifest.projectName,
-    roots: built.manifest.roots,
-    fileCount: built.fileCount,
-    stateId: stateId.digest,
-    skipped
-  };
-  return result;
-}
-function importSpecTree(archive, options) {
-  const info = inspectTreeArchive2(archive);
-  if (!info.compatible) {
-    throw new Error("incompatible .waitree archive (format or minimum wairon version)");
-  }
-  const destDir = path22.resolve(options.destDir ?? getProjectRoot());
-  const occupied = hasSpecTree(destDir);
-  const authored = hasAuthoredSpecs(destDir);
-  if (authored && options.replaceExisting !== true) {
-    throw new Error(
-      "the destination already holds an authored spec tree; pass replaceExisting to move it aside and import over it"
-    );
-  }
-  const stagingDir = createStagingDir(destDir);
-  let extraction;
-  try {
-    extraction = extractTreeArchive2(archive, stagingDir, options.refuseExecutableEntries);
-  } catch (err) {
-    discardStagingDir(stagingDir);
-    throw err;
-  }
-  const backupPath = commitStagedTree(stagingDir, destDir, extraction.roots, occupied);
-  discardStagingDir(stagingDir);
-  invalidateSpecCache();
-  const result = {
-    destDir,
-    projectName: extraction.manifest.projectName,
-    roots: extraction.roots,
-    fileCount: extraction.writtenPaths.length,
-    replaced: occupied
-  };
-  if (backupPath) result.backupPath = backupPath;
-  if (extraction.manifest.stateId) result.stateId = extraction.manifest.stateId;
-  return result;
-}
-function liveSpecDirFor(rootDir) {
-  const modern = path22.join(rootDir, ".wai");
-  if (fs17.existsSync(modern)) return modern;
-  const legacy = path22.join(rootDir, ".wairon");
-  if (fs17.existsSync(legacy)) return legacy;
-  return null;
+  return expected;
 }
-function timestampSlug() {
-  return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+function resolveTargetConfig(agentTarget, projectConfig) {
+  const targetType = typeof agentTarget === "string" ? agentTarget : agentTarget.type;
+  return projectConfig.targets.find((t) => {
+    if (typeof t === "string") return t === targetType;
+    return t.type === targetType;
+  });
 }
-var fs17, path22, sdkPortal, STAGING_PREFIX, BACKUP_DIR;
-var init_treetransfer = __esm({
-  "src/core/treetransfer.ts"() {
+var path26;
+var init_generate = __esm({
+  "src/exporters/generate.ts"() {
     "use strict";
-    fs17 = __toESM(require("fs"));
-    path22 = __toESM(require("path"));
-    sdkPortal = __toESM(require_dist());
-    init_loader();
+    path26 = __toESM(require("path"));
+    init_templates();
+    init_agent_resolver();
+    init_execution_profile();
+    init_budget_policy();
     init_fs();
-    init_specs2();
-    init_statehash();
-    STAGING_PREFIX = ".wai-staging-";
-    BACKUP_DIR = ".wai-backups";
+    init_registry2();
+    init_base();
   }
 });
 
@@ -27510,12 +27781,12 @@ function digest(content) {
   return crypto4.createHash("sha256").update(normalized, "utf8").digest("hex");
 }
 function currentSpecDigests(root = getProjectRoot()) {
-  const mountDirs = loadSubsystemSpecs().filter((s) => s.projectPath && !s.id.includes("::")).map((s) => `${path23.resolve(root, s.projectPath).split(path23.sep).join("/")}/`);
+  const mountDirs = loadSubsystemSpecs().filter((s) => s.projectPath && !s.id.includes("::")).map((s) => `${path27.resolve(root, s.projectPath).split(path27.sep).join("/")}/`);
   const out = {};
   for (const [abs, content] of snapshotSpecFiles()) {
-    const normalized = path23.resolve(abs).split(path23.sep).join("/");
+    const normalized = path27.resolve(abs).split(path27.sep).join("/");
     if (mountDirs.some((dir) => normalized.startsWith(dir))) continue;
-    out[path23.relative(root, abs).split(path23.sep).join("/")] = digest(content);
+    out[path27.relative(root, abs).split(path27.sep).join("/")] = digest(content);
   }
   return out;
 }
@@ -27573,7 +27844,7 @@ function currentChildPins(mounts, root = getProjectRoot()) {
   const pins = {};
   for (const mount of mounts) {
     if (!mount.projectPath || mount.id.includes("::")) continue;
-    const child = readLockRecordAt(path23.resolve(root, mount.projectPath));
+    const child = readLockRecordAt(path27.resolve(root, mount.projectPath));
     if (child) pins[mount.id] = pinOf(child.stateId);
   }
   return pins;
@@ -27589,12 +27860,12 @@ function movedChildren(mounts, root = getProjectRoot()) {
   }
   return moved;
 }
-var crypto4, path23;
+var crypto4, path27;
 var init_approval = __esm({
   "src/core/approval.ts"() {
     "use strict";
     crypto4 = __toESM(require("crypto"));
-    path23 = __toESM(require("path"));
+    path27 = __toESM(require("path"));
     init_fs();
     init_specs2();
     init_lockfile();
@@ -27678,6 +27949,7 @@ var init_core = __esm({
     init_treetransfer();
     init_extensions();
     init_agent_resolver();
+    init_generate();
     init_treetransfer();
     init_provision();
     init_stereotype_migration();
@@ -28140,236 +28412,18 @@ init_models();
 // src/config/index.ts
 init_defaults();
 init_loader();
+init_paths();
 
 // src/index.ts
 init_core();
 
-// src/exporters/base.ts
-var WAIRON_MANAGED_MARKER = "wairon:managed";
-var WAIRON_MANAGED_BANNER = `<!-- ${WAIRON_MANAGED_MARKER} \u2014 generated by \`wairon generate\`; do not edit, changes are overwritten -->`;
-
-// src/exporters/claude.ts
-var path24 = __toESM(require("path"));
-init_fs();
-var MODEL_BY_TIER = {
-  small: "haiku",
-  standard: "sonnet",
-  large: "opus",
-  frontier: "fable"
-};
-var TOOLS_BY_CLASS = {
-  "read-only": ["Read", "Grep", "Glob"],
-  implement: ["Read", "Grep", "Glob", "Edit", "Write", "Bash"],
-  orchestrate: ["Agent", "SendMessage", "TodoWrite"],
-  // `full` means "inherit everything" — expressed by omitting the field.
-  full: void 0
-};
-function toolsFor(budget) {
-  const base = TOOLS_BY_CLASS[budget.toolClass];
-  if (!base) return void 0;
-  if (budget.allowNestedDelegation && !base.includes("Agent")) {
-    return [...base, "Agent"];
-  }
-  if (!budget.allowNestedDelegation) {
-    return base.filter((t) => t !== "Agent");
-  }
-  return base;
-}
-function mcpServersFor(access) {
-  return access === "none" ? "[]" : void 0;
-}
-function yamlScalar(value) {
-  return /[:#\n]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value;
-}
-var ClaudeExporter = class {
-  constructor(options = {}) {
-    this.options = options;
-    this.targetType = "claude";
-  }
-  outputPath(ctx) {
-    const { agent, target, projectRoot } = ctx;
-    const outputDir = "outputDir" in target ? target.outputDir : ".claude/agents";
-    return path24.resolve(projectRoot, outputDir, `${agent.id.replace(/::/g, "--")}.md`);
-  }
-  export(ctx) {
-    const { agent, renderedInstructions, budget } = ctx;
-    const filePath = this.outputPath(ctx);
-    const frontmatter = [
-      `name: ${agent.name}`,
-      `description: ${yamlScalar(agent.description)}`
-    ];
-    if (budget && this.options.emitBudget) {
-      if (budget.modelTier) frontmatter.push(`model: ${MODEL_BY_TIER[budget.modelTier]}`);
-      if (budget.effort) frontmatter.push(`effort: ${budget.effort}`);
-      if (budget.maxTurns !== void 0) frontmatter.push(`maxTurns: ${budget.maxTurns}`);
-      const tools = toolsFor(budget);
-      if (tools) frontmatter.push(`tools: ${tools.join(", ")}`);
-      const servers = mcpServersFor(budget.mcp);
-      if (servers) frontmatter.push(`mcpServers: ${servers}`);
-    }
-    const content = ["---", ...frontmatter, "---", "", renderedInstructions, ""].join("\n");
-    const changed = writeFileIfChanged(filePath, content);
-    return { outputPath: filePath, content, unchanged: !changed };
-  }
-};
-
-// src/exporters/custom.ts
-var path25 = __toESM(require("path"));
-init_fs();
-var CustomExporter = class {
-  constructor() {
-    this.targetType = "custom";
-  }
-  outputPath(ctx) {
-    const { agent, target, projectRoot } = ctx;
-    if (!("outputDir" in target)) {
-      throw new Error("CustomExporter requires target.outputDir");
-    }
-    return path25.resolve(projectRoot, target.outputDir, `${agent.id.replace(/::/g, "--")}.md`);
-  }
-  export(ctx) {
-    const { agent, target, renderedInstructions } = ctx;
-    const label = "label" in target ? target.label : "Custom";
-    const filePath = this.outputPath(ctx);
-    const content = [
-      "---",
-      `name: ${agent.name}`,
-      `description: ${agent.description}`,
-      `id: ${agent.id}`,
-      `target: ${label}`,
-      "---",
-      "",
-      renderedInstructions,
-      ""
-    ].join("\n");
-    const changed = writeFileIfChanged(filePath, content);
-    return { outputPath: filePath, content, unchanged: !changed };
-  }
-};
-
-// src/exporters/gemini.ts
-var path26 = __toESM(require("path"));
-init_fs();
-var GeminiExporter = class {
-  constructor() {
-    this.targetType = "gemini";
-  }
-  outputPath(ctx) {
-    const { agent, target, projectRoot } = ctx;
-    const outputDir = "outputDir" in target ? target.outputDir : ".gemini/agents";
-    return path26.resolve(projectRoot, outputDir, `${agent.id.replace(/::/g, "--")}.yaml`);
-  }
-  export(ctx) {
-    const { agent, renderedInstructions } = ctx;
-    const filePath = this.outputPath(ctx);
-    const indentedInstructions = renderedInstructions.split("\n").map((line) => line.length > 0 ? `  ${line}` : "").join("\n");
-    const content = [
-      `name: ${yamlString(agent.name)}`,
-      `description: ${yamlString(agent.description)}`,
-      `system_prompt: |`,
-      indentedInstructions,
-      ""
-    ].join("\n");
-    const changed = writeFileIfChanged(filePath, content);
-    return { outputPath: filePath, content, unchanged: !changed };
-  }
-};
-function yamlString(value) {
-  if (/[:#\[\]{},&*!|>'"%@`]/.test(value) || value.startsWith(" ") || value.endsWith(" ")) {
-    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
-  }
-  return value;
-}
-
-// src/exporters/generate.ts
-var path27 = __toESM(require("path"));
-init_core();
-init_execution_profile();
-init_budget_policy();
-init_fs();
-
-// src/exporters/registry.ts
-init_errors();
-var EXPORTERS = /* @__PURE__ */ new Map([
-  ["claude", new ClaudeExporter({ emitBudget: true })],
-  ["gemini", new GeminiExporter()],
-  ["agy", new GeminiExporter()],
-  ["cursor", new ClaudeExporter()],
-  ["copilot", new ClaudeExporter()],
-  ["codex", new ClaudeExporter()],
-  ["custom", new CustomExporter()]
-]);
-function getExporter(target) {
-  const type = typeof target === "string" ? target : target.type;
-  const exporter = EXPORTERS.get(type);
-  if (!exporter) {
-    throw new WaironError(`No exporter registered for target type: "${type}"`);
-  }
-  return exporter;
-}
-function registerExporter(type, exporter) {
-  EXPORTERS.set(type, exporter);
-}
-
-// src/exporters/generate.ts
-function generateAgent(agent, projectConfig, options = {}) {
-  const projectRoot = options.projectRoot ?? getProjectRoot();
-  const template = loadTemplate(agent.template, projectConfig.globalTemplatesDir);
-  const rendered = `${WAIRON_MANAGED_BANNER}
-${composeAgentBrief(agent.id).instructions}`;
-  const results = [];
-  const budget = resolveBudget(
-    deriveExecutionProfile(agent),
-    projectConfig.execution,
-    agent.id
-  );
-  for (const agentTarget of agent.targets) {
-    const targetConfig = resolveTargetConfig(agentTarget, projectConfig);
-    if (!targetConfig) continue;
-    if (options.filterTargets) {
-      const type = "type" in targetConfig ? targetConfig.type : targetConfig;
-      if (!options.filterTargets.includes(type)) continue;
-    }
-    if (!options.dryRun) {
-      results.push(getExporter(targetConfig).export({
-        agent,
-        template,
-        renderedInstructions: rendered,
-        projectRoot,
-        target: targetConfig,
-        budget
-      }));
-    }
-  }
-  return { agent, results };
-}
-function generateAll(agents, projectConfig, options = {}) {
-  let pool = agents;
-  if (options.filterDomainIds && options.filterDomainIds.length > 0) {
-    const ids = new Set(options.filterDomainIds);
-    pool = agents.filter((a) => ids.has(a.domainRoot ?? "root"));
-  }
-  return pool.map((agent) => generateAgent(agent, projectConfig, options));
-}
-function resolveExpectedOutputPaths(agents, projectConfig, projectRoot = getProjectRoot()) {
-  const expected = /* @__PURE__ */ new Set();
-  for (const agent of agents) {
-    for (const agentTarget of agent.targets) {
-      const targetConfig = resolveTargetConfig(agentTarget, projectConfig);
-      if (!targetConfig) continue;
-      const ctx = { agent, projectRoot, target: targetConfig };
-      expected.add(path27.resolve(getExporter(targetConfig).outputPath(ctx)));
-    }
-  }
-  return expected;
-}
-function resolveTargetConfig(agentTarget, projectConfig) {
-  const targetType = typeof agentTarget === "string" ? agentTarget : agentTarget.type;
-  return projectConfig.targets.find((t) => {
-    if (typeof t === "string") return t === targetType;
-    return t.type === targetType;
-  });
-}
+// src/exporters/index.ts
+init_base();
+init_claude();
+init_custom();
+init_gemini();
+init_generate();
+init_registry2();
 
 // src/utils/index.ts
 init_errors();