skillwiki 0.10.109 → 0.10.110

package/dist/{chunk-DTTKCCQ4.js → chunk-KX5Y3GSX.js}

@@ -3,11 +3,11 @@ import {
   ROOT_INDEX_SECTION_ORDER,
   atomicWriteText,
   buildRootIndexUniverse
-} from "./chunk-HMHMCPCE.js";
+} from "./chunk-WPJHDRTP.js";
 import {
   err,
   ok
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-R2DJ7IJ5.js";
 
 // src/utils/index-projection.ts
 import { readFile } from "fs/promises";

package/dist/{chunk-QU2IXZRN.js → chunk-NA3TZ4JN.js}

@@ -8,7 +8,7 @@ import {
   readLogEvents,
   resolveExistingRegularFileInsideVault,
   writeLogEvent
-} from "./chunk-JCDAEZVD.js";
+} from "./chunk-5MV5SSRM.js";
 import {
   ExitCode,
   RawSourceSchema,
@@ -19,7 +19,7 @@ import {
   scanSensitiveContent,
   scanVault,
   splitFrontmatter
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-R2DJ7IJ5.js";
 
 // src/commands/sources.ts
 import { readFile as readFile4 } from "fs/promises";

package/dist/{chunk-FYAKMULW.js → chunk-QU2CKXM4.js}

@@ -2,7 +2,7 @@
 import {
   atomicWriteText,
   buildRootIndexUniverse
-} from "./chunk-HMHMCPCE.js";
+} from "./chunk-WPJHDRTP.js";
 import {
   authorizeRawOperation,
   buildSourceReferenceIndex,
@@ -22,7 +22,7 @@ import {
   resolveExistingRegularFileInsideVault,
   stripFencedBlocks,
   writeLogEvent
-} from "./chunk-JCDAEZVD.js";
+} from "./chunk-5MV5SSRM.js";
 import {
   ExitCode,
   FleetManifestSchema,
@@ -30,6 +30,7 @@ import {
   extractFrontmatter,
   filterGitIgnoredRelativePaths,
   getErrorMessage,
+  isClipOutboxKey,
   isVaultSyncKey,
   mapWithConcurrency,
   ok,
@@ -41,7 +42,7 @@ import {
   scanVault,
   splitFrontmatter,
   vaultIoConcurrency
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-R2DJ7IJ5.js";
 
 // src/utils/home.ts
 import { homedir } from "os";
@@ -104,7 +105,7 @@ function parseDotenvText(text) {
     if (eq <= 0) continue;
     const key = line.slice(0, eq).trim();
     const value = line.slice(eq + 1).trim();
-    if (!_whitelist.has(key) && !isValidWikiProfileKey(key) && !isVaultSyncKey(key)) continue;
+    if (!_whitelist.has(key) && !isValidWikiProfileKey(key) && !isVaultSyncKey(key) && !isClipOutboxKey(key)) continue;
     if (value.length === 0) continue;
     out[key] = value;
   }

package/dist/{chunk-GJC2CI3W.js → chunk-R2DJ7IJ5.js}

@@ -419,6 +419,106 @@ function parseVaultSyncKeyValue(key, value) {
   const first = parsed.error.issues[0];
   return { ok: false, message: first?.message ?? "invalid value" };
 }
+var clipBool = z.enum(["true", "false"]);
+var clipIntString = (min, max) => z.string().regex(/^[0-9]+$/, "must be a decimal integer").refine((s) => {
+  const n = Number(s);
+  return Number.isInteger(n) && n >= min && n <= max;
+}, { message: `must be an integer ${min}\u2013${max}` });
+var clipHttpsUrl = z.string().min(1).refine((s) => {
+  try {
+    const u = new URL(s);
+    return u.protocol === "https:" && u.username === "" && u.password === "";
+  } catch {
+    return false;
+  }
+}, { message: "must be an https URL without userinfo" });
+var clipCredentialRef = z.string().min(1).max(128).regex(
+  /^[a-zA-Z0-9_.-]+$/,
+  "must be a credential reference name, never a secret value"
+);
+var CLIP_IMAGE_TYPES = ["png", "jpeg", "gif", "webp"];
+var CLIP_ALLOWED_PREFIXES = "raw/articles,raw/assets";
+var CLIP_OUTBOX_DEFAULTS = {
+  enabled: "false",
+  vault_id: "central",
+  allowed_prefixes: CLIP_ALLOWED_PREFIXES,
+  destination: "seaweed-wiki:cloud/wiki",
+  mode: "event-watch",
+  poll_fallback_enabled: "true",
+  reconcile_seconds: "3600",
+  debounce_ms: "500",
+  stable_hash_ms: "500",
+  max_article_bytes: "2097152",
+  max_images: "64",
+  max_image_bytes: "20971520",
+  max_bundle_bytes: "104857600",
+  max_pixels: "40000000",
+  download_concurrency: "4",
+  image_types: CLIP_IMAGE_TYPES.join(","),
+  max_redirects: "5",
+  request_timeout_ms: "30000",
+  localize_timeout_ms: "120000",
+  watcher_label: "com.karlchow.skillwiki-clip-outbox"
+};
+var ClipOutboxConfigSchema = z.object({
+  "clip_outbox.enabled": clipBool,
+  "clip_outbox.root": absolutePath,
+  "clip_outbox.state_root": absolutePath,
+  "clip_outbox.mirror_root": absolutePath,
+  "clip_outbox.d8_note_root": absolutePath,
+  "clip_outbox.d8_note_absent": clipBool,
+  "clip_outbox.vault_id": z.literal("central"),
+  "clip_outbox.allowed_prefixes": z.string().refine((s) => {
+    const parts = s.split(",").map((p) => p.trim()).filter(Boolean).sort();
+    return parts.join(",") === "raw/articles,raw/assets";
+  }, { message: "must be exactly raw/articles,raw/assets" }),
+  "clip_outbox.destination": z.literal("seaweed-wiki:cloud/wiki"),
+  "clip_outbox.mode": z.literal("event-watch"),
+  "clip_outbox.poll_fallback_enabled": clipBool,
+  "clip_outbox.reconcile_seconds": clipIntString(1, 86400),
+  "clip_outbox.debounce_ms": clipIntString(100, 5e3),
+  "clip_outbox.stable_hash_ms": clipIntString(100, 5e3),
+  "clip_outbox.max_article_bytes": clipIntString(1, 2097152),
+  "clip_outbox.max_images": clipIntString(0, 64),
+  "clip_outbox.max_image_bytes": clipIntString(1, 20971520),
+  "clip_outbox.max_bundle_bytes": clipIntString(1, 104857600),
+  "clip_outbox.max_pixels": clipIntString(1, 4e7),
+  "clip_outbox.download_concurrency": clipIntString(1, 4),
+  "clip_outbox.image_types": z.string().refine((s) => {
+    const parts = s.split(",").map((p) => p.trim()).filter(Boolean);
+    if (parts.length === 0) return false;
+    const allowed = new Set(CLIP_IMAGE_TYPES);
+    const seen = /* @__PURE__ */ new Set();
+    for (const p of parts) {
+      if (!allowed.has(p) || seen.has(p)) return false;
+      seen.add(p);
+    }
+    return true;
+  }, { message: "must be a unique subset of png,jpeg,gif,webp" }),
+  "clip_outbox.max_redirects": clipIntString(0, 5),
+  "clip_outbox.request_timeout_ms": clipIntString(1, 3e4),
+  "clip_outbox.localize_timeout_ms": clipIntString(1, 12e4),
+  "clip_outbox.ready_url": clipHttpsUrl,
+  "clip_outbox.s3_credential_ref": clipCredentialRef,
+  "clip_outbox.ready_credential_ref": clipCredentialRef,
+  "clip_outbox.watcher_label": z.literal("com.karlchow.skillwiki-clip-outbox")
+}).strict();
+var CLIP_OUTBOX_KEYS = Object.keys(ClipOutboxConfigSchema.shape);
+function isClipOutboxKey(key) {
+  return CLIP_OUTBOX_KEYS.includes(key);
+}
+function parseClipOutboxKeyValue(key, value) {
+  if (!isClipOutboxKey(key)) {
+    return { ok: false, message: `unknown clip_outbox key: ${key}` };
+  }
+  const fieldSchema = ClipOutboxConfigSchema.shape[key];
+  const parsed = fieldSchema.safeParse(value);
+  if (parsed.success) {
+    return { ok: true };
+  }
+  const first = parsed.error.issues[0];
+  return { ok: false, message: first?.message ?? "invalid value" };
+}
 function detectSchema(fm) {
   const COMPOUND_TYPES = /* @__PURE__ */ new Set(["lesson", "pattern", "antipattern", "gotcha"]);
   if (typeof fm.type === "string" && COMPOUND_TYPES.has(fm.type) && "project" in fm) return { schema: "compound" };
@@ -834,6 +934,9 @@ export {
   FleetManifestSchema,
   isVaultSyncKey,
   parseVaultSyncKeyValue,
+  CLIP_OUTBOX_DEFAULTS,
+  isClipOutboxKey,
+  parseClipOutboxKeyValue,
   detectSchema,
   isBlockedHost,
   getErrorMessage,

package/dist/{chunk-HMHMCPCE.js → chunk-WPJHDRTP.js}

@@ -8,7 +8,7 @@ import {
   ok,
   scanSensitiveContent,
   scanVault
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-R2DJ7IJ5.js";
 
 // src/utils/atomic-write.ts
 import { randomBytes } from "crypto";

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,7 @@ import {
   guardProtectedVaultWrite,
   isEventLedgerPath,
   isFailedRunStatus,
+  loadClipOutboxConfig,
   mcpAuthFromEnv,
   measureDirtyVolume,
   memoryAuthorityTiersRank,
@@ -65,7 +67,7 @@ import {
   upsertIndexEntry,
   vectorIndexStatus,
   withMcpClient
-} from "./chunk-LDEZQXH6.js";
+} from "./chunk-6X6PPQNI.js";
 import {
   normalizeDistTag,
   readCache,
@@ -78,7 +80,7 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-DTTKCCQ4.js";
+} from "./chunk-KX5Y3GSX.js";
 import {
   FLEET_REL_PATH,
   REDACTED_MALFORMED_REFERENCE,
@@ -171,12 +173,12 @@ import {
   supersedeStaleReviewRequiredJournals,
   taxonomyCommentForPage,
   writeDotenv
-} from "./chunk-FYAKMULW.js";
+} from "./chunk-QU2CKXM4.js";
 import {
   assertTargetInsideVault,
   atomicWriteText,
   prepareTypedPage
-} from "./chunk-HMHMCPCE.js";
+} from "./chunk-WPJHDRTP.js";
 import {
   applySourceDisposition,
   decodeSourceActionApproval,
@@ -184,7 +186,7 @@ import {
   inventorySources,
   planSourceDisposition,
   runSourcesPending
-} from "./chunk-QU2IXZRN.js";
+} from "./chunk-NA3TZ4JN.js";
 import {
   authorizeRawOperation,
   buildSourceReferenceIndex,
@@ -201,7 +203,7 @@ import {
   resolveExistingRegularFileInsideVault,
   validateLogEvent,
   writeLogEvent
-} from "./chunk-JCDAEZVD.js";
+} from "./chunk-5MV5SSRM.js";
 import {
   ExitCode,
   MetaSchema,
@@ -222,7 +224,7 @@ import {
   scanVault,
   splitFrontmatter,
   vaultIoConcurrency
-} from "./chunk-GJC2CI3W.js";
+} from "./chunk-R2DJ7IJ5.js";
 
 // src/cli.ts
 import { join as join45 } from "path";
@@ -1288,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, {
@@ -3587,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";
@@ -4107,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;
@@ -4230,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;
@@ -9761,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" };
 }
@@ -9937,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 });
@@ -11212,7 +11255,7 @@ async function emitManagedVaultWrite(vault, command, mutate, opts) {
   if (dirty) {
     return emit(dirty, void 0, { postCommit: false });
   }
-  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-MAIGWFQJ.js");
+  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-JPOBVVSU.js");
   const run = await runManagedWriteTransaction2({
     vault,
     command,
@@ -11856,6 +11899,8 @@ 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: resolveSkillwikiHome(),
   fromFile: opts.fromFile,

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-MAIGWFQJ.js → managed-write-preflight-JPOBVVSU.js}

@@ -6,10 +6,10 @@ import {
   runManagedWritePeerGate,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-FYAKMULW.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,

package/dist/skillwiki-mcp.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-LDEZQXH6.js";
+} from "./chunk-6X6PPQNI.js";
 import "./chunk-7I2TPIV5.js";
-import "./chunk-DTTKCCQ4.js";
-import "./chunk-FYAKMULW.js";
-import "./chunk-HMHMCPCE.js";
-import "./chunk-QU2IXZRN.js";
-import "./chunk-JCDAEZVD.js";
-import "./chunk-GJC2CI3W.js";
+import "./chunk-KX5Y3GSX.js";
+import "./chunk-QU2CKXM4.js";
+import "./chunk-WPJHDRTP.js";
+import "./chunk-NA3TZ4JN.js";
+import "./chunk-5MV5SSRM.js";
+import "./chunk-R2DJ7IJ5.js";
 
 // src/mcp-entry.ts
 runSkillwikiMcpStdio().catch((error) => {

package/dist/sources-CLOF5VAT.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  runSourcesPending
+} from "./chunk-NA3TZ4JN.js";
+import "./chunk-5MV5SSRM.js";
+import "./chunk-R2DJ7IJ5.js";
+export {
+  runSourcesPending
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.109",
+  "version": "0.10.110",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js",

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.109",
+  "version": "0.10.110",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 22 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp, skillwiki-connect) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.109",
+  "version": "0.10.110",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 22 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.109",
+  "version": "0.10.110",
   "description": "Project-aware Karpathy-style knowledge base: 22 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp, skillwiki-connect) backed by HTTP MCP wiki_capture.",
   "author": {
     "name": "karlorz"

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.10.109",
+  "version": "0.10.110",
   "private": true,
   "files": [
     "wiki-*",

package/skills/skills/using-skillwiki/SKILL.md

@@ -183,7 +183,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 ## Skill Map
 | Skill | When to Invoke |
 |-------|----------------|
-| `wiki-init` | Bootstrap a vault and install `_Templates/web-clipper/llm-wiki-clippings.json` plus import guidance |
+| `wiki-init` | Bootstrap a vault and install `_Templates/web-clipper/llm-wiki-clippings.json` plus import guidance. File-level clips use a dedicated `~/Obsidian/clip-outbox` vault, not `~/wiki`; `skillwiki doctor` reports clip-channel rows; `wiki_capture` is not clip ingress. |
 | `wiki-ingest` | Convert URLs, files, or pasted text into typed-knowledge pages |
 | `wiki-query` | Search typed knowledge by default; work-queue / doctor / MCP diagnose questions use `wiki_context` or `--scope work` / `--scope all`; explicitly requested fresh/raw evidence uses the separate pending channel |
 | `wiki-lint` | Vault health and lint checks; use `health` for whole-system reports and `lint --summary` for bounded lint buckets |

package/skills/skills/wiki-init/SKILL.md

@@ -29,17 +29,18 @@ None for the first run.
    `skillwiki init --target <dir> --domain existing --write-gitignore`.
 6. Report the installed Web Clipper assets at
    `_Templates/web-clipper/llm-wiki-clippings.json` and
-   `_Templates/web-clipper/readme.txt`. Tell the user to open Obsidian Web
-   Clipper Settings, import the JSON, and repeat the import for every browser
-   profile that should capture into the vault. Re-init preserves existing
-   customized copies, including short files.
-7. Explain that the generic template preserves `{{content}}`; remote HTTP(S)
-   images remain external dependencies. An attended local-asset capture may
-   choose any URL-friendly path under `raw/assets/`, but it must write the asset,
-   emit an explicit vault-qualified `![[raw/assets/...]]` embed, verify
-   resolution/preview, and only then finalize the immutable raw note. Also write
-   a sibling Markdown note (`listings.md`, `note.md`, or a dated `.md`) that
-   embeds each file. Never use `.txt` as the only index.
+   `_Templates/web-clipper/readme.txt`. For the file-level clip channel, create
+   or select the dedicated Obsidian vault `~/Obsidian/clip-outbox` (never
+   `~/wiki`), with `raw/articles` and `raw/assets`, attachment folder
+   `raw/assets`. Tell the user to open Obsidian Web Clipper Settings, import the
+   JSON, select that outbox vault, keep **Add to Obsidian**, and repeat the
+   import for every browser profile. Re-init preserves existing customized
+   copies, including short files. A new package version never silently updates
+   browser extension storage.
+7. Explain that the generic template preserves `{{content}}`. The clip-outbox
+   worker localizes required v1 HTTPS images before freeze, writes
+   `![[raw/assets/...]]` embeds, and uploads `raw/assets/<capture-id>/note.md`.
+   `wiki_capture` is not clip ingress. Never use `.txt` as the only index.
 8. **Suggest first sources.** Propose 3–5 initial sources (URLs, papers, articles) appropriate to the domain. Prompt the user to provide the first one to ingest, then hand off to wiki-ingest.
 
 ## Stop conditions

package/skills/using-skillwiki/SKILL.md

@@ -183,7 +183,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 ## Skill Map
 | Skill | When to Invoke |
 |-------|----------------|
-| `wiki-init` | Bootstrap a vault and install `_Templates/web-clipper/llm-wiki-clippings.json` plus import guidance |
+| `wiki-init` | Bootstrap a vault and install `_Templates/web-clipper/llm-wiki-clippings.json` plus import guidance. File-level clips use a dedicated `~/Obsidian/clip-outbox` vault, not `~/wiki`; `skillwiki doctor` reports clip-channel rows; `wiki_capture` is not clip ingress. |
 | `wiki-ingest` | Convert URLs, files, or pasted text into typed-knowledge pages |
 | `wiki-query` | Search typed knowledge by default; work-queue / doctor / MCP diagnose questions use `wiki_context` or `--scope work` / `--scope all`; explicitly requested fresh/raw evidence uses the separate pending channel |
 | `wiki-lint` | Vault health and lint checks; use `health` for whole-system reports and `lint --summary` for bounded lint buckets |

package/skills/wiki-init/SKILL.md

@@ -29,17 +29,18 @@ None for the first run.
    `skillwiki init --target <dir> --domain existing --write-gitignore`.
 6. Report the installed Web Clipper assets at
    `_Templates/web-clipper/llm-wiki-clippings.json` and
-   `_Templates/web-clipper/readme.txt`. Tell the user to open Obsidian Web
-   Clipper Settings, import the JSON, and repeat the import for every browser
-   profile that should capture into the vault. Re-init preserves existing
-   customized copies, including short files.
-7. Explain that the generic template preserves `{{content}}`; remote HTTP(S)
-   images remain external dependencies. An attended local-asset capture may
-   choose any URL-friendly path under `raw/assets/`, but it must write the asset,
-   emit an explicit vault-qualified `![[raw/assets/...]]` embed, verify
-   resolution/preview, and only then finalize the immutable raw note. Also write
-   a sibling Markdown note (`listings.md`, `note.md`, or a dated `.md`) that
-   embeds each file. Never use `.txt` as the only index.
+   `_Templates/web-clipper/readme.txt`. For the file-level clip channel, create
+   or select the dedicated Obsidian vault `~/Obsidian/clip-outbox` (never
+   `~/wiki`), with `raw/articles` and `raw/assets`, attachment folder
+   `raw/assets`. Tell the user to open Obsidian Web Clipper Settings, import the
+   JSON, select that outbox vault, keep **Add to Obsidian**, and repeat the
+   import for every browser profile. Re-init preserves existing customized
+   copies, including short files. A new package version never silently updates
+   browser extension storage.
+7. Explain that the generic template preserves `{{content}}`. The clip-outbox
+   worker localizes required v1 HTTPS images before freeze, writes
+   `![[raw/assets/...]]` embeds, and uploads `raw/assets/<capture-id>/note.md`.
+   `wiki_capture` is not clip ingress. Never use `.txt` as the only index.
 8. **Suggest first sources.** Propose 3–5 initial sources (URLs, papers, articles) appropriate to the domain. Prompt the user to provide the first one to ingest, then hand off to wiki-ingest.
 
 ## Stop conditions

package/templates/launchd/com.karlchow.skillwiki-clip-outbox.plist

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.karlchow.skillwiki-clip-outbox</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/skillwiki</string>
+    <string>clip-outbox</string>
+    <string>watch</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>WatchPaths</key>
+  <array>
+    <string>/Users/REPLACE/Obsidian/clip-outbox/raw/articles</string>
+  </array>
+</dict>
+</plist>

package/templates/web-clipper/llm-wiki-clippings.json

@@ -51,6 +51,6 @@
     }
   ],
   "triggers": [],
-  "noteNameFormat": "{{date|date:\"YYYY-MM-DD\"}}-{{title|safe_name}}",
+  "noteNameFormat": "{{date|date:\"YYYY-MM-DD\"}}-{{title|safe_name}}-{{date|date:\"HHmmss\"}}",
   "path": "raw/articles"
 }

package/templates/web-clipper/readme.txt

@@ -1,16 +1,16 @@
 SkillWiki Obsidian Web Clipper template
 
-1. Open Obsidian Web Clipper Settings in the browser profile that will capture this vault.
-2. Import llm-wiki-clippings.json.
-3. Confirm the destination path is raw/articles and the behavior is Create.
-4. Repeat the import for every browser profile that should capture into this vault.
+Dedicated clip-outbox (v1):
+1. Create or select an Obsidian vault at ~/Obsidian/clip-outbox (outside ~/wiki).
+2. Create raw/articles and raw/assets in that vault. Set the attachment folder to raw/assets.
+3. Open Obsidian Web Clipper Settings in the browser profile that will capture.
+4. Import llm-wiki-clippings.json.
+5. Select the clip-outbox vault. Keep Add to Obsidian. Do not select ~/wiki.
+6. Confirm the destination path is raw/articles and the behavior is Create.
+7. Repeat the import for every browser profile. Shipping a new JSON does not update extension storage.
+8. Verify with a scratch capture and a repeated same-title save before enabling delivery.
 
-The generic template preserves Web Clipper's {{content}} output. Remote HTTP(S)
-images remain external dependencies and are not guaranteed to be downloaded or
-available offline.
-
-For attended local asset materialization, an agent may choose any URL-friendly
-path under raw/assets/. Write the asset first, use an explicit vault-qualified
-Obsidian embed such as ![[raw/assets/example/diagram.png]], verify the target and
-preview, and only then finalize the new raw capture. Referenced asset paths are
-stable after capture.
+The generic template preserves Web Clipper's {{content}} output. The clip-outbox
+worker localizes remote HTTPS images, writes explicit ![[raw/assets/...]] embeds,
+and uploads a sibling Markdown index at raw/assets/<capture-id>/note.md. Never use
+.txt as the only index. wiki_capture is not clip or image ingress.