heyspex 0.2.2 → 0.2.3

package/dist/cli/hs-index-rebuild.mjs

@@ -161,9 +161,9 @@ function parseCredentialsStore(raw) {
     accounts
   };
 }
-function readTextOrNull(read, path15) {
+function readTextOrNull(read, path16) {
   try {
-    const raw = read(path15);
+    const raw = read(path16);
     return typeof raw === "string" ? raw : null;
   } catch {
     return null;
@@ -215,14 +215,14 @@ var init_session_owner = __esm({
 });
 
 // vendor/heyspex-mcp/vault-less-endpoints.mjs
-function pathnameOf(path15) {
-  const raw = String(path15 ?? "").split("?")[0].split("#")[0];
+function pathnameOf(path16) {
+  const raw = String(path16 ?? "").split("?")[0].split("#")[0];
   const noTrailing = raw.length > 1 ? raw.replace(/\/+$/, "") : raw;
   return noTrailing || "/";
 }
-function isVaultLessEndpoint(method, path15) {
+function isVaultLessEndpoint(method, path16) {
   const m = String(method || "GET").toUpperCase();
-  const pathname = pathnameOf(path15);
+  const pathname = pathnameOf(path16);
   return VAULT_LESS_ENDPOINTS.some((row) => {
     const [rowMethod, rowPath] = row.split(" ");
     return rowPath === pathname && (rowMethod === "*" || rowMethod === m);
@@ -245,7 +245,9 @@ var init_vault_less_endpoints = __esm({
 });
 
 // scripts/lib/shared-path-helpers.mjs
+import { realpathSync } from "node:fs";
 import { isAbsolute, resolve as resolve2, sep } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 var init_shared_path_helpers = __esm({
   "scripts/lib/shared-path-helpers.mjs"() {
     "use strict";
@@ -270,20 +272,52 @@ var init_write_outbox = __esm({
   }
 });
 
+// vendor/heyspex-mcp/usable-dir-env.mjs
+import { statSync } from "node:fs";
+import { isAbsolute as isAbsolute3 } from "node:path";
+var init_usable_dir_env = __esm({
+  "vendor/heyspex-mcp/usable-dir-env.mjs"() {
+    "use strict";
+  }
+});
+
+// vendor/heyspex-mcp/vault-binding.mjs
+import {
+  copyFileSync,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync4,
+  realpathSync as realpathSync2,
+  renameSync as renameSync3,
+  statSync as statSync2,
+  unlinkSync,
+  writeFileSync as writeFileSync3
+} from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import path from "node:path";
+var init_vault_binding = __esm({
+  "vendor/heyspex-mcp/vault-binding.mjs"() {
+    "use strict";
+  }
+});
+
 // vendor/heyspex-mcp/vault-resolve.mjs
-import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
-import { homedir as homedir4, tmpdir } from "node:os";
-import { dirname as dirname3, join as join5, resolve as resolve3 } from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync5, realpathSync as realpathSync3, statSync as statSync3 } from "node:fs";
+import { homedir as homedir5, tmpdir } from "node:os";
+import { basename as basename2, dirname as dirname3, join as join5, resolve as resolve3 } from "node:path";
 var init_vault_resolve = __esm({
   "vendor/heyspex-mcp/vault-resolve.mjs"() {
     "use strict";
     init_heyspex_home();
+    init_usable_dir_env();
+    init_vault_binding();
+    init_vault_binding();
   }
 });
 
 // vendor/heyspex-mcp/console-fetch.mjs
-import { readFileSync as readFileSync5 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
+import { readFileSync as readFileSync6 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
 import { join as join6 } from "node:path";
 function isCloudVaultId(value) {
   return typeof value === "string" && CLOUD_VAULT_ID_RE.test(value.trim());
@@ -305,13 +339,13 @@ var init_console_fetch = __esm({
 });
 
 // spex-console/src/lib/heyspex-home.ts
-import { homedir as homedir6 } from "node:os";
+import { homedir as homedir7 } from "node:os";
 function heyspexHome2(env = process.env) {
   const override = env?.HEYSPEX_HOME;
   if (typeof override === "string" && override.trim().length > 0) {
     return override.trim();
   }
-  return homedir6();
+  return homedir7();
 }
 var init_heyspex_home2 = __esm({
   "spex-console/src/lib/heyspex-home.ts"() {
@@ -339,7 +373,7 @@ var init_types = __esm({
 });
 
 // spex-console/src/lib/vault-registry/registry-file.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync6, renameSync as renameSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync7, renameSync as renameSync4, writeFileSync as writeFileSync4 } from "node:fs";
 import { dirname as dirname4, join as join7, resolve as resolve4 } from "node:path";
 function vaultRegistryDir(opts = {}) {
   return opts.registryDir ?? join7(heyspexHome2(), ".heyspex");
@@ -446,9 +480,9 @@ function parseVaultRegistryFile(json) {
 }
 function readRegistryJson(opts) {
   const filePath = vaultRegistryFilePath(opts);
-  if (!existsSync4(filePath)) return { kind: "missing" };
+  if (!existsSync5(filePath)) return { kind: "missing" };
   try {
-    const raw = readFileSync6(filePath, "utf8");
+    const raw = readFileSync7(filePath, "utf8");
     const json = JSON.parse(raw);
     if (registryFileSchemaOf(json) === null) return { kind: "unreadable" };
     return { kind: "ok", raw, json };
@@ -484,8 +518,8 @@ var init_registry_file = __esm({
 });
 
 // scripts/lib/dev-mode.mjs
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
-import { homedir as homedir7 } from "node:os";
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "node:fs";
+import { homedir as homedir8 } from "node:os";
 import { join as join8 } from "node:path";
 function devModeFilePath(homeDir = heyspexHome()) {
   return join8(homeDir, ".heyspex", DEV_MODE_FILENAME);
@@ -540,6 +574,11 @@ function readLocalDevModeRecord({ homeDir = heyspexHome(), readFile = defaultRea
     return { record: null, parseError: `unparseable dev-mode.json: ${String(err?.message ?? err)}` };
   }
 }
+function overrideCloudCheck(source, cloudKnown, staleAgainstCloud) {
+  if (source !== "local-override") return "not-applicable";
+  if (!cloudKnown) return "unverified";
+  return staleAgainstCloud ? "stale" : "in-sync";
+}
 function resolveDevMode({
   env = process.env,
   homeDir = heyspexHome(),
@@ -579,6 +618,7 @@ function resolveDevMode({
   const semantics = deriveSemantics(mode, reliance);
   const consoleUrl = source === "local-override" && local.record?.console_url ? local.record.console_url.replace(/\/+$/, "") : semantics.consoleUrl;
   const staleAgainstCloud = source === "local-override" && cloudValue !== null && (cloudValue.mode !== mode || mode === "dev" && cloudValue.reliance !== semantics.reliance);
+  const cloudCheck = overrideCloudCheck(source, cloudKnown, staleAgainstCloud);
   return {
     mode,
     reliance: semantics.reliance,
@@ -596,7 +636,8 @@ function resolveDevMode({
       present: local.record !== null,
       record: local.record,
       parseError: local.parseError,
-      staleAgainstCloud
+      staleAgainstCloud,
+      cloudCheck
     },
     cloudSetting: { known: cloudKnown, value: cloudValue }
   };
@@ -610,13 +651,13 @@ var init_dev_mode = __esm({
     CLOUD_CONSOLE_URL = "https://app.heyspex.com";
     LOCAL_CONSOLE_URL = "http://localhost:3000";
     DEV_MODE_FILENAME = "dev-mode.json";
-    defaultReadFile = (p) => readFileSync7(p, "utf8");
+    defaultReadFile = (p) => readFileSync8(p, "utf8");
   }
 });
 
 // scripts/lib/console-url-resolver.mjs
-import { readFileSync as readFileSync8 } from "node:fs";
-import { homedir as homedir8 } from "node:os";
+import { readFileSync as readFileSync9 } from "node:fs";
+import { homedir as homedir9 } from "node:os";
 import { join as join9 } from "node:path";
 function trimTrailingSlash(url) {
   return url.replace(/\/+$/, "");
@@ -651,7 +692,7 @@ function readCredentialsConsoleUrl({ homeDir = heyspexHome(), readFile = default
   }
 }
 function defaultReadFile2(p) {
-  return readFileSync8(p, "utf8");
+  return readFileSync9(p, "utf8");
 }
 function readDiscoveryFileConsoleUrl(repoRoot, { readDiscovery: readDiscovery2 = defaultReadFile2 } = {}) {
   if (!repoRoot) return null;
@@ -726,9 +767,9 @@ var init_console_url_resolver = __esm({
 });
 
 // spex-console/src/lib/vault-registry/repo-identity.ts
-import path2 from "node:path";
+import path3 from "node:path";
 function normalizeRepoRoot(p) {
-  let resolved = path2.resolve(p);
+  let resolved = path3.resolve(p);
   while (resolved.length > 1 && (resolved.endsWith("/") || resolved.endsWith("\\"))) {
     resolved = resolved.slice(0, -1);
   }
@@ -737,8 +778,8 @@ function normalizeRepoRoot(p) {
 function repoRootCandidates(p) {
   const norm = normalizeRepoRoot(p);
   const candidates = [norm];
-  if (path2.basename(norm) === "specs") {
-    const parent = path2.dirname(norm);
+  if (path3.basename(norm) === "specs") {
+    const parent = path3.dirname(norm);
     if (parent !== norm) candidates.push(parent);
   }
   return candidates;
@@ -763,22 +804,22 @@ var init_default_workspace = __esm({
 });
 
 // spex-console/src/lib/cli/vault-workspace-shared.ts
-import { readFileSync as readFileSync9 } from "node:fs";
+import { readFileSync as readFileSync10 } from "node:fs";
 function resolveConfiguredAccountId(opts = {}) {
   return resolveSessionOwnerUncached({
     env: opts.env ?? process.env,
     homeDir: opts.homeDir ?? heyspexHome2(),
-    readFile: opts.readFile ?? ((p) => readFileSync9(p, "utf-8"))
+    readFile: opts.readFile ?? ((p) => readFileSync10(p, "utf-8"))
   });
 }
 function resolveCloudAccountIdOrRefuse(opts = {}) {
   const accountId = resolveConfiguredAccountId(opts);
   return accountId ? { ok: true, accountId } : { ok: false, message: CLOUD_ACCOUNT_ID_REQUIRED_MESSAGE };
 }
-async function cloudHttpRequest(http, method, path15, body) {
-  const scopeHeaders = http.scope ? http.scope.headersFor(method, path15) : {};
+async function cloudHttpRequest(http, method, path16, body) {
+  const scopeHeaders = http.scope ? http.scope.headersFor(method, path16) : {};
   try {
-    const res = await http.fetchImpl(`${http.consoleUrl}${path15}`, {
+    const res = await http.fetchImpl(`${http.consoleUrl}${path16}`, {
       method,
       headers: {
         "content-type": "application/json",
@@ -1589,13 +1630,13 @@ function bareFileKeyOf(input) {
   if (KNOWN_TYPE_LABELS.has(token)) return null;
   return FILE_KEY_RE.test(token) ? token : null;
 }
-function isEra3SpecId(id, basename2) {
+function isEra3SpecId(id, basename3) {
   const raw = String(id ?? "").trim();
   if (!raw) return false;
   if (parseSpecId(raw)?.era === 3) return true;
   const fileKey = bareFileKeyOf(raw);
   if (!fileKey) return false;
-  const parsed = parseSpecId(basename2 ?? "");
+  const parsed = parseSpecId(basename3 ?? "");
   return parsed?.era === 3 && (parsed.fileKey ?? "").toUpperCase() === fileKey;
 }
 var FILE_KEY_RE, KNOWN_TYPE_LABELS, RULED_FAMILY_SURNAMES, FAMILY_KEYED_TYPE_LABELS, FAMILY_KEY_SHAPE_RE;
@@ -1669,7 +1710,7 @@ var init_vault_shared = __esm({
 // spex-console/src/lib/indexer/parser.ts
 import { createHash } from "node:crypto";
 import { promises as fs2 } from "node:fs";
-import path4 from "node:path";
+import path5 from "node:path";
 function normalizeWikilink2(raw) {
   let t = raw.trim();
   if (t.startsWith("[[") && t.endsWith("]]")) {
@@ -4568,9 +4609,9 @@ var init_satellite = __esm({
 });
 
 // spex-console/src/lib/vault-resolve/index.ts
-import { existsSync as existsSync5, readFileSync as readFileSync11 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync12, realpathSync as realpathSync4, statSync as statSync4 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import path5 from "node:path";
+import path6 from "node:path";
 var init_vault_resolve2 = __esm({
   "spex-console/src/lib/vault-resolve/index.ts"() {
     "use strict";
@@ -4607,8 +4648,8 @@ var init_resolve_status = __esm({
 });
 
 // spex-console/src/lib/vault-resolve/active.ts
-import { existsSync as existsSync6 } from "node:fs";
-import path6 from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import path7 from "node:path";
 var ACTIVE_VAULT_CACHE_KEY, cacheStore;
 var init_active = __esm({
   "spex-console/src/lib/vault-resolve/active.ts"() {
@@ -4630,7 +4671,7 @@ var init_active = __esm({
 
 // spex-console/src/lib/control-plane/statusline-focus-cache.ts
 import fs3 from "node:fs";
-import path7 from "node:path";
+import path8 from "node:path";
 var init_statusline_focus_cache = __esm({
   "spex-console/src/lib/control-plane/statusline-focus-cache.ts"() {
     "use strict";
@@ -5247,10 +5288,10 @@ function trashPathFor(relPath, now) {
   const normalized = relPath.split("\\").join("/");
   const slashIdx = normalized.lastIndexOf("/");
   const folder = slashIdx === -1 ? "" : normalized.slice(0, slashIdx);
-  const basename2 = slashIdx === -1 ? normalized : normalized.slice(slashIdx + 1);
+  const basename3 = slashIdx === -1 ? normalized : normalized.slice(slashIdx + 1);
   const stamp = now.toISOString().replace(/[:.]/g, "-");
   const trashDir = folder ? `${folder}/.trash` : ".trash";
-  return `${trashDir}/${stamp}-${basename2}`;
+  return `${trashDir}/${stamp}-${basename3}`;
 }
 function materializeSpecMarkdown(bundle) {
   return stringifySpecMarkdown(bundle.bodyText, bundle.frontmatter);
@@ -5372,10 +5413,10 @@ var init_export_status = __esm({
 function isGitHubFailure(value) {
   return typeof value === "object" && value !== null && "status" in value;
 }
-async function githubJson(path15, target, fetchImpl, init) {
+async function githubJson(path16, target, fetchImpl, init) {
   let response;
   try {
-    response = await fetchImpl(`${GITHUB_API_BASE2}${path15}`, {
+    response = await fetchImpl(`${GITHUB_API_BASE2}${path16}`, {
       ...init,
       headers: {
         ...githubHeaders(target.token),
@@ -6104,7 +6145,7 @@ var init_diagnose_spawned = __esm({
 
 // spex-console/src/lib/guardrail-naming.ts
 import fs4 from "node:fs";
-import path8 from "node:path";
+import path9 from "node:path";
 var init_guardrail_naming = __esm({
   "spex-console/src/lib/guardrail-naming.ts"() {
     "use strict";
@@ -6114,7 +6155,7 @@ var init_guardrail_naming = __esm({
 // spex-console/src/lib/indexer/indexer-service.ts
 import { spawnSync } from "node:child_process";
 import { promises as fs5 } from "node:fs";
-import path9 from "node:path";
+import path10 from "node:path";
 var init_indexer_service = __esm({
   "spex-console/src/lib/indexer/indexer-service.ts"() {
     "use strict";
@@ -6133,7 +6174,7 @@ var init_indexer_service = __esm({
 
 // spex-console/src/lib/indexer/outbox-index-feeder.ts
 import { promises as fs6 } from "node:fs";
-import path10 from "node:path";
+import path11 from "node:path";
 var init_outbox_index_feeder = __esm({
   "spex-console/src/lib/indexer/outbox-index-feeder.ts"() {
     "use strict";
@@ -6331,7 +6372,7 @@ var init_list_filter = __esm({
 });
 
 // spex-console/src/lib/specs/list-query.ts
-import path11 from "node:path";
+import path12 from "node:path";
 var init_list_query = __esm({
   "spex-console/src/lib/specs/list-query.ts"() {
     "use strict";
@@ -6374,7 +6415,7 @@ var init_pipeline_neighborhood = __esm({
 });
 
 // spex-console/src/lib/specs/spec-by-id.ts
-import path12 from "node:path";
+import path13 from "node:path";
 var init_spec_by_id = __esm({
   "spex-console/src/lib/specs/spec-by-id.ts"() {
     "use strict";
@@ -6431,9 +6472,9 @@ var init_search_body_hit = __esm({
 
 // spex-console/src/lib/vault.ts
 import { spawn } from "node:child_process";
-import { readdirSync as readdirSync2, readFileSync as readFileSync12, statSync } from "node:fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync13, statSync as statSync5 } from "node:fs";
 import { promises as fs7 } from "node:fs";
-import path13 from "node:path";
+import path14 from "node:path";
 import yaml3 from "js-yaml";
 var import_gray_matter3, VAULT_CACHE_TTL_WATCHED_MS, VAULT_CACHE_KEY, vaultCacheStore, VAULT_CACHE_DELTA_LISTENERS_KEY, vaultCacheDeltaListeners, SEARCH_TEXT_KEY, searchTextStore, VAULT_SNAPSHOT_KEY, vaultSnapshotStore;
 var init_vault = __esm({
@@ -6551,9 +6592,9 @@ var init_vault = __esm({
 
 // spex-console/bin/hs-index-rebuild.ts
 import { execSync } from "node:child_process";
-import { appendFileSync, mkdirSync as mkdirSync6, readFileSync as readFileSync13 } from "node:fs";
+import { appendFileSync, mkdirSync as mkdirSync7, readFileSync as readFileSync15 } from "node:fs";
 import { promises as fs10 } from "node:fs";
-import path14 from "node:path";
+import path15 from "node:path";
 import process4 from "node:process";
 
 // spex-console/src/lib/cli/control-shared.ts
@@ -6563,14 +6604,14 @@ init_credentials();
 init_session_owner();
 init_vault_less_endpoints();
 init_registry_file();
-import path from "node:path";
+import path2 from "node:path";
 var VAULT_ID_HEADER = "x-heyspex-vault-id";
 var ACCOUNT_ID_HEADER = "x-heyspex-account-id";
-function scopeHeadersFor(scope, method, path15) {
+function scopeHeadersFor(scope, method, path16) {
   if (scope === "none") {
-    if (!isVaultLessEndpoint(method, path15)) {
+    if (!isVaultLessEndpoint(method, path16)) {
       throw new Error(
-        `controlRequest: scope "none" is only allowed for the vault-less endpoints (${VAULT_LESS_ENDPOINTS.join(", ")}); ${method.toUpperCase()} ${path15} is vault-scoped and must name { accountId, vaultId }.`
+        `controlRequest: scope "none" is only allowed for the vault-less endpoints (${VAULT_LESS_ENDPOINTS.join(", ")}); ${method.toUpperCase()} ${path16} is vault-scoped and must name { accountId, vaultId }.`
       );
     }
     return {};
@@ -6581,7 +6622,7 @@ function cloudRequestScope(scope) {
   const named = { accountId: scope.accountId, vaultId: scope.vaultId };
   return {
     ...named,
-    headersFor: (method, path15) => isVaultLessEndpoint(method, path15) ? {} : scopeHeadersFor(named, method, path15)
+    headersFor: (method, path16) => isVaultLessEndpoint(method, path16) ? {} : scopeHeadersFor(named, method, path16)
   };
 }
 
@@ -6624,7 +6665,7 @@ init_console_fetch();
 init_registry_file();
 init_repo_identity();
 import { promises as fs } from "node:fs";
-import path3 from "node:path";
+import path4 from "node:path";
 
 // spex-console/src/lib/cli/init.ts
 init_console_url_resolver();
@@ -6661,12 +6702,15 @@ var HELP2 = [
   "(spex-console/src/lib/cli/template-manifest.ts) \u2014 universal docs",
   "copied verbatim, template-shape docs written as author-prompt skeletons \u2014",
   "plus a generated CLAUDE.md, the kept-principles index, and the template_version",
-  "pin; with --git, one initial `git init` + commit. Rerunnable: a <dir> that already",
-  "holds heyspex.yaml and an empty/placeholder-only specs/ is accepted, existing",
-  "files are never overwritten (an existing CLAUDE.md gets a CLAUDE.md.template",
-  "beside it), and the result lists each manifest row as created or kept. Refuses a",
-  "non-empty <dir> without heyspex.yaml, or a specs/ holding managed specs.",
-  "See init.customer-vault.ts.",
+  "pin; with --git, one initial `git init` + commit. On an EXISTING vault (<dir>",
+  "holds heyspex.yaml with a vault_id) it is a REFRESH \u2014 the repair `hs doctor`'s",
+  "vault-template row names: only missing shipped files are added, template_version",
+  "is written/updated in heyspex.yaml (every other byte and the vault_id kept),",
+  "nothing existing is ever overwritten (an existing CLAUDE.md gets a",
+  "CLAUDE.md.template beside it), the result lists each manifest row as created or",
+  "kept, and a second run writes nothing. <dir> may be any path (a satellite repo",
+  "names its vault, e.g. `hs init --customer-vault ../my-specs`). Refuses only a",
+  "non-empty <dir> that has no heyspex.yaml. See init.customer-vault.ts.",
   "",
   "Flags:",
   "  --console-url <url>  console_url value (default: the mode-aware console --",
@@ -6739,7 +6783,7 @@ async function resolveSyncVaultTargetFromEnv(deps) {
   let markerVaultId = null;
   try {
     markerVaultId = parseVaultId(
-      await fs.readFile(path3.join(deps.vaultRoot, "heyspex.yaml"), "utf8")
+      await fs.readFile(path4.join(deps.vaultRoot, "heyspex.yaml"), "utf8")
     );
   } catch {
     markerVaultId = null;
@@ -6941,16 +6985,17 @@ async function runReindex(input) {
 init_validator();
 
 // spex-console/src/lib/vault-sync/pull-io.ts
-import { promises as fs9 } from "node:fs";
+import { promises as fs9, readFileSync as readFileSync14 } from "node:fs";
+import { EOL } from "node:os";
 import nodePath2 from "node:path";
 
 // spex-console/src/lib/dev-mode.ts
 init_heyspex_home2();
 init_credentials();
-import { mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "node:fs";
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync11, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join10 } from "node:path";
 var CLOUD_CONSOLE_URL2 = "https://app.heyspex.com";
-var defaultReadFile3 = (p) => readFileSync10(p, "utf8");
+var defaultReadFile3 = (p) => readFileSync11(p, "utf8");
 function readCredentialsMcpToken({
   homeDir = heyspexHome2(),
   readFile = defaultReadFile3
@@ -7100,16 +7145,16 @@ function currentGitHead(vaultRoot2) {
   }
 }
 function appendJournal(vaultRoot2, message) {
-  const heyspexDir = path14.join(vaultRoot2, ".heyspex");
-  mkdirSync6(heyspexDir, { recursive: true });
-  const logPath = path14.join(heyspexDir, "index-rebuild.log");
+  const heyspexDir = path15.join(vaultRoot2, ".heyspex");
+  mkdirSync7(heyspexDir, { recursive: true });
+  const logPath = path15.join(heyspexDir, "index-rebuild.log");
   const ts = (/* @__PURE__ */ new Date()).toISOString();
   appendFileSync(logPath, `[${ts}] ${message}
 `, "utf-8");
 }
 function readDiscovery(p) {
   try {
-    return readFileSync13(p, "utf-8");
+    return readFileSync15(p, "utf-8");
   } catch {
     return null;
   }
@@ -7121,7 +7166,7 @@ function resolveConsole(args) {
 }
 async function loadCrosswalk(vaultRoot2) {
   try {
-    const raw = await fs10.readFile(path14.join(vaultRoot2, ".heyspex", "id-crosswalk.json"), "utf8");
+    const raw = await fs10.readFile(path15.join(vaultRoot2, ".heyspex", "id-crosswalk.json"), "utf8");
     const parsed = JSON.parse(raw);
     return Array.isArray(parsed) ? parsed : [];
   } catch {
@@ -7129,10 +7174,10 @@ async function loadCrosswalk(vaultRoot2) {
   }
 }
 async function walkLocal(args) {
-  const specsDir = path14.join(args.vaultRoot, "specs");
+  const specsDir = path15.join(args.vaultRoot, "specs");
   const files = [];
   for await (const file of fs10.glob("**/*.md", { cwd: specsDir })) {
-    files.push(path14.join(specsDir, file));
+    files.push(path15.join(specsDir, file));
   }
   files.sort();
   const specs2 = [];
@@ -7140,10 +7185,10 @@ async function walkLocal(args) {
   for (const abs of files) {
     try {
       const content = await fs10.readFile(abs, "utf8");
-      const relPath = path14.relative(args.vaultRoot, abs).split(path14.sep).join("/");
+      const relPath = path15.relative(args.vaultRoot, abs).split(path15.sep).join("/");
       const parsed = parseSpecFromContent(content, {
         relPath,
-        basenameFallback: path14.basename(abs).replace(/\.md$/i, "")
+        basenameFallback: path15.basename(abs).replace(/\.md$/i, "")
       });
       specs2.push({ relPath, content, parsed });
       if (args.verbose) say(args, `  parsed  ${relPath}