@skein-code/cli 0.2.1 → 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.1",
+  version: "0.2.3",
   description: "A context-first, model-agnostic coding agent with an auditable terminal workspace.",
   type: "module",
   license: "MIT",
@@ -383,13 +383,15 @@ async function resolveProjectNamespace(workspace) {
   const { workspace: root, canonical, legacy } = projectNamespacePaths(workspace);
   await assertNamespacePathsSeparated(legacy, canonical);
   const [canonicalExists, legacyExists] = await Promise.all([isDirectory(canonical), isDirectory(legacy)]);
-  const activeKind = canonicalExists ? "canonical" : legacyExists ? "legacy" : "legacy";
+  const phase = legacyCompatibilityStatus().phase;
+  const activeKind = activeProjectNamespaceKind(canonicalExists, legacyExists, phase);
   return {
     workspace: root,
     canonical,
     legacy,
     active: activeKind === "canonical" ? canonical : legacy,
     activeKind,
+    phase,
     canonicalExists,
     legacyExists,
     conflict: canonicalExists && legacyExists
@@ -399,18 +401,25 @@ function resolveProjectNamespaceSync(workspace) {
   const { workspace: root, canonical, legacy } = projectNamespacePaths(workspace);
   const canonicalExists = isDirectorySync(canonical);
   const legacyExists = isDirectorySync(legacy);
-  const activeKind = canonicalExists ? "canonical" : "legacy";
+  const phase = legacyCompatibilityStatus().phase;
+  const activeKind = activeProjectNamespaceKind(canonicalExists, legacyExists, phase);
   return {
     workspace: root,
     canonical,
     legacy,
     active: activeKind === "canonical" ? canonical : legacy,
     activeKind,
+    phase,
     canonicalExists,
     legacyExists,
     conflict: canonicalExists && legacyExists
   };
 }
+function activeProjectNamespaceKind(canonicalExists, legacyExists, phase) {
+  if (canonicalExists) return "canonical";
+  if (legacyExists) return "legacy";
+  return phase === "active" ? "legacy" : "canonical";
+}
 function resolveHomeNamespace(environment = process.env) {
   const paths = homeNamespacePaths(environment);
   if (environment.SKEIN_HOME?.trim()) return paths.canonical;
@@ -421,12 +430,14 @@ async function resolveHomeStorageNamespace(environment = process.env) {
   await assertNamespacePathsSeparated(legacy, canonical);
   const [canonicalExists, legacyExists] = await Promise.all([isDirectory(canonical), isDirectory(legacy)]);
   const activeKind = canonicalExists ? "canonical" : "legacy";
+  const phase = legacyCompatibilityStatus({ environment }).phase;
   return {
     workspace: root,
     canonical,
     legacy,
     active: activeKind === "canonical" ? canonical : legacy,
     activeKind,
+    phase,
     canonicalExists,
     legacyExists,
     conflict: canonicalExists && legacyExists
@@ -9752,10 +9763,11 @@ async function runDoctor(config, options = {}) {
   let legacyCompatibility;
   try {
     namespace = await inspectProjectNamespace(root);
+    const activeNamespace = resolveProjectNamespaceSync(root);
     checks.push({
       name: "Storage namespace",
       ok: namespace.status !== "conflict",
-      detail: namespace.status === "ready" ? `legacy .mosaic detected; migrate to ${namespace.destination}` : namespace.status === "conflict" ? `conflict in ${namespace.conflicts.length} path(s); migration paused` : !namespace.sourceExists && !namespace.destinationExists ? `no durable state yet; first write uses ${namespace.source}` : `canonical .skein namespace active at ${namespace.destination}`,
+      detail: namespace.status === "ready" ? `legacy .mosaic detected; migrate to ${namespace.destination}` : namespace.status === "conflict" ? `conflict in ${namespace.conflicts.length} path(s); migration paused` : !namespace.sourceExists && !namespace.destinationExists ? `no durable state yet; first write uses ${activeNamespace.active}` : `canonical .skein namespace active at ${namespace.destination}`,
       required: false
     });
   } catch (error) {
@@ -11123,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);
@@ -11696,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;
@@ -11788,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";
@@ -12710,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;
@@ -14901,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) {
@@ -14923,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 = {
@@ -14974,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 {
@@ -14986,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) {
@@ -15033,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;
   }
@@ -15462,7 +15649,14 @@ program.command("status").description("Show model, context, workspace, and index
   const config = await runtimeConfig(workspaceOption(options.workspace), runtimeOptions(options));
   const engine = new ContextEngine(config);
   const status = await engine.status();
-  printObject({ config: configSummary(config), context: status }, options.json === true);
+  const namespace = resolveProjectNamespaceSync(config.workspaceRoots[0] ?? process.cwd());
+  const update = await refreshUpdateCache(package_default.version).catch(() => void 0);
+  if (options.json === 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, 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) => {
   const config = await runtimeConfig(workspaceOption(options.workspace), runtimeOptions(options));
@@ -15564,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");
@@ -16202,6 +16396,40 @@ function printObject(value, json) {
   else process.stdout.write(`${JSON.stringify(value, null, 2)}
 `);
 }
+function printStatusSummary(config, context, namespace, update) {
+  const glyphs = cliGlyphs;
+  const dim = (text) => chalk3.dim(text);
+  const line = (level, name, detail) => {
+    const icon = level === "ok" ? chalk3.green(glyphs.success) : level === "error" ? chalk3.red(glyphs.error) : chalk3.yellow("!");
+    process.stdout.write(`${icon} ${name.padEnd(16)} ${dim(detail)}
+`);
+  };
+  const keyReady = Boolean(config.model.apiKey) || config.model.provider === "compatible";
+  const endpoint = redactEndpoint(config.model.baseUrl);
+  const local = context.local ?? {};
+  const selected = String(context.selected ?? "local");
+  const engineDetail = selected === "contextengine" ? "ContextEngine (external)" : selected === "unindexed" ? `ContextEngine available; index not built ${glyphs.separator} run ${PRODUCT_COMMAND} index` : selected === "unavailable" ? `ContextEngine required but unavailable ${glyphs.separator} run ${PRODUCT_COMMAND} doctor` : "local index";
+  const indexFiles = local.files ?? 0;
+  const indexReady = Boolean(local.available) && indexFiles > 0;
+  const indexDetail = indexReady ? `${indexFiles} files ${glyphs.separator} ${local.chunks ?? 0} chunks` : `not built ${glyphs.separator} run ${PRODUCT_COMMAND} index`;
+  process.stdout.write(`${chalk3.hex("#A78BFA").bold(`${glyphs.brand} ${PRODUCT_NAME.toUpperCase()} STATUS`)}
+
+`);
+  line("ok", "Model", `${config.model.provider}/${config.model.model}`);
+  line("ok", "Endpoint", endpoint);
+  line(keyReady ? "ok" : "warn", "API key", keyReady ? "configured" : `missing ${glyphs.separator} set it, then run ${PRODUCT_COMMAND} doctor to verify`);
+  line(selected === "unavailable" ? "error" : "ok", "Context engine", engineDetail);
+  line(indexReady ? "ok" : "warn", "Code index", indexDetail);
+  line("ok", "Workspace", config.workspaceRoots.join(`  ${glyphs.separator}  `));
+  const namespaceName = namespace.activeKind === "canonical" ? ".skein" : ".mosaic";
+  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.`)}
+`);
+}
 function printSessionList(sessions) {
   if (!sessions.length) {
     process.stdout.write("No saved sessions.\n");