skillwiki 0.9.31 → 0.9.33

package/dist/{chunk-6G7RAAOS.js → chunk-OPXMAS4O.js}

@@ -2056,11 +2056,57 @@ ${markdown_links.map((l) => `  line ${l.line}: ${l.text}`).join("\n")}`;
 
 // src/commands/dedup.ts
 import { createHash as createHash2 } from "crypto";
-import { execFile } from "child_process";
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2 } from "fs";
 import { dirname as dirname4, join as join12, resolve as resolve3 } from "path";
+
+// src/utils/rclone.ts
+import { execFile } from "child_process";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
+function normalizeRemoteRoot(remote) {
+  return remote?.replace(/\/+$/, "");
+}
+function buildRemoteObjectPath(remoteRoot, relPath) {
+  return remoteRoot ? `${remoteRoot}/${relPath}` : void 0;
+}
+function isValidRemoteDeleteCap(maxRemoteDeletes) {
+  if (maxRemoteDeletes === void 0) return true;
+  return Number.isInteger(maxRemoteDeletes) && maxRemoteDeletes > 0;
+}
+async function planAndMaybePruneRemoteObjects(plannedDeletes, input) {
+  const output = { plannedDeletes, deleted: [] };
+  if (!input.remoteDelete) return ok(output);
+  const maxDeletes = input.maxRemoteDeletes ?? input.defaultMaxDeletes ?? 1;
+  if (!Number.isInteger(maxDeletes) || maxDeletes < 1) {
+    return err("USAGE", { message: "--max-remote-deletes must be a positive integer" });
+  }
+  if (plannedDeletes.length > maxDeletes) {
+    return err("USAGE", { message: `remote delete cap exceeded: ${plannedDeletes.length} > ${maxDeletes}` });
+  }
+  const runner = input.rcloneRunner ?? defaultRcloneRunner;
+  for (const path of plannedDeletes) {
+    const result = await runner(["deletefile", path]);
+    if (result.exitCode !== 0) {
+      return err("SYNC_PUSH_FAILED", { path, stderr: result.stderr, deleted: output.deleted });
+    }
+    output.deleted.push(path);
+  }
+  return ok(output);
+}
+async function defaultRcloneRunner(args) {
+  try {
+    const result = await execFileAsync("rclone", args, { encoding: "utf-8" });
+    return { exitCode: 0, stdout: result.stdout, stderr: result.stderr };
+  } catch (e) {
+    return {
+      exitCode: typeof e?.code === "number" ? e.code : 1,
+      stdout: typeof e?.stdout === "string" ? e.stdout : "",
+      stderr: typeof e?.stderr === "string" ? e.stderr : String(e)
+    };
+  }
+}
+
+// src/commands/dedup.ts
 async function runDedup(input) {
   if (input.canonicalPolicy && input.canonicalPolicy !== "scan-order" && input.canonicalPolicy !== "stable-path") {
     return { exitCode: ExitCode.USAGE, result: err("USAGE", { message: "--canonical-policy must be stable-path or scan-order" }) };
@@ -2259,39 +2305,9 @@ function readManifest(path) {
   }
 }
 async function planAndMaybePruneRemote(input, entries) {
-  const remoteRoot = input.remote?.replace(/\/+$/, "");
+  const remoteRoot = normalizeRemoteRoot(input.remote);
   const plannedDeletes = remoteRoot ? entries.flatMap((entry) => entry.duplicates.map((path) => `${remoteRoot}/${path}`)) : [];
-  const output = { plannedDeletes, deleted: [] };
-  if (!input.remoteDelete) return ok(output);
-  const maxDeletes = input.maxRemoteDeletes ?? 50;
-  if (!Number.isInteger(maxDeletes) || maxDeletes < 1) {
-    return err("USAGE", { message: "--max-remote-deletes must be a positive integer" });
-  }
-  if (plannedDeletes.length > maxDeletes) {
-    return err("USAGE", { message: `remote delete cap exceeded: ${plannedDeletes.length} > ${maxDeletes}` });
-  }
-  const runner = input.rcloneRunner ?? defaultRcloneRunner;
-  for (const path of plannedDeletes) {
-    const result = await runner(["deletefile", path]);
-    if (result.exitCode !== 0) {
-      output.failed = { path, stderr: result.stderr };
-      return err("SYNC_PUSH_FAILED", { path, stderr: result.stderr });
-    }
-    output.deleted.push(path);
-  }
-  return ok(output);
-}
-async function defaultRcloneRunner(args) {
-  try {
-    const result = await execFileAsync("rclone", args, { encoding: "utf-8" });
-    return { exitCode: 0, stdout: result.stdout, stderr: result.stderr };
-  } catch (e) {
-    return {
-      exitCode: typeof e?.code === "number" ? e.code : 1,
-      stdout: typeof e?.stdout === "string" ? e.stdout : "",
-      stderr: typeof e?.stderr === "string" ? e.stderr : String(e)
-    };
-  }
+  return planAndMaybePruneRemoteObjects(plannedDeletes, { ...input, defaultMaxDeletes: 50 });
 }
 
 // src/utils/safe-write.ts
@@ -2711,7 +2727,7 @@ function buildCliSurface() {
   program.command("health").option("--wiki <name>").option("--sync <mode>").option("--no-fail").option("--out <path>").option("--examples <n>");
   program.command("doctor");
   program.command("status").option("--wiki <name>");
-  program.command("archive").option("--wiki <name>").option("--cascade").option("--apply");
+  program.command("archive").option("--wiki <name>").option("--cascade").option("--apply").option("--remote <remote>").option("--remote-delete").option("--max-remote-deletes <n>");
   program.command("drift").option("--apply").option("--new <date>").option("--wiki <name>");
   program.command("dedup").option("--apply").option("--canonical-policy <policy>").option("--manifest-out <path>").option("--manifest-in <path>").option("--remote <remote>").option("--remote-delete").option("--max-remote-deletes <n>").option("--wiki <name>");
   program.command("migrate-citations").option("--dry-run").option("--wiki <name>");
@@ -8863,6 +8879,10 @@ export {
   runLogRotate,
   runTopicMapCheck,
   runIndexLinkFormat,
+  normalizeRemoteRoot,
+  buildRemoteObjectPath,
+  isValidRemoteDeleteCap,
+  planAndMaybePruneRemoteObjects,
   runDedup,
   safeWritePage,
   runFrontmatterFix,

package/dist/cli.js

@@ -6,6 +6,7 @@ import {
   TypedKnowledgeSchema,
   appendLastOp,
   assessSourceIdentity,
+  buildRemoteObjectPath,
   clearLastOp,
   configPath,
   detectSchema,
@@ -18,10 +19,13 @@ import {
   fixPathTooLong,
   isBlockedHost,
   isFailedRunStatus,
+  isValidRemoteDeleteCap,
   loadFleetManifest,
+  normalizeRemoteRoot,
   ok,
   parseDotenvFile,
   parseDotenvText,
+  planAndMaybePruneRemoteObjects,
   profileKey,
   readCliPackageJson,
   readLastOp,
@@ -69,7 +73,7 @@ import {
   triggerAutoUpdate,
   writeCache,
   writeDotenv
-} from "./chunk-6G7RAAOS.js";
+} from "./chunk-OPXMAS4O.js";
 import {
   normalizeDistTag
 } from "./chunk-E6UWZ3S3.js";
@@ -1078,6 +1082,19 @@ function runVaultSyncHealth(home, syncMode) {
   const filterPath = join9(home, ".config", "rclone", "wiki-push-filters.txt");
   const checks = [];
   const pushScript = join9(shareDir, "wiki-push.sh");
+  if (syncMode === "optional" && !existsSync3(pushScript)) {
+    return {
+      status: "pass",
+      blocking: false,
+      installed: false,
+      summary: { pass: 1, info: 0, warn: 0, error: 0, skipped: 1 },
+      checks: [{
+        id: "vault_sync_installed",
+        status: "pass",
+        detail: `vault-sync not installed at ${pushScript}; optional check skipped`
+      }]
+    };
+  }
   checks.push(existsSync3(pushScript) ? { id: "vault_sync_installed", label: "Vault sync installed", status: "pass", detail: `Found: ${pushScript}` } : { id: "vault_sync_installed", label: "Vault sync installed", status: "error", detail: `Script missing: ${pushScript}` });
   if (isMac) {
     const pushPlist = join9(home, "Library", "LaunchAgents", "com.karlchow.wiki-push.plist");
@@ -1217,6 +1234,7 @@ async function runHealth(input) {
   if (!lint.result.ok) return { exitCode: lint.exitCode, result: lint.result };
   const doctorStatus = statusFromCounts(doctor.result.data.summary);
   const vaultSync = runVaultSyncHealth(input.home, syncMode);
+  const vaultSyncCoverage = syncMode === "off" ? { state: "skipped", status: "pass", reason: "--sync off" } : !vaultSync.installed && vaultSync.summary.skipped > 0 && vaultSync.summary.warn === 0 && vaultSync.summary.error === 0 ? { state: "skipped", status: vaultSync.status, reason: "vault-sync not installed and --sync optional" } : { state: "checked", status: vaultSync.status };
   const queryReadiness = deriveQueryReadiness(lint.result.data);
   const sourceFreshness = {
     status: bucketCount(lint.result.data.buckets, "stale_page") > 0 || bucketCount(lint.result.data.buckets, "file_source_url") > 0 ? "warn" : "pass",
@@ -1269,7 +1287,7 @@ async function runHealth(input) {
     coverage: {
       doctor: { state: "checked", status: doctorStatus },
       lint: { state: "checked", status: lintComponent.status },
-      vault_sync: syncMode === "off" ? { state: "skipped", status: "pass", reason: "--sync off" } : { state: "checked", status: vaultSync.status },
+      vault_sync: vaultSyncCoverage,
       query_readiness: { state: "checked", status: queryReadiness.status },
       source_freshness: { state: "checked", status: sourceFreshness.status }
     },
@@ -1339,6 +1357,12 @@ function arraysEqual(a, b) {
   return true;
 }
 async function runArchive(input) {
+  if (input.remoteDelete && !input.remote) {
+    return { exitCode: ExitCode.USAGE, result: err("USAGE", { message: "--remote-delete requires --remote" }) };
+  }
+  if (input.remoteDelete && !isValidRemoteDeleteCap(input.maxRemoteDeletes)) {
+    return { exitCode: ExitCode.USAGE, result: err("USAGE", { message: "--max-remote-deletes must be a positive integer" }) };
+  }
   const scan = await scanVault(input.vault);
   if (!scan.ok) return { exitCode: ExitCode.VAULT_PATH_INVALID, result: scan };
   const lookup = (pages) => {
@@ -1355,6 +1379,8 @@ async function runArchive(input) {
   if (relPath.startsWith("_archive/")) return { exitCode: ExitCode.ARCHIVE_ALREADY_ARCHIVED, result: err("ARCHIVE_ALREADY_ARCHIVED", { page: relPath }) };
   const slug = relPath.replace(/\.md$/, "").split("/").pop();
   const archivePath = join10("_archive", relPath).replace(/\\/g, "/");
+  const remoteRoot = normalizeRemoteRoot(input.remote);
+  const remoteObjectPath = buildRemoteObjectPath(remoteRoot, relPath);
   let cascade;
   if (input.cascade) {
     const wikilinkRefs = [];
@@ -1398,7 +1424,8 @@ async function runArchive(input) {
         index_updated: false,
         applied: false,
         cascade,
-        humanHint: summary
+        ...remoteObjectPath ? { remote: { plannedDeletes: [remoteObjectPath], deleted: [] } } : {},
+        humanHint: summary + (remoteObjectPath ? ` (remote planned ${input.remoteDelete ? "delete" : "preview"}: ${remoteObjectPath})` : "")
       })
     };
   }
@@ -1445,8 +1472,18 @@ ${fmRewritten}
     files: [relPath],
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   });
+  let remote;
+  if (remoteObjectPath) {
+    const plannedDeletes = [remoteObjectPath];
+    const pruned = await planAndMaybePruneRemoteObjects(plannedDeletes, input);
+    if (!pruned.ok) {
+      return { exitCode: ExitCode.SYNC_PUSH_FAILED, result: pruned };
+    }
+    remote = pruned.data;
+  }
   const applied = input.cascade ? true : void 0;
   const cascadeNote = input.cascade ? ` (cascade: ${cascade.source_array_refs.length} src arrays updated, ${cascade.wikilink_refs.length} wikilinks reported)` : "";
+  const remoteNote = remote ? ` (remote ${input.remoteDelete ? `deleted ${remote.deleted.length}` : `planned ${remote.plannedDeletes.length}`})` : "";
   return {
     exitCode: ExitCode.OK,
     result: ok({
@@ -1455,7 +1492,8 @@ ${fmRewritten}
       index_updated: indexUpdated,
       ...applied !== void 0 ? { applied } : {},
       ...cascade ? { cascade } : {},
-      humanHint: `${relPath} -> ${archivePath}${indexUpdated ? " (index updated)" : ""}${cascadeNote}`
+      ...remote ? { remote } : {},
+      humanHint: `${relPath} -> ${archivePath}${indexUpdated ? " (index updated)" : ""}${cascadeNote}${remoteNote}`
     })
   };
 }
@@ -4886,10 +4924,18 @@ program.command("status [vault]").description("output vault diagnostics").option
     langEnvValue: process.env.WIKI_LANG
   }), v.vault);
 });
-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).action(async (page, vault, opts) => {
+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("--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) => {
   const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
-  else emit(await runArchive({ vault: v.vault, page, cascade: !!opts.cascade, apply: !!opts.apply }), v.vault);
+  else emit(await runArchive({
+    vault: v.vault,
+    page,
+    cascade: !!opts.cascade,
+    apply: !!opts.apply,
+    remote: opts.remote,
+    remoteDelete: !!opts.remoteDelete,
+    maxRemoteDeletes: Number.parseInt(opts.maxRemoteDeletes, 10)
+  }), v.vault);
 });
 program.command("drift [vault]").description("detect content drift in raw sources").option("--apply", "update sha256 in drifted sources").option("--new <date>", "list raw files ingested on/after this date (YYYY-MM-DD)").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
   const v = await resolveVaultArg(vault, opts.wiki);

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-6G7RAAOS.js";
+} from "./chunk-OPXMAS4O.js";
 import "./chunk-E6UWZ3S3.js";
 
 // src/mcp-entry.ts

package/package.json

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

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

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

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

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

package/skills/package.json

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

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

@@ -22,7 +22,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 
 0. Resolve vault: `skillwiki path` and `skillwiki lang`.
 1. Identify the target page. Confirm with the user which page to archive (show full relPath).
-2. Run `skillwiki archive <page> [vault]`. Read the JSON output.
+2. Run `skillwiki archive <page> [vault]`. On a vault-sync leaf host where S3 stale originals must be pruned, use `skillwiki archive <page> [vault] --remote seaweed-wiki:cloud/wiki --remote-delete --max-remote-deletes 1` only when that remote path deletion is explicitly intended. Read the JSON output.
 3. Verify with `skillwiki index-check [vault]` — confirm no ghost entries remain.
 4. Run `skillwiki lint [vault]` — check for broken wikilinks from other pages that still reference the archived page. If found, update those pages to point to the replacement or remove the stale link.
 5. **Raw file archiving (N9 Reingest Protocol only):** When archiving a `raw/` file due to content drift, update ALL `^[raw/...]` citation markers and `sources:` frontmatter entries that reference the old path. Change `raw/articles/foo.md` to `_archive/raw/articles/foo.md` in every referencing page. Verify with `skillwiki audit` that no broken markers remain.
@@ -30,7 +30,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 
 ## Reversibility
 
-Archiving is reversible: move the file back from `_archive/` to its original directory and re-add the wikilink entry to `index.md`. No data is deleted.
+Archiving is locally reversible: move the file back from `_archive/` to its original directory and re-add the wikilink entry to `index.md`. If `--remote-delete` was used, the stale active-path object is pruned from the remote after the archive move, but the archived copy remains and a restore will republish the active path on the next push.
 
 ## Stop conditions
 
@@ -42,4 +42,4 @@ Archiving is reversible: move the file back from `_archive/` to its original dir
 - Archiving `raw/` files outside the N9 Reingest Protocol (raw is immutable except during content-drift reingestion).
 - Archiving raw files without updating all `^[raw/...]` citation markers that reference them.
 - Archiving without user confirmation.
-- Deleting files (archive moves, never deletes).
+- Deleting local vault files directly (archive moves locally; remote stale-path pruning is only allowed through the explicit `skillwiki archive --remote ... --remote-delete --max-remote-deletes 1` path).

package/skills/wiki-archive/SKILL.md

@@ -22,7 +22,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 
 0. Resolve vault: `skillwiki path` and `skillwiki lang`.
 1. Identify the target page. Confirm with the user which page to archive (show full relPath).
-2. Run `skillwiki archive <page> [vault]`. Read the JSON output.
+2. Run `skillwiki archive <page> [vault]`. On a vault-sync leaf host where S3 stale originals must be pruned, use `skillwiki archive <page> [vault] --remote seaweed-wiki:cloud/wiki --remote-delete --max-remote-deletes 1` only when that remote path deletion is explicitly intended. Read the JSON output.
 3. Verify with `skillwiki index-check [vault]` — confirm no ghost entries remain.
 4. Run `skillwiki lint [vault]` — check for broken wikilinks from other pages that still reference the archived page. If found, update those pages to point to the replacement or remove the stale link.
 5. **Raw file archiving (N9 Reingest Protocol only):** When archiving a `raw/` file due to content drift, update ALL `^[raw/...]` citation markers and `sources:` frontmatter entries that reference the old path. Change `raw/articles/foo.md` to `_archive/raw/articles/foo.md` in every referencing page. Verify with `skillwiki audit` that no broken markers remain.
@@ -30,7 +30,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 
 ## Reversibility
 
-Archiving is reversible: move the file back from `_archive/` to its original directory and re-add the wikilink entry to `index.md`. No data is deleted.
+Archiving is locally reversible: move the file back from `_archive/` to its original directory and re-add the wikilink entry to `index.md`. If `--remote-delete` was used, the stale active-path object is pruned from the remote after the archive move, but the archived copy remains and a restore will republish the active path on the next push.
 
 ## Stop conditions
 
@@ -42,4 +42,4 @@ Archiving is reversible: move the file back from `_archive/` to its original dir
 - Archiving `raw/` files outside the N9 Reingest Protocol (raw is immutable except during content-drift reingestion).
 - Archiving raw files without updating all `^[raw/...]` citation markers that reference them.
 - Archiving without user confirmation.
-- Deleting files (archive moves, never deletes).
+- Deleting local vault files directly (archive moves locally; remote stale-path pruning is only allowed through the explicit `skillwiki archive --remote ... --remote-delete --max-remote-deletes 1` path).