skillwiki 0.8.5-beta.1 → 0.8.5-beta.3

package/dist/auto-update-bg.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 #!/usr/bin/env node
 import {
+  normalizeDistTag,
   semverGt
-} from "./chunk-XM5IYZX7.js";
+} from "./chunk-E6UWZ3S3.js";
 
 // src/auto-update-bg.ts
 import { execSync } from "child_process";
@@ -10,11 +11,12 @@ import { writeFileSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
 var home = process.argv[2];
 var currentVersion = process.argv[3];
+var distTag = normalizeDistTag(process.argv[4]);
 if (!home || !currentVersion) process.exit(0);
 var cacheFile = join(home, ".skillwiki", ".update-cache.json");
 setTimeout(() => process.exit(0), 3e4);
 try {
-  const latest = execSync("npm view skillwiki@latest version", {
+  const latest = execSync(`npm view skillwiki@${distTag} version`, {
     encoding: "utf8",
     timeout: 15e3
   }).trim();
@@ -22,10 +24,11 @@ try {
   const cache = {
     lastCheck: Date.now(),
     latestVersion: latest,
-    currentVersion
+    currentVersion,
+    distTag
   };
   if (semverGt(latest, currentVersion)) {
-    execSync("npm install -g skillwiki@latest", {
+    execSync(`npm install -g skillwiki@${distTag}`, {
       stdio: "ignore",
       timeout: 6e4
     });
@@ -36,7 +39,7 @@ try {
 } catch {
   try {
     mkdirSync(dirname(cacheFile), { recursive: true });
-    writeFileSync(cacheFile, JSON.stringify({ lastCheck: Date.now(), latestVersion: "", currentVersion }, null, 2));
+    writeFileSync(cacheFile, JSON.stringify({ lastCheck: Date.now(), latestVersion: "", currentVersion, distTag }, null, 2));
   } catch {
   }
 }

package/dist/{chunk-XM5IYZX7.js → chunk-E6UWZ3S3.js}

@@ -40,6 +40,23 @@ function parseSemver(version) {
   };
 }
 
+// src/utils/update-consts.ts
+var DIST_TAG = "latest";
+var CACHE_FILENAME = ".update-cache.json";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var ENV_DISABLE_KEY = "NO_UPDATE_NOTIFIER";
+var CLI_DISABLE_FLAG = "--no-update-notifier";
+function normalizeDistTag(tag) {
+  const value = (tag ?? DIST_TAG).trim();
+  return /^[A-Za-z0-9._-]+$/.test(value) ? value : DIST_TAG;
+}
+
 export {
-  semverGt
+  semverGt,
+  DIST_TAG,
+  CACHE_FILENAME,
+  CHECK_INTERVAL_MS,
+  ENV_DISABLE_KEY,
+  CLI_DISABLE_FLAG,
+  normalizeDistTag
 };

package/dist/cli.js

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
 import {
+  CACHE_FILENAME,
+  CHECK_INTERVAL_MS,
+  CLI_DISABLE_FLAG,
+  DIST_TAG,
+  ENV_DISABLE_KEY,
+  normalizeDistTag,
   semverGt
-} from "./chunk-XM5IYZX7.js";
+} from "./chunk-E6UWZ3S3.js";
 import {
   git,
   gitStrict
@@ -4011,7 +4017,7 @@ async function runConfigPath(input) {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync9, lstatSync, readlinkSync, readdirSync, statSync as statSync3, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync10, lstatSync, readlinkSync, readdirSync as readdirSync2, statSync as statSync3, readFileSync as readFileSync7 } from "fs";
 import { join as join27, resolve as resolve5 } from "path";
 import { execSync as execSync2 } from "child_process";
 import { platform as platform2 } from "os";
@@ -4020,14 +4026,6 @@ import { platform as platform2 } from "os";
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync7, mkdirSync as mkdirSync3 } from "fs";
 import { join as join24, dirname as dirname9 } from "path";
 import { spawn } from "child_process";
-
-// src/utils/update-consts.ts
-var CACHE_FILENAME = ".update-cache.json";
-var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-var ENV_DISABLE_KEY = "NO_UPDATE_NOTIFIER";
-var CLI_DISABLE_FLAG = "--no-update-notifier";
-
-// src/utils/auto-update.ts
 function cachePath(home) {
   return join24(home, ".skillwiki", CACHE_FILENAME);
 }
@@ -4053,12 +4051,17 @@ function writeCache(home, cache) {
 }
 function latestFromCache(home, currentVersion) {
   const { cache } = readCache(home);
-  if (!cache || !cache.latestVersion) return { hasUpdate: false, latest: null };
+  if (!cache || !cache.latestVersion) return { hasUpdate: false, latest: null, distTag: DIST_TAG };
+  const distTag = normalizeDistTag(cache.distTag);
   return {
     hasUpdate: semverGt(cache.latestVersion, currentVersion),
-    latest: cache.latestVersion
+    latest: cache.latestVersion,
+    distTag
   };
 }
+function distTagFromCache(home) {
+  return normalizeDistTag(readCacheRaw(home)?.distTag);
+}
 function isDisabled() {
   return !!(process.env[ENV_DISABLE_KEY] || process.env.NODE_ENV === "test" || process.argv.includes(CLI_DISABLE_FLAG));
 }
@@ -4066,9 +4069,10 @@ function triggerAutoUpdate(home, currentVersion) {
   if (isDisabled()) return;
   const { isStale: isStale2 } = readCache(home);
   if (!isStale2) return;
+  const distTag = distTagFromCache(home);
   const bgScript = new URL("../auto-update-bg.js", import.meta.url).pathname;
   if (!existsSync7(bgScript)) return;
-  const child = spawn(process.execPath, [bgScript, home, currentVersion], {
+  const child = spawn(process.execPath, [bgScript, home, currentVersion, distTag], {
     detached: true,
     stdio: "ignore"
   });
@@ -4078,9 +4082,10 @@ function triggerAutoUpdate(home, currentVersion) {
 }
 
 // src/utils/plugin-registry.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync8, readdirSync, readFileSync as readFileSync5 } from "fs";
 import { join as join25 } from "path";
 var REGISTRY_PATH = join25(".claude", "plugins", "installed_plugins.json");
+var CODEX_CONFIG_PATH = join25(".codex", "config.toml");
 var PLUGIN_KEY = "skillwiki@llm-wiki";
 function readInstalledPlugins(home) {
   try {
@@ -4097,6 +4102,102 @@ function findPlugin(home, key = PLUGIN_KEY) {
   if (!entries || entries.length === 0) return null;
   return entries[0];
 }
+function findPluginInstallations(home, key = PLUGIN_KEY) {
+  const parsed = parsePluginKey(key);
+  if (!parsed) return [];
+  const installs = [];
+  const claudePlugin = findPlugin(home, key);
+  if (claudePlugin) {
+    installs.push({
+      channel: "claude",
+      label: "Claude",
+      key,
+      pluginName: parsed.pluginName,
+      marketplace: parsed.marketplace,
+      installPath: claudePlugin.installPath,
+      version: claudePlugin.version
+    });
+  }
+  const codexPlugin = findCodexPlugin(home, key, parsed.pluginName, parsed.marketplace);
+  if (codexPlugin) installs.push(codexPlugin);
+  return installs;
+}
+function findCodexPlugin(home, key, pluginName, marketplace) {
+  const config = readCodexPluginConfig(home, key, marketplace);
+  if (!config?.enabled) return null;
+  const cacheRoot = join25(home, ".codex", "plugins", "cache", marketplace, pluginName);
+  if (!existsSync8(cacheRoot)) return null;
+  let versions;
+  try {
+    versions = readdirSync(cacheRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  } catch {
+    return null;
+  }
+  if (versions.length === 0) return null;
+  const version = versions.reduce((latest, candidate) => semverGt(candidate, latest) ? candidate : latest);
+  return {
+    channel: "codex",
+    label: "Codex",
+    key,
+    pluginName,
+    marketplace,
+    installPath: join25(cacheRoot, version),
+    version,
+    sourceType: config.sourceType,
+    source: config.source
+  };
+}
+function parsePluginKey(key) {
+  const at = key.lastIndexOf("@");
+  if (at <= 0 || at === key.length - 1) return null;
+  return {
+    pluginName: key.slice(0, at),
+    marketplace: key.slice(at + 1)
+  };
+}
+function readCodexPluginConfig(home, key, marketplace) {
+  let raw;
+  try {
+    raw = readFileSync5(join25(home, CODEX_CONFIG_PATH), "utf8");
+  } catch {
+    return null;
+  }
+  const pluginSections = /* @__PURE__ */ new Set([`plugins."${key}"`, `plugins.${key}`]);
+  const marketplaceSections = /* @__PURE__ */ new Set([`marketplaces.${marketplace}`, `marketplaces."${marketplace}"`]);
+  let section = "";
+  let sawPlugin = false;
+  const config = { enabled: false };
+  for (const line of raw.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const sectionMatch = trimmed.match(/^\[([^\]]+)\]$/);
+    if (sectionMatch) {
+      section = sectionMatch[1];
+      continue;
+    }
+    const kv = trimmed.match(/^([A-Za-z0-9_.-]+)\s*=\s*(.+)$/);
+    if (!kv) continue;
+    const name = kv[1];
+    const value = parseTomlScalar(kv[2]);
+    if (pluginSections.has(section) && name === "enabled") {
+      sawPlugin = true;
+      config.enabled = value === true;
+    } else if (marketplaceSections.has(section) && name === "source_type" && typeof value === "string") {
+      config.sourceType = value;
+    } else if (marketplaceSections.has(section) && name === "source" && typeof value === "string") {
+      config.source = value;
+    }
+  }
+  return sawPlugin ? config : null;
+}
+function parseTomlScalar(rawValue) {
+  const value = rawValue.replace(/\s+#.*$/, "").trim();
+  if (value === "true") return true;
+  if (value === "false") return false;
+  const quoted = value.match(/^"((?:\\"|[^"])*)"$/);
+  if (quoted) return quoted[1].replace(/\\"/g, '"');
+  return value;
+}
 
 // src/utils/s3-mount-health.ts
 import { execSync } from "child_process";
@@ -4361,12 +4462,12 @@ function detectCliChannels(argv, home) {
   const plugin = findPlugin(home);
   if (plugin) {
     const pluginBin = join27(plugin.installPath, "bin", "skillwiki");
-    if (existsSync9(pluginBin)) {
+    if (existsSync10(pluginBin)) {
       channels.push({ name: "plugin", path: pluginBin, isDevLink: false });
     }
   }
   const installBin = join27(home, ".claude", "skills", "bin", "skillwiki");
-  if (existsSync9(installBin)) {
+  if (existsSync10(installBin)) {
     channels.push({ name: "install", path: installBin, isDevLink: false });
   }
   return channels;
@@ -4418,7 +4519,7 @@ function checkCliChannels(argv, home) {
 }
 async function checkConfigFile(home) {
   const cfgPath = configPath(home);
-  if (!existsSync9(cfgPath)) {
+  if (!existsSync10(cfgPath)) {
     return check("warn", "config_file", "Config file exists", `${cfgPath} not found`);
   }
   try {
@@ -4433,7 +4534,7 @@ function checkWikiPathExists(resolvedPath) {
   if (resolvedPath === void 0) {
     return check("error", "wiki_path_exists", "Vault directory exists", "Cannot check \u2014 WIKI_PATH not resolved");
   }
-  if (existsSync9(resolvedPath) && statSync3(resolvedPath).isDirectory()) {
+  if (existsSync10(resolvedPath) && statSync3(resolvedPath).isDirectory()) {
     return check("pass", "wiki_path_exists", "Vault directory exists", resolvedPath);
   }
   return check("error", "wiki_path_exists", "Vault directory exists", `${resolvedPath} does not exist or is not a directory`);
@@ -4442,13 +4543,13 @@ function checkVaultStructure(resolvedPath) {
   if (resolvedPath === void 0) {
     return check("error", "vault_structure", "Vault structure valid", "Cannot check \u2014 WIKI_PATH not resolved");
   }
-  if (!existsSync9(resolvedPath)) {
+  if (!existsSync10(resolvedPath)) {
     return check("error", "vault_structure", "Vault structure valid", "Cannot check \u2014 vault directory does not exist");
   }
   const missing = [];
-  if (!existsSync9(join27(resolvedPath, "SCHEMA.md"))) missing.push("SCHEMA.md");
+  if (!existsSync10(join27(resolvedPath, "SCHEMA.md"))) missing.push("SCHEMA.md");
   for (const dir of ["raw", "entities", "concepts", "meta"]) {
-    if (!existsSync9(join27(resolvedPath, dir))) missing.push(dir + "/");
+    if (!existsSync10(join27(resolvedPath, dir))) missing.push(dir + "/");
   }
   if (missing.length === 0) {
     return check("pass", "vault_structure", "Vault structure valid", "All required files and directories present");
@@ -4457,7 +4558,7 @@ function checkVaultStructure(resolvedPath) {
 }
 function checkSkillsInstalled(home, cwd) {
   const srcDir = cwd ? join27(cwd, "packages", "skills") : void 0;
-  if (srcDir && existsSync9(srcDir)) {
+  if (srcDir && existsSync10(srcDir)) {
     const found = findInstalledSkillMd(srcDir);
     if (found.length > 0) {
       return check("pass", "skills_installed", "Skills installed", `${found.length} SKILL.md file(s) found (source)`);
@@ -4471,7 +4572,7 @@ function checkSkillsInstalled(home, cwd) {
     }
   }
   const skillsDir = join27(home, ".claude", "skills");
-  if (existsSync9(skillsDir)) {
+  if (existsSync10(skillsDir)) {
     const found = findInstalledSkillMd(skillsDir);
     if (found.length > 0) {
       return check("pass", "skills_installed", "Skills installed", `${found.length} SKILL.md file(s) found (CLI install)`);
@@ -4513,32 +4614,54 @@ function checkDuplicateSkills(home) {
   return check(status, "skills_duplicate", "Skills not duplicated", parts.join("; "));
 }
 function checkNpmUpdate(home, currentVersion) {
-  const { hasUpdate, latest } = latestFromCache(home, currentVersion);
+  const { hasUpdate, latest, distTag } = latestFromCache(home, currentVersion);
   if (!latest) {
-    return check("pass", "npm_update", "npm CLI version", `v${currentVersion} (no cache yet)`);
+    return check("pass", "npm_update", "npm CLI version", `v${currentVersion} (${distTag}: no cache yet)`);
   }
   if (hasUpdate) {
-    return check("warn", "npm_update", "npm CLI version", `v${currentVersion} \u2014 update available: v${latest}. Run \`skillwiki update\`.`);
+    return check("warn", "npm_update", "npm CLI version", `v${currentVersion} \u2014 ${distTag} update available: v${latest}. Run \`skillwiki update --tag ${distTag}\`.`);
   }
-  return check("pass", "npm_update", "npm CLI version", `v${currentVersion} (latest: v${latest})`);
+  return check("pass", "npm_update", "npm CLI version", `v${currentVersion} (${distTag}: v${latest})`);
 }
 function checkPluginVersionDrift(home, currentVersion) {
-  const plugin = findPlugin(home);
-  if (!plugin) {
+  const plugins = findPluginInstallations(home);
+  if (plugins.length === 0) {
     return check("pass", "plugin_version_drift", "Plugin/CLI version", "Plugin not installed \u2014 CLI only");
   }
-  const pluginVersion = plugin.version;
-  if (pluginVersion === currentVersion) {
-    return check("pass", "plugin_version_drift", "Plugin/CLI version", `Both at v${currentVersion}`);
+  const drifted = plugins.filter((plugin) => plugin.version !== currentVersion);
+  if (drifted.length === 0) {
+    if (plugins.length === 1 && plugins[0].channel === "claude") {
+      return check("pass", "plugin_version_drift", "Plugin/CLI version", `Both at v${currentVersion}`);
+    }
+    if (plugins.length === 1) {
+      return check("pass", "plugin_version_drift", "Plugin/CLI version", `${plugins[0].label} plugin and CLI both at v${currentVersion}`);
+    }
+    const labels = plugins.map((plugin) => `${plugin.label} plugin`).join(", ");
+    return check("pass", "plugin_version_drift", "Plugin/CLI version", `${labels}, and CLI all at v${currentVersion}`);
   }
-  const updateCmd = semverGt(pluginVersion, currentVersion) ? "npm install -g skillwiki@latest" : "claude plugin update skillwiki@llm-wiki";
+  const details = drifted.map((plugin) => {
+    const updateCmd = pluginUpdateCommand(plugin, currentVersion);
+    return `${plugin.label} plugin v${plugin.version} \u2260 CLI v${currentVersion} \u2014 run \`${updateCmd}\``;
+  });
   return check(
     "warn",
     "plugin_version_drift",
     "Plugin/CLI version",
-    `Plugin v${pluginVersion} \u2260 CLI v${currentVersion} \u2014 run \`${updateCmd}\``
+    details.join("; ")
   );
 }
+function pluginUpdateCommand(plugin, currentVersion) {
+  if (semverGt(plugin.version, currentVersion)) {
+    return "npm install -g skillwiki@latest";
+  }
+  if (plugin.channel === "claude") {
+    return "claude plugin update skillwiki@llm-wiki";
+  }
+  if (plugin.sourceType === "git") {
+    return "codex plugin marketplace upgrade llm-wiki && codex plugin remove skillwiki@llm-wiki && codex plugin add skillwiki@llm-wiki";
+  }
+  return "codex plugin remove skillwiki@llm-wiki && codex plugin add skillwiki@llm-wiki";
+}
 async function checkProfiles(home) {
   const map = await parseDotenvFile(configPath(home));
   const profiles = [];
@@ -4562,7 +4685,7 @@ async function checkProfiles(home) {
 async function checkProjectLocalOverride(cwd) {
   const dir = cwd ?? process.cwd();
   const envPath = join27(dir, ".skillwiki", ".env");
-  if (existsSync9(envPath)) {
+  if (existsSync10(envPath)) {
     return check("pass", "project_local", "Project-local config", `Found: ${envPath}`);
   }
   return check("pass", "project_local", "Project-local config", "None");
@@ -4571,7 +4694,7 @@ function checkVaultGitRemote(resolvedPath) {
   if (resolvedPath === void 0) {
     return check("error", "vault_git_remote", "Vault git remote", "Cannot check \u2014 WIKI_PATH not resolved");
   }
-  if (!existsSync9(join27(resolvedPath, ".git"))) {
+  if (!existsSync10(join27(resolvedPath, ".git"))) {
     return check("warn", "vault_git_remote", "Vault git remote", "Vault is not a git repository \u2014 sync features unavailable");
   }
   try {
@@ -4594,9 +4717,9 @@ function checkObsidianTemplates(resolvedPath) {
     return check("error", "obsidian_templates", "Obsidian templates", "Cannot check \u2014 WIKI_PATH not resolved");
   }
   const missing = [];
-  if (!existsSync9(join27(resolvedPath, "_Templates"))) missing.push("_Templates/");
-  if (!existsSync9(join27(resolvedPath, ".obsidian", "templates.json"))) missing.push(".obsidian/templates.json");
-  if (!existsSync9(join27(resolvedPath, ".obsidian", "app.json"))) missing.push(".obsidian/app.json");
+  if (!existsSync10(join27(resolvedPath, "_Templates"))) missing.push("_Templates/");
+  if (!existsSync10(join27(resolvedPath, ".obsidian", "templates.json"))) missing.push(".obsidian/templates.json");
+  if (!existsSync10(join27(resolvedPath, ".obsidian", "app.json"))) missing.push(".obsidian/app.json");
   if (missing.length === 0) {
     return check("pass", "obsidian_templates", "Obsidian templates", "Template folder and config present");
   }
@@ -4607,14 +4730,14 @@ function checkDotStoreClean(resolvedPath) {
     return check("error", "dsstore_clean", "No .DS_Store in raw/", "Cannot check \u2014 WIKI_PATH not resolved");
   }
   const rawDir = join27(resolvedPath, "raw");
-  if (!existsSync9(rawDir)) {
+  if (!existsSync10(rawDir)) {
     return check("pass", "dsstore_clean", "No .DS_Store in raw/", "raw/ directory not found \u2014 check skipped");
   }
   const found = [];
   (function walk2(dir, rel) {
     let entries;
     try {
-      entries = readdirSync(dir, { withFileTypes: true });
+      entries = readdirSync2(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -4635,7 +4758,7 @@ function checkSyncLastPush(resolvedPath) {
   if (resolvedPath === void 0) {
     return check("error", "sync_last_push", "Vault sync recency", "Cannot check \u2014 WIKI_PATH not resolved");
   }
-  if (!existsSync9(join27(resolvedPath, ".git"))) {
+  if (!existsSync10(join27(resolvedPath, ".git"))) {
     return check("pass", "sync_last_push", "Vault sync recency", "No git repo \u2014 sync check skipped");
   }
   let timestamp;
@@ -4683,7 +4806,7 @@ function checkVaultGitDirty(resolvedPath) {
   if (resolvedPath === void 0) {
     return check("pass", "vault_git_dirty", "Vault git dirty state", "No vault path \u2014 check skipped");
   }
-  if (!existsSync9(join27(resolvedPath, ".git"))) {
+  if (!existsSync10(join27(resolvedPath, ".git"))) {
     return check("pass", "vault_git_dirty", "Vault git dirty state", "No git repo \u2014 check skipped");
   }
   try {
@@ -4724,7 +4847,7 @@ function checkVaultGitComparison(resolvedPath, id, label, range, nonZeroSuffix,
   if (resolvedPath === void 0) {
     return check("pass", id, label, "No vault path \u2014 check skipped");
   }
-  if (!existsSync9(join27(resolvedPath, ".git"))) {
+  if (!existsSync10(join27(resolvedPath, ".git"))) {
     return check("pass", id, label, "No git repo \u2014 check skipped");
   }
   if (!hasOriginMain(resolvedPath)) {
@@ -4762,7 +4885,7 @@ function isRecentLogLine(line, nowMs) {
   return nowMs - ts <= 24 * 60 * 60 * 1e3;
 }
 function checkVaultGitPullFailures(home) {
-  const path = pullLogPaths(home).find((p) => existsSync9(p));
+  const path = pullLogPaths(home).find((p) => existsSync10(p));
   if (!path) {
     return check("pass", "vault_git_pull_failures", "Vault pull failures", "No wiki-pull.log found \u2014 check skipped");
   }
@@ -4791,7 +4914,7 @@ function checkS3MountPerf(resolvedPath) {
   }
   const mountPoint = fuse.mountPoint;
   const conceptsDir = join27(resolvedPath, "concepts");
-  if (!existsSync9(conceptsDir)) {
+  if (!existsSync10(conceptsDir)) {
     return check("pass", "s3_mount_perf", "S3 mount performance", `S3 FUSE mount (${mountPoint}), no concepts/ to benchmark`);
   }
   const start = Date.now();
@@ -4974,7 +5097,7 @@ function checkWriteTest(resolvedPath) {
     return check("pass", "s3_write_test", "S3 write test", "local disk \u2014 check skipped");
   }
   const conceptsDir = join27(resolvedPath, "concepts");
-  if (!existsSync9(conceptsDir)) {
+  if (!existsSync10(conceptsDir)) {
     return check("pass", "s3_write_test", "S3 write test", "no concepts/ dir to test \u2014 check skipped");
   }
   const result = writeTest(conceptsDir);
@@ -5099,7 +5222,7 @@ function vaultSyncChecks(input) {
   const filterPath = input.filterPath ?? join27(home, ".config", "rclone", "wiki-push-filters.txt");
   const snapshotPath = input.snapshotScriptPath ?? "/root/.hermes/scripts/wiki-snapshot-v3.sh";
   const pushScriptPath = join27(shareDir, "wiki-push.sh");
-  const c1 = existsSync9(pushScriptPath) ? check("pass", "vault_sync_installed", "Vault sync installed", `Found: ${pushScriptPath}`) : check("error", "vault_sync_installed", "Vault sync installed", `Script not found at ${pushScriptPath} \u2014 run vault-sync-install`);
+  const c1 = existsSync10(pushScriptPath) ? check("pass", "vault_sync_installed", "Vault sync installed", `Found: ${pushScriptPath}`) : check("error", "vault_sync_installed", "Vault sync installed", `Script not found at ${pushScriptPath} \u2014 run vault-sync-install`);
   let c2;
   try {
     if (isMac) {
@@ -5209,7 +5332,7 @@ function vaultSyncChecks(input) {
       }
     }
   } catch {
-    c3 = existsSync9(logDir) ? check(
+    c3 = existsSync10(logDir) ? check(
       "warn",
       "vault_sync_last_push_age",
       "Vault sync last push recency",
@@ -5268,7 +5391,7 @@ function vaultSyncChecks(input) {
   }
   let c4;
   try {
-    if (!existsSync9(filterPath)) {
+    if (!existsSync10(filterPath)) {
       c4 = check(
         "error",
         "vault_sync_filter_present",
@@ -5317,7 +5440,7 @@ function vaultSyncChecks(input) {
     );
   } else {
     try {
-      if (!existsSync9(snapshotPath)) {
+      if (!existsSync10(snapshotPath)) {
         c5 = check(
           "error",
           "vault_sync_snapshot_guard",
@@ -5357,7 +5480,7 @@ function findSkillMd(dir) {
   const results = [];
   let entries;
   try {
-    entries = readdirSync(dir, { withFileTypes: true });
+    entries = readdirSync2(dir, { withFileTypes: true });
   } catch {
     return results;
   }
@@ -5378,12 +5501,12 @@ function findSkillNames(dir) {
   const results = [];
   let entries;
   try {
-    entries = readdirSync(dir, { withFileTypes: true });
+    entries = readdirSync2(dir, { withFileTypes: true });
   } catch {
     return results;
   }
   for (const entry of entries) {
-    if (entry.isDirectory() && existsSync9(join27(dir, entry.name, "SKILL.md"))) {
+    if (entry.isDirectory() && existsSync10(join27(dir, entry.name, "SKILL.md"))) {
       results.push(entry.name);
     }
   }
@@ -6057,7 +6180,7 @@ async function runUpdate(input) {
     readFileSync8(new URL("../../package.json", import.meta.url), "utf8")
   );
   const currentVersion = pkg2.version;
-  const tag = input.distTag ?? "latest";
+  const tag = normalizeDistTag(input.distTag);
   const target = join29(input.home, ".claude", "skills");
   let latest;
   try {
@@ -6074,7 +6197,8 @@ async function runUpdate(input) {
   const cache = {
     lastCheck: Date.now(),
     latestVersion: latest,
-    currentVersion
+    currentVersion,
+    distTag: tag
   };
   if (latest === currentVersion) {
     writeCache(input.home, cache);
@@ -6086,7 +6210,7 @@ async function runUpdate(input) {
         wasAlreadyLatest: true,
         version_warnings: [],
         skills_refreshed: false,
-        humanHint: `Already on latest ${tag}: v${currentVersion}`
+        humanHint: `Already on npm@${tag}: v${currentVersion}`
       })
     };
   }
@@ -6106,7 +6230,7 @@ async function runUpdate(input) {
   const version_warnings = installResult.warnings;
   const skills_refreshed = installResult.refreshed;
   const hintLines = [
-    `Updated skillwiki ${currentVersion} \u2192 ${latest}`,
+    `Updated skillwiki ${currentVersion} \u2192 ${latest} via npm@${tag}`,
     `skills refreshed: ${skills_refreshed}`
   ];
   if (version_warnings.length > 0) {
@@ -6128,7 +6252,7 @@ async function runUpdate(input) {
 
 // src/commands/self-update.ts
 import { execSync as execSync4 } from "child_process";
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9 } from "fs";
 import { join as join30 } from "path";
 var DEFAULT_SOURCE_ROOT_SUFFIX = "/Desktop/code/llm-wiki";
 async function runSelfUpdate(input) {
@@ -6136,8 +6260,9 @@ async function runSelfUpdate(input) {
     readFileSync9(new URL("../../package.json", import.meta.url), "utf8")
   ).version;
   const sourceRoot = input.sourceRoot ?? `${input.home}${DEFAULT_SOURCE_ROOT_SUFFIX}`;
+  const distTag = normalizeDistTag(input.distTag);
   const localPkgPath = join30(sourceRoot, "packages", "cli", "package.json");
-  const hasLocalSource = existsSync10(localPkgPath);
+  const hasLocalSource = existsSync11(localPkgPath);
   if (input.check) {
     let availableVersion = null;
     let source;
@@ -6151,7 +6276,7 @@ async function runSelfUpdate(input) {
     } else {
       source = "npm";
       try {
-        availableVersion = execSync4("npm view skillwiki@latest version", {
+        availableVersion = execSync4(`npm view skillwiki@${distTag} version`, {
           encoding: "utf8",
           timeout: 15e3
         }).trim();
@@ -6221,7 +6346,7 @@ async function runSelfUpdate(input) {
   }
   let latestVersion;
   try {
-    latestVersion = execSync4("npm view skillwiki@latest version", {
+    latestVersion = execSync4(`npm view skillwiki@${distTag} version`, {
       encoding: "utf8",
       timeout: 15e3
     }).trim();
@@ -6239,12 +6364,12 @@ async function runSelfUpdate(input) {
         currentVersion,
         availableVersion: latestVersion,
         updateAvailable: false,
-        humanHint: `Already on latest: v${currentVersion}`
+        humanHint: `Already on ${distTag}: v${currentVersion}`
       })
     };
   }
   try {
-    execSync4("npm install -g skillwiki@latest", {
+    execSync4(`npm install -g skillwiki@${distTag}`, {
       stdio: "pipe",
       timeout: 6e4
     });
@@ -6262,7 +6387,7 @@ async function runSelfUpdate(input) {
       availableVersion: latestVersion,
       updateAvailable: true,
       newVersion: latestVersion,
-      humanHint: `Updated skillwiki ${currentVersion} \u2192 ${latestVersion} via npm@latest`
+      humanHint: `Updated skillwiki ${currentVersion} \u2192 ${latestVersion} via npm@${distTag}`
     })
   };
 }
@@ -6445,7 +6570,7 @@ ${entries.map((e) => `  ${e.type}: [[${e.page.replace(/\.md$/, "")}]] \u2014 ${e
 // src/commands/compound.ts
 import { writeFile as writeFile12, mkdir as mkdir11, readdir as readdir7, unlink as unlink4 } from "fs/promises";
 import { join as join33 } from "path";
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import { readFile as readFile23 } from "fs/promises";
 var RETRO_HEADING_RE = /^## \[(\d{4}-\d{2}-\d{2})(?:\s+[^\]]+)?\] retro \| loop cycle(?: (\d+))?: (.+)$/;
 var FIELD_RE = {
@@ -6563,7 +6688,7 @@ async function runCompound(input) {
     }
     const slug = slugify(entry.cycleName);
     const compoundPath = join33(compoundDir, `${slug}.md`);
-    if (existsSync11(compoundPath)) {
+    if (existsSync12(compoundPath)) {
       skipped.push(entry.date);
       continue;
     }
@@ -6601,7 +6726,7 @@ async function runCompound(input) {
     ].join("\n");
     const content = frontmatter + "\n" + body;
     if (!input.dryRun) {
-      if (!existsSync11(compoundDir)) {
+      if (!existsSync12(compoundDir)) {
         await mkdir11(compoundDir, { recursive: true });
       }
       await writeFile12(compoundPath, content, "utf8");
@@ -6624,7 +6749,7 @@ async function runCompound(input) {
 }
 async function runCompoundDelete(input) {
   const projectDir = join33(input.vault, "projects", input.project);
-  if (!existsSync11(projectDir)) {
+  if (!existsSync12(projectDir)) {
     return {
       exitCode: ExitCode.PROJECT_NOT_FOUND,
       result: err("PROJECT_NOT_FOUND", { slug: input.project, path: projectDir })
@@ -6632,7 +6757,7 @@ async function runCompoundDelete(input) {
   }
   const entryName = input.entry.replace(/\.md$/, "");
   const compoundPath = join33(projectDir, "compound", `${entryName}.md`);
-  if (!existsSync11(compoundPath)) {
+  if (!existsSync12(compoundPath)) {
     return {
       exitCode: ExitCode.FILE_NOT_FOUND,
       result: err("FILE_NOT_FOUND", { path: compoundPath })
@@ -6666,7 +6791,7 @@ knowledge.md regenerated`
 }
 async function runCompoundList(input) {
   const compoundDir = join33(input.vault, "projects", input.project, "compound");
-  if (!existsSync11(compoundDir)) {
+  if (!existsSync12(compoundDir)) {
     return {
       exitCode: ExitCode.OK,
       result: ok({
@@ -6729,7 +6854,7 @@ no compound entries found`;
 
 // src/commands/observe.ts
 import { mkdir as mkdir12, writeFile as writeFile13 } from "fs/promises";
-import { existsSync as existsSync12, statSync as statSync4 } from "fs";
+import { existsSync as existsSync13, statSync as statSync4 } from "fs";
 import { join as join34 } from "path";
 import { createHash as createHash4 } from "crypto";
 var ALLOWED_KINDS = /* @__PURE__ */ new Set(["note", "bug", "task", "idea", "session-log"]);
@@ -6753,7 +6878,7 @@ async function runObserve(input) {
       result: err("SCHEME_REJECTED", { message: "Text must not be empty" })
     };
   }
-  if (!existsSync12(input.vault) || !statSync4(input.vault).isDirectory()) {
+  if (!existsSync13(input.vault) || !statSync4(input.vault).isDirectory()) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: err("VAULT_PATH_INVALID", { path: input.vault })
@@ -7257,11 +7382,11 @@ ${body}`;
 }
 
 // src/commands/sync.ts
-import { existsSync as existsSync14 } from "fs";
+import { existsSync as existsSync15 } from "fs";
 import { join as join37 } from "path";
 
 // src/utils/sync-lock.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync4, readFileSync as readFileSync10, renameSync, unlinkSync as unlinkSync5, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync4, readFileSync as readFileSync10, renameSync, unlinkSync as unlinkSync5, writeFileSync as writeFileSync6 } from "fs";
 import { join as join36 } from "path";
 import { createHash as createHash6 } from "crypto";
 function getSessionId() {
@@ -7274,7 +7399,7 @@ function lockPath(vault) {
 }
 function readLock(vault) {
   const path = lockPath(vault);
-  if (!existsSync13(path)) return null;
+  if (!existsSync14(path)) return null;
   try {
     const raw = readFileSync10(path, "utf8");
     return JSON.parse(raw);
@@ -7290,7 +7415,7 @@ function isStale(lock, now) {
 function acquireLock(vault, opts = {}) {
   const path = lockPath(vault);
   const dir = join36(vault, ".skillwiki");
-  if (!existsSync13(dir)) {
+  if (!existsSync14(dir)) {
     mkdirSync4(dir, { recursive: true });
   }
   const sessionId = opts.sessionId ?? getSessionId();
@@ -7335,7 +7460,7 @@ function writeLockedFile(path, lock) {
 }
 function releaseLock(vault, opts = {}) {
   const path = lockPath(vault);
-  if (!existsSync13(path)) {
+  if (!existsSync14(path)) {
     return { released: false };
   }
   const sessionId = opts.sessionId ?? getSessionId();
@@ -7364,7 +7489,7 @@ function releaseLock(vault, opts = {}) {
 function runSyncStatus(input) {
   const vault = input.vault;
   const includeStashes = input.includeStashes ?? false;
-  if (!existsSync14(join37(vault, ".git"))) {
+  if (!existsSync15(join37(vault, ".git"))) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: ok({
@@ -7442,7 +7567,7 @@ function runSyncStatus(input) {
 }
 async function runSyncPush(input) {
   const vault = input.vault;
-  if (!existsSync14(join37(vault, ".git"))) {
+  if (!existsSync15(join37(vault, ".git"))) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: err("NOT_A_GIT_REPO", { path: vault })
@@ -7565,7 +7690,7 @@ function enableGitLongPathsOnWindows(vault) {
 }
 async function runSyncPull(input) {
   const vault = input.vault;
-  if (!existsSync14(join37(vault, ".git"))) {
+  if (!existsSync15(join37(vault, ".git"))) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: err("NOT_A_GIT_REPO", { path: vault })
@@ -7737,7 +7862,7 @@ function runSyncPeers(input) {
 }
 function runSyncLock(input) {
   const vault = input.vault;
-  if (!existsSync14(vault)) {
+  if (!existsSync15(vault)) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: err("VAULT_PATH_INVALID", { path: vault })
@@ -7772,7 +7897,7 @@ function runSyncLock(input) {
 }
 function runSyncUnlock(input) {
   const vault = input.vault;
-  if (!existsSync14(vault)) {
+  if (!existsSync15(vault)) {
     return {
       exitCode: ExitCode.VAULT_PATH_INVALID,
       result: err("VAULT_PATH_INVALID", { path: vault })
@@ -7805,7 +7930,7 @@ function runSyncUnlock(input) {
 }
 
 // src/commands/backup.ts
-import { statSync as statSync5, readdirSync as readdirSync2, readFileSync as readFileSync11, mkdirSync as mkdirSync5, writeFileSync as writeFileSync7 } from "fs";
+import { statSync as statSync5, readdirSync as readdirSync3, readFileSync as readFileSync11, mkdirSync as mkdirSync5, writeFileSync as writeFileSync7 } from "fs";
 import { join as join38, relative as relative3, dirname as dirname12 } from "path";
 import { PutObjectCommand, HeadObjectCommand, ListObjectsV2Command, GetObjectCommand, DeleteObjectsCommand } from "@aws-sdk/client-s3";
 
@@ -7828,7 +7953,7 @@ function createS3Client(config) {
 // src/commands/backup.ts
 var SKIP_DIRS2 = /* @__PURE__ */ new Set([".git", ".obsidian", "_archive", "node_modules", ".skillwiki"]);
 function* walkMarkdown(dir, base) {
-  for (const entry of readdirSync2(dir, { withFileTypes: true })) {
+  for (const entry of readdirSync3(dir, { withFileTypes: true })) {
     if (SKIP_DIRS2.has(entry.name)) continue;
     const full = join38(dir, entry.name);
     if (entry.isDirectory()) {
@@ -7975,11 +8100,11 @@ async function runBackupRestore(input) {
 }
 
 // src/commands/status.ts
-import { existsSync as existsSync15, statSync as statSync6 } from "fs";
+import { existsSync as existsSync16, statSync as statSync6 } from "fs";
 import { readFile as readFile25 } from "fs/promises";
 import { join as join39 } from "path";
 async function runStatus(input) {
-  if (!existsSync15(input.vault)) {
+  if (!existsSync16(input.vault)) {
     return { exitCode: ExitCode.VAULT_PATH_INVALID, result: err("VAULT_PATH_INVALID", { vault: input.vault }) };
   }
   const scan = await scanVault(input.vault);
@@ -8180,7 +8305,7 @@ async function runSeed(input) {
 
 // src/commands/canvas.ts
 import { readFile as readFile26, writeFile as writeFile16 } from "fs/promises";
-import { existsSync as existsSync16 } from "fs";
+import { existsSync as existsSync17 } from "fs";
 import { join as join41 } from "path";
 var NODE_WIDTH = 240;
 var NODE_HEIGHT = 60;
@@ -8260,7 +8385,7 @@ function buildCanvasEdges(adjacency) {
 }
 async function runCanvasGenerate(input) {
   const graphPath = input.graphPath ?? join41(input.vault, ".skillwiki", "graph.json");
-  if (!existsSync16(graphPath)) {
+  if (!existsSync17(graphPath)) {
     return {
       exitCode: ExitCode.FILE_NOT_FOUND,
       result: err("FILE_NOT_FOUND", {
@@ -8463,14 +8588,14 @@ async function loadOrBuildGraph(vault) {
 }
 
 // src/utils/auto-commit.ts
-import { existsSync as existsSync17 } from "fs";
+import { existsSync as existsSync18 } from "fs";
 import { join as join43 } from "path";
 async function postCommit(vault, exitCode) {
   if (exitCode !== 0) return;
   const home = process.env.HOME ?? "";
   const dotenv = await parseDotenvFile(configPath(home));
   if (dotenv["AUTO_COMMIT"] === "false") return;
-  if (!existsSync17(join43(vault, ".git"))) return;
+  if (!existsSync18(join43(vault, ".git"))) return;
   const lastOps = readLastOp(vault);
   if (lastOps.length === 0) return;
   const porcelain = git(vault, ["status", "--porcelain"]);
@@ -8711,13 +8836,14 @@ program.command("frontmatter-fix [vault]").description("fix common frontmatter i
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runFrontmatterFix({ vault: v.vault, dryRun: !!opts.dryRun }), v.vault);
 });
-program.command("update").description("update skillwiki CLI to the latest version").option("--tag <tag>", "npm dist-tag", "latest").action(async (opts) => emit(await runUpdate({
+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 ?? "",
   distTag: opts.tag
 })));
-program.command("self-update").description("update skillwiki CLI from local source or npm@latest").option("--check", "check for updates without installing", false).action(async (opts) => emit(await runSelfUpdate({
+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 ?? "",
-  check: !!opts.check
+  check: !!opts.check,
+  distTag: opts.tag
 })));
 program.command("transcripts [vault]").description("list transcript files in raw/transcripts/").option("--since <date>", "only files ingested on or after this date (YYYY-MM-DD)").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
   const v = await resolveVaultArg(vault, opts.wiki);

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.5-beta.1",
+  "version": "0.8.5-beta.3",
   "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.8.5-beta.1",
+  "version": "0.8.5-beta.3",
   "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.8.5-beta.1",
+  "version": "0.8.5-beta.3",
   "private": true,
   "files": [
     "wiki-*",