skillwiki 0.8.5-beta.2 → 0.8.5-beta.4

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,14 +1,19 @@
 #!/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
 } from "./chunk-TPS5XD2J.js";
 
 // src/cli.ts
-import { readFileSync as readFileSync12 } from "fs";
 import { join as join44 } from "path";
 import { Command as Command2 } from "commander";
 
@@ -4020,14 +4025,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 +4050,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 +4068,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"
   });
@@ -4610,14 +4613,14 @@ 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 plugins = findPluginInstallations(home);
@@ -6143,8 +6146,30 @@ ${newBody}`;
 
 // src/commands/update.ts
 import { execSync as execSync3 } from "child_process";
-import { readFileSync as readFileSync8 } from "fs";
 import { join as join29 } from "path";
+
+// src/utils/package-info.ts
+import { readFileSync as readFileSync8 } from "fs";
+function packageJsonCandidateUrls(baseUrl = import.meta.url) {
+  return [
+    new URL("../package.json", baseUrl),
+    new URL("../../package.json", baseUrl)
+  ];
+}
+function readCliPackageJson(baseUrl = import.meta.url) {
+  for (const url of packageJsonCandidateUrls(baseUrl)) {
+    try {
+      const pkg2 = JSON.parse(readFileSync8(url, "utf8"));
+      if (typeof pkg2.version === "string") {
+        return { ...pkg2, version: pkg2.version };
+      }
+    } catch {
+    }
+  }
+  throw new Error(`Could not locate skillwiki package.json from ${baseUrl}`);
+}
+
+// src/commands/update.ts
 function resolveGlobalSkillsRoot() {
   try {
     const globalRoot = execSync3("npm root -g", {
@@ -6172,11 +6197,9 @@ async function refreshInstalledSkills(target) {
   }
 }
 async function runUpdate(input) {
-  const pkg2 = JSON.parse(
-    readFileSync8(new URL("../../package.json", import.meta.url), "utf8")
-  );
+  const pkg2 = readCliPackageJson();
   const currentVersion = pkg2.version;
-  const tag = input.distTag ?? "latest";
+  const tag = normalizeDistTag(input.distTag);
   const target = join29(input.home, ".claude", "skills");
   let latest;
   try {
@@ -6193,7 +6216,8 @@ async function runUpdate(input) {
   const cache = {
     lastCheck: Date.now(),
     latestVersion: latest,
-    currentVersion
+    currentVersion,
+    distTag: tag
   };
   if (latest === currentVersion) {
     writeCache(input.home, cache);
@@ -6205,7 +6229,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}`
       })
     };
   }
@@ -6225,7 +6249,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) {
@@ -6251,10 +6275,9 @@ 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) {
-  const currentVersion = JSON.parse(
-    readFileSync9(new URL("../../package.json", import.meta.url), "utf8")
-  ).version;
+  const currentVersion = readCliPackageJson().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 = existsSync11(localPkgPath);
   if (input.check) {
@@ -6270,7 +6293,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();
@@ -6340,7 +6363,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();
@@ -6358,12 +6381,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
     });
@@ -6381,7 +6404,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}`
     })
   };
 }
@@ -8618,7 +8641,7 @@ async function postCommit(vault, exitCode) {
 }
 
 // src/cli.ts
-var pkg = JSON.parse(readFileSync12(new URL("../package.json", import.meta.url), "utf8"));
+var pkg = readCliPackageJson();
 var program = new Command2();
 program.name("skillwiki").description("Deterministic helpers for CodeWiki skills").version(pkg.version);
 program.option("--human", "render terminal-readable output instead of JSON");
@@ -8830,13 +8853,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.2",
+  "version": "0.8.5-beta.4",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

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

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