@pleri/olam-cli 0.1.174 → 0.1.180

package/dist/index.js

@@ -492,8 +492,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path96, errorMaps, issueData } = params;
-      const fullPath = [...path96, ...issueData.path || []];
+      const { data, path: path97, errorMaps, issueData } = params;
+      const fullPath = [...path97, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -801,11 +801,11 @@ var init_types = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path96, key) {
+      constructor(parent, value, path97, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path96;
+        this._path = path97;
         this._key = key;
       }
       get path() {
@@ -4286,7 +4286,7 @@ import YAML from "yaml";
 function bootstrapStepCmd(entry) {
   return typeof entry === "string" ? entry : entry.cmd;
 }
-function refineForbiddenKeys(value, path96, ctx, rejectSource) {
+function refineForbiddenKeys(value, path97, ctx, rejectSource) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     return;
   }
@@ -4294,12 +4294,12 @@ function refineForbiddenKeys(value, path96, ctx, rejectSource) {
     if (FORBIDDEN_KEYS.has(key)) {
       ctx.addIssue({
         code: external_exports.ZodIssueCode.custom,
-        path: [...path96, key],
+        path: [...path97, key],
         message: `forbidden key "${key}" (prototype-pollution surface)`
       });
       continue;
     }
-    if (rejectSource && path96.length === 0 && key === "source") {
+    if (rejectSource && path97.length === 0 && key === "source") {
       ctx.addIssue({
         code: external_exports.ZodIssueCode.custom,
         path: ["source"],
@@ -4307,21 +4307,21 @@ function refineForbiddenKeys(value, path96, ctx, rejectSource) {
       });
       continue;
     }
-    refineForbiddenKeys(value[key], [...path96, key], ctx, false);
+    refineForbiddenKeys(value[key], [...path97, key], ctx, false);
   }
 }
-function rejectForbiddenKeys(value, path96, rejectSource) {
+function rejectForbiddenKeys(value, path97, rejectSource) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     return;
   }
   for (const key of Object.keys(value)) {
     if (FORBIDDEN_KEYS.has(key)) {
-      throw new Error(`[manifest] ${path96}: forbidden key "${key}" (prototype-pollution surface)`);
+      throw new Error(`[manifest] ${path97}: forbidden key "${key}" (prototype-pollution surface)`);
     }
     if (rejectSource && key === "source") {
-      throw new Error(`[manifest] ${path96}: top-level "source" is loader-stamped \u2014 manifests must not author it`);
+      throw new Error(`[manifest] ${path97}: top-level "source" is loader-stamped \u2014 manifests must not author it`);
     }
-    rejectForbiddenKeys(value[key], `${path96}.${key}`, false);
+    rejectForbiddenKeys(value[key], `${path97}.${key}`, false);
   }
 }
 function unknownTopLevelKeys(parsed) {
@@ -5515,8 +5515,8 @@ var init_client = __esm({
           throw new Error(`failed to report rate-limit for ${accountId} (HTTP ${res.status})`);
         }
       }
-      async request(method, path96, body, attempt = 0) {
-        const url2 = `${this.baseUrl}${path96}`;
+      async request(method, path97, body, attempt = 0) {
+        const url2 = `${this.baseUrl}${path97}`;
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeoutMs);
         const headers = {};
@@ -5534,7 +5534,7 @@ var init_client = __esm({
         } catch (err) {
           if (attempt < RETRY_COUNT && isTransient(err)) {
             await sleep(RETRY_BACKOFF_MS * (attempt + 1));
-            return this.request(method, path96, body, attempt + 1);
+            return this.request(method, path97, body, attempt + 1);
           }
           throw err;
         } finally {
@@ -5977,6 +5977,22 @@ function readAuthSecret() {
     return "";
   }
 }
+function readAnthropicBaseUrl() {
+  const fromOlamEnv = process.env["OLAM_ANTHROPIC_BASE_URL"];
+  if (fromOlamEnv && fromOlamEnv.length > 0)
+    return fromOlamEnv.trim();
+  const file = path11.join(os6.homedir(), ".olam", "anthropic-base-url");
+  try {
+    const content = fs10.readFileSync(file, "utf-8").trim();
+    if (content.length > 0)
+      return content;
+  } catch {
+  }
+  const fromShellEnv = process.env["ANTHROPIC_BASE_URL"];
+  if (fromShellEnv && fromShellEnv.length > 0)
+    return fromShellEnv.trim();
+  return "";
+}
 function readHostCpToken() {
   const fromEnv = process.env["OLAM_HOST_CP_TOKEN"];
   if (fromEnv && fromEnv.length > 0)
@@ -6196,6 +6212,7 @@ var init_container2 = __esm({
       const labels = olamLabels(worldId, worldName);
       const authSecret = readAuthSecret();
       const hostCpToken = readHostCpToken();
+      const anthropicBaseUrl = readAnthropicBaseUrl();
       const memoryEnv = resolveMemoryEnv();
       const worldEnv = {
         OLAM_WORLD_ID: worldId,
@@ -6219,6 +6236,15 @@ var init_container2 = __esm({
         ...isKubernetesServiceSubstrate() ? { OLAM_KG_SERVICE_URL: TRAEFIK_INGRESS_KG_URL } : {},
         ...authSecret ? { OLAM_AUTH_SECRET: authSecret } : {},
         ...hostCpToken ? { OLAM_HOST_CP_TOKEN: hostCpToken } : {},
+        // Cloud-mode Anthropic proxy: when an auth-worker bearer URL is configured
+        // (~/.olam/anthropic-base-url file OR OLAM_ANTHROPIC_BASE_URL env), every
+        // outbound Claude call from inside the world is routed through it via
+        // URL-userinfo Basic auth. The container's Claude Code + Anthropic SDK
+        // respect ANTHROPIC_BASE_URL natively; no per-caller change required.
+        // When unset, the in-world fetch-creds.mjs helper still pulls from the
+        // local OLAM_AUTH_SERVICE_URL (host.docker.internal:9999) — zero
+        // regression for existing local-mode operators.
+        ...anthropicBaseUrl ? { ANTHROPIC_BASE_URL: anthropicBaseUrl } : {},
         // Phase B1 + C4 — agent-memory wiring. URL + secret resolved together
         // by resolveMemoryEnv() above:
         //   - local mode (or no config): URL = host.docker.internal:3111,
@@ -7337,8 +7363,8 @@ var init_provider3 = __esm({
       // -----------------------------------------------------------------------
       // Internal fetch helper
       // -----------------------------------------------------------------------
-      async request(path96, method, body) {
-        const url2 = `${this.config.workerUrl}${path96}`;
+      async request(path97, method, body) {
+        const url2 = `${this.config.workerUrl}${path97}`;
         const bearer = await this.config.mintToken();
         const headers = {
           Authorization: `Bearer ${bearer}`
@@ -9202,17 +9228,17 @@ function kgRoot() {
 function worldsRoot() {
   return join17(olamHome(), "worlds");
 }
-function assertWithinPrefix(path96, prefix, label) {
-  if (!path96.startsWith(prefix + "/")) {
-    throw new Error(`${label} escape: ${path96} not under ${prefix}/`);
+function assertWithinPrefix(path97, prefix, label) {
+  if (!path97.startsWith(prefix + "/")) {
+    throw new Error(`${label} escape: ${path97} not under ${prefix}/`);
   }
 }
 function kgPristinePath(workspace) {
   validateWorkspaceName(workspace);
   const root = kgRoot();
-  const path96 = resolve6(join17(root, workspace));
-  assertWithinPrefix(path96, root, "kgPristinePath");
-  return path96;
+  const path97 = resolve6(join17(root, workspace));
+  assertWithinPrefix(path97, root, "kgPristinePath");
+  return path97;
 }
 var KG_PATHS_INTERNALS;
 var init_storage_paths = __esm({
@@ -9327,8 +9353,8 @@ import { execFileSync as execFileSync4 } from "node:child_process";
 import * as fs15 from "node:fs";
 import * as os9 from "node:os";
 import * as path17 from "node:path";
-function expandHome2(p, homedir64) {
-  return p.replace(/^~(?=$|\/|\\)/, homedir64());
+function expandHome2(p, homedir67) {
+  return p.replace(/^~(?=$|\/|\\)/, homedir67());
 }
 function sanitizeRepoFilename(name) {
   const sanitized = name.replace(/[^A-Za-z0-9._-]/g, "_");
@@ -9351,7 +9377,7 @@ ${stderr}`;
 }
 function snapshotBaselineDiff(repos, workspacePath, deps = {}) {
   const exec = deps.exec ?? ((cmd, args, opts) => execFileSync4(cmd, args, opts));
-  const homedir64 = deps.homedir ?? (() => os9.homedir());
+  const homedir67 = deps.homedir ?? (() => os9.homedir());
   const baselineDir = path17.join(workspacePath, ".olam", "baseline");
   try {
     fs15.mkdirSync(baselineDir, { recursive: true });
@@ -9367,7 +9393,7 @@ function snapshotBaselineDiff(repos, workspacePath, deps = {}) {
       continue;
     const filename = `${sanitizeRepoFilename(repo.name)}.diff`;
     const outPath = path17.join(baselineDir, filename);
-    const repoPath = expandHome2(repo.path, homedir64);
+    const repoPath = expandHome2(repo.path, homedir67);
     if (!fs15.existsSync(repoPath)) {
       writeBaselineFile(outPath, `# repo: ${repo.name}
 # (skipped: path ${repoPath} does not exist)
@@ -9487,21 +9513,21 @@ function extractStderr(err) {
 }
 function carryUncommittedEdits(repos, workspacePath, deps = {}) {
   const exec = deps.exec ?? ((cmd, args, opts) => execFileSync4(cmd, args, opts));
-  const homedir64 = deps.homedir ?? (() => os9.homedir());
-  const existsSync113 = deps.existsSync ?? ((p) => fs15.existsSync(p));
-  const copyFileSync16 = deps.copyFileSync ?? ((src, dest) => fs15.copyFileSync(src, dest));
-  const mkdirSync67 = deps.mkdirSync ?? ((dirPath, opts) => {
+  const homedir67 = deps.homedir ?? (() => os9.homedir());
+  const existsSync115 = deps.existsSync ?? ((p) => fs15.existsSync(p));
+  const copyFileSync17 = deps.copyFileSync ?? ((src, dest) => fs15.copyFileSync(src, dest));
+  const mkdirSync68 = deps.mkdirSync ?? ((dirPath, opts) => {
     fs15.mkdirSync(dirPath, opts);
   });
   const plans = [];
   for (const repo of repos) {
     if (!repo.path)
       continue;
-    const repoPath = expandHome2(repo.path, homedir64);
+    const repoPath = expandHome2(repo.path, homedir67);
     const worktreePath = path17.join(workspacePath, repo.name);
-    if (!existsSync113(repoPath))
+    if (!existsSync115(repoPath))
       continue;
-    if (!existsSync113(worktreePath)) {
+    if (!existsSync115(worktreePath)) {
       console.warn(`[carry] ${repo.name}: world worktree ${worktreePath} missing; skipping carry for this repo`);
       continue;
     }
@@ -9561,11 +9587,11 @@ function carryUncommittedEdits(repos, workspacePath, deps = {}) {
     for (const rel of plan.diff.untracked) {
       const src = path17.join(plan.repoPath, rel);
       const dest = path17.join(plan.worktreePath, rel);
-      if (!existsSync113(src))
+      if (!existsSync115(src))
         continue;
       try {
-        mkdirSync67(path17.dirname(dest), { recursive: true });
-        copyFileSync16(src, dest);
+        mkdirSync68(path17.dirname(dest), { recursive: true });
+        copyFileSync17(src, dest);
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         console.warn(`[carry] ${plan.name}: copy untracked ${rel} failed: ${msg}`);
@@ -15485,7 +15511,20 @@ function removePid() {
 }
 async function findHostCpContainer() {
   const docker3 = new Dockerode2(resolveDockerHostOptions());
-  const containers = await docker3.listContainers({ all: true });
+  let timer = null;
+  const listing = docker3.listContainers({ all: true }).then((cs) => cs);
+  const timeout = new Promise((resolve27) => {
+    timer = setTimeout(() => resolve27(null), DOCKER_PROBE_TIMEOUT_MS);
+  });
+  let containers;
+  try {
+    containers = await Promise.race([listing, timeout]);
+  } catch {
+    containers = null;
+  } finally {
+    if (timer !== null) clearTimeout(timer);
+  }
+  if (containers === null) return null;
   for (const c of containers) {
     const names = (c.Names ?? []).map((n) => n.replace(/^\//, ""));
     if (names.includes("olam-host-cp")) {
@@ -15859,10 +15898,10 @@ async function readHostCpToken2() {
   if (!fs26.existsSync(tp)) return null;
   return fs26.readFileSync(tp, "utf-8").trim();
 }
-async function callHostCpProxy(method, worldId, path96, body) {
+async function callHostCpProxy(method, worldId, path97, body) {
   const token = await readHostCpToken2();
   if (!token) return { ok: false, status: 0, error: "no token (host CP not started)" };
-  const url2 = `http://127.0.0.1:${HOST_CP_PORT}/api/world/${encodeURIComponent(worldId)}${path96}`;
+  const url2 = `http://127.0.0.1:${HOST_CP_PORT}/api/world/${encodeURIComponent(worldId)}${path97}`;
   try {
     const headers = {
       Authorization: `Bearer ${token}`
@@ -15966,7 +16005,7 @@ async function handleDeregister(opts) {
   }
   printSuccess(`Deregistered ${opts.world}`);
 }
-var HOST_CP_PORT, SIDECAR_PULL_SERVICE;
+var HOST_CP_PORT, DOCKER_PROBE_TIMEOUT_MS, SIDECAR_PULL_SERVICE;
 var init_host_cp = __esm({
   "src/commands/host-cp.ts"() {
     "use strict";
@@ -15977,6 +16016,7 @@ var init_host_cp = __esm({
     init_cli_version();
     init_open_url();
     HOST_CP_PORT = 19e3;
+    DOCKER_PROBE_TIMEOUT_MS = 2e3;
     SIDECAR_PULL_SERVICE = "docker-socket-proxy";
   }
 });
@@ -16337,31 +16377,31 @@ __export(from_manifest_exports, {
   provenanceLine: () => provenanceLine
 });
 import { readFileSync as readFileSync30 } from "node:fs";
-function parseForkManifest(path96) {
+function parseForkManifest(path97) {
   let raw;
   try {
-    raw = readFileSync30(path96, "utf8");
+    raw = readFileSync30(path97, "utf8");
   } catch (err) {
     const reason = err?.code === "ENOENT" ? "file does not exist" : err.message;
-    throw new Error(`--from-manifest: cannot read ${path96} (${reason})`);
+    throw new Error(`--from-manifest: cannot read ${path97} (${reason})`);
   }
   let json;
   try {
     json = JSON.parse(raw);
   } catch (err) {
-    throw new Error(`--from-manifest: ${path96} is not valid JSON (${err.message})`);
+    throw new Error(`--from-manifest: ${path97} is not valid JSON (${err.message})`);
   }
   if (!isPlainObject2(json)) {
-    throw new Error(`--from-manifest: ${path96} root must be a JSON object`);
+    throw new Error(`--from-manifest: ${path97} root must be a JSON object`);
   }
   const originalWorldId = json.originalWorldId;
   if (typeof originalWorldId !== "string" || originalWorldId.trim().length === 0) {
-    throw new Error(`--from-manifest: ${path96} missing required string "originalWorldId"`);
+    throw new Error(`--from-manifest: ${path97} missing required string "originalWorldId"`);
   }
   const newPrompt = json.newPrompt;
   if (typeof newPrompt !== "string" || newPrompt.trim().length === 0) {
     throw new Error(
-      `--from-manifest: ${path96} has no "newPrompt" \u2014 re-run trace-replay with --with-prompt "<alternate dispatch>"`
+      `--from-manifest: ${path97} has no "newPrompt" \u2014 re-run trace-replay with --with-prompt "<alternate dispatch>"`
     );
   }
   const fp = isPlainObject2(json.forkPoint) ? json.forkPoint : {};
@@ -16372,7 +16412,7 @@ function parseForkManifest(path96) {
     originalWorldId: originalWorldId.trim(),
     forkPoint: { resolvedPhase, resolvedSpanId, resolvedAt },
     newPrompt,
-    manifestPath: path96
+    manifestPath: path97
   };
 }
 function defaultNameFromManifest(manifest) {
@@ -17498,8 +17538,8 @@ var init_artifact_resolver = __esm({
 });
 
 // ../core/dist/lib/shim-targets.js
-function lookupShimTarget(basename16) {
-  return SHIM_TARGETS.find((t) => t.basename === basename16);
+function lookupShimTarget(basename17) {
+  return SHIM_TARGETS.find((t) => t.basename === basename17);
 }
 function compareSemver(installed, required) {
   const norm = (s) => {
@@ -17518,8 +17558,8 @@ function compareSemver(installed, required) {
   }
   return 0;
 }
-function checkShimRemoval(basename16, installedOlamVersion) {
-  const target = lookupShimTarget(basename16);
+function checkShimRemoval(basename17, installedOlamVersion) {
+  const target = lookupShimTarget(basename17);
   if (target === void 0)
     return null;
   return {
@@ -17600,11 +17640,11 @@ function detectCollisions(artifacts) {
   }
   const collisions = [];
   for (const [key, loserList] of losersByKey.entries()) {
-    const [bucket, basename16] = key.split("\0");
+    const [bucket, basename17] = key.split("\0");
     const winner = seen.get(key);
     collisions.push({
       bucket,
-      basename: basename16,
+      basename: basename17,
       winnerSourceId: winner.sourceId,
       winnerSourcePath: winner.sourcePath,
       loserSourceIds: loserList.map((l) => l.sourceId),
@@ -17649,8 +17689,8 @@ function cleanManagedSymlinks(claude, installedOlamVersion, overlayReferences, e
         } else if (bucket === "agents" && stat.isFile() && !name.includes(".shadow-backup-")) {
           const hasWinner = expectedAgentWinnerNames !== void 0 ? expectedAgentWinnerNames.has(name) : true;
           if (hasWinner) {
-            const backup3 = shadowBackup(p);
-            shadowBackups.push(backup3);
+            const backup4 = shadowBackup(p);
+            shadowBackups.push(backup4);
           }
         }
       } catch {
@@ -17661,9 +17701,9 @@ function cleanManagedSymlinks(claude, installedOlamVersion, overlayReferences, e
 }
 function shadowBackup(link) {
   const epoch = Math.floor(Date.now() / 1e3);
-  const backup3 = `${link}.shadow-backup-${epoch}`;
-  fs59.renameSync(link, backup3);
-  return backup3;
+  const backup4 = `${link}.shadow-backup-${epoch}`;
+  fs59.renameSync(link, backup4);
+  return backup4;
 }
 function linkIfNeeded(target, link) {
   try {
@@ -17677,14 +17717,14 @@ function linkIfNeeded(target, link) {
     isLink = fs59.lstatSync(link).isSymbolicLink();
   } catch {
   }
-  let backup3;
+  let backup4;
   if (isLink) {
     fs59.unlinkSync(link);
   } else if (fs59.existsSync(link)) {
-    backup3 = shadowBackup(link);
+    backup4 = shadowBackup(link);
   }
   fs59.symlinkSync(target, link);
-  return { created: true, shadowBackup: backup3 };
+  return { created: true, shadowBackup: backup4 };
 }
 function deployArtifacts(artifacts, opts) {
   const claude = claudeDir();
@@ -17707,11 +17747,11 @@ function deployArtifacts(artifacts, opts) {
       result.linked += 1;
       continue;
     }
-    const { created, shadowBackup: backup3 } = linkIfNeeded(artifact.sourcePath, linkPath);
+    const { created, shadowBackup: backup4 } = linkIfNeeded(artifact.sourcePath, linkPath);
     if (created)
       result.linked += 1;
-    if (backup3)
-      result.shadowBackups.push(backup3);
+    if (backup4)
+      result.shadowBackups.push(backup4);
   }
   return result;
 }
@@ -18421,11 +18461,11 @@ function scanOverlayReferences(overlayRoot, basenames, caps = DEFAULT_CAPS) {
       throw err;
     }
     const relpath = path65.relative(overlayRoot, filepath).split(path65.sep).join("/");
-    for (const basename16 of basenames) {
-      if (content.includes(basename16)) {
-        const list = result.get(basename16) ?? [];
+    for (const basename17 of basenames) {
+      if (content.includes(basename17)) {
+        const list = result.get(basename17) ?? [];
         list.push(relpath);
-        result.set(basename16, list);
+        result.set(basename17, list);
       }
     }
   }
@@ -19338,12 +19378,12 @@ function sourceConfigPath(clonePath) {
   return join76(clonePath, "shared", "source-config.yaml");
 }
 function readSourceConfig(clonePath, sourceId) {
-  const path96 = sourceConfigPath(clonePath);
-  if (!existsSync77(path96))
+  const path97 = sourceConfigPath(clonePath);
+  if (!existsSync77(path97))
     return void 0;
   let raw;
   try {
-    raw = readFileSync67(path96, "utf-8");
+    raw = readFileSync67(path97, "utf-8");
   } catch (err) {
     emitMalformedWarning(sourceId, `read failed: ${errToMsg(err)}`);
     return void 0;
@@ -19882,12 +19922,12 @@ function restoreShadowBackup(opts) {
   if (!fs71.existsSync(abs)) {
     throw new Error(`backup file not found: ${abs}`);
   }
-  const basename16 = path71.basename(abs);
-  const match2 = SHADOW_BACKUP_SUFFIX_RE.exec(basename16);
+  const basename17 = path71.basename(abs);
+  const match2 = SHADOW_BACKUP_SUFFIX_RE.exec(basename17);
   if (!match2) {
-    throw new Error(`not a shadow-backup file (basename "${basename16}" does not match \`.shadow-backup-<epoch>\`): ${abs}`);
+    throw new Error(`not a shadow-backup file (basename "${basename17}" does not match \`.shadow-backup-<epoch>\`): ${abs}`);
   }
-  const originalBasename = basename16.slice(0, basename16.length - match2[0].length);
+  const originalBasename = basename17.slice(0, basename17.length - match2[0].length);
   const originalPath = path71.join(path71.dirname(abs), originalBasename);
   if (fs71.existsSync(originalPath) && !opts.force) {
     throw new Error(`original path already occupied: ${originalPath}. Move/rename it first OR re-run with --force.`);
@@ -20507,11 +20547,11 @@ __export(project_sweep_exports, {
 });
 import * as path74 from "node:path";
 import { readdirSync as readdirSync25, lstatSync as lstatSync6, statSync as statSync25, existsSync as existsSync82 } from "node:fs";
-function isSkipped(basename16, extra) {
-  if (DEFAULT_SKIP.has(basename16))
+function isSkipped(basename17, extra) {
+  if (DEFAULT_SKIP.has(basename17))
     return true;
   for (const pattern of extra) {
-    if (basename16 === pattern)
+    if (basename17 === pattern)
       return true;
   }
   return false;
@@ -20936,16 +20976,16 @@ function isValidConfig(value) {
   if (typeof v.install_id !== "string" || v.install_id.length === 0) return false;
   return true;
 }
-function atomicWriteJSON(path96, value, stderr = process.stderr) {
+function atomicWriteJSON(path97, value, stderr = process.stderr) {
   ensureStateDir();
-  const dir = dirname3(path96);
+  const dir = dirname3(path97);
   if (!existsSync6(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
-  const tmp = `${path96}.tmp.${process.pid}`;
+  const tmp = `${path97}.tmp.${process.pid}`;
   try {
     writeFileSync2(tmp, JSON.stringify(value, null, 2) + "\n", { encoding: "utf8" });
-    renameSync2(tmp, path96);
+    renameSync2(tmp, path97);
   } catch (err) {
     if (existsSync6(tmp)) {
       try {
@@ -21306,9 +21346,9 @@ var UnknownArchetypeError = class extends Error {
 };
 var ArchetypeCycleError = class extends Error {
   path;
-  constructor(path96) {
-    super(`Archetype inheritance cycle detected: ${path96.join(" \u2192 ")} \u2192 ${path96[0] ?? "?"}`);
-    this.path = path96;
+  constructor(path97) {
+    super(`Archetype inheritance cycle detected: ${path97.join(" \u2192 ")} \u2192 ${path97[0] ?? "?"}`);
+    this.path = path97;
     this.name = "ArchetypeCycleError";
   }
 };
@@ -22107,14 +22147,14 @@ function ensureSecrets() {
   step("1/6 \u2014 operator secrets");
   mkdirSync19(OLAM_HOME3, { recursive: true });
   for (const name of SECRET_FILES) {
-    const path96 = join34(OLAM_HOME3, name);
-    if (existsSync29(path96)) {
+    const path97 = join34(OLAM_HOME3, name);
+    if (existsSync29(path97)) {
       printInfo("skip", `~/.olam/${name} already exists`);
       continue;
     }
     const hex = randomBytes7(32).toString("hex");
-    writeFileSync15(path96, hex + "\n", { encoding: "utf8", mode: 384 });
-    chmodSync4(path96, 384);
+    writeFileSync15(path97, hex + "\n", { encoding: "utf8", mode: 384 });
+    chmodSync4(path97, 384);
     printSuccess(`generated ~/.olam/${name}`);
   }
 }
@@ -22237,13 +22277,13 @@ function installObservability(opts) {
     scriptEnv.OLAM_BUNDLE_ROOT = bundleRoot;
   }
   for (const script of OBSERVABILITY_SCRIPTS) {
-    const path96 = join34(observabilityDir, script);
-    if (!existsSync29(path96)) {
+    const path97 = join34(observabilityDir, script);
+    if (!existsSync29(path97)) {
       printWarning(`observability script missing: ${script} \u2014 skipping`);
       continue;
     }
     printInfo("run", script);
-    const result = spawnSync10("bash", [path96], {
+    const result = spawnSync10("bash", [path97], {
       stdio: "inherit",
       env: scriptEnv
     });
@@ -23252,56 +23292,56 @@ var SECRET_LEN_BYTES = 32;
 function generateSecret() {
   return randomBytes8(SECRET_LEN_BYTES).toString("hex");
 }
-function writeSecretAtPath(path96, value) {
-  mkdirSync21(dirname22(path96), { recursive: true });
-  const tmp = `${path96}.tmp.${process.pid}`;
+function writeSecretAtPath(path97, value) {
+  mkdirSync21(dirname22(path97), { recursive: true });
+  const tmp = `${path97}.tmp.${process.pid}`;
   writeFileSync16(tmp, value, { mode: 384 });
   chmodSync5(tmp, 384);
-  renameSync6(tmp, path96);
+  renameSync6(tmp, path97);
 }
-function readSecretAtPathOrNull(path96) {
-  if (!existsSync32(path96)) return null;
-  const mode = statSync8(path96).mode & 511;
+function readSecretAtPathOrNull(path97) {
+  if (!existsSync32(path97)) return null;
+  const mode = statSync8(path97).mode & 511;
   if (mode !== 384) {
     process.stderr.write(
-      `warn: ${path96} has mode 0${mode.toString(8)}; expected 0600. Run 'olam memory secret rotate' to regenerate.
+      `warn: ${path97} has mode 0${mode.toString(8)}; expected 0600. Run 'olam memory secret rotate' to regenerate.
 `
     );
   }
-  return readFileSync25(path96, "utf8").trim();
+  return readFileSync25(path97, "utf8").trim();
 }
-function readSecretAtPath(path96) {
-  const v = readSecretAtPathOrNull(path96);
+function readSecretAtPath(path97) {
+  const v = readSecretAtPathOrNull(path97);
   if (v === null) {
     throw new Error(
-      `Secret not found at ${path96}. Run 'olam memory start' to generate it.`
+      `Secret not found at ${path97}. Run 'olam memory start' to generate it.`
     );
   }
   return v;
 }
-function ensureMemorySecret(path96 = MEMORY_SECRET_PATH) {
-  const existing = readSecretAtPathOrNull(path96);
+function ensureMemorySecret(path97 = MEMORY_SECRET_PATH) {
+  const existing = readSecretAtPathOrNull(path97);
   if (existing) return existing;
   const fresh = generateSecret();
-  writeSecretAtPath(path96, fresh);
+  writeSecretAtPath(path97, fresh);
   return fresh;
 }
-function readMemorySecretOrNull(path96 = MEMORY_SECRET_PATH) {
-  return readSecretAtPathOrNull(path96);
+function readMemorySecretOrNull(path97 = MEMORY_SECRET_PATH) {
+  return readSecretAtPathOrNull(path97);
 }
-function readMemorySecret(path96 = MEMORY_SECRET_PATH) {
-  return readSecretAtPath(path96);
+function readMemorySecret(path97 = MEMORY_SECRET_PATH) {
+  return readSecretAtPath(path97);
 }
-function rotateMemorySecret(path96 = MEMORY_SECRET_PATH) {
+function rotateMemorySecret(path97 = MEMORY_SECRET_PATH) {
   const fresh = generateSecret();
-  writeSecretAtPath(path96, fresh);
+  writeSecretAtPath(path97, fresh);
   return fresh;
 }
-function hasMemorySecret(path96 = MEMORY_SECRET_PATH) {
-  return existsSync32(path96);
+function hasMemorySecret(path97 = MEMORY_SECRET_PATH) {
+  return existsSync32(path97);
 }
-function writeCloudMemorySecret(value, path96 = CLOUD_MEMORY_SECRET_PATH) {
-  writeSecretAtPath(path96, value);
+function writeCloudMemorySecret(value, path97 = CLOUD_MEMORY_SECRET_PATH) {
+  writeSecretAtPath(path97, value);
 }
 
 // src/commands/memory-service-container.ts
@@ -24408,12 +24448,12 @@ function appendAuditEntry(entry, auditLogPath, writeFileSyncImpl) {
 async function runManifestRefresh(manifestsDir, acceptRegression, deps = {}, peripheral) {
   const auditLogPath = deps.auditLogPath ?? MANIFEST_REFRESH_AUDIT_LOG;
   const readdirSync33 = deps.readdirSync ?? fs31.readdirSync;
-  const readFileSync96 = deps.readFileSync ?? fs31.readFileSync;
+  const readFileSync99 = deps.readFileSync ?? fs31.readFileSync;
   const writeFileSyncImpl = deps.writeFileSync ?? fs31.writeFileSync;
-  const existsSync113 = deps.existsSync ?? fs31.existsSync;
+  const existsSync115 = deps.existsSync ?? fs31.existsSync;
   const now = deps.now ? deps.now() : /* @__PURE__ */ new Date();
   const targetDir = peripheral ? path32.join(manifestsDir, peripheral) : manifestsDir;
-  if (!existsSync113(targetDir)) {
+  if (!existsSync115(targetDir)) {
     return {
       ok: false,
       message: peripheral ? `peripheral manifests directory not found: ${targetDir}` : `manifests directory not found: ${targetDir}`
@@ -24434,7 +24474,7 @@ async function runManifestRefresh(manifestsDir, acceptRegression, deps = {}, per
     const filePath = path32.join(targetDir, file);
     let content;
     try {
-      content = readFileSync96(filePath, "utf8");
+      content = readFileSync99(filePath, "utf8");
     } catch {
       continue;
     }
@@ -24685,11 +24725,11 @@ async function checkSecretPreCondition(context, deps) {
 }
 async function applyConfigMapSubstitution(context, manifestsDir, deps) {
   const wrap = deps.kubectlWrapImpl ?? kubectlWrap;
-  const readFileSync96 = deps.readFileSyncImpl ?? fs32.readFileSync;
+  const readFileSync99 = deps.readFileSyncImpl ?? fs32.readFileSync;
   const configMapPath = path33.join(manifestsDir, "30-configmap.yaml");
   let rawYaml;
   try {
-    rawYaml = readFileSync96(configMapPath, "utf8");
+    rawYaml = readFileSync99(configMapPath, "utf8");
   } catch (err) {
     return `Failed to read ConfigMap at ${configMapPath}: ${err instanceof Error ? err.message : String(err)}`;
   }
@@ -26059,9 +26099,9 @@ function formatFreshnessWarning(result, image = DEFAULT_DEVBOX_IMAGE) {
     "These source files have changed since the image was built; the",
     "changes will NOT take effect in fresh worlds until you rebuild:"
   ];
-  for (const { path: path96, mtimeMs } of result.newerSources) {
+  for (const { path: path97, mtimeMs } of result.newerSources) {
     const when = new Date(mtimeMs).toISOString();
-    lines.push(`  \u2022 ${path96}  (modified ${when})`);
+    lines.push(`  \u2022 ${path97}  (modified ${when})`);
   }
   lines.push("");
   lines.push("Rebuild with:");
@@ -26440,15 +26480,15 @@ var AGENTMEMORY_LOCAL_URL = "http://host.docker.internal:3111";
 var HOST_CP_URL = "http://127.0.0.1:19000";
 async function readHostCpTokenForCreate() {
   try {
-    const { default: fs96 } = await import("node:fs");
-    const { default: os50 } = await import("node:os");
-    const { default: path96 } = await import("node:path");
-    const tp = path96.join(
-      process.env.OLAM_HOME ?? path96.join(os50.homedir(), ".olam"),
+    const { default: fs97 } = await import("node:fs");
+    const { default: os51 } = await import("node:os");
+    const { default: path97 } = await import("node:path");
+    const tp = path97.join(
+      process.env.OLAM_HOME ?? path97.join(os51.homedir(), ".olam"),
       "host-cp.token"
     );
-    if (!fs96.existsSync(tp)) return null;
-    return fs96.readFileSync(tp, "utf-8").trim();
+    if (!fs97.existsSync(tp)) return null;
+    return fs97.readFileSync(tp, "utf-8").trim();
   } catch {
     return null;
   }
@@ -26936,12 +26976,12 @@ function defaultNameFromPrompt(prompt) {
 }
 async function readHostCpToken3() {
   try {
-    const { default: fs96 } = await import("node:fs");
-    const { default: os50 } = await import("node:os");
-    const { default: path96 } = await import("node:path");
-    const tp = path96.join(os50.homedir(), ".olam", "host-cp.token");
-    if (!fs96.existsSync(tp)) return null;
-    const raw = fs96.readFileSync(tp, "utf-8").trim();
+    const { default: fs97 } = await import("node:fs");
+    const { default: os51 } = await import("node:os");
+    const { default: path97 } = await import("node:path");
+    const tp = path97.join(os51.homedir(), ".olam", "host-cp.token");
+    if (!fs97.existsSync(tp)) return null;
+    const raw = fs97.readFileSync(tp, "utf-8").trim();
     return raw.length > 0 ? raw : null;
   } catch {
     return null;
@@ -28662,13 +28702,13 @@ var PlansClient = class {
     const credentials = Buffer.from(`operator:${this.cfg.bearer}`).toString("base64");
     return `Basic ${credentials}`;
   }
-  async request(path96, init) {
+  async request(path97, init) {
     const headers = {
       Authorization: this.authHeader()
     };
     if (init.body) headers["content-type"] = "application/json";
     if (init.adminSecret) headers["X-Admin-Secret"] = init.adminSecret;
-    return fetch(`${this.cfg.cloudUrl}${path96}`, {
+    return fetch(`${this.cfg.cloudUrl}${path97}`, {
       method: init.method,
       headers,
       body: init.body ? JSON.stringify(init.body) : void 0
@@ -31153,11 +31193,11 @@ function zodIssueToError(issue, doc, lineCounter) {
     suggestion: deriveSuggestion(issue)
   };
 }
-function formatJsonPath(path96) {
-  if (path96.length === 0)
+function formatJsonPath(path97) {
+  if (path97.length === 0)
     return "<root>";
   let out = "";
-  for (const seg of path96) {
+  for (const seg of path97) {
     if (typeof seg === "number") {
       out += `[${seg}]`;
     } else {
@@ -31166,11 +31206,11 @@ function formatJsonPath(path96) {
   }
   return out;
 }
-function resolveYamlLocation(path96, doc, lineCounter) {
+function resolveYamlLocation(path97, doc, lineCounter) {
   let bestLine = 0;
   let bestColumn = 0;
-  for (let depth = path96.length; depth >= 0; depth -= 1) {
-    const segment = path96.slice(0, depth);
+  for (let depth = path97.length; depth >= 0; depth -= 1) {
+    const segment = path97.slice(0, depth);
     try {
       const node = doc.getIn(segment, true);
       if (node && typeof node === "object" && "range" in node) {
@@ -31388,11 +31428,11 @@ function topoSort(nodes) {
 }
 function traceCycle(start, byId) {
   const seen = /* @__PURE__ */ new Set();
-  const path96 = [];
+  const path97 = [];
   let current = start;
   while (current && !seen.has(current)) {
     seen.add(current);
-    path96.push(current);
+    path97.push(current);
     const node = byId.get(current);
     const next = node?.dependsOn[0];
     if (next === void 0)
@@ -31400,10 +31440,10 @@ function traceCycle(start, byId) {
     current = next;
   }
   if (current && seen.has(current)) {
-    const idx = path96.indexOf(current);
-    return [...path96.slice(idx), current];
+    const idx = path97.indexOf(current);
+    return [...path97.slice(idx), current];
   }
-  return path96;
+  return path97;
 }
 
 // ../core/dist/executor/types.js
@@ -36110,8 +36150,8 @@ function checkWorld(container, hostShas, dockerExec) {
     const m = shaLine.match(/^([a-f0-9]{64})\s+(.+)$/);
     if (!m) continue;
     const sha = m[1];
-    const path96 = m[2];
-    const filename = path96?.split("/").pop();
+    const path97 = m[2];
+    const filename = path97?.split("/").pop();
     if (!filename) continue;
     const mtimeSecs = parseInt(mtimeLine.trim(), 10);
     if (Number.isNaN(mtimeSecs) || !sha) continue;
@@ -36978,9 +37018,9 @@ var TasksClient = class {
     this.olamNodeId = opts.olamNodeId;
     this.sessionId = opts.sessionId;
   }
-  async call(method, path96, scopes, body, query) {
+  async call(method, path97, scopes, body, query) {
     const qs = query ? "?" + new URLSearchParams(Object.entries(query).filter(([, v]) => v !== void 0)).toString() : "";
-    const url2 = `${this.baseUrl}${path96}${qs}`;
+    const url2 = `${this.baseUrl}${path97}${qs}`;
     const res = await fetch(url2, {
       method,
       headers: {
@@ -37031,8 +37071,8 @@ function parseFrontmatter2(raw) {
   }
   return { frontmatter: fm, body };
 }
-function parseTracker(path96) {
-  const raw = readFileSync48(path96, "utf8");
+function parseTracker(path97) {
+  const raw = readFileSync48(path97, "utf8");
   const { frontmatter, body } = parseFrontmatter2(raw);
   const lines = body.split("\n");
   const tasks = [];
@@ -37269,8 +37309,8 @@ function registerTasks(program2) {
 `);
     }
   });
-  tasks.command("sync-tracker <path>").description("Parse /10x:commit-plan tracker.md + upsert each task via POST /api/tasks (B2.4; dual-emit pattern, olam-side per cross-ownership decoupling)").option("--node-id <uuid>", "Olam node ID").option("--session-id <uuid>", "Session ID").option("--dry-run", "Parse + print task records; do not POST").option("--json", "Output raw JSON envelope").action(async (path96, opts) => {
-    const parsed = parseTracker(path96);
+  tasks.command("sync-tracker <path>").description("Parse /10x:commit-plan tracker.md + upsert each task via POST /api/tasks (B2.4; dual-emit pattern, olam-side per cross-ownership decoupling)").option("--node-id <uuid>", "Olam node ID").option("--session-id <uuid>", "Session ID").option("--dry-run", "Parse + print task records; do not POST").option("--json", "Output raw JSON envelope").action(async (path97, opts) => {
+    const parsed = parseTracker(path97);
     if (opts.dryRun) {
       process.stdout.write(JSON.stringify(parsed, null, 2) + "\n");
       return;
@@ -37516,9 +37556,9 @@ function appendIdempotent(opts) {
 }
 function resolveShellRc(home, shellEnv) {
   if (!shellEnv) return null;
-  const basename16 = path54.basename(shellEnv);
-  if (basename16 === "zsh") return path54.join(home, ".zshrc");
-  if (basename16 === "bash") return path54.join(home, ".bashrc");
+  const basename17 = path54.basename(shellEnv);
+  if (basename17 === "zsh") return path54.join(home, ".zshrc");
+  if (basename17 === "bash") return path54.join(home, ".bashrc");
   return null;
 }
 
@@ -41319,10 +41359,10 @@ function registerSkillsMigrateHooksBack(program2) {
           process.exitCode = 1;
           return;
         }
-        const basename16 = path85.basename(resolved);
-        if (!basename16.startsWith(META_HOOKS_SNAPSHOT_PREFIX)) {
+        const basename17 = path85.basename(resolved);
+        if (!basename17.startsWith(META_HOOKS_SNAPSHOT_PREFIX)) {
           printError(
-            `--snapshot filename must start with "${META_HOOKS_SNAPSHOT_PREFIX}" (got "${basename16}"). Cross-namespace snapshots (atlas-toolbox-*) are not valid restore targets for olam-meta hooks.`
+            `--snapshot filename must start with "${META_HOOKS_SNAPSHOT_PREFIX}" (got "${basename17}"). Cross-namespace snapshots (atlas-toolbox-*) are not valid restore targets for olam-meta hooks.`
           );
           process.exitCode = 1;
           return;
@@ -42310,8 +42350,8 @@ var SECRET = process.env["OLAM_MCP_AUTH_SECRET"] ?? "";
 function authHeaders() {
   return SECRET ? { "X-Olam-Mcp-Secret": SECRET } : {};
 }
-async function apiFetch(path96, init = {}) {
-  const res = await fetch(`${BASE_URL}${path96}`, {
+async function apiFetch(path97, init = {}) {
+  const res = await fetch(`${BASE_URL}${path97}`, {
     ...init,
     headers: {
       "Content-Type": "application/json",
@@ -43551,13 +43591,13 @@ function resolveMemoryServiceDir() {
   );
 }
 function resolveLocalBridgeScript(serviceDir) {
-  const path96 = join97(serviceDir, "scripts", "local-bridge-server.mjs");
-  if (!existsSync105(path96)) {
+  const path97 = join97(serviceDir, "scripts", "local-bridge-server.mjs");
+  if (!existsSync105(path97)) {
     throw new Error(
-      `Could not find local-bridge-server.mjs at ${path96}. Verify packages/memory-service ships the scripts/ directory.`
+      `Could not find local-bridge-server.mjs at ${path97}. Verify packages/memory-service ships the scripts/ directory.`
     );
   }
-  return path96;
+  return path97;
 }
 function validateBridgeOpts(opts) {
   const local = opts.local ?? false;
@@ -43915,9 +43955,9 @@ function defaultSourceDir() {
   if (existsSync106(srcCandidate)) return srcCandidate;
   return candidate;
 }
-function installOne2(basename16, sourceDir, targetDir, opts) {
-  const sourcePath = join98(sourceDir, basename16);
-  const targetPath = join98(targetDir, basename16);
+function installOne2(basename17, sourceDir, targetDir, opts) {
+  const sourcePath = join98(sourceDir, basename17);
+  const targetPath = join98(targetDir, basename17);
   if (!existsSync106(sourcePath)) {
     throw new Error(`canonical hook source missing at ${sourcePath} \u2014 olam install corrupt or sourceDir is wrong`);
   }
@@ -43927,11 +43967,11 @@ function installOne2(basename16, sourceDir, targetDir, opts) {
       mkdirSync60(dirname56(targetPath), { recursive: true });
       writeFileSync52(targetPath, newContent, { mode: 493 });
     }
-    return { basename: basename16, action: "written", targetPath };
+    return { basename: basename17, action: "written", targetPath };
   }
   const existing = readFileSync86(targetPath, "utf8");
   if (existing === newContent) {
-    return { basename: basename16, action: "unchanged", targetPath };
+    return { basename: basename17, action: "unchanged", targetPath };
   }
   if (opts.force === true) {
     const backupPath = `${targetPath}.agentmemory-hook-backup-${Math.floor(Date.now() / 1e3)}`;
@@ -43939,9 +43979,9 @@ function installOne2(basename16, sourceDir, targetDir, opts) {
       copyFileSync12(targetPath, backupPath);
       writeFileSync52(targetPath, newContent, { mode: 493 });
     }
-    return { basename: basename16, action: "force-overwritten", targetPath, backupPath };
+    return { basename: basename17, action: "force-overwritten", targetPath, backupPath };
   }
-  return { basename: basename16, action: "preserved-existing", targetPath };
+  return { basename: basename17, action: "preserved-existing", targetPath };
 }
 function emitSettingsHint(targetDir) {
   return `
@@ -43977,8 +44017,8 @@ function registerMemoryInstallHooks(parent) {
     const lines = [];
     const backups = [];
     try {
-      for (const basename16 of HOOK_BASENAMES) {
-        const result = installOne2(basename16, sourceDir, targetDir, opts);
+      for (const basename17 of HOOK_BASENAMES) {
+        const result = installOne2(basename17, sourceDir, targetDir, opts);
         const dryRunSuffix = opts.dryRun === true ? " (dry-run)" : "";
         switch (result.action) {
           case "written":
@@ -44059,8 +44099,8 @@ function port() {
   const n = Number.parseInt(env, 10);
   return Number.isFinite(n) && n > 0 ? n : KG_SERVICE_PORT_DEFAULT;
 }
-function url(path96) {
-  return `http://127.0.0.1:${port()}${path96}`;
+function url(path97) {
+  return `http://127.0.0.1:${port()}${path97}`;
 }
 function kgServiceHealthUrl() {
   return url("/health");
@@ -45325,14 +45365,14 @@ async function emitBreadcrumb(opts) {
     );
     process.exit(2);
   }
-  const path96 = destPath(rec.project_slug);
-  const lockDir = dirname59(path96);
+  const path97 = destPath(rec.project_slug);
+  const lockDir = dirname59(path97);
   mkdirSync63(lockDir, { recursive: true });
   const line = JSON.stringify(rec) + "\n";
   await withFileLock(
     lockDir,
     () => {
-      appendFileSync6(path96, line, "utf8");
+      appendFileSync6(path97, line, "utf8");
     },
     {
       lockFilename: LOCK_FILENAME,
@@ -45342,7 +45382,7 @@ async function emitBreadcrumb(opts) {
       acquireTimeoutMs: 5e3
     }
   );
-  process.stdout.write(`[K7-emit] ${path96}: ${rec.extracted_pattern} (${rec.severity})
+  process.stdout.write(`[K7-emit] ${path97}: ${rec.extracted_pattern} (${rec.severity})
 `);
 }
 function registerFlywheelEmitBreadcrumb(parent) {
@@ -45465,38 +45505,38 @@ function validateK5ScoredAt(scoredAt) {
   }
   return null;
 }
-function validatePlan(path96) {
+function validatePlan(path97) {
   let stat;
   try {
-    stat = statSync30(path96);
+    stat = statSync30(path97);
   } catch (err) {
-    return { ok: false, message: `FAIL cannot stat ${path96}: ${err instanceof Error ? err.message : "unknown"}` };
+    return { ok: false, message: `FAIL cannot stat ${path97}: ${err instanceof Error ? err.message : "unknown"}` };
   }
   if (stat.size > MAX_PLAN_BYTES) {
-    return { ok: false, message: `FAIL ${path96}: plan file exceeds 1MB (${stat.size} bytes); refusing to parse` };
+    return { ok: false, message: `FAIL ${path97}: plan file exceeds 1MB (${stat.size} bytes); refusing to parse` };
   }
   let text;
   try {
-    text = readFileSync90(path96, "utf8");
+    text = readFileSync90(path97, "utf8");
   } catch (err) {
-    return { ok: false, message: `FAIL cannot read ${path96}: ${err instanceof Error ? err.message : "unknown"}` };
+    return { ok: false, message: `FAIL cannot read ${path97}: ${err instanceof Error ? err.message : "unknown"}` };
   }
   if (!text.replace(/^/, "").startsWith("---")) {
-    return { ok: false, message: `FAIL ${path96}: no YAML frontmatter (missing opening --- marker)` };
+    return { ok: false, message: `FAIL ${path97}: no YAML frontmatter (missing opening --- marker)` };
   }
   if (!text.includes("\n---", 3)) {
-    return { ok: false, message: `FAIL ${path96}: frontmatter block never closed (missing closing --- marker)` };
+    return { ok: false, message: `FAIL ${path97}: frontmatter block never closed (missing closing --- marker)` };
   }
   const fm = extractFrontmatter(text);
   if (fm === null) {
-    return { ok: false, message: `FAIL ${path96}: frontmatter could not be parsed as YAML` };
+    return { ok: false, message: `FAIL ${path97}: frontmatter could not be parsed as YAML` };
   }
   const hasScores = "k5_scores" in fm;
   const hasBoost = "k5_boost" in fm;
   const hasComposite = "k5_composite" in fm;
   const hasScoredAt = "k5_scored_at" in fm;
   if (!hasScores && !hasBoost && !hasComposite && !hasScoredAt) {
-    return { ok: true, message: `PASS ${path96}: k5_scores absent (acceptable \u2014 legacy plan)` };
+    return { ok: true, message: `PASS ${path97}: k5_scores absent (acceptable \u2014 legacy plan)` };
   }
   const errors = [];
   if (hasScores) {
@@ -45516,9 +45556,9 @@ function validatePlan(path96) {
     if (err !== null) errors.push(err);
   }
   if (errors.length > 0) {
-    return { ok: false, message: `FAIL ${path96}: ${errors.join("; ")}` };
+    return { ok: false, message: `FAIL ${path97}: ${errors.join("; ")}` };
   }
-  const lines = [`PASS ${path96}: k5_scores valid`];
+  const lines = [`PASS ${path97}: k5_scores valid`];
   if (hasScores && typeof fm.k5_scores === "object" && fm.k5_scores !== null) {
     const scoresObj = fm.k5_scores;
     const vals = [];
@@ -46204,14 +46244,14 @@ function pushOverlays(opts) {
   const registeredPrefixes = (opts._testSkillSources ?? listSkillSources()).map((s) => s.prefix).filter((p) => typeof p === "string" && p.length > 0);
   if (registeredPrefixes.length > 0) {
     for (const { srcFile, relPath } of sourceFiles) {
-      const basename16 = relPath.split("/").pop() ?? relPath;
+      const basename17 = relPath.split("/").pop() ?? relPath;
       let content;
       try {
         content = readFileSync94(srcFile);
       } catch {
         continue;
       }
-      const validation = validateCanonical(basename16, content, registeredPrefixes);
+      const validation = validateCanonical(basename17, content, registeredPrefixes);
       if (!validation.ok && validation.violation !== void 0) {
         throw new PushError(
           1,
@@ -46667,6 +46707,261 @@ Per-file changes:
   });
 }
 
+// src/commands/flywheel/session-start.ts
+import { readFileSync as readFileSync95, statSync as statSync33 } from "node:fs";
+import { homedir as homedir63 } from "node:os";
+import { join as join106 } from "node:path";
+var SESSIONSTART_HOOK_SENTINEL = "olam-sessionstart-context-hook-v1";
+var MAX_WAKE_BRIEF_BYTES = 8 * 1024;
+var MAX_ACTIVE_WORLD_BYTES = 4 * 1024;
+var MAX_CONFIG_BYTES = 8 * 1024;
+function tryReadCapped(path97, maxBytes) {
+  try {
+    const stat = statSync33(path97);
+    if (!stat.isFile() || stat.size === 0) return null;
+    if (stat.size > maxBytes) {
+      process.stderr.write(
+        `[${SESSIONSTART_HOOK_SENTINEL}] skipping ${path97}: ${stat.size} bytes > ${maxBytes} cap
+`
+      );
+      return null;
+    }
+    return readFileSync95(path97, "utf-8");
+  } catch (err) {
+    const code = err?.code;
+    if (code === "ENOENT") return null;
+    process.stderr.write(
+      `[${SESSIONSTART_HOOK_SENTINEL}] read failed for ${path97}: ${err?.message ?? err}
+`
+    );
+    return null;
+  }
+}
+function tryParseJson(raw, label) {
+  if (raw === null) return null;
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    process.stderr.write(
+      `[${SESSIONSTART_HOOK_SENTINEL}] ${label} JSON parse failed: ${err?.message ?? err}
+`
+    );
+    return null;
+  }
+}
+function buildContextBlock(olamHome5) {
+  const config = tryParseJson(
+    tryReadCapped(join106(olamHome5, "config.json"), MAX_CONFIG_BYTES),
+    "config.json"
+  );
+  const activeWorld = tryParseJson(
+    tryReadCapped(join106(olamHome5, "state", "active-world.json"), MAX_ACTIVE_WORLD_BYTES),
+    "active-world.json"
+  );
+  const wakeBrief = tryReadCapped(
+    join106(olamHome5, "state", "wake-brief.md"),
+    MAX_WAKE_BRIEF_BYTES
+  );
+  const sections = [];
+  if (config && typeof config.activeWorkspace === "string") {
+    sections.push(`Active workspace: ${config.activeWorkspace}`);
+  }
+  if (activeWorld && typeof activeWorld === "object") {
+    const parts = [];
+    if (typeof activeWorld.worldId === "string") parts.push(`worldId=${activeWorld.worldId}`);
+    if (typeof activeWorld.branch === "string") parts.push(`branch=${activeWorld.branch}`);
+    if (typeof activeWorld.repo === "string") parts.push(`repo=${activeWorld.repo}`);
+    if (typeof activeWorld.tier === "string") parts.push(`tier=${activeWorld.tier}`);
+    if (typeof activeWorld.enteredAt === "string") parts.push(`enteredAt=${activeWorld.enteredAt}`);
+    if (parts.length > 0) sections.push(`Active world: ${parts.join(", ")}`);
+  }
+  if (wakeBrief && wakeBrief.trim().length > 0) {
+    sections.push("Most recent wake brief:\n\n" + wakeBrief.trimEnd());
+  }
+  if (sections.length === 0) return null;
+  const body = sections.join("\n\n");
+  return `Olam SessionStart context (${Buffer.byteLength(body, "utf-8")} bytes):
+
+${body}`;
+}
+function emitSessionStartContext(olamHome5) {
+  try {
+    const context = buildContextBlock(olamHome5);
+    if (context === null) {
+      process.stdout.write("{}\n");
+      return;
+    }
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "SessionStart",
+          additionalContext: context
+        }
+      }) + "\n"
+    );
+  } catch (err) {
+    process.stderr.write(
+      `[${SESSIONSTART_HOOK_SENTINEL}] unexpected error: ${err?.message ?? err}
+`
+    );
+    process.stdout.write("{}\n");
+  }
+}
+function registerFlywheelSessionStart(parent) {
+  parent.command("session-start").description(
+    "Emit operator-state context for the SessionStart hook (4th defense layer). Reads ~/.olam/state/* and writes the additionalContext JSON to stdout. Fail-soft: always exits 0."
+  ).action(() => {
+    const olamHome5 = process.env.OLAM_HOME ?? join106(homedir63(), ".olam");
+    emitSessionStartContext(olamHome5);
+    process.exit(0);
+  });
+}
+
+// src/commands/flywheel/install-sessionstart-hook.ts
+init_merge_settings();
+init_output();
+import { existsSync as existsSync112, copyFileSync as copyFileSync16, mkdirSync as mkdirSync66, readFileSync as readFileSync96, unlinkSync as unlinkSync25, writeFileSync as writeFileSync58 } from "node:fs";
+import { homedir as homedir64 } from "node:os";
+import { dirname as dirname62, join as join107 } from "node:path";
+var SESSIONSTART_HOOK_STAGE = "SessionStart";
+var SESSIONSTART_HOOK_TIMEOUT_MS = 5e3;
+var NOOP_GUARD = "command -v olam >/dev/null 2>&1 || exit 0;";
+function buildSessionStartHookEntry() {
+  return {
+    matcher: "",
+    hooks: [
+      {
+        type: "command",
+        command: `OLAM_SESSIONSTART_SENTINEL=${SESSIONSTART_HOOK_SENTINEL}; ${NOOP_GUARD} olam flywheel session-start`,
+        timeout: SESSIONSTART_HOOK_TIMEOUT_MS
+      }
+    ]
+  };
+}
+function settingsPathFor4(scope, cwd) {
+  if (scope === "user") return join107(homedir64(), ".claude", "settings.json");
+  return join107(cwd ?? process.cwd(), ".claude", "settings.json");
+}
+function backup3(filePath) {
+  if (!existsSync112(filePath)) return null;
+  const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const backupPath = `${filePath}.olam-bak.${ts}`;
+  copyFileSync16(filePath, backupPath);
+  return backupPath;
+}
+function installSessionStartHook(filePath) {
+  mkdirSync66(dirname62(filePath), { recursive: true });
+  const backupPath = backup3(filePath);
+  const result = mergeHomeSettingsJson(filePath, {
+    ensureHook: {
+      stage: SESSIONSTART_HOOK_STAGE,
+      sentinel: SESSIONSTART_HOOK_SENTINEL,
+      entry: buildSessionStartHookEntry()
+    }
+  });
+  if (result.status === "already-present" && backupPath) {
+    try {
+      unlinkSync25(backupPath);
+    } catch {
+    }
+    return { status: "already-present", filePath, backupPath: null };
+  }
+  return { status: result.status, filePath, backupPath };
+}
+function uninstallSessionStartHook(filePath) {
+  if (!existsSync112(filePath)) return { status: "no-settings", filePath };
+  const raw = readFileSync96(filePath, "utf-8");
+  const settings = raw.trim() ? JSON.parse(raw) : {};
+  const matchers = settings.hooks?.SessionStart;
+  if (!Array.isArray(matchers) || matchers.length === 0) {
+    return { status: "not-found", filePath };
+  }
+  let changed = false;
+  const kept = [];
+  for (const matcher of matchers) {
+    const inner = matcher.hooks ?? [];
+    const keptInner = inner.filter((h) => {
+      if (typeof h.command === "string" && h.command.includes(SESSIONSTART_HOOK_SENTINEL)) {
+        changed = true;
+        return false;
+      }
+      return true;
+    });
+    if (keptInner.length === 0 && inner.length > 0) {
+      changed = true;
+      continue;
+    }
+    if (keptInner.length === inner.length) {
+      kept.push(matcher);
+    } else {
+      kept.push({ ...matcher, hooks: keptInner });
+    }
+  }
+  if (!changed) return { status: "not-found", filePath };
+  const next = {
+    ...settings,
+    hooks: { ...settings.hooks, SessionStart: kept }
+  };
+  if (kept.length === 0) {
+    const otherStages = Object.keys(next.hooks ?? {}).filter((k) => k !== "SessionStart");
+    if (otherStages.length === 0) {
+      delete next.hooks;
+    } else {
+      delete next.hooks.SessionStart;
+    }
+  }
+  writeFileSync58(filePath, JSON.stringify(next, null, 2) + "\n");
+  return { status: "removed", filePath };
+}
+function registerFlywheelInstallSessionStartHook(parent) {
+  parent.command("install-sessionstart-hook").description(
+    "Install (or --uninstall) the SessionStart context hook into .claude/settings.json. Idempotent. 4th defense layer \u2014 preloads operator state before the first prompt."
+  ).option("--scope <scope>", "project (default; <cwd>/.claude/settings.json) or user (~/.claude/settings.json)", "project").option("--uninstall", "Remove the hook instead of installing it").action((opts) => {
+    const scope = opts.scope === "user" ? "user" : "project";
+    const filePath = settingsPathFor4(scope);
+    if (opts.uninstall) {
+      try {
+        const r = uninstallSessionStartHook(filePath);
+        switch (r.status) {
+          case "removed":
+            printSuccess(`SessionStart context hook removed from ${filePath}`);
+            return;
+          case "not-found":
+            printInfo("sessionstart hook", `not found in ${filePath} \u2014 already uninstalled`);
+            return;
+          case "no-settings":
+            printInfo("sessionstart hook", `no settings.json at ${filePath} \u2014 nothing to remove`);
+            return;
+        }
+      } catch (err) {
+        printError(`uninstall failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+      }
+      return;
+    }
+    try {
+      const r = installSessionStartHook(filePath);
+      switch (r.status) {
+        case "installed":
+          printSuccess(`SessionStart context hook installed (${scope} scope)`);
+          printInfo("settings", r.filePath);
+          if (r.backupPath) printInfo("backup", r.backupPath);
+          printInfo("next", "open a new Claude Code session \u2014 Olam state will preload via additionalContext");
+          return;
+        case "already-present":
+          printInfo("sessionstart hook", `already installed at ${r.filePath}`);
+          return;
+        case "no-op":
+          printWarning(`no change made to ${r.filePath}`);
+          return;
+      }
+    } catch (err) {
+      printError(`install failed: ${err instanceof Error ? err.message : String(err)}`);
+      process.exitCode = 1;
+    }
+  });
+}
+
 // src/commands/flywheel/index.ts
 function registerFlywheel(program2) {
   const flywheel = program2.command("flywheel").description(
@@ -46682,6 +46977,8 @@ function registerFlywheel(program2) {
   registerFlywheelPing(flywheel);
   registerFlywheelInstallShims(flywheel);
   registerFlywheelMigrateOverlays(flywheel);
+  registerFlywheelSessionStart(flywheel);
+  registerFlywheelInstallSessionStartHook(flywheel);
 }
 
 // src/commands/seed.ts
@@ -47074,19 +47371,321 @@ function registerRekey(program2) {
   });
 }
 
-// src/pleri-config.ts
+// src/commands/yolo.ts
+init_output();
+import * as childProcess2 from "node:child_process";
 import * as fs95 from "node:fs";
+import * as os50 from "node:os";
 import * as path95 from "node:path";
+import pc44 from "picocolors";
+var YOLO_BOOT_DELAY_MS = 8e3;
+var CAPTURE_DELAY_MS = 4e3;
+var TMUX_PROBE_PATHS = [
+  "/opt/homebrew/Cellar/tmux/3.6a/bin/tmux",
+  "/opt/homebrew/bin/tmux",
+  "/usr/local/bin/tmux",
+  "/usr/bin/tmux"
+];
+var TMUX_SHIM_MARKERS = [".oh-my-zsh", ".zsh", ".bash", "nvm", "asdf"];
+function defaultRunner(cmd, args, opts) {
+  const result = childProcess2.spawnSync(cmd, args, {
+    encoding: "utf-8",
+    cwd: opts?.cwd
+  });
+  return {
+    status: result.status,
+    stdout: typeof result.stdout === "string" ? result.stdout.trim() : "",
+    stderr: typeof result.stderr === "string" ? result.stderr.trim() : ""
+  };
+}
+function defaultSleeper(ms) {
+  return new Promise((resolve27) => setTimeout(resolve27, ms));
+}
+function detectTmuxBinary(runner = defaultRunner) {
+  for (const p of TMUX_PROBE_PATHS) {
+    if (TMUX_SHIM_MARKERS.some((m) => p.includes(m))) continue;
+    if (fs95.existsSync(p)) return p;
+  }
+  const result = runner("which", ["tmux"]);
+  if (result.status === 0 && result.stdout) {
+    const p = result.stdout.trim();
+    if (TMUX_SHIM_MARKERS.some((m) => p.includes(m))) return null;
+    return p;
+  }
+  return null;
+}
+function resolveWorktreeRoot(runner = defaultRunner, cwd = process.cwd()) {
+  if (process.env["OLAM_TMUX_YOLO_ROOT"]) {
+    return process.env["OLAM_TMUX_YOLO_ROOT"];
+  }
+  const rootFile = path95.join(os50.homedir(), ".olam-tmux-yolo-root");
+  if (fs95.existsSync(rootFile)) {
+    const line = fs95.readFileSync(rootFile, "utf-8").trim();
+    if (line) return line;
+  }
+  const gitResult = runner("git", ["rev-parse", "--show-toplevel"], { cwd });
+  if (gitResult.status !== 0 || !gitResult.stdout) {
+    return path95.join(cwd, "..", path95.basename(cwd) + "-wt");
+  }
+  const repoRoot = gitResult.stdout.trim();
+  return path95.join(path95.dirname(repoRoot), path95.basename(repoRoot) + "-wt");
+}
+function resolveYoloCommand(runner = defaultRunner) {
+  const result = runner("bash", ["-lc", "command -v yolo"]);
+  if (result.status === 0 && result.stdout) {
+    const p = result.stdout.trim();
+    if (p && !TMUX_SHIM_MARKERS.some((m) => p.includes(m))) {
+      return { cmd: "yolo", usingFallback: false };
+    }
+  }
+  return {
+    cmd: "~/.local/bin/claude --dangerously-skip-permissions",
+    usingFallback: true
+  };
+}
+async function spawnYolo(opts) {
+  const runner = opts.runner ?? defaultRunner;
+  const sleeper = opts.sleeper ?? defaultSleeper;
+  const cwd = opts.cwd ?? process.cwd();
+  const tmux = detectTmuxBinary(runner);
+  if (!tmux) {
+    throw new Error(
+      "tmux binary not found. Checked: " + TMUX_PROBE_PATHS.join(", ") + " and PATH. Ensure tmux is installed and not shadowed by a shell plugin."
+    );
+  }
+  try {
+    fs95.accessSync(opts.promptFile, fs95.constants.R_OK);
+  } catch {
+    throw new Error(
+      `Prompt file not found or not readable: ${opts.promptFile}
+Create the file with your task description and try again.`
+    );
+  }
+  const worktreeRoot = resolveWorktreeRoot(runner, cwd);
+  const worktreePath = path95.join(worktreeRoot, opts.name);
+  const branchCheck = runner("git", ["show-ref", "--verify", "--quiet", `refs/heads/${opts.branch}`], { cwd });
+  if (branchCheck.status === 0) {
+    throw new Error(
+      `Branch "${opts.branch}" already exists.
+Run: olam yolo --cleanup ${opts.name}  (or use --force to bypass the merged check)`
+    );
+  }
+  if (fs95.existsSync(worktreePath)) {
+    throw new Error(
+      `Worktree directory already exists: ${worktreePath}
+Run: olam yolo --cleanup ${opts.name}  to remove it first.`
+    );
+  }
+  const base = opts.base ?? (() => {
+    const r = runner("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd });
+    return r.status === 0 ? r.stdout.trim() : "main";
+  })();
+  const worktreeAdd = runner(
+    "git",
+    ["worktree", "add", "-b", opts.branch, worktreePath, base],
+    { cwd }
+  );
+  if (worktreeAdd.status !== 0) {
+    throw new Error(
+      `git worktree add failed:
+${worktreeAdd.stderr || worktreeAdd.stdout}`
+    );
+  }
+  const newWindow = runner(tmux, ["new-window", "-t", "0:", "-n", opts.name, "-c", worktreePath]);
+  if (newWindow.status !== 0) {
+    throw new Error(
+      `tmux new-window failed:
+${newWindow.stderr}
+Is tmux running? Start a session with: tmux new-session -d -s 0`
+    );
+  }
+  const { cmd: yoloCmd, usingFallback } = resolveYoloCommand(runner);
+  await sleeper(YOLO_BOOT_DELAY_MS);
+  const sendKeysArg = `${yoloCmd} "$(cat ${opts.promptFile})"`;
+  const sendKeys = runner(tmux, ["send-keys", "-t", `0:${opts.name}`, sendKeysArg, "Enter"]);
+  if (sendKeys.status !== 0) {
+    throw new Error(`tmux send-keys failed:
+${sendKeys.stderr}`);
+  }
+  await sleeper(CAPTURE_DELAY_MS);
+  const capture = runner(tmux, ["capture-pane", "-t", `0:${opts.name}`, "-p"]);
+  const captureText = capture.stdout ?? "";
+  let captureWarning;
+  const YOLO_STARTED_MARKERS = ["Cogitating", "Welcome to Claude Code", "Claude Code", "Human:", "> "];
+  const started = YOLO_STARTED_MARKERS.some((m) => captureText.includes(m));
+  if (!started) {
+    captureWarning = "yolo may not have started \u2014 pane output does not contain expected markers. Attach to verify: tmux select-window -t 0:" + opts.name;
+  }
+  return {
+    worktreePath,
+    branch: opts.branch,
+    windowName: opts.name,
+    attachHint: `tmux select-window -t 0:${opts.name}`,
+    captureWarning,
+    yoloFallbackUsed: usingFallback
+  };
+}
+function listYoloWindows(opts = {}) {
+  const runner = opts.runner ?? defaultRunner;
+  const cwd = opts.cwd ?? process.cwd();
+  const tmux = detectTmuxBinary(runner);
+  if (!tmux) return [];
+  const listResult = runner(tmux, ["list-windows", "-t", "0", "-F", "#{window_name}"]);
+  if (listResult.status !== 0) return [];
+  const windowNames = listResult.stdout.split("\n").map((n) => n.trim()).filter(Boolean);
+  const worktreeRoot = resolveWorktreeRoot(runner, cwd);
+  return windowNames.map((name) => {
+    const worktreePath = path95.join(worktreeRoot, name);
+    return {
+      name,
+      worktreePath: fs95.existsSync(worktreePath) ? worktreePath : void 0
+    };
+  });
+}
+async function cleanupYolo(opts) {
+  const runner = opts.runner ?? defaultRunner;
+  const cwd = opts.cwd ?? process.cwd();
+  const mainBranch = opts.mainBranch ?? "main";
+  const worktreeRoot = resolveWorktreeRoot(runner, cwd);
+  const worktreePath = path95.join(worktreeRoot, opts.name);
+  const worktreeList = runner("git", ["worktree", "list", "--porcelain"], { cwd });
+  let branch;
+  if (worktreeList.status === 0) {
+    const lines = worktreeList.stdout.split("\n");
+    let inTarget = false;
+    for (const line of lines) {
+      if (line.startsWith("worktree ")) {
+        inTarget = line.slice("worktree ".length).trim() === worktreePath;
+      }
+      if (inTarget && line.startsWith("branch ")) {
+        branch = line.replace("branch refs/heads/", "").trim();
+        break;
+      }
+    }
+  }
+  if (branch && !opts.force) {
+    const mergedCheck = runner(
+      "git",
+      ["branch", "--merged", mainBranch],
+      { cwd }
+    );
+    const mergedBranches = mergedCheck.stdout.split("\n").map((b) => b.replace(/^\*?\s*/, "").trim());
+    if (!mergedBranches.includes(branch)) {
+      throw new Error(
+        `Branch "${branch}" is not merged into ${mainBranch}.
+Run: olam yolo --cleanup ${opts.name} --force  to remove anyway.`
+      );
+    }
+  }
+  const tmux = detectTmuxBinary(runner);
+  if (tmux) {
+    runner(tmux, ["kill-window", "-t", `0:${opts.name}`]);
+  }
+  const removeArgs = opts.force ? ["worktree", "remove", "--force", worktreePath] : ["worktree", "remove", worktreePath];
+  const worktreeRemove = runner("git", removeArgs, { cwd });
+  if (worktreeRemove.status !== 0) {
+    if (!worktreeRemove.stderr.includes("is not a worktree")) {
+      printWarning(`git worktree remove: ${worktreeRemove.stderr}`);
+    }
+  }
+  if (branch) {
+    const branchDeleteArgs = opts.force ? ["branch", "-D", branch] : ["branch", "-d", branch];
+    const branchDelete = runner("git", branchDeleteArgs, { cwd });
+    if (branchDelete.status !== 0) {
+      printWarning(`git branch delete: ${branchDelete.stderr}`);
+    }
+  }
+}
+function registerYolo(program2) {
+  const cmd = program2.command("yolo").description(
+    "Dispatch a parallel Claude Code session in a new tmux window + isolated git worktree"
+  ).argument("[name]", "Short identifier for the yolo session (kebab-case)").option("--branch <branch>", "Branch to create in the worktree").option("--base <base>", "Base branch to fork from (default: current branch)").option("--prompt-file <path>", "Path to a file containing the task prompt").option("--list", "List active yolo tmux windows and matched worktree paths").option("--cleanup <name>", "Remove worktree + kill tmux window + delete branch").option("--force", "With --cleanup: bypass merged-branch check").action(
+    async (name, opts) => {
+      if (opts.list) {
+        const windows = listYoloWindows();
+        if (windows.length === 0) {
+          console.log(pc44.dim("No active yolo windows found (tmux session 0)."));
+          return;
+        }
+        printHeader(`${windows.length} yolo window(s)`);
+        for (const w of windows) {
+          const wt = w.worktreePath ? pc44.dim(w.worktreePath) : pc44.dim("(no worktree)");
+          console.log(`  ${pc44.bold(w.name.padEnd(24))} ${wt}`);
+        }
+        return;
+      }
+      if (opts.cleanup) {
+        try {
+          await cleanupYolo({
+            name: opts.cleanup,
+            force: opts.force
+          });
+          printSuccess(`cleaned up yolo "${opts.cleanup}"`);
+        } catch (err) {
+          printError(err instanceof Error ? err.message : String(err));
+          process.exitCode = 1;
+        }
+        return;
+      }
+      if (!name) {
+        cmd.help();
+        return;
+      }
+      if (!opts.branch) {
+        printError("--branch is required for spawn. Example: --branch feat/my-task");
+        process.exitCode = 1;
+        return;
+      }
+      if (!opts.promptFile) {
+        printError(
+          "--prompt-file is required for spawn. Create a file with your task description."
+        );
+        process.exitCode = 1;
+        return;
+      }
+      try {
+        const result = await spawnYolo({
+          name,
+          branch: opts.branch,
+          base: opts.base,
+          promptFile: opts.promptFile
+        });
+        printHeader("yolo dispatched");
+        printInfo("Worktree", result.worktreePath);
+        printInfo("Branch", result.branch);
+        printInfo("Window", result.windowName);
+        printInfo("Attach", result.attachHint);
+        if (result.yoloFallbackUsed) {
+          console.log(
+            pc44.dim(
+              "  [note] yolo alias not found on PATH \u2014 used ~/.local/bin/claude --dangerously-skip-permissions"
+            )
+          );
+        }
+        if (result.captureWarning) {
+          printWarning(result.captureWarning);
+        }
+      } catch (err) {
+        printError(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+      }
+    }
+  );
+}
+
+// src/pleri-config.ts
+import * as fs96 from "node:fs";
+import * as path96 from "node:path";
 function isPleriConfigured(configDir = process.env.OLAM_CONFIG_DIR ?? ".olam") {
   if (process.env.PLERI_BASE_URL) {
     return true;
   }
-  const configPath = path95.join(configDir, "config.yaml");
-  if (!fs95.existsSync(configPath)) {
+  const configPath = path96.join(configDir, "config.yaml");
+  if (!fs96.existsSync(configPath)) {
     return false;
   }
   try {
-    const contents = fs95.readFileSync(configPath, "utf8");
+    const contents = fs96.readFileSync(configPath, "utf8");
     return /^[^#\n]*\bpleri:/m.test(contents);
   } catch {
     return false;
@@ -47129,6 +47728,7 @@ registerPlans(program);
 registerServices(program);
 registerSeed(program);
 registerRekey(program);
+registerYolo(program);
 registerLanes(program);
 registerPolicyCheck(program);
 registerWorldspec(program);
@@ -47172,4 +47772,5 @@ registerSkillsShadowBackups(program);
 registerSkillsDoctor(program);
 registerSkills10x(program);
 registerHermes(program);
-program.parse();
+await program.parseAsync();
+process.exit(process.exitCode ?? 0);