skillwiki 0.10.109 → 0.10.111

package/dist/{chunk-LDEZQXH6.js → chunk-OJJBZDPR.js}

@@ -1,4 +1,17 @@
 #!/usr/bin/env node
+import {
+  applySourceCompileClaim,
+  applySourceCompilePublished,
+  applySourceCompileRelease,
+  applySourceReview,
+  listCompileStatus,
+  listSourceReviews,
+  planSourceCompileClaim,
+  planSourceCompilePublished,
+  planSourceCompileRelease,
+  planSourceReview,
+  runSourcesPending
+} from "./chunk-JQV5KNPT.js";
 import {
   latestFromCache,
   semverGt
@@ -6,9 +19,8 @@ import {
 import {
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-DTTKCCQ4.js";
+} from "./chunk-MRPJ7X7W.js";
 import {
-  CONFIG_KEYS,
   VAULT_HYGIENE_GENERATED_COMMIT_PATHS,
   VAULT_HYGIENE_GITIGNORE_PATTERNS,
   VAULT_SYNC_FILTER_REQUIRED_EXCLUDES,
@@ -18,20 +30,16 @@ import {
   communityCohesion,
   git,
   hasUnmergedPaths,
-  isValidWikiProfileKey,
   listReviewRequiredOps,
   loadFleetManifestAndHost,
   louvain,
   missingIgnorePatterns,
-  parseDotenvFile,
-  parseDotenvText,
   probeGithubReachability,
   probeS3Reachability,
   probeSnapshotterSsh,
   releaseOwnedSyncLock,
   resolveConfiguredSnapshotWorktree,
   resolveRuntimePath,
-  resolveSkillwikiHome,
   resolveVaultSyncPullHelper,
   resolveWikiS3Remote,
   runLint,
@@ -39,30 +47,46 @@ import {
   runStale,
   satelliteGateFromFleetLoad,
   snapshotterAliasForLocalHost,
-  toUndirectedWeighted,
-  writeDotenv
-} from "./chunk-FYAKMULW.js";
+  toUndirectedWeighted
+} from "./chunk-HBJLFPQP.js";
+import {
+  eventPathFor,
+  writeLogEvent
+} from "./chunk-5IBLXGLY.js";
 import {
-  atomicWriteText,
   prepareTypedPage
-} from "./chunk-HMHMCPCE.js";
+} from "./chunk-I6IRJCUJ.js";
 import {
-  applySourceCompileClaim,
-  applySourceCompilePublished,
-  applySourceCompileRelease,
-  applySourceReview,
-  listCompileStatus,
-  listSourceReviews,
-  planSourceCompileClaim,
-  planSourceCompilePublished,
-  planSourceCompileRelease,
-  planSourceReview,
-  runSourcesPending
-} from "./chunk-QU2IXZRN.js";
+  extractFrontmatter,
+  readPage,
+  redactSensitiveContent,
+  resolveReadOnlyVaultRoot,
+  scanSensitiveContent,
+  scanVault,
+  splitFrontmatter
+} from "./chunk-X5GL2FCU.js";
 import {
-  eventPathFor,
-  writeLogEvent
-} from "./chunk-JCDAEZVD.js";
+  xml
+} from "./chunk-TDBUJUYH.js";
+import {
+  CLIP_NOT_CONFIGURED,
+  PRODUCTION_WATCHER_LABEL,
+  RETIRED_WATCHER_LABELS,
+  conditionalCreateProven,
+  loadClipCredentials,
+  loadClipOutboxConfig
+} from "./chunk-6OQLBNKR.js";
+import {
+  CONFIG_KEYS,
+  isValidWikiProfileKey,
+  parseDotenvFile,
+  parseDotenvText,
+  resolveSkillwikiHome,
+  writeDotenv
+} from "./chunk-PYPPG7RF.js";
+import {
+  atomicWriteText
+} from "./chunk-GQWCTJTU.js";
 import {
   CompoundSchema,
   ExitCode,
@@ -72,18 +96,13 @@ import {
   WorkItemSchema,
   detectSchema,
   err,
-  extractFrontmatter,
+  isClipOutboxKey,
   isVaultSyncKey,
   ok,
+  parseClipOutboxKeyValue,
   parseVaultSyncKeyValue,
-  readPage,
-  redactSensitiveContent,
-  resolveReadOnlyVaultRoot,
-  scanSensitiveContent,
-  scanVault,
-  splitFrontmatter,
   systemdPropertyFor
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-UIEQIJXP.js";
 
 // src/commands/log-append.ts
 import { readFile, stat } from "fs/promises";
@@ -1017,7 +1036,7 @@ import { readFile as readFile5 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
 import { join as join5 } from "path";
 function validateKey(key) {
-  return CONFIG_KEYS.includes(key) || isValidWikiProfileKey(key) || isVaultSyncKey(key);
+  return CONFIG_KEYS.includes(key) || isValidWikiProfileKey(key) || isVaultSyncKey(key) || isClipOutboxKey(key);
 }
 function displayConfigValue(key, value) {
   if (key === "SKILLWIKI_MCP_TOKEN") return value.length > 0 ? "TOKEN_SET" : "";
@@ -1044,6 +1063,12 @@ async function runConfigSet(input) {
       return { exitCode: ExitCode.INVALID_CONFIG_VALUE, result: err("INVALID_CONFIG_VALUE", { key: input.key, value: input.value, message: parsed.message }) };
     }
   }
+  if (isClipOutboxKey(input.key)) {
+    const parsed = parseClipOutboxKeyValue(input.key, input.value);
+    if (!parsed.ok) {
+      return { exitCode: ExitCode.INVALID_CONFIG_VALUE, result: err("INVALID_CONFIG_VALUE", { key: input.key, value: input.value, message: parsed.message }) };
+    }
+  }
   const filePath = configPath(input.home);
   try {
     let originalContent;
@@ -1130,7 +1155,7 @@ function isMcpOnlyLeaf(input) {
 }
 
 // src/doctor/runner.ts
-import { existsSync as existsSync18 } from "fs";
+import { existsSync as existsSync19 } from "fs";
 
 // src/doctor/probes/environment.ts
 import { existsSync as existsSync4, lstatSync, readlinkSync } from "fs";
@@ -2102,7 +2127,9 @@ import { execSync as execSync4 } from "child_process";
 // src/utils/s3-mount-health.ts
 import { execSync as execSync3 } from "child_process";
 import { platform as platform2 } from "os";
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, readFileSync as readFile6 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
+import { readFile as readFile6, writeFile as writeFile2, unlink } from "fs/promises";
+import { randomUUID } from "crypto";
 import { join as join13 } from "path";
 var OS = platform2();
 function findRcloneMountPid() {
@@ -2260,36 +2287,45 @@ function detectFuseMount(vaultPath) {
   }
   return null;
 }
-function writeTest(dir) {
-  const testFile = join13(dir, `.doctor-write-test-${process.pid}.tmp`);
-  const payload = `skillwiki doctor write test \u2014 ${Date.now()} \u2014 ${Math.random().toString(36).slice(2)}`;
+async function writeTest(dir, options = {}) {
+  const testFile = join13(dir, options.fileName ?? `.doctor-write-test-${process.pid}.tmp`);
+  const io = options.io ?? {
+    write: (path, payload2) => writeFile2(path, payload2, "utf8"),
+    read: (path) => readFile6(path, "utf8"),
+    remove: (path) => unlink(path)
+  };
+  const payload = `skillwiki write test \u2014 ${(/* @__PURE__ */ new Date()).toISOString()} \u2014 ${randomUUID()}`;
   const start = Date.now();
   try {
-    writeFileSync2(testFile, payload, "utf8");
+    await io.write(testFile, payload);
   } catch (e) {
+    try {
+      await io.remove(testFile);
+    } catch {
+    }
     return { success: false, writeMs: Date.now() - start, readMs: 0, size: 0, error: `write failed: ${e.message}` };
   }
   const writeMs = Date.now() - start;
   const readStart = Date.now();
   try {
-    const back = readFile6(testFile, "utf8");
+    const back = await io.read(testFile);
     const readMs = Date.now() - readStart;
     if (back !== payload) {
       try {
-        unlinkSync2(testFile);
+        await io.remove(testFile);
       } catch {
       }
       return { success: false, writeMs, readMs, size: Buffer.byteLength(payload, "utf8"), error: "content mismatch \u2014 wrote and read-back differ" };
     }
   } catch (e) {
     try {
-      unlinkSync2(testFile);
+      await io.remove(testFile);
     } catch {
     }
     return { success: false, writeMs, readMs: Date.now() - readStart, size: 0, error: `read failed: ${e.message}` };
   }
   try {
-    unlinkSync2(testFile);
+    await io.remove(testFile);
   } catch {
   }
   return { success: true, writeMs, readMs: Date.now() - readStart, size: Buffer.byteLength(payload, "utf8") };
@@ -2523,7 +2559,7 @@ function checkRcloneVersion(resolvedPath, vaultSyncInstalled, pushEnabled = true
   }
   return check("pass", "rclone_version", "rclone version", ver.raw);
 }
-function checkWriteTest(resolvedPath) {
+async function checkWriteTest(resolvedPath) {
   if (!resolvedPath) {
     return check("pass", "s3_write_test", "S3 write test", "No vault path \u2014 check skipped");
   }
@@ -2535,7 +2571,7 @@ function checkWriteTest(resolvedPath) {
   if (!existsSync10(conceptsDir)) {
     return check("pass", "s3_write_test", "S3 write test", "no concepts/ dir to test \u2014 check skipped");
   }
-  const result = writeTest(conceptsDir);
+  const result = await writeTest(conceptsDir);
   if (result.success) {
     const totalMs = result.writeMs + result.readMs;
     if (totalMs > 3e3) {
@@ -2618,13 +2654,13 @@ function checkVfsCacheHealth(resolvedPath) {
 }
 var s3MountHealthProbe = {
   id: "s3_mount_health",
-  run(ctx) {
+  async run(ctx) {
     return [
       checkS3MountPerf(ctx.resolvedPath),
       checkS3MountFreshness(ctx.resolvedPath),
       checkRcloneFlagAudit(ctx.resolvedPath),
       checkRcloneVersion(ctx.resolvedPath, ctx.vsConfig.installed, ctx.vsConfig.pushEnabled !== false, ctx.mcpOnlyLeaf),
-      checkWriteTest(ctx.resolvedPath),
+      await checkWriteTest(ctx.resolvedPath),
       checkVfsCacheHealth(ctx.resolvedPath)
     ];
   }
@@ -4422,6 +4458,156 @@ var mcpHandshakeProbe = {
   }
 };
 
+// src/doctor/probes/clip-outbox.ts
+import { existsSync as existsSync18, readFileSync as readFileSync12 } from "fs";
+import { execSync as execSync7 } from "child_process";
+import { platform as platform6 } from "os";
+import { join as join22 } from "path";
+var CLIP_CHECK_IDS = [
+  "clip_config",
+  "clip_frozen_mirror",
+  "clip_push_isolation",
+  "clip_outbox_root",
+  "clip_watcher",
+  "clip_storage_credentials",
+  "clip_ready_channel",
+  "clip_mirror_listener"
+];
+function notConfigured() {
+  return CLIP_CHECK_IDS.map(
+    (id) => check("info", id, clipLabel(id), CLIP_NOT_CONFIGURED)
+  );
+}
+function clipLabel(id) {
+  switch (id) {
+    case "clip_config":
+      return "Clip outbox configuration";
+    case "clip_frozen_mirror":
+      return "Clip frozen mirror";
+    case "clip_push_isolation":
+      return "Clip push isolation";
+    case "clip_outbox_root":
+      return "Clip outbox root";
+    case "clip_watcher":
+      return "Clip outbox watcher";
+    case "clip_storage_credentials":
+      return "Clip storage credentials";
+    case "clip_ready_channel":
+      return "Clip ready channel";
+    case "clip_mirror_listener":
+      return "Clip mirror listener";
+    default:
+      return id;
+  }
+}
+function launchdLoaded(label) {
+  if (platform6() !== "darwin") return false;
+  try {
+    execSync7(`launchctl list ${label}`, {
+      encoding: "utf8",
+      timeout: 2e3,
+      stdio: ["pipe", "ignore", "ignore"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function watcherStatus(env, label, home, root) {
+  const fixture = env.CLIP_WATCHER_FIXTURE;
+  if (fixture === "loaded-enabled") return { loaded: true, enabled: true, kind: "production" };
+  if (fixture === "stopped") return { loaded: false, enabled: false, kind: "production" };
+  if (fixture === "retired-wiki-dev") return { loaded: true, enabled: true, kind: "retired" };
+  if (fixture === "missing") return { loaded: false, enabled: false, kind: "unknown" };
+  if (RETIRED_WATCHER_LABELS.includes(label)) {
+    return { loaded: false, enabled: false, kind: "retired" };
+  }
+  if (!launchdLoaded(label)) {
+    return { loaded: false, enabled: false, kind: "unknown" };
+  }
+  const plist = join22(home, "Library", "LaunchAgents", `${label}.plist`);
+  try {
+    const text = readFileSync12(plist, "utf8");
+    const xmlRoot = xml(root);
+    const matchesRoot = text.includes(`<key>WatchPaths</key><array><string>${xmlRoot}</string></array>`);
+    const disabled = execSync7(`launchctl print-disabled gui/${process.getuid()}`, { encoding: "utf8", timeout: 2e3, stdio: ["ignore", "pipe", "ignore"] });
+    const explicitlyDisabled = disabled.split("\n").some((line) => line.includes(`"${label}"`) && line.includes("true"));
+    return { loaded: true, enabled: matchesRoot && !explicitlyDisabled, kind: "production" };
+  } catch {
+    return { loaded: true, enabled: false, kind: "unknown" };
+  }
+}
+function pushLoaded(env) {
+  if (env.CLIP_PUSH_FIXTURE === "loaded") return true;
+  if (env.CLIP_PUSH_FIXTURE === "unloaded") return false;
+  return launchdLoaded("com.karlchow.wiki-push");
+}
+function credentialPresent(env, ref) {
+  if (env.CLIP_CREDENTIAL_FIXTURE === "present") return true;
+  if (env.CLIP_CREDENTIAL_FIXTURE === "absent") return false;
+  const value = env[ref];
+  return typeof value === "string" && value.length > 0;
+}
+function listenerOk(env) {
+  if (env.CLIP_LISTENER_FIXTURE === "ok") return true;
+  return false;
+}
+function conditionalCreateEvidence(env) {
+  return env.CLIP_CONDITIONAL_CREATE_FIXTURE === "ok";
+}
+var clipOutboxProbe = {
+  id: "clip_outbox",
+  async run(ctx) {
+    if (ctx.mcpOnlyLeaf) {
+      return CLIP_CHECK_IDS.map(
+        (id) => check("info", id, clipLabel(id), MCP_ONLY_LEAF_SKIP)
+      );
+    }
+    const env = ctx.input.env ?? process.env;
+    const resolved = await loadClipOutboxConfig(ctx.input.home);
+    if (!resolved.ok) {
+      return [
+        check("error", "clip_config", clipLabel("clip_config"), resolved.message),
+        ...CLIP_CHECK_IDS.slice(1).map((id) => check("error", id, clipLabel(id), "clip configuration invalid"))
+      ];
+    }
+    if (!resolved.enabled) {
+      return notConfigured();
+    }
+    const cfg = resolved.config;
+    const frozen = existsSync18(join22(cfg.mirrorRoot, ".WIKI_GIT_FROZEN"));
+    const pushOn = ctx.vsConfig.pushEnabled !== false;
+    const pushIsLoaded = pushLoaded(env);
+    const watch = watcherStatus(env, cfg.watcherLabel, ctx.input.home, cfg.root);
+    let s3Creds = credentialPresent(env, cfg.s3CredentialRef);
+    let readyCreds = credentialPresent(env, cfg.readyCredentialRef);
+    let condCreate = conditionalCreateEvidence(env);
+    if (!env.CLIP_CREDENTIAL_FIXTURE) {
+      try {
+        const credentials = await loadClipCredentials(ctx.input.home, cfg, env);
+        s3Creds = true;
+        readyCreds = true;
+        condCreate = await conditionalCreateProven(cfg, credentials.s3.endpoint);
+      } catch {
+        s3Creds = false;
+        readyCreds = false;
+        condCreate = false;
+      }
+    }
+    const listener = listenerOk(env);
+    return [
+      check("pass", "clip_config", clipLabel("clip_config"), "clip_outbox.enabled=true; schema valid"),
+      frozen ? check("pass", "clip_frozen_mirror", clipLabel("clip_frozen_mirror"), "frozen marker present") : check("error", "clip_frozen_mirror", clipLabel("clip_frozen_mirror"), "frozen marker missing; do not unfreeze"),
+      !pushOn && !pushIsLoaded ? check("pass", "clip_push_isolation", clipLabel("clip_push_isolation"), "wiki-push disabled and unloaded") : check("error", "clip_push_isolation", clipLabel("clip_push_isolation"), "wiki-push must stay disabled and unloaded"),
+      check("pass", "clip_outbox_root", clipLabel("clip_outbox_root"), "outbox and state roots are canonical and disjoint"),
+      watch.kind === "retired" ? check("error", "clip_watcher", clipLabel("clip_watcher"), "retired wiki-dev or D8 job does not satisfy the clip watcher") : watch.loaded && watch.enabled && watch.kind === "production" ? check("pass", "clip_watcher", clipLabel("clip_watcher"), `loaded and enabled: ${PRODUCTION_WATCHER_LABEL}`) : check("error", "clip_watcher", clipLabel("clip_watcher"), "production clip watcher not loaded and enabled"),
+      s3Creds && readyCreds && condCreate ? check("pass", "clip_storage_credentials", clipLabel("clip_storage_credentials"), "credential references present; conditional-create evidence available") : check("error", "clip_storage_credentials", clipLabel("clip_storage_credentials"), "missing credential reference or conditional-create evidence"),
+      readyCreds ? check("pass", "clip_ready_channel", clipLabel("clip_ready_channel"), "ready URL and credential reference present") : check("error", "clip_ready_channel", clipLabel("clip_ready_channel"), "ready credential missing"),
+      listener ? check("pass", "clip_mirror_listener", clipLabel("clip_mirror_listener"), "inbound production SSE listener configured") : check("error", "clip_mirror_listener", clipLabel("clip_mirror_listener"), "inbound SSE listener disabled or missing")
+    ];
+  }
+};
+
 // src/doctor/probes/index.ts
 var DOCTOR_PROBES = [
   environmentProbe,
@@ -4436,7 +4622,8 @@ var DOCTOR_PROBES = [
   fuseStalenessProbe,
   activationMarkerProbe,
   dsStoreNoiseProbe,
-  mcpHandshakeProbe
+  mcpHandshakeProbe,
+  clipOutboxProbe
 ];
 
 // src/doctor/runner.ts
@@ -4447,7 +4634,7 @@ function resolveSnapshotGitWorktree(home) {
   const configured = resolveConfiguredSnapshotWorktree(home);
   if (configured) return configured;
   const defaultPath = "/root/wiki-git";
-  return existsSync18(defaultPath) ? defaultPath : void 0;
+  return existsSync19(defaultPath) ? defaultPath : void 0;
 }
 var DoctorRunner = class {
   probes;
@@ -4527,6 +4714,9 @@ var DoctorRunner = class {
     if (summary.info > 0) summaryParts.push(`${summary.info} info`);
     summaryParts.push(`${summary.warn} warn`, `${summary.error} error`);
     lines.push(summaryParts.join(" \xB7 "));
+    if (checks.some((c) => c.id === "clip_config" && c.detail === "clip channel not configured")) {
+      lines.push("Clip setup is attended: skillwiki clip-outbox install-or-migrate refreshes the packaged plist; prove SeaweedFS conditional-create before enabling/loading the channel.");
+    }
     const humanHint = redactMcpSecret(lines.join("\n"), auth.token);
     return { exitCode, result: ok({ checks, summary, humanHint }) };
   }
@@ -4536,7 +4726,7 @@ async function runDoctor(input) {
 }
 
 // src/utils/package-info.ts
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync13 } from "fs";
 function packageJsonCandidateUrls(baseUrl = import.meta.url) {
   return [
     new URL("../package.json", baseUrl),
@@ -4546,7 +4736,7 @@ function packageJsonCandidateUrls(baseUrl = import.meta.url) {
 function readCliPackageJson(baseUrl = import.meta.url) {
   for (const url of packageJsonCandidateUrls(baseUrl)) {
     try {
-      const pkg = JSON.parse(readFileSync12(url, "utf8"));
+      const pkg = JSON.parse(readFileSync13(url, "utf8"));
       if (typeof pkg.version === "string") {
         return { ...pkg, version: pkg.version };
       }
@@ -4558,8 +4748,8 @@ function readCliPackageJson(baseUrl = import.meta.url) {
 
 // src/utils/vault-write-gates.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync19, readdirSync as readdirSync7, readFileSync as readFileSync13, statSync as statSync3 } from "fs";
-import { join as join22, relative as relative2 } from "path";
+import { existsSync as existsSync20, readdirSync as readdirSync7, readFileSync as readFileSync14, statSync as statSync3 } from "fs";
+import { join as join23, relative as relative2 } from "path";
 var DEFAULT_DIRTY_VOLUME_THRESHOLD = 50;
 var DEFAULT_CAPTURE_BUDGET = 20;
 var DEFAULT_NO_DECISION_STREAK = 3;
@@ -4615,7 +4805,7 @@ function isEventLedgerPath(rel) {
   return n === "meta/log-events" || n.startsWith("meta/log-events/");
 }
 function countEventLedgerFiles(vault) {
-  return listFilesRecursive(join22(vault, "meta", "log-events")).length;
+  return listFilesRecursive(join23(vault, "meta", "log-events")).length;
 }
 function measureDirtyVolume(vault) {
   const empty = (extra = {}) => ({
@@ -4631,7 +4821,7 @@ function measureDirtyVolume(vault) {
     is_git_repo: false,
     ...extra
   });
-  if (!existsSync19(vault) || !statSync3(vault).isDirectory()) {
+  if (!existsSync20(vault) || !statSync3(vault).isDirectory()) {
     return empty();
   }
   const gitDir = git(vault, ["rev-parse", "--absolute-git-dir"]);
@@ -4675,8 +4865,8 @@ function measureDirtyVolume(vault) {
     if (!rel) continue;
     if (code === "??") {
       untracked += 1;
-      const abs = join22(vault, rel);
-      if (existsSync19(abs) && statSync3(abs).isDirectory()) {
+      const abs = join23(vault, rel);
+      if (existsSync20(abs) && statSync3(abs).isDirectory()) {
         const files = listFilesRecursive(abs);
         expanded += files.length;
         addBucket(rel, files.length);
@@ -4719,7 +4909,7 @@ function listFilesRecursive(dir) {
   }
   for (const name of entries) {
     if (name === ".git") continue;
-    const p = join22(dir, name);
+    const p = join23(dir, name);
     try {
       const st = statSync3(p);
       if (st.isDirectory()) out.push(...listFilesRecursive(p));
@@ -4814,7 +5004,7 @@ var CAPTURE_HYGIENE_CONTRACT = `After each productive cycle (or when daily captu
 function listProjectDayCaptures(vault, project, day) {
   const found = [];
   const slug = project.replace(/^\[\[/, "").replace(/\]\]$/, "").trim();
-  if (!slug || !existsSync19(vault)) return found;
+  if (!slug || !existsSync20(vault)) return found;
   const consider = (abs, rel) => {
     if (!rel.endsWith(".md")) return;
     const base = rel.split(/[/\\]/).pop() ?? "";
@@ -4831,7 +5021,7 @@ function listProjectDayCaptures(vault, project, day) {
     }
     if (norm.startsWith("raw/transcripts/")) {
       try {
-        const body = readFileSync13(abs, "utf8");
+        const body = readFileSync14(abs, "utf8");
         if (body.includes(`project: ${slug}`) || body.includes(`project: "[[${slug}]]"`) || body.includes(`project: [[${slug}]]`)) {
           found.push(norm);
         } else if (base.includes(slug)) {
@@ -4842,7 +5032,7 @@ function listProjectDayCaptures(vault, project, day) {
     }
   };
   const walk = (dir, relBase) => {
-    if (!existsSync19(dir)) return;
+    if (!existsSync20(dir)) return;
     let entries;
     try {
       entries = readdirSync7(dir);
@@ -4850,7 +5040,7 @@ function listProjectDayCaptures(vault, project, day) {
       return;
     }
     for (const name of entries) {
-      const abs = join22(dir, name);
+      const abs = join23(dir, name);
       const rel = relBase ? `${relBase}/${name}` : name;
       try {
         const st = statSync3(abs);
@@ -4860,16 +5050,16 @@ function listProjectDayCaptures(vault, project, day) {
       }
     }
   };
-  walk(join22(vault, "raw", "transcripts"), "raw/transcripts");
-  walk(join22(vault, "projects", slug, "raw", "transcripts"), `projects/${slug}/raw/transcripts`);
-  walk(join22(vault, "projects", slug, "requirements"), `projects/${slug}/requirements`);
-  const workRoot = join22(vault, "projects", slug, "work");
-  if (existsSync19(workRoot)) {
+  walk(join23(vault, "raw", "transcripts"), "raw/transcripts");
+  walk(join23(vault, "projects", slug, "raw", "transcripts"), `projects/${slug}/raw/transcripts`);
+  walk(join23(vault, "projects", slug, "requirements"), `projects/${slug}/requirements`);
+  const workRoot = join23(vault, "projects", slug, "work");
+  if (existsSync20(workRoot)) {
     try {
       for (const name of readdirSync7(workRoot)) {
         if (!name.startsWith(day)) continue;
         if (!/investigate|pilot-q|research|cycle|dev-loop/.test(name)) continue;
-        const abs = join22(workRoot, name);
+        const abs = join23(workRoot, name);
         if (statSync3(abs).isDirectory()) {
           for (const f of listFilesRecursive(abs)) {
             const rel = relative2(vault, f).replace(/\\/g, "/");
@@ -4914,7 +5104,7 @@ function evaluateCaptureBudget(input) {
   return { allowed: true, reason: "under_budget", report };
 }
 function runWritePreflight(input) {
-  if (!input.vault || !existsSync19(input.vault)) {
+  if (!input.vault || !existsSync20(input.vault)) {
     return err(GateError.VAULT_PATH_INVALID, { path: input.vault });
   }
   const want = new Set(input.checks ?? ["all"]);
@@ -4973,9 +5163,9 @@ function runWritePreflight(input) {
 }
 
 // src/commands/observe.ts
-import { mkdir as mkdir3, writeFile as writeFile2 } from "fs/promises";
-import { existsSync as existsSync20, statSync as statSync4 } from "fs";
-import { join as join23 } from "path";
+import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
+import { existsSync as existsSync21, statSync as statSync4 } from "fs";
+import { join as join24 } from "path";
 import { createHash as createHash2 } from "crypto";
 var ALLOWED_KINDS = /* @__PURE__ */ new Set(["note", "bug", "task", "idea", "session-log"]);
 function slugify(text) {
@@ -4998,7 +5188,7 @@ async function runObserve(input) {
       result: err("SCHEME_REJECTED", { message: "Text must not be empty" })
     };
   }
-  if (!existsSync20(input.vault) || !statSync4(input.vault).isDirectory()) {
+  if (!existsSync21(input.vault) || !statSync4(input.vault).isDirectory()) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: err("VAULT_PATH_INVALID", { path: input.vault })
@@ -5024,7 +5214,7 @@ async function runObserve(input) {
       };
     }
   }
-  const transcriptsDir = join23(input.vault, "raw", "transcripts");
+  const transcriptsDir = join24(input.vault, "raw", "transcripts");
   try {
     await mkdir3(transcriptsDir, { recursive: true });
   } catch {
@@ -5036,7 +5226,7 @@ async function runObserve(input) {
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const slug = slugify(input.text);
   const fileName = `${today}-observation-${slug}.md`;
-  const filePath = join23(transcriptsDir, fileName);
+  const filePath = join24(transcriptsDir, fileName);
   const body = `
 ${input.text.trim()}
 `;
@@ -5054,7 +5244,7 @@ ${input.text.trim()}
   frontmatterLines.push("---");
   const content = frontmatterLines.join("\n") + body;
   try {
-    await writeFile2(filePath, content, "utf8");
+    await writeFile3(filePath, content, "utf8");
   } catch (e) {
     return {
       exitCode: ExitCode.WRITE_FAILED,
@@ -5077,8 +5267,8 @@ ${input.text.trim()}
 
 // src/commands/memory.ts
 import { createHash as createHash3 } from "crypto";
-import { mkdir as mkdir4, readFile as readFile7, readdir as readdir2, stat as stat2, writeFile as writeFile3 } from "fs/promises";
-import { basename as basename2, extname, join as join24, relative as relative3, sep as sep2 } from "path";
+import { mkdir as mkdir4, readFile as readFile7, readdir as readdir2, stat as stat2, writeFile as writeFile4 } from "fs/promises";
+import { basename as basename2, extname, join as join25, relative as relative3, sep as sep2 } from "path";
 
 // src/utils/memory-authority.ts
 var TIER_RANK = {
@@ -5197,9 +5387,9 @@ async function runMemoryIndex(input) {
   }
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
   const relCachePath = memoryCacheRelPath(input.project);
-  const absCachePath = join24(input.vault, relCachePath);
-  await mkdir4(join24(input.vault, ".skillwiki", "memory", input.project), { recursive: true });
-  await writeFile3(absCachePath, `${JSON.stringify({
+  const absCachePath = join25(input.vault, relCachePath);
+  await mkdir4(join25(input.vault, ".skillwiki", "memory", input.project), { recursive: true });
+  await writeFile4(absCachePath, `${JSON.stringify({
     generated_at: generatedAt,
     project: input.project,
     topics: state.topics,
@@ -5390,7 +5580,7 @@ async function buildMemoryIndexState(pages, project) {
 }
 async function checkMemoryIndex(vault, project, current) {
   const relCachePath = memoryCacheRelPath(project);
-  const cacheText = await readIfExists(join24(vault, relCachePath));
+  const cacheText = await readIfExists(join25(vault, relCachePath));
   if (!cacheText) {
     return {
       ok: true,
@@ -5799,7 +5989,7 @@ async function walkImportFiles(dir, out) {
   const entries = await readdir2(dir, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.name === ".git" || entry.name === "node_modules") continue;
-    const path = join24(dir, entry.name);
+    const path = join25(dir, entry.name);
     if (entry.isDirectory()) {
       await walkImportFiles(path, out);
     } else if (entry.isFile() && isImportCandidate(path)) {
@@ -5866,9 +6056,9 @@ async function writeImportCapture(vault, entry, today) {
   const content = hiddenString(entry, "__content");
   const project = hiddenString(entry, "__project");
   const relPath = await availableImportPath(vault, entry.proposed_path);
-  const absPath = join24(vault, relPath);
-  await mkdir4(join24(vault, "raw", "transcripts"), { recursive: true });
-  await writeFile3(absPath, renderImportCapture(entry, content, project, today), "utf8");
+  const absPath = join25(vault, relPath);
+  await mkdir4(join25(vault, "raw", "transcripts"), { recursive: true });
+  await writeFile4(absPath, renderImportCapture(entry, content, project, today), "utf8");
   const validation = await runValidate({ file: absPath });
   return {
     relPath,
@@ -5883,7 +6073,7 @@ async function availableImportPath(vault, proposed) {
   const stem = proposed.slice(0, -ext.length);
   let candidate = proposed;
   let i = 2;
-  while (await readIfExists(join24(vault, candidate))) {
+  while (await readIfExists(join25(vault, candidate))) {
     candidate = `${stem}-${i}${ext}`;
     i++;
   }
@@ -6068,10 +6258,10 @@ function memoryCacheRelPath(project) {
 }
 async function readMemoryCache(vault, project) {
   if (project) {
-    const projectCache = await readIfExists(join24(vault, memoryCacheRelPath(project)));
+    const projectCache = await readIfExists(join25(vault, memoryCacheRelPath(project)));
     if (projectCache) return projectCache;
   }
-  return readIfExists(join24(vault, ".skillwiki", "memory-topics.json"));
+  return readIfExists(join25(vault, ".skillwiki", "memory-topics.json"));
 }
 function dedupePages(pages) {
   const seen = /* @__PURE__ */ new Set();
@@ -6163,7 +6353,7 @@ function slugify2(value) {
 
 // src/commands/query.ts
 import { readFile as readFile9, stat as stat4 } from "fs/promises";
-import { join as join26 } from "path";
+import { join as join27 } from "path";
 
 // src/utils/rrf.ts
 var RRF_K = 60;
@@ -6179,8 +6369,8 @@ function fuseRankings(lists, k = RRF_K) {
 
 // src/utils/vector-index.ts
 import { mkdir as mkdir5, readFile as readFile8, stat as stat3 } from "fs/promises";
-import { join as join25 } from "path";
-import { existsSync as existsSync21 } from "fs";
+import { join as join26 } from "path";
+import { existsSync as existsSync22 } from "fs";
 var VECTOR_INDEX_REL = ".skillwiki/vectors/index.json";
 var VECTOR_INDEX_SCHEMA = "skillwiki-tfidf-index/v1";
 function tokenize(text) {
@@ -6194,7 +6384,7 @@ function extractPageTokens(text) {
   return tokenize(`${title} ${body}`);
 }
 function vectorIndexPath(vault) {
-  return join25(vault, ...VECTOR_INDEX_REL.split("/"));
+  return join26(vault, ...VECTOR_INDEX_REL.split("/"));
 }
 function termFreq(tokens) {
   const tf = /* @__PURE__ */ new Map();
@@ -6249,7 +6439,7 @@ async function buildVectorIndex(vault, now = (/* @__PURE__ */ new Date()).toISOS
     docs
   };
   const dest = vectorIndexPath(vault);
-  await mkdir5(join25(vault, ".skillwiki", "vectors"), { recursive: true });
+  await mkdir5(join26(vault, ".skillwiki", "vectors"), { recursive: true });
   await atomicWriteText(dest, `${JSON.stringify(index)}
 `);
   return ok(index);
@@ -6292,7 +6482,7 @@ async function reindexPageInVectorIndex(vault, pageRelPath, now = (/* @__PURE__
   if (!normalizedPage.endsWith(".md")) {
     return err("USAGE", { message: `Page must be a .md file: ${pageRelPath}` });
   }
-  const absPath = join25(vault, ...normalizedPage.split("/"));
+  const absPath = join26(vault, ...normalizedPage.split("/"));
   let text;
   try {
     text = await readFile8(absPath, "utf8");
@@ -6377,7 +6567,7 @@ async function reindexPageInVectorIndex(vault, pageRelPath, now = (/* @__PURE__
     }
   }
   const dest = vectorIndexPath(vault);
-  await mkdir5(join25(vault, ".skillwiki", "vectors"), { recursive: true });
+  await mkdir5(join26(vault, ".skillwiki", "vectors"), { recursive: true });
   await atomicWriteText(dest, `${JSON.stringify(index)}
 `);
   return ok({
@@ -6395,8 +6585,8 @@ async function pruneVectorIndex(vault, opts) {
   const orphans = [];
   for (const docKey of Object.keys(index.docs)) {
     const normalizedKey = docKey.split(/\\|\//).join("/");
-    const absPath = join25(vault, ...normalizedKey.split("/"));
-    if (!existsSync21(absPath)) {
+    const absPath = join26(vault, ...normalizedKey.split("/"));
+    if (!existsSync22(absPath)) {
       orphans.push(normalizedKey);
     }
   }
@@ -6442,7 +6632,7 @@ async function pruneVectorIndex(vault, opts) {
       index.docs[docKey] = toTfIdf(termFreq(tokens), index.df, newPageCount);
     } else {
       try {
-        const text = await readFile8(join25(vault, ...docKey.split("/")), "utf8");
+        const text = await readFile8(join26(vault, ...docKey.split("/")), "utf8");
         const tokens = extractPageTokens(text);
         index.docs[docKey] = toTfIdf(termFreq(tokens), index.df, newPageCount);
       } catch {
@@ -6452,7 +6642,7 @@ async function pruneVectorIndex(vault, opts) {
   }
   if (!opts?.dryRun) {
     const dest = vectorIndexPath(vault);
-    await mkdir5(join25(vault, ".skillwiki", "vectors"), { recursive: true });
+    await mkdir5(join26(vault, ".skillwiki", "vectors"), { recursive: true });
     await atomicWriteText(dest, `${JSON.stringify(index)}
 `);
   }
@@ -6583,7 +6773,7 @@ async function runQuery(input) {
   }
   let pendingSources;
   if (input.includePending) {
-    const { runSourcesPending: runSourcesPending2 } = await import("./sources-QTQSZMST.js");
+    const { runSourcesPending: runSourcesPending2 } = await import("./sources-D2MGP246.js");
     const pending = await runSourcesPending2({
       vault: input.vault,
       match: input.text,
@@ -6753,7 +6943,7 @@ function computeKeywordScore(terms, title, tags, body, relPath) {
   return score;
 }
 async function loadOrBuildGraph(vault) {
-  const graphPath = join26(vault, ".skillwiki", "graph.json");
+  const graphPath = join27(vault, ".skillwiki", "graph.json");
   let needsBuild = false;
   try {
     const fileStat = await stat4(graphPath);
@@ -6842,7 +7032,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 
 // src/mcp/vault-resolve.ts
-import { join as join27, resolve as resolve4 } from "path";
+import { join as join28, resolve as resolve4 } from "path";
 
 // src/mcp/allowlist.ts
 import { resolve as resolve3, sep as sep3 } from "path";
@@ -6904,7 +7094,7 @@ async function resolveMcpVault(input) {
   return ok({ vault: vaultPath, source });
 }
 function defaultGraphOut(vault) {
-  return join27(vault, ".skillwiki", "graph.json");
+  return join28(vault, ".skillwiki", "graph.json");
 }
 
 // src/mcp/result-format.ts
@@ -6920,7 +7110,7 @@ function formatToolResult(payload) {
 
 // src/mcp/audit-log.ts
 import { appendFileSync, mkdirSync as mkdirSync2 } from "fs";
-import { join as join28 } from "path";
+import { join as join29 } from "path";
 function auditEnabled() {
   const v = process.env.SKILLWIKI_MCP_AUDIT;
   if (v === "0" || v === "false") return false;
@@ -6932,7 +7122,7 @@ function auditSink() {
 function auditFilePath() {
   const custom = process.env.SKILLWIKI_MCP_AUDIT_FILE;
   if (custom && custom.length > 0) return custom;
-  return join28(resolveSkillwikiHome(), ".skillwiki", "mcp-audit.jsonl");
+  return join29(resolveSkillwikiHome(), ".skillwiki", "mcp-audit.jsonl");
 }
 function auditMcpToolCall(entry) {
   if (!auditEnabled()) return;
@@ -6942,7 +7132,7 @@ function auditMcpToolCall(entry) {
     return;
   }
   const path = auditFilePath();
-  mkdirSync2(join28(path, ".."), { recursive: true });
+  mkdirSync2(join29(path, ".."), { recursive: true });
   appendFileSync(path, line, "utf8");
 }
 async function runMcpToolHandler(tool, input, fn) {
@@ -7217,7 +7407,7 @@ function registerMcpMutatingTools(server) {
 
 // src/mcp/resources.ts
 import { readFile as readFile11 } from "fs/promises";
-import { join as join30 } from "path";
+import { join as join31 } from "path";
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/mcp/lint-bucket.ts
@@ -7347,8 +7537,8 @@ async function fetchQueryPreview(input) {
 
 // src/mcp/graph-html.ts
 import { readFile as readFile10 } from "fs/promises";
-import { join as join29 } from "path";
-import { existsSync as existsSync22 } from "fs";
+import { join as join30 } from "path";
+import { existsSync as existsSync23 } from "fs";
 var TYPE_COLORS = {
   entities: "#e74c3c",
   concepts: "#27ae60",
@@ -7416,9 +7606,9 @@ ${nodeSvg}
   return { html, node_count: nodes.length, edge_count: edges.length, truncated };
 }
 async function fetchGraphHtmlReport(input) {
-  const graphPath = input.graphPath ?? join29(input.vault, ".skillwiki", "graph.json");
+  const graphPath = input.graphPath ?? join30(input.vault, ".skillwiki", "graph.json");
   const maxNodes = Math.min(Math.max(10, input.maxNodes ?? 120), 500);
-  if (!existsSync22(graphPath)) {
+  if (!existsSync23(graphPath)) {
     return {
       exitCode: ExitCode.FILE_NOT_FOUND,
       result: err("GRAPH_MISSING", { path: graphPath, hint: "Run skillwiki.graph_build first." })
@@ -7490,7 +7680,7 @@ async function fetchStaleSummary(input) {
 
 // src/mcp/resources.ts
 async function readVaultFile(vault, rel) {
-  return readFile11(join30(vault, rel), "utf8");
+  return readFile11(join31(vault, rel), "utf8");
 }
 async function tailLines(text, lines) {
   const parts = text.split(/\r?\n/);
@@ -7576,7 +7766,7 @@ function registerMcpResources(server) {
       if (!v.ok) {
         return { contents: [{ uri: uri.href, mimeType: "text/plain", text: JSON.stringify(v) }] };
       }
-      const path = join30(v.data.vault, ".skillwiki", "graph.json");
+      const path = join31(v.data.vault, ".skillwiki", "graph.json");
       try {
         const raw = await readFile11(path, "utf8");
         const graph = JSON.parse(raw);