@voxgig/build 4.4.0 → 4.11.0

package/dist/doc/doc_gen.js

@@ -0,0 +1,397 @@
+"use strict";
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doc_gen = void 0;
+// Docs: model-driven documentation generation - mermaid diagrams and
+// per-service READMEs derived from the compiled model. Everything here is
+// a pure function of the model, so (like theme.css and views.js) the
+// output is REGENERATED on every model-build, content-diffed to avoid
+// needless writes, and marked AUTO-GENERATED (never hand-edit).
+//
+// Outputs (paths relative to the project root):
+//   docs/reference/entities.md    entity tables + ER diagram (ref fields)
+//   docs/reference/messages.md    per-service message tables + flow diagram
+//   docs/reference/system-map.md  system architecture + dependency map
+//   backend/src/srv/<srv>/README.md   one per implemented service
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const GENMARK = (what) => `<!-- AUTO-GENERATED from the model by @voxgig/build (${what}) - do not edit. -->`;
+// Sanitize a canon or name into a mermaid-safe node id.
+const mid = (s) => String(s).replace(/[^A-Za-z0-9_]/g, '_');
+// ---- model walkers ----
+// Leaf message patterns under a msg subtree. A leaf is a node with no
+// child objects other than the '$' metadata entry. Returns
+// [{ path: ['save','item'], meta: {file?} }].
+function msgLeaves(node, prefix = []) {
+    const out = [];
+    const keys = Object.keys(node || {}).filter((k) => '$' !== k);
+    if (0 === keys.length && 0 < prefix.length) {
+        return [{ path: prefix, meta: (node && node.$) || {} }];
+    }
+    for (const k of keys) {
+        if (node[k] && 'object' === typeof node[k]) {
+            out.push(...msgLeaves(node[k], [...prefix, k]));
+        }
+        else if (0 < prefix.length) {
+            // Scalar child: treat the current node as a leaf with options.
+            return [{ path: prefix, meta: (node && node.$) || {} }];
+        }
+    }
+    return out;
+}
+// Pattern string for a leaf under aim:<srv>: 'aim:todo,save:item'.
+const patstr = (aim, path) => {
+    let s = 'aim:' + aim;
+    for (let i = 0; i < path.length; i += 2) {
+        s += ',' + path[i] + ':' + (path[i + 1] || '');
+    }
+    return s;
+};
+// Action file for a message by the MakeSrv convention: last pattern pair
+// joined with '_' ('save','item' -> save_item), unless $.file overrides.
+const actfile = (path, meta) => {
+    if (meta && meta.file) {
+        return String(meta.file).replace(/^\.\//, '');
+    }
+    const last = path.slice(-2);
+    return last.join('_');
+};
+// The services and their messages, from main.srv[].in + main.msg.aim.
+function services(model) {
+    const srvs = model.main.srv || {};
+    const aim = (model.main.msg && model.main.msg.aim) || {};
+    const out = [];
+    for (const name of Object.keys(srvs)) {
+        const srv = srvs[name];
+        const inaim = (srv.in && srv.in.aim) || {};
+        const own = [];
+        const routes = [];
+        for (const k of Object.keys(inaim)) {
+            if ('req' === k) {
+                const on = (inaim.req && inaim.req.on) || {};
+                for (const rk of Object.keys(on)) {
+                    for (const leaf of msgLeaves((aim.req && aim.req.on && aim.req.on[rk]) || {})) {
+                        routes.push({
+                            raw: leaf, on: rk,
+                            file: actfile(leaf.path, leaf.meta),
+                        });
+                    }
+                }
+            }
+            else {
+                for (const leaf of msgLeaves(aim[k] || {})) {
+                    own.push({
+                        pattern: patstr(k, leaf.path),
+                        file: actfile(leaf.path, leaf.meta),
+                    });
+                }
+            }
+        }
+        out.push({ name, srv, msgs: own, routes });
+    }
+    return out;
+}
+// Entities with their fields and ref relationships.
+function entities(model) {
+    const zones = model.main.ent || {};
+    const out = [];
+    for (const zone of Object.keys(zones)) {
+        for (const name of Object.keys(zones[zone])) {
+            const def = zones[zone][name] || {};
+            const fields = [];
+            const refs = [];
+            for (const fname of Object.keys(def.field || {})) {
+                const f = def.field[fname] || {};
+                fields.push({ name: fname, kind: f.kind || 'String', ref: f.ref });
+                if (f.ref) {
+                    refs.push({ field: fname, target: f.ref });
+                }
+            }
+            out.push({
+                zone, name, canon: zone + '/' + name, fields, refs,
+                custom: !!(def.ux && 'custom' === def.ux.view),
+            });
+        }
+    }
+    return out;
+}
+// ---- generators ----
+function entitiesMd(model) {
+    const ents = entities(model);
+    const lines = [];
+    lines.push('# Reference: entities (generated)');
+    lines.push('');
+    lines.push(GENMARK('doc_gen'));
+    lines.push('');
+    lines.push('*Diátaxis: reference — the entity graph, derived from the model.*');
+    lines.push('');
+    lines.push('## Entity relationship diagram');
+    lines.push('');
+    lines.push('Relationships come from `ref` fields (the field stores the id of the');
+    lines.push('target entity).');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('erDiagram');
+    for (const e of ents) {
+        lines.push('  ' + mid(e.canon) + ' {');
+        for (const f of e.fields) {
+            lines.push('    ' + mid(f.kind) + ' ' + mid(f.name) + (f.ref ? ' FK' : ''));
+        }
+        lines.push('  }');
+    }
+    for (const e of ents) {
+        for (const r of e.refs) {
+            lines.push('  ' + mid(r.target) + ' ||--o{ ' + mid(e.canon) + ' : "' + r.field + '"');
+        }
+    }
+    lines.push('```');
+    lines.push('');
+    lines.push('(Entity ids are canons with `/` shown as `_`.)');
+    lines.push('');
+    lines.push('## Entities');
+    lines.push('');
+    lines.push('| Canon | Fields | Relationships | UI |');
+    lines.push('|---|---|---|---|');
+    for (const e of ents) {
+        const flds = e.fields.map((f) => f.name).join(', ');
+        const refs = e.refs.map((r) => `${r.field} → ${r.target}`).join('<br>') || '—';
+        lines.push(`| \`${e.canon}\` | ${flds} | ${refs} | ${e.custom ? 'custom view' : 'generic admin'} |`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function messagesMd(model) {
+    const srvs = services(model);
+    const lines = [];
+    lines.push('# Reference: messages (generated)');
+    lines.push('');
+    lines.push(GENMARK('doc_gen'));
+    lines.push('');
+    lines.push('*Diátaxis: reference — services and the messages they answer, derived');
+    lines.push('from the model. Action files follow the MakeSrv convention (last');
+    lines.push('pattern pair: `save:item` → `save_item`).*');
+    lines.push('');
+    lines.push('## Message flow');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('flowchart LR');
+    lines.push('  client([Clients / SPA])');
+    lines.push('  gateway{{gateway}}');
+    lines.push('  client -->|aim:* messages| gateway');
+    for (const s of srvs) {
+        lines.push('  ' + mid(s.name) + '[srv ' + s.name + ']');
+        const aims = Object.keys((s.srv.in && s.srv.in.aim) || {}).filter((k) => 'req' !== k);
+        for (const a of aims) {
+            lines.push('  gateway -->|aim:' + a + '| ' + mid(s.name));
+        }
+    }
+    lines.push('```');
+    lines.push('');
+    for (const s of srvs) {
+        lines.push('## Service: ' + s.name);
+        lines.push('');
+        lines.push('| Message | Action file |');
+        lines.push('|---|---|');
+        for (const m of s.msgs) {
+            lines.push('| `' + m.pattern + '` | `src/srv/' + s.name + '/' + m.file + '.ts` |');
+        }
+        lines.push('');
+        if (s.routes.length) {
+            lines.push('Gateway (web) routes:');
+            lines.push('');
+            lines.push('| Route | Handler file |');
+            lines.push('|---|---|');
+            for (const r of s.routes) {
+                lines.push('| `aim:req,on:' + r.on + ',' + patstr('', r.raw.path).slice(5) +
+                    '` | `src/srv/' + s.name + '/' + r.file + '.ts` |');
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+function systemMapMd(model) {
+    const srvs = services(model);
+    const ents = entities(model);
+    const envs = model.main.env || {};
+    const active = Object.keys(envs).filter((k) => envs[k] && envs[k].active);
+    const webactive = !!(envs.web && envs.web.active);
+    const zones = {};
+    for (const e of ents) {
+        (zones[e.zone] = zones[e.zone] || []).push(e);
+    }
+    const lines = [];
+    lines.push('# Reference: system map (generated)');
+    lines.push('');
+    lines.push(GENMARK('doc_gen'));
+    lines.push('');
+    lines.push('*Diátaxis: reference — the system structure and its dependencies,');
+    lines.push('derived from the model.*');
+    lines.push('');
+    lines.push('## Architecture');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('flowchart TB');
+    if (webactive) {
+        lines.push('  subgraph spa[Web SPA]');
+        lines.push('    shell[cmp/shell]');
+        lines.push('    admin[cmp/admin]');
+        lines.push('    publiccmp[cmp/public + cmp/auth]');
+        lines.push('    settings[cmp/settings]');
+        for (const e of ents.filter((x) => x.custom)) {
+            lines.push('    view_' + mid(e.canon) + '[cmp/view/' + e.zone + '_' + e.name + ']');
+        }
+        lines.push('    bus[(Seneca bus)]');
+        lines.push('    shell --> bus');
+        lines.push('    admin --> bus');
+        lines.push('    publiccmp --> bus');
+        lines.push('    settings --> bus');
+        for (const e of ents.filter((x) => x.custom)) {
+            lines.push('    view_' + mid(e.canon) + ' --> bus');
+        }
+        lines.push('  end');
+        lines.push('  bus -->|aim:* over browser transport| gateway{{gateway}}');
+    }
+    else {
+        lines.push('  client([Clients]) -->|aim:*| gateway{{gateway}}');
+    }
+    lines.push('  subgraph services[Services]');
+    for (const s of srvs) {
+        lines.push('    srv_' + mid(s.name) + '[' + s.name + ']');
+    }
+    lines.push('  end');
+    for (const s of srvs) {
+        lines.push('  gateway --> srv_' + mid(s.name));
+    }
+    // Service deps from the model (srv.deps), if declared.
+    for (const s of srvs) {
+        for (const d of Object.keys(s.srv.deps || {})) {
+            lines.push('  srv_' + mid(s.name) + ' -.depends.-> srv_' + mid(d));
+        }
+    }
+    lines.push('  subgraph data[Entities]');
+    for (const zone of Object.keys(zones).sort()) {
+        lines.push('    subgraph zone_' + mid(zone) + '[zone ' + zone + ']');
+        for (const e of zones[zone]) {
+            lines.push('      ' + mid(e.canon) + '[' + e.name + ']');
+        }
+        lines.push('    end');
+    }
+    lines.push('  end');
+    for (const s of srvs) {
+        lines.push('  srv_' + mid(s.name) + ' --> data');
+    }
+    lines.push('```');
+    lines.push('');
+    lines.push('## Target environments');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('flowchart LR');
+    lines.push('  model[(model.json)]');
+    for (const name of active) {
+        lines.push('  model --> env_' + mid(name) + '[env ' + name + ']');
+    }
+    lines.push('```');
+    lines.push('');
+    lines.push('Active environments: ' + (active.map((a) => '`' + a + '`').join(', ') || 'none') + '.');
+    lines.push('');
+    lines.push('See also: [entities](entities.md) · [messages](messages.md).');
+    lines.push('');
+    return lines.join('\n');
+}
+function srvReadmeMd(model, s) {
+    const lines = [];
+    lines.push('# Service: ' + s.name + ' (generated)');
+    lines.push('');
+    lines.push(GENMARK('doc_gen'));
+    lines.push('');
+    lines.push('Answers `aim:' +
+        Object.keys((s.srv.in && s.srv.in.aim) || {}).filter((k) => 'req' !== k).join('`, `aim:') +
+        '` messages, loaded by convention (`@voxgig/system` MakeSrv): each');
+    lines.push('message maps to the action file named after its last pattern pair.');
+    lines.push('');
+    if (s.srv.user && s.srv.user.required) {
+        lines.push('Requires a signed-in user (`user.required: true`).');
+        lines.push('');
+    }
+    lines.push('## Messages');
+    lines.push('');
+    lines.push('| Message | Action file |');
+    lines.push('|---|---|');
+    for (const m of s.msgs) {
+        lines.push('| `' + m.pattern + '` | `' + m.file + '.ts` |');
+    }
+    for (const r of s.routes) {
+        lines.push('| `aim:req,on:' + r.on + ',' + patstr('', r.raw.path).slice(5) +
+            '` (gateway) | `' + r.file + '.ts` |');
+    }
+    lines.push('');
+    lines.push('## Flow');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('flowchart LR');
+    lines.push('  gateway{{gateway}} -->|validated msg| srv[srv ' + s.name + ']');
+    const seen = new Set();
+    for (const m of s.msgs) {
+        if (!seen.has(m.file)) {
+            seen.add(m.file);
+            lines.push('  srv --> ' + mid(m.file) + '["' + m.pattern + '<br>' + m.file + '.ts"]');
+        }
+    }
+    for (const r of s.routes) {
+        const rid = mid(r.file);
+        if (!seen.has(r.file)) {
+            seen.add(r.file);
+            lines.push('  gateway -.route.-> ' + rid + '["' + r.file + '.ts"]');
+        }
+    }
+    lines.push('```');
+    lines.push('');
+    lines.push('Message params are validated from the model (gubu); see');
+    lines.push('`../../../model/` and `docs/reference/messages.md` at the project root.');
+    lines.push('');
+    return lines.join('\n');
+}
+// Write content if changed; return true when written.
+function writeIfChanged(dest, content) {
+    const existing = fs_1.default.existsSync(dest) ? fs_1.default.readFileSync(dest, 'utf8') : null;
+    if (existing === content) {
+        return false;
+    }
+    fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
+    fs_1.default.writeFileSync(dest, content);
+    return true;
+}
+// doc_gen(model, spec): generate the model-driven docs. Returns
+// { created } - the (project-relative) paths actually (re)written.
+const doc_gen = async (model, spec) => {
+    const root = spec.root;
+    const srvfolder = spec.srvfolder || path_1.default.join(root, 'backend', 'src', 'srv');
+    const created = [];
+    const refdir = path_1.default.join(root, 'docs', 'reference');
+    if (writeIfChanged(path_1.default.join(refdir, 'entities.md'), entitiesMd(model))) {
+        created.push('docs/reference/entities.md');
+    }
+    if (writeIfChanged(path_1.default.join(refdir, 'messages.md'), messagesMd(model))) {
+        created.push('docs/reference/messages.md');
+    }
+    if (writeIfChanged(path_1.default.join(refdir, 'system-map.md'), systemMapMd(model))) {
+        created.push('docs/reference/system-map.md');
+    }
+    // Per-service READMEs - only for services whose folder exists (a
+    // declared-but-unimplemented service has nowhere sensible to document).
+    for (const s of services(model)) {
+        const dir = path_1.default.join(srvfolder, s.name);
+        if (fs_1.default.existsSync(dir)) {
+            if (writeIfChanged(path_1.default.join(dir, 'README.md'), srvReadmeMd(model, s))) {
+                created.push('backend/src/srv/' + s.name + '/README.md');
+            }
+        }
+    }
+    return { created: created.sort() };
+};
+exports.doc_gen = doc_gen;
+//# sourceMappingURL=doc_gen.js.map

package/dist/doc/doc_gen.js.map

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

package/dist/env/web/web_gen.js

@@ -26,20 +26,52 @@ const generate_1 = require("../lambda/generate");
 // the project root, which holds backend/ and web/). $$slots$$ in the
 // output path are rendered too.
 const WEB_FILES = [
-    // Frontend SPA (web/)
+    // Frontend SPA (web/) — a model-driven enterprise app: public site + login,
+    // an app shell (nav / project selector / user menu / collapsible entity
+    // menu), and generic CRUD with relationship navigation. All runtime
+    // model-driven (model.js reads /model.json), so it fits any entity graph.
     { frag: 'web/package.json.frag', out: 'web/package.json' },
     { frag: 'web/index.html.frag', out: 'web/index.html' },
     { frag: 'web/playwright.config.js.frag', out: 'web/playwright.config.js' },
     { frag: 'web/src/main.js.frag', out: 'web/src/main.js' },
     { frag: 'web/src/bus.js.frag', out: 'web/src/bus.js' },
+    { frag: 'web/src/model.js.frag', out: 'web/src/model.js' },
+    { frag: 'web/src/api.js.frag', out: 'web/src/api.js' },
+    { frag: 'web/src/hooks.js.frag', out: 'web/src/hooks.js' },
+    { frag: 'web/src/theme.js.frag', out: 'web/src/theme.js' },
+    { frag: 'web/src/customise.js.frag', out: 'web/src/customise.js' },
+    { frag: 'web/src/custom.css.frag', out: 'web/src/custom.css' },
     { frag: 'web/src/style.css.frag', out: 'web/src/style.css' },
     { frag: 'web/src/cmp/app.js.frag', out: 'web/src/cmp/app.js' },
+    { frag: 'web/src/cmp/public.js.frag', out: 'web/src/cmp/public.js' },
     { frag: 'web/src/cmp/auth.js.frag', out: 'web/src/cmp/auth.js' },
+    { frag: 'web/src/cmp/shell.js.frag', out: 'web/src/cmp/shell.js' },
     { frag: 'web/src/cmp/admin.js.frag', out: 'web/src/cmp/admin.js' },
+    { frag: 'web/src/cmp/settings.js.frag', out: 'web/src/cmp/settings.js' },
+    // Per-component doc sidecars (mermaid structure + message diagrams),
+    // create-once next to each component.
+    { frag: 'web/src/cmp/app.md.frag', out: 'web/src/cmp/app.md' },
+    { frag: 'web/src/cmp/public.md.frag', out: 'web/src/cmp/public.md' },
+    { frag: 'web/src/cmp/auth.md.frag', out: 'web/src/cmp/auth.md' },
+    { frag: 'web/src/cmp/shell.md.frag', out: 'web/src/cmp/shell.md' },
+    { frag: 'web/src/cmp/admin.md.frag', out: 'web/src/cmp/admin.md' },
+    { frag: 'web/src/cmp/settings.md.frag', out: 'web/src/cmp/settings.md' },
     { frag: 'web/e2e/smoke.spec.js.frag', out: 'web/e2e/smoke.spec.js' },
+    { frag: 'web/AGENTS.md.frag', out: 'web/AGENTS.md' },
+    // Project docs (Diátaxis) for the web app, alongside the scaffold's
+    // backend docs (@voxgig/create-system DocsPart). Create-once like all
+    // WEB_FILES: the project owns its docs after generation.
+    { frag: 'docs/how-to/customise-the-web-app.md.frag', out: 'docs/how-to/customise-the-web-app.md' },
+    { frag: 'docs/how-to/use-the-api.md.frag', out: 'docs/how-to/use-the-api.md' },
+    { frag: 'docs/how-to/change-the-theme.md.frag', out: 'docs/how-to/change-the-theme.md' },
+    { frag: 'docs/how-to/add-a-custom-entity-view.md.frag', out: 'docs/how-to/add-a-custom-entity-view.md' },
+    { frag: 'docs/reference/web-app.md.frag', out: 'docs/reference/web-app.md' },
+    { frag: 'docs/explanation/web-architecture.md.frag', out: 'docs/explanation/web-architecture.md' },
     // Backend web runner + auth service (backend/src/...)
     { frag: 'backend/env/web/web.ts.frag', out: 'backend/src/env/web/web.ts' },
+    { frag: 'backend/env/shared/seed.ts.frag', out: 'backend/src/env/shared/seed.ts' },
     { frag: 'backend/srv/auth/auth-srv.ts.frag', out: 'backend/src/srv/auth/auth-srv.ts' },
+    { frag: 'backend/srv/auth/user_util.ts.frag', out: 'backend/src/srv/auth/user_util.ts' },
     { frag: 'backend/srv/auth/get_info.ts.frag', out: 'backend/src/srv/auth/get_info.ts' },
     { frag: 'backend/srv/auth/signin_user.ts.frag', out: 'backend/src/srv/auth/signin_user.ts' },
     { frag: 'backend/srv/auth/signout_user.ts.frag', out: 'backend/src/srv/auth/signout_user.ts' },
@@ -47,6 +79,56 @@ const WEB_FILES = [
     { frag: 'backend/srv/auth/web_signin_user.ts.frag', out: 'backend/src/srv/auth/web_signin_user.ts' },
     { frag: 'backend/srv/auth/web_signout_user.ts.frag', out: 'backend/src/srv/auth/web_signout_user.ts' },
     { frag: 'backend/srv/auth/web_load_auth.ts.frag', out: 'backend/src/srv/auth/web_load_auth.ts' },
+    // Auth settings/security extensions.
+    { frag: 'backend/srv/auth/change_pass.ts.frag', out: 'backend/src/srv/auth/change_pass.ts' },
+    { frag: 'backend/srv/auth/web_change_pass.ts.frag', out: 'backend/src/srv/auth/web_change_pass.ts' },
+    { frag: 'backend/srv/auth/update_user.ts.frag', out: 'backend/src/srv/auth/update_user.ts' },
+    { frag: 'backend/srv/auth/web_update_user.ts.frag', out: 'backend/src/srv/auth/web_update_user.ts' },
+    { frag: 'backend/srv/auth/remind_pass.ts.frag', out: 'backend/src/srv/auth/remind_pass.ts' },
+    { frag: 'backend/srv/auth/web_remind_pass.ts.frag', out: 'backend/src/srv/auth/web_remind_pass.ts' },
+    // API access keys (Settings & security + REST API auth).
+    { frag: 'backend/srv/auth/apikey_util.ts.frag', out: 'backend/src/srv/auth/apikey_util.ts' },
+    { frag: 'backend/srv/auth/create_apikey.ts.frag', out: 'backend/src/srv/auth/create_apikey.ts' },
+    { frag: 'backend/srv/auth/list_apikey.ts.frag', out: 'backend/src/srv/auth/list_apikey.ts' },
+    { frag: 'backend/srv/auth/revoke_apikey.ts.frag', out: 'backend/src/srv/auth/revoke_apikey.ts' },
+    { frag: 'backend/srv/auth/web_create_apikey.ts.frag', out: 'backend/src/srv/auth/web_create_apikey.ts' },
+    { frag: 'backend/srv/auth/web_list_apikey.ts.frag', out: 'backend/src/srv/auth/web_list_apikey.ts' },
+    { frag: 'backend/srv/auth/web_revoke_apikey.ts.frag', out: 'backend/src/srv/auth/web_revoke_apikey.ts' },
+    // The strict-JSON REST API (model main.api): api service + HTTP mapping.
+    // valid_gen.ts (request validation shapes) is REGENERATED by api_gen.
+    { frag: 'backend/srv/api/api-srv.ts.frag', out: 'backend/src/srv/api/api-srv.ts' },
+    { frag: 'backend/srv/api/get_info.ts.frag', out: 'backend/src/srv/api/get_info.ts' },
+    { frag: 'backend/srv/api/on_ent.ts.frag', out: 'backend/src/srv/api/on_ent.ts' },
+    { frag: 'backend/srv/api/expose.ts.frag', out: 'backend/src/srv/api/expose.ts' },
+    { frag: 'backend/env/web/api.ts.frag', out: 'backend/src/env/web/api.ts' },
+    // Unit tests for what EnvWeb generates (node:test). They are
+    // MODEL-DRIVEN - the entity under test and its payloads come from the
+    // model - so they hold for any entity graph, and they stand in for
+    // other services with mock messages rather than booting them.
+    { frag: 'backend/test/unit/srv/api/api.setup.ts.frag', out: 'backend/test/unit/srv/api/api.setup.ts' },
+    { frag: 'backend/test/unit/srv/api/api.test.ts.frag', out: 'backend/test/unit/srv/api/api.test.ts' },
+    { frag: 'backend/test/unit/srv/auth/auth.setup.ts.frag', out: 'backend/test/unit/srv/auth/auth.setup.ts' },
+    { frag: 'backend/test/unit/srv/auth/apikey.test.ts.frag', out: 'backend/test/unit/srv/auth/apikey.test.ts' },
+    { frag: 'backend/test/unit/srv/auth/session.test.ts.frag', out: 'backend/test/unit/srv/auth/session.test.ts' },
+    { frag: 'backend/test/unit/env/web/api-router.test.ts.frag', out: 'backend/test/unit/env/web/api-router.test.ts' },
+    { frag: 'backend/test/unit/env/web/surface.test.ts.frag', out: 'backend/test/unit/env/web/surface.test.ts' },
+    { frag: 'backend/test/unit/srv/ent/ent.setup.ts.frag', out: 'backend/test/unit/srv/ent/ent.setup.ts' },
+    { frag: 'backend/test/unit/srv/ent/proxy.test.ts.frag', out: 'backend/test/unit/srv/ent/proxy.test.ts' },
+    // Generic entity service (parameterised CRUD, membership-scoped).
+    { frag: 'backend/srv/ent/ent-srv.ts.frag', out: 'backend/src/srv/ent/ent-srv.ts' },
+    { frag: 'backend/srv/ent/access.ts.frag', out: 'backend/src/srv/ent/access.ts' },
+    { frag: 'backend/srv/ent/get_info.ts.frag', out: 'backend/src/srv/ent/get_info.ts' },
+    { frag: 'backend/srv/ent/cmd_list.ts.frag', out: 'backend/src/srv/ent/cmd_list.ts' },
+    { frag: 'backend/srv/ent/cmd_load.ts.frag', out: 'backend/src/srv/ent/cmd_load.ts' },
+    { frag: 'backend/srv/ent/cmd_save.ts.frag', out: 'backend/src/srv/ent/cmd_save.ts' },
+    { frag: 'backend/srv/ent/cmd_remove.ts.frag', out: 'backend/src/srv/ent/cmd_remove.ts' },
+    // Browser proxies: aim:web,on:ent,cmd:* -> aim:ent,cmd:* (the gateway
+    // accepts only aim:web, so the entity service is never posted directly
+    // from a browser).
+    { frag: 'backend/srv/ent/web_cmd_list.ts.frag', out: 'backend/src/srv/ent/web_cmd_list.ts' },
+    { frag: 'backend/srv/ent/web_cmd_load.ts.frag', out: 'backend/src/srv/ent/web_cmd_load.ts' },
+    { frag: 'backend/srv/ent/web_cmd_save.ts.frag', out: 'backend/src/srv/ent/web_cmd_save.ts' },
+    { frag: 'backend/srv/ent/web_cmd_remove.ts.frag', out: 'backend/src/srv/ent/web_cmd_remove.ts' },
 ];
 exports.WEB_FILES = WEB_FILES;
 // Default seeded users (local testing only), rendered into the runner.
@@ -87,6 +169,82 @@ const web_gen = async (model, spec) => {
         fs_1.default.writeFileSync(dest, content);
         created.push(outrel);
     }
+    // Custom entity views: for every entity declaring `ux:{ view: 'custom' }`,
+    // generate a hand-coded view component (CREATE-ONCE, so edits survive) plus
+    // an always-regenerated index (views.js) that imports them.
+    const entzones = model.main.ent || {};
+    const customs = [];
+    for (const zone of Object.keys(entzones)) {
+        for (const name of Object.keys(entzones[zone])) {
+            const def = entzones[zone][name];
+            if (def && def.ux && 'custom' === def.ux.view) {
+                customs.push({ zone, name, canon: zone + '/' + name });
+            }
+        }
+    }
+    for (const c of customs) {
+        const vslots = Object.assign({}, slots, {
+            canon: c.canon,
+            zone: c.zone,
+            name: c.name,
+            tag: 'vg-view-' + c.zone + '-' + c.name,
+            className: 'VgView' + (0, util_1.camelify)(c.zone) + (0, util_1.camelify)(c.name),
+            Label: (0, util_1.camelify)(c.name),
+        });
+        // The component starter plus its doc sidecar, both create-once.
+        for (const ext of ['js', 'md']) {
+            const outrel = 'web/src/cmp/view/' + c.zone + '_' + c.name + '.' + ext;
+            const dest = path_1.default.join(spec.root, outrel);
+            if (fs_1.default.existsSync(dest) && !spec.force) {
+                skipped.push(outrel);
+                continue;
+            }
+            const content = (0, generate_1.renderFragment)((0, generate_1.loadFragment)('web/src/cmp/view/custom-view.' + ext + '.frag', spec, 'web'), vslots);
+            fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
+            fs_1.default.writeFileSync(dest, content);
+            created.push(outrel);
+        }
+    }
+    // views.js — the generated index of custom views. Regenerated whenever the
+    // set of custom views changes; a no-op run leaves it (and `created`) alone.
+    const viewsRel = 'web/src/views.js';
+    const viewsPath = path_1.default.join(spec.root, viewsRel);
+    const viewsBody = '// AUTO-GENERATED: imports every custom entity view (model entities declaring\n' +
+        '// ux:{view:\'custom\'}). Regenerated from the model — do not edit. The view\n' +
+        '// files it imports are hand-coded and create-once.\n\n' +
+        customs.map((c) => `import './cmp/view/${c.zone}_${c.name}.js'`).join('\n') + '\n';
+    const existingViews = fs_1.default.existsSync(viewsPath) ? fs_1.default.readFileSync(viewsPath, 'utf8') : null;
+    if (existingViews !== viewsBody) {
+        fs_1.default.mkdirSync(path_1.default.join(spec.root, 'web/src'), { recursive: true });
+        fs_1.default.writeFileSync(viewsPath, viewsBody);
+        created.push(viewsRel);
+    }
+    // theme.css — the design theme from the model (main.theme). Each mode's
+    // tokens become CSS variables under :root[data-theme-mode="<mode>"], with the
+    // default mode also on plain :root. Regenerated from the model; override
+    // tokens in custom.css and add modes via the theme:modes hook.
+    const theme = model.main && model.main.theme;
+    if (theme && theme.modes && Object.keys(theme.modes).length) {
+        const defMode = theme.mode || Object.keys(theme.modes)[0];
+        const tokensCss = (tokens) => Object.keys(tokens).sort()
+            .map((k) => `  --vg-${k}: ${tokens[k]};`).join('\n');
+        const blocks = [':root,\n:root[data-theme-mode="' + defMode + '"] {\n' + tokensCss(theme.modes[defMode]) + '\n}'];
+        for (const mode of Object.keys(theme.modes)) {
+            if (mode !== defMode) {
+                blocks.push(':root[data-theme-mode="' + mode + '"] {\n' + tokensCss(theme.modes[mode]) + '\n}');
+            }
+        }
+        const themeBody = '/* AUTO-GENERATED from the model theme (main.theme) — do not edit.\n' +
+            '   Override tokens in custom.css; add modes via the theme:modes hook. */\n\n' +
+            blocks.join('\n\n') + '\n';
+        const themePath = path_1.default.join(spec.root, 'web/src/theme.css');
+        const existingTheme = fs_1.default.existsSync(themePath) ? fs_1.default.readFileSync(themePath, 'utf8') : null;
+        if (existingTheme !== themeBody) {
+            fs_1.default.mkdirSync(path_1.default.join(spec.root, 'web/src'), { recursive: true });
+            fs_1.default.writeFileSync(themePath, themeBody);
+            created.push('web/src/theme.css');
+        }
+    }
     return { created: created.sort(), skipped: skipped.sort() };
 };
 exports.web_gen = web_gen;