create-astram-app 0.1.3 → 0.3.0

package/dist/add-frontend.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * `astram-add-frontend` — additive frontend installer for an EXISTING Astram app
+ * (ADR-0023 §3, Task B8).
+ *
+ *   cd my-existing-app
+ *   npx astram-add-frontend
+ *
+ * This is the SECOND delivery path for `template/frontend/` (the Vite/React
+ * identity UI) alongside `create-astram-app <name> --with-frontend` (Task B7,
+ * which emits it at scaffold time for a BRAND NEW app). `astram-add-frontend`
+ * targets an app that was scaffolded earlier WITHOUT `--with-frontend`, or any
+ * existing directory a developer wants to bolt the identity UI onto later.
+ *
+ * Copies `template/frontend/` → `<cwd>/frontend/` using the EXACT same
+ * `copyTemplate` skip-if-exists semantics as the main scaffolder (imported from
+ * `./index.js`, not re-implemented): existing files are NEVER overwritten, so
+ * re-running this bin after the developer has edited `frontend/` is always safe
+ * — it only adds files that are still missing (e.g. a newer template picked up
+ * a file this app doesn't have yet).
+ */
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { copyTemplate, templateDir } from './index.js';
+/**
+ * The app name substituted into `__APP_NAME__` tokens in the copied frontend
+ * files (`package.json` name, `<title>`, comments — see `template/frontend/`).
+ * Resolved from the CURRENT DIRECTORY'S OWN `package.json` `name` field when
+ * present (this is an EXISTING app being extended, not a fresh scaffold), else
+ * falls back to the directory's basename.
+ */
+export function resolveAppName(cwd) {
+    const pkgPath = join(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            if (typeof pkg.name === 'string' && pkg.name.trim().length > 0) {
+                return pkg.name.trim();
+            }
+        }
+        catch {
+            // Malformed/unreadable package.json — fall through to the directory name
+            // rather than failing the whole add-frontend run over a cosmetic token.
+        }
+    }
+    return basename(cwd);
+}
+/**
+ * Add `frontend/` to the app rooted at `cwd` (default `process.cwd()`). Returns
+ * the target dir + copy report. Exported for tests (which pass an explicit
+ * `cwd`), mirroring `scaffold()` in `index.ts`.
+ */
+export function addFrontend(cwd = process.cwd()) {
+    const appName = resolveAppName(cwd);
+    const targetDir = resolve(cwd, 'frontend');
+    const report = { written: [], skipped: [] };
+    copyTemplate(join(templateDir(), 'frontend'), targetDir, appName, report, 'frontend');
+    return { targetDir, report };
+}
+/** Entry point. Returns a process exit code (0 ok, non-zero on error). */
+export function main() {
+    let result;
+    try {
+        result = addFrontend(process.cwd());
+    }
+    catch (err) {
+        console.error(`astram-add-frontend: ${err.message}`);
+        return 1;
+    }
+    const { report } = result;
+    console.log('\nAdded frontend/ (Vite/React identity UI) to this app.');
+    console.log(`  ${report.written.length} file(s) written.`);
+    if (report.skipped.length > 0) {
+        console.log(`  ${report.skipped.length} existing file(s) left untouched (never-clobber): ${report.skipped.join(', ')}`);
+    }
+    console.log('\nNext steps:');
+    console.log('  cd frontend');
+    console.log('  npm install');
+    console.log('  npm run dev        # boots the identity UI (login, session)');
+    console.log('');
+    return 0;
+}
+// Run ONLY when this module is the process entry point (i.e. executed as the
+// CLI), NOT when imported by a test. Identical symlink-safe realpath check to
+// `index.ts`'s `isInvokedAsCli()`: `npx`/npm run a `bin` through a SYMLINK, so
+// `process.argv[1]` is the symlink path, not this real dist file — resolve
+// (realpath) before comparing, or the CLI silently no-ops under npx. When
+// imported by a test, argv[1] is the test runner, resolving to a different
+// real file → correctly skips.
+function isInvokedAsCli() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    const thisFile = fileURLToPath(import.meta.url);
+    try {
+        return realpathSync(entry) === realpathSync(thisFile);
+    }
+    catch {
+        // If either path can't be realpath'd, fall back to a direct compare.
+        return pathToFileURL(entry).href === import.meta.url;
+    }
+}
+if (isInvokedAsCli()) {
+    process.exitCode = main();
+}
+//# sourceMappingURL=add-frontend.js.map

package/dist/add-frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-frontend.js","sourceRoot":"","sources":["../src/add-frontend.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,7 +2,8 @@
 /**
  * `create-astram-app` — the Astram app scaffolder (ADR-0023 §3).
  *
- *   npx create-astram-app <name>
+ *   npx create-astram-app <name>                    # server/ only
+ *   npx create-astram-app <name> --with-frontend     # + frontend/ (identity UI)
  *
  * Emits a NEW consumer app directory that depends on the published, immutable
  * framework packages (`@astram/core`, `@astram/guard`, `@astram/sdk`) via real
@@ -21,12 +22,20 @@
  * Reference skeleton: `examples/example-backend/` in the astram-framework repo.
  */
 import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
+import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 /** Token substituted with the app name at copy time (in package.json name, README title, …). */
 const APP_NAME_TOKEN = '__APP_NAME__';
-/** Directory (inside the published package) that holds the emitted app template. */
-function templateDir() {
+/**
+ * Directory (inside the published package) that holds the emitted app template.
+ * Resolved relative to THIS file's own compiled location, NOT the caller's —
+ * safe to import from a sibling bin (e.g. `add-frontend.ts`, Task B8) because
+ * both compile into the SAME `dist/` directory, so `dist/index.js/../template`
+ * and `dist/add-frontend.js/../template` are identical. Exported so sibling
+ * bins reuse this exact path-math instead of duplicating (and risking drift
+ * from) it.
+ */
+export function templateDir() {
     // dist/index.js → ../template (bundled via the package's `files` field).
     const here = dirname(fileURLToPath(import.meta.url));
     return resolve(here, '..', 'template');
@@ -59,15 +68,42 @@ export function validateAppName(name) {
     return null;
 }
 const USAGE = [
-    'Usage: create-astram-app <name>',
+    'Usage: create-astram-app <name> [--with-frontend]',
     '',
     'Scaffolds a new Astram consumer app that depends on the published framework',
     '(@astram/core, @astram/guard, @astram/sdk) and enforces deny-by-default from',
     'the first boot.',
     '',
+    '  --with-frontend   Also scaffold frontend/ (Vite/React identity UI).',
+    '                    Without this flag, only server/ is scaffolded.',
+    '',
     'Example:',
     '  npx create-astram-app my-app',
+    '  npx create-astram-app my-app --with-frontend',
 ].join('\n');
+/**
+ * Copy a SINGLE template file `srcPath` → `destPath` (never a directory),
+ * substituting {@link APP_NAME_TOKEN} in text file CONTENTS, and NEVER
+ * overwriting a file that already exists at the destination (spec §3.1 —
+ * never clobber developer-authored files). `rel` is the path relative to the
+ * template root, recorded in `report.written`/`report.skipped`.
+ */
+function copyTemplateFile(srcPath, destPath, appName, report, rel) {
+    if (existsSync(destPath)) {
+        // Never-clobber: leave the developer's file exactly as-is.
+        report.skipped.push(rel);
+        return;
+    }
+    const raw = readFileSync(srcPath);
+    if (isTextFile(basename(srcPath))) {
+        const substituted = raw.toString('utf8').split(APP_NAME_TOKEN).join(appName);
+        writeFileSync(destPath, substituted, 'utf8');
+    }
+    else {
+        cpSync(srcPath, destPath);
+    }
+    report.written.push(rel);
+}
 /**
  * Recursively copy `srcDir` → `destDir`, substituting {@link APP_NAME_TOKEN} in
  * text file CONTENTS, and NEVER overwriting a file that already exists at the
@@ -75,8 +111,14 @@ const USAGE = [
  * are created as needed; only missing files are written.
  *
  * `relBase` accumulates the path relative to the template root for reporting.
+ *
+ * Exported so sibling bins (e.g. `add-frontend.ts`, Task B8) reuse this EXACT
+ * copy semantics — skip-if-exists / never-clobber / __APP_NAME__ substitution —
+ * for a single-subtree copy (`template/frontend` → `<cwd>/frontend`) instead of
+ * a full app scaffold, without re-implementing (and risking drift from) the
+ * never-clobber contract.
  */
-function copyTemplate(srcDir, destDir, appName, report, relBase = '') {
+export function copyTemplate(srcDir, destDir, appName, report, relBase = '') {
     mkdirSync(destDir, { recursive: true });
     for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
         const srcPath = join(srcDir, entry.name);
@@ -90,31 +132,30 @@ function copyTemplate(srcDir, destDir, appName, report, relBase = '') {
             copyTemplate(srcPath, destPath, appName, report, rel);
             continue;
         }
-        if (existsSync(destPath)) {
-            // Never-clobber: leave the developer's file exactly as-is.
-            report.skipped.push(rel);
-            continue;
-        }
-        const raw = readFileSync(srcPath);
-        if (isTextFile(entry.name)) {
-            const substituted = raw.toString('utf8').split(APP_NAME_TOKEN).join(appName);
-            writeFileSync(destPath, substituted, 'utf8');
-        }
-        else {
-            cpSync(srcPath, destPath);
-        }
-        report.written.push(rel);
+        copyTemplateFile(srcPath, destPath, appName, report, rel);
     }
 }
 /** Text extensions that get token substitution + utf8 handling. */
 function isTextFile(fileName) {
     return /\.(json|ts|js|mjs|cjs|md|txt|example|yml|yaml|gitignore)$/i.test(fileName) || fileName.startsWith('_');
 }
+/**
+ * Names of the template's top-level SUBTREES that are copied separately (not
+ * via the generic root-level pass below), because each is independently
+ * gated: `server/` is always emitted, `frontend/` only with `--with-frontend`.
+ */
+const TEMPLATE_SUBTREES = ['server', 'frontend'];
 /**
  * Scaffold `appName` into `<cwd>/<appName>`. Returns the copy report + resolved
  * target dir. Exported for tests (which pass an explicit `cwd`).
+ *
+ * `withFrontend` gates the `template/frontend/` → `<app>/frontend/` copy — the
+ * scaffolded app is server-only by default; `--with-frontend` (CLI) or
+ * `withFrontend: true` (programmatic) also emits the Vite/React identity UI.
+ * `server/` and the app-root files (`.astram/guide/`, `CLAUDE.md`, `.gitignore`,
+ * `README.md`) are unconditional either way — unchanged from prior behavior.
  */
-export function scaffold(appName, cwd = process.cwd()) {
+export function scaffold(appName, cwd = process.cwd(), withFrontend = false) {
     const targetDir = resolve(cwd, appName);
     const report = { written: [], skipped: [] };
     if (existsSync(targetDir)) {
@@ -125,12 +166,56 @@ export function scaffold(appName, cwd = process.cwd()) {
         // Existing dir is allowed — copyTemplate skips any file that already exists,
         // so developer-authored docs/, .astram/guide/, README, etc. survive untouched.
     }
-    copyTemplate(templateDir(), targetDir, appName, report);
+    const template = templateDir();
+    // The generic per-directory copyTemplate() calls always mkdirSync their own
+    // destDir first; the app root itself needs the same treatment since
+    // root-level FILES (e.g. CLAUDE.md) are written directly into targetDir
+    // below without going through copyTemplate.
+    mkdirSync(targetDir, { recursive: true });
+    // App-root files/dirs (.astram/guide/, CLAUDE.md, .gitignore, README.md, …) —
+    // everything directly under template/ EXCEPT the independently-gated
+    // server/ and frontend/ subtrees, which are copied below. Dispatch by dirent
+    // type: a directory recurses via copyTemplate; a plain file (e.g. CLAUDE.md)
+    // copies via copyTemplateFile directly — copyTemplate always treats its
+    // srcDir arg as a directory, so calling it on a FILE path throws ENOTDIR.
+    for (const entry of readdirSync(template, { withFileTypes: true })) {
+        if (TEMPLATE_SUBTREES.includes(entry.name))
+            continue;
+        const srcPath = join(template, entry.name);
+        const destName = entry.name.startsWith('_') ? `.${entry.name.slice(1)}` : entry.name;
+        const destPath = join(targetDir, destName);
+        if (entry.isDirectory()) {
+            copyTemplate(srcPath, destPath, appName, report, destName);
+        }
+        else {
+            copyTemplateFile(srcPath, destPath, appName, report, destName);
+        }
+    }
+    // server/ — always scaffolded (unchanged prior behavior).
+    copyTemplate(join(template, 'server'), join(targetDir, 'server'), appName, report, 'server');
+    // frontend/ — opt-in via --with-frontend (Task B7). Previously this was
+    // copied unconditionally as part of the wholesale template/ copy; it is now
+    // gated so a plain `create-astram-app <name>` stays server-only.
+    if (withFrontend) {
+        copyTemplate(join(template, 'frontend'), join(targetDir, 'frontend'), appName, report, 'frontend');
+    }
     return { targetDir, report };
 }
+/** Long-form boolean flags this CLI recognizes (anywhere in argv). */
+const WITH_FRONTEND_FLAG = '--with-frontend';
+/**
+ * The app name is the first argv entry that is NOT a recognized `--flag` —
+ * robust to `--with-frontend` appearing before OR after the name
+ * (`create-astram-app --with-frontend my-app` and
+ * `create-astram-app my-app --with-frontend` both work).
+ */
+function parseAppName(argv) {
+    return argv.find((arg) => !arg.startsWith('--'));
+}
 /** Entry point. Returns a process exit code (0 ok, non-zero on error). */
 export function main(argv = process.argv.slice(2)) {
-    const name = argv[0];
+    const name = parseAppName(argv);
+    const withFrontend = argv.includes(WITH_FRONTEND_FLAG);
     const validationError = validateAppName(name);
     if (validationError) {
         console.error(`create-astram-app: ${validationError}\n`);
@@ -140,7 +225,7 @@ export function main(argv = process.argv.slice(2)) {
     const appName = name.trim();
     let report;
     try {
-        ({ report } = scaffold(appName));
+        ({ report } = scaffold(appName, process.cwd(), withFrontend));
     }
     catch (err) {
         console.error(`create-astram-app: ${err.message}`);
@@ -155,7 +240,13 @@ export function main(argv = process.argv.slice(2)) {
     console.log('\nWhat you got (a monorepo):');
     console.log('  • server/  — a running, framework-ENFORCED NestJS API. Every route is denied');
     console.log('    by default (ADR-0002) unless you classify it @Public()/@Classified().');
-    console.log('  • frontend/ — an empty space for your UI (add any framework: Vite/React, etc.).');
+    if (withFrontend) {
+        console.log('  • frontend/ — a Vite/React identity UI (login, session) wired to the API.');
+    }
+    else {
+        console.log('  • frontend/ — NOT scaffolded (pass --with-frontend to also emit the Vite/React');
+        console.log('    identity UI). You can still add any UI framework yourself later.');
+    }
     console.log('  • The framework installed in server/ as immutable dependencies (@astram/core,');
     console.log('    @astram/guard, @astram/engine, @astram/sdk) — you never edit it; upgrade via');
     console.log('    `npm update`.');
@@ -168,6 +259,12 @@ export function main(argv = process.argv.slice(2)) {
     console.log(`  cd ${appName}/server`);
     console.log('  npm install');
     console.log('  npm run dev        # boots the API; GET /health → 200, unclassified → 403');
+    if (withFrontend) {
+        console.log('');
+        console.log(`  cd ${appName}/frontend`);
+        console.log('  npm install');
+        console.log('  npm run dev        # boots the identity UI (login, session)');
+    }
     console.log('');
     return 0;
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1H,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,gGAAgG;AAChG,MAAM,cAAc,GAAG,cAAc,CAAC;AAEtC,oFAAoF;AACpF,SAAS,WAAW;IAClB,yEAAyE;IACzE,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,wDAAwD,IAAI,GAAG,CAAC;IACzE,CAAC;IACD,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,+DAA+D,IAAI,GAAG,CAAC;IAChF,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,wCAAwC,IAAI,GAAG,CAAC;IACzD,CAAC;IACD,gDAAgD;IAChD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,OAAO,mEAAmE,IAAI,GAAG,CAAC;IACpF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,KAAK,GAAG;IACZ,iCAAiC;IACjC,EAAE;IACF,6EAA6E;IAC7E,8EAA8E;IAC9E,iBAAiB;IACjB,EAAE;IACF,UAAU;IACV,gCAAgC;CACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAQb;;;;;;;GAOG;AACH,SAAS,YAAY,CACnB,MAAc,EACd,OAAe,EACf,OAAe,EACf,MAAkB,EAClB,OAAO,GAAG,EAAE;IAEZ,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,4EAA4E;QAC5E,4EAA4E;QAC5E,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE1D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;YACtD,SAAS;QACX,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,2DAA2D;YAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7E,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,4DAA4D,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACjH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAExD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,iCAAiC,CAAC,CAAC;QACvE,CAAC;QACD,6EAA6E;QAC7E,+EAA+E;IACjF,CAAC;IAED,YAAY,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAErB,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,sBAAsB,eAAe,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAI,IAAe,CAAC,IAAI,EAAE,CAAC;IAExC,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,sBAAuB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,sDAAsD;IACtD,OAAO,CAAC,GAAG,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CACT,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,qDAAqD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3G,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;IACjG,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;IAC/F,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAChG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAChG,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,8EAA8E,CAAC,CAAC;IAC5F,OAAO,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;IAE1F,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,SAAS,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,gFAAgF;AAChF,2EAA2E;AAC3E,+EAA+E;AAC/E,8EAA8E;AAC9E,iFAAiF;AACjF,SAAS,cAAc;IACrB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACvD,CAAC;AACH,CAAC;AACD,IAAI,cAAc,EAAE,EAAE,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "create-astram-app",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "license": "MIT",
   "description": "Scaffolder for a new Astram app — emits a running, framework-enforced consumer project (empty src/features/ + deny-by-default enforcement) that installs the immutable @astram/core, @astram/guard, and @astram/sdk framework.",
   "type": "module",
   "bin": {
-    "create-astram-app": "dist/index.js"
+    "create-astram-app": "dist/index.js",
+    "astram-add-frontend": "dist/add-frontend.js"
   },
   "publishConfig": {
     "access": "public"

package/template/frontend/FRONTEND.md

@@ -0,0 +1,92 @@
+# __APP_NAME__ frontend
+
+This is the Astram framework's **identity frontend** — login, session, users, roles,
+companies, access, audit — scaffolded straight into your app. It is a real,
+production-shaped Vite/React UI (shadcn/ui + Tailwind v4), not a placeholder.
+
+## What this is
+
+The files under `frontend/` are **yours** — you own and edit them like any other
+part of your app. The framework does not manage or overwrite them once they're
+here.
+
+The actual auth/session/API **logic** does NOT live in these files — it comes from
+two npm packages:
+
+- **`@astram/frontend-core`** — auth flows, session handling, HTTP client wiring.
+- **`@astram/sdk`** — typed calls against the framework API (users, roles,
+  companies, access, audit).
+
+That split is what makes this model work: the **view** (these files: pages,
+components, routing, styling) is scaffolded once and is fully yours to change;
+the **logic** (auth correctness, new API surface, bug fixes) ships as ordinary
+npm package updates you pull in with `npm update`, without touching a single file
+in this folder.
+
+## Run
+
+```bash
+npm install
+npm run dev
+```
+
+- Opens the identity UI on **http://localhost:5173**.
+- Log in at **`/login`**.
+- The Vite dev server proxies **`/api`** to your backend on **`http://localhost:3000`**
+  (see `vite.config.js`) — the browser calls same-origin `/api/auth/login`, and the
+  proxy rewrites it to `/auth/login` on the server. Override the target with the
+  `API_URL` env var if your backend runs elsewhere.
+
+Make sure the framework backend (`../server`) is running first — this UI has
+nothing to talk to otherwise.
+
+## Re-skin
+
+You don't need to touch component code to make this look like your product:
+
+- **Name / logo** — copy `.env.example` to `.env` and set:
+  - `VITE_APP_NAME` — shown in the header/title instead of the default.
+  - `VITE_APP_LOGO` — path/URL to your logo (light theme).
+  - `VITE_APP_LOGO_DARK` — path/URL to your logo (dark theme).
+  - `VITE_APP_TAGLINE` / `VITE_APP_SUB_TAGLINE` — login-screen copy.
+- **Theme color** — edit the `--primary` / `--primary-foreground` oklch pair in
+  `src/index.css`: the `:root` block controls light mode, the `.dark` block
+  controls dark mode. Every primary button, focus ring, and accent in the UI
+  derives from this one token pair — change it once, it propagates everywhere.
+
+Both of these are **additive, config-only** customizations — they don't modify
+any scaffolded file, so a future framework/template update never conflicts with
+your branding.
+
+## Updates / no-clobber model
+
+Two different things update on two different schedules, and it's important to
+know which is which:
+
+1. **Logic (`@astram/frontend-core`, `@astram/sdk`)** updates like any other npm
+   dependency — `npm update` pulls in bug fixes and new API methods for free. You
+   never edit these packages directly (they live in `node_modules`).
+
+2. **View files (everything under `frontend/src/`, `frontend/index.html`, etc.)**
+   are yours. They were copied in ONCE, by either `create-astram-app --with-frontend`
+   at scaffold time or by `npx astram-add-frontend` afterwards. Nothing in the
+   framework reaches back into this folder to overwrite your edits — this file, a
+   page you've re-themed, a component you've customized, all survive indefinitely.
+
+3. **Re-running `npx astram-add-frontend` is safe, any time.** It's additive and
+   idempotent: it only writes files that are still missing (e.g. the published
+   template gained a new page or component since you last ran it). Any file that
+   already exists in your `frontend/` — including one you've heavily edited — is
+   left completely untouched. It will never overwrite your work.
+
+4. **Adopting an improved framework screen is a manual, deliberate step**, not an
+   automatic one — by design, so you're never surprised by a silent overwrite. If
+   a newer `create-astram-app` release improves a page you're using unmodified
+   (e.g. a better `Login.jsx`), diff your version against the current template
+   (published inside the `create-astram-app` npm package, under `template/frontend/`)
+   and cherry-pick the parts you want.
+
+The practical effect: keep your branding in `.env` + the `--primary` token instead
+of hand-editing component internals wherever you can — it keeps your view files
+close to the upstream template, which makes adopting future improvements a small
+diff instead of a merge conflict.

package/template/frontend/_env.example

@@ -0,0 +1,6 @@
+# __APP_NAME__ frontend — copy to .env; all optional (astram defaults apply).
+# VITE_APP_NAME=My App
+# VITE_APP_LOGO=/my-logo.png
+# VITE_APP_LOGO_DARK=/my-logo-dark.png
+# VITE_APP_TAGLINE=...
+# VITE_APP_SUB_TAGLINE=...

package/template/frontend/_gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+*.log
+.DS_Store
+
+# Local env files (real values). `.env.example` is committed as the template.
+.env
+.env.*
+!.env.example

package/template/frontend/eslint.config.js

@@ -0,0 +1,71 @@
+// Frontend ESLint flat config (ESLint 9) for an Astram consumer app.
+//
+// React + hooks + fast-refresh rules over the JS/JSX source. The `lint` script
+// (`eslint "src/**/*.{js,jsx}"`) resolves this file. The Vite build is the
+// correctness gate; this catches unused vars, hook-dependency mistakes, and
+// fast-refresh foot-guns. Uses the framework's `_`-prefixed-unused convention.
+import js from '@eslint/js';
+import globals from 'globals';
+import react from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+
+export default [
+  {
+    ignores: ['node_modules/**', 'dist/**', 'coverage/**', 'eslint.config.js'],
+  },
+
+  js.configs.recommended,
+
+  {
+    files: ['src/**/*.{js,jsx}'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: { ...globals.browser },
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+    },
+    settings: {
+      react: { version: 'detect' },
+    },
+    plugins: {
+      react,
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...react.configs.flat.recommended.rules,
+      ...react.configs.flat['jsx-runtime'].rules, // React 18 automatic JSX runtime — no `React` import needed.
+      ...reactHooks.configs.flat.recommended.rules,
+
+      // Allow `_`-prefixed intentionally-unused args/vars (shared convention).
+      'no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_' },
+      ],
+
+      // Fast-refresh: warn (not error) when a module exports non-components
+      // alongside components — common + harmless in shadcn ui files.
+      'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
+
+      // Project convention: PropTypes are not used (no `prop-types` dep).
+      'react/prop-types': 'off',
+
+      // react-hooks 7.x ships new, very aggressive rules that flag idiomatic
+      // patterns (a mount-guard `setState` in an effect, a fetch-on-mount
+      // `load()` effect, the lazy-ref-init `if (!ref.current) ref.current = …`
+      // one-time init, etc.). These were REVIEWED case-by-case (task #138): every
+      // current hit is a known-good idiom, not a bug — promoting them to error
+      // would force contorting clean code, so they stay ADVISORY (warn): visible,
+      // non-blocking. The genuinely load-bearing hooks rules below stay errors.
+      // If a future hit is an actual bug, fix that site; don't relax the warn.
+      'react-hooks/set-state-in-effect': 'warn',
+      'react-hooks/refs': 'warn',
+      // These two catch real bugs — keep them blocking.
+      'react-hooks/exhaustive-deps': 'error',
+      'react-hooks/rules-of-hooks': 'error',
+    },
+  },
+];

package/template/frontend/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en" suppressHydrationWarning>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+    <link rel="icon" type="image/png" href="/favicon.png" />
+    <title>__APP_NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/template/frontend/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "description": "The frontend (UI) half of an Astram consumer app — a professional web UI (login / auth / identity management) over the framework auth API. Built on shadcn/ui + Tailwind v4; shared auth/http logic comes from @astram/frontend-core and @astram/sdk. The API (../server) lives at http://localhost:3000 by default.",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "lint": "eslint \"src/**/*.{js,jsx}\"",
+    "test": "node --test src/**/*.test.mjs"
+  },
+  "dependencies": {
+    "@astram/frontend-core": "^0.2.0",
+    "@astram/sdk": "^0.2.0",
+    "@radix-ui/react-alert-dialog": "^1.1.19",
+    "@radix-ui/react-avatar": "^1.1.10",
+    "@radix-ui/react-checkbox": "^1.1.4",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-select": "^2.3.3",
+    "@radix-ui/react-separator": "^1.1.7",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "input-otp": "^1.4.2",
+    "lucide-react": "^0.460.0",
+    "next-themes": "^0.4.6",
+    "qrcode": "^1.5.4",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.26.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.3.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@tailwindcss/vite": "^4.1.14",
+    "@vitejs/plugin-react": "^4.3.0",
+    "eslint": "^9.39.5",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.3",
+    "globals": "^17.7.0",
+    "tailwindcss": "^4.1.14",
+    "tw-animate-css": "^1.4.0",
+    "vite": "^5.4.0"
+  }
+}