@skein-code/cli 0.2.2 → 0.2.3

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/cli.tsx
 import { createInterface as createInterface2 } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
-import { writeFile as writeFile2 } from "node:fs/promises";
+import { writeFile as writeFile3 } from "node:fs/promises";
 import { basename as basename12, resolve as resolve22 } from "node:path";
 import { Command, Option } from "commander";
 import chalk3 from "chalk";
@@ -220,7 +220,7 @@ function isSqliteBusy(error) {
 // package.json
 var package_default = {
   name: "@skein-code/cli",
-  version: "0.2.2",
+  version: "0.2.3",
   description: "A context-first, model-agnostic coding agent with an auditable terminal workspace.",
   type: "module",
   license: "MIT",
@@ -11135,6 +11135,9 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
     if (item.kind === "banner") {
       return /* @__PURE__ */ jsx(Banner, { model: item.model, engine: item.engine, workspace: item.workspace, version: item.version, width, glyphs }, item.id);
     }
+    if (item.kind === "update") {
+      return /* @__PURE__ */ jsx(UpdateNotice, { current: item.current, latest: item.latest, command: item.command, width, glyphs }, item.id);
+    }
     const color = item.tone === "error" ? theme.error : item.tone === "success" ? theme.success : theme.muted;
     const noticeGlyph = item.tone === "error" ? glyphs.error : item.tone === "success" ? glyphs.success : glyphs.info;
     return /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, { color, wrap: "wrap", children: `${noticeGlyph} ${sanitizeTerminalText(item.text)}` }) }, item.id);
@@ -11708,6 +11711,20 @@ function Banner({ model, engine, workspace, version, width, glyphs }) {
     /* @__PURE__ */ jsx(Text, { color: theme.dim, children: truncateDisplay(`type a request ${glyphs.separator} /help for commands ${glyphs.separator} @ to attach files`, innerWidth) })
   ] });
 }
+function UpdateNotice({ current, latest, command: command2, width, glyphs }) {
+  const theme = useTheme();
+  const parts = [
+    { text: glyphs.up, color: theme.accent, bold: true },
+    { text: " a new version is available  ", color: theme.text, bold: false },
+    { text: `v${current}`, color: theme.dim, bold: false },
+    { text: ` ${glyphs.arrow} `, color: theme.muted, bold: false },
+    { text: `v${latest}`, color: theme.success, bold: true },
+    { text: `   ${command2}`, color: theme.dim, bold: false }
+  ];
+  const rendered = truncateDisplay(parts.map((part) => part.text).join(""), safeWidth(width));
+  const truncated = rendered.length < parts.map((part) => part.text).join("").length;
+  return /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: truncated ? /* @__PURE__ */ jsx(Text, { color: theme.muted, children: rendered }) : parts.map((part, index) => /* @__PURE__ */ jsx(Text, { color: part.color, bold: part.bold, children: part.text }, index)) });
+}
 function RichText({ value, glyphs }) {
   const theme = useTheme();
   let inCode = false;
@@ -11800,6 +11817,141 @@ function safeWidth(width) {
   return Math.max(1, Math.floor(Number.isFinite(width) ? width : 80));
 }
 
+// src/utils/update-check.ts
+import { mkdir as mkdir9, readFile as readFile15, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join16 } from "node:path";
+var PACKAGE_NAME = "@skein-code/cli";
+var REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+var CACHE_FILE = "update-check.json";
+var CHECK_INTERVAL_MS = 1e3 * 60 * 60 * 24;
+var FETCH_TIMEOUT_MS = 3e3;
+var MAX_BODY_BYTES = 1e6;
+function truthyEnv(value) {
+  return value !== void 0 && value !== "" && value !== "false" && value !== "0";
+}
+function isCi(env) {
+  return truthyEnv(env.CI) || truthyEnv(env.CONTINUOUS_INTEGRATION) || truthyEnv(env.GITHUB_ACTIONS) || truthyEnv(env.GITLAB_CI) || truthyEnv(env.BUILD_NUMBER);
+}
+function isUpdateCheckDisabled(env = process.env) {
+  if (truthyEnv(env.SKEIN_NO_UPDATE_CHECK) || truthyEnv(env.MOSAIC_NO_UPDATE_CHECK) || truthyEnv(env.NO_UPDATE_NOTIFIER)) {
+    return true;
+  }
+  if (env.NODE_ENV === "test") return true;
+  return isCi(env);
+}
+function parseVersion(value) {
+  const cleaned = value.trim().replace(/^v/iu, "");
+  const buildAt = cleaned.indexOf("+");
+  const noBuild = buildAt === -1 ? cleaned : cleaned.slice(0, buildAt);
+  const dashAt = noBuild.indexOf("-");
+  const mainStr = dashAt === -1 ? noBuild : noBuild.slice(0, dashAt);
+  const preStr = dashAt === -1 ? "" : noBuild.slice(dashAt + 1);
+  const parts = mainStr.split(".");
+  if (parts.length !== 3) return null;
+  const [major, minor, patch] = parts.map((part) => Number(part));
+  if ([major, minor, patch].some((n) => n === void 0 || !Number.isInteger(n) || n < 0)) return null;
+  return { main: [major, minor, patch], pre: preStr ? preStr.split(".") : [] };
+}
+function compareVersions(a, b) {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  if (!pa || !pb) return a === b ? 0 : a < b ? -1 : 1;
+  for (let i = 0; i < 3; i++) {
+    const x = pa.main[i];
+    const y = pb.main[i];
+    if (x !== y) return x < y ? -1 : 1;
+  }
+  if (pa.pre.length === 0 && pb.pre.length === 0) return 0;
+  if (pa.pre.length === 0) return 1;
+  if (pb.pre.length === 0) return -1;
+  const len = Math.max(pa.pre.length, pb.pre.length);
+  for (let i = 0; i < len; i++) {
+    const x = pa.pre[i];
+    const y = pb.pre[i];
+    if (x === void 0) return -1;
+    if (y === void 0) return 1;
+    const xNum = /^\d+$/u.test(x);
+    const yNum = /^\d+$/u.test(y);
+    if (xNum && yNum) {
+      const nx = Number(x);
+      const ny = Number(y);
+      if (nx !== ny) return nx < ny ? -1 : 1;
+    } else if (xNum !== yNum) {
+      return xNum ? -1 : 1;
+    } else if (x !== y) {
+      return x < y ? -1 : 1;
+    }
+  }
+  return 0;
+}
+function updateCachePath(env = process.env) {
+  return join16(resolveHomeNamespace(env), CACHE_FILE);
+}
+function upgradeCommand() {
+  return `npm i -g ${PACKAGE_NAME}`;
+}
+function updateNoticeText(notice) {
+  return `Update available ${notice.current} \u2192 ${notice.latest} \xB7 run ${notice.command}`;
+}
+function noticeIfNewer(latest, current) {
+  if (latest && compareVersions(latest, current) > 0) {
+    return { current, latest, command: upgradeCommand() };
+  }
+  return void 0;
+}
+async function readUpdateCache(env = process.env) {
+  try {
+    const raw = await readFile15(updateCachePath(env), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.checkedAt === "number" && (typeof parsed.latest === "string" || parsed.latest === null)) {
+      return { checkedAt: parsed.checkedAt, latest: parsed.latest };
+    }
+  } catch {
+  }
+  return null;
+}
+async function writeUpdateCache(cache, env) {
+  try {
+    const dir = resolveHomeNamespace(env);
+    await mkdir9(dir, { recursive: true, mode: 448 });
+    await writeFile2(updateCachePath(env), JSON.stringify(cache), "utf8");
+  } catch {
+  }
+}
+async function fetchLatestVersion(fetchImpl, url = REGISTRY_URL) {
+  try {
+    const response = await fetchImpl(url, {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+    });
+    if (!response.ok) return null;
+    const body = await response.text();
+    if (body.length > MAX_BODY_BYTES) return null;
+    const parsed = JSON.parse(body);
+    return typeof parsed.version === "string" ? parsed.version : null;
+  } catch {
+    return null;
+  }
+}
+async function resolveCachedUpdateNotice(currentVersion, env = process.env) {
+  if (isUpdateCheckDisabled(env)) return void 0;
+  const cache = await readUpdateCache(env);
+  return noticeIfNewer(cache?.latest ?? null, currentVersion);
+}
+async function refreshUpdateCache(currentVersion, options = {}) {
+  const env = options.env ?? process.env;
+  if (isUpdateCheckDisabled(env)) return void 0;
+  const cache = await readUpdateCache(env);
+  const now = Date.now();
+  if (!options.force && cache && now - cache.checkedAt < CHECK_INTERVAL_MS) {
+    return noticeIfNewer(cache.latest, currentVersion);
+  }
+  const latest = await fetchLatestVersion(options.fetchImpl ?? fetch);
+  const effectiveLatest = latest ?? cache?.latest ?? null;
+  await writeUpdateCache({ checkedAt: now, latest: effectiveLatest }, env);
+  return noticeIfNewer(effectiveLatest, currentVersion);
+}
+
 // src/ui/composer.tsx
 import { useEffect, useRef, useState } from "react";
 import { Text as Text2, useInput, usePaste } from "ink";
@@ -12722,6 +12874,29 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
   useEffect2(() => {
     setSuggestionIndex(0);
   }, [input2]);
+  useEffect2(() => {
+    let cancelled = false;
+    const showNotice = (notice) => {
+      if (cancelled || !notice) return;
+      setTimeline((items) => {
+        const bannerIndex = items.findIndex((item) => item.kind === "banner");
+        if (bannerIndex === -1) return items;
+        const existing = items.find((item) => item.kind === "update");
+        if (existing) {
+          if (existing.kind === "update" && existing.latest === notice.latest) return items;
+          return items.map((item) => item === existing ? { id: item.id, kind: "update", current: notice.current, latest: notice.latest, command: notice.command } : item);
+        }
+        const next = items.slice();
+        next.splice(bannerIndex + 1, 0, { id: nextId(), kind: "update", current: notice.current, latest: notice.latest, command: notice.command });
+        return next;
+      });
+    };
+    void resolveCachedUpdateNotice(package_default.version).then(showNotice);
+    void refreshUpdateCache(package_default.version).then(showNotice);
+    return () => {
+      cancelled = true;
+    };
+  }, []);
   useEffect2(() => {
     if (suggestionMode !== "mention" || !mentionToken) {
       mentionRequest.current += 1;
@@ -14913,9 +15088,9 @@ function scopeKey(scope, context) {
 }
 
 // src/skills/catalog.ts
-import { lstat as lstat19, readFile as readFile15, readdir as readdir7, realpath as realpath8 } from "node:fs/promises";
+import { lstat as lstat19, readFile as readFile16, readdir as readdir7, realpath as realpath8 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
-import { basename as basename11, join as join16, resolve as resolve20 } from "node:path";
+import { basename as basename11, join as join17, resolve as resolve20 } from "node:path";
 import { parse as parseYaml3 } from "yaml";
 var SkillCatalog = class {
   constructor(workspace, config) {
@@ -14935,7 +15110,7 @@ var SkillCatalog = class {
     for (const location of locations) {
       const entries = await safeDirectories(location.path);
       for (const entry of entries) {
-        const skillPath = join16(location.path, entry, "SKILL.md");
+        const skillPath = join17(location.path, entry, "SKILL.md");
         const metadata = await readMetadata(skillPath);
         if (!metadata) continue;
         const descriptor = {
@@ -14986,10 +15161,10 @@ function discoveryLocations(workspace, configured) {
   const home = homedir4();
   const workspaceRoot = resolve20(workspace);
   return [
-    { path: join16(home, ".agents", "skills"), scope: "user", trusted: true },
-    { path: join16(home, ".claude", "skills"), scope: "user", trusted: true },
-    { path: join16(home, ".augment", "skills"), scope: "user", trusted: true },
-    { path: join16(resolveHomeNamespace(), "skills"), scope: "user", trusted: true },
+    { path: join17(home, ".agents", "skills"), scope: "user", trusted: true },
+    { path: join17(home, ".claude", "skills"), scope: "user", trusted: true },
+    { path: join17(home, ".augment", "skills"), scope: "user", trusted: true },
+    { path: join17(resolveHomeNamespace(), "skills"), scope: "user", trusted: true },
     ...configured.map((path) => {
       const resolved = resolve20(workspaceRoot, path);
       return {
@@ -14998,10 +15173,10 @@ function discoveryLocations(workspace, configured) {
         trusted: !isInside(workspaceRoot, resolved)
       };
     }),
-    { path: join16(workspace, ".agents", "skills"), scope: "workspace", trusted: false },
-    { path: join16(workspace, ".claude", "skills"), scope: "workspace", trusted: false },
-    { path: join16(workspace, ".augment", "skills"), scope: "workspace", trusted: false },
-    { path: join16(resolveProjectNamespaceSync(workspaceRoot).active, "skills"), scope: "workspace", trusted: false }
+    { path: join17(workspace, ".agents", "skills"), scope: "workspace", trusted: false },
+    { path: join17(workspace, ".claude", "skills"), scope: "workspace", trusted: false },
+    { path: join17(workspace, ".augment", "skills"), scope: "workspace", trusted: false },
+    { path: join17(resolveProjectNamespaceSync(workspaceRoot).active, "skills"), scope: "workspace", trusted: false }
   ];
 }
 async function safeDirectories(path) {
@@ -15045,7 +15220,7 @@ async function safeRead(path, maxBytes) {
     const resolvedParent = await realpath8(parent);
     const resolvedPath = await realpath8(path);
     if (!resolvedPath.startsWith(`${resolvedParent}/`)) return void 0;
-    return await readFile15(path, "utf8");
+    return await readFile16(path, "utf8");
   } catch {
     return void 0;
   }
@@ -15475,10 +15650,12 @@ program.command("status").description("Show model, context, workspace, and index
   const engine = new ContextEngine(config);
   const status = await engine.status();
   const namespace = resolveProjectNamespaceSync(config.workspaceRoots[0] ?? process.cwd());
+  const update = await refreshUpdateCache(package_default.version).catch(() => void 0);
   if (options.json === true) {
-    printObject({ config: configSummary(config), context: status, namespace }, true);
+    const updateJson = update ? { current: update.current, latest: update.latest, command: update.command } : { current: package_default.version, latest: null, command: upgradeCommand() };
+    printObject({ config: configSummary(config), context: status, namespace, update: updateJson }, true);
   } else {
-    printStatusSummary(config, status, namespace);
+    printStatusSummary(config, status, namespace, update);
   }
 });
 program.command("doctor").description("Diagnose prerequisites and safe fallbacks").option("-w, --workspace <path>", "workspace root").option("--config <path>", "explicit config file").option("--json", "print JSON").option("--visual", "inspect terminal rendering, glyphs, and keyboard support").action(async (options) => {
@@ -15581,7 +15758,7 @@ sessionCommand.command("export <id>").description("Export a session as Markdown"
   const store = new SessionStore(workspaceOption(options.workspace));
   const session = await requireSessionSelector(store, id);
   const markdown = sessionMarkdown(session);
-  if (options.output) await writeFile2(resolve22(options.output), markdown, "utf8");
+  if (options.output) await writeFile3(resolve22(options.output), markdown, "utf8");
   else process.stdout.write(markdown);
 });
 var checkpointCommand = program.command("checkpoint").description("Inspect and restore pre-mutation snapshots");
@@ -16219,7 +16396,7 @@ function printObject(value, json) {
   else process.stdout.write(`${JSON.stringify(value, null, 2)}
 `);
 }
-function printStatusSummary(config, context, namespace) {
+function printStatusSummary(config, context, namespace, update) {
   const glyphs = cliGlyphs;
   const dim = (text) => chalk3.dim(text);
   const line = (level, name, detail) => {
@@ -16248,6 +16425,7 @@ function printStatusSummary(config, context, namespace) {
   const storageDetail = namespace.activeKind === "canonical" ? `${namespaceName} (canonical)` : namespace.phase === "active" ? `${namespaceName} (legacy; new projects switch to .skein from 0.3.0)` : `${namespaceName} (legacy; run ${PRODUCT_COMMAND} migrate --yes before removal)`;
   const storageReady = namespace.activeKind === "canonical" || namespace.phase === "active";
   line(storageReady ? "ok" : "warn", "Storage", storageDetail);
+  line(update ? "warn" : "ok", "Version", update ? updateNoticeText(update) : `v${package_default.version} (up to date)`);
   process.stdout.write(`
 ${dim(`Run ${PRODUCT_COMMAND} status --json for the full machine-readable record.`)}
 `);