skillwiki 0.10.109 → 0.10.111

package/dist/chunk-OSL4J7GF.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+// src/clip-outbox/ready.ts
+function buildReadyHint(vaultId, files) {
+  const assets = files.filter((f) => f.path.startsWith("raw/assets/"));
+  const articles = files.filter((f) => f.path.startsWith("raw/articles/"));
+  return { vault_id: vaultId, files: [...assets, ...articles] };
+}
+async function postReadyHint(opts) {
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const body = JSON.stringify(opts.hint);
+  if (Buffer.byteLength(body) > 32768) return { ok: false, status: 413 };
+  const res = await fetchImpl(opts.url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${opts.token}`,
+      "Content-Type": "application/json"
+    },
+    body,
+    signal: AbortSignal.timeout(1e4),
+    redirect: "error"
+  });
+  if (!res.ok) return { ok: false, status: res.status };
+  const result = await res.json();
+  const paths = result.paths;
+  return result.ok === true && Array.isArray(paths) && opts.hint.files.every((f) => paths.includes(f.path)) ? { ok: true } : { ok: false, status: 503 };
+}
+
+export {
+  buildReadyHint,
+  postReadyHint
+};

package/dist/chunk-PYPPG7RF.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import {
+  isClipOutboxKey,
+  isVaultSyncKey
+} from "./chunk-UIEQIJXP.js";
+
+// src/utils/home.ts
+import { homedir } from "os";
+import { resolve } from "path";
+function resolveSkillwikiHome(home, env = process.env) {
+  for (const candidate of [home, env.HOME, env.USERPROFILE]) {
+    if (candidate?.trim()) return resolve(candidate);
+  }
+  try {
+    const fallback = homedir();
+    if (fallback?.trim()) return resolve(fallback);
+  } catch {
+    throw new Error("Could not resolve SkillWiki home directory");
+  }
+  throw new Error("Could not resolve SkillWiki home directory");
+}
+
+// src/utils/dotenv.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { dirname } from "path";
+var CONFIG_KEYS = [
+  "WIKI_PATH",
+  "WIKI_LANG",
+  "SKILLWIKI_HOST_ID",
+  "AUTO_COMMIT",
+  "BACKUP_ENDPOINT",
+  "BACKUP_BUCKET",
+  "BACKUP_REGION",
+  "BACKUP_ACCESS_KEY_ID",
+  "BACKUP_SECRET_ACCESS_KEY"
+];
+var MCP_AUTH_KEYS = ["SKILLWIKI_MCP_TOKEN", "SKILLWIKI_MCP_URL"];
+var _whitelist = /* @__PURE__ */ new Set([...CONFIG_KEYS, ...MCP_AUTH_KEYS]);
+var PROFILE_PATH_RE = /^WIKI_([A-Z][A-Z0-9_]{0,31})_PATH$/;
+var PROFILE_LANG_RE = /^WIKI_([A-Z][A-Z0-9_]{0,31})_LANG$/;
+var PROFILE_DEFAULT_RE = /^WIKI_DEFAULT$/;
+function isValidWikiProfileKey(key) {
+  if (key === "WIKI_PATH" || key === "WIKI_LANG") return false;
+  return PROFILE_PATH_RE.test(key) || PROFILE_LANG_RE.test(key) || PROFILE_DEFAULT_RE.test(key);
+}
+function profileKey(name, suffix) {
+  return `WIKI_${name.toUpperCase().replace(/-/g, "_").replace(/[^A-Z0-9_]/g, "")}_${suffix}`;
+}
+function parseDotenvText(text) {
+  const out = {};
+  for (const rawLine of text.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (line.length === 0 || line.startsWith("#")) continue;
+    const eq = line.indexOf("=");
+    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) && !isClipOutboxKey(key)) continue;
+    if (value.length === 0) continue;
+    out[key] = value;
+  }
+  return out;
+}
+async function parseDotenvFile(path) {
+  let text;
+  try {
+    text = await readFile(path, "utf8");
+  } catch {
+    return {};
+  }
+  return parseDotenvText(text);
+}
+async function writeDotenv(filePath, entries, originalContent) {
+  const lines = originalContent !== void 0 ? updateLines(originalContent, entries) : freshLines(entries);
+  await mkdir(dirname(filePath), { recursive: true });
+  await writeFile(filePath, lines.join("\n") + "\n", "utf8");
+}
+function freshLines(entries) {
+  const out = [];
+  for (const [key, value] of Object.entries(entries)) {
+    if (value !== void 0) out.push(`${key}=${value}`);
+  }
+  return out;
+}
+function updateLines(originalContent, entries) {
+  let rawLines = originalContent.split(/\r?\n/);
+  if (rawLines.length > 0 && rawLines[rawLines.length - 1] === "") {
+    rawLines = rawLines.slice(0, -1);
+  }
+  const keysToWrite = new Set(Object.keys(entries));
+  const out = [];
+  for (const line of rawLines) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0 || trimmed.startsWith("#")) {
+      out.push(line);
+      continue;
+    }
+    const eq = trimmed.indexOf("=");
+    if (eq <= 0) {
+      out.push(line);
+      continue;
+    }
+    const key = trimmed.slice(0, eq).trim();
+    if (keysToWrite.has(key)) {
+      out.push(`${key}=${entries[key]}`);
+      keysToWrite.delete(key);
+    } else {
+      out.push(line);
+    }
+  }
+  for (const key of keysToWrite) {
+    const value = entries[key];
+    if (value !== void 0) out.push(`${key}=${value}`);
+  }
+  return out;
+}
+
+export {
+  resolveSkillwikiHome,
+  CONFIG_KEYS,
+  isValidWikiProfileKey,
+  profileKey,
+  parseDotenvText,
+  parseDotenvFile,
+  writeDotenv
+};

package/dist/chunk-QESNTTVY.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+// src/utils/delete-intent.ts
+import { mkdir, writeFile, readdir, readFile } from "fs/promises";
+import { join } from "path";
+var DELETE_INTENT_SCHEMA = "vault-delete-intent/v1";
+var DELETE_INTENT_DIR = "meta/delete-intents";
+function normalizeVaultRelPath(path) {
+  const p = path.replace(/\\/g, "/").replace(/^\/+/, "");
+  if (!p || p.includes("..") || p.startsWith(".git/")) {
+    throw new Error(`invalid vault-relative path: ${path}`);
+  }
+  return p;
+}
+function pathToIntentFilename(path) {
+  const p = normalizeVaultRelPath(path);
+  return `${p.replace(/\//g, "__")}.json`;
+}
+function intentHostId() {
+  return process.env.SKILLWIKI_HOST_ID ?? process.env.AGENT_HOST_ID ?? "unknown";
+}
+function buildDeleteIntent(input) {
+  return {
+    schema: DELETE_INTENT_SCHEMA,
+    path: normalizeVaultRelPath(input.path),
+    action: input.action,
+    created: input.created ?? (/* @__PURE__ */ new Date()).toISOString(),
+    host: input.host ?? intentHostId(),
+    actor: input.actor,
+    reason: input.reason,
+    source: input.source,
+    expires: input.expires ?? null
+  };
+}
+async function writeDeleteIntent(vault, intent) {
+  const dir = join(vault, DELETE_INTENT_DIR);
+  await mkdir(dir, { recursive: true });
+  const rel = `${DELETE_INTENT_DIR}/${pathToIntentFilename(intent.path)}`;
+  await writeFile(join(vault, rel), JSON.stringify(intent, null, 2) + "\n", "utf8");
+  return rel;
+}
+
+export {
+  DELETE_INTENT_SCHEMA,
+  DELETE_INTENT_DIR,
+  normalizeVaultRelPath,
+  pathToIntentFilename,
+  buildDeleteIntent,
+  writeDeleteIntent
+};

package/dist/chunk-TDBUJUYH.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import {
+  PRODUCTION_WATCHER_LABEL,
+  evidencePath,
+  expandUserPath,
+  loadClipCredentials,
+  nestedOrEqual,
+  resolveClipOutboxConfig,
+  validateRuntime
+} from "./chunk-6OQLBNKR.js";
+import {
+  parseDotenvFile
+} from "./chunk-PYPPG7RF.js";
+import {
+  atomicWriteText
+} from "./chunk-GQWCTJTU.js";
+
+// src/clip-outbox/migrate.ts
+import { access, mkdir, readFile } from "fs/promises";
+import { constants } from "fs";
+import { basename, dirname, isAbsolute, join } from "path";
+import { execFileSync } from "child_process";
+var CLIP_MIGRATION_HINT = "Clip channel requires attended setup: run skillwiki clip-outbox install-or-migrate, then skillwiki doctor. Installation/update never sets clip_outbox.enabled=true or loads launchd. Prove deployed SeaweedFS If-None-Match:* create-only before operator enablement.";
+var xml = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+async function packagedPlist() {
+  for (const rel of ["../templates/launchd/", "../../templates/launchd/"]) {
+    try {
+      return await readFile(new URL(`${rel}${PRODUCTION_WATCHER_LABEL}.plist`, import.meta.url), "utf8");
+    } catch {
+    }
+  }
+  throw new Error("packaged clip launchd template missing");
+}
+async function stableCliBinary(argvPath = process.argv[1]) {
+  const candidates = [argvPath, ...[dirname(process.execPath), ...(process.env.PATH ?? "").split(":")].map((dir) => join(dir, "skillwiki"))];
+  for (const candidate of candidates) {
+    if (!candidate || !isAbsolute(candidate) || basename(candidate) !== "skillwiki") continue;
+    try {
+      await access(candidate, constants.X_OK);
+      return candidate;
+    } catch {
+    }
+  }
+  throw new Error("global npm skillwiki binary not found; install/link the CLI before migrating");
+}
+async function migrateClipOutbox(input) {
+  const map = await parseDotenvFile(join(input.home, ".skillwiki", ".env"));
+  const resolved = resolveClipOutboxConfig(map, input.home);
+  if (!resolved.ok) throw new Error(resolved.message);
+  if (input.load && (!resolved.enabled || !input.conditionalCreateProven)) throw new Error("--load requires existing clip_outbox.enabled=true and --conditional-create-proven after the operator's deployed create-only race test");
+  if ((input.platform ?? process.platform) !== "darwin") throw new Error("clip launchd migration requires macOS");
+  const rawRoot = map["clip_outbox.root"] ?? "~/Obsidian/clip-outbox";
+  const root = resolved.enabled ? resolved.config.root : expandUserPath(rawRoot, input.home);
+  if (!isAbsolute(root) || root.includes("\0") || rawRoot.split("/").includes("..")) throw new Error("invalid outbox root");
+  const mirror = resolved.enabled ? resolved.config.mirrorRoot : expandUserPath(map["clip_outbox.mirror_root"] ?? join(input.home, "wiki"), input.home);
+  if (nestedOrEqual(root, mirror)) throw new Error("outbox must be disjoint from mirror");
+  const binary = input.binaryPath ?? await stableCliBinary();
+  if (!isAbsolute(binary) || !isAbsolute(input.nodePath ?? process.execPath)) throw new Error("absolute executable paths required");
+  const logRoot = join(input.home, "Library", "Logs", "SkillWiki");
+  const plistPath = join(input.home, "Library", "LaunchAgents", `${PRODUCTION_WATCHER_LABEL}.plist`);
+  const template = await packagedPlist();
+  let plist = template;
+  for (const [key, value] of Object.entries({ NODE_BINARY: input.nodePath ?? process.execPath, CLI_BINARY: binary, OUTBOX_ROOT: root, HOME: input.home, LOG_ROOT: logRoot })) plist = plist.replaceAll(`@${key}@`, xml(value));
+  if (input.load) {
+    if (!resolved.enabled) throw new Error("--load requires existing clip_outbox.enabled=true and --conditional-create-proven after the operator's deployed create-only race test");
+    const creds = await loadClipCredentials(input.home, resolved.config);
+    await mkdir(resolved.config.stateRoot, { recursive: true, mode: 448 });
+    const proof = await atomicWriteText(evidencePath(resolved.config), JSON.stringify({ verified: true, destination: resolved.config.destination, endpoint: creds.s3.endpoint, testedAt: (/* @__PURE__ */ new Date()).toISOString(), basis: "operator-attested deployed If-None-Match:* race test" }));
+    if (!proof.ok) throw new Error("cannot record operator conditional-create attestation");
+    await validateRuntime(input.home, resolved.config, creds.s3.endpoint);
+  }
+  await mkdir(dirname(plistPath), { recursive: true });
+  await mkdir(logRoot, { recursive: true });
+  const result = await atomicWriteText(plistPath, plist);
+  if (!result.ok) throw new Error("cannot refresh clip plist");
+  if (input.load) {
+    if (typeof process.getuid !== "function") throw new Error("clip launchd load requires macOS");
+    const domain = `gui/${process.getuid()}`;
+    const launch = input.launch ?? ((args) => {
+      execFileSync("launchctl", args, { stdio: "ignore", timeout: 5e3 });
+    });
+    try {
+      launch(["bootout", `${domain}/${PRODUCTION_WATCHER_LABEL}`]);
+    } catch {
+    }
+    launch(["enable", `${domain}/${PRODUCTION_WATCHER_LABEL}`]);
+    launch(["bootstrap", domain, plistPath]);
+  }
+  return { plistPath, loaded: !!input.load, enabled: resolved.enabled, humanHint: `${result.data.changed ? "Refreshed" : "Current"} clip launchd plist: ${plistPath}. ${input.load ? "Operator-gated launchd bootstrap requested." : CLIP_MIGRATION_HINT}` };
+}
+async function refreshInstalledClipPlist(home, opts) {
+  const plistPath = join(home, "Library", "LaunchAgents", `${PRODUCTION_WATCHER_LABEL}.plist`);
+  try {
+    await access(plistPath, constants.F_OK);
+  } catch {
+    return void 0;
+  }
+  const result = await migrateClipOutbox({ ...opts, home, load: false });
+  return result.humanHint;
+}
+
+export {
+  CLIP_MIGRATION_HINT,
+  xml,
+  packagedPlist,
+  stableCliBinary,
+  migrateClipOutbox,
+  refreshInstalledClipPlist
+};