@sechroom/cli 2026.6.35-rc.92df1100 → 2026.6.35

package/dist/index.js

@@ -844,6 +844,50 @@ Examples:
       cmd.optsWithGlobals().json
     );
   });
+  memory.command("update <memoryId>").description("Update metadata only \u2014 title/tags/type/confidence (PATCH /memories/{memoryId}/metadata; omitted = unchanged)").option("--title <text>", "Set the title").option("--tag <tag...>", "Set the full tag list (replaces existing); repeatable").option("--add-tag <tag...>", "Add tag(s) to the existing set (repeatable)").option("--remove-tag <tag...>", "Remove tag(s) from the existing set (repeatable)").option("--type <type>", "Set the memory type (e.g. reference, note, document)").option("--confidence <n>", "Set confidence (0..1)", (v) => Number(v)).option("--memory-source <src>", "Set the memory's own Source field").option("--bump-version", "Bump the version chain (use for a content reinterpretation, e.g. a type promotion)", false).option("--source <source>", "Contributing lane stamp (attribution)", "cli").action(async (memoryId, opts, cmd) => {
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const json = cmd.optsWithGlobals().json;
+    const hasTagOps = Boolean(opts.tag || opts.addTag || opts.removeTag);
+    const hasAny = opts.title !== void 0 || hasTagOps || opts.type !== void 0 || opts.confidence !== void 0 || opts.memorySource !== void 0 || Boolean(opts.bumpVersion);
+    if (!hasAny)
+      fail("nothing to update \u2014 pass at least one of --title / --tag / --add-tag / --remove-tag / --type / --confidence / --memory-source.");
+    let tags;
+    if (hasTagOps) {
+      let base;
+      if (opts.tag) base = opts.tag;
+      else {
+        const current = await runApi("Reading current tags", async () => {
+          const client = await makeClient(cfg);
+          return client.GET("/memories/{memoryId}", { params: { path: { memoryId } } });
+        });
+        base = current?.item?.tags ?? current?.tags ?? [];
+      }
+      const set = new Set(base);
+      for (const t of opts.addTag ?? []) set.add(t);
+      for (const t of opts.removeTag ?? []) set.delete(t);
+      tags = [...set];
+    }
+    const body = {
+      memoryId,
+      source: opts.source,
+      bumpVersion: Boolean(opts.bumpVersion)
+    };
+    if (opts.title !== void 0) body.title = opts.title;
+    if (tags !== void 0) body.tags = tags;
+    if (opts.type !== void 0) body.type = opts.type;
+    if (opts.confidence !== void 0) body.confidence = opts.confidence;
+    if (opts.memorySource !== void 0) body.memorySource = opts.memorySource;
+    const data = await runApi("Updating metadata", async () => {
+      const client = await makeClient(cfg);
+      return client.PATCH("/memories/{memoryId}/metadata", {
+        params: { path: { memoryId } },
+        body
+      });
+    });
+    const changed = data?.changed ?? [];
+    const summary = changed.length > 0 ? `updated ${changed.join(", ")}` : "no changes";
+    emitAction(`${summary} on ${style.bold(memoryId)} \u2192 v${style.bold(String(data?.version ?? "?"))}`, data, json);
+  });
   memory.command("archive <memoryId>").description("Archive a memory (POST /memories/{memoryId}/archive)").option("--source <source>", "Source / lane stamp", "cli").action(async (memoryId, opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
     const data = await runApi("Archiving memory", async () => {
@@ -1773,14 +1817,18 @@ Examples:
   });
 }
 
+// src/commands/checkpoint.ts
+import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname5, join as join6 } from "path";
+
 // src/commands/hook.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { homedir as homedir3 } from "os";
-import { delimiter, dirname as dirname4, join as join4 } from "path";
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { delimiter, dirname as dirname4, join as join5 } from "path";
 
 // src/sem.ts
 import { basename as basename2, dirname as dirname2, join as join2 } from "path";
-import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, statSync, writeFileSync as writeFileSync2 } from "fs";
 var SEM_FILE = join2(".sechroom", "lane.json");
 var LEGACY_SEM_FILE = ".sem";
 var STATE_DIR_NAME2 = ".sechroom";
@@ -1799,6 +1847,43 @@ function resolveSemPathForRead(start = process.cwd()) {
     dir = parent;
   }
 }
+function applyWorktreeLaneSuffix(lane, start = process.cwd()) {
+  try {
+    let dir = start;
+    let gitPath;
+    for (; ; ) {
+      const candidate = join2(dir, ".git");
+      if (existsSync2(candidate)) {
+        gitPath = candidate;
+        break;
+      }
+      const parent = dirname2(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    if (!gitPath || statSync(gitPath).isDirectory()) return lane;
+    const gitFile = readFileSync2(gitPath, "utf8");
+    const common = gitFile.trim().match(/^gitdir:\s*(.+)\/worktrees\/[^/\s]+\s*$/);
+    if (!common) return lane;
+    const worktreesDir = join2(common[1], "worktrees");
+    const siblings = readdirSync(worktreesDir).filter((n) => {
+      try {
+        return statSync(join2(worktreesDir, n)).isDirectory();
+      } catch {
+        return false;
+      }
+    });
+    return laneWithWorktreeSuffix(lane, gitFile, siblings);
+  } catch {
+    return lane;
+  }
+}
+function laneWithWorktreeSuffix(lane, gitFile, siblings) {
+  const m = gitFile.trim().match(/\/worktrees\/([^/\s]+)\s*$/);
+  if (!m) return lane;
+  const idx = [...siblings].sort().indexOf(m[1]);
+  return idx < 0 ? lane : `${lane}-${idx + 2}`;
+}
 function parseSem(text) {
   const out = {};
   for (const raw of text.split("\n")) {
@@ -1896,8 +1981,55 @@ function ensureSemIgnored(semPath) {
 
 // src/setup/clients.ts
 import { existsSync as existsSync3 } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname3, join as join4 } from "path";
+
+// src/setup/config-dirs.ts
 import { homedir as homedir2 } from "os";
-import { dirname as dirname3, join as join3 } from "path";
+import { join as join3 } from "path";
+function expandTilde(p) {
+  if (p === "~") return homedir2();
+  if (p.startsWith("~/")) return join3(homedir2(), p.slice(2));
+  return p;
+}
+function splitDirs(raw) {
+  if (!raw) return [];
+  return raw.split(",").map((s) => expandTilde(s.trim())).filter(Boolean);
+}
+function resolveScope(flag) {
+  if (flag == null) return "global";
+  if (flag === "global" || flag === "project") return flag;
+  throw new Error(`--scope must be 'global' or 'project' (got '${flag}')`);
+}
+function labelFor(dir) {
+  const h = homedir2();
+  if (dir === h) return "~";
+  return dir.startsWith(h + "/") ? "~" + dir.slice(h.length) : dir;
+}
+function defaultClaudeDir() {
+  return join3(homedir2(), ".claude");
+}
+function defaultCodexHome() {
+  return join3(homedir2(), ".codex");
+}
+function resolveClaudeTargets(opts) {
+  const scope = opts.scope ?? "global";
+  const cwd = opts.cwd ?? process.cwd();
+  if (scope === "project") {
+    return [{ dir: join3(cwd, ".claude"), scope, label: "<project>" }];
+  }
+  const fromFlag = splitDirs(opts.override);
+  const fromEnv = splitDirs(process.env.CLAUDE_CONFIG_DIR);
+  const dirs = fromFlag.length ? fromFlag : fromEnv.length ? fromEnv : [defaultClaudeDir()];
+  return dirs.map((dir) => ({ dir, scope, label: labelFor(dir) }));
+}
+function resolveCodexHomes(opts) {
+  const scope = opts.scope ?? "global";
+  if (scope === "project") return [];
+  const fromFlag = splitDirs(opts.override);
+  const fromEnv = splitDirs(process.env.CODEX_HOME);
+  return fromFlag.length ? fromFlag : fromEnv.length ? fromEnv : [defaultCodexHome()];
+}
 
 // src/setup/operator-surface.ts
 var SectionType = {
@@ -1910,15 +2042,25 @@ var SectionType = {
    *  carried a workspaceId and that workspace has agent-setup-bundle memories. */
   WorkspaceConventions: "workspace-conventions"
 };
-async function fetchSetup(cfg) {
+async function fetchSetup(cfg, namespaceSlug) {
   const client = await makeClient(cfg);
+  const query = {};
+  if (cfg.workspaceId) query.workspaceId = cfg.workspaceId;
+  if (namespaceSlug) query.namespaceSlug = namespaceSlug;
+  const hasQuery = query.workspaceId !== void 0 || query.namespaceSlug !== void 0;
   const { data, error } = await client.GET(
     "/operator-surface/setup",
-    cfg.workspaceId ? { params: { query: { workspaceId: cfg.workspaceId } } } : {}
+    hasQuery ? { params: { query } } : {}
   );
   if (error) throw new Error(`GET /operator-surface/setup failed: ${JSON.stringify(error)}`);
   return data;
 }
+async function listNamespaces(cfg) {
+  const client = await makeClient(cfg);
+  const { data } = await client.GET("/mcp-aggregator/namespaces", {});
+  const rows = data ?? [];
+  return rows.filter((r) => typeof r.slug === "string").map((r) => ({ slug: r.slug, displayName: r.displayName ?? r.slug }));
+}
 function findSurface(setup, surfaceKey) {
   return setup.surfaces.find((s) => s.surfaceKey === surfaceKey);
 }
@@ -1989,12 +2131,14 @@ async function resolveWorkspaceConventions(cfg, section) {
     if (parseTagArtifactId(artifact.id)) continue;
     const mem = await fetchMemoryFields(cfg, artifact.id);
     if (typeof mem?.text === "string" && mem.text.trim().length > 0) {
-      parts.push(mem.text.trim());
-      refs.push(`${artifact.id}@v${mem.version ?? 1}`);
+      const ref = `${artifact.id}@v${mem.version ?? 1}`;
+      parts.push(`<!-- @sechroom/cli:section source=${ref} -->
+${mem.text.trim()}`);
+      refs.push(ref);
     }
   }
   if (parts.length === 0) return null;
-  return { body: parts.join("\n\n---\n\n"), refs };
+  return { body: parts.join("\n\n"), refs };
 }
 async function createOverride(cfg, template, personalWorkspaceId) {
   const client = await makeClient(cfg);
@@ -2022,51 +2166,53 @@ async function createOverride(cfg, template, personalWorkspaceId) {
 function claudeDesktopConfigPath(home) {
   switch (process.platform) {
     case "darwin":
-      return join3(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+      return join4(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
     case "win32":
-      return join3(process.env.APPDATA ?? join3(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+      return join4(process.env.APPDATA ?? join4(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
     default:
-      return join3(home, ".config", "Claude", "claude_desktop_config.json");
+      return join4(home, ".config", "Claude", "claude_desktop_config.json");
   }
 }
-function clientTargets(cwd) {
-  const home = homedir2();
+function clientTargets(cwd, opts = {}) {
+  const home = homedir3();
+  const claudeDir = opts.claudeDir ?? join4(home, ".claude");
+  const codexHome = opts.codexHome ?? join4(home, ".codex");
   return {
     "claude-code": {
       key: "claude-code",
       label: "Claude Code",
-      mcp: { surfaceKey: "claude-code", sectionType: SectionType.McpConfig, path: join3(cwd, ".mcp.json"), format: "json" },
-      instruction: { surfaceKey: "claude-code", path: join3(cwd, "CLAUDE.md") }
+      mcp: { surfaceKey: "claude-code", sectionType: SectionType.McpConfig, path: join4(cwd, ".mcp.json"), format: "json" },
+      instruction: { surfaceKey: "claude-code", path: join4(cwd, "CLAUDE.md") }
     },
     "claude-desktop": {
       key: "claude-desktop",
       label: "Claude Desktop",
       mcp: { surfaceKey: "claude-desktop", sectionType: SectionType.McpConfig, path: claudeDesktopConfigPath(home), format: "json" },
-      instruction: { surfaceKey: "claude-desktop", path: join3(home, ".claude", "CLAUDE.md") }
+      instruction: { surfaceKey: "claude-desktop", path: join4(claudeDir, "CLAUDE.md") }
     },
     codex: {
       key: "codex",
       label: "Codex CLI",
-      mcp: { surfaceKey: "chatgpt", sectionType: SectionType.McpConfigToml, path: join3(home, ".codex", "config.toml"), format: "toml" },
-      instruction: { surfaceKey: "chatgpt", path: join3(cwd, "AGENTS.md") }
+      mcp: { surfaceKey: "chatgpt", sectionType: SectionType.McpConfigToml, path: join4(codexHome, "config.toml"), format: "toml" },
+      instruction: { surfaceKey: "chatgpt", path: join4(cwd, "AGENTS.md") }
     },
     cursor: {
       key: "cursor",
       label: "Cursor",
-      mcp: { surfaceKey: "claude-code", sectionType: SectionType.McpConfig, path: join3(cwd, ".cursor", "mcp.json"), format: "json" },
-      instruction: { surfaceKey: "chatgpt", path: join3(cwd, "AGENTS.md") }
+      mcp: { surfaceKey: "claude-code", sectionType: SectionType.McpConfig, path: join4(cwd, ".cursor", "mcp.json"), format: "json" },
+      instruction: { surfaceKey: "chatgpt", path: join4(cwd, "AGENTS.md") }
     }
   };
 }
 var ALL_CLIENT_KEYS = ["claude-code", "claude-desktop", "codex", "cursor"];
 var DEFAULT_CLIENT_KEY = "claude-code";
 function detectInstalledClients(cwd) {
-  const home = homedir2();
+  const home = homedir3();
   const detected = [];
-  if (existsSync3(join3(home, ".claude"))) detected.push("claude-code");
+  if (resolveClaudeTargets({}).some((t) => existsSync3(t.dir))) detected.push("claude-code");
   if (existsSync3(dirname3(claudeDesktopConfigPath(home)))) detected.push("claude-desktop");
-  if (existsSync3(join3(home, ".codex"))) detected.push("codex");
-  if (existsSync3(join3(home, ".cursor")) || existsSync3(join3(cwd, ".cursor"))) detected.push("cursor");
+  if (resolveCodexHomes({}).some((d) => existsSync3(d))) detected.push("codex");
+  if (existsSync3(join4(home, ".cursor")) || existsSync3(join4(cwd, ".cursor"))) detected.push("cursor");
   return detected;
 }
 
@@ -2090,14 +2236,15 @@ function resolveLane(flagLane, cwd) {
   const env = process.env.SECHROOM_LANE;
   if (env) return env;
   const start = cwd ?? process.cwd();
-  const sem = readSem(resolveSemPathForRead(start));
-  return sem?.values["code-lane"];
+  const base = readSem(resolveSemPathForRead(start))?.values["code-lane"];
+  if (!base) return void 0;
+  return applyWorktreeLaneSuffix(base, start);
 }
-var INTENT_FILE = join4(".sechroom", "continuity.json");
+var INTENT_FILE = join5(".sechroom", "continuity.json");
 function resolveIntentPath(start) {
   let dir = start;
   for (; ; ) {
-    const candidate = join4(dir, INTENT_FILE);
+    const candidate = join5(dir, INTENT_FILE);
     if (existsSync4(candidate)) return candidate;
     const parent = dirname4(dir);
     if (parent === dir) return void 0;
@@ -2118,6 +2265,102 @@ function hasRequiredIntent(i) {
     i.objective?.trim() && i.state?.trim() && i.lastAction?.trim() && i.nextAction?.trim() && i.resumeInstruction?.trim()
   );
 }
+async function saveSnapshotFromIntent(cmd, cwd, laneFlag, scopeFlag, defaultScope, opts) {
+  const lane = resolveLane(laneFlag, cwd);
+  if (!lane) return false;
+  const intent = readIntent(cwd);
+  if (!intent || !hasRequiredIntent(intent)) return false;
+  if (opts?.skipIfUnchanged && unchangedSinceLastPush(cwd, intent)) return false;
+  const cfg = resolveConfig(cmd.optsWithGlobals());
+  const client = await makeClient(cfg);
+  await client.POST("/continuity/snapshots", {
+    body: {
+      laneId: lane,
+      scope: scopeFlag ?? intent.scope ?? defaultScope,
+      currentObjective: intent.objective,
+      currentState: intent.state,
+      lastMeaningfulAction: intent.lastAction,
+      nextIntendedAction: intent.nextAction,
+      resumeInstruction: intent.resumeInstruction,
+      activeConstraints: intent.constraints ?? null,
+      openQuestions: intent.questions ?? null,
+      surfaceMarkers: intent.surfaceMarkers ?? null,
+      relevantArtifactIds: intent.artifacts ?? null,
+      confidence: intent.confidence ?? null,
+      // Frequent triggers (compaction, session-end) land within the FR-051 4h
+      // window; Acknowledge lets the checkpoint persist on the lane.
+      concurrentSessionPolicy: "Acknowledge"
+    }
+  });
+  recordPush(cwd, intent);
+  return true;
+}
+function ledgerPath(start) {
+  const intent = resolveIntentPath(start);
+  const dir = intent ? dirname4(intent) : join5(start, ".sechroom");
+  return join5(dir, ".checkpoint-state.json");
+}
+function readLedger(start) {
+  try {
+    const p = ledgerPath(start);
+    if (!existsSync4(p)) return {};
+    return JSON.parse(readFileSync3(p, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function intentHash(i) {
+  const canonical = JSON.stringify({
+    objective: i.objective ?? "",
+    state: i.state ?? "",
+    lastAction: i.lastAction ?? "",
+    nextAction: i.nextAction ?? "",
+    resumeInstruction: i.resumeInstruction ?? "",
+    scope: i.scope ?? "",
+    constraints: i.constraints ?? [],
+    questions: i.questions ?? [],
+    surfaceMarkers: i.surfaceMarkers ?? [],
+    artifacts: i.artifacts ?? [],
+    confidence: i.confidence ?? null
+  });
+  return createHash2("sha256").update(canonical, "utf8").digest("hex");
+}
+function recentlyCheckpointed(start, minutes) {
+  const { lastEpochMs } = readLedger(start);
+  return typeof lastEpochMs === "number" && Date.now() - lastEpochMs < minutes * 6e4;
+}
+function unchangedSinceLastPush(start, intent) {
+  const ledger = readLedger(start);
+  if (ledger.lastHash == null) return false;
+  const path = resolveIntentPath(start);
+  if (path && ledger.lastMtimeMs != null) {
+    try {
+      if (statSync2(path).mtimeMs <= ledger.lastMtimeMs) return true;
+    } catch {
+    }
+  }
+  return intentHash(intent) === ledger.lastHash;
+}
+function recordPush(start, intent) {
+  try {
+    const p = ledgerPath(start);
+    const path = resolveIntentPath(start);
+    let mtimeMs;
+    try {
+      if (path) mtimeMs = statSync2(path).mtimeMs;
+    } catch {
+      mtimeMs = void 0;
+    }
+    mkdirSync3(dirname4(p), { recursive: true });
+    const ledger = {
+      lastEpochMs: Date.now(),
+      lastMtimeMs: mtimeMs,
+      lastHash: intentHash(intent)
+    };
+    writeFileSync3(p, JSON.stringify(ledger) + "\n");
+  } catch {
+  }
+}
 function formatContext(bundle, lane) {
   const s = bundle?.latestSnapshot;
   if (!s) return null;
@@ -2154,20 +2397,23 @@ function emitSessionStart(additionalContext) {
     }) + "\n"
   );
 }
-var HOOK_COMMANDS = {
+var CLAUDE_HOOK_COMMANDS = {
+  SessionStart: "sechroom hook session-start",
+  PreCompact: "sechroom hook pre-compact",
+  SessionEnd: "sechroom hook session-end"
+};
+var CODEX_HOOK_COMMANDS = {
   SessionStart: "sechroom hook session-start",
-  PreCompact: "sechroom hook pre-compact"
+  Stop: "sechroom hook session-end --debounce-minutes 10"
 };
-var HOOK_EVENTS = ["SessionStart", "PreCompact"];
 function hasHookCommand(config2, event, command) {
   const groups = config2.hooks?.[event] ?? [];
   return groups.some((g) => (g.hooks ?? []).some((h) => h.type === "command" && h.command === command));
 }
-function mergeHooks(config2) {
+function mergeHooks(config2, commands) {
   config2.hooks ??= {};
   let added = 0;
-  for (const event of HOOK_EVENTS) {
-    const command = HOOK_COMMANDS[event];
+  for (const [event, command] of Object.entries(commands)) {
     if (hasHookCommand(config2, event, command)) continue;
     const groups = config2.hooks[event] ??= [];
     groups.push({ hooks: [{ type: "command", command }] });
@@ -2181,10 +2427,10 @@ function readJsonConfig2(path) {
   if (!raw.trim()) return {};
   return JSON.parse(raw);
 }
-function installHooksJson(path, dryRun) {
+function installHooksJson(path, commands, dryRun) {
   const existed = existsSync4(path) && readFileSync3(path, "utf8").trim().length > 0;
   const config2 = readJsonConfig2(path);
-  const added = mergeHooks(config2);
+  const added = mergeHooks(config2, commands);
   if (added === 0 && existed) return { path, status: "current" };
   if (!dryRun) {
     mkdirSync3(dirname4(path), { recursive: true });
@@ -2244,11 +2490,11 @@ function installHookSurfaces(surfaces, opts) {
   const out = [];
   for (const surface of surfaces) {
     if (surface === "claude") {
-      const path = opts.local ? join4(opts.cwd, ".claude", "settings.json") : join4(opts.home, ".claude", "settings.json");
-      out.push({ surface, results: [installHooksJson(path, opts.dryRun)] });
+      const path = join5(opts.claudeDir, "settings.json");
+      out.push({ surface, results: [installHooksJson(path, CLAUDE_HOOK_COMMANDS, opts.dryRun)] });
     } else {
-      const hooksJson = installHooksJson(join4(opts.home, ".codex", "hooks.json"), opts.dryRun);
-      const featureFlag = installCodexFeatureFlag(join4(opts.home, ".codex", "config.toml"), opts.dryRun);
+      const hooksJson = installHooksJson(join5(opts.codexHome, "hooks.json"), CODEX_HOOK_COMMANDS, opts.dryRun);
+      const featureFlag = installCodexFeatureFlag(join5(opts.codexHome, "config.toml"), opts.dryRun);
       out.push({ surface, results: [hooksJson, featureFlag] });
     }
   }
@@ -2268,7 +2514,7 @@ function isSechroomOnPath() {
   for (const dir of pathEnv.split(delimiter)) {
     if (!dir) continue;
     for (const name of names) {
-      if (existsSync4(join4(dir, name))) return true;
+      if (existsSync4(join5(dir, name))) return true;
     }
   }
   return false;
@@ -2327,52 +2573,62 @@ Fail-soft: no lane / no auth / no-or-partial intent file / API error -> exit 0,
       const raw = await readStdin();
       const input = parseHookInput(raw);
       const cwd = input.cwd ?? process.cwd();
-      const lane = resolveLane(opts.lane, input.cwd);
-      if (!lane) return process.exit(0);
-      const intent = readIntent(cwd);
-      if (!intent || !hasRequiredIntent(intent)) return process.exit(0);
-      const cfg = resolveConfig(cmd.optsWithGlobals());
-      const client = await makeClient(cfg);
-      await client.POST("/continuity/snapshots", {
-        body: {
-          laneId: lane,
-          scope: opts.scope ?? intent.scope ?? "compaction",
-          currentObjective: intent.objective,
-          currentState: intent.state,
-          lastMeaningfulAction: intent.lastAction,
-          nextIntendedAction: intent.nextAction,
-          resumeInstruction: intent.resumeInstruction,
-          activeConstraints: intent.constraints ?? null,
-          openQuestions: intent.questions ?? null,
-          surfaceMarkers: intent.surfaceMarkers ?? null,
-          relevantArtifactIds: intent.artifacts ?? null,
-          confidence: intent.confidence ?? null,
-          // Compaction is infrequent, so the FR-051 clobber guard doesn't bite;
-          // Acknowledge lets a within-window checkpoint land on the lane.
-          concurrentSessionPolicy: "Acknowledge"
-        }
-      });
+      await saveSnapshotFromIntent(cmd, cwd, opts.lane, opts.scope, "compaction", { skipIfUnchanged: true });
+      return process.exit(0);
+    } catch {
+      return process.exit(0);
+    }
+  });
+  hook.command("session-end").description("Save a continuity snapshot from the intent file on a SessionEnd (Claude) / Stop (Codex) hook").option("--lane <laneId>", "Override the resolved lane (else SECHROOM_LANE, else ./.sem code-lane)").option("--scope <scope>", "Snapshot scope (else the intent file's `scope`, else 'session-end')").option("--surface <surface>", "Target surface: claude | codex (lifecycle-only on both)", "claude").option(
+    "--debounce-minutes <n>",
+    "skip if a hook checkpoint ran within this many minutes \u2014 for high-frequency triggers like Codex Stop (Claude SessionEnd passes none)"
+  ).action(async (opts, cmd) => {
+    try {
+      const raw = await readStdin();
+      const input = parseHookInput(raw);
+      const cwd = input.cwd ?? process.cwd();
+      const debounce = opts.debounceMinutes != null ? Number(opts.debounceMinutes) : 0;
+      if (debounce > 0 && recentlyCheckpointed(cwd, debounce)) return process.exit(0);
+      await saveSnapshotFromIntent(cmd, cwd, opts.lane, opts.scope, "session-end", { skipIfUnchanged: true });
       return process.exit(0);
     } catch {
       return process.exit(0);
     }
   });
-  hook.command("install").description("Wire the session-start + pre-compact hooks into Claude Code and/or Codex config").option("--surface <surface>", "Target surface: claude | codex | both (default: auto-detect installed surfaces)").option("--local", "Claude Code only: write <cwd>/.claude/settings.json instead of ~/.claude/settings.json").option("--dry-run", "Print what would change; write nothing").action((opts) => {
+  hook.command("install").description("Wire the session-start + pre-compact hooks into Claude Code and/or Codex config").option("--surface <surface>", "Target surface: claude | codex | both (default: auto-detect installed surfaces)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--dry-run", "Print what would change; write nothing").action((opts, cmd) => {
+    const g = cmd.optsWithGlobals();
     const dryRun = Boolean(opts.dryRun);
     const cwd = process.cwd();
+    let scope;
     let surfaces;
     try {
+      scope = opts.local ? "project" : resolveScope(opts.scope);
       surfaces = resolveSurfaces(opts.surface, cwd);
     } catch (err2) {
       process.stderr.write(`${err2.message}
 `);
       return process.exit(2);
     }
+    const claudeTargets = surfaces.includes("claude") ? resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd }) : [];
+    const codexHomes = surfaces.includes("codex") ? resolveCodexHomes({ override: g.codexHome, scope }) : [];
     const results = [];
     try {
-      const installed = installHookSurfaces(surfaces, { dryRun, local: opts.local, cwd, home: homedir3() });
-      for (const { surface, results: surfaceResults } of installed) {
-        process.stdout.write(`${HOOK_SURFACE_LABEL[surface]}:
+      const multiClaude = claudeTargets.length > 1;
+      for (const t of claudeTargets) {
+        const surfaceResults = installHookSurfaces(["claude"], { dryRun, claudeDir: t.dir, codexHome: "" })[0].results;
+        process.stdout.write(`${HOOK_SURFACE_LABEL.claude}${multiClaude ? ` (${t.label})` : ""}:
+`);
+        for (const r of surfaceResults) {
+          results.push(r);
+          process.stdout.write(describe(r, dryRun) + "\n");
+        }
+      }
+      if (surfaces.includes("codex") && codexHomes.length === 0) {
+        process.stdout.write("Codex has no project scope \u2014 skipped (use --scope global for Codex).\n");
+      }
+      for (const codexHome of codexHomes) {
+        const surfaceResults = installHookSurfaces(["codex"], { dryRun, claudeDir: "", codexHome })[0].results;
+        process.stdout.write(`${HOOK_SURFACE_LABEL.codex}:
 `);
         for (const r of surfaceResults) {
           results.push(r);
@@ -2396,6 +2652,101 @@ Fail-soft: no lane / no auth / no-or-partial intent file / API error -> exit 0,
   });
 }
 
+// src/commands/checkpoint.ts
+function registerCheckpoint(program2) {
+  program2.command("checkpoint").description(
+    "Checkpoint working state: create a continuity snapshot (server-validated) AND sync ./.sechroom/continuity.json in one step"
+  ).option("--lane <laneId>", "Lane id (else SECHROOM_LANE, else ./.sem code-lane)").option("--scope <scope>", "Snapshot scope (else the file's scope, else 'session')").option("--objective <text>", "Current objective").option("--state <text>", "Current state").option("--last-action <text>", "Last meaningful action").option("--next-action <text>", "Next intended action").option("--resume-instruction <text>", "Resume instruction").option("--constraint <text...>", "Active constraints (repeatable)").option("--question <text...>", "Open questions (repeatable)").option("--surface-marker <text...>", "Surface markers (repeatable)").option("--artifact <id...>", "Relevant artifact ids (repeatable)").option("--confidence <n>", "Confidence 0..1").option("--dry-run", "validate + print the snapshot payload without creating it or writing the file", false).addHelpText(
+    "after",
+    `
+File-first: reads ./.sechroom/continuity.json (kept current as you work) as the base; any flag
+overrides that field. The snapshot is created FIRST (server-validated), then the local file is
+written/normalized with the returned snapshotId. Lane: --lane > SECHROOM_LANE > ./.sem code-lane.
+
+Examples:
+  $ sechroom checkpoint                          snapshot from ./.sechroom/continuity.json, then sync it
+  $ sechroom checkpoint --next-action "..."      override one field, keep the rest from the file
+  $ sechroom checkpoint --lane claude-code-chris --objective "..." --state "..." \\
+      --last-action "..." --next-action "..." --resume-instruction "..."`
+  ).action(async (opts, cmd) => {
+    const cwd = process.cwd();
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const json = Boolean(cmd.optsWithGlobals().json);
+    const base = readIntent(cwd) ?? {};
+    const merged = {
+      objective: opts.objective ?? base.objective,
+      state: opts.state ?? base.state,
+      lastAction: opts.lastAction ?? base.lastAction,
+      nextAction: opts.nextAction ?? base.nextAction,
+      resumeInstruction: opts.resumeInstruction ?? base.resumeInstruction,
+      scope: opts.scope ?? base.scope,
+      constraints: opts.constraint ?? base.constraints,
+      questions: opts.question ?? base.questions,
+      surfaceMarkers: opts.surfaceMarker ?? base.surfaceMarkers,
+      artifacts: opts.artifact ?? base.artifacts,
+      confidence: opts.confidence != null ? Number(opts.confidence) : base.confidence
+    };
+    const lane = resolveLane(opts.lane, cwd);
+    if (!lane) {
+      fail(
+        "no lane resolved \u2014 pass --lane, set SECHROOM_LANE, or pin one in ./.sem (code-lane). See `sechroom lane`."
+      );
+    }
+    const required = [
+      ["objective", "--objective"],
+      ["state", "--state"],
+      ["lastAction", "--last-action"],
+      ["nextAction", "--next-action"],
+      ["resumeInstruction", "--resume-instruction"]
+    ];
+    const missing = required.filter(([k]) => !String(merged[k] ?? "").trim()).map(([, flag]) => flag);
+    if (missing.length > 0) {
+      fail(
+        `missing required field(s): ${missing.join(", ")} \u2014 supply via flag or in ./.sechroom/continuity.json`
+      );
+    }
+    const scope = merged.scope ?? "session";
+    const body = {
+      laneId: lane,
+      scope,
+      currentObjective: merged.objective,
+      currentState: merged.state,
+      lastMeaningfulAction: merged.lastAction,
+      nextIntendedAction: merged.nextAction,
+      resumeInstruction: merged.resumeInstruction,
+      activeConstraints: merged.constraints ?? null,
+      openQuestions: merged.questions ?? null,
+      surfaceMarkers: merged.surfaceMarkers ?? null,
+      relevantArtifactIds: merged.artifacts ?? null,
+      confidence: merged.confidence ?? null,
+      // Explicit checkpoints are often within the FR-051 4h window; Acknowledge
+      // lets one land on the lane (matches `hook pre-compact`).
+      concurrentSessionPolicy: "Acknowledge"
+    };
+    if (opts.dryRun) {
+      emit({ dryRun: true, lane, scope, wouldCreate: body }, json);
+      return;
+    }
+    const data = await runApi("Creating snapshot", async () => {
+      const client = await makeClient(cfg);
+      return client.POST("/continuity/snapshots", { body });
+    });
+    const path = resolveIntentPath(cwd) ?? join6(cwd, INTENT_FILE);
+    const fileBody = { ...merged, scope, lastSnapshotId: data.snapshotId };
+    mkdirSync4(dirname5(path), { recursive: true });
+    writeFileSync4(path, JSON.stringify(fileBody, null, 2) + "\n");
+    recordPush(cwd, merged);
+    if (json) {
+      emit({ snapshotId: data.snapshotId, lane, scope, file: path }, true);
+      return;
+    }
+    process.stdout.write(
+      `${style.bold("\u2713")} checkpoint ${style.bold(data.snapshotId)} ${style.dim(`(lane ${lane}, scope ${scope})`)} \u2014 synced ${path}
+`
+    );
+  });
+}
+
 // src/commands/account.ts
 function registerId(program2) {
   const id = program2.command("id").description("Allocate human-authored id sequences (FR-*, D-*)");
@@ -2612,16 +2963,16 @@ Examples:
 }
 
 // src/setup/apply.ts
-import { createHash as createHash2 } from "crypto";
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync5 } from "fs";
-import { dirname as dirname5 } from "path";
+import { createHash as createHash3 } from "crypto";
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync5, existsSync as existsSync5 } from "fs";
+import { dirname as dirname6 } from "path";
 var MARKER_BEGIN = "<!-- @sechroom/cli:begin";
 var MARKER_END = "<!-- @sechroom/cli:end";
 function normalizeBody(s) {
   return s.replace(/\r\n/g, "\n").trim();
 }
 function bodySha256(body) {
-  return createHash2("sha256").update(normalizeBody(body), "utf8").digest("hex");
+  return createHash3("sha256").update(normalizeBody(body), "utf8").digest("hex");
 }
 function renderBlock(write) {
   const body = normalizeBody(write.body);
@@ -2667,7 +3018,7 @@ function parseManagedBlock(content, block) {
   return null;
 }
 function ensureDir2(path) {
-  mkdirSync4(dirname5(path), { recursive: true });
+  mkdirSync5(dirname6(path), { recursive: true });
 }
 function readOr(path, fallback) {
   try {
@@ -2690,7 +3041,7 @@ function mergeMcpJson(path, snippet, dryRun) {
   current.mcpServers = { ...current.mcpServers ?? {}, ...incoming.mcpServers ?? {} };
   if (dryRun) return { kind: "mcp", path, status: "dry-run" };
   ensureDir2(path);
-  writeFileSync4(path, JSON.stringify(current, null, 2) + "\n", { mode: 384 });
+  writeFileSync5(path, JSON.stringify(current, null, 2) + "\n", { mode: 384 });
   return { kind: "mcp", path, status: existed ? "merged" : "created" };
 }
 function mergeCodexToml(path, snippet, dryRun) {
@@ -2701,7 +3052,7 @@ function mergeCodexToml(path, snippet, dryRun) {
   const next = (trimmed.length > 0 ? trimmed + "\n\n" : "") + snippet.trim() + "\n";
   if (dryRun) return { kind: "mcp", path, status: "dry-run" };
   ensureDir2(path);
-  writeFileSync4(path, next, { mode: 384 });
+  writeFileSync5(path, next, { mode: 384 });
   return { kind: "mcp", path, status: existed ? "merged" : "created" };
 }
 function writeInstructionBlock(path, write, dryRun) {
@@ -2709,7 +3060,7 @@ function writeInstructionBlock(path, write, dryRun) {
   const next = computeBlockFile(readOr(path, ""), write);
   if (dryRun) return { kind: "instruction", path, status: "dry-run" };
   ensureDir2(path);
-  writeFileSync4(path, next);
+  writeFileSync5(path, next);
   return { kind: "instruction", path, status: existed ? "merged" : "created" };
 }
 function computeBlockFile(current, write) {
@@ -2750,7 +3101,7 @@ function applyBlock(path, write, mode, dryRun) {
     const next = computeBlockFile(current, write);
     if (!dryRun) {
       ensureDir2(proposedPath);
-      writeFileSync4(proposedPath, next);
+      writeFileSync5(proposedPath, next);
     }
     return {
       kind: "instruction",
@@ -2821,12 +3172,14 @@ async function applyClient(cfg, setup, target, opts) {
 }
 
 // src/setup/hooks-offer.ts
-import { homedir as homedir4 } from "os";
 async function maybeOfferHooks(opts) {
   if (opts.dryRun) return;
   const cwd = opts.cwd ?? process.cwd();
+  const scope = opts.scope ?? "global";
   const surfaces = detectHookSurfaces(cwd);
   if (surfaces.length === 0) return;
+  const claudeTargets = surfaces.includes("claude") ? resolveClaudeTargets({ override: opts.claudeConfigDir, scope, cwd }) : [];
+  const codexHomes = surfaces.includes("codex") ? resolveCodexHomes({ override: opts.codexHome, scope }) : [];
   const names = surfaces.map((s) => HOOK_SURFACE_LABEL[s]).join(" + ");
   process.stderr.write(
     `
@@ -2837,15 +3190,28 @@ auto-resumes where you left off and checkpoints working state before compacting.
   const install = opts.yes ? true : canPrompt() ? await promptYesNo(`Install the continuity hooks for ${names}?`) : false;
   if (!install) return;
   try {
-    const installed = installHookSurfaces(surfaces, { dryRun: false, cwd, home: homedir4() });
     let changed = false;
-    for (const { surface, results } of installed) {
+    const emit2 = (surface, results, label) => {
       for (const r of results) {
         if (r.status !== "current") changed = true;
         const verb = r.status === "current" ? "already configured" : r.status === "created" ? "created" : "updated";
-        process.stderr.write(`${style.green("\u2713")} ${HOOK_SURFACE_LABEL[surface]}: ${r.path} (${verb})
+        const tag = label ? ` ${style.dim(`(${label})`)}` : "";
+        process.stderr.write(`${style.green("\u2713")} ${HOOK_SURFACE_LABEL[surface]}${tag}: ${r.path} (${verb})
 `);
       }
+    };
+    const multiClaude = claudeTargets.length > 1;
+    for (const t of claudeTargets) {
+      const results = installHookSurfaces(["claude"], { dryRun: false, claudeDir: t.dir, codexHome: "" })[0].results;
+      emit2("claude", results, multiClaude ? t.label : void 0);
+    }
+    if (surfaces.includes("codex") && codexHomes.length === 0) {
+      process.stderr.write(`${style.dim("Codex has no project scope \u2014 skipped (use --scope global for Codex).")}
+`);
+    }
+    for (const codexHome of codexHomes) {
+      const results = installHookSurfaces(["codex"], { dryRun: false, claudeDir: "", codexHome })[0].results;
+      emit2("codex", results);
     }
     if (changed) {
       process.stderr.write(`${style.dim("Restart (or reload) your agent for the hooks to take effect.")}
@@ -2859,9 +3225,8 @@ auto-resumes where you left off and checkpoints working state before compacting.
 }
 
 // src/setup/skills-offer.ts
-import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "fs";
-import { homedir as homedir5 } from "os";
-import { join as join5 } from "path";
+import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync7 } from "fs";
+import { join as join8 } from "path";
 
 // src/setup/lane-pin.ts
 var CODE_LANE_PREFIX_BY_CLIENT = {
@@ -2943,57 +3308,173 @@ I can pin this checkout's lane so operator skills + the continuity hook resolve
   writePin(code || void 0, design || void 0);
 }
 
-// src/setup/skills-offer.ts
-var ROLE_TAG = "sechroom:role:skill-template";
+// src/setup/skill-resolution.ts
+var SYSTEM_WORKSPACE_ID = "wsp_system";
+var SKILL_ROLE_TAG = "sechroom:role:skill-template";
+var SKILL_NAME_PREFIX = "skill:";
+var AGENT_ROLE_TAG = "sechroom:role:agent-template";
+var AGENT_NAME_PREFIX = "agent:";
+function tagsOf(row) {
+  const m = row?.item ?? row;
+  return m?.tags ?? m?.Tags ?? [];
+}
 function tagValue(tags, prefix) {
   return tags.find((t) => t.startsWith(prefix))?.slice(prefix.length);
 }
-async function maybeOfferSkills(cfg, personalWorkspaceId, opts) {
-  if (!personalWorkspaceId || opts.dryRun) return;
-  const surface = opts.surface ?? "claude-code";
-  let rows = [];
+function bodyOf(row) {
+  const m = row?.item ?? row;
+  return m?.text ?? m?.Text ?? "";
+}
+function entriesFromRows(rows, surface, source, roleTag, namePrefix) {
+  const out = /* @__PURE__ */ new Map();
+  for (const row of rows ?? []) {
+    const tags = tagsOf(row);
+    if (!tags.includes(roleTag)) continue;
+    if (tagValue(tags, "target:") !== surface) continue;
+    const name = tagValue(tags, namePrefix);
+    if (!name) continue;
+    out.set(name, { name, body: bodyOf(row), source });
+  }
+  return out;
+}
+function resolveByRole(systemRows, personalRows, surface, roleTag, namePrefix) {
+  const merged = entriesFromRows(systemRows, surface, "system", roleTag, namePrefix);
+  for (const [name, item] of entriesFromRows(personalRows, surface, "personal", roleTag, namePrefix)) {
+    merged.set(name, item);
+  }
+  return [...merged.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function resolveSkills(systemRows, personalRows, surface) {
+  return resolveByRole(systemRows, personalRows, surface, SKILL_ROLE_TAG, SKILL_NAME_PREFIX);
+}
+function resolveAgents(systemRows, personalRows, surface) {
+  return resolveByRole(systemRows, personalRows, surface, AGENT_ROLE_TAG, AGENT_NAME_PREFIX);
+}
+
+// src/setup/skill-resolution-io.ts
+var AGENT_TARGET = { "claude-code": "claude-agent" };
+function agentTargetFor(surface) {
+  return AGENT_TARGET[surface] ?? `${surface}-agent`;
+}
+async function fetchFeedRows(cfg, workspaceId) {
   try {
     const client = await makeClient(cfg);
     const feed = await client.GET("/workspaces/{workspaceId}/memories/feed", {
       params: {
-        path: { workspaceId: personalWorkspaceId },
+        path: { workspaceId },
+        // cascadeWorkspaces: skills land in an "Operator Skills" SUB-workspace;
+        // includeText: the feed omits bodies by default, we need them for SKILL.md.
         query: { limit: 200, cascadeWorkspaces: true, includeText: true }
       }
     }).then((r) => r.data).catch(() => void 0);
-    rows = feed?.results ?? feed?.Results ?? [];
+    return feed?.results ?? feed?.Results ?? [];
+  } catch {
+    return [];
+  }
+}
+async function fetchTemplateRows(cfg, personalWorkspaceId) {
+  const [systemRows, personalRows] = await Promise.all([
+    fetchFeedRows(cfg, SYSTEM_WORKSPACE_ID),
+    personalWorkspaceId ? fetchFeedRows(cfg, personalWorkspaceId) : Promise.resolve([])
+  ]);
+  return { systemRows, personalRows };
+}
+function resolveSkillSet(rows, surface) {
+  return resolveSkills(rows.systemRows, rows.personalRows, surface);
+}
+function resolveAgentSet(rows, surface) {
+  return resolveAgents(rows.systemRows, rows.personalRows, agentTargetFor(surface));
+}
+
+// src/setup/skills-lock.ts
+import { existsSync as existsSync6, mkdirSync as mkdirSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
+import { join as join7 } from "path";
+var SKILLS_LOCK = ".sechroom-skills.json";
+var DEFAULT_SKILLS_SLUG = "operator-skills";
+function skillsDir(configDir) {
+  return join7(configDir, "skills");
+}
+function agentsDir(configDir) {
+  return join7(configDir, "agents");
+}
+function readSkillsLock(dir) {
+  const lockPath = join7(dir, SKILLS_LOCK);
+  if (!existsSync6(lockPath)) return {};
+  try {
+    return JSON.parse(readFileSync5(lockPath, "utf8"));
   } catch {
+    return {};
+  }
+}
+function writeSkillsLock(dir, lock) {
+  mkdirSync6(dir, { recursive: true });
+  writeFileSync6(join7(dir, SKILLS_LOCK), JSON.stringify(lock, null, 2) + "\n");
+}
+function recordMaterialisedSkills(dir, slug, skills, meta = {}) {
+  const lock = readSkillsLock(dir);
+  lock[slug] = { surface: meta.surface, skills: [...skills].sort() };
+  writeSkillsLock(dir, lock);
+}
+
+// src/setup/skills-offer.ts
+async function maybeOfferSkills(cfg, personalWorkspaceId, opts) {
+  const surface = opts.surface ?? "claude-code";
+  const configDir = opts.configDir ?? resolveClaudeTargets({})[0].dir;
+  const rows = await fetchTemplateRows(cfg, personalWorkspaceId);
+  const skills = resolveSkillSet(rows, surface);
+  const agents = resolveAgentSet(rows, surface);
+  if (skills.length === 0 && agents.length === 0) return;
+  const sDir = skillsDir(configDir);
+  const aDir = agentsDir(configDir);
+  if (opts.dryRun) {
+    const lines = (label, items) => items.length === 0 ? "" : `
+Would materialise ${style.bold(String(items.length))} ${label} for ${surface}:
+` + items.map((s) => `  ${s.name} ${style.dim(`[${s.source}]`)}`).join("\n") + "\n";
+    process.stderr.write(lines("operator skill(s)", skills) + lines("agent(s)", agents));
     return;
   }
-  const skills = rows.map((r) => r.item ?? r).filter((m) => {
-    const tags = m.tags ?? m.Tags ?? [];
-    return tags.includes(ROLE_TAG) && tagValue(tags, "target:") === surface;
-  });
-  if (skills.length === 0) return;
-  const byName = /* @__PURE__ */ new Map();
-  for (const m of skills) {
-    const name = tagValue(m.tags ?? m.Tags ?? [], "skill:");
-    if (name) byName.set(name, m);
-  }
-  const names = [...byName.keys()].sort();
-  if (names.length === 0) return;
-  process.stderr.write(
-    `
-Found ${style.bold(String(names.length))} operator skill(s) installed in your workspace: ${names.join(", ")}.
-`
-  );
-  const dir = join5(homedir5(), ".claude", "skills");
-  const materialise = opts.yes ? true : canPrompt() ? await promptYesNo(`Write them to ${dir}/ so ${surface} can use them?`) : false;
+  const summary = [
+    skills.length > 0 ? `${style.bold(String(skills.length))} skill(s)` : "",
+    agents.length > 0 ? `${style.bold(String(agents.length))} agent(s)` : ""
+  ].filter(Boolean).join(" + ");
+  process.stderr.write(`
+Found ${summary} available to you for ${surface}.
+`);
+  if (skills.length > 0) process.stderr.write(`  skills: ${skills.map((s) => s.name).join(", ")}
+`);
+  if (agents.length > 0) process.stderr.write(`  agents: ${agents.map((a) => a.name).join(", ")}
+`);
+  const dest = [skills.length > 0 ? `${sDir}/` : "", agents.length > 0 ? `${aDir}/` : ""].filter(Boolean).join(" + ");
+  const materialise = opts.yes ? true : canPrompt() ? await promptYesNo(`Write them to ${dest} so ${surface} can use them?`) : false;
   if (!materialise) return;
-  const written = [];
-  for (const [name, m] of byName) {
-    const body = m.text ?? m.Text ?? "";
-    mkdirSync5(join5(dir, name), { recursive: true });
-    writeFileSync5(join5(dir, name, "SKILL.md"), body.endsWith("\n") ? body : body + "\n");
-    written.push(name);
+  if (skills.length > 0) {
+    const written = [];
+    for (const s of skills) {
+      mkdirSync7(join8(sDir, s.name), { recursive: true });
+      writeFileSync7(join8(sDir, s.name, "SKILL.md"), s.body.endsWith("\n") ? s.body : s.body + "\n");
+      written.push(s.name);
+    }
+    recordMaterialisedSkills(sDir, DEFAULT_SKILLS_SLUG, written, { surface });
+    process.stderr.write(`${style.green("\u2713")} wrote ${written.length} skill(s) to ${sDir}
+`);
   }
-  process.stderr.write(`${style.green("\u2713")} wrote ${written.length} skill(s) to ${dir}
+  if (agents.length > 0) {
+    mkdirSync7(aDir, { recursive: true });
+    const written = [];
+    for (const a of agents) {
+      const file = `${a.name}.md`;
+      writeFileSync7(join8(aDir, file), a.body.endsWith("\n") ? a.body : a.body + "\n");
+      written.push(file);
+    }
+    recordMaterialisedSkills(aDir, DEFAULT_SKILLS_SLUG, written, { surface });
+    process.stderr.write(`${style.green("\u2713")} wrote ${written.length} agent(s) to ${aDir}
 `);
-  await ensureLanePin(cfg, { yes: opts.yes, dryRun: opts.dryRun, clients: [surface] });
+  }
+  await ensureLanePin(cfg, {
+    yes: opts.yes,
+    dryRun: opts.dryRun,
+    clients: [surface]
+  });
 }
 
 // src/commands/setup.ts
@@ -3031,14 +3512,14 @@ version, the shared template stays clean, and you can discard back anytime.
 }
 function resolveClientKeys(raw) {
   const targets = clientTargets(process.cwd());
-  if (raw === "all") return [...ALL_CLIENT_KEYS];
-  const keys = raw.split(",").map((k) => k.trim()).filter(Boolean);
-  for (const k of keys) {
+  const tokens = (Array.isArray(raw) ? raw : [raw]).flatMap((t) => t.split(",")).map((k) => k.trim()).filter(Boolean);
+  if (tokens.includes("all")) return [...ALL_CLIENT_KEYS];
+  for (const k of tokens) {
     if (!targets[k]) {
       fail(`unknown client '${k}'. Known: ${ALL_CLIENT_KEYS.join(", ")}, or 'all'.`);
     }
   }
-  return keys;
+  return [...new Set(tokens)];
 }
 function printActions(client, actions) {
   process.stdout.write(`
@@ -3050,24 +3531,96 @@ ${client.label} (${client.key}):
 `);
   }
 }
+function resolveEvalMode(opts) {
+  return opts.check ? "check" : opts.force ? "force" : "apply";
+}
+function summarizeEval(result, mode, json, dryRun) {
+  const counts = { current: 0, stale: 0, drift: 0, absent: 0 };
+  for (const { actions } of result) for (const a of actions) if (a.eval) counts[a.eval]++;
+  const wouldChange = counts.stale + counts.drift + counts.absent;
+  if (mode === "check") {
+    if (!json) {
+      if (wouldChange === 0) {
+        process.stdout.write("\u2713 all instruction blocks are up to date.\n");
+      } else {
+        const bits = [];
+        if (counts.stale) bits.push(`${counts.stale} out of date`);
+        if (counts.drift) bits.push(`${counts.drift} with local edits`);
+        if (counts.absent) bits.push(`${counts.absent} not yet written`);
+        process.stderr.write(
+          `\u26A0 ${wouldChange} instruction block(s) would change: ${bits.join(", ")}. Re-run with ${style.cyan("--refresh")}.
+`
+        );
+      }
+    }
+    process.exit(wouldChange === 0 ? 0 : 1);
+  }
+  if (json) return;
+  if (!dryRun && counts.stale) {
+    process.stderr.write(`\u21BB refreshed ${counts.stale} section(s) the server had moved
+`);
+  }
+  if (!dryRun && counts.drift) {
+    process.stderr.write(
+      mode === "force" ? `\u26A0 overwrote ${counts.drift} section(s) that had local edits (--force)
+` : `\u26A0 ${counts.drift} section(s) have local edits \u2014 wrote a .proposed file alongside (original untouched). Review + merge, or re-run with ${style.cyan("--force")}.
+`
+    );
+  }
+}
+var GLOBAL_NAMESPACE = "__global__";
+async function resolveNamespaceChoice(cfg, flag) {
+  if (flag) return flag;
+  if (!canPrompt()) return null;
+  const namespaces = await listNamespaces(cfg);
+  if (namespaces.length === 0) return null;
+  const picked = await promptSelect(
+    "Which namespace should this connection use?",
+    [
+      { label: "Global (whole tenant)", value: GLOBAL_NAMESPACE },
+      ...namespaces.map((n) => ({
+        label: n.displayName,
+        value: n.slug,
+        hint: n.slug
+      }))
+    ],
+    GLOBAL_NAMESPACE
+  );
+  return picked === GLOBAL_NAMESPACE ? null : picked;
+}
 function registerInit(program2) {
-  program2.command("init").description("Wire this project for sechroom: write MCP config + agent instruction files from the server's setup descriptors").option("--client <list>", `comma-separated clients (${ALL_CLIENT_KEYS.join(", ")}) or 'all'`, DEFAULT_CLIENT_KEY).option("--dry-run", "print what would be written without writing", false).option("--mcp-only", "only write MCP config (skip agent files)", false).option("--agent-files-only", "only write agent instruction files (skip MCP config)", false).option("--copy", "make a personal copy of the agent instructions you can edit (default: prompt on a TTY, else skip)").addHelpText(
+  program2.command("init").description("Wire this project for sechroom: write MCP config + agent instruction files from the server's setup descriptors").option("--client <list...>", `clients to wire \u2014 space- or comma-separated (${ALL_CLIENT_KEYS.join(", ")}) or 'all'`, DEFAULT_CLIENT_KEY).option("--scope <scope>", "install skills/agents/hooks 'global' (config dir / CLAUDE_CONFIG_DIR) or 'project' (<cwd>/.claude) \u2014 default global", "global").option("--dry-run", "print what would be written without writing", false).option("--mcp-only", "only write MCP config (skip agent files)", false).option("--agent-files-only", "only write agent instruction files (skip MCP config)", false).option("--copy", "make a personal copy of the agent instructions you can edit (default: prompt on a TTY, else skip)").option("--namespace <slug>", "MCP namespace for the connection URL (interactive picker if omitted on a TTY; defaults to tenant-global)").option("--refresh", "refresh out-of-date agent-file blocks in place (local edits preserved to .proposed)", false).option("--force", "rewrite agent-file managed blocks, overwriting local edits inside the markers", false).option("--check", "report whether agent files would change and exit (0 = current, 1 = stale/drift/absent); writes nothing", false).addHelpText(
     "after",
     `
 Examples:
   $ sechroom init                       Claude Code (default): ./.mcp.json + ./CLAUDE.md
   $ sechroom init --client all          claude-code, claude-desktop, codex, cursor
-  $ sechroom init --client codex,cursor
+  $ sechroom init --client codex cursor   space-separated (comma also works)
   $ sechroom init --mcp-only            just the MCP config (skip agent files)
   $ sechroom init --dry-run --json      preview the writes, change nothing`
   ).action(async (opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
-    const setup = await withSpinner("Fetching setup descriptors", () => fetchSetup(cfg));
-    const targets = clientTargets(process.cwd());
+    const mode = resolveEvalMode(opts);
+    const check = mode === "check";
+    const namespaceSlug = await resolveNamespaceChoice(cfg, opts.namespace);
+    const setup = await withSpinner(
+      "Fetching setup descriptors",
+      () => fetchSetup(cfg, namespaceSlug ?? void 0)
+    );
+    const g = cmd.optsWithGlobals();
+    let scope;
+    try {
+      scope = resolveScope(opts.scope);
+    } catch (err2) {
+      return fail(err2.message);
+    }
+    const claudeTargets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+    const codexHomes = resolveCodexHomes({ override: g.codexHome, scope });
+    const targets = clientTargets(process.cwd(), { claudeDir: claudeTargets[0]?.dir, codexHome: codexHomes[0] });
     const keys = resolveClientKeys(opts.client);
-    const json = cmd.optsWithGlobals().json;
+    const json = g.json;
     const personalWorkspaceId = await getPersonalWorkspaceId(cfg);
-    if (!opts.dryRun && !opts.mcpOnly) {
+    if (!opts.dryRun && !opts.mcpOnly && !check) {
       await maybeOfferCopies(cfg, setup, targets, keys, personalWorkspaceId, copyChoice(opts));
     }
     const result = [];
@@ -3077,16 +3630,20 @@ Examples:
         dryRun: Boolean(opts.dryRun),
         mcp: !opts.agentFilesOnly,
         agentFiles: !opts.mcpOnly,
-        personalWorkspaceId
+        personalWorkspaceId,
+        mode
       });
       result.push({ client: key, actions });
-      if (!json) printActions(target, actions);
+      if (!json && !check) printActions(target, actions);
     }
+    summarizeEval(result, mode, Boolean(json), Boolean(opts.dryRun));
     if (!json && !opts.dryRun && !opts.mcpOnly) {
-      await maybeOfferSkills(cfg, personalWorkspaceId, { yes: false, dryRun: Boolean(opts.dryRun), surface: "claude-code" });
+      for (const t of claudeTargets) {
+        await maybeOfferSkills(cfg, personalWorkspaceId, { yes: false, dryRun: Boolean(opts.dryRun), surface: "claude-code", configDir: t.dir });
+      }
     }
     if (!json && !opts.dryRun && !opts.mcpOnly) {
-      await maybeOfferHooks({ yes: false, dryRun: Boolean(opts.dryRun), cwd: process.cwd() });
+      await maybeOfferHooks({ yes: false, dryRun: Boolean(opts.dryRun), cwd: process.cwd(), scope, claudeConfigDir: g.claudeConfigDir, codexHome: g.codexHome });
     }
     if (json) {
       emit({ dryRun: Boolean(opts.dryRun), clients: result }, true);
@@ -3107,23 +3664,99 @@ Next \u2014 verify: ${verify.description}
 }
 function registerSetup(program2) {
   const setup = program2.command("setup").description("Granular onboarding steps (init runs these together)");
-  setup.command("mcp <clients...>").description(`Write only the MCP config for one or more clients (${ALL_CLIENT_KEYS.join(", ")}, or 'all')`).option("--dry-run", "print what would be written without writing", false).addHelpText("after", "\nExamples:\n  $ sechroom setup mcp codex\n  $ sechroom setup mcp claude-code codex\n  $ sechroom setup mcp all").action(async (clients, opts, cmd) => {
-    await runClients(clients, cmd, { dryRun: Boolean(opts.dryRun), mcp: true, agentFiles: false });
+  setup.command("mcp <clients...>").description(`Write only the MCP config for one or more clients (${ALL_CLIENT_KEYS.join(", ")}, or 'all')`).option("--dry-run", "print what would be written without writing", false).option("--namespace <slug>", "MCP namespace for the connection URL (interactive picker if omitted on a TTY; defaults to tenant-global)").addHelpText("after", "\nExamples:\n  $ sechroom setup mcp codex\n  $ sechroom setup mcp claude-code codex\n  $ sechroom setup mcp all").action(async (clients, opts, cmd) => {
+    await runClients(clients, cmd, { dryRun: Boolean(opts.dryRun), mcp: true, agentFiles: false, namespace: opts.namespace });
   });
-  setup.command("agent-files <clients...>").description(`Write only the agent instruction file(s) for one or more clients (${ALL_CLIENT_KEYS.join(", ")}, or 'all')`).option("--dry-run", "print what would be written without writing", false).option("--copy", "make a personal copy you can edit (default: prompt on a TTY, else skip)").addHelpText("after", "\nExamples:\n  $ sechroom setup agent-files claude-code        CLAUDE.md\n  $ sechroom setup agent-files claude-code codex  CLAUDE.md + AGENTS.md in one run\n  $ sechroom setup agent-files all").action(async (clients, opts, cmd) => {
-    await runClients(clients, cmd, { dryRun: Boolean(opts.dryRun), mcp: false, agentFiles: true, copy: opts.copy });
+  setup.command("agent-files <clients...>").description(`Write only the agent instruction file(s) for one or more clients (${ALL_CLIENT_KEYS.join(", ")}, or 'all')`).option("--dry-run", "print what would be written without writing", false).option("--copy", "make a personal copy you can edit (default: prompt on a TTY, else skip)").option("--refresh", "refresh out-of-date blocks in place (local edits preserved to .proposed)", false).option("--force", "rewrite managed blocks, overwriting local edits inside the markers", false).option("--check", "report whether anything would change and exit (0 = current, 1 = stale/drift/absent); writes nothing", false).addHelpText("after", "\nExamples:\n  $ sechroom setup agent-files claude-code        CLAUDE.md\n  $ sechroom setup agent-files claude-code codex  CLAUDE.md + AGENTS.md in one run\n  $ sechroom setup agent-files all --check        CI gate: nonzero exit if out of date\n  $ sechroom setup agent-files claude-code --force   overwrite local edits in the managed block").action(async (clients, opts, cmd) => {
+    await runClients(clients, cmd, { dryRun: Boolean(opts.dryRun), mcp: false, agentFiles: true, copy: opts.copy, mode: resolveEvalMode(opts) });
+  });
+  setup.command("new-convention <title...>").description("Scaffold a workspace-conventions section: author a correctly-tagged memo (header as first body line) + regen the agent files").option("--kind <kind>", "reference | standard (orders the section; reference first)", "reference").option("--workspace <id>", "workspace to author in (default: the bound workspace)").option("--body <markdown>", "section body (default: a TODO scaffold to edit later)").option("--no-regen", "skip the agent-files regen after authoring").option("--dry-run", "print what would be authored; write nothing", false).addHelpText(
+    "after",
+    `
+The memo carries the two conventions a workspace-conventions section needs (FR-sechroom-236):
+the \`agent-setup-bundle\` tag + the \`# Header\` as the FIRST body line. It's authored in the
+BOUND workspace (so the regen, which sources conventions from there, picks it up). Edit it later
+in the app or via \`sechroom memory edit-text\`.
+
+Examples:
+  $ sechroom setup new-convention "Deploy runbook"
+  $ sechroom setup new-convention "Backend testing" --kind standard --body "- run dotnet test ..."
+  $ sechroom setup new-convention "Draft section" --no-regen   author only, regen later`
+  ).action(async (titleParts, opts, cmd) => {
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const json = Boolean(cmd.optsWithGlobals().json);
+    const title = titleParts.join(" ").trim();
+    if (!title) fail('a section title is required, e.g. `sechroom setup new-convention "Deploy runbook"`.');
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    if (!workspaceId)
+      fail("no workspace \u2014 pass --workspace <id> or bind one (`sechroom config set --local workspaceId <id>`).");
+    const kind = String(opts.kind).toLowerCase() === "standard" ? "standard" : "reference";
+    const body = typeof opts.body === "string" && opts.body.trim().length > 0 ? opts.body.trim() : "_TODO: write this section, then edit the memo and re-run the regen._";
+    const text = `# ${title}
+
+${body}
+`;
+    const tags = ["agent-setup-bundle", "scope:sechroom", `kind:${kind}`, "archetype:document"];
+    if (opts.dryRun) {
+      emit({ dryRun: true, workspaceId, title, kind, tags, text }, json);
+      return;
+    }
+    const data = await runApi("Authoring convention memo", async () => {
+      const client = await makeClient(cfg);
+      return client.POST("/memories", {
+        body: {
+          text,
+          type: kind,
+          content: "{}",
+          confidence: 1,
+          source: "cli-new-convention",
+          archetype: "Document",
+          title,
+          tags,
+          owner: { type: "Workspace", id: workspaceId }
+        }
+      });
+    });
+    if (!json) {
+      const view = resolveViewUrl(cfg.baseUrl, data.url);
+      process.stdout.write(
+        `\u2713 authored convention ${style.bold(data.id)} ${style.dim(`"${title}"`)}${view ? ` ${style.dim("\u2192")} ${view}` : ""}
+`
+      );
+    }
+    if (opts.regen === false) {
+      if (json) emit({ id: data.id, workspaceId, regen: false }, true);
+      else process.stdout.write("Skipped regen (--no-regen). Run `sechroom setup agent-files all` to apply.\n");
+      return;
+    }
+    await runClients(["claude-code", "codex"], cmd, {
+      dryRun: false,
+      mcp: false,
+      agentFiles: true,
+      copy: false,
+      mode: "apply"
+    });
   });
 }
 async function runClients(clients, cmd, opts) {
-  const cfg = resolveConfig(cmd.optsWithGlobals());
-  const targets = clientTargets(process.cwd());
+  const g = cmd.optsWithGlobals();
+  const cfg = resolveConfig(g);
+  const mode = opts.mode ?? "apply";
+  const check = mode === "check";
+  const claudeDir = resolveClaudeTargets({ override: g.claudeConfigDir })[0]?.dir;
+  const codexHome = resolveCodexHomes({ override: g.codexHome })[0];
+  const targets = clientTargets(process.cwd(), { claudeDir, codexHome });
   const keys = resolveClientKeys(clients.join(","));
-  const setupData = await withSpinner("Fetching setup descriptors", () => fetchSetup(cfg));
+  const namespaceSlug = opts.mcp ? await resolveNamespaceChoice(cfg, opts.namespace) : null;
+  const setupData = await withSpinner(
+    "Fetching setup descriptors",
+    () => fetchSetup(cfg, namespaceSlug ?? void 0)
+  );
   const personalWorkspaceId = await getPersonalWorkspaceId(cfg);
-  if (opts.agentFiles && !opts.dryRun) {
+  if (opts.agentFiles && !opts.dryRun && !check) {
     await maybeOfferCopies(cfg, setupData, targets, keys, personalWorkspaceId, copyChoice(opts));
   }
-  const json = cmd.optsWithGlobals().json;
+  const json = g.json;
   const result = [];
   for (const key of keys) {
     const target = targets[key];
@@ -3131,11 +3764,13 @@ async function runClients(clients, cmd, opts) {
       dryRun: opts.dryRun,
       mcp: opts.mcp,
       agentFiles: opts.agentFiles,
-      personalWorkspaceId
+      personalWorkspaceId,
+      mode
     });
     result.push({ client: key, actions });
-    if (!json) printActions(target, actions);
+    if (!json && !check) printActions(target, actions);
   }
+  summarizeEval(result, mode, Boolean(json), opts.dryRun);
   if (json) {
     emit({ dryRun: opts.dryRun, clients: result }, true);
     return;
@@ -3143,14 +3778,81 @@ async function runClients(clients, cmd, opts) {
   process.stdout.write(opts.dryRun ? "\n(dry run \u2014 nothing written)\n" : "\nDone.\n");
 }
 
+// src/commands/namespace.ts
+function registerNamespace(program2) {
+  const namespace = program2.command("namespace").description("Browse, inspect, and wire up MCP namespaces");
+  namespace.addHelpText(
+    "after",
+    `
+Examples:
+  $ sechroom namespace list
+  $ sechroom namespace show eng
+  $ sechroom namespace use eng                 wire Claude Code to the 'eng' namespace
+  $ sechroom namespace use eng --client all`
+  );
+  namespace.command("list").description("List the namespaces you can reach (GET /mcp-aggregator/namespaces)").action(async (_opts, cmd) => {
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const data = await runApi("Listing namespaces", async () => {
+      const client = await makeClient(cfg);
+      return client.GET("/mcp-aggregator/namespaces", {});
+    });
+    emit(data, cmd.optsWithGlobals().json);
+  });
+  namespace.command("show <slug>").description("Show a namespace's details (GET /mcp-aggregator/namespaces/{slug}). For the tool list it exposes, point an OpenAPI client at /t/{tenant}/namespaces/{slug}/api/openapi.json.").action(async (slug, _opts, cmd) => {
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const data = await runApi("Fetching namespace", async () => {
+      const client = await makeClient(cfg);
+      return client.GET("/mcp-aggregator/namespaces/{slug}", {
+        params: { path: { slug } }
+      });
+    });
+    emit(data, cmd.optsWithGlobals().json);
+  });
+  namespace.command("use <slug>").description("Wire an AI client's MCP config to this namespace's URL").option(
+    "--client <list>",
+    `comma-separated clients (${ALL_CLIENT_KEYS.join(", ")}) or 'all'`,
+    DEFAULT_CLIENT_KEY
+  ).option("--dry-run", "print what would be written without writing", false).action(async (slug, opts, cmd) => {
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const setup = await withSpinner(
+      "Fetching setup descriptors",
+      () => fetchSetup(cfg, slug)
+    );
+    const targets = clientTargets(process.cwd());
+    const keys = resolveClientKeys(opts.client);
+    const json = cmd.optsWithGlobals().json;
+    const result = [];
+    for (const key of keys) {
+      const target = targets[key];
+      const actions = await applyClient(cfg, setup, target, {
+        dryRun: Boolean(opts.dryRun),
+        mcp: true,
+        agentFiles: false,
+        personalWorkspaceId: null
+      });
+      result.push({ client: key, actions });
+      if (!json) printActions(target, actions);
+    }
+    if (json) {
+      emit({ namespace: slug, dryRun: Boolean(opts.dryRun), clients: result }, true);
+      return;
+    }
+    process.stdout.write(
+      opts.dryRun ? "\n(dry run \u2014 nothing written)\n" : `
+Wired to namespace '${slug}'. Restart your AI client (or reload MCP) to pick it up.
+`
+    );
+  });
+}
+
 // src/commands/onboard.ts
-import { existsSync as existsSync7 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { basename as basename3, join as join10 } from "path";
 
 // src/commands/fanout.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync6, readFileSync as readFileSync5, readdirSync, statSync } from "fs";
-import { isAbsolute, join as join6, resolve } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync6, readdirSync as readdirSync2, statSync as statSync3 } from "fs";
+import { isAbsolute, join as join9, resolve } from "path";
 var ICON = {
   refresh: "\u21BB",
   bind: "+",
@@ -3163,28 +3865,28 @@ function resolveChildDir(path, root) {
 function discoverChildren(root) {
   let names;
   try {
-    names = readdirSync(root);
+    names = readdirSync2(root);
   } catch {
     return [];
   }
   const out = [];
   for (const name of names.sort()) {
     if (name.startsWith(".") || name === "node_modules") continue;
-    const dir = join6(root, name);
+    const dir = join9(root, name);
     try {
-      if (!statSync(dir).isDirectory()) continue;
+      if (!statSync3(dir).isDirectory()) continue;
     } catch {
       continue;
     }
-    if (existsSync6(join6(dir, ".git")) || committedBindingPath(dir)) out.push(name);
+    if (existsSync7(join9(dir, ".git")) || committedBindingPath(dir)) out.push(name);
   }
   return out;
 }
 function readManifest(path) {
-  if (!existsSync6(path)) return null;
+  if (!existsSync7(path)) return null;
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync5(path, "utf8"));
+    parsed = JSON.parse(readFileSync6(path, "utf8"));
   } catch (err2) {
     throw new Error(`couldn't parse ${path}: ${err2 instanceof Error ? err2.message : String(err2)}`);
   }
@@ -3322,7 +4024,39 @@ async function warnIfProjectStray(client, projectId, workspaceId, json) {
     );
   }
 }
-async function pickWorkspace(client, promptLabel = "Bind this directory to a workspace:") {
+async function fetchPersonalWorkspaceId(client) {
+  try {
+    const { data } = await client.GET("/me/personal-workspace", {});
+    return data?.workspaceId ?? null;
+  } catch {
+    return null;
+  }
+}
+function nameTokens(s) {
+  return s.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 2);
+}
+function personalSubtreeIds(personalId, all) {
+  const childrenOf = /* @__PURE__ */ new Map();
+  for (const w of all) {
+    if (!w.parentId) continue;
+    (childrenOf.get(w.parentId) ?? childrenOf.set(w.parentId, []).get(w.parentId)).push(w);
+  }
+  const ids = /* @__PURE__ */ new Set([personalId]);
+  const queue = [personalId];
+  while (queue.length > 0) {
+    const id = queue.shift();
+    for (const child of childrenOf.get(id) ?? []) {
+      if (!ids.has(child.id)) {
+        ids.add(child.id);
+        queue.push(child.id);
+      }
+    }
+  }
+  return ids;
+}
+async function pickWorkspace(client, opts = {}) {
+  const promptLabel = opts.promptLabel ?? "Bind this directory to a workspace:";
+  const dirName = opts.dirName ?? basename3(process.cwd());
   const all = await withSpinner("Listing your workspaces", () => fetchWorkspaces(client));
   if (all.length === 0) {
     process.stderr.write(`no workspaces found \u2014 skipping workspace binding (you can set it later with \`sechroom config set --local workspaceId <id>\`)
@@ -3330,22 +4064,34 @@ async function pickWorkspace(client, promptLabel = "Bind this directory to a wor
     return void 0;
   }
   const byId = new Map(all.map((w) => [w.id, w]));
-  let pool = all;
-  if (all.length > 12) {
-    const q = (await promptText(`Filter ${all.length} workspaces (substring, Enter to list all)?`, "")).trim().toLowerCase();
+  const personalId = await fetchPersonalWorkspaceId(client);
+  const excluded = personalId ? personalSubtreeIds(personalId, all) : /* @__PURE__ */ new Set();
+  let candidates = all.filter((w) => !excluded.has(w.id));
+  if (candidates.length === 0) candidates = all;
+  const dirToks = new Set(nameTokens(dirName));
+  const isMatch = (w) => nameTokens(w.name).some((t) => dirToks.has(t));
+  const suggestions = candidates.filter(isMatch);
+  let pool = candidates;
+  if (candidates.length > 12 && suggestions.length === 0) {
+    const q = (await promptText(`Filter ${candidates.length} workspaces (substring, Enter to list all)?`, "")).trim().toLowerCase();
     if (q) {
-      const hits = all.filter((w) => `${w.name} ${workspacePath(w, byId)}`.toLowerCase().includes(q));
+      const hits = candidates.filter((w) => `${w.name} ${workspacePath(w, byId)}`.toLowerCase().includes(q));
       if (hits.length > 0) pool = hits;
       else process.stderr.write(`no match for "${q}" \u2014 listing all
 `);
     }
   }
   const SKIP = "__skip__";
+  const byPath = (a, b) => workspacePath(a, byId).localeCompare(workspacePath(b, byId));
+  const matched = pool.filter(isMatch).sort(byPath);
+  const rest = pool.filter((w) => !isMatch(w)).sort(byPath);
   const choices = [
-    ...pool.slice().sort((a, b) => workspacePath(a, byId).localeCompare(workspacePath(b, byId))).map((w) => ({ label: workspacePath(w, byId), value: w.id, hint: w.id })),
+    ...matched.map((w) => ({ label: workspacePath(w, byId), value: w.id, hint: style.dim(`matches "${dirName}"`) })),
+    ...rest.map((w) => ({ label: workspacePath(w, byId), value: w.id, hint: w.id })),
     { label: style.dim("skip \u2014 don't bind a workspace"), value: SKIP, hint: void 0 }
   ];
-  const chosen = await promptSelect(promptLabel, choices, SKIP);
+  const defaultValue = matched.length === 1 ? matched[0].id : SKIP;
+  const chosen = await promptSelect(promptLabel, choices, defaultValue);
   if (chosen === SKIP) return void 0;
   const picked = byId.get(chosen);
   const collisions = all.filter((w) => w.id !== picked.id && namesCollide(w.name, picked.name));
@@ -3372,7 +4118,7 @@ async function resolveWorkspaceBinding(client, existing, opts) {
   }
   if (existing) return existing;
   if (!canPrompt() || opts.yes) return void 0;
-  return pickWorkspace(client);
+  return pickWorkspace(client, { dirName: basename3(process.cwd()) });
 }
 async function ensureTenant(baseUrl, g, opts) {
   const persisted = readPersisted();
@@ -3488,7 +4234,7 @@ async function ensureTimezone(cfg, opts) {
   return { timezone: tz, action: "set" };
 }
 async function chooseClients(clientFlag, yes, cwd) {
-  if (clientFlag) return resolveClientKeys(clientFlag);
+  if (clientFlag && clientFlag.length > 0) return resolveClientKeys(clientFlag);
   const detected = detectInstalledClients(cwd);
   const preselected = detected.length > 0 ? detected : [DEFAULT_CLIENT_KEY];
   if (!canPrompt() || yes) return preselected;
@@ -3503,12 +4249,24 @@ async function chooseClients(clientFlag, yes, cwd) {
   );
   return picks.length > 0 ? picks : preselected;
 }
+async function chooseScope(scopeFlag, yes) {
+  if (scopeFlag != null) return resolveScope(scopeFlag);
+  if (!canPrompt() || yes) return "global";
+  return promptSelect(
+    "Install skills, agents, and hooks globally or just for this project?",
+    [
+      { label: "Globally", value: "global", hint: "~/.claude (or CLAUDE_CONFIG_DIR) \u2014 all projects" },
+      { label: "This project", value: "project", hint: "<repo>/.claude" }
+    ],
+    "global"
+  );
+}
 async function planRecurseChild(entry, root, client, opts) {
   const dir = resolveChildDir(entry.path, root);
-  if (!existsSync7(dir)) {
+  if (!existsSync8(dir)) {
     return { label: entry.path, dir, disposition: "skip-missing", argv: [], reason: "directory does not exist" };
   }
-  if (existsSync7(join7(dir, ".sechroom.json"))) {
+  if (existsSync8(join10(dir, ".sechroom.json"))) {
     return {
       label: entry.path,
       dir,
@@ -3535,7 +4293,10 @@ async function planRecurseChild(entry, root, client, opts) {
   process.stderr.write(`
 ${style.bold(entry.path)} ${style.dim("is not bound yet.")}
 `);
-  const ws = await pickWorkspace(client, `Bind ${style.cyan(entry.path)} to a workspace:`);
+  const ws = await pickWorkspace(client, {
+    promptLabel: `Bind ${style.cyan(entry.path)} to a workspace:`,
+    dirName: basename3(entry.path)
+  });
   if (!ws) {
     return { label: entry.path, dir, disposition: "skip-unbound", argv: [], reason: "unbound \u2014 no workspace chosen (skipped)" };
   }
@@ -3578,7 +4339,7 @@ This fan-out will pin the same lane in every repo:
 async function runRecurse(cfg, g, opts) {
   const { yes, dryRun, json } = opts;
   const root = process.cwd();
-  const manifestPath = join7(root, ".sechroom", "repos.json");
+  const manifestPath = join10(root, ".sechroom", "repos.json");
   const fromManifest = readManifest(manifestPath);
   const entries = fromManifest ?? discoverChildren(root).map((path) => ({ path }));
   const sourceLabel = fromManifest ? `manifest ${manifestPath}` : `auto-discovered under ${root}`;
@@ -3606,7 +4367,7 @@ async function runRecurse(cfg, g, opts) {
   summarizeFanout(results, { dryRun });
 }
 function registerOnboard(program2) {
-  program2.command("onboard").description("Guided first-run setup: configure, sign in, set timezone, detect clients, and wire this project").option("--recurse", "orchestration-root mode: onboard every child repo under this dir (auto-discovered, or from ./.sechroom/repos.json) \u2014 refreshes bound repos, prompts a workspace per new one", false).option("--lane <id>", "set the code-lane (substrate source identity) explicitly instead of inferring it; with --recurse it's used for every child repo").option("--design-lane <id>", "set the design-lane explicitly (substrate-authoring identity); with --recurse applies to every child").option("--client <list>", `comma-separated clients (${ALL_CLIENT_KEYS.join(", ")}) or 'all' (default: auto-detected)`).option("--local", "save the binding (tenant + base URL + workspace) to a committed .sechroom.json in this repo instead of the global config", false).option("--here", "with --local: write the binding at THIS directory even when a parent already carries one \u2014 binds a subtree (e.g. a monorepo's frontend/) to its own workspace", false).option("--workspace <id>", "bind this directory to a workspace (skips the interactive workspace pick)").option("--cli-only", "configure the CLI only \u2014 don't wire any AI client (no MCP config, no agent files)", false).option("--no-mcp", "skip the MCP server config (.mcp.json etc.); still write the agent instruction files").option("--copy", "make a personal copy of the agent instructions you can edit (default: prompt on a TTY, else skip)").option("--dry-run", "walk through without writing files or changing the profile", false).option("--refresh", "re-fetch descriptors and refresh any out-of-date managed blocks (local edits preserved to .proposed)", false).option("--force", "rewrite every managed block, overwriting local edits inside the markers (content outside untouched)", false).option("--check", "report whether anything would change and exit (0 = all current, 1 = stale/drift/absent); writes nothing", false).option("-y, --yes", "non-interactive: accept defaults (system timezone, detected clients, global config, full wire)", false).addHelpText(
+  program2.command("onboard").description("Guided first-run setup: configure, sign in, set timezone, detect clients, and wire this project").option("--recurse", "orchestration-root mode: onboard every child repo under this dir (auto-discovered, or from ./.sechroom/repos.json) \u2014 refreshes bound repos, prompts a workspace per new one", false).option("--lane <id>", "set the code-lane (substrate source identity) explicitly instead of inferring it; with --recurse it's used for every child repo").option("--design-lane <id>", "set the design-lane explicitly (substrate-authoring identity); with --recurse applies to every child").option("--client <list...>", `clients to wire \u2014 space- or comma-separated (${ALL_CLIENT_KEYS.join(", ")}) or 'all' (default: auto-detected)`).option("--scope <scope>", "install skills/agents/hooks 'global' (config dir / CLAUDE_CONFIG_DIR) or 'project' (<cwd>/.claude) \u2014 default: prompt, else global").option("--local", "save the binding (tenant + base URL + workspace) to a committed .sechroom.json in this repo instead of the global config", false).option("--here", "with --local: write the binding at THIS directory even when a parent already carries one \u2014 binds a subtree (e.g. a monorepo's frontend/) to its own workspace", false).option("--workspace <id>", "bind this directory to a workspace (skips the interactive workspace pick)").option("--cli-only", "configure the CLI only \u2014 don't wire any AI client (no MCP config, no agent files)", false).option("--no-mcp", "skip the MCP server config (.mcp.json etc.); still write the agent instruction files").option("--copy", "make a personal copy of the agent instructions you can edit (default: prompt on a TTY, else skip)").option("--dry-run", "walk through without writing files or changing the profile", false).option("--refresh", "re-fetch descriptors and refresh any out-of-date managed blocks (local edits preserved to .proposed)", false).option("--force", "rewrite every managed block, overwriting local edits inside the markers (content outside untouched)", false).option("--check", "report whether anything would change and exit (0 = all current, 1 = stale/drift/absent); writes nothing", false).option("-y, --yes", "non-interactive: accept defaults (system timezone, detected clients, global config, full wire)", false).addHelpText(
     "after",
     `
 Examples:
@@ -3649,6 +4410,13 @@ Examples:
       process.stderr.write(line);
     }
     const wire = await chooseWire(opts, yes);
+    const scope = await chooseScope(opts.scope, yes);
+    const claudeTargets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+    const codexHomes = resolveCodexHomes({ override: g.codexHome, scope });
+    if (scope === "project" && g.claudeConfigDir && !json) {
+      process.stderr.write(`${style.dim("(--claude-config-dir is ignored for --scope project \u2014 project files are repo-relative)")}
+`);
+    }
     if (wire === "cli-only") {
       if (json) {
         emit({ dryRun, baseUrl: cfg.baseUrl, tenant: cfg.tenant, workspaceId: cfg.workspaceId ?? null, timezone: tz, wire, clients: [] }, true);
@@ -3656,7 +4424,7 @@ Examples:
       }
       if (!dryRun) {
         await ensureLanePin(cfg, { yes, dryRun, clients: detectInstalledClients(process.cwd()) });
-        await maybeOfferHooks({ yes, dryRun, cwd: process.cwd() });
+        await maybeOfferHooks({ yes, dryRun, cwd: process.cwd(), scope, claudeConfigDir: g.claudeConfigDir, codexHome: g.codexHome });
       }
       process.stdout.write(
         `
@@ -3669,7 +4437,7 @@ Try: ${style.cyan('sechroom memory search "..."')}  or  ${style.cyan("sechroom -
     }
     const keys = await chooseClients(opts.client, yes, process.cwd());
     const setup = await withSpinner("Fetching setup descriptors", () => fetchSetup(cfg));
-    const targets = clientTargets(process.cwd());
+    const targets = clientTargets(process.cwd(), { claudeDir: claudeTargets[0]?.dir, codexHome: codexHomes[0] });
     const personalWorkspaceId = await getPersonalWorkspaceId(cfg);
     if (!dryRun && !check) {
       await maybeOfferCopies(cfg, setup, targets, keys, personalWorkspaceId, copyChoice(opts));
@@ -3713,10 +4481,12 @@ Try: ${style.cyan('sechroom memory search "..."')}  or  ${style.cyan("sechroom -
       await ensureLanePin(cfg, { yes, dryRun, clients: keys });
     }
     if (!json && !dryRun) {
-      await maybeOfferSkills(cfg, personalWorkspaceId, { yes, dryRun, surface: "claude-code" });
+      for (const t of claudeTargets) {
+        await maybeOfferSkills(cfg, personalWorkspaceId, { yes, dryRun, surface: "claude-code", configDir: t.dir });
+      }
     }
     if (!json && !dryRun) {
-      await maybeOfferHooks({ yes, dryRun, cwd: process.cwd() });
+      await maybeOfferHooks({ yes, dryRun, cwd: process.cwd(), scope, claudeConfigDir: g.claudeConfigDir, codexHome: g.codexHome });
     }
     if (json) {
       emit({ dryRun, baseUrl: cfg.baseUrl, tenant: cfg.tenant, workspaceId: cfg.workspaceId ?? null, timezone: tz, wire, eval: evalCounts, clients: result }, true);
@@ -3762,14 +4532,21 @@ async function chooseWire(opts, yes) {
   return opts.mcp === false ? "agent-only" : "full";
 }
 var FALLBACK_AGENT_PROMPT = "Resume my sechroom continuity, summarise what I was last working on, then suggest the next step.";
+function printNextStepBlock(heading, lines) {
+  const rule = style.dim("\u2500".repeat(52));
+  process.stdout.write(
+    `
+${rule}
+${style.bold(heading)}
+
+` + lines.map((l) => `  ${l}`).join("\n") + `
+${rule}
+`
+  );
+}
 async function printStarterPrompt(mode, cfg) {
   if (mode === "cli") {
-    process.stdout.write(
-      `
-${style.bold("Next:")} pick up where you left off \u2014
-  ${style.cyan("sechroom continuity resume-me")}
-`
-    );
+    printNextStepBlock("Next \u2014 pick up where you left off:", [style.cyan("sechroom continuity resume-me")]);
     return;
   }
   let primary = FALLBACK_AGENT_PROMPT;
@@ -3781,21 +4558,16 @@ ${style.bold("Next:")} pick up where you left off \u2014
     } catch {
     }
   }
-  process.stdout.write(
-    `
-${style.bold("Next:")} paste this into your AI agent to get going \u2014
-  ${style.cyan(`"${primary}"`)}
-`
-  );
+  printNextStepBlock("Next \u2014 paste this into your AI agent to get going:", [style.cyan(`"${primary}"`)]);
 }
 
 // src/commands/sweep.ts
-import { existsSync as existsSync8 } from "fs";
-import { dirname as dirname6, join as join8, resolve as resolve2 } from "path";
-var DEFAULT_MANIFEST = join8(".sechroom", "repos.json");
+import { existsSync as existsSync9 } from "fs";
+import { dirname as dirname7, join as join11, resolve as resolve2 } from "path";
+var DEFAULT_MANIFEST = join11(".sechroom", "repos.json");
 function planEntry(entry, root) {
   const dir = resolveChildDir(entry.path, root);
-  if (!existsSync8(dir)) {
+  if (!existsSync9(dir)) {
     return { label: entry.path, dir, disposition: "skip-missing", argv: [], reason: "directory does not exist" };
   }
   if (committedBindingPath(dir)) {
@@ -3871,7 +4643,7 @@ Examples:
 `);
       return;
     }
-    const root = dirname6(dirname6(manifestPath));
+    const root = dirname7(dirname7(manifestPath));
     const plans = repos.map((entry) => planEntry(entry, root));
     if (!json) {
       process.stderr.write(
@@ -3888,162 +4660,222 @@ Examples:
   });
 }
 
-// src/commands/skills.ts
-import { homedir as homedir6 } from "os";
-import { join as join9 } from "path";
-import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync6, rmSync as rmSync2, existsSync as existsSync9, readFileSync as readFileSync6 } from "fs";
-var DEFAULT_SLUG = "operator-skills";
-var ROLE_TAGS = ["sechroom:role:skill-template", "role:skill-template"];
-var LOCK = ".sechroom-skills.json";
-function skillsDir(global) {
-  return global ? join9(homedir6(), ".claude", "skills") : join9(process.cwd(), ".claude", "skills");
-}
-function tagValue2(tags, prefix) {
-  return (tags ?? []).find((t) => t.startsWith(prefix))?.slice(prefix.length);
-}
-function hasAny(tags, candidates) {
-  return (tags ?? []).some((t) => candidates.includes(t));
-}
-function registerSkills(program2) {
-  const skills = program2.command("skills").description("Install + manage operator skills from a bundle");
-  skills.addHelpText(
+// src/commands/lane.ts
+var LANE_KEYS = ["code-lane", "design-lane"];
+function showLane(json) {
+  const found = readSem();
+  if (!found) {
+    if (json) return emit({ path: null, values: {} }, true);
+    return console.log(
+      style.dim(`No ./.sechroom/lane.json pin in this checkout. Run 'sechroom lane set'.`)
+    );
+  }
+  const resolved = { ...found.values };
+  let suffixed = false;
+  for (const k of LANE_KEYS) {
+    const v = found.values[k];
+    if (!v) continue;
+    resolved[k] = applyWorktreeLaneSuffix(v);
+    if (resolved[k] !== v) suffixed = true;
+  }
+  if (json) return emit({ path: found.path, values: resolved, worktreeSuffixApplied: suffixed }, true);
+  console.log(style.dim(`from ${found.path}`));
+  Object.entries(resolved).forEach(([k, v]) => console.log("  " + style.bold(k) + " = " + v));
+  if (suffixed) console.log(style.dim("  (worktree -N suffix applied \u2014 non-primary git worktree)"));
+}
+function setLane(opts) {
+  if (!opts.codeLane && !opts.designLane) fail("Provide --code-lane and/or --design-lane.");
+  const target = localSemPath();
+  const values = readLocalSemValues();
+  if (opts.codeLane) values["code-lane"] = opts.codeLane;
+  if (opts.designLane) values["design-lane"] = opts.designLane;
+  writeSem(values, target);
+  if (opts.json) return emit({ path: target, values }, true);
+  console.log(style.green(`Wrote lane pin \u2192 ${target} ${style.dim("(git-ignored)")}`));
+  Object.entries(values).forEach(([k, v]) => console.log("  " + style.dim(k) + " = " + v));
+}
+function registerLane(program2) {
+  const lane = program2.command("lane").description("Show this checkout's continuity lane pin (worktree-aware -N suffix applied)").option("--json", "machine output").action((opts, cmd) => showLane(Boolean(opts.json) || Boolean(cmd.optsWithGlobals().json)));
+  lane.command("set").description("Write this checkout's lane pin to ./.sechroom/lane.json").option("--code-lane <id>", "code-surface lane id (e.g. claude-code-chris)").option("--design-lane <id>", "design / substrate-authoring lane id (e.g. claude-design-chris)").option("--json", "machine output").action(
+    (opts, cmd) => setLane({
+      codeLane: opts.codeLane,
+      designLane: opts.designLane,
+      json: Boolean(opts.json) || Boolean(cmd.optsWithGlobals().json)
+    })
+  );
+  lane.addHelpText(
     "after",
     `
 Examples:
-  $ sechroom skills install --code-lane claude-code-chris --design-lane claude-design-chris
-  $ sechroom skills install operator-skills --surface claude-code --local
-  $ sechroom skills list
-  $ sechroom skills set-lane --code-lane claude-code-chris --design-lane claude-design-chris
-  $ sechroom skills lane
-  $ sechroom skills clean`
+  $ sechroom lane                                              show the resolved lane(s)
+  $ sechroom lane set --code-lane claude-code-chris --design-lane claude-design-chris
+
+In a non-primary git worktree the ratified concurrent-session -N suffix is auto-applied (SBC-1094).
+(Aliases: 'sechroom skills lane' / 'skills set-lane' \u2014 kept for back-compat.)`
   );
-  skills.command("install [slug]").description(`Install a skills bundle (default ${DEFAULT_SLUG}) into your personal workspace + write SKILL.md files`).option("--version <v>", "bundle version (default: latest published in the catalogue)").option("--instance <name>", "install as a named, separate instance (install the same bundle more than once)").option("--code-lane <id>", "identity.code-lane binding (e.g. claude-code-chris)").option("--design-lane <id>", "identity.design-lane binding (e.g. claude-design-chris)").option("--surface <s>", "skill target surface to materialise", "claude-code").option("--local", "write to ./.claude/skills instead of ~/.claude/skills").option("--json", "machine output").action(async (slugArg, opts, cmd) => {
-    const slug = slugArg || DEFAULT_SLUG;
-    const client = await makeClient(resolveConfig(cmd.optsWithGlobals()));
-    const pw = await runApi("resolving personal workspace", () => client.GET("/me/personal-workspace", {}));
-    const personalWsId = pw?.id || pw?.workspaceId || pw?.personalWorkspaceId || pw?.item?.id;
-    if (!personalWsId) fail("Could not resolve your personal workspace.");
-    let version = opts.version;
-    if (!version) {
-      const cat = await runApi("reading the bundle catalogue", () => client.GET("/me/bundles", {}));
-      const item = (cat?.bundles ?? cat?.Bundles ?? []).find((b) => (b.slug ?? b.Slug) === slug);
-      if (!item) fail(`Bundle '${slug}' is not in your self-serve catalogue (must be UserInstallable + Published).`);
-      version = item.latestVersion ?? item.LatestVersion;
-      if (!version) fail(`Bundle '${slug}' has no installable (Published) version.`);
-    }
-    const installOptions = {};
-    if (opts.codeLane) installOptions["identity.code-lane"] = opts.codeLane;
-    if (opts.designLane) installOptions["identity.design-lane"] = opts.designLane;
-    const res = await runApi(
-      `installing ${slug}@${version}${opts.instance ? ` (${opts.instance})` : ""}`,
-      () => client.POST("/me/bundles/{slug}/versions/{version}/install", {
-        params: { path: { slug, version } },
-        // instance: null/absent = the default instance (reinstall updates in
-        // place); a name installs a separate instance.
-        body: { installOptions, instance: opts.instance ?? null }
-      })
+}
+
+// src/setup/materialise.ts
+import { existsSync as existsSync10, mkdirSync as mkdirSync8, rmSync as rmSync2, writeFileSync as writeFileSync8 } from "fs";
+import { join as join12 } from "path";
+var CLIENT_SURFACE = "claude-code";
+function writeSkills(dir, skills, surface) {
+  const written = [];
+  for (const s of skills) {
+    mkdirSync8(join12(dir, s.name), { recursive: true });
+    writeFileSync8(join12(dir, s.name, "SKILL.md"), s.body.endsWith("\n") ? s.body : s.body + "\n");
+    written.push(s.name);
+  }
+  if (written.length) recordMaterialisedSkills(dir, DEFAULT_SKILLS_SLUG, written, { surface });
+  return written;
+}
+function writeAgents(dir, agents, surface) {
+  if (agents.length) mkdirSync8(dir, { recursive: true });
+  const written = [];
+  for (const a of agents) {
+    const file = `${a.name}.md`;
+    writeFileSync8(join12(dir, file), a.body.endsWith("\n") ? a.body : a.body + "\n");
+    written.push(file);
+  }
+  if (written.length) recordMaterialisedSkills(dir, DEFAULT_SKILLS_SLUG, written, { surface });
+  return written;
+}
+var SKILL_SPEC = { kind: "skill", dir: skillsDir, resolve: resolveSkillSet, write: writeSkills };
+var AGENT_SPEC = { kind: "agent", dir: agentsDir, resolve: resolveAgentSet, write: writeAgents };
+function scopeOf(opts) {
+  return opts.local ? "project" : resolveScope(opts.scope);
+}
+async function runInstall(spec, cmd, opts) {
+  const g = cmd.optsWithGlobals();
+  let scope;
+  try {
+    scope = scopeOf(opts);
+  } catch (err2) {
+    return fail(err2.message);
+  }
+  const cfg = resolveConfig(g);
+  const dryRun = Boolean(opts.dryRun);
+  const json = Boolean(g.json || opts.json);
+  const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+  const personalWorkspaceId = await getPersonalWorkspaceId(cfg);
+  const rows = await fetchTemplateRows(cfg, personalWorkspaceId);
+  const items = spec.resolve(rows, CLIENT_SURFACE);
+  const results = targets.map((t) => {
+    const dir = spec.dir(t.dir);
+    const written = dryRun ? items.map((i) => i.name) : spec.write(dir, items, CLIENT_SURFACE);
+    return { dir, label: t.label, written };
+  });
+  if (json) return emit({ kind: spec.kind, dryRun, available: items.length, targets: results }, true);
+  if (items.length === 0) {
+    console.log(style.dim(`No ${spec.kind}s available to install \u2014 is the bundle installed for your account?`));
+    return;
+  }
+  for (const r of results) {
+    console.log(
+      `${dryRun ? "" : style.green("\u2713 ")}${dryRun ? "would write" : "wrote"} ${r.written.length} ${spec.kind}(s) ${style.dim("\u2192")} ${r.dir}`
     );
-    const status = String(res?.status ?? res?.Status ?? "");
-    if (status && status.toLowerCase() !== "completed") {
-      fail(`Install did not complete (status=${status}; ${res?.failureReason ?? res?.FailureReason ?? ""}).`);
-    }
-    const feed = await runApi(
-      "materialising skill files",
-      () => client.GET("/workspaces/{workspaceId}/memories/feed", {
-        // cascadeWorkspaces: skills land in an "Operator Skills" SUB-workspace of
-        // the personal workspace, so we recurse from the personal-ws root.
-        // includeText: the feed omits bodies by default; we need them for SKILL.md.
-        params: {
-          path: { workspaceId: personalWsId },
-          query: { limit: 200, cascadeWorkspaces: true, includeText: true }
-        }
-      })
+    if (dryRun) for (const i of items) console.log(`    ${i.name} ${style.dim(`[${i.source}]`)}`);
+  }
+}
+function runList(spec, cmd, opts) {
+  const g = cmd.optsWithGlobals();
+  let scope;
+  try {
+    scope = scopeOf(opts);
+  } catch (err2) {
+    return fail(err2.message);
+  }
+  const json = Boolean(g.json || opts.json);
+  const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+  const out = targets.map((t) => {
+    const dir = spec.dir(t.dir);
+    const lock = readSkillsLock(dir);
+    const entries = Object.entries(lock).flatMap(
+      ([slug, e]) => (e.skills ?? []).map((name) => ({ slug, name, present: existsSync10(join12(dir, name)) }))
     );
-    const rows = feed?.results ?? feed?.Results ?? [];
-    const dir = skillsDir(!opts.local);
-    const wantInstance = opts.instance || "default";
-    const written = [];
-    const bundleTagPrefix = `sechroom:bundle:${slug}@`;
-    for (const r of rows) {
-      const m = r.item ?? r;
-      const tags = m.tags ?? m.Tags ?? [];
-      if (!hasAny(tags, ROLE_TAGS)) continue;
-      if (tagValue2(tags, "target:") !== opts.surface) continue;
-      if (!tags.some((t) => t.startsWith(bundleTagPrefix))) continue;
-      if ((tagValue2(tags, "sechroom:skill-instance:") ?? "default") !== wantInstance) continue;
-      const name = tagValue2(tags, "skill:");
-      if (!name) continue;
-      const body = m.text ?? m.Text ?? "";
-      mkdirSync6(join9(dir, name), { recursive: true });
-      writeFileSync6(join9(dir, name, "SKILL.md"), body.endsWith("\n") ? body : body + "\n");
-      written.push(name);
-    }
-    mkdirSync6(dir, { recursive: true });
-    const lockPath = join9(dir, LOCK);
-    const lock = existsSync9(lockPath) ? JSON.parse(readFileSync6(lockPath, "utf8")) : {};
-    lock[slug] = { surface: opts.surface, version, instance: wantInstance, skills: written.sort() };
-    writeFileSync6(lockPath, JSON.stringify(lock, null, 2) + "\n");
-    if (opts.json) return emit({ slug, version, instance: wantInstance, surface: opts.surface, dir, installed: written }, true);
-    const instanceNote = opts.instance ? ` (${opts.instance})` : "";
-    console.log(style.green(`Installed ${slug}@${version}${instanceNote} \u2014 ${written.length} skill(s) \u2192 ${dir}`));
-    written.forEach((n) => console.log("  " + style.dim("\u2022") + " " + n));
-    if (written.length === 0) console.log(style.dim(`  (no '${opts.surface}' skill bodies found; check --surface)`));
-  });
-  skills.command("list").description("List your installed bundles (GET /me/bundle-installs)").option("--json", "machine output").action(async (opts, cmd) => {
-    const client = await makeClient(resolveConfig(cmd.optsWithGlobals()));
-    const data = await runApi("reading your installs", () => client.GET("/me/bundle-installs", {}));
-    if (opts.json) return emit(data, true);
-    const installs = data?.installs ?? data?.Installs ?? [];
-    if (installs.length === 0) return console.log(style.dim("No bundles installed."));
-    installs.forEach((i) => {
-      const inst = i.instance ?? i.Instance ?? "";
-      const tag = inst ? style.dim(` [${inst}]`) : "";
-      console.log(`  ${i.bundleSlug ?? i.BundleSlug}@${i.bundleVersion ?? i.BundleVersion ?? "?"}${tag}`);
-    });
+    return { dir, label: t.label, entries };
   });
-  skills.command("clean [slug]").description(`Remove materialised skill files written by install (default ${DEFAULT_SLUG})`).option("--local", "clean ./.claude/skills instead of ~/.claude/skills").option("--json", "machine output").action(async (slugArg, opts) => {
-    const slug = slugArg || DEFAULT_SLUG;
-    const dir = skillsDir(!opts.local);
-    const lockPath = join9(dir, LOCK);
-    if (!existsSync9(lockPath)) fail(`No skills lockfile at ${lockPath}; nothing to clean.`);
-    const lock = JSON.parse(readFileSync6(lockPath, "utf8"));
+  if (json) return emit({ kind: spec.kind, targets: out }, true);
+  let any = false;
+  for (const t of out) {
+    if (t.entries.length === 0) continue;
+    any = true;
+    console.log(style.bold(t.dir) + ":");
+    for (const e of t.entries) {
+      const flag = e.present ? "" : style.dim("(missing) ");
+      console.log(`  ${flag}${e.name} ${style.dim(`[${e.slug}]`)}`);
+    }
+  }
+  if (!any) console.log(style.dim(`No ${spec.kind}s materialised. Run \`sechroom ${spec.kind}s install\`.`));
+}
+function runClean(spec, cmd, opts, slugArg) {
+  const g = cmd.optsWithGlobals();
+  const slug = slugArg || DEFAULT_SKILLS_SLUG;
+  let scope;
+  try {
+    scope = scopeOf(opts);
+  } catch (err2) {
+    return fail(err2.message);
+  }
+  const json = Boolean(g.json || opts.json);
+  const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+  const cleaned = [];
+  const missing = [];
+  for (const t of targets) {
+    const dir = spec.dir(t.dir);
+    const lock = readSkillsLock(dir);
     const entry = lock[slug];
-    if (!entry) fail(`No installed record for '${slug}' in ${lockPath}.`);
+    if (!entry) {
+      missing.push(join12(dir, SKILLS_LOCK));
+      continue;
+    }
     const removed = [];
     for (const name of entry.skills) {
-      const skillPath = join9(dir, name);
-      if (existsSync9(skillPath)) {
-        rmSync2(skillPath, { recursive: true, force: true });
+      const p = join12(dir, name);
+      if (existsSync10(p)) {
+        rmSync2(p, { recursive: true, force: true });
         removed.push(name);
       }
     }
     delete lock[slug];
-    writeFileSync6(lockPath, JSON.stringify(lock, null, 2) + "\n");
-    if (opts.json) return emit({ slug, removed, dir }, true);
-    console.log(style.green(`Removed ${removed.length} skill(s) for ${slug} from ${dir}`));
-  });
-  skills.command("set-lane").description("Write this checkout's lane pin to a local ./.sechroom/lane.json file (read at runtime by skills)").option("--code-lane <id>", "code-surface lane id (e.g. claude-code-chris)").option("--design-lane <id>", "design / substrate-authoring lane id (e.g. claude-design-chris)").option("--json", "machine output").action((opts, cmd) => {
-    if (!opts.codeLane && !opts.designLane) fail("Provide --code-lane and/or --design-lane.");
-    const target = localSemPath();
-    const values = readLocalSemValues();
-    if (opts.codeLane) values["code-lane"] = opts.codeLane;
-    if (opts.designLane) values["design-lane"] = opts.designLane;
-    writeSem(values, target);
-    if (cmd.optsWithGlobals().json) return emit({ path: target, values }, true);
-    console.log(style.green(`Wrote lane pin \u2192 ${target} ${style.dim("(git-ignored)")}`));
-    Object.entries(values).forEach(([k, v]) => console.log("  " + style.dim(k) + " = " + v));
-  });
-  skills.command("lane").description("Show the lane pin resolved from ./.sechroom/lane.json (nearest in this checkout; legacy ./.sem honoured)").option("--json", "machine output").action((opts, cmd) => {
-    const json = cmd.optsWithGlobals().json;
-    const found = readSem();
-    if (!found) {
-      if (json) return emit({ path: null, values: {} }, true);
-      return console.log(style.dim(`No ./.sechroom/lane.json pin in this checkout. Run 'sechroom skills set-lane'.`));
-    }
-    if (json) return emit(found, true);
-    console.log(style.dim(`from ${found.path}`));
-    Object.entries(found.values).forEach(([k, v]) => console.log("  " + style.bold(k) + " = " + v));
-  });
+    writeSkillsLock(dir, lock);
+    cleaned.push({ dir, removed });
+  }
+  if (cleaned.length === 0) {
+    return fail(`No materialised ${spec.kind}s recorded for '${slug}' in ${missing.join(", ")}.`);
+  }
+  if (json) return emit({ kind: spec.kind, slug, cleaned, missing }, true);
+  for (const c of cleaned) {
+    console.log(style.green(`Removed ${c.removed.length} ${spec.kind}(s) for ${slug} from ${c.dir}`));
+  }
+}
+
+// src/commands/skills.ts
+function registerSkills(program2) {
+  const skills = program2.command("skills").description("Manage operator skills (install to disk, list, clean)");
+  skills.addHelpText(
+    "after",
+    `
+Examples:
+  $ sechroom skills install                 materialise your installed skills to ~/.claude/skills
+  $ sechroom skills install --scope project  write them to ./.claude/skills instead
+  $ sechroom skills list                     what's materialised on disk
+  $ sechroom skills clean                    remove the materialised skill files
+  $ sechroom skills set-lane --code-lane claude-code-chris --design-lane claude-design-chris
+
+`
+  );
+  skills.command("install").description("Materialise your installed skills to disk (the already-installed bundle \u2014 no server install)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--dry-run", "print what would be written; write nothing").option("--json", "machine output").action((opts, cmd) => runInstall(SKILL_SPEC, cmd, opts));
+  skills.command("list").description("List the skills materialised on disk (per resolved config dir)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((opts, cmd) => runList(SKILL_SPEC, cmd, opts));
+  skills.command("clean [slug]").description(`Remove skill files materialised to disk (default ${DEFAULT_SKILLS_SLUG})`).option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((slugArg, opts, cmd) => runClean(SKILL_SPEC, cmd, opts, slugArg));
+  skills.command("set-lane").description("Alias of `sechroom lane set` (kept for back-compat) \u2014 write this checkout's lane pin").option("--code-lane <id>", "code-surface lane id (e.g. claude-code-chris)").option("--design-lane <id>", "design / substrate-authoring lane id (e.g. claude-design-chris)").option("--json", "machine output").action(
+    (opts, cmd) => setLane({
+      codeLane: opts.codeLane,
+      designLane: opts.designLane,
+      json: Boolean(opts.json) || Boolean(cmd.optsWithGlobals().json)
+    })
+  );
+  skills.command("lane").description("Alias of `sechroom lane` (kept for back-compat) \u2014 show this checkout's lane pin").option("--json", "machine output").action((opts, cmd) => showLane(Boolean(opts.json) || Boolean(cmd.optsWithGlobals().json)));
   skills.command("set-workflow").description("Set your per-operator workflow defaults (server-side; follows you across tenants)").option("--default-code-lane <id>", "personal default code lane (e.g. claude-code-chris)").option("--default-design-lane <id>", "personal default design lane (e.g. claude-design-chris)").option("--handover-recipient <id>", "your daily-handover counterparty (e.g. andy)").option("--json", "machine output").action(async (opts, cmd) => {
     if (!opts.defaultCodeLane && !opts.defaultDesignLane && !opts.handoverRecipient)
       fail("Provide at least one of --default-code-lane / --default-design-lane / --handover-recipient.");
@@ -4106,23 +4938,46 @@ Examples:
   });
 }
 
+// src/commands/agents.ts
+function registerAgents(program2) {
+  const agents = program2.command("agents").description("Manage operator subagents (install to disk, list, clean)");
+  agents.addHelpText(
+    "after",
+    `
+Examples:
+  $ sechroom agents install                 materialise your installed agents to ~/.claude/agents
+  $ sechroom agents install --scope project  write them to ./.claude/agents instead
+  $ sechroom agents install --claude-config-dir ~/.claude-abcs   target another instance
+  $ sechroom agents list                     what's materialised on disk
+  $ sechroom agents clean                    remove the materialised agent files
+
+Agents are resolved from the agent target (target:claude-agent), the dispatchable
+workers your loop skills call (e.g. find-prior-art \u2192 substrate-miner).`
+  );
+  agents.command("install").description("Materialise your installed subagents to disk (the already-installed bundle \u2014 no server install)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--dry-run", "print what would be written; write nothing").option("--json", "machine output").action((opts, cmd) => runInstall(AGENT_SPEC, cmd, opts));
+  agents.command("list").description("List the subagents materialised on disk (per resolved config dir)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((opts, cmd) => runList(AGENT_SPEC, cmd, opts));
+  agents.command("clean [slug]").description(`Remove subagent files materialised to disk (default ${DEFAULT_SKILLS_SLUG})`).option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((slugArg, opts, cmd) => runClean(AGENT_SPEC, cmd, opts, slugArg));
+}
+
 // src/commands/reset.ts
-import { homedir as homedir7 } from "os";
-import { join as join10 } from "path";
-import { existsSync as existsSync10, readFileSync as readFileSync7, rmSync as rmSync3 } from "fs";
-var SKILLS_LOCK = ".sechroom-skills.json";
-var localSkillsDir = () => join10(process.cwd(), ".claude", "skills");
-var globalSkillsDir = () => join10(homedir7(), ".claude", "skills");
+import { homedir as homedir4 } from "os";
+import { join as join13 } from "path";
+import { existsSync as existsSync11, readFileSync as readFileSync7, rmSync as rmSync3 } from "fs";
+var SKILLS_LOCK2 = ".sechroom-skills.json";
+var localSkillsDir = () => join13(process.cwd(), ".claude", "skills");
+var globalSkillsDir = () => join13(homedir4(), ".claude", "skills");
+var localAgentsDir = () => join13(process.cwd(), ".claude", "agents");
+var globalAgentsDir = () => join13(homedir4(), ".claude", "agents");
 function removeMaterialisedSkills(dir) {
   const removed = [];
-  const lockPath = join10(dir, SKILLS_LOCK);
-  if (!existsSync10(lockPath)) return removed;
+  const lockPath = join13(dir, SKILLS_LOCK2);
+  if (!existsSync11(lockPath)) return removed;
   try {
     const lock = JSON.parse(readFileSync7(lockPath, "utf8"));
     for (const entry of Object.values(lock)) {
       for (const name of entry.skills ?? []) {
-        const p = join10(dir, name);
-        if (existsSync10(p)) {
+        const p = join13(dir, name);
+        if (existsSync11(p)) {
           rmSync3(p, { recursive: true, force: true });
           removed.push(p);
         }
@@ -4167,28 +5022,30 @@ function registerReset(program2) {
       }
     }
     const removed = [];
-    const stateDir = join10(process.cwd(), ".sechroom");
-    if (existsSync10(stateDir)) {
+    const stateDir = join13(process.cwd(), ".sechroom");
+    if (existsSync11(stateDir)) {
       rmSync3(stateDir, { recursive: true, force: true });
       removed.push(stateDir);
     }
-    const legacyCfg = join10(process.cwd(), ".sechroom.json");
-    if (existsSync10(legacyCfg)) {
+    const legacyCfg = join13(process.cwd(), ".sechroom.json");
+    if (existsSync11(legacyCfg)) {
       rmSync3(legacyCfg, { force: true });
       removed.push(legacyCfg);
     }
-    const legacySem = join10(process.cwd(), ".sem");
-    if (existsSync10(legacySem)) {
+    const legacySem = join13(process.cwd(), ".sem");
+    if (existsSync11(legacySem)) {
       rmSync3(legacySem, { force: true });
       removed.push(legacySem);
     }
     removed.push(...removeMaterialisedSkills(localSkillsDir()));
+    removed.push(...removeMaterialisedSkills(localAgentsDir()));
     if (global) {
       const tok = clearToken();
       if (tok) removed.push(tok);
       const cfg = clearPersisted();
       if (cfg) removed.push(cfg);
       removed.push(...removeMaterialisedSkills(globalSkillsDir()));
+      removed.push(...removeMaterialisedSkills(globalAgentsDir()));
     }
     if (json) return emit({ global, removed }, true);
     if (removed.length === 0) {
@@ -4213,7 +5070,7 @@ function resolveVersion() {
   }
 }
 var program = new Command();
-program.name("sechroom").description("Sechroom CLI \u2014 thin generated client over the Sechroom HTTP API. An agent/human surface alongside MCP.").version(resolveVersion()).option("--base-url <url>", "API base URL (overrides config / SECHROOM_BASE_URL)").option("--tenant <tenant>", "Tenant id (required by the API; overrides config / SECHROOM_TENANT)").option("--binding <name>", "Named workspace binding from .sechroom.json `workspaces` (overrides path auto-selection / SECHROOM_BINDING)").option("--json", "Emit compact JSON (for scripts and agents)", false);
+program.name("sechroom").description("Sechroom CLI \u2014 thin generated client over the Sechroom HTTP API. An agent/human surface alongside MCP.").version(resolveVersion()).option("--base-url <url>", "API base URL (overrides config / SECHROOM_BASE_URL)").option("--tenant <tenant>", "Tenant id (required by the API; overrides config / SECHROOM_TENANT)").option("--binding <name>", "Named workspace binding from .sechroom.json `workspaces` (overrides path auto-selection / SECHROOM_BINDING)").option("--claude-config-dir <dirs>", "Claude config dir(s), comma-separated (overrides CLAUDE_CONFIG_DIR / ~/.claude)").option("--codex-home <dir>", "Codex home (overrides CODEX_HOME / ~/.codex)").option("--json", "Emit compact JSON (for scripts and agents)", false);
 program.addHelpText(
   "after",
   `
@@ -4317,15 +5174,19 @@ registerWorkspace(program);
 registerProject(program);
 registerFiling(program);
 registerContinuity(program);
+registerCheckpoint(program);
 registerHook(program);
 registerId(program);
 registerAccount(program);
 registerChat(program);
 registerInit(program);
 registerSetup(program);
+registerNamespace(program);
 registerOnboard(program);
 registerSweep(program);
 registerSkills(program);
+registerAgents(program);
+registerLane(program);
 registerReset(program);
 program.parseAsync().catch((err2) => {
   process.stderr.write(`error: ${err2 instanceof Error ? err2.message : String(err2)}