@atolljs/cli 0.0.0-stage → 0.1.5

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@atolljs/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.5",
+  "description": "atoll — scaffold worker pools, shared-memory contracts, and framework islands (experimental)",
+  "homepage": "https://jwhenry3.github.io/atolljs/consumer/quickstart/",
+  "type": "module",
+  "bin": {
+    "atoll": "./dist/cli.js"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "build": "esbuild src/cli.ts --bundle --format=esm --platform=node --target=node20.12 --outfile=dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20.12"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jwhenry3/atolljs",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/jwhenry3/atolljs/issues"
+  },
+  "license": "MIT"
+}

package/src/cli.ts

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * `atoll` — bootstrap multithreading in an app: worker pools, shared-memory
+ * contracts, framework islands, and a doctor that checks the setup.
+ *
+ * Sources stay TypeScript — dev runs this entry via Node's type stripping
+ * (`npm run atoll`, vitest, CI smoke). The *published* bin is a bundled
+ * dist/cli.js: Node refuses type stripping inside node_modules, which is
+ * where npx installs packages. Keep relative imports' `.ts` extensions
+ * explicit and stay inside erasable syntax so both paths keep working;
+ * `npm run build` (esbuild) regenerates the bundle.
+ */
+import { consoleIo, type Fmt, type Io } from './io.ts';
+import { hasFlag, parseArgs } from './parse.ts';
+import { runAdd, runCreate, runDoctor, runInit, type Ctx } from './commands.ts';
+
+const HELP = (fmt: Fmt) => `${fmt.strong('atoll')} — bootstrap multithreading ${fmt.dim('(experimental)')}
+
+  ${fmt.accent('atoll new <dir>')} [--framework react|vue|solid|svelte|node] [--pm npm]
+      Scaffold a fresh app — vite shell + a worker-rendered island,
+      or a tsx Node service with a pooled worker.
+
+  ${fmt.accent('atoll init')} [--name app] [--force]
+      Wire Atoll into the current project: hardened .npmrc, package
+      install, and a contract + worker + client spine under src/atoll/.
+
+  ${fmt.accent('atoll add [framework] <kind> [variant] [name]')}
+      worker      pool + typed client (+ framework bindings on UI projects)
+      memory      shared-memory contract
+      island      worker-rendered UI — facade (contract + lazy import) | mono
+      service     nestjs: @AtollService class facade + pool module + worker
+      method      nestjs: @AtollTask method-level offload
+      module      nestjs: registerPool boundary module + worker entry
+      housed      nestjs: route subtree served entirely inside workers
+      route       nextjs: api route pool — task | client variants
+      component   nextjs: 'use client' hooks component over a pool
+      instrumentation   nextjs: server bootstrap that warms route pools
+
+      Frameworks: react vue solid svelte angular nestjs nextjs node
+      [--dir <path>] [--memory <name>|--no-memory] [--variant <v>] [--force]
+
+  ${fmt.accent('atoll doctor')} [--fix]
+      Check the setup — deps, lockfile, .npmrc policy, bundler-detectable
+      worker entries, COOP/COEP headers. --fix writes a hardened .npmrc.
+
+  ${fmt.dim(`flags: --yes/-y accepts defaults, --force overwrites existing files,
+         --no-install skips dependency installation`)}
+`;
+
+const DISCLAIMER =
+  'atoll is experimental — report bugs or feedback: ' +
+  'https://github.com/jwhenry3/atolljs/issues';
+
+export async function runCli(argv: readonly string[], io: Io, cwd: string): Promise<number> {
+  const args = parseArgs(argv);
+  const ctx: Ctx = { io, cwd, args };
+  const [cmd] = args._;
+
+  io.warn(io.fmt.dim(DISCLAIMER));
+
+  try {
+    switch (cmd) {
+      case 'new':
+      case 'create':
+        return await runCreate(ctx);
+      case 'init':
+        return await runInit(ctx);
+      case 'add':
+        return await runAdd(ctx);
+      case 'doctor':
+        return runDoctor(ctx);
+      case 'help':
+      case undefined:
+        io.print(HELP(io.fmt));
+        return cmd === undefined ? 0 : 0;
+      default:
+        io.error(`unknown command ${io.fmt.accent(cmd)}`);
+        io.print(HELP(io.fmt));
+        return 1;
+    }
+  } catch (e) {
+    io.error(e instanceof Error ? e.message : String(e));
+    return 1;
+  } finally {
+    io.close();
+  }
+}
+
+// Entry guard — the file is also imported by tests, which pass their own io.
+const invokedAs =
+  process.argv[1] && import.meta.url.endsWith(process.argv[1].replaceAll('\\', '/'));
+if (invokedAs) {
+  const args = parseArgs(process.argv.slice(2));
+  const interactive = process.stdin.isTTY === true && !hasFlag(args, 'yes', 'y');
+  const code = await runCli(process.argv.slice(2), consoleIo(interactive), process.cwd());
+  process.exit(code);
+}