skillwiki 0.10.108 → 0.10.110

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   CAPTURE_HYGIENE_CONTRACT,
+  CLIP_NOT_CONFIGURED,
   DEFAULT_CAPTURE_BUDGET,
   DEFAULT_DIRTY_VOLUME_THRESHOLD,
   DEFAULT_MCP_URL,
@@ -21,6 +22,8 @@ import {
   guardProtectedVaultWrite,
   isEventLedgerPath,
   isFailedRunStatus,
+  loadClipOutboxConfig,
+  mcpAuthFromEnv,
   measureDirtyVolume,
   memoryAuthorityTiersRank,
   mergeMcpAuthIntoEnv,
@@ -62,8 +65,9 @@ import {
   scanConflictMarkerBlocksInText,
   snapshotterHealthChecks,
   upsertIndexEntry,
-  vectorIndexStatus
-} from "./chunk-Z4NCF6K6.js";
+  vectorIndexStatus,
+  withMcpClient
+} from "./chunk-6X6PPQNI.js";
 import {
   normalizeDistTag,
   readCache,
@@ -76,7 +80,7 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-DTTKCCQ4.js";
+} from "./chunk-KX5Y3GSX.js";
 import {
   FLEET_REL_PATH,
   REDACTED_MALFORMED_REFERENCE,
@@ -133,6 +137,7 @@ import {
   resolveFleetHostId,
   resolveInitTimePath,
   resolveRuntimePath,
+  resolveSkillwikiHome,
   resolveWikiS3Remote,
   rewriteRawSourceReferences,
   runAudit,
@@ -168,12 +173,12 @@ import {
   supersedeStaleReviewRequiredJournals,
   taxonomyCommentForPage,
   writeDotenv
-} from "./chunk-PGD3J2GE.js";
+} from "./chunk-QU2CKXM4.js";
 import {
   assertTargetInsideVault,
   atomicWriteText,
   prepareTypedPage
-} from "./chunk-HMHMCPCE.js";
+} from "./chunk-WPJHDRTP.js";
 import {
   applySourceDisposition,
   decodeSourceActionApproval,
@@ -181,7 +186,7 @@ import {
   inventorySources,
   planSourceDisposition,
   runSourcesPending
-} from "./chunk-QU2IXZRN.js";
+} from "./chunk-NA3TZ4JN.js";
 import {
   authorizeRawOperation,
   buildSourceReferenceIndex,
@@ -198,7 +203,7 @@ import {
   resolveExistingRegularFileInsideVault,
   validateLogEvent,
   writeLogEvent
-} from "./chunk-JCDAEZVD.js";
+} from "./chunk-5MV5SSRM.js";
 import {
   ExitCode,
   MetaSchema,
@@ -219,7 +224,7 @@ import {
   scanVault,
   splitFrontmatter,
   vaultIoConcurrency
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-R2DJ7IJ5.js";
 
 // src/cli.ts
 import { join as join45 } from "path";
@@ -1285,7 +1290,7 @@ gitignore: ${gi.written ? "merged" : "unchanged"} (write-gitignore only)`,
     skipEnv ? "env: skipped" : `env: ${envWritten}`,
     input.noGitignore ? "gitignore: skipped" : `gitignore: ${gitignoreWritten ? "written" : "unchanged"}`,
     `web clipper template: ${WEB_CLIPPER_TEMPLATE_REL}`,
-    "web clipper import: open Obsidian Web Clipper Settings and import the JSON in each browser profile"
+    "web clipper import: create ~/Obsidian/clip-outbox (not ~/wiki), import the JSON in each browser profile, select that outbox vault, keep Add to Obsidian"
   ].join("\n");
   if (created.length > 0) {
     appendLastOp(target, {
@@ -3584,6 +3589,30 @@ async function runHealth(input) {
   return { exitCode, result: ok(report) };
 }
 
+// src/commands/clip-outbox.ts
+async function runClipOutboxStatus(home) {
+  const resolved = await loadClipOutboxConfig(home);
+  if (!resolved.ok) {
+    return {
+      exitCode: ExitCode.INVALID_CONFIG_VALUE,
+      result: err("INVALID_CONFIG_VALUE", { message: resolved.message })
+    };
+  }
+  if (!resolved.enabled) {
+    return {
+      exitCode: ExitCode.OK,
+      result: ok({ enabled: false, humanHint: CLIP_NOT_CONFIGURED })
+    };
+  }
+  return {
+    exitCode: ExitCode.OK,
+    result: ok({
+      enabled: true,
+      humanHint: `clip-outbox enabled root=${resolved.config.root} mode=${resolved.config.mode}`
+    })
+  };
+}
+
 // src/commands/connect.ts
 import { chmod, mkdir as mkdir5, readFile as readFile6, stat as stat3 } from "fs/promises";
 import { join as join18 } from "path";
@@ -3671,6 +3700,7 @@ ${formatHostRow(normalizedHash, hostId, granted.vaults)}` };
 }
 
 // src/commands/connect.ts
+import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
 var CONNECT_DESCRIPTION = "HTTP MCP leaf connect: ingest a chat-attached env file into ~/.skillwiki/.env (mode 0600). Never runs skillwiki init. Cloud Drive / \u4E91\u76D8 is unsupported.";
 var RESERVED_HOST_IDS = ["msi", "doubao-linux-agent", "macos-dev"];
 var DEST_MODE = 384;
@@ -3712,44 +3742,16 @@ function redactConnectPayload(data, secret) {
   };
 }
 async function readWikiStatus(fetchFn, url, token) {
-  const headers = {
-    Authorization: `Bearer ${token}`,
-    "Content-Type": "application/json",
-    Accept: "application/json, text/event-stream"
-  };
   try {
-    const initRes = await fetchFn(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        id: 1,
-        method: "initialize",
-        params: {
-          protocolVersion: "2025-11-25",
-          capabilities: {},
-          clientInfo: { name: "skillwiki-connect", version: "0" }
-        }
-      })
-    });
-    const session = initRes.headers.get("mcp-session-id");
-    if (session) headers["mcp-session-id"] = session;
-    const statusRes = await fetchFn(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        id: 2,
-        method: "tools/call",
-        params: { name: "wiki_status", arguments: {} }
-      })
-    });
-    const raw = await statusRes.text();
-    const parsed = JSON.parse(raw.startsWith("data:") ? raw.replace(/^data:\s*/m, "") : raw);
-    const structured = parsed.result?.structuredContent;
-    let body = structured;
+    const result = await withMcpClient(
+      { fetchFn, url, token, clientName: "skillwiki-connect", version: "0" },
+      async (client, signal) => CallToolResultSchema.parse(await client.callTool({ name: "wiki_status", arguments: {} }, void 0, { signal }))
+    );
+    if (result.isError) return { writer_id: null, ok: null, reconcile_ready: null, error: "wiki_status returned a tool error" };
+    let body = result.structuredContent;
     if (!body) {
-      const text = parsed.result?.content?.find((c) => typeof c.text === "string")?.text;
+      const content = result.content.find((item) => item.type === "text");
+      const text = content?.type === "text" ? content.text : void 0;
       if (text) {
         try {
           body = JSON.parse(text);
@@ -3758,17 +3760,26 @@ async function readWikiStatus(fetchFn, url, token) {
         }
       }
     }
-    if (!body) return { writer_id: null, ok: null, reconcile_ready: null };
+    if (!body || typeof body !== "object" || Array.isArray(body) || typeof body.ok !== "boolean" || typeof body.reconcile_ready !== "boolean" || body.writer_id !== void 0 && typeof body.writer_id !== "string") {
+      return { writer_id: null, ok: null, reconcile_ready: null, error: "wiki_status returned an invalid status object" };
+    }
+    if (!body.ok) return { writer_id: null, ok: false, reconcile_ready: body.reconcile_ready, error: "wiki_status reported failure" };
     return {
-      writer_id: typeof body.writer_id === "string" ? body.writer_id : null,
-      ok: typeof body.ok === "boolean" ? body.ok : null,
-      reconcile_ready: typeof body.reconcile_ready === "boolean" ? body.reconcile_ready : null
+      writer_id: body.writer_id ?? null,
+      ok: body.ok,
+      reconcile_ready: body.reconcile_ready
+    };
+  } catch (error) {
+    return {
+      writer_id: null,
+      ok: null,
+      reconcile_ready: null,
+      error: redactMcpSecret(error instanceof Error ? error.message : String(error), token)
     };
-  } catch {
-    return { writer_id: null, ok: null, reconcile_ready: null };
   }
 }
 async function runConnect(input) {
+  input = { ...input, home: resolveSkillwikiHome(input.home, input.env) };
   const dest = join18(input.home, ".skillwiki", ".env");
   const fromFile = input.fromFile?.trim();
   const fromStdin = Boolean(input.fromStdin);
@@ -3878,8 +3889,13 @@ async function runConnect(input) {
     if (doctor.result.ok) {
       handshake = doctor.result.data.checks.find((c) => c.id === "mcp_handshake")?.detail ?? null;
     }
-    const url = incomingUrl ?? DEFAULT_MCP_URL;
-    const status = await readWikiStatus(input.mcpFetch ?? globalThis.fetch, url, incomingToken);
+    const auth = mcpAuthFromEnv(env);
+    const url = auth.url ?? DEFAULT_MCP_URL;
+    const status = await readWikiStatus(input.mcpFetch ?? globalThis.fetch, url, auth.token ?? incomingToken);
+    if (status.error) {
+      doctorExit = ExitCode.DOCTOR_HAS_ERRORS;
+      handshake = `${handshake ?? ""}; wiki_status verification failed \u2014 ${status.error}`;
+    }
     writerId = status.writer_id;
     statusOk = status.ok;
     reconcileReady = status.reconcile_ready;
@@ -4117,7 +4133,7 @@ ${fmRewritten}
   }
   let indexUpdated = false;
   if (!isRaw) {
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-ESBJOBS7.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-6XGESSHV.js");
     const before = await readFile8(join20(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -4240,7 +4256,7 @@ async function runRemove(input) {
   if (relPath.endsWith(".md") && !relPath.startsWith("raw/")) {
     const { readFile: readFile24 } = await import("fs/promises");
     const { join: pathJoin } = await import("path");
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-ESBJOBS7.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-6XGESSHV.js");
     const before = await readFile24(pathJoin(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -6119,7 +6135,6 @@ import {
   unlinkSync,
   writeFileSync as writeFileSync5
 } from "fs";
-import { homedir } from "os";
 import { dirname as dirname6, join as join28 } from "path";
 var PUBLICATION_JOURNAL_SCHEMA = "skillwiki-publication-operation-v1";
 var PHASE_ORDER2 = [
@@ -6148,10 +6163,10 @@ function vaultIdentity(vaultPath) {
   }
   return sha256Hex(real).slice(0, 16);
 }
-function publicationJournalRoot(home = process.env.HOME || homedir()) {
-  return join28(home, ".skillwiki", "publication-operations");
+function publicationJournalRoot(home = resolveSkillwikiHome()) {
+  return join28(resolveSkillwikiHome(home), ".skillwiki", "publication-operations");
 }
-function resolveJournalPaths(vaultPath, operationId2, home = process.env.HOME || homedir()) {
+function resolveJournalPaths(vaultPath, operationId2, home = resolveSkillwikiHome()) {
   const identity = vaultIdentity(vaultPath);
   const rootDir = publicationJournalRoot(home);
   const vaultDir = join28(rootDir, identity);
@@ -6261,7 +6276,7 @@ function buildIdentitySummary(input) {
     prior_target_sha256: input.prior_target_sha256
   };
 }
-function readPublicationJournal(vaultPath, operationId2, home = process.env.HOME || homedir()) {
+function readPublicationJournal(vaultPath, operationId2, home = resolveSkillwikiHome()) {
   const { journalPath: journalPath2 } = resolveJournalPaths(vaultPath, operationId2, home);
   if (!existsSync10(journalPath2)) return ok(null);
   let text;
@@ -6279,7 +6294,7 @@ function readPublicationJournal(vaultPath, operationId2, home = process.env.HOME
   return validateRecord(parsed);
 }
 function createPublicationJournal(input) {
-  const home = input.home ?? process.env.HOME ?? homedir();
+  const home = resolveSkillwikiHome(input.home);
   const paths = resolveJournalPaths(input.vaultPath, input.operationId, home);
   if (existsSync10(paths.journalPath)) {
     return err("WRITE_FAILED", { message: "journal already exists", path: paths.journalPath });
@@ -6306,7 +6321,7 @@ function createPublicationJournal(input) {
   return ok(record);
 }
 function advancePublicationJournal(input) {
-  const home = input.home ?? process.env.HOME ?? homedir();
+  const home = resolveSkillwikiHome(input.home);
   const existing = readPublicationJournal(input.vaultPath, input.operationId, home);
   if (!existing.ok) return existing;
   if (!existing.data) {
@@ -6351,7 +6366,7 @@ function advancePublicationJournal(input) {
   }
   return ok(record);
 }
-function deletePublicationJournal(vaultPath, operationId2, home = process.env.HOME || homedir()) {
+function deletePublicationJournal(vaultPath, operationId2, home = resolveSkillwikiHome()) {
   const { journalPath: journalPath2 } = resolveJournalPaths(vaultPath, operationId2, home);
   if (!existsSync10(journalPath2)) return ok({ deleted: false });
   try {
@@ -6372,7 +6387,7 @@ function completePublicationJournal(input) {
   const deleted = deletePublicationJournal(
     input.vaultPath,
     input.operationId,
-    input.home ?? process.env.HOME ?? homedir()
+    resolveSkillwikiHome(input.home)
   );
   if (!deleted.ok) return deleted;
   return ok({ completed: true });
@@ -8898,7 +8913,7 @@ function refusalErr(code, reason, guidance) {
 }
 async function runSnapshotMaintenanceDryRun(input) {
   const env = input.env ?? process.env;
-  const home = input.home ?? env.HOME ?? "";
+  const home = resolveSkillwikiHome(input.home, env);
   const audit = input.auditSink ?? defaultAuditSink(home);
   const now = input.now ?? Date.now();
   const liveVaultPath = input.liveVaultPath ? canonicalize(input.liveVaultPath) : await resolveLiveVault({ env, home });
@@ -9039,7 +9054,7 @@ function makeAuditEvent(input, hostId, now, result, errorCode, approvalId, comma
 }
 async function runSnapshotMaintenanceExecute(input) {
   const env = input.env ?? process.env;
-  const home = input.home ?? env.HOME ?? "";
+  const home = resolveSkillwikiHome(input.home, env);
   const audit = input.auditSink ?? defaultAuditSink(home);
   const now = input.now ?? Date.now();
   const isTty = input.isTty ?? !!process.stdin.isTTY;
@@ -9174,7 +9189,7 @@ function extraUnmergedPaths(unmerged) {
 }
 async function authorizeRepairContext(input) {
   const env = input.env ?? process.env;
-  const home = input.home ?? env.HOME ?? "";
+  const home = resolveSkillwikiHome(input.home, env);
   const audit = input.auditSink ?? defaultAuditSink(home);
   const now = input.now ?? Date.now();
   const liveVaultPath = input.liveVaultPath ? canonicalize(input.liveVaultPath) : await resolveLiveVault({ env, home });
@@ -9238,7 +9253,7 @@ async function authorizeRepairContext(input) {
 }
 async function runProjectionConflictRepairDryRun(input) {
   const env = input.env ?? process.env;
-  const home = input.home ?? env.HOME ?? "";
+  const home = resolveSkillwikiHome(input.home, env);
   const audit = input.auditSink ?? defaultAuditSink(home);
   const now = input.now ?? Date.now();
   const ctx = await authorizeRepairContext(input);
@@ -9341,7 +9356,7 @@ async function performProjectionRepair(input, plan, audit, now) {
 }
 async function runProjectionConflictRepairExecute(input) {
   const env = input.env ?? process.env;
-  const home = input.home ?? env.HOME ?? "";
+  const home = resolveSkillwikiHome(input.home, env);
   const audit = input.auditSink ?? defaultAuditSink(home);
   const now = input.now ?? Date.now();
   const isTty = input.isTty ?? !!process.stdin.isTTY;
@@ -9772,11 +9787,20 @@ async function measureAuthoritativeLiveDrift(liveVault, projection) {
 
 // src/copy-status/copy-status.ts
 function liveRecord(p) {
+  if (p.writable === false) {
+    return {
+      state: "blocked",
+      reachable: p.reachable,
+      writable: false,
+      blocked_reason: "s3_write_probe_failed",
+      detail: p.detail ?? "S3 write probe failed"
+    };
+  }
   if (p.unknown || p.reachable === void 0) {
     return { state: "unknown", reachable: p.reachable, detail: p.detail ?? "S3/MCP unmeasured" };
   }
   if (p.reachable) {
-    return { state: "ok", reachable: true, detail: p.detail ?? "S3 reachable" };
+    return { state: "ok", reachable: true, ...p.writable === true ? { writable: true } : {}, detail: p.detail ?? "S3 reachable" };
   }
   return { state: "unknown", reachable: false, detail: p.detail ?? "S3 unreachable" };
 }
@@ -9948,6 +9972,14 @@ function defaultCopyStatusDeps(input) {
   };
   return {
     probeLive() {
+      if (input.s3Writable === false) {
+        return {
+          reachable: input.s3Ok,
+          writable: false,
+          detail: `MCP S3 write probe failed${input.s3WritableError ? ` (${input.s3WritableError})` : ""}`
+        };
+      }
+      if (input.s3Ok === true && input.s3Writable === true) return { reachable: true, writable: true, detail: "MCP S3 readable and writable" };
       if (input.s3Ok === true) return { reachable: true, detail: "MCP S3 ok" };
       if (input.s3Ok === false) return { reachable: false, detail: "MCP S3 not ok" };
       const remote = resolveWikiS3Remote({ home: input.home });
@@ -10869,7 +10901,7 @@ function rowHealthy(reachable, timer, runUnhealthy, timerBad, platform3) {
 async function runFleetHealth(input) {
   const deps = input.deps ?? defaultDeps3();
   const env = input.env ?? process.env;
-  const home = input.home ?? env.HOME ?? "";
+  const home = resolveSkillwikiHome(input.home, env);
   const osHostname = input.osHostname ?? env.HOSTNAME ?? nodeHostname();
   const vault = input.vault ?? env.WIKI_PATH;
   const file = input.file ?? (vault ? join43(vault, FLEET_REL_PATH) : void 0);
@@ -10974,7 +11006,7 @@ function isValidLastOpPath(file) {
 }
 async function postCommit(vault, exitCode) {
   if (exitCode !== 0) return;
-  const home = process.env.HOME ?? "";
+  const home = resolveSkillwikiHome();
   const dotenv = await parseDotenvFile(configPath(home));
   const autoCommit = process.env.AUTO_COMMIT ?? dotenv["AUTO_COMMIT"];
   if (autoCommit === "false") return;
@@ -11192,7 +11224,7 @@ async function emitGuardedVaultWrite(vault, command, run, opts) {
     vault,
     command,
     env: process.env,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     cwd: process.cwd(),
     osHostname: process.env.HOSTNAME,
     user: process.env.USER
@@ -11211,7 +11243,7 @@ async function emitManagedVaultWrite(vault, command, mutate, opts) {
     vault,
     command,
     env: process.env,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     cwd: process.cwd(),
     osHostname: process.env.HOSTNAME,
     user: process.env.USER
@@ -11223,14 +11255,14 @@ async function emitManagedVaultWrite(vault, command, mutate, opts) {
   if (dirty) {
     return emit(dirty, void 0, { postCommit: false });
   }
-  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-AYD3CJYD.js");
+  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-JPOBVVSU.js");
   const run = await runManagedWriteTransaction2({
     vault,
     command,
     allowImmutableRecord: opts?.allowImmutableRecord === true,
     convergenceVault: opts?.convergenceVault,
     env: process.env,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     cwd: process.cwd(),
     osHostname: process.env.HOSTNAME,
     user: process.env.USER,
@@ -11476,14 +11508,14 @@ sourcesCmd.command("dispose <raw-path> [vault]").description("permanently delete
 program.command("orphans [vault]").description("find pages not referenced by any other page").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => emit(await runOrphans({
   vault,
   envValue: process.env.WIKI_PATH,
-  home: process.env.HOME ?? "",
+  home: resolveSkillwikiHome(),
   wiki: opts.wiki,
   cwd: process.cwd()
 })));
 program.command("audit <file>").description("audit citation markers and source provenance for a vault page").action(async (file) => emit(await runAudit({ file })));
-program.command("install").description("install skillwiki SKILL.md files into ~/.claude/skills/").option("--target <dir>", "target install directory", `${process.env.HOME ?? ""}/.claude/skills/`).option("--dry-run", "preview only", false).option("--skills-root <dir>", "source skills directory (defaults to packaged)").option("--symlink", "create symlinks instead of copies (dev mode \u2014 edits to source are immediately visible)", false).option("--force", "install CLI copies even when the skillwiki@llm-wiki plugin channel is active", false).action(async (opts) => {
+program.command("install").description("install skillwiki SKILL.md files into ~/.claude/skills/").option("--target <dir>", "target install directory", `${resolveSkillwikiHome()}/.claude/skills/`).option("--dry-run", "preview only", false).option("--skills-root <dir>", "source skills directory (defaults to packaged)").option("--symlink", "create symlinks instead of copies (dev mode \u2014 edits to source are immediately visible)", false).option("--force", "install CLI copies even when the skillwiki@llm-wiki plugin channel is active", false).action(async (opts) => {
   const skillsRoot = opts.skillsRoot ?? new URL("../skills/", import.meta.url).pathname;
-  emit(await runInstall({ skillsRoot, target: opts.target, dryRun: !!opts.dryRun, symlink: !!opts.symlink, home: process.env.HOME ?? "", force: !!opts.force }));
+  emit(await runInstall({ skillsRoot, target: opts.target, dryRun: !!opts.dryRun, symlink: !!opts.symlink, home: resolveSkillwikiHome(), force: !!opts.force }));
 });
 program.command("path").description("show the resolved vault path").option("--vault <dir>", "explicit vault override (runtime)").option("--target <dir>", "explicit target override (init-time)").option("--wiki <name>", "wiki profile name").option("--init-time", "use init-time chain instead of runtime", false).option("--explain", "include resolution chain in output", false).option("--plain", "print only the vault path (no JSON wrapper)", false).action(async (opts) => {
   const initTime = !!opts.initTime;
@@ -11491,7 +11523,7 @@ program.command("path").description("show the resolved vault path").option("--va
   const r = await runPath({
     flag,
     envValue: process.env.WIKI_PATH,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     initTime,
     wiki: opts.wiki,
     cwd: process.cwd(),
@@ -11509,7 +11541,7 @@ program.command("lang").description("get or set the vault language").option("--l
   emit(await runLang({
     flag: opts.lang,
     envValue: process.env.WIKI_LANG,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     explain: !!opts.explain
   }));
 });
@@ -11519,7 +11551,7 @@ program.command("init").description("bootstrap a new vault with SCHEMA.md, index
   emit(await runInit({
     flag: opts.target,
     envValue: process.env.WIKI_PATH,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     templates,
     domain: opts.domain,
     taxonomy,
@@ -11537,7 +11569,7 @@ async function resolveVaultArg(arg, wiki) {
     flag: void 0,
     envValue: process.env.WIKI_PATH,
     wikiEnv: process.env.WIKI,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     wiki,
     cwd: process.cwd()
   });
@@ -11841,7 +11873,7 @@ program.command("health [vault]").description("bounded whole-system wiki health
   else emit(await runHealth({
     vault: v.vault,
     vaultSource: vault ? "flag" : "resolved",
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     envValue: process.env.WIKI_PATH,
     argv: process.argv,
     currentVersion: pkg.version,
@@ -11853,12 +11885,12 @@ program.command("health [vault]").description("bounded whole-system wiki health
   }), void 0, { postCommit: false, humanDetailHints: healthLintDetailHints });
 });
 var configCmd = program.command("config").description("manage skillwiki configuration");
-configCmd.command("get <key>").description("print the value of a config key").action(async (key) => emit(await runConfigGet({ key, home: process.env.HOME ?? "" })));
-configCmd.command("set <key> <value>").description("set a config key value").action(async (key, value) => emit(await runConfigSet({ key, value, home: process.env.HOME ?? "" })));
-configCmd.command("list").option("--profiles", "show wiki profiles summary", false).description("list all config key=value pairs").action(async (opts) => emit(await runConfigList({ home: process.env.HOME ?? "", profiles: !!opts.profiles })));
-configCmd.command("path").description("print the config file path").action(async () => emit(await runConfigPath({ home: process.env.HOME ?? "" })));
+configCmd.command("get <key>").description("print the value of a config key").action(async (key) => emit(await runConfigGet({ key, home: resolveSkillwikiHome() })));
+configCmd.command("set <key> <value>").description("set a config key value").action(async (key, value) => emit(await runConfigSet({ key, value, home: resolveSkillwikiHome() })));
+configCmd.command("list").option("--profiles", "show wiki profiles summary", false).description("list all config key=value pairs").action(async (opts) => emit(await runConfigList({ home: resolveSkillwikiHome(), profiles: !!opts.profiles })));
+configCmd.command("path").description("print the config file path").action(async () => emit(await runConfigPath({ home: resolveSkillwikiHome() })));
 program.command("doctor").description("diagnose skillwiki setup issues").option("--check-snapshotter", "SSH-probe fleet snapshotter (short timeout)", false).option("--check-mcp", "live-handshake HTTP MCP initialize + tools/list (network)", false).action(async (opts) => emit(await runDoctor({
-  home: process.env.HOME ?? "",
+  home: resolveSkillwikiHome(),
   envValue: process.env.WIKI_PATH,
   argv: process.argv,
   currentVersion: pkg.version,
@@ -11867,8 +11899,10 @@ program.command("doctor").description("diagnose skillwiki setup issues").option(
   checkMcp: !!opts.checkMcp,
   env: process.env
 })));
+var clipOutboxCmd = program.command("clip-outbox").description("dedicated file-level web-clip outbox");
+clipOutboxCmd.command("status").description("show whether the clip-outbox channel is configured").action(async () => emit(await runClipOutboxStatus(resolveSkillwikiHome())));
 program.command("connect").description(CONNECT_DESCRIPTION).option("--from-file <path>", "chat-attached env file (not Drive / \u4E91\u76D8)").option("--from-stdin", "read env file from stdin (no echo)").option("--dry-run", "validate without writing ~/.skillwiki/.env").option("--force", "overwrite a different existing token").action(async (opts) => emit(await runConnect({
-  home: process.env.HOME ?? "",
+  home: resolveSkillwikiHome(),
   fromFile: opts.fromFile,
   fromStdin: !!opts.fromStdin,
   dryRun: !!opts.dryRun,
@@ -11882,7 +11916,7 @@ program.command("status [vault]").description("output vault diagnostics").option
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runStatus({
     vault: v.vault,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     langEnvValue: process.env.WIKI_LANG
   }), v.vault);
 });
@@ -11891,7 +11925,7 @@ program.command("copy-status [vault]").description("plane-tagged vault freshness
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runCopyStatusCommand({
     vault: v.vault,
-    home: process.env.HOME ?? ""
+    home: resolveSkillwikiHome()
   }), v.vault, { postCommit: false });
 });
 program.command("archive <page> [vault]").description("archive a typed-knowledge or raw page").option("--wiki <name>", "wiki profile name").option("--cascade", "scan vault for references (wikilinks + sources arrays); preview by default", false).option("--apply", "with --cascade: mutate sources arrays and archive (without --apply, --cascade is preview-only)", false).option("--approve <token>", "approve an exact state-bound raw archive plan").option("--remote <remote>", "rclone remote root to prune the archived source path, for example seaweed-wiki:cloud/wiki").option("--remote-delete", "delete the archived source path from the remote after local archive", false).option("--max-remote-deletes <n>", "maximum remote object deletes allowed", "1").action(async (page, vault, opts) => {
@@ -11998,11 +12032,11 @@ program.command("frontmatter-fix [vault]").description("fix common frontmatter i
   );
 });
 program.command("update").description("update skillwiki CLI from npm dist-tag").option("--tag <tag>", "npm dist-tag", "latest").action(async (opts) => emit(await runUpdate({
-  home: process.env.HOME ?? "",
+  home: resolveSkillwikiHome(),
   distTag: opts.tag
 })));
 program.command("self-update").description("update skillwiki CLI from local source or npm dist-tag").option("--check", "check for updates without installing", false).option("--tag <tag>", "npm dist-tag", "latest").action(async (opts) => emit(await runSelfUpdate({
-  home: process.env.HOME ?? "",
+  home: resolveSkillwikiHome(),
   check: !!opts.check,
   distTag: opts.tag
 })));
@@ -12071,7 +12105,7 @@ syncCmd.command("status [vault]").description("check vault git sync status").opt
   const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else {
-    const home = process.env.HOME ?? "";
+    const home = resolveSkillwikiHome();
     let snapshotterAlias;
     if (opts.checkSnapshotter) {
       const fleetLoad = await loadFleetManifestAndHost({
@@ -12205,7 +12239,7 @@ backupCmd.command("sync [vault]").description("sync vault to S3-compatible remot
     emit({ exitCode: v.exitCode, result: v.payload });
     return;
   }
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
+  const home = resolveSkillwikiHome();
   const dotenv = await parseDotenvFile(configPath(home));
   emit(await runBackupSync({
     vault: v.vault,
@@ -12224,7 +12258,7 @@ backupCmd.command("restore [vault]").description("restore vault from S3-compatib
     emit({ exitCode: v.exitCode, result: v.payload });
     return;
   }
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
+  const home = resolveSkillwikiHome();
   const dotenv = await parseDotenvFile(configPath(home));
   return emitGuardedVaultWrite(
     v.vault,
@@ -12403,7 +12437,7 @@ fleetCmd.command("context [vault]").description("render compact Runtime Host Con
     file: opts.file,
     hostId: opts.hostId,
     env: process.env,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     cwd: process.cwd(),
     osHostname: process.env.HOSTNAME,
     user: process.env.USER
@@ -12416,7 +12450,7 @@ fleetCmd.command("health [vault]").description("read-only health probe for skill
     hostId: opts.hostId,
     json: !!opts.json,
     env: process.env,
-    home: process.env.HOME ?? "",
+    home: resolveSkillwikiHome(),
     cwd: process.cwd(),
     osHostname: process.env.HOSTNAME,
     user: process.env.USER
@@ -12481,10 +12515,10 @@ mcpAuthCmd.command("issue-host").description("append a host-id hash to the metal
     allowedVaults
   }));
 });
-for (const w of getDeprecatedWarnings(process.env.HOME ?? "")) {
+for (const w of getDeprecatedWarnings(resolveSkillwikiHome())) {
   process.stderr.write(w + "\n");
 }
-triggerAutoUpdate(process.env.HOME ?? "", pkg.version);
+triggerAutoUpdate(resolveSkillwikiHome(), pkg.version);
 program.parseAsync(process.argv).catch((e) => {
   process.stdout.write(JSON.stringify({ ok: false, error: "INTERNAL", detail: { message: String(e) } }) + "\n");
   process.exit(ExitCode.INTERNAL_ERROR);

package/dist/{index-projection-ESBJOBS7.js → index-projection-6XGESSHV.js}

@@ -4,9 +4,9 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-DTTKCCQ4.js";
-import "./chunk-HMHMCPCE.js";
-import "./chunk-GJC2CI3W.js";
+} from "./chunk-KX5Y3GSX.js";
+import "./chunk-WPJHDRTP.js";
+import "./chunk-R2DJ7IJ5.js";
 export {
   UNMANAGED_END,
   UNMANAGED_START,

package/dist/{managed-write-preflight-AYD3CJYD.js → managed-write-preflight-JPOBVVSU.js}

@@ -6,10 +6,10 @@ import {
   runManagedWritePeerGate,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-PGD3J2GE.js";
-import "./chunk-HMHMCPCE.js";
-import "./chunk-JCDAEZVD.js";
-import "./chunk-GJC2CI3W.js";
+} from "./chunk-QU2CKXM4.js";
+import "./chunk-WPJHDRTP.js";
+import "./chunk-5MV5SSRM.js";
+import "./chunk-R2DJ7IJ5.js";
 export {
   DEFAULT_MANAGED_WRITE_WAIT_MS,
   MANAGED_WRITE_POLL_INTERVAL_MS,