@sechroom/cli 2026.6.36 → 2026.6.37

package/dist/index.js

@@ -1275,7 +1275,8 @@ Examples:
   $ sechroom workspace get wsp_XXXX --json
   $ sechroom workspace rename wsp_XXXX --name "Renamed"
   $ sechroom workspace move wsp_XXXX --parent wsp_YYYY
-  $ sechroom workspace feed wsp_XXXX --limit 20 --cascade`
+  $ sechroom workspace feed wsp_XXXX --limit 20 --cascade
+  $ sechroom workspace feed wsp_XXXX --tag kind:plan --since 2026-06-01T00:00:00Z --order UpdatedDesc`
   );
   workspace.command("create").description("Create a workspace (POST /workspaces)").requiredOption("--name <name>", "Workspace name").option("--description <description>", "Optional description").option("--parent <parentId>", "Parent workspace id (omit for a top-level workspace)").action(async (opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
@@ -1383,7 +1384,7 @@ Examples:
     });
     emitAction(`restored workspace ${style.bold(workspaceId)}`, data, cmd.optsWithGlobals().json);
   });
-  workspace.command("feed <workspaceId>").description("List a workspace's memory feed (GET /workspaces/{workspaceId}/memories/feed)").option("--limit <n>", "Max results", "20").option("--cursor <cursor>", "Paging cursor from a prior page").option("--cascade", "Cascade into descendant workspaces", false).option("--include-projects", "Include the workspace's projects", false).option("--include-archived", "Include archived memories", false).option("--query <query>", "Filter the feed by text").option("--tag <tag>", "Filter tags (comma-separated)").action(async (workspaceId, opts, cmd) => {
+  workspace.command("feed <workspaceId>").description("List a workspace's memory feed (GET /workspaces/{workspaceId}/memories/feed)").option("--limit <n>", "Max results", "20").option("--cursor <cursor>", "Paging cursor from a prior page").option("--cascade", "Cascade into descendant workspaces", false).option("--include-projects", "Include the workspace's projects", false).option("--include-archived", "Include archived memories", false).option("--query <query>", "Filter the feed by text").option("--tag <tag>", "Filter tags (comma-separated)").option("--since <iso>", "Only memories updated since this ISO-8601 timestamp (updatedSince)").option("--order <order>", "Order: UpdatedDesc | UpdatedAsc | CreatedDesc | CreatedAsc").action(async (workspaceId, opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
     const data = await runApi("Fetching feed", async () => {
       const client = await makeClient(cfg);
@@ -1397,7 +1398,12 @@ Examples:
             includeArchived: Boolean(opts.includeArchived),
             ...opts.cursor ? { cursor: opts.cursor } : {},
             ...opts.query ? { query: opts.query } : {},
-            ...opts.tag ? { filterTags: opts.tag } : {}
+            ...opts.tag ? { filterTags: opts.tag } : {},
+            ...opts.since ? { updatedSince: opts.since } : {},
+            // orderBy is WorkspaceFeedOrder (Updated*/Created*) post-FR-feed-005
+            // (the FeedOrder schema-name collision is fixed). opts.order is a raw
+            // commander string; cast to a valid member to satisfy the union.
+            ...opts.order ? { orderBy: opts.order } : {}
           }
         }
       });
@@ -1827,10 +1833,9 @@ import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as rea
 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 { dirname as dirname2, join as join2 } from "path";
 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";
 function localSemPath(cwd = process.cwd()) {
   return join2(cwd, SEM_FILE);
@@ -1840,8 +1845,6 @@ function resolveSemPathForRead(start = process.cwd()) {
   while (true) {
     const candidate = join2(dir, SEM_FILE);
     if (existsSync2(candidate)) return candidate;
-    const legacy = join2(dir, LEGACY_SEM_FILE);
-    if (existsSync2(legacy)) return legacy;
     const parent = dirname2(dir);
     if (parent === dir) return void 0;
     dir = parent;
@@ -1884,34 +1887,17 @@ function laneWithWorktreeSuffix(lane, gitFile, siblings) {
   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")) {
-    const line = raw.trim();
-    if (!line || line.startsWith("#")) continue;
-    const eq = line.indexOf("=");
-    if (eq === -1) continue;
-    const key = line.slice(0, eq).trim();
-    const value = line.slice(eq + 1).trim();
-    if (key) out[key] = value;
-  }
-  return out;
-}
 function serializeSem(values) {
   return JSON.stringify(values, null, 2) + "\n";
 }
 function readSem(path) {
   const p = path ?? resolveSemPathForRead();
   if (!p || !existsSync2(p)) return void 0;
-  const text = readFileSync2(p, "utf8");
-  const values = basename2(p) === LEGACY_SEM_FILE ? parseSem(text) : parseLaneJson(text);
-  return { path: p, values };
+  return { path: p, values: parseLaneJson(readFileSync2(p, "utf8")) };
 }
 function readLocalSemValues(cwd = process.cwd()) {
   const next = join2(cwd, SEM_FILE);
   if (existsSync2(next)) return readSem(next)?.values ?? {};
-  const legacy = join2(cwd, LEGACY_SEM_FILE);
-  if (existsSync2(legacy)) return readSem(legacy)?.values ?? {};
   return {};
 }
 function parseLaneJson(text) {
@@ -1931,8 +1917,34 @@ function writeSem(values, path = localSemPath()) {
   mkdirSync2(dirname2(path), { recursive: true });
   writeFileSync2(path, serializeSem(values));
   ensureSemIgnored(path);
+  ensureContinuityScaffold(path);
   return path;
 }
+var CONTINUITY_FILE_NAME = "continuity.json";
+var CONTINUITY_SCAFFOLD = JSON.stringify(
+  {
+    _readme: "Agent-maintained continuity intent. Keep these current during the session; `sechroom checkpoint` and the PreCompact hook snapshot from here. The five required fields (objective, state, lastAction, nextAction, resumeInstruction) must all be non-empty for a snapshot to be created.",
+    objective: "",
+    state: "",
+    lastAction: "",
+    nextAction: "",
+    resumeInstruction: "",
+    constraints: [],
+    questions: [],
+    artifacts: [],
+    confidence: null
+  },
+  null,
+  2
+) + "\n";
+function ensureContinuityScaffold(semPath) {
+  try {
+    const target = join2(dirname2(semPath), CONTINUITY_FILE_NAME);
+    if (existsSync2(target)) return;
+    writeFileSync2(target, CONTINUITY_SCAFFOLD);
+  } catch {
+  }
+}
 function ignoresSem(content) {
   return content.split("\n").some((line) => {
     const t = line.trim();
@@ -2201,10 +2213,22 @@ function clientTargets(cwd, opts = {}) {
       label: "Cursor",
       mcp: { surfaceKey: "claude-code", sectionType: SectionType.McpConfig, path: join4(cwd, ".cursor", "mcp.json"), format: "json" },
       instruction: { surfaceKey: "chatgpt", path: join4(cwd, "AGENTS.md") }
+    },
+    antigravity: {
+      key: "antigravity",
+      label: "Google Antigravity",
+      // FR-sechroom-247 — Antigravity reads MCP from a GLOBAL, home-relative
+      // `~/.gemini/config/mcp_config.json` (not cwd; not affected by
+      // CLAUDE_CONFIG_DIR / CODEX_HOME). The snippet — `serverUrl`-shaped, no
+      // `type` — comes from the `antigravity` server surface, so we don't
+      // hardcode it here. Instructions go in the project `AGENTS.md`
+      // (cross-tool, shared with Codex/Cursor).
+      mcp: { surfaceKey: "antigravity", sectionType: SectionType.McpConfig, path: join4(home, ".gemini", "config", "mcp_config.json"), format: "json" },
+      instruction: { surfaceKey: "antigravity", path: join4(cwd, "AGENTS.md") }
     }
   };
 }
-var ALL_CLIENT_KEYS = ["claude-code", "claude-desktop", "codex", "cursor"];
+var ALL_CLIENT_KEYS = ["claude-code", "claude-desktop", "codex", "cursor", "antigravity"];
 var DEFAULT_CLIENT_KEY = "claude-code";
 function detectInstalledClients(cwd) {
   const home = homedir3();
@@ -2213,6 +2237,7 @@ function detectInstalledClients(cwd) {
   if (existsSync3(dirname3(claudeDesktopConfigPath(home)))) detected.push("claude-desktop");
   if (resolveCodexHomes({}).some((d) => existsSync3(d))) detected.push("codex");
   if (existsSync3(join4(home, ".cursor")) || existsSync3(join4(cwd, ".cursor"))) detected.push("cursor");
+  if (existsSync3(join4(home, ".gemini"))) detected.push("antigravity");
   return detected;
 }
 
@@ -2541,15 +2566,17 @@ Examples:
   $ sechroom hook install --surface codex        Codex only
   $ sechroom hook install --local --dry-run      preview the project .claude/settings.json
 
-Lane source (high -> low): --lane  >  SECHROOM_LANE  >  ./.sem code-lane (D-binding-5).
+Lane source (high -> low): --lane  >  SECHROOM_LANE  >  ./.sechroom/lane.json code-lane (D-binding-5).
 Fail-soft: no lane / no auth / no-or-partial intent file / API error -> exit 0, never blocks.`
   );
-  hook.command("session-start").description("Resume the checkout's lane and emit continuity context for a SessionStart hook").option("--lane <laneId>", "Override the resolved lane (else SECHROOM_LANE, else ./.sem code-lane)").option("--surface <surface>", "Target surface: claude | codex (output is identical for session-start)", "claude").option("--max-artifacts <n>", "Cap artifacts in the resume bundle").action(async (opts, cmd) => {
+  hook.command("session-start").description("Resume the checkout's lane and emit continuity context for a SessionStart hook").option("--lane <laneId>", "Override the resolved lane (else SECHROOM_LANE, else ./.sechroom/lane.json code-lane)").option("--surface <surface>", "Target surface: claude | codex (output is identical for session-start)", "claude").option("--max-artifacts <n>", "Cap artifacts in the resume bundle").action(async (opts, cmd) => {
     try {
       const raw = await readStdin();
       const input = parseHookInput(raw);
       const lane = resolveLane(opts.lane, input.cwd);
       if (!lane) return process.exit(0);
+      const semPath = resolveSemPathForRead(input.cwd ?? process.cwd());
+      if (semPath) ensureContinuityScaffold(semPath);
       const cfg = resolveConfig(cmd.optsWithGlobals());
       const client = await makeClient(cfg);
       const { data } = await client.POST("/continuity/resume/lane", {
@@ -2568,7 +2595,7 @@ Fail-soft: no lane / no auth / no-or-partial intent file / API error -> exit 0,
       return process.exit(0);
     }
   });
-  hook.command("pre-compact").description("Save a continuity snapshot from the agent-maintained intent file on a PreCompact 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 'compaction')").option("--surface <surface>", "Target surface: claude | codex (lifecycle-only on both)", "claude").action(async (opts, cmd) => {
+  hook.command("pre-compact").description("Save a continuity snapshot from the agent-maintained intent file on a PreCompact hook").option("--lane <laneId>", "Override the resolved lane (else SECHROOM_LANE, else ./.sechroom/lane.json code-lane)").option("--scope <scope>", "Snapshot scope (else the intent file's `scope`, else 'compaction')").option("--surface <surface>", "Target surface: claude | codex (lifecycle-only on both)", "claude").action(async (opts, cmd) => {
     try {
       const raw = await readStdin();
       const input = parseHookInput(raw);
@@ -2579,7 +2606,7 @@ Fail-soft: no lane / no auth / no-or-partial intent file / API error -> exit 0,
       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(
+  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 ./.sechroom/lane.json 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) => {
@@ -2656,12 +2683,12 @@ Fail-soft: no lane / no auth / no-or-partial intent file / API error -> exit 0,
 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(
+  ).option("--lane <laneId>", "Lane id (else SECHROOM_LANE, else ./.sechroom/lane.json 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.
+written/normalized with the returned snapshotId. Lane: --lane > SECHROOM_LANE > ./.sechroom/lane.json code-lane.
 
 Examples:
   $ sechroom checkpoint                          snapshot from ./.sechroom/continuity.json, then sync it
@@ -2689,7 +2716,7 @@ Examples:
     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`."
+        "no lane resolved \u2014 pass --lane, set SECHROOM_LANE, or pin one in ./.sechroom/lane.json (code-lane). See `sechroom lane`."
       );
     }
     const required = [
@@ -2815,7 +2842,7 @@ Examples:
     });
     emitAction("updated profile", data, cmd.optsWithGlobals().json);
   });
-  account.command("feed").description("Your recent memory feed (GET /me/memories/feed)").option("--limit <n>", "Max results", "20").option("--cursor <cursor>", "Opaque paging cursor").option("--query <query>", "Free-text filter").option("--filter-tags <tags>", "Comma-separated tag filter").option("--include-archived", "Include archived memories", false).option("--include-text", "Include memory body text", false).action(async (opts, cmd) => {
+  account.command("feed").description("Your recent memory feed (GET /me/memories/feed)").option("--limit <n>", "Max results", "20").option("--cursor <cursor>", "Opaque paging cursor").option("--query <query>", "Free-text filter").option("--filter-tags <tags>", "Comma-separated tag filter").option("--include-archived", "Include archived memories", false).option("--include-text", "Include memory body text", false).option("--since <iso>", "Only contributions updated since this ISO-8601 timestamp (updatedSince)").option("--order <order>", "Order: LastTouchedDesc | LastTouchedAsc | FirstTouchedDesc | FirstTouchedAsc").action(async (opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
     const data = await runApi("Fetching feed", async () => {
       const client = await makeClient(cfg);
@@ -2827,7 +2854,9 @@ Examples:
             includeText: Boolean(opts.includeText),
             ...opts.cursor ? { cursor: opts.cursor } : {},
             ...opts.query ? { query: opts.query } : {},
-            ...opts.filterTags ? { filterTags: opts.filterTags } : {}
+            ...opts.filterTags ? { filterTags: opts.filterTags } : {},
+            ...opts.since ? { updatedSince: opts.since } : {},
+            ...opts.order ? { orderBy: opts.order } : {}
           }
         }
       });
@@ -3314,6 +3343,8 @@ 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:";
+var REFERENCE_ROLE_TAG = "sechroom:role:skill-reference";
+var REFERENCE_NAME_PREFIX = "component:";
 function tagsOf(row) {
   const m = row?.item ?? row;
   return m?.tags ?? m?.Tags ?? [];
@@ -3350,6 +3381,9 @@ function resolveSkills(systemRows, personalRows, surface) {
 function resolveAgents(systemRows, personalRows, surface) {
   return resolveByRole(systemRows, personalRows, surface, AGENT_ROLE_TAG, AGENT_NAME_PREFIX);
 }
+function resolveReferences(systemRows, personalRows, surface) {
+  return resolveByRole(systemRows, personalRows, surface, REFERENCE_ROLE_TAG, REFERENCE_NAME_PREFIX);
+}
 
 // src/setup/skill-resolution-io.ts
 var AGENT_TARGET = { "claude-code": "claude-agent" };
@@ -3385,6 +3419,9 @@ function resolveSkillSet(rows, surface) {
 function resolveAgentSet(rows, surface) {
   return resolveAgents(rows.systemRows, rows.personalRows, agentTargetFor(surface));
 }
+function resolveReferenceSet(rows, surface) {
+  return resolveReferences(rows.systemRows, rows.personalRows, surface);
+}
 
 // src/setup/skills-lock.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
@@ -3594,7 +3631,7 @@ function registerInit(program2) {
     `
 Examples:
   $ sechroom init                       Claude Code (default): ./.mcp.json + ./CLAUDE.md
-  $ sechroom init --client all          claude-code, claude-desktop, codex, cursor
+  $ sechroom init --client all          claude-code, claude-desktop, codex, cursor, antigravity
   $ 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`
@@ -3847,7 +3884,7 @@ Wired to namespace '${slug}'. Restart your AI client (or reload MCP) to pick it
 
 // src/commands/onboard.ts
 import { existsSync as existsSync8 } from "fs";
-import { basename as basename3, join as join10 } from "path";
+import { basename as basename2, join as join10 } from "path";
 
 // src/commands/fanout.ts
 import { spawnSync } from "child_process";
@@ -4056,7 +4093,7 @@ function personalSubtreeIds(personalId, all) {
 }
 async function pickWorkspace(client, opts = {}) {
   const promptLabel = opts.promptLabel ?? "Bind this directory to a workspace:";
-  const dirName = opts.dirName ?? basename3(process.cwd());
+  const dirName = opts.dirName ?? basename2(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>\`)
@@ -4118,7 +4155,7 @@ async function resolveWorkspaceBinding(client, existing, opts) {
   }
   if (existing) return existing;
   if (!canPrompt() || opts.yes) return void 0;
-  return pickWorkspace(client, { dirName: basename3(process.cwd()) });
+  return pickWorkspace(client, { dirName: basename2(process.cwd()) });
 }
 async function ensureTenant(baseUrl, g, opts) {
   const persisted = readPersisted();
@@ -4295,7 +4332,7 @@ ${style.bold(entry.path)} ${style.dim("is not bound yet.")}
 `);
   const ws = await pickWorkspace(client, {
     promptLabel: `Bind ${style.cyan(entry.path)} to a workspace:`,
-    dirName: basename3(entry.path)
+    dirName: basename2(entry.path)
   });
   if (!ws) {
     return { label: entry.path, dir, disposition: "skip-unbound", argv: [], reason: "unbound \u2014 no workspace chosen (skipped)" };
@@ -4740,6 +4777,17 @@ function writeAgents(dir, agents, surface) {
   if (written.length) recordMaterialisedSkills(dir, DEFAULT_SKILLS_SLUG, written, { surface });
   return written;
 }
+function writeReferencesIntoSkillDirs(dir, skills, refs) {
+  if (!refs.length || !skills.length) return [];
+  for (const s of skills) {
+    const refDir = join12(dir, s.name, "references");
+    mkdirSync8(refDir, { recursive: true });
+    for (const r of refs) {
+      writeFileSync8(join12(refDir, `${r.name}.md`), r.body.endsWith("\n") ? r.body : r.body + "\n");
+    }
+  }
+  return refs.map((r) => r.name);
+}
 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) {
@@ -4760,12 +4808,14 @@ async function runInstall(spec, cmd, opts) {
   const personalWorkspaceId = await getPersonalWorkspaceId(cfg);
   const rows = await fetchTemplateRows(cfg, personalWorkspaceId);
   const items = spec.resolve(rows, CLIENT_SURFACE);
+  const refs = spec.kind === "skill" ? resolveReferenceSet(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 };
+    const refsWritten = dryRun ? refs.map((r) => r.name) : writeReferencesIntoSkillDirs(dir, items, refs);
+    return { dir, label: t.label, written, refsWritten };
   });
-  if (json) return emit({ kind: spec.kind, dryRun, available: items.length, targets: results }, true);
+  if (json) return emit({ kind: spec.kind, dryRun, available: items.length, references: refs.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;
@@ -4774,6 +4824,10 @@ async function runInstall(spec, cmd, opts) {
     console.log(
       `${dryRun ? "" : style.green("\u2713 ")}${dryRun ? "would write" : "wrote"} ${r.written.length} ${spec.kind}(s) ${style.dim("\u2192")} ${r.dir}`
     );
+    if (r.refsWritten.length)
+      console.log(
+        `${dryRun ? "" : style.green("\u2713 ")}${dryRun ? "would write" : "wrote"} ${r.refsWritten.length} reference(s) into each skill ${style.dim("\u2192")} ${r.dir}/<skill>/references`
+      );
     if (dryRun) for (const i of items) console.log(`    ${i.name} ${style.dim(`[${i.source}]`)}`);
   }
 }
@@ -4910,7 +4964,7 @@ Examples:
     console.log("  " + style.bold("default-design-lane") + " = " + (data?.defaultDesignLane ?? style.dim("(unset)")));
     console.log("  " + style.bold("handover-recipient") + "  = " + (data?.handoverRecipient ?? style.dim("(unset)")));
   });
-  skills.command("resolve").description("Resolve the effective ${identity.*} slot values (per-location .sem + per-operator workflow prefs)").option("--json", "machine output (a flat slot->value map + per-slot source)").action(async (opts, cmd) => {
+  skills.command("resolve").description("Resolve the effective ${identity.*} slot values (per-location .sechroom/lane.json + per-operator workflow prefs)").option("--json", "machine output (a flat slot->value map + per-slot source)").action(async (opts, cmd) => {
     const local = readSem()?.values ?? {};
     let operator = {};
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sechroom/cli",
-  "version": "2026.6.36",
+  "version": "2026.6.37",
   "description": "Sechroom CLI — a thin, generated client over the Sechroom HTTP API. An agent/human surface alongside MCP.",
   "type": "module",
   "license": "UNLICENSED",