@emeryld/manager 0.4.0 → 0.4.2

package/README.md

@@ -1,58 +1,42 @@
 # @emeryld/manager
 
-Interactive release helper for pnpm monorepos. Install it as a local dev dependency, then run `pnpm manager-cli` (or call a `scripts.manager-cli` alias) from your workspace root to walk through selecting packages, running updates/tests/builds, and publishing.
-
-## Installation
-
-1. Ensure your workspace has a `packages/` directory (or configure one via `packages.mjs`).
-2. Add the manager to your dev dependencies so its CLI and helpers are hoisted into the consuming repo:
-   ```sh
-   pnpm add -D @emeryld/manager
-   ```
-3. Include a script in your `package.json` so you can invoke it consistently:
-   ```json
-   {
-     "scripts": {
-       "manager-cli": "manager-cli"
-     }
-   }
-   ```
-4. Run `pnpm install` to fetch `ts-node`, `semver`, and other runtime deps.
-
-## Running the CLI
-
-- Always run `pnpm manager-cli` (or `pnpm run manager-cli`) from the **workspace root** where your `packages/` folder lives. The manager operates against the workspace you are in, not the package that ships the tool.
-- Each TypeScript helper script registers the bundled `ts-node/esm` loader with the exact script path, so the CLI works even from pnpm workspaces that hoist dependencies.
-- To avoid the warning/error you saw earlier, make sure:
-  - the workspace has `packages/` (or a configured manifest) so `loadPackages()` can find targets,
-  - `pnpm install` has already written `ts-node` into `node_modules`,
-  - you execute the CLI from the workspace that owns those packages.
-
-## Testing the loader registration
-
-Run `pnpm test` to ensure the helper CLI always generates a `--import data:text...` snippet that registers `ts-node/esm.mjs` with **the actual script file path**. This guards against regressions that would make Node reject the loader and crash before the interactive menu appears.
-
-## Package creator overview
-
-Use `Create package` inside the CLI to scaffold starter packages. The flow will prompt for a variant, target path, and package name, then generate the files and attempt `pnpm install` and `pnpm run build` when a build script exists.
-
-### How to scaffold
-- From the workspace root, run `pnpm manager-cli` → choose `Create package`.
-- Pick a variant, confirm the target directory, and override the package name if desired.
-- After scaffolding, the new package’s README covers variant-specific details and scripts.
-
-### Variant quick view
-
-| Variant | Default dir | Purpose | Key scripts |
+Dev dependency built for Codex agents: scaffold RRRoutes packages, read the generated structure, and ship changes without rebuilding boilerplate. Install it in a pnpm workspace and call `pnpm manager-cli` from the workspace root.
+
+## Quick start (agents)
+- Install: `pnpm add -D @emeryld/manager`
+- Add a script: `"manager-cli": "manager-cli"` in the workspace `package.json`
+- Discover templates fast: `pnpm manager-cli templates` (alias `pnpm manager-cli create --list`)
+- Scaffold without prompts:  
+  `pnpm manager-cli create --variant rrr-server --dir packages/api --name @scope/api --contract @scope/contract --skip-install`
+- Prefer prompts: `pnpm manager-cli create` and follow the menu
+- After scaffolding, open the new package `README.md` for variant-specific scripts and usage
+
+## Templates at a glance
+| id | default dir | summary | key files |
 | --- | --- | --- | --- |
-| rrr contract | `packages/rrr-contract` | Shared RRRoutes contract registry and socket config | `dev`, `build`, `typecheck`, `lint`, `format` |
-| rrr server | `packages/rrr-server` | Express + RRRoutes API wired to a contract import | `dev`, `build`, `start`, `lint`, `format` |
-| rrr client | `packages/rrr-client` | RRRoutes client helpers + React Query setup | `dev`, `build`, `lint`, `format` |
-| empty package | `packages/rrr-empty` | Minimal TypeScript starter | `dev`, `build`, `lint`, `format` |
-| dockerized service | `packages/rrr-docker` | Express service with Dockerfile and helper CLI | `dev`, `build`, `start`, `docker:*` |
-| full stack stack | `rrrfull-stack` | Workspace with contract + server + client + docker | `dev`, `build`, `lint`, `docker:*` (root scripts orchestrate) |
-
-### Common scripts and helpers
-- `dev` (watch), `build`, `typecheck`, `lint`/`lint:fix`, `format`/`format:check`, `clean`, `test` are scaffolded where relevant.
-- Docker-focused variants expose `docker:build`, `docker:up`, `docker:dev`, `docker:logs`, `docker:stop`, `docker:clean`, `docker:reset`.
-- Husky + lint-staged and ESLint/Prettier configs are included in every package for consistent DX.
+| rrr-contract | `packages/rrr-contract` | Shared RRRoutes contract + sockets for clients/servers | `src/index.ts`, `README.md` |
+| rrr-server | `packages/rrr-server` | Express + RRRoutes API wired to a contract import | `src/index.ts`, `.env.example`, `README.md` |
+| rrr-client | `packages/rrr-client` | React Query-ready RRRoutes client bound to a contract import | `src/index.ts`, `README.md` |
+| rrr-empty | `packages/rrr-empty` | Minimal TypeScript package with lint/format/test wiring | `src/index.ts`, `README.md` |
+| rrr-docker | `packages/rrr-docker` | Express service with Dockerfile + helper CLI | `src/index.ts`, `scripts/docker.ts`, `Dockerfile`, `README.md` |
+| rrr-fullstack | `rrrfull-stack` | pnpm workspace with contract, server, client, and docker helper | root `package.json`, `pnpm-workspace.yaml`, `packages/*` |
+
+Use `pnpm manager-cli create --describe <variant>` to print the scripts, key files, and notes for any template before scaffolding.
+
+## Create command reference
+- `pnpm manager-cli create --list` — show templates
+- `pnpm manager-cli create --describe rrr-server` — see scripts/files/notes for one template
+- `pnpm manager-cli create --variant rrr-client --dir packages/web-client --name @scope/web-client` — scaffold directly (adds `--contract <id>` for server/client)
+- `--skip-install` / `--skip-build` — bypass post-create steps when you want to install/build later
+
+## Release helper (existing packages)
+- Run from the workspace root where `packages/` lives.
+- `pnpm manager-cli` launches an interactive menu: pick packages, then run update → test → build → publish (or any single step).
+- Non-interactive publish: `pnpm manager-cli <pkg|all> --non-interactive --bump patch` (see CLI prompts for flags like `--sync` and `--tag`).
+
+## Notes
+- Each helper script registers the bundled `ts-node/esm` loader with the correct path so the CLI works even when dependencies are hoisted.
+- The create flow runs `pnpm install` and `pnpm run build` when a build script exists; skip with `--skip-install`/`--skip-build` if you want to control timing.
+
+## Tests
+- `pnpm test` verifies the helper CLI loader registration.

package/dist/create-package/index.js

@@ -4,7 +4,7 @@ import path from 'node:path';
 import { stdin as input } from 'node:process';
 import { askLine, promptSingleKey } from '../prompts.js';
 import { colors, logGlobal } from '../utils/log.js';
-import { workspaceRoot } from './shared.js';
+import { SCRIPT_DESCRIPTIONS, workspaceRoot, } from './shared.js';
 import { clientVariant } from './variants/client.js';
 import { contractVariant } from './variants/contract.js';
 import { dockerVariant } from './variants/docker.js';
@@ -19,10 +19,122 @@ const VARIANTS = [
     dockerVariant,
     fullstackVariant,
 ];
+const VARIANT_LOOKUP = new Map(VARIANTS.map((variant) => [variant.id, variant]));
 function derivePackageName(targetDir) {
     const base = path.basename(targetDir) || 'rrr-package';
     return base;
 }
+function resolveVariant(key) {
+    if (!key)
+        return undefined;
+    const normalized = key.toLowerCase();
+    return (VARIANT_LOOKUP.get(normalized) ??
+        VARIANTS.find((variant) => {
+            const label = variant.label.toLowerCase();
+            const id = variant.id.toLowerCase();
+            return (id === normalized ||
+                id.replace(/^rrr-/, '') === normalized ||
+                label === normalized ||
+                label.includes(normalized));
+        }));
+}
+function printVariantList() {
+    logGlobal('Available templates', colors.magenta);
+    VARIANTS.forEach((variant) => {
+        const summary = variant.summary ? ` ${colors.dim(`– ${variant.summary}`)}` : '';
+        console.log(`- ${colors.green(variant.label)} ${colors.dim(`(${variant.id})`)} → ${colors.cyan(variant.defaultDir)}${summary}`);
+    });
+    console.log(colors.dim('Use "--describe <variant>" for details or "--variant <id> --dir <path>" to scaffold without prompts.'));
+}
+function printVariantDetails(variant) {
+    logGlobal(`${variant.label} (${variant.id})`, colors.green);
+    console.log(`  default dir: ${colors.cyan(variant.defaultDir)}`);
+    if (variant.summary) {
+        console.log(`  ${variant.summary}`);
+    }
+    if (variant.keyFiles?.length) {
+        console.log('  key files:');
+        variant.keyFiles.forEach((file) => console.log(`    - ${file}`));
+    }
+    if (variant.scripts?.length) {
+        console.log('  scripts:');
+        variant.scripts.forEach((script) => {
+            const desc = SCRIPT_DESCRIPTIONS[script];
+            const detail = desc ? colors.dim(` – ${desc}`) : '';
+            console.log(`    - ${script}${detail}`);
+        });
+    }
+    if (variant.notes?.length) {
+        console.log('  notes:');
+        variant.notes.forEach((note) => console.log(`    - ${note}`));
+    }
+}
+function parseCreateCliArgs(argv) {
+    const options = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--list' || arg === '-l' || arg === 'list' || arg === 'ls') {
+            options.list = true;
+            continue;
+        }
+        if (arg === '--describe' || arg === '-d' || arg === 'describe') {
+            options.describe = argv[++i];
+            continue;
+        }
+        if (arg === '--variant' || arg === '-v') {
+            options.variant = argv[++i];
+            continue;
+        }
+        if (arg === '--dir' || arg === '--path' || arg === '-p') {
+            options.targetDir = argv[++i];
+            continue;
+        }
+        if (arg === '--name' || arg === '-n') {
+            options.pkgName = argv[++i];
+            continue;
+        }
+        if (arg === '--contract') {
+            options.contractName = argv[++i];
+            continue;
+        }
+        if (arg === '--skip-install') {
+            options.skipInstall = true;
+            continue;
+        }
+        if (arg === '--skip-build') {
+            options.skipBuild = true;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+            continue;
+        }
+        if (!arg.startsWith('-') && !options.variant) {
+            options.variant = arg;
+        }
+    }
+    return options;
+}
+function printCreateHelp() {
+    logGlobal('Create package help', colors.magenta);
+    console.log('Usage:');
+    console.log('  pnpm manager-cli create                     # interactive prompts');
+    console.log('  pnpm manager-cli create --list              # list templates');
+    console.log('  pnpm manager-cli create --describe rrr-server');
+    console.log('  pnpm manager-cli create --variant rrr-client --dir packages/rrr-client --name @scope/client');
+    console.log('  pnpm manager-cli create --variant rrr-server --contract @scope/contract --skip-install');
+    console.log('');
+    console.log('Flags:');
+    console.log('  --list, -l          Show available templates');
+    console.log('  --describe, -d      Print details for a template');
+    console.log('  --variant, -v       Pick a template by id/label (skips variant prompt)');
+    console.log('  --dir, --path, -p   Target directory (skips path prompt)');
+    console.log('  --name, -n          Package name (skips name prompt)');
+    console.log('  --contract          Contract import to inject (server/client variants)');
+    console.log('  --skip-install      Do not run pnpm install after scaffolding');
+    console.log('  --skip-build        Skip build after scaffolding');
+    console.log('  --help, -h          Show this help');
+}
 async function ensureTargetDir(targetDir) {
     try {
         const stats = await stat(targetDir);
@@ -177,7 +289,11 @@ async function promptForTargetDir(fallback) {
     const normalized = answer || fallback;
     return path.resolve(workspaceRoot, normalized);
 }
-async function postCreateTasks(targetDir) {
+async function postCreateTasks(targetDir, options) {
+    if (options?.skipInstall) {
+        logGlobal('Skipping pnpm install (flag).', colors.dim);
+        return;
+    }
     try {
         logGlobal('Running pnpm install…', colors.cyan);
         await runCommand('pnpm', ['install'], workspaceRoot);
@@ -186,6 +302,10 @@ async function postCreateTasks(targetDir) {
         logGlobal(`pnpm install failed: ${error instanceof Error ? error.message : String(error)}`, colors.yellow);
         return;
     }
+    if (options?.skipBuild) {
+        logGlobal('Skipping build (flag).', colors.dim);
+        return;
+    }
     try {
         const pkgJsonPath = path.join(targetDir, 'package.json');
         const pkgRaw = await readFile(pkgJsonPath, 'utf8');
@@ -199,22 +319,69 @@ async function postCreateTasks(targetDir) {
         logGlobal(`Skipping build (could not read package.json): ${error instanceof Error ? error.message : String(error)}`, colors.yellow);
     }
 }
-async function gatherTarget() {
-    const variant = await promptForVariant();
-    const targetDir = await promptForTargetDir(variant.defaultDir);
+async function gatherTarget(initial = {}) {
+    const variant = initial.variant ?? (await promptForVariant());
+    const targetDir = initial.targetDir !== undefined
+        ? path.resolve(workspaceRoot, initial.targetDir)
+        : await promptForTargetDir(variant.defaultDir);
     const fallbackName = derivePackageName(targetDir);
-    const nameAnswer = await askLine(`Package name? (${fallbackName}): `);
+    const nameAnswer = initial.pkgName === undefined
+        ? await askLine(`Package name? (${fallbackName}): `)
+        : initial.pkgName;
     const pkgName = (nameAnswer || fallbackName).trim() || fallbackName;
     await ensureTargetDir(targetDir);
-    return { variant, targetDir, pkgName };
+    return {
+        variant,
+        targetDir,
+        pkgName,
+        contractName: initial.contractName,
+    };
 }
-export async function createRrrPackage() {
-    const target = await gatherTarget();
+export async function createRrrPackage(options = {}) {
+    const target = await gatherTarget(options);
     logGlobal(`Creating ${target.variant.label} in ${path.relative(workspaceRoot, target.targetDir) || '.'}`, colors.green);
     await target.variant.scaffold({
         targetDir: target.targetDir,
         pkgName: target.pkgName,
+        contractName: target.contractName ?? options.contractName,
+    });
+    await postCreateTasks(target.targetDir, {
+        skipInstall: options.skipInstall,
+        skipBuild: options.skipBuild ?? options.skipInstall,
     });
-    await postCreateTasks(target.targetDir);
     logGlobal('Scaffold complete. Install/build steps were attempted; ready to run!', colors.green);
 }
+export async function runCreatePackageCli(argv) {
+    const parsed = parseCreateCliArgs(argv);
+    if (parsed.help) {
+        printCreateHelp();
+        return;
+    }
+    if (parsed.list) {
+        printVariantList();
+        return;
+    }
+    if (parsed.describe) {
+        const variant = resolveVariant(parsed.describe);
+        if (!variant) {
+            throw new Error(`Unknown variant "${parsed.describe}". Use --list to see available templates.`);
+        }
+        printVariantDetails(variant);
+        return;
+    }
+    const variant = resolveVariant(parsed.variant);
+    if (parsed.variant && !variant) {
+        throw new Error(`Unknown variant "${parsed.variant}". Use --list to see available templates.`);
+    }
+    const targetDir = parsed.targetDir
+        ? path.resolve(workspaceRoot, parsed.targetDir)
+        : undefined;
+    await createRrrPackage({
+        variant,
+        targetDir,
+        pkgName: parsed.pkgName,
+        contractName: parsed.contractName,
+        skipInstall: parsed.skipInstall,
+        skipBuild: parsed.skipBuild ?? parsed.skipInstall,
+    });
+}

package/dist/create-package/shared.js

@@ -155,7 +155,7 @@ export function basePackageFiles(options) {
         '.gitignore': gitignoreFrom(options?.gitignoreEntries),
     };
 }
-const SCRIPT_DESCRIPTIONS = {
+export const SCRIPT_DESCRIPTIONS = {
     dev: 'Watch and rebuild on change',
     build: 'Type-check and emit to dist/',
     typecheck: 'Type-check only (no emit)',

package/dist/create-package/variants/client.js

@@ -1,4 +1,15 @@
 import { BASE_LINT_DEV_DEPENDENCIES, basePackageFiles, basePackageJson, buildReadme, baseScripts, baseTsConfig, writeFileIfMissing, } from '../shared.js';
+const CLIENT_SCRIPTS = [
+    'dev',
+    'build',
+    'typecheck',
+    'lint',
+    'lint:fix',
+    'format',
+    'format:check',
+    'clean',
+    'test',
+];
 const CONTRACT_IMPORT_PLACEHOLDER = '@your-scope/contract';
 export function clientIndexTs(contractImport) {
     return `import { QueryClient } from '@tanstack/react-query'
@@ -35,17 +46,6 @@ export function clientPackageJson(name, contractName = CONTRACT_IMPORT_PLACEHOLD
     });
 }
 function clientFiles(pkgName, contractImport) {
-    const scriptsForReadme = [
-        'dev',
-        'build',
-        'typecheck',
-        'lint',
-        'lint:fix',
-        'format',
-        'format:check',
-        'clean',
-        'test',
-    ];
     return {
         'package.json': clientPackageJson(pkgName, contractImport),
         'tsconfig.json': baseTsConfig({ lib: ['ES2020', 'DOM'], types: ['node'] }),
@@ -54,7 +54,7 @@ function clientFiles(pkgName, contractImport) {
         'README.md': buildReadme({
             name: pkgName,
             description: 'Starter RRRoutes client scaffold.',
-            scripts: scriptsForReadme,
+            scripts: CLIENT_SCRIPTS,
             sections: [
                 {
                     title: 'Getting Started',
@@ -83,6 +83,13 @@ export const clientVariant = {
     id: 'rrr-client',
     label: 'rrr client',
     defaultDir: 'packages/rrr-client',
+    summary: 'React Query-ready RRRoutes client bound to a shared contract import.',
+    keyFiles: ['src/index.ts', 'README.md'],
+    scripts: CLIENT_SCRIPTS,
+    notes: [
+        'Set the contract import via --contract or by editing src/index.ts.',
+        'Exports query client + typed route builders to plug into React apps.',
+    ],
     async scaffold(ctx) {
         const contractImport = ctx.contractName ?? CONTRACT_IMPORT_PLACEHOLDER;
         const files = clientFiles(ctx.pkgName, contractImport);

package/dist/create-package/variants/contract.js

@@ -1,4 +1,15 @@
 import { BASE_LINT_DEV_DEPENDENCIES, basePackageFiles, basePackageJson, buildReadme, baseScripts, baseTsConfig, writeFileIfMissing, } from '../shared.js';
+const CONTRACT_SCRIPTS = [
+    'dev',
+    'build',
+    'typecheck',
+    'lint',
+    'lint:fix',
+    'format',
+    'format:check',
+    'clean',
+    'test',
+];
 export const CONTRACT_TS = `import { defineSocketEvents, finalize, resource } from '@emeryld/rrroutes-contract'
 import { z } from 'zod'
 
@@ -90,17 +101,6 @@ function contractPackageJson(name) {
     });
 }
 function contractFiles(pkgName) {
-    const scriptsForReadme = [
-        'dev',
-        'build',
-        'typecheck',
-        'lint',
-        'lint:fix',
-        'format',
-        'format:check',
-        'clean',
-        'test',
-    ];
     return {
         'package.json': contractPackageJson(pkgName),
         'tsconfig.json': baseTsConfig(),
@@ -109,7 +109,7 @@ function contractFiles(pkgName) {
         'README.md': buildReadme({
             name: pkgName,
             description: 'Contract package scaffolded by manager-cli.',
-            scripts: scriptsForReadme,
+            scripts: CONTRACT_SCRIPTS,
             sections: [
                 {
                     title: 'Getting Started',
@@ -134,6 +134,12 @@ export const contractVariant = {
     id: 'rrr-contract',
     label: 'rrr contract',
     defaultDir: 'packages/rrr-contract',
+    summary: 'Shared RRRoutes registry + sockets to be consumed by server/client packages.',
+    keyFiles: ['src/index.ts', 'README.md'],
+    scripts: CONTRACT_SCRIPTS,
+    notes: [
+        'Edit src/index.ts to define routes and socket events; exports registry/socket config.',
+    ],
     async scaffold(ctx) {
         const files = contractFiles(ctx.pkgName);
         for (const [relative, contents] of Object.entries(files)) {

package/dist/create-package/variants/docker.js

@@ -1,4 +1,23 @@
 import { BASE_LINT_DEV_DEPENDENCIES, basePackageFiles, basePackageJson, buildReadme, baseScripts, baseTsConfig, writeFileIfMissing, } from '../shared.js';
+const DOCKER_SCRIPTS = [
+    'dev',
+    'build',
+    'typecheck',
+    'lint',
+    'lint:fix',
+    'format',
+    'format:check',
+    'clean',
+    'test',
+    'start',
+    'docker:build',
+    'docker:up',
+    'docker:dev',
+    'docker:logs',
+    'docker:stop',
+    'docker:clean',
+    'docker:reset',
+];
 function dockerPackageJson(name) {
     return basePackageJson({
         name,
@@ -77,25 +96,6 @@ CMD ["node", "dist/index.js"]
 `;
 }
 function dockerFiles(pkgName) {
-    const scriptsForReadme = [
-        'dev',
-        'build',
-        'typecheck',
-        'lint',
-        'lint:fix',
-        'format',
-        'format:check',
-        'clean',
-        'test',
-        'start',
-        'docker:build',
-        'docker:up',
-        'docker:dev',
-        'docker:logs',
-        'docker:stop',
-        'docker:clean',
-        'docker:reset',
-    ];
     return {
         'package.json': dockerPackageJson(pkgName),
         'tsconfig.json': baseTsConfig({ types: ['node'] }),
@@ -107,7 +107,7 @@ function dockerFiles(pkgName) {
         'README.md': buildReadme({
             name: pkgName,
             description: 'Dockerized service scaffolded by manager-cli.',
-            scripts: scriptsForReadme,
+            scripts: DOCKER_SCRIPTS,
             sections: [
                 {
                     title: 'Getting Started',
@@ -221,6 +221,18 @@ export const dockerVariant = {
     id: 'rrr-docker',
     label: 'dockerized service',
     defaultDir: 'packages/rrr-docker',
+    summary: 'Express service plus Dockerfile and a helper CLI for local runs.',
+    keyFiles: [
+        'src/index.ts',
+        'scripts/docker.ts',
+        'Dockerfile',
+        'README.md',
+    ],
+    scripts: DOCKER_SCRIPTS,
+    notes: [
+        'Use docker:dev or docker:up to build and run the container quickly.',
+        'scripts/docker.ts wraps common docker commands with consistent naming.',
+    ],
     async scaffold(ctx) {
         const files = dockerFiles(ctx.pkgName);
         for (const [relative, contents] of Object.entries(files)) {

package/dist/create-package/variants/empty.js

@@ -1,4 +1,15 @@
 import { BASE_LINT_DEV_DEPENDENCIES, basePackageFiles, basePackageJson, buildReadme, baseScripts, baseTsConfig, writeFileIfMissing, } from '../shared.js';
+const EMPTY_SCRIPTS = [
+    'dev',
+    'build',
+    'typecheck',
+    'lint',
+    'lint:fix',
+    'format',
+    'format:check',
+    'clean',
+    'test',
+];
 function emptyPackageJson(name) {
     return basePackageJson({
         name,
@@ -9,17 +20,6 @@ function emptyPackageJson(name) {
     });
 }
 function emptyFiles(pkgName) {
-    const scriptsForReadme = [
-        'dev',
-        'build',
-        'typecheck',
-        'lint',
-        'lint:fix',
-        'format',
-        'format:check',
-        'clean',
-        'test',
-    ];
     return {
         'package.json': emptyPackageJson(pkgName),
         'tsconfig.json': baseTsConfig({ types: ['node'] }),
@@ -28,7 +28,7 @@ function emptyFiles(pkgName) {
         'README.md': buildReadme({
             name: pkgName,
             description: 'Empty package scaffolded by manager-cli.',
-            scripts: scriptsForReadme,
+            scripts: EMPTY_SCRIPTS,
             sections: [
                 {
                     title: 'Getting Started',
@@ -50,6 +50,10 @@ export const emptyVariant = {
     id: 'rrr-empty',
     label: 'empty package',
     defaultDir: 'packages/rrr-empty',
+    summary: 'Minimal TypeScript package with lint/format/test scaffolding.',
+    keyFiles: ['src/index.ts', 'README.md'],
+    scripts: EMPTY_SCRIPTS,
+    notes: ['Start coding in src/index.ts; everything else is wired up.'],
     async scaffold(ctx) {
         const files = emptyFiles(ctx.pkgName);
         for (const [relative, contents] of Object.entries(files)) {

package/dist/create-package/variants/fullstack.js

@@ -4,6 +4,25 @@ import { clientVariant } from './client.js';
 import { serverVariant } from './server.js';
 import { dockerVariant } from './docker.js';
 import { contractVariant } from './contract.js';
+const FULLSTACK_SCRIPTS = [
+    'setup',
+    'dev',
+    'build',
+    'typecheck',
+    'lint',
+    'lint:fix',
+    'lint-staged',
+    'format',
+    'format:check',
+    'test',
+    'clean',
+    'prepare',
+    'docker:up',
+    'docker:dev',
+    'docker:logs',
+    'docker:stop',
+    'docker:reset',
+];
 function deriveNames(baseName) {
     const normalized = baseName.trim();
     return {
@@ -97,6 +116,21 @@ export const fullstackVariant = {
     id: 'rrr-fullstack',
     label: 'rrr fullstack (contract + server + client + docker)',
     defaultDir: 'rrrfull-stack',
+    summary: 'End-to-end RRRoutes stack: pnpm workspace with contract, server, client, and docker helper packages.',
+    keyFiles: [
+        'package.json',
+        'pnpm-workspace.yaml',
+        'docker-compose.yml',
+        'packages/<name>-contract',
+        'packages/<name>-server',
+        'packages/<name>-client',
+        'packages/<name>-docker',
+    ],
+    scripts: FULLSTACK_SCRIPTS,
+    notes: [
+        'Generates four packages and a workspace root; great starting point when you need the whole stack.',
+        'Use --name to control the workspace prefix (default is the target folder name).',
+    ],
     async scaffold(ctx) {
         const baseName = ctx.pkgName;
         const names = deriveNames(baseName);

package/dist/create-package/variants/server.js

@@ -1,4 +1,16 @@
 import { BASE_LINT_DEV_DEPENDENCIES, basePackageFiles, basePackageJson, buildReadme, baseScripts, baseTsConfig, writeFileIfMissing, } from '../shared.js';
+const SERVER_SCRIPTS = [
+    'dev',
+    'build',
+    'typecheck',
+    'lint',
+    'lint:fix',
+    'format',
+    'format:check',
+    'clean',
+    'test',
+    'start',
+];
 const CONTRACT_IMPORT_PLACEHOLDER = '@your-scope/contract';
 export function serverIndexTs(contractImport) {
     return `import 'dotenv/config'
@@ -70,18 +82,6 @@ export function serverPackageJson(name, contractName = CONTRACT_IMPORT_PLACEHOLD
     });
 }
 function serverFiles(pkgName, contractImport) {
-    const scriptsForReadme = [
-        'dev',
-        'build',
-        'typecheck',
-        'lint',
-        'lint:fix',
-        'format',
-        'format:check',
-        'clean',
-        'test',
-        'start',
-    ];
     return {
         'package.json': serverPackageJson(pkgName, contractImport),
         'tsconfig.json': baseTsConfig({ types: ['node'] }),
@@ -91,7 +91,7 @@ function serverFiles(pkgName, contractImport) {
         'README.md': buildReadme({
             name: pkgName,
             description: 'Starter RRRoutes server scaffold.',
-            scripts: scriptsForReadme,
+            scripts: SERVER_SCRIPTS,
             sections: [
                 {
                     title: 'Getting Started',
@@ -121,6 +121,13 @@ export const serverVariant = {
     id: 'rrr-server',
     label: 'rrr server',
     defaultDir: 'packages/rrr-server',
+    summary: 'Express + RRRoutes server wired to a contract import; ships a health route.',
+    keyFiles: ['src/index.ts', '.env.example', 'README.md'],
+    scripts: SERVER_SCRIPTS,
+    notes: [
+        'Set the contract import via --contract or by editing src/index.ts.',
+        'Includes start script for compiled output and dotenv-ready dev script.',
+    ],
     async scaffold(ctx) {
         const contractImport = ctx.contractName ?? CONTRACT_IMPORT_PLACEHOLDER;
         const files = serverFiles(ctx.pkgName, contractImport);

package/dist/publish.js

@@ -5,7 +5,7 @@ import { getOrderedPackages, loadPackages, resolvePackage } from './packages.js'
 import { releaseMultiple, releaseSingle, } from './release.js';
 import { ensureWorkingTreeCommitted } from './preflight.js';
 import { publishCliState } from './prompts.js';
-import { createRrrPackage } from './create-package/index.js';
+import { createRrrPackage, runCreatePackageCli, } from './create-package/index.js';
 import { colors, logGlobal } from './utils/log.js';
 function resolveTargetsFromArg(packages, arg) {
     if (arg.toLowerCase() === 'all')
@@ -121,6 +121,14 @@ async function runPackageSelectionLoop(packages, helperArgs) {
 }
 async function main() {
     const cliArgs = process.argv.slice(2);
+    if (cliArgs[0] === 'create') {
+        await runCreatePackageCli(cliArgs.slice(1));
+        return;
+    }
+    if (cliArgs[0] === 'templates') {
+        await runCreatePackageCli(['--list']);
+        return;
+    }
     const parsed = parseCliArgs(cliArgs);
     const packages = await loadPackages();
     // If user provided non-interactive flags, run headless path

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/manager",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Interactive manager for pnpm monorepos (update/test/build/publish).",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,8 @@
   "devDependencies": {
     "@types/node": "^20.17.0",
     "@types/semver": "^7.7.1",
-    "cross-env": "^7.0.3"
+    "cross-env": "^7.0.3",
+    "@emeryld/manager": "^0.4.1"
   },
   "ts-node": {
     "esm": true,
@@ -41,6 +42,6 @@
   "scripts": {
     "build": "tsc -p tsconfig.base.json && node scripts/copy-manager-cli.mjs",
     "typecheck": "tsc -p tsconfig.base.json --noEmit",
-    "test": "cross-env TS_NODE_PROJECT=tsconfig.test.json node --loader ts-node/esm test/helper-cli.test.ts"
+    "test": "cross-env TS_NODE_PROJECT=tsconfig.test.json node --loader ts-node/esm --test test/*.test.ts"
   }
 }