@voxgig/build 4.1.0 → 4.2.0

package/build.ts

@@ -17,6 +17,8 @@ import { srv_yml } from './env/lambda/srv_yml'
 import { srv_handler } from './env/lambda/srv_handler'
 import { resources_yml } from './env/lambda/res_yml'
 
+import { env_gen, ENV_FILES, ENV_SRC, KINDS as ENV_KINDS } from './env/env_gen'
+
 import {
   generate, empty, TM,
   loadFragment, renderFragment, listFragments, PKG_TM,
@@ -34,6 +36,16 @@ const EnvLambda = {
 }
 
 
+// Per-environment deployment artifacts (gen/env/<name>/), driven by the
+// model's `main: env:` declarations. See env/env_gen.ts.
+const EnvGen = {
+  env_gen,
+  files: ENV_FILES,
+  srcfiles: ENV_SRC,
+  kinds: ENV_KINDS,
+}
+
+
 // Fragment tooling (used by voxgig-system template list/eject/diff, and
 // available to project code).
 const Fragments = {
@@ -46,6 +58,7 @@ const Fragments = {
 
 export {
   EnvLambda,
+  EnvGen,
   Fragments,
 
   // Building blocks for ejected project templates (src/gen/<name>.ts

package/dist/build.d.ts

@@ -23,10 +23,27 @@ declare const EnvLambda: {
         tm?: string;
     }) => Promise<void>;
 };
+declare const EnvGen: {
+    env_gen: (model: any, spec: {
+        folder: string;
+        tm?: string;
+        src?: string;
+    }) => Promise<void>;
+    files: Record<string, {
+        frag: string;
+        out: string;
+    }[]>;
+    srcfiles: Record<string, {
+        frag: string;
+        dir: string;
+        out: string;
+    }[]>;
+    kinds: string[];
+};
 declare const Fragments: {
     load: typeof loadFragment;
     render: typeof renderFragment;
     list: typeof listFragments;
     folder: string;
 };
-export { EnvLambda, Fragments, generate, empty, TM, loadFragment, renderFragment, MsgMetaShape, CoreConfShape, CloudConfShape, res_dynamo_yml, };
+export { EnvLambda, EnvGen, Fragments, generate, empty, TM, loadFragment, renderFragment, MsgMetaShape, CoreConfShape, CloudConfShape, res_dynamo_yml, };

package/dist/build.js

@@ -1,7 +1,7 @@
 "use strict";
 /* Copyright © 2022-2026 Voxgig Ltd, MIT License. */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.res_dynamo_yml = exports.CloudConfShape = exports.CoreConfShape = exports.MsgMetaShape = exports.renderFragment = exports.loadFragment = exports.TM = exports.empty = exports.generate = exports.Fragments = exports.EnvLambda = void 0;
+exports.res_dynamo_yml = exports.CloudConfShape = exports.CoreConfShape = exports.MsgMetaShape = exports.renderFragment = exports.loadFragment = exports.TM = exports.empty = exports.generate = exports.Fragments = exports.EnvGen = exports.EnvLambda = void 0;
 // EnvLambda: generation of the Lambda deployment templates, built on the
 // jostraca templating library. The templates live in env/lambda/, one file
 // per output for convenience:
@@ -17,6 +17,7 @@ exports.res_dynamo_yml = exports.CloudConfShape = exports.CoreConfShape = export
 const srv_yml_1 = require("./env/lambda/srv_yml");
 const srv_handler_1 = require("./env/lambda/srv_handler");
 const res_yml_1 = require("./env/lambda/res_yml");
+const env_gen_1 = require("./env/env_gen");
 const generate_1 = require("./env/lambda/generate");
 Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generate_1.generate; } });
 Object.defineProperty(exports, "empty", { enumerable: true, get: function () { return generate_1.empty; } });
@@ -36,6 +37,15 @@ const EnvLambda = {
     resources_yml: res_yml_1.resources_yml,
 };
 exports.EnvLambda = EnvLambda;
+// Per-environment deployment artifacts (gen/env/<name>/), driven by the
+// model's `main: env:` declarations. See env/env_gen.ts.
+const EnvGen = {
+    env_gen: env_gen_1.env_gen,
+    files: env_gen_1.ENV_FILES,
+    srcfiles: env_gen_1.ENV_SRC,
+    kinds: env_gen_1.KINDS,
+};
+exports.EnvGen = EnvGen;
 // Fragment tooling (used by voxgig-system template list/eject/diff, and
 // available to project code).
 const Fragments = {

package/dist/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../build.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,yEAAyE;AACzE,2EAA2E;AAC3E,8BAA8B;AAC9B,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,qCAAqC;AAErC,kDAA8C;AAC9C,0DAAsD;AACtD,kDAAoD;AAEpD,oDAG8B;AA+B5B,yFAjCA,mBAAQ,OAiCA;AACR,sFAlCU,gBAAK,OAkCV;AACL,mFAnCiB,aAAE,OAmCjB;AACF,6FAnCA,uBAAY,OAmCA;AACZ,+FApCc,yBAAc,OAoCd;AAjChB,qCAA0C;AAkCxC,6FAlCO,kBAAY,OAkCP;AAjCd,uCAA4D;AAkC1D,8FAlCO,oBAAa,OAkCP;AACb,+FAnCsB,qBAAc,OAmCtB;AAlChB,yDAAqD;AAmCnD,+FAnCO,+BAAc,OAmCP;AAhChB,MAAM,SAAS,GAAG;IAChB,OAAO,EAAP,iBAAO;IACP,WAAW,EAAX,yBAAW;IACX,aAAa,EAAb,uBAAa;CACd,CAAA;AAcC,8BAAS;AAXX,wEAAwE;AACxE,8BAA8B;AAC9B,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,uBAAY;IAClB,MAAM,EAAE,yBAAc;IACtB,IAAI,EAAE,wBAAa;IACnB,MAAM,EAAE,iBAAM;CACf,CAAA;AAKC,8BAAS"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../build.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,yEAAyE;AACzE,2EAA2E;AAC3E,8BAA8B;AAC9B,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,qCAAqC;AAErC,kDAA8C;AAC9C,0DAAsD;AACtD,kDAAoD;AAEpD,2CAA+E;AAE/E,oDAG8B;AA0C5B,yFA5CA,mBAAQ,OA4CA;AACR,sFA7CU,gBAAK,OA6CV;AACL,mFA9CiB,aAAE,OA8CjB;AACF,6FA9CA,uBAAY,OA8CA;AACZ,+FA/Cc,yBAAc,OA+Cd;AA5ChB,qCAA0C;AA6CxC,6FA7CO,kBAAY,OA6CP;AA5Cd,uCAA4D;AA6C1D,8FA7CO,oBAAa,OA6CP;AACb,+FA9CsB,qBAAc,OA8CtB;AA7ChB,yDAAqD;AA8CnD,+FA9CO,+BAAc,OA8CP;AA3ChB,MAAM,SAAS,GAAG;IAChB,OAAO,EAAP,iBAAO;IACP,WAAW,EAAX,yBAAW;IACX,aAAa,EAAb,uBAAa;CACd,CAAA;AAwBC,8BAAS;AArBX,wEAAwE;AACxE,yDAAyD;AACzD,MAAM,MAAM,GAAG;IACb,OAAO,EAAP,iBAAO;IACP,KAAK,EAAE,mBAAS;IAChB,QAAQ,EAAE,iBAAO;IACjB,KAAK,EAAE,eAAS;CACjB,CAAA;AAeC,wBAAM;AAZR,wEAAwE;AACxE,8BAA8B;AAC9B,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,uBAAY;IAClB,MAAM,EAAE,yBAAc;IACtB,IAAI,EAAE,wBAAa;IACnB,MAAM,EAAE,iBAAM;CACf,CAAA;AAMC,8BAAS"}

package/dist/env/env_gen.d.ts

@@ -0,0 +1,16 @@
+declare const ENV_FILES: Record<string, {
+    frag: string;
+    out: string;
+}[]>;
+declare const ENV_SRC: Record<string, {
+    frag: string;
+    dir: string;
+    out: string;
+}[]>;
+declare const KINDS: string[];
+declare const env_gen: (model: any, spec: {
+    folder: string;
+    tm?: string;
+    src?: string;
+}) => Promise<void>;
+export { env_gen, ENV_FILES, ENV_SRC, KINDS, };

package/dist/env/env_gen.js

@@ -0,0 +1,143 @@
+"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.KINDS = exports.ENV_SRC = exports.ENV_FILES = exports.env_gen = void 0;
+// EnvGen: per-environment deployment artifact generation. The project
+// model declares its target environments under `main: env:`:
+//
+//   main: env: local: { active: true }
+//   main: env: aws: { active: true, region: 'eu-west-1', stage: 'dev' }
+//
+// For each active environment this generates gen/env/<name>/ from the
+// fragment set tm/env/<kind>/ (kind defaults to the env name, so a
+// project can declare e.g. `aws2: { kind: 'aws', region: ... }`).
+// Fragments are project-shadowable via spec.tm (the project's tm/env
+// folder), like the lambda templates.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const util_1 = require("@voxgig/util");
+const conf_1 = require("../shape/conf");
+const generate_1 = require("./lambda/generate");
+// The supported environment kinds and the files each generates.
+// `out` may contain $$slots$$ (rendered with the same slot values).
+const ENV_FILES = {
+    local: [
+        { frag: 'local/run.sh.frag', out: 'run.sh' },
+        { frag: 'local/README.md.frag', out: 'README.md' },
+    ],
+    basic: [
+        { frag: 'basic/backend.service.frag', out: '$$name$$-backend.service' },
+        { frag: 'basic/deploy.sh.frag', out: 'deploy.sh' },
+        { frag: 'basic/README.md.frag', out: 'README.md' },
+    ],
+    docker: [
+        { frag: 'docker/Dockerfile.frag', out: 'Dockerfile' },
+        { frag: 'docker/compose.yml.frag', out: 'compose.yml' },
+        { frag: 'docker/README.md.frag', out: 'README.md' },
+    ],
+    vm: [
+        { frag: 'vm/cloud-init.yaml.frag', out: 'cloud-init.yaml' },
+        { frag: 'vm/README.md.frag', out: 'README.md' },
+    ],
+    aws: [
+        { frag: 'aws/serverless.yml.frag', out: 'serverless.yml' },
+        { frag: 'aws/README.md.frag', out: 'README.md' },
+    ],
+    azure: [
+        { frag: 'azure/host.json.frag', out: 'host.json' },
+        { frag: 'azure/README.md.frag', out: 'README.md' },
+    ],
+    cloudflare: [
+        { frag: 'cloudflare/wrangler.toml.frag', out: 'wrangler.toml' },
+        { frag: 'cloudflare/README.md.frag', out: 'README.md' },
+    ],
+};
+exports.ENV_FILES = ENV_FILES;
+// The runtime entry point + Seneca config setup each environment needs
+// under src/env/. These are generated ONCE (only when missing): after
+// creation the project owns them, like the scaffold's local entry. All
+// entries route Seneca configuration through src/env/shared/basic.ts.
+// `dir` is relative to the project src/env folder.
+const ENV_SRC = {
+    local: [], // scaffold provides src/env/local/local.ts
+    basic: [
+        { frag: 'server.entry.ts.frag', dir: 'basic', out: 'basic.ts' },
+    ],
+    docker: [
+        { frag: 'server.entry.ts.frag', dir: 'docker', out: 'docker.ts' },
+    ],
+    vm: [
+        { frag: 'server.entry.ts.frag', dir: 'vm', out: 'vm.ts' },
+    ],
+    aws: [
+        // The Lambda bootstrap the generated handlers import.
+        { frag: 'aws/lambda.entry.ts.frag', dir: 'lambda', out: 'lambda.ts' },
+    ],
+    azure: [
+        { frag: 'azure/entry.ts.frag', dir: 'azure', out: 'azure.ts' },
+    ],
+    cloudflare: [
+        { frag: 'cloudflare/worker.ts.frag', dir: 'cloudflare', out: 'worker.ts' },
+    ],
+};
+exports.ENV_SRC = ENV_SRC;
+const KINDS = Object.keys(ENV_FILES);
+exports.KINDS = KINDS;
+const env_gen = async (model, spec) => {
+    var _a;
+    const core = (0, conf_1.CoreConfShape)(model.main.conf.core);
+    const envs = model.main.env || {};
+    for (const entry of Object.entries(envs)) {
+        const name = entry[0];
+        const def = entry[1] || {};
+        if (false === def.active) {
+            continue;
+        }
+        const kind = def.kind || name;
+        const filedefs = ENV_FILES[kind];
+        if (null == filedefs) {
+            throw new Error('@voxgig/build: unknown environment kind: ' + kind +
+                ' (env ' + name + '; known kinds: ' + KINDS.join(', ') + ')');
+        }
+        // Slot values: project identity, ports, and per-env config with
+        // sensible defaults. Additional scalar config keys on the env
+        // definition become slots too.
+        const slots = {
+            name: core.name,
+            Name: (0, util_1.camelify)(core.name),
+            env: name,
+            port: ((_a = model.main.conf.port) === null || _a === void 0 ? void 0 : _a.backend) || 8080,
+            node: def.node || '22',
+            region: def.region || 'us-east-1',
+            stage: def.stage || 'dev',
+        };
+        for (const key of Object.keys(def)) {
+            if ('object' !== typeof def[key] && null == slots[key]) {
+                slots[key] = def[key];
+            }
+        }
+        // Slot for the env name inside entry fragments.
+        slots.env = name;
+        const files = filedefs.map((fd) => ({
+            name: (0, generate_1.renderFragment)(fd.out, slots),
+            content: (0, generate_1.renderFragment)((0, generate_1.loadFragment)(fd.frag, spec, 'env'), slots),
+        }));
+        await (0, generate_1.generate)(spec.folder + '/' + name, files);
+        // Runtime entries: create-once into src/env (user-owned afterwards).
+        if (null != spec.src) {
+            for (const sd of (ENV_SRC[kind] || [])) {
+                const dest = path_1.default.join(spec.src, sd.dir, (0, generate_1.renderFragment)(sd.out, slots));
+                if (!fs_1.default.existsSync(dest)) {
+                    const content = (0, generate_1.renderFragment)((0, generate_1.loadFragment)(sd.frag, spec, 'env'), slots);
+                    fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
+                    fs_1.default.writeFileSync(dest, content);
+                }
+            }
+        }
+    }
+};
+exports.env_gen = env_gen;
+//# sourceMappingURL=env_gen.js.map

package/dist/env/env_gen.js.map

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

package/dist/env/lambda/generate.d.ts

@@ -1,7 +1,8 @@
+declare const PKG_TM_ROOT: string;
 declare const PKG_TM: string;
 declare function loadFragment(name: string, spec?: {
     tm?: string;
-}): string;
+}, area?: string): string;
 declare function renderFragment(src: string, slots: Record<string, any>): string;
 declare function listFragments(): string[];
 declare function generate(folder: string, files: {
@@ -10,4 +11,4 @@ declare function generate(folder: string, files: {
 }[]): Promise<void>;
 declare function empty(o: any): boolean;
 declare function TM(str: string): string;
-export { generate, empty, TM, loadFragment, renderFragment, listFragments, PKG_TM, };
+export { generate, empty, TM, loadFragment, renderFragment, listFragments, PKG_TM, PKG_TM_ROOT, };

package/dist/env/lambda/generate.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PKG_TM = void 0;
+exports.PKG_TM_ROOT = exports.PKG_TM = void 0;
 exports.generate = generate;
 exports.empty = empty;
 exports.TM = TM;
@@ -23,21 +23,25 @@ const jostraca_1 = require("jostraca");
 // placing a same-named file in its own tm folder (passed as spec.tm by
 // the project's build actions). The fragment file's final newline is
 // dropped at load, so slot values fully control trailing bytes.
-// Package tm folder: compiled code lives at <pkg>/dist/env/lambda (three
+// Package tm root: compiled code lives at <pkg>/dist/env/lambda (three
 // levels down), but test transforms run the source at <pkg>/env/lambda
-// (two levels down) - probe both.
-const PKG_TM = [
-    path_1.default.join(__dirname, '..', '..', '..', 'tm', 'lambda'),
-    path_1.default.join(__dirname, '..', '..', 'tm', 'lambda'),
+// (two levels down) - probe both. Areas (tm/<area>/...) group fragment
+// sets: 'lambda' (the EnvLambda templates) and 'env' (per-environment
+// deployment templates).
+const PKG_TM_ROOT = [
+    path_1.default.join(__dirname, '..', '..', '..', 'tm'),
+    path_1.default.join(__dirname, '..', '..', 'tm'),
 ].find((p) => fs_1.default.existsSync(p)) ||
-    path_1.default.join(__dirname, '..', '..', '..', 'tm', 'lambda');
+    path_1.default.join(__dirname, '..', '..', '..', 'tm');
+exports.PKG_TM_ROOT = PKG_TM_ROOT;
+const PKG_TM = path_1.default.join(PKG_TM_ROOT, 'lambda');
 exports.PKG_TM = PKG_TM;
-function loadFragment(name, spec) {
+function loadFragment(name, spec, area = 'lambda') {
     const candidates = [];
     if (spec === null || spec === void 0 ? void 0 : spec.tm) {
         candidates.push(path_1.default.join(spec.tm, name));
     }
-    candidates.push(path_1.default.join(PKG_TM, name));
+    candidates.push(path_1.default.join(PKG_TM_ROOT, area, name));
     for (const c of candidates) {
         if (fs_1.default.existsSync(c)) {
             let src = fs_1.default.readFileSync(c, 'utf8');

package/dist/env/lambda/generate.js.map

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

package/env/env_gen.ts

@@ -0,0 +1,165 @@
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+
+// EnvGen: per-environment deployment artifact generation. The project
+// model declares its target environments under `main: env:`:
+//
+//   main: env: local: { active: true }
+//   main: env: aws: { active: true, region: 'eu-west-1', stage: 'dev' }
+//
+// For each active environment this generates gen/env/<name>/ from the
+// fragment set tm/env/<kind>/ (kind defaults to the env name, so a
+// project can declare e.g. `aws2: { kind: 'aws', region: ... }`).
+// Fragments are project-shadowable via spec.tm (the project's tm/env
+// folder), like the lambda templates.
+
+import Fs from 'fs'
+import Path from 'path'
+
+import { camelify } from '@voxgig/util'
+
+import { CoreConfShape } from '../shape/conf'
+
+import { generate, loadFragment, renderFragment } from './lambda/generate'
+
+
+// The supported environment kinds and the files each generates.
+// `out` may contain $$slots$$ (rendered with the same slot values).
+const ENV_FILES: Record<string, { frag: string, out: string }[]> = {
+  local: [
+    { frag: 'local/run.sh.frag', out: 'run.sh' },
+    { frag: 'local/README.md.frag', out: 'README.md' },
+  ],
+  basic: [
+    { frag: 'basic/backend.service.frag', out: '$$name$$-backend.service' },
+    { frag: 'basic/deploy.sh.frag', out: 'deploy.sh' },
+    { frag: 'basic/README.md.frag', out: 'README.md' },
+  ],
+  docker: [
+    { frag: 'docker/Dockerfile.frag', out: 'Dockerfile' },
+    { frag: 'docker/compose.yml.frag', out: 'compose.yml' },
+    { frag: 'docker/README.md.frag', out: 'README.md' },
+  ],
+  vm: [
+    { frag: 'vm/cloud-init.yaml.frag', out: 'cloud-init.yaml' },
+    { frag: 'vm/README.md.frag', out: 'README.md' },
+  ],
+  aws: [
+    { frag: 'aws/serverless.yml.frag', out: 'serverless.yml' },
+    { frag: 'aws/README.md.frag', out: 'README.md' },
+  ],
+  azure: [
+    { frag: 'azure/host.json.frag', out: 'host.json' },
+    { frag: 'azure/README.md.frag', out: 'README.md' },
+  ],
+  cloudflare: [
+    { frag: 'cloudflare/wrangler.toml.frag', out: 'wrangler.toml' },
+    { frag: 'cloudflare/README.md.frag', out: 'README.md' },
+  ],
+}
+
+// The runtime entry point + Seneca config setup each environment needs
+// under src/env/. These are generated ONCE (only when missing): after
+// creation the project owns them, like the scaffold's local entry. All
+// entries route Seneca configuration through src/env/shared/basic.ts.
+// `dir` is relative to the project src/env folder.
+const ENV_SRC: Record<string, { frag: string, dir: string, out: string }[]> = {
+  local: [], // scaffold provides src/env/local/local.ts
+  basic: [
+    { frag: 'server.entry.ts.frag', dir: 'basic', out: 'basic.ts' },
+  ],
+  docker: [
+    { frag: 'server.entry.ts.frag', dir: 'docker', out: 'docker.ts' },
+  ],
+  vm: [
+    { frag: 'server.entry.ts.frag', dir: 'vm', out: 'vm.ts' },
+  ],
+  aws: [
+    // The Lambda bootstrap the generated handlers import.
+    { frag: 'aws/lambda.entry.ts.frag', dir: 'lambda', out: 'lambda.ts' },
+  ],
+  azure: [
+    { frag: 'azure/entry.ts.frag', dir: 'azure', out: 'azure.ts' },
+  ],
+  cloudflare: [
+    { frag: 'cloudflare/worker.ts.frag', dir: 'cloudflare', out: 'worker.ts' },
+  ],
+}
+
+const KINDS = Object.keys(ENV_FILES)
+
+
+const env_gen = async (model: any, spec: {
+  folder: string     // gen/env output root; each env writes <folder>/<name>/
+  tm?: string        // project tm/env folder (fragment shadowing)
+  src?: string       // project src/env folder: runtime entries generated
+                     // here ONCE (existing files are never overwritten)
+}) => {
+
+  const core = CoreConfShape(model.main.conf.core)
+  const envs = model.main.env || {}
+
+  for (const entry of Object.entries(envs)) {
+    const name = entry[0]
+    const def: any = entry[1] || {}
+
+    if (false === def.active) {
+      continue
+    }
+
+    const kind = def.kind || name
+    const filedefs = ENV_FILES[kind]
+    if (null == filedefs) {
+      throw new Error('@voxgig/build: unknown environment kind: ' + kind +
+        ' (env ' + name + '; known kinds: ' + KINDS.join(', ') + ')')
+    }
+
+    // Slot values: project identity, ports, and per-env config with
+    // sensible defaults. Additional scalar config keys on the env
+    // definition become slots too.
+    const slots: Record<string, any> = {
+      name: core.name,
+      Name: camelify(core.name),
+      env: name,
+      port: model.main.conf.port?.backend || 8080,
+      node: def.node || '22',
+      region: def.region || 'us-east-1',
+      stage: def.stage || 'dev',
+    }
+    for (const key of Object.keys(def)) {
+      if ('object' !== typeof def[key] && null == slots[key]) {
+        slots[key] = def[key]
+      }
+    }
+
+    // Slot for the env name inside entry fragments.
+    slots.env = name
+
+    const files = filedefs.map((fd) => ({
+      name: renderFragment(fd.out, slots),
+      content: renderFragment(loadFragment(fd.frag, spec, 'env'), slots),
+    }))
+
+    await generate(spec.folder + '/' + name, files)
+
+    // Runtime entries: create-once into src/env (user-owned afterwards).
+    if (null != spec.src) {
+      for (const sd of (ENV_SRC[kind] || [])) {
+        const dest = Path.join(spec.src, sd.dir, renderFragment(sd.out, slots))
+        if (!Fs.existsSync(dest)) {
+          const content =
+            renderFragment(loadFragment(sd.frag, spec, 'env'), slots)
+          Fs.mkdirSync(Path.dirname(dest), { recursive: true })
+          Fs.writeFileSync(dest, content)
+        }
+      }
+    }
+  }
+}
+
+
+export {
+  env_gen,
+  ENV_FILES,
+  ENV_SRC,
+  KINDS,
+}

package/env/lambda/generate.ts

@@ -17,22 +17,28 @@ import { Jostraca, Project, File, Content } from 'jostraca'
 // the project's build actions). The fragment file's final newline is
 // dropped at load, so slot values fully control trailing bytes.
 
-// Package tm folder: compiled code lives at <pkg>/dist/env/lambda (three
+// Package tm root: compiled code lives at <pkg>/dist/env/lambda (three
 // levels down), but test transforms run the source at <pkg>/env/lambda
-// (two levels down) - probe both.
-const PKG_TM = [
-  Path.join(__dirname, '..', '..', '..', 'tm', 'lambda'),
-  Path.join(__dirname, '..', '..', 'tm', 'lambda'),
+// (two levels down) - probe both. Areas (tm/<area>/...) group fragment
+// sets: 'lambda' (the EnvLambda templates) and 'env' (per-environment
+// deployment templates).
+const PKG_TM_ROOT = [
+  Path.join(__dirname, '..', '..', '..', 'tm'),
+  Path.join(__dirname, '..', '..', 'tm'),
 ].find((p) => Fs.existsSync(p)) ||
-  Path.join(__dirname, '..', '..', '..', 'tm', 'lambda')
+  Path.join(__dirname, '..', '..', '..', 'tm')
 
+const PKG_TM = Path.join(PKG_TM_ROOT, 'lambda')
 
-function loadFragment(name: string, spec?: { tm?: string }): string {
+
+function loadFragment(
+  name: string, spec?: { tm?: string }, area: string = 'lambda'
+): string {
   const candidates = []
   if (spec?.tm) {
     candidates.push(Path.join(spec.tm, name))
   }
-  candidates.push(Path.join(PKG_TM, name))
+  candidates.push(Path.join(PKG_TM_ROOT, area, name))
 
   for (const c of candidates) {
     if (Fs.existsSync(c)) {
@@ -102,4 +108,5 @@ export {
   renderFragment,
   listFragments,
   PKG_TM,
+  PKG_TM_ROOT,
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/build",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "main": "dist/build.js",
   "type": "commonjs",
   "types": "dist/build.d.ts",

package/tm/env/aws/README.md.frag

@@ -0,0 +1,9 @@
+# $$Name$$ - aws environment (Serverless Framework)
+
+    cd backend && npm run build
+    cd gen/env/aws && npx serverless deploy --stage $$stage$$
+
+serverless.yml composes the generated srv.yml (functions) and res.yml
+(resources); both are regenerated by model-build. Provider settings
+(region/stage/runtime) come from the model env entry - change them with
+the model, or eject env/aws/serverless.yml.frag for structural edits.

package/tm/env/aws/lambda.entry.ts.frag

@@ -0,0 +1,89 @@
+
+// $$Name$$ backend - AWS Lambda environment bootstrap (generated once;
+// this file is yours to edit). The generated handlers
+// (src/handler/lambda/<srv>.ts) call getSeneca() for a ready Seneca
+// instance wired for the Lambda + API Gateway path, configured by the
+// shared setup (src/env/shared/basic.ts).
+
+import Seneca from 'seneca'
+import { Live } from '@voxgig/system'
+
+import { basic, base } from '../shared/basic'
+
+import Pkg from '../../../package.json'
+import Model from '../../../model/model.json'
+
+
+const STAGE = process.env.STAGE || 'local'
+
+const Main = Model.main as any
+
+let seneca: any = null
+
+
+async function getSeneca(srvname: string, complete: Function): Promise<any> {
+  const { deep } = Seneca.util
+
+  if (null == seneca) {
+    const srv = Main.srv[srvname]
+
+    seneca = Seneca(deep(base.seneca, {
+      tag: srvname + '-$$name$$-' + STAGE + '@' + Pkg.version,
+      timeout: srv.env.lambda.timeout * 60 * 1000,
+    })).test()
+
+    seneca.context.model = Model
+    seneca.context.srvname = srvname
+    seneca.context.stage = STAGE
+    seneca.context.env = 'lambda'
+    seneca.context.pkg = Pkg
+
+    basic(seneca, { reload: { active: false } })
+
+    seneca
+      .use('gateway')
+      .use('gateway-lambda', {
+        auth: {
+          token: {
+            name: '$$name$$-auth',
+          },
+        },
+      })
+      .use('gateway-auth', {
+        spec: {
+          lambda_cookie: {
+            active: true,
+            token: {
+              name: '$$name$$-auth',
+            },
+            user: {
+              auth: true,
+              require: srv.user?.required ?? true,
+            },
+          },
+        },
+      })
+
+    seneca.use(Live, {
+      srv: {
+        name: srvname,
+        folder: __dirname + '/../../srv',
+      },
+    })
+
+    // Call ready() exactly once - a second ready() on an already-ready
+    // instance never resolves under seneca 4.0.0-rc4.
+    await seneca.ready()
+
+    if (complete) {
+      await complete(seneca)
+    }
+  }
+
+  return seneca
+}
+
+
+export {
+  getSeneca,
+}

package/tm/env/aws/serverless.yml.frag

@@ -0,0 +1,23 @@
+# $$Name$$ backend - Serverless Framework config (generated; customize via
+# tm/env/aws/). Composes the model-generated pieces: per-service function
+# definitions (srv.yml) and resources (res.yml) live beside this file and
+# are regenerated by model-build - edit the model, not those files.
+service: $$name$$-backend
+
+frameworkVersion: '4'
+
+provider:
+  name: aws
+  runtime: nodejs$$node$$.x
+  region: $$region$$
+  stage: ${opt:stage, '$$stage$$'}
+
+custom:
+  # res.yml derives the IAM role name suffix from this index.
+  index:
+    BasicLambdaRole: '01'
+
+functions: ${file(./srv.yml)}
+
+resources:
+  Resources: ${file(./res.yml)}

package/tm/env/azure/README.md.frag

@@ -0,0 +1,7 @@
+# $$Name$$ - azure environment (starting point)
+
+Azure Functions host config for the $$Name$$ backend. This is a starting
+point: Azure needs one function.json binding per exposed function - derive
+them from the service definitions the model generates for aws
+(gen/env/aws/srv.yml lists every handler and route). Eject
+env/azure/host.json.frag to customize.

package/tm/env/azure/entry.ts.frag

@@ -0,0 +1,49 @@
+
+// $$Name$$ backend - azure environment entry (generated once; this file is
+// yours to edit). STARTING POINT: an Azure Functions HTTP handler shape -
+// wire the Seneca gateway the way src/env/lambda/lambda.ts does for AWS.
+
+import Seneca from 'seneca'
+
+import { basic, base } from '../shared/basic'
+
+import Pkg from '../../../package.json'
+import Model from '../../../model/model.json'
+
+
+let seneca: any = null
+
+async function getSeneca(): Promise<any> {
+  if (null == seneca) {
+    seneca = Seneca(Seneca.util.deep(base.seneca, {
+      tag: '$$name$$-azure@' + Pkg.version,
+    })).test()
+
+    seneca.context.model = Model
+    seneca.context.env = 'azure'
+    seneca.context.pkg = Pkg
+
+    basic(seneca, { reload: { active: false } })
+
+    await seneca.ready()
+  }
+  return seneca
+}
+
+
+// Azure Functions v4 programming model handler (add @azure/functions and
+// register per-route handlers derived from the model - see
+// gen/env/aws/srv.yml for the full route list).
+async function handler(request: any, _context: any) {
+  await getSeneca()
+  return {
+    status: 501,
+    jsonBody: { ok: false, why: '$$name$$-backend azure entry not yet wired' },
+  }
+}
+
+
+export {
+  getSeneca,
+  handler,
+}

package/tm/env/azure/host.json.frag

@@ -0,0 +1,8 @@
+{
+  "version": "2.0",
+  "logging": {
+    "applicationInsights": {
+      "samplingSettings": { "isEnabled": true }
+    }
+  }
+}

package/tm/env/basic/README.md.frag

@@ -0,0 +1,7 @@
+# $$Name$$ - basic environment (remote server)
+
+Runs the backend like local, on a plain server under systemd.
+
+    BASIC_HOST=user@host sh gen/env/basic/deploy.sh
+
+Installs to /opt/$$name$$/backend with unit $$name$$-backend.service.

package/tm/env/basic/backend.service.frag

@@ -0,0 +1,14 @@
+# systemd unit for the $$Name$$ backend (generated; customize via tm/env/basic/)
+[Unit]
+Description=$$Name$$ backend
+After=network.target
+
+[Service]
+WorkingDirectory=/opt/$$name$$/backend
+ExecStart=/usr/bin/node dist/env/local/local.js
+Restart=always
+Environment=NODE_ENV=production
+Environment=PORT=$$port$$
+
+[Install]
+WantedBy=multi-user.target

package/tm/env/basic/deploy.sh.frag

@@ -0,0 +1,13 @@
+#!/bin/sh
+# Deploy the $$Name$$ backend to a plain remote server (generated).
+# Usage: BASIC_HOST=user@host sh deploy.sh
+set -e
+: "${BASIC_HOST:?set BASIC_HOST=user@host}"
+cd "$(dirname "$0")/../../.."
+npm run build
+rsync -az --delete \
+  --exclude node_modules --exclude gen --exclude dist-test \
+  ./ "$BASIC_HOST:/opt/$$name$$/backend/"
+ssh "$BASIC_HOST" "cd /opt/$$name$$/backend && npm install --omit=dev \
+  && sudo cp gen/env/basic/$$name$$-backend.service /etc/systemd/system/ \
+  && sudo systemctl daemon-reload && sudo systemctl restart $$name$$-backend"

package/tm/env/cloudflare/README.md.frag

@@ -0,0 +1,7 @@
+# $$Name$$ - cloudflare environment (starting point)
+
+    cd gen/env/cloudflare && npx wrangler deploy
+
+The worker entry (src/env/cloudflare/worker.ts - yours to edit, wrangler
+bundles the TS directly) is a 501 stub: wire the Seneca gateway into the
+fetch handler (src/env/lambda/lambda.ts is the AWS model to follow).

package/tm/env/cloudflare/worker.ts.frag

@@ -0,0 +1,13 @@
+// $$Name$$ backend - Cloudflare Worker entry (generated once; this file is
+// yours to edit). STARTING POINT: Workers use a fetch handler rather than
+// a long-lived process - adapt the gateway wiring (src/env/lambda/lambda.ts
+// is the AWS equivalent) to route requests into Seneca here.
+
+export default {
+  async fetch(_request: Request, _env: unknown, _ctx: unknown) {
+    return new Response(JSON.stringify({
+      ok: false,
+      why: '$$name$$-backend worker entry not yet wired',
+    }), { status: 501, headers: { 'content-type': 'application/json' } })
+  },
+}

package/tm/env/cloudflare/wrangler.toml.frag

@@ -0,0 +1,7 @@
+# $$Name$$ backend - Cloudflare Workers config (generated; starting point)
+name = "$$name$$-backend"
+main = "../../../src/env/cloudflare/worker.ts"
+compatibility_date = "2026-01-01"
+
+[vars]
+NODE_ENV = "production"

package/tm/env/docker/Dockerfile.frag

@@ -0,0 +1,10 @@
+# $$Name$$ backend image (generated; customize via tm/env/docker/)
+FROM node:$$node$$-slim
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev
+COPY model/model.json model/model.json
+COPY dist/ dist/
+ENV NODE_ENV=production
+EXPOSE $$port$$
+CMD ["node", "dist/env/local/local.js"]

package/tm/env/docker/README.md.frag

@@ -0,0 +1,7 @@
+# $$Name$$ - docker environment
+
+    cd backend && npm run build
+    docker compose -f gen/env/docker/compose.yml up --build
+
+Port $$port$$. The image runs the local (in-memory) runner; wire a real
+store before production use.

package/tm/env/docker/compose.yml.frag

@@ -0,0 +1,10 @@
+# $$Name$$ backend - docker compose (generated; customize via tm/env/docker/)
+services:
+  $$name$$-backend:
+    build:
+      context: ../../..
+      dockerfile: gen/env/docker/Dockerfile
+    ports:
+      - "$$port$$:$$port$$"
+    environment:
+      NODE_ENV: production

package/tm/env/local/README.md.frag

@@ -0,0 +1,7 @@
+# $$Name$$ - local environment
+
+Runs the backend in-process with the in-memory store:
+
+    sh gen/env/local/run.sh    # or: cd backend && npm run local
+
+Port: $$port$$. No external services required.

package/tm/env/local/run.sh.frag

@@ -0,0 +1,6 @@
+#!/bin/sh
+# $$Name$$ backend - local run (generated; customize via tm/env/local/)
+# In-process Seneca instance, in-memory store, port $$port$$.
+cd "$(dirname "$0")/../../.."
+export NODE_ENV=development
+exec npm run local

package/tm/env/server.entry.ts.frag

@@ -0,0 +1,48 @@
+
+// $$Name$$ backend - $$env$$ environment entry (generated once; this file
+// is yours to edit). A long-lived server process using the shared Seneca
+// setup (src/env/shared/basic.ts); reads its env config from the model
+// (main.env.$$env$$).
+
+import Seneca from 'seneca'
+import { Local } from '@voxgig/system'
+
+import { basic, base } from '../shared/basic'
+
+import Pkg from '../../../package.json'
+import Model from '../../../model/model.json'
+
+
+run()
+
+
+async function run() {
+  const { deep } = Seneca.util
+
+  const envdef: any = (Model as any).main.env?.['$$env$$'] || {}
+
+  const seneca = Seneca(deep(base.seneca, {
+    tag: '$$name$$-$$env$$',
+    log: { level: envdef.log || 'warn' },
+  }, envdef.seneca || {}))
+
+  seneca.context.model = Model
+  seneca.context.env = '$$env$$'
+  seneca.context.stage = process.env.STAGE || '$$env$$'
+  seneca.context.srvname = 'all'
+  seneca.context.pkg = Pkg
+
+  basic(seneca)
+
+  seneca.use(Local, {
+    srv: {
+      folder: __dirname + '/../../../dist/srv',
+    },
+  })
+
+  await seneca.ready()
+
+  console.log('$$name$$-backend started', {
+    env: '$$env$$', version: Pkg.version, port: $$port$$,
+  })
+}

package/tm/env/vm/README.md.frag

@@ -0,0 +1,5 @@
+# $$Name$$ - vm environment
+
+Boot any cloud VM with gen/env/vm/cloud-init.yaml as user-data, then push
+code with the basic deploy script (BASIC_HOST=user@vm sh
+gen/env/basic/deploy.sh) or your own pipeline.

package/tm/env/vm/cloud-init.yaml.frag

@@ -0,0 +1,23 @@
+#cloud-config
+# $$Name$$ backend VM bootstrap (generated; customize via tm/env/vm/)
+packages:
+  - nodejs
+  - npm
+  - rsync
+write_files:
+  - path: /etc/systemd/system/$$name$$-backend.service
+    content: |
+      [Unit]
+      Description=$$Name$$ backend
+      After=network.target
+      [Service]
+      WorkingDirectory=/opt/$$name$$/backend
+      ExecStart=/usr/bin/node dist/env/local/local.js
+      Restart=always
+      Environment=NODE_ENV=production
+      [Install]
+      WantedBy=multi-user.target
+runcmd:
+  - mkdir -p /opt/$$name$$/backend
+  - systemctl daemon-reload
+  - systemctl enable $$name$$-backend