@1agh/maude 0.15.0

package/cli/install.cjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+/* eslint-disable */
+// Postinstall: resolve the matching @1agh/maude-<slug> sub-package and
+// write its absolute binary path to `cli/.platform-binary-path` so the
+// dispatcher (`cli/bin/maude.mjs`) can `execFileSync` the native binary for
+// hot paths (`maude design serve`) with zero Node startup tax on subsequent
+// invocations.
+//
+// Pragmatic deviation from plan T12: see DDR-015. The full "maude IS the
+// binary" port (delete maude.mjs entirely) is deferred — currently the binary
+// only handles the dev-server, so we route only that subcommand through it.
+// CLI subcommands (init, config, version) keep running on Node for now.
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const HERE = __dirname;
+const SIDE_CHANNEL = path.join(HERE, '.platform-binary-path');
+
+function isLocalDev() {
+  // Don't run inside the source tree (when the user is developing the package itself).
+  return fs.existsSync(path.join(HERE, '..', 'packages', 'maude-darwin-arm64', 'package.json'));
+}
+
+function detectSlug() {
+  const p = process.platform;
+  const a = process.arch;
+
+  if (p === 'darwin') {
+    if (a === 'arm64') return 'darwin-arm64';
+    try {
+      const { execSync } = require('node:child_process');
+      const t = execSync('sysctl -n sysctl.proc_translated', {
+        stdio: ['ignore', 'pipe', 'ignore'],
+      })
+        .toString()
+        .trim();
+      if (t === '1') return 'darwin-arm64';
+    } catch {
+      /* not running under Rosetta */
+    }
+    return 'darwin-x64';
+  }
+
+  if (p === 'linux') {
+    const isMusl = (() => {
+      try {
+        const report = process.report?.getReport?.();
+        const glibc = report?.header?.glibcVersionRuntime;
+        return !glibc;
+      } catch {
+        return false;
+      }
+    })();
+    if (a === 'arm64') return isMusl ? 'linux-arm64-musl' : 'linux-arm64';
+    return isMusl ? 'linux-x64-musl' : 'linux-x64';
+  }
+
+  if (p === 'win32') return 'win32-x64';
+
+  throw new Error(`Unsupported platform: ${p}-${a}`);
+}
+
+function resolveBinary(slug) {
+  const pkg = `@1agh/maude-${slug}`;
+  const filename = process.platform === 'win32' ? 'maude.exe' : 'maude';
+  try {
+    const manifest = require.resolve(`${pkg}/package.json`);
+    return path.join(path.dirname(manifest), filename);
+  } catch (err) {
+    throw new Error(
+      `Cannot find ${pkg}. Reinstall with \`npm i -g @1agh/maude\` or \`npm rebuild @1agh/maude\`. (${err?.message ? err.message : err})`
+    );
+  }
+}
+
+function main() {
+  // Accept both env-var names for one cycle (BC alias). Drop MD_CLAUDE_SKIP_POSTINSTALL in v0.17.x.
+  if (
+    process.env.MAUDE_SKIP_POSTINSTALL === '1' ||
+    process.env.MD_CLAUDE_SKIP_POSTINSTALL === '1'
+  ) {
+    console.log('@1agh/maude: postinstall skipped via MAUDE_SKIP_POSTINSTALL=1');
+    return;
+  }
+  if (isLocalDev()) {
+    return;
+  }
+  try {
+    const slug = detectSlug();
+    const bin = resolveBinary(slug);
+    if (!fs.existsSync(bin)) {
+      throw new Error(`binary missing at ${bin}`);
+    }
+    fs.writeFileSync(SIDE_CHANNEL, bin, 'utf8');
+    try {
+      fs.chmodSync(bin, 0o755);
+    } catch {
+      /* read-only fs / Windows — ignore */
+    }
+    console.log(`@1agh/maude: registered ${slug} binary (${bin})`);
+  } catch (err) {
+    console.error(`@1agh/maude: postinstall failed — ${err?.message ? err.message : err}`);
+    console.error(
+      '  `maude design serve` will fall back to running server.ts on Bun (if available).'
+    );
+    process.exit(0); // Don't fail the install.
+  }
+}
+
+main();

package/cli/lib/argv.mjs

@@ -0,0 +1,37 @@
+// Minimal flag/positional parser. No deps.
+//
+// parseArgs(['--name', 'foo', '--force', 'pos1'])
+//   → { flags: { name: 'foo', force: true }, positional: ['pos1'] }
+//
+// Boolean flags must be in the `booleans` set or they consume the next arg.
+export function parseArgs(args, { booleans = [] } = {}) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === '--') {
+      positional.push(...args.slice(i + 1));
+      break;
+    }
+    if (a.startsWith('--')) {
+      const eq = a.indexOf('=');
+      if (eq !== -1) {
+        flags[a.slice(2, eq)] = a.slice(eq + 1);
+      } else {
+        const key = a.slice(2);
+        if (booleans.includes(key)) {
+          flags[key] = true;
+        } else {
+          flags[key] = args[++i];
+        }
+      }
+    } else if (a.startsWith('-') && a.length > 1) {
+      const key = a.slice(1);
+      if (booleans.includes(key)) flags[key] = true;
+      else flags[key] = args[++i];
+    } else {
+      positional.push(a);
+    }
+  }
+  return { flags, positional };
+}

package/cli/lib/argv.test.mjs

@@ -0,0 +1,46 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { parseArgs } from './argv.mjs';
+
+test('value flag with --key value', () => {
+  const { flags, positional } = parseArgs(['--name', 'foo']);
+  assert.equal(flags.name, 'foo');
+  assert.deepEqual(positional, []);
+});
+
+test('value flag with --key=value', () => {
+  const { flags } = parseArgs(['--name=foo']);
+  assert.equal(flags.name, 'foo');
+});
+
+test('boolean flag declared in booleans set', () => {
+  const { flags, positional } = parseArgs(['--force', 'pos1'], { booleans: ['force'] });
+  assert.equal(flags.force, true);
+  assert.deepEqual(positional, ['pos1']);
+});
+
+test('positional args collected', () => {
+  const { positional } = parseArgs(['init', 'my-project']);
+  assert.deepEqual(positional, ['init', 'my-project']);
+});
+
+test('-- separator dumps remaining as positional', () => {
+  const { flags, positional } = parseArgs(['--name', 'foo', '--', '--not-a-flag', 'x']);
+  assert.equal(flags.name, 'foo');
+  assert.deepEqual(positional, ['--not-a-flag', 'x']);
+});
+
+test('short flag -p value', () => {
+  const { flags } = parseArgs(['-p', '4399']);
+  assert.equal(flags.p, '4399');
+});
+
+test('mixed flags + positionals', () => {
+  const { flags, positional } = parseArgs(
+    ['design', 'serve', '--port', '4399', '--root', '/tmp/x'],
+    { booleans: [] }
+  );
+  assert.equal(flags.port, '4399');
+  assert.equal(flags.root, '/tmp/x');
+  assert.deepEqual(positional, ['design', 'serve']);
+});

package/cli/lib/copy-tree.mjs

@@ -0,0 +1,78 @@
+import { copyFile, mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import { basename, join, relative } from 'node:path';
+
+// Recursively copy `src` → `dest`. Returns { created, skipped, replaced }.
+// - never overwrites unless { force }
+// - .gitkeep files are copied as empty dirs only when the dir is otherwise empty
+// - if `transform({ srcPath, destPath, contents })` is provided, runs it before write
+//   for files matching `transformGlob` (substring match on srcPath).
+// - if `rename(name)` is provided, rewrites entry filenames before computing dest
+//   (used to strip `.tpl` suffix during design-system scaffold).
+export async function copyTree(src, dest, opts = {}) {
+  const {
+    force = false,
+    dryRun = false,
+    transform = null,
+    transformMatch = () => false,
+    rename = (name) => name,
+  } = opts;
+  const stats = { created: [], skipped: [], replaced: [] };
+
+  async function walk(srcDir, destDir) {
+    await ensureDir(destDir, dryRun);
+    const entries = await readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const srcPath = join(srcDir, entry.name);
+      const destName = entry.isDirectory() ? entry.name : rename(entry.name);
+      const destPath = join(destDir, destName);
+      if (entry.isDirectory()) {
+        await walk(srcPath, destPath);
+        continue;
+      }
+      const exists = await fileExists(destPath);
+      if (entry.name === '.gitkeep') {
+        // Only carry .gitkeep over if dest dir is otherwise empty after this run.
+        // We still copy it to keep the dir tracked; harmless if non-empty.
+        if (!exists) {
+          if (!dryRun) await copyFile(srcPath, destPath);
+          stats.created.push(relative(dest, destPath));
+        } else {
+          stats.skipped.push(relative(dest, destPath));
+        }
+        continue;
+      }
+      if (exists && !force) {
+        stats.skipped.push(relative(dest, destPath));
+        continue;
+      }
+      if (transform && transformMatch(srcPath)) {
+        const contents = await readFile(srcPath, 'utf8');
+        const out = await transform({ srcPath, destPath, contents });
+        if (!dryRun) await writeFile(destPath, out);
+      } else {
+        if (!dryRun) await copyFile(srcPath, destPath);
+      }
+      if (exists) stats.replaced.push(relative(dest, destPath));
+      else stats.created.push(relative(dest, destPath));
+    }
+  }
+
+  await walk(src, dest);
+  return stats;
+}
+
+async function ensureDir(dir, dryRun) {
+  if (dryRun) return;
+  await mkdir(dir, { recursive: true });
+}
+
+async function fileExists(p) {
+  try {
+    await stat(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export { basename };

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@1agh/maude",
+  "version": "0.15.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": {
+    "node": ">=20",
+    "pnpm": ">=9",
+    "bun": ">=1.3"
+  },
+  "packageManager": "pnpm@11.0.4",
+  "bin": {
+    "maude": "cli/bin/maude.mjs",
+    "mdcc": "cli/bin/mdcc.mjs",
+    "maude-safe": "cli/cli-wrapper.cjs",
+    "mdcc-safe": "cli/cli-wrapper.cjs",
+    "claude-design-server": "plugins/design/dev-server/server.mjs"
+  },
+  "scripts": {
+    "start": "bun run plugins/design/dev-server/server.ts",
+    "dev": "bun run plugins/design/dev-server/server.ts --port 4399",
+    "dev:site": "pnpm --filter @maude/site dev --port 4398",
+    "build": "pnpm -r --if-present run build",
+    "build:binary": "bun run plugins/design/dev-server/build.ts --release",
+    "test": "node --test --test-reporter=spec cli/**/*.test.mjs",
+    "test:dev-server": "cd plugins/design/dev-server && bun test",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "changeset": "changeset",
+    "changeset:version": "bash scripts/changesets-version.sh",
+    "release": "pnpm build && changeset publish",
+    "maude": "node cli/bin/maude.mjs",
+    "mdcc": "node cli/bin/mdcc.mjs",
+    "video:smoke": "bash scripts/video/smoke/run.sh",
+    "video:smoke:terminal": "vhs scripts/video/smoke/terminal.tape",
+    "video:smoke:browser": "playwright test --config scripts/video/smoke/playwright.config.ts",
+    "video:smoke:card": "remotion render scripts/video/smoke/card/index.tsx SmokeCard scripts/video/.work/smoke/card.mp4 --mute",
+    "postinstall": "node cli/install.cjs",
+    "prepublishOnly": "bash scripts/check-version-parity.sh"
+  },
+  "optionalDependencies": {
+    "@1agh/maude-darwin-arm64": "0.15.0",
+    "@1agh/maude-darwin-x64": "0.15.0",
+    "@1agh/maude-linux-arm64": "0.15.0",
+    "@1agh/maude-linux-arm64-musl": "0.15.0",
+    "@1agh/maude-linux-x64": "0.15.0",
+    "@1agh/maude-linux-x64-musl": "0.15.0",
+    "@1agh/maude-win32-x64": "0.15.0"
+  },
+  "files": [
+    "cli",
+    "plugins/design/dev-server",
+    "plugins/design/templates",
+    "plugins/flow/templates",
+    "plugins/flow/.claude-plugin/config.schema.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1aGh/maude.git"
+  },
+  "homepage": "https://github.com/1aGh/maude#readme",
+  "bugs": {
+    "url": "https://github.com/1aGh/maude/issues"
+  },
+  "license": "MIT",
+  "author": "Michal Dovrtěl (1aGh)",
+  "keywords": [
+    "claude-code",
+    "claude-marketplace",
+    "claude-plugin",
+    "maude",
+    "mdcc",
+    "agentic-workflow",
+    "design-tools",
+    "design-system",
+    "dev-server",
+    "scaffold"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@changesets/cli": "^2.27.10",
+    "@playwright/test": "^1.60.0",
+    "@remotion/bundler": "^4.0.463",
+    "@remotion/cli": "^4.0.463",
+    "@remotion/renderer": "^4.0.463",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "remotion": "^4.0.463"
+  }
+}