@1agh/maude 0.18.2 → 0.19.0

package/cli/bin/maude.mjs

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 // maude — Maude CLI. Scaffold .ai workspace, run dev servers, manage config.
 import { fileURLToPath } from 'node:url';
+import { runUpdateCheck } from '../lib/update-check.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -16,10 +18,24 @@ const COMMANDS = {
   version: () => import('../commands/version.mjs'),
 };
 
+function readCurrentVersion() {
+  try {
+    const raw = readFileSync(resolve(PKG_ROOT, 'package.json'), 'utf8');
+    return JSON.parse(raw).version || null;
+  } catch {
+    return null;
+  }
+}
+
 async function main(argv) {
   const args = argv.slice(2);
   const cmd = args[0];
 
+  // Print "update available" notice (from cached registry data) before
+  // dispatch, so it lands on stderr ahead of any subcommand output. Hot
+  // path is sync + non-blocking — the stale-cache refresh is detached.
+  runUpdateCheck(readCurrentVersion());
+
   if (!cmd || cmd === '--help' || cmd === '-h') {
     const { run } = await COMMANDS.help();
     return run({ args: args.slice(1), pkgRoot: PKG_ROOT });

package/cli/lib/update-check.mjs

@@ -0,0 +1,145 @@
+// Update-availability notifier for the `maude` CLI.
+//
+// Design (intentional, see PR discussion):
+//   • Hot path reads ONLY the local cache. Never blocks on a network fetch.
+//   • A detached child process refreshes the cache when stale (>24h). The
+//     notice for a freshly published version therefore appears on the run
+//     AFTER the cache rolls — same pattern as `update-notifier`.
+//   • Opt-out via MAUDE_NO_UPDATE_CHECK=1, NO_UPDATE_NOTIFIER=1, CI=true,
+//     or any non-TTY stderr (pipes, CI logs, etc.).
+//   • Best-effort everywhere: cache read/write, registry fetch, and spawn
+//     all swallow errors. The CLI must never fail because of this module.
+
+import { spawn } from 'node:child_process';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PKG_NAME = '@1agh/maude';
+const REGISTRY_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 3000;
+
+function cachePath() {
+  const base = process.env.XDG_CACHE_HOME || join(homedir(), '.cache');
+  return join(base, 'maude', 'update-check.json');
+}
+
+function shouldSkip() {
+  if (process.env.MAUDE_NO_UPDATE_CHECK) return true;
+  if (process.env.NO_UPDATE_NOTIFIER) return true;
+  if (process.env.CI) return true;
+  if (!process.stderr.isTTY) return true;
+  return false;
+}
+
+// Compare semver x.y.z (ignoring prerelease/build metadata). Returns
+// positive if a > b, negative if a < b, 0 if equal.
+export function cmpSemver(a, b) {
+  const parse = (v) =>
+    String(v)
+      .split(/[-+]/)[0]
+      .split('.')
+      .map((n) => Number(n) || 0);
+  const pa = parse(a);
+  const pb = parse(b);
+  for (let i = 0; i < 3; i += 1) {
+    const x = pa[i] || 0;
+    const y = pb[i] || 0;
+    if (x !== y) return x - y;
+  }
+  return 0;
+}
+
+function readCacheSync() {
+  try {
+    const raw = readFileSync(cachePath(), 'utf8');
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.latest === 'string' && typeof parsed?.checkedAt === 'number') {
+      return parsed;
+    }
+  } catch {
+    /* missing or corrupt — treat as no cache */
+  }
+  return null;
+}
+
+function writeCacheSync(data) {
+  const path = cachePath();
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(data), 'utf8');
+  } catch {
+    /* read-only fs / no permission — non-fatal */
+  }
+}
+
+function printNotice(current, latest) {
+  const msg = [
+    '',
+    `  ⚠ maude update available: ${current} → ${latest}`,
+    `    Run: npm i -g ${PKG_NAME}@latest   (or pnpm add -g / bun add -g)`,
+    '',
+    '',
+  ].join('\n');
+  process.stderr.write(msg);
+}
+
+function spawnDetachedRefresh() {
+  try {
+    const self = fileURLToPath(import.meta.url);
+    const child = spawn(process.execPath, [self, '--refresh'], {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+      env: { ...process.env, MAUDE_UPDATE_CHECK_CHILD: '1' },
+    });
+    child.unref();
+  } catch {
+    /* spawn failed — skip the refresh, will retry next run */
+  }
+}
+
+async function refreshCache() {
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(REGISTRY_URL, {
+      headers: { accept: 'application/json' },
+      signal: ac.signal,
+    });
+    if (!res.ok) return;
+    const json = await res.json();
+    if (typeof json?.version === 'string') {
+      writeCacheSync({ latest: json.version, checkedAt: Date.now() });
+    }
+  } catch {
+    /* offline, DNS failure, registry down — ignore */
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/**
+ * Run the update check from the CLI entry. Synchronous-fast: reads cache,
+ * prints notice if outdated, kicks off a detached refresh when the cache
+ * is stale, returns immediately.
+ */
+export function runUpdateCheck(currentVersion) {
+  if (shouldSkip()) return;
+  if (!currentVersion) return;
+
+  const cache = readCacheSync();
+  if (cache?.latest && cmpSemver(cache.latest, currentVersion) > 0) {
+    printNotice(currentVersion, cache.latest);
+  }
+  const isStale = !cache || Date.now() - cache.checkedAt > CACHE_TTL_MS;
+  if (isStale) spawnDetachedRefresh();
+}
+
+// Entrypoint when invoked as a detached refresh child:
+//   node cli/lib/update-check.mjs --refresh
+if (process.argv[1]?.endsWith('update-check.mjs') && process.argv.includes('--refresh')) {
+  refreshCache().catch(() => process.exit(0));
+}

package/cli/lib/update-check.test.mjs

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { cmpSemver } from './update-check.mjs';
+
+test('cmpSemver: equal versions return 0', () => {
+  assert.equal(cmpSemver('0.18.2', '0.18.2'), 0);
+  assert.equal(cmpSemver('1.0.0', '1.0.0'), 0);
+});
+
+test('cmpSemver: newer patch > older', () => {
+  assert.ok(cmpSemver('0.18.3', '0.18.2') > 0);
+  assert.ok(cmpSemver('0.18.2', '0.18.3') < 0);
+});
+
+test('cmpSemver: newer minor > older', () => {
+  assert.ok(cmpSemver('0.19.0', '0.18.99') > 0);
+  assert.ok(cmpSemver('0.18.99', '0.19.0') < 0);
+});
+
+test('cmpSemver: newer major > older', () => {
+  assert.ok(cmpSemver('1.0.0', '0.99.99') > 0);
+});
+
+test('cmpSemver: prerelease tags stripped (compares core only)', () => {
+  assert.equal(cmpSemver('0.18.2-beta.1', '0.18.2'), 0);
+  assert.ok(cmpSemver('0.19.0-rc.0', '0.18.2') > 0);
+});
+
+test('cmpSemver: missing components default to 0', () => {
+  assert.equal(cmpSemver('1', '1.0.0'), 0);
+  assert.equal(cmpSemver('1.2', '1.2.0'), 0);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1agh/maude",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "Marketplace of Claude Code plugins by Michal Dovrtěl: `design` (canvas-first design iteration) + `flow` (generic agentic workflow loop with .ai second brain). Ships the `maude` CLI (with `mdcc` legacy alias) to scaffold workspace, run the design dev server, and manage configs.",
   "type": "module",
   "engines": {
@@ -41,13 +41,13 @@
     "prepublishOnly": "bash scripts/check-version-parity.sh"
   },
   "optionalDependencies": {
-    "@1agh/maude-darwin-arm64": "0.18.2",
-    "@1agh/maude-darwin-x64": "0.18.2",
-    "@1agh/maude-linux-arm64": "0.18.2",
-    "@1agh/maude-linux-arm64-musl": "0.18.2",
-    "@1agh/maude-linux-x64": "0.18.2",
-    "@1agh/maude-linux-x64-musl": "0.18.2",
-    "@1agh/maude-win32-x64": "0.18.2"
+    "@1agh/maude-darwin-arm64": "0.19.0",
+    "@1agh/maude-darwin-x64": "0.19.0",
+    "@1agh/maude-linux-arm64": "0.19.0",
+    "@1agh/maude-linux-arm64-musl": "0.19.0",
+    "@1agh/maude-linux-x64": "0.19.0",
+    "@1agh/maude-linux-x64-musl": "0.19.0",
+    "@1agh/maude-win32-x64": "0.19.0"
   },
   "files": [
     "cli",

package/plugins/design/dev-server/api.ts

@@ -839,12 +839,12 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
       }
       const items: { label: string; path: string; group: string }[] = [];
       for (const m of matches) {
-        const files = await findFiles(m.abs, m.rel, ['.html']);
+        const files = await findFiles(m.abs, m.rel, ['.tsx', '.html']);
         for (const f of files) {
           const fname = f
             .split('/')
             .pop()
-            ?.replace(/\.html$/i, '');
+            ?.replace(/\.(tsx|html)$/i, '');
           const group = f.split('/').slice(-2, -1)[0] || folderName;
           const label = fname.toLowerCase() === 'index' ? group : fname;
           items.push({ label, path: f, group });

package/plugins/design/dev-server/canvas-lib-resolver.ts

@@ -27,15 +27,24 @@ import path from 'node:path';
 
 import type { BunPlugin } from 'bun';
 
+import { DEV_SERVER_ROOT } from './paths.ts';
+
 export const CANVAS_LIB_SPECIFIER = '@maude/canvas-lib';
 
 /**
  * Returns the dev-server-internal canvas-lib path. The `_designRoot` parameter
  * is retained for one minor (back-compat with callers we don't control) but
  * ignored — canvas-lib now ships with the dev-server install (DDR-025).
+ *
+ * Uses DEV_SERVER_ROOT (paths.ts) instead of `import.meta.dir` per DDR-045 —
+ * inside `bun --compile` standalone binaries `import.meta.dir` resolves to the
+ * virtual `/$bunfs/root` and any subsequent `existsSync` / `fs.watch` against
+ * that path silently fails. Same bug class as v0.18.0/0.18.1; this one surfaces
+ * as `[canvas-lib] failed to watch ... '/$bunfs/root/canvas-lib.tsx'` at boot
+ * and disables canvas-lib HMR.
  */
 export function canvasLibPath(_designRoot?: string): string {
-  return path.join(import.meta.dir, 'canvas-lib.tsx');
+  return path.join(DEV_SERVER_ROOT, 'canvas-lib.tsx');
 }
 
 export interface CanvasLibResolverOptions {

package/plugins/design/dev-server/client/app.jsx

@@ -1073,7 +1073,7 @@ function Viewport({ tabs, activePath, registerIframe, systemData, onOpenFromSyst
         if (t.path === SYSTEM_TAB) {
           return (
             <div key={t.path} className={'system-view' + (t.path === activePath ? ' active' : '')}>
-              <SystemView data={systemData} onOpen={onOpenFromSystem} />
+              <SystemView data={systemData} onOpen={onOpenFromSystem} cfg={cfg} />
             </div>
           );
         }
@@ -1152,7 +1152,7 @@ function TypeLadder() {
   );
 }
 
-function SystemView({ data, onOpen }) {
+function SystemView({ data, onOpen, cfg }) {
   if (!data) {
     return <div className="sv-empty"><p>Loading design system…</p></div>;
   }
@@ -1176,15 +1176,15 @@ function SystemView({ data, onOpen }) {
         </div>
       ) : (
         <>
-          <Gallery title="preview" items={previewGallery} onOpen={onOpen} kind="preview" />
-          <Gallery title="ui kits"  items={uiKitsGallery}  onOpen={onOpen} kind="ui_kits" />
+          <Gallery title="preview" items={previewGallery} onOpen={onOpen} kind="preview" cfg={cfg} />
+          <Gallery title="ui kits"  items={uiKitsGallery}  onOpen={onOpen} kind="ui_kits" cfg={cfg} />
         </>
       )}
     </div>
   );
 }
 
-function Gallery({ title, items, onOpen, kind }) {
+function Gallery({ title, items, onOpen, kind, cfg }) {
   if (!items || items.length === 0) return null;
   return (
     <section className="sv-section">
@@ -1193,7 +1193,7 @@ function Gallery({ title, items, onOpen, kind }) {
         {items.map(p => (
           <article key={p.path} className="sv-preview-card" onClick={() => onOpen(p.path)}>
             <div className="sv-preview-frame">
-              <iframe src={urlOf(p.path)} title={p.label} scrolling="no" />
+              <iframe src={canvasUrl(p.path, cfg)} title={p.label} scrolling="no" />
             </div>
             <div className="sv-preview-foot">
               <strong>{p.label}</strong>