@cleocode/cleo 2026.5.29 → 2026.5.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/cleo",
-  "version": "2026.5.29",
+  "version": "2026.5.33",
   "description": "CLEO CLI — the assembled product consuming @cleocode/core",
   "type": "module",
   "main": "./dist/cli/index.js",
@@ -29,16 +29,17 @@
     "tree-sitter-ruby": "^0.23.1",
     "tree-sitter-rust": "0.23.1",
     "tree-sitter-typescript": "^0.23.2",
-    "@cleocode/caamp": "2026.5.29",
-    "@cleocode/contracts": "2026.5.29",
-    "@cleocode/lafs": "2026.5.29",
-    "@cleocode/cant": "2026.5.29",
-    "@cleocode/nexus": "2026.5.29",
-    "@cleocode/playbooks": "2026.5.29",
-    "@cleocode/runtime": "2026.5.29"
+    "@cleocode/animations": "2026.5.33",
+    "@cleocode/caamp": "2026.5.33",
+    "@cleocode/cant": "2026.5.33",
+    "@cleocode/contracts": "2026.5.33",
+    "@cleocode/lafs": "2026.5.33",
+    "@cleocode/nexus": "2026.5.33",
+    "@cleocode/playbooks": "2026.5.33",
+    "@cleocode/runtime": "2026.5.33"
   },
   "peerDependencies": {
-    "@cleocode/core": "2026.5.29"
+    "@cleocode/core": "2026.5.33"
   },
   "peerDependenciesMeta": {
     "@cleocode/core": {
@@ -69,8 +70,11 @@
     "directory": "packages/cleo"
   },
   "scripts": {
+    "gen:manifest": "node scripts/generate-command-manifest.mjs",
+    "prebuild": "node scripts/generate-command-manifest.mjs",
     "build": "tsc",
     "postbuild": "node scripts/assert-shebang.mjs",
+    "pretypecheck": "node scripts/generate-command-manifest.mjs",
     "typecheck": "tsc --noEmit",
     "test": "cd ../.. && vitest run packages/cleo/src",
     "test:integration": "cd ../.. && vitest run --config packages/cleo/vitest.integration.config.ts",

package/scripts/generate-command-manifest.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * Build-time generator: scans `packages/cleo/src/cli/commands/*.ts` and emits
+ * `packages/cleo/src/cli/generated/command-manifest.ts` — a static index of
+ * `{ exportName, importPath, meta: { name, description } }` for every exported
+ * `xxxCommand` constant.
+ *
+ * Why
+ * ----
+ * The CLI entry point uses this manifest to register lazy command wrappers:
+ * `meta` is read eagerly (so `--help` works without loading every command),
+ * and the actual command module is `import()`-ed only when the user runs it.
+ *
+ * Each command file remains the single source of truth for its own metadata —
+ * this script just bridges that to a static index the bundler can analyse.
+ */
+
+import { readdirSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = resolve(__dirname, '..');
+const COMMANDS_DIR = join(PKG_ROOT, 'src', 'cli', 'commands');
+const OUTPUT_DIR = join(PKG_ROOT, 'src', 'cli', 'generated');
+const OUTPUT_FILE = join(OUTPUT_DIR, 'command-manifest.ts');
+
+/**
+ * Match `export const fooCommand = defineCommand({` (with optional `as CommandDef`
+ * type assertions) plus the immediately-following `meta: { name: '...', description: '...' }`
+ * block. Multi-line descriptions are captured inside the same string literal.
+ */
+const COMMAND_BLOCK_RE =
+  /export\s+const\s+(\w+Command)\s*(?::\s*\w+)?\s*=\s*defineCommand\s*\(\s*\{[\s\S]*?meta\s*:\s*\{([\s\S]*?)\}/g;
+
+const NAME_RE = /name\s*:\s*['"`]([^'"`]+)['"`]/;
+const DESC_RE = /description\s*:\s*['"`]((?:[^'"`\\]|\\.)*)['"`]/;
+
+function extractFromFile(file) {
+  const text = readFileSync(file, 'utf8');
+  const results = [];
+  let match;
+  while ((match = COMMAND_BLOCK_RE.exec(text)) !== null) {
+    const exportName = match[1];
+    const metaBlock = match[2];
+    const nameMatch = metaBlock.match(NAME_RE);
+    const descMatch = metaBlock.match(DESC_RE);
+    if (!nameMatch) continue; // skip if no name field
+    results.push({
+      exportName,
+      name: nameMatch[1],
+      description: descMatch ? descMatch[1] : '',
+    });
+  }
+  return results;
+}
+
+function main() {
+  const files = readdirSync(COMMANDS_DIR)
+    .filter((f) => f.endsWith('.ts') && !f.endsWith('.test.ts'))
+    .sort();
+
+  const entries = [];
+  for (const f of files) {
+    const path = join(COMMANDS_DIR, f);
+    const fileEntries = extractFromFile(path);
+    for (const e of fileEntries) {
+      entries.push({
+        ...e,
+        // Import path used at runtime — relative to cli/generated/
+        importPath: `../commands/${f.replace(/\.ts$/, '.js')}`,
+      });
+    }
+  }
+
+  if (entries.length === 0) {
+    console.error('generate-command-manifest: no commands found in', COMMANDS_DIR);
+    process.exit(1);
+  }
+
+  // Detect duplicate command names so we surface conflicts at build time.
+  const seenNames = new Map();
+  for (const e of entries) {
+    const prev = seenNames.get(e.name);
+    if (prev && prev.exportName !== e.exportName) {
+      console.error(
+        `generate-command-manifest: duplicate command name "${e.name}" — ` +
+          `${prev.exportName} (${prev.importPath}) and ${e.exportName} (${e.importPath})`,
+      );
+      process.exit(1);
+    }
+    seenNames.set(e.name, e);
+  }
+
+  const banner = `/**
+ * AUTO-GENERATED by packages/cleo/scripts/generate-command-manifest.mjs.
+ * DO NOT EDIT MANUALLY — regenerate via \`pnpm --filter @cleocode/cleo run gen:manifest\`.
+ *
+ * This file is the eagerly-loaded index of CLI commands. Each entry carries the
+ * static \`meta\` plus a dynamic \`load()\` that imports the command on demand.
+ *
+ * The point: \`cleo --help\` and \`cleo --version\` no longer transitively load
+ * 111 command modules + their CORE/SQLite/drizzle dependency trees. Only the
+ * matched command's module is loaded at run time.
+ */
+
+import type { CommandDef } from 'citty';
+
+/**
+ * One entry per exported \`xxxCommand\` discovered in src/cli/commands/.
+ * Identified by both \`exportName\` (some files export multiple commands)
+ * and \`name\` (the user-facing CLI subcommand).
+ */
+export interface CommandManifestEntry {
+  /** The exported binding inside the command module (e.g. \`findCommand\`). */
+  readonly exportName: string;
+  /** The user-facing CLI name (e.g. \`find\`). Matches \`meta.name\` in source. */
+  readonly name: string;
+  /** Short description shown in \`cleo --help\`. Matches \`meta.description\` in source. */
+  readonly description: string;
+  /** Dynamic import — resolves to the full \`CommandDef\` only when invoked. */
+  readonly load: () => Promise<CommandDef>;
+}
+`;
+
+  const lines = [banner, '', 'export const COMMAND_MANIFEST: readonly CommandManifestEntry[] = [', ];
+  for (const e of entries) {
+    const desc = e.description.replace(/'/g, "\\'");
+    lines.push(
+      `  {`,
+      `    exportName: '${e.exportName}',`,
+      `    name: '${e.name}',`,
+      `    description: '${desc}',`,
+      `    load: async () => (await import('${e.importPath}')).${e.exportName} as CommandDef,`,
+      `  },`,
+    );
+  }
+  lines.push('] as const;', '');
+
+  mkdirSync(OUTPUT_DIR, { recursive: true });
+  writeFileSync(OUTPUT_FILE, lines.join('\n'), 'utf8');
+  console.info(
+    `generate-command-manifest: wrote ${entries.length} entries to ${OUTPUT_FILE.replace(PKG_ROOT + '/', '')}`,
+  );
+}
+
+main();