@voxgig/system 1.3.1 → 1.4.0

package/README.md

@@ -56,3 +56,26 @@ Add.fields(folder, 'thing', ['title', 'done:Boolean'])
 ## License
 
 MIT. Copyright (c) Voxgig Ltd.
+
+## Custom generation templates
+
+Generation templates resolve in layers — first hit wins:
+
+1. `backend/src/gen/<name>.ts` — compiled generator override (deep custom)
+2. `backend/tm/lambda/<frag>` — project fragment (text-level custom)
+3. `@voxgig/build` defaults
+
+```bash
+voxgig-system template list            # each template + its providing layer
+voxgig-system template eject srv.yml.frag      # copy fragment -> tm/lambda/
+voxgig-system template eject srv_yml --code    # copy generator -> src/gen/
+voxgig-system template diff            # ejected copies vs installed package
+```
+
+Fragments are jostraca-style text templates with `$$slot$$` placeholders —
+edit and re-run `npm run model-build`, no compile step. Ejecting records
+provenance (`tm/lambda/.ejected.json`) so `template diff` can flag
+upstream template changes after a `@voxgig/build` upgrade. `--code`
+copies the template source rewired to `@voxgig/build`'s public API; the
+project then owns that generator (`npm run build && npm run model-build`
+after edits).

package/cmd.ts

@@ -17,9 +17,12 @@
 // model build (npm run model-build) afterwards to compile.
 
 import { addEntity, addSrv, addMsg, addFields } from './lib/add'
+import {
+  listTemplates, ejectFragment, ejectCode, diffTemplates,
+} from './lib/template'
 
 
-const USAGE = `Usage: voxgig-system add <element> [args...]
+const USAGE = `Usage: voxgig-system <command> [args...]
 
   add entity [name|spec]           add an entity (name may be zone/name)
   add srv    [name|spec]           add a service
@@ -27,6 +30,11 @@ const USAGE = `Usage: voxgig-system add <element> [args...]
   add field  <entity> [field...]   add field(s) to an entity
   add fields <entity> [field...]   alias of add field
 
+  template list                    templates + the layer providing each
+  template eject <name>            copy a fragment into backend/tm/lambda/
+  template eject <name> --code     copy a generator into backend/src/gen/
+  template diff                    ejected copies vs the installed package
+
 name:  plain element name - an empty element is added
 spec:  jsonic definition with config options, e.g.
        add entity '{name:thing,field:{title:{kind:String}}}'
@@ -34,6 +42,11 @@ spec:  jsonic definition with config options, e.g.
        add msg    '{name:thing.save.item,params:{title:String}}'
        add field  thing title 'done:Boolean' 'note:{kind:String,valid:Skip}'
 
+Generation templates resolve in layers (first hit wins): project
+src/gen/<name>.ts (code override) -> project tm/lambda/<frag> (text
+fragment) -> @voxgig/build defaults. Eject a fragment to customize the
+text shape with no compile step; eject --code for structural changes.
+
 Run inside the project (or backend/) folder. Then: npm run model-build
 `
 
@@ -48,14 +61,69 @@ async function main() {
 
   const [cmd, element, ...args] = argv
 
+  const start = process.cwd()
+
+  if ('template' === cmd || 'templates' === cmd) {
+    try {
+      if ('list' === element) {
+        for (const row of listTemplates(start)) {
+          console.log(
+            row.kind.padEnd(10) + row.name.padEnd(24) + row.layer)
+        }
+      }
+      else if ('eject' === element) {
+        const name = args.filter((a) => !a.startsWith('-'))[0]
+        if (null == name) {
+          throw new Error('template eject: missing template name')
+        }
+        if (args.includes('--code')) {
+          const dest = ejectCode(start, name)
+          console.log('ejected generator: ' + dest)
+          console.log('\nThis project copy now owns the ' + name +
+            ' generator. After editing:')
+          console.log('  npm run build && npm run model-build')
+        }
+        else {
+          const dest = ejectFragment(start, name)
+          console.log('ejected fragment: ' + dest)
+          console.log('\nEdit the fragment, then: npm run model-build')
+        }
+      }
+      else if ('diff' === element) {
+        const rows = diffTemplates(start)
+        if (0 === rows.length) {
+          console.log('nothing ejected')
+        }
+        for (const row of rows) {
+          console.log('== ' + row.name + '  (upstream: ' +
+            row.upstream + ')')
+          if (row.diff) {
+            console.log(row.diff)
+          }
+          else if ('' === row.diff) {
+            console.log('   identical to package')
+          }
+        }
+      }
+      else {
+        console.error('voxgig-system: unknown template command: ' + element)
+        console.log(USAGE)
+        process.exit(1)
+      }
+      process.exit(0)
+    }
+    catch (e: any) {
+      console.error('voxgig-system: ' + e.message)
+      process.exit(1)
+    }
+  }
+
   if ('add' !== cmd) {
     console.error('voxgig-system: unknown command: ' + cmd)
     console.log(USAGE)
     process.exit(1)
   }
 
-  const start = process.cwd()
-
   try {
     if ('entity' === element) {
       requireArgs(args, 1, 'add entity')

package/dist/cmd.js

@@ -18,7 +18,8 @@ exports.main = main;
 // are found via model/model.jsonic and appended to. Run the project's
 // model build (npm run model-build) afterwards to compile.
 const add_1 = require("./lib/add");
-const USAGE = `Usage: voxgig-system add <element> [args...]
+const template_1 = require("./lib/template");
+const USAGE = `Usage: voxgig-system <command> [args...]
 
   add entity [name|spec]           add an entity (name may be zone/name)
   add srv    [name|spec]           add a service
@@ -26,6 +27,11 @@ const USAGE = `Usage: voxgig-system add <element> [args...]
   add field  <entity> [field...]   add field(s) to an entity
   add fields <entity> [field...]   alias of add field
 
+  template list                    templates + the layer providing each
+  template eject <name>            copy a fragment into backend/tm/lambda/
+  template eject <name> --code     copy a generator into backend/src/gen/
+  template diff                    ejected copies vs the installed package
+
 name:  plain element name - an empty element is added
 spec:  jsonic definition with config options, e.g.
        add entity '{name:thing,field:{title:{kind:String}}}'
@@ -33,6 +39,11 @@ spec:  jsonic definition with config options, e.g.
        add msg    '{name:thing.save.item,params:{title:String}}'
        add field  thing title 'done:Boolean' 'note:{kind:String,valid:Skip}'
 
+Generation templates resolve in layers (first hit wins): project
+src/gen/<name>.ts (code override) -> project tm/lambda/<frag> (text
+fragment) -> @voxgig/build defaults. Eject a fragment to customize the
+text shape with no compile step; eject --code for structural changes.
+
 Run inside the project (or backend/) folder. Then: npm run model-build
 `;
 async function main() {
@@ -42,12 +53,65 @@ async function main() {
         process.exit(0 === argv.length ? 1 : 0);
     }
     const [cmd, element, ...args] = argv;
+    const start = process.cwd();
+    if ('template' === cmd || 'templates' === cmd) {
+        try {
+            if ('list' === element) {
+                for (const row of (0, template_1.listTemplates)(start)) {
+                    console.log(row.kind.padEnd(10) + row.name.padEnd(24) + row.layer);
+                }
+            }
+            else if ('eject' === element) {
+                const name = args.filter((a) => !a.startsWith('-'))[0];
+                if (null == name) {
+                    throw new Error('template eject: missing template name');
+                }
+                if (args.includes('--code')) {
+                    const dest = (0, template_1.ejectCode)(start, name);
+                    console.log('ejected generator: ' + dest);
+                    console.log('\nThis project copy now owns the ' + name +
+                        ' generator. After editing:');
+                    console.log('  npm run build && npm run model-build');
+                }
+                else {
+                    const dest = (0, template_1.ejectFragment)(start, name);
+                    console.log('ejected fragment: ' + dest);
+                    console.log('\nEdit the fragment, then: npm run model-build');
+                }
+            }
+            else if ('diff' === element) {
+                const rows = (0, template_1.diffTemplates)(start);
+                if (0 === rows.length) {
+                    console.log('nothing ejected');
+                }
+                for (const row of rows) {
+                    console.log('== ' + row.name + '  (upstream: ' +
+                        row.upstream + ')');
+                    if (row.diff) {
+                        console.log(row.diff);
+                    }
+                    else if ('' === row.diff) {
+                        console.log('   identical to package');
+                    }
+                }
+            }
+            else {
+                console.error('voxgig-system: unknown template command: ' + element);
+                console.log(USAGE);
+                process.exit(1);
+            }
+            process.exit(0);
+        }
+        catch (e) {
+            console.error('voxgig-system: ' + e.message);
+            process.exit(1);
+        }
+    }
     if ('add' !== cmd) {
         console.error('voxgig-system: unknown command: ' + cmd);
         console.log(USAGE);
         process.exit(1);
     }
-    const start = process.cwd();
     try {
         if ('entity' === element) {
             requireArgs(args, 1, 'add entity');

package/dist/cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../cmd.ts"],"names":[],"mappings":";;AACA,+CAA+C;;QAiH7C,IAAI;AA/GN,wEAAwE;AACxE,EAAE;AACF,yDAAyD;AACzD,yDAAyD;AACzD,yDAAyD;AACzD,sEAAsE;AACtE,sEAAsE;AACtE,EAAE;AACF,8DAA8D;AAC9D,wEAAwE;AACxE,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,2DAA2D;AAE3D,mCAAgE;AAGhE,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;CAgBb,CAAA;AAGD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAElC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAEpC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,GAAG,CAAC,CAAA;QACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAE3B,IAAI,CAAC;QACH,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,CAAA;YAClC,MAAM,GAAG,GAAG,IAAA,eAAS,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACrC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;aACI,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;YAC/B,MAAM,GAAG,GAAG,IAAA,YAAM,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;aACI,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;YAC/B,MAAM,GAAG,GAAG,IAAA,YAAM,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;aACI,IAAI,OAAO,KAAK,OAAO,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrD,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;YACjC,MAAM,GAAG,GAAG,IAAA,eAAS,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACpD,MAAM,CAAC,GAAG,CAAC,CAAA;QACb,CAAC;aACI,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,OAAO,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,CAAM,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAGD,SAAS,WAAW,CAAC,IAAc,EAAE,CAAS,EAAE,IAAY;IAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,uBAAuB,CAAC,CAAA;IACjD,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAAyC;IACvD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;QAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;AACH,CAAC;AAGD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAA;AACR,CAAC"}
+{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../cmd.ts"],"names":[],"mappings":";;AACA,+CAA+C;;QAqL7C,IAAI;AAnLN,wEAAwE;AACxE,EAAE;AACF,yDAAyD;AACzD,yDAAyD;AACzD,yDAAyD;AACzD,sEAAsE;AACtE,sEAAsE;AACtE,EAAE;AACF,8DAA8D;AAC9D,wEAAwE;AACxE,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,2DAA2D;AAE3D,mCAAgE;AAChE,6CAEuB;AAGvB,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAA;AAGD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAElC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAEpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAE3B,IAAI,UAAU,KAAK,GAAG,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,KAAK,MAAM,GAAG,IAAI,IAAA,wBAAa,EAAC,KAAK,CAAC,EAAE,CAAC;oBACvC,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;gBAC1D,CAAC;YACH,CAAC;iBACI,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACtD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;gBAC1D,CAAC;gBACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,GAAG,IAAA,oBAAS,EAAC,KAAK,EAAE,IAAI,CAAC,CAAA;oBACnC,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAA;oBACzC,OAAO,CAAC,GAAG,CAAC,mCAAmC,GAAG,IAAI;wBACpD,4BAA4B,CAAC,CAAA;oBAC/B,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAA;gBACvD,CAAC;qBACI,CAAC;oBACJ,MAAM,IAAI,GAAG,IAAA,wBAAa,EAAC,KAAK,EAAE,IAAI,CAAC,CAAA;oBACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;oBACxC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAA;gBAC/D,CAAC;YACH,CAAC;iBACI,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAA;gBACjC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;gBAChC,CAAC;gBACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,GAAG,eAAe;wBAC5C,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAA;oBACrB,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;wBACb,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;oBACvB,CAAC;yBACI,IAAI,EAAE,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;wBACzB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;oBACxC,CAAC;gBACH,CAAC;YACH,CAAC;iBACI,CAAC;gBACJ,OAAO,CAAC,KAAK,CAAC,2CAA2C,GAAG,OAAO,CAAC,CAAA;gBACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,OAAO,CAAM,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,GAAG,CAAC,CAAA;QACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,IAAI,CAAC;QACH,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,CAAA;YAClC,MAAM,GAAG,GAAG,IAAA,eAAS,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACrC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;aACI,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;YAC/B,MAAM,GAAG,GAAG,IAAA,YAAM,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;aACI,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;YAC/B,MAAM,GAAG,GAAG,IAAA,YAAM,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACf,CAAC;aACI,IAAI,OAAO,KAAK,OAAO,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrD,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;YACjC,MAAM,GAAG,GAAG,IAAA,eAAS,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACpD,MAAM,CAAC,GAAG,CAAC,CAAA;QACb,CAAC;aACI,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,OAAO,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,CAAM,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAGD,SAAS,WAAW,CAAC,IAAc,EAAE,CAAS,EAAE,IAAY;IAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,uBAAuB,CAAC,CAAA;IACjD,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAAyC;IACvD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;QAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;AACH,CAAC;AAGD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAA;AACR,CAAC"}

package/dist/lib/template.d.ts

@@ -0,0 +1,24 @@
+declare const GENERATORS: string[];
+export type Project = {
+    backend: string;
+    tm: string;
+    gen: string;
+    pkg: string;
+    pkgtm: string;
+};
+declare function resolveProject(start: string): Project;
+export type TemplateRow = {
+    name: string;
+    kind: 'fragment' | 'generator';
+    layer: string;
+};
+declare function listTemplates(start: string): TemplateRow[];
+declare function ejectFragment(start: string, name: string): string;
+declare function ejectCode(start: string, name: string): string;
+export type DiffRow = {
+    name: string;
+    upstream: 'unchanged' | 'changed' | 'missing';
+    diff?: string;
+};
+declare function diffTemplates(start: string): DiffRow[];
+export { resolveProject, listTemplates, ejectFragment, ejectCode, diffTemplates, GENERATORS, };

package/dist/lib/template.js

@@ -0,0 +1,202 @@
+"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.GENERATORS = void 0;
+exports.resolveProject = resolveProject;
+exports.listTemplates = listTemplates;
+exports.ejectFragment = ejectFragment;
+exports.ejectCode = ejectCode;
+exports.diffTemplates = diffTemplates;
+// Template customization tooling: list / eject / diff for the generation
+// templates provided by @voxgig/build.
+//
+// Layered resolution (first hit wins):
+//   1. backend/src/gen/<name>.ts   compiled generator override (deep custom)
+//   2. backend/tm/lambda/<frag>    project fragment (text-level custom)
+//   3. @voxgig/build               package defaults
+//
+// eject copies a package fragment (or, with code=true, a template source
+// rewired to the package's public API) into the project, recording
+// provenance in tm/lambda/.ejected.json so diff can show upstream drift
+// after package upgrades.
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const add_1 = require("./add");
+// The code-level template generators (env/lambda/<name>.ts in the package).
+const GENERATORS = ['srv_yml', 'srv_handler', 'res_yml'];
+exports.GENERATORS = GENERATORS;
+// Generator shorthand -> default fragment.
+const GENERATOR_FRAG = {
+    srv_yml: 'srv.yml.frag',
+    srv_handler: 'srv_handler.ts.frag',
+    res_yml: 'res.role.yml.frag',
+};
+function resolveProject(start) {
+    const files = (0, add_1.resolveModelFiles)(start);
+    const backend = node_path_1.default.dirname(files.folder);
+    let pkgjson;
+    try {
+        pkgjson = require.resolve('@voxgig/build/package.json', {
+            paths: [backend, files.folder, start],
+        });
+    }
+    catch (e) {
+        throw new Error('@voxgig/build not found from ' + backend +
+            ' - is it installed? (npm install)');
+    }
+    const pkg = node_path_1.default.dirname(pkgjson);
+    return {
+        backend,
+        tm: node_path_1.default.join(backend, 'tm', 'lambda'),
+        gen: node_path_1.default.join(backend, 'src', 'gen'),
+        pkg,
+        pkgtm: node_path_1.default.join(pkg, 'tm', 'lambda'),
+    };
+}
+function pkgVersion(project) {
+    return JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(project.pkg, 'package.json'), 'utf8')).version;
+}
+function sha256(content) {
+    return node_crypto_1.default.createHash('sha256').update(content).digest('hex');
+}
+function readProvenance(project) {
+    const p = node_path_1.default.join(project.tm, '.ejected.json');
+    return node_fs_1.default.existsSync(p) ? JSON.parse(node_fs_1.default.readFileSync(p, 'utf8')) : {};
+}
+function writeProvenance(project, prov) {
+    node_fs_1.default.mkdirSync(project.tm, { recursive: true });
+    node_fs_1.default.writeFileSync(node_path_1.default.join(project.tm, '.ejected.json'), JSON.stringify(prov, null, 2) + '\n');
+}
+// List each template with the layer that currently provides it.
+function listTemplates(start) {
+    const project = resolveProject(start);
+    const rows = [];
+    for (const gen of GENERATORS) {
+        const override = node_path_1.default.join(project.gen, gen + '.ts');
+        rows.push({
+            name: gen,
+            kind: 'generator',
+            layer: node_fs_1.default.existsSync(override) ?
+                'project (src/gen/' + gen + '.ts)' : 'package',
+        });
+    }
+    const frags = node_fs_1.default.readdirSync(project.pkgtm)
+        .filter((f) => f.endsWith('.frag')).sort();
+    for (const frag of frags) {
+        rows.push({
+            name: frag,
+            kind: 'fragment',
+            layer: node_fs_1.default.existsSync(node_path_1.default.join(project.tm, frag)) ?
+                'project (tm/lambda/' + frag + ')' : 'package',
+        });
+    }
+    return rows;
+}
+// Eject a fragment (text template) into backend/tm/lambda/.
+function ejectFragment(start, name) {
+    const project = resolveProject(start);
+    const frag = GENERATOR_FRAG[name] || name;
+    const srcpath = node_path_1.default.join(project.pkgtm, frag);
+    if (!node_fs_1.default.existsSync(srcpath)) {
+        const avail = node_fs_1.default.readdirSync(project.pkgtm)
+            .filter((f) => f.endsWith('.frag')).sort();
+        throw new Error('unknown fragment: ' + frag +
+            ' (available: ' + avail.join(', ') + ')');
+    }
+    const dest = node_path_1.default.join(project.tm, frag);
+    if (node_fs_1.default.existsSync(dest)) {
+        throw new Error('already ejected: ' + node_path_1.default.relative(start, dest));
+    }
+    const content = node_fs_1.default.readFileSync(srcpath, 'utf8');
+    node_fs_1.default.mkdirSync(project.tm, { recursive: true });
+    node_fs_1.default.writeFileSync(dest, content);
+    const prov = readProvenance(project);
+    prov[frag] = {
+        package: '@voxgig/build',
+        version: pkgVersion(project),
+        sha256: sha256(content),
+    };
+    writeProvenance(project, prov);
+    return dest;
+}
+// Eject a generator source (compiled component override) into
+// backend/src/gen/<name>.ts, rewiring package-internal imports to the
+// public '@voxgig/build' API.
+function ejectCode(start, name) {
+    const project = resolveProject(start);
+    if (!GENERATORS.includes(name)) {
+        throw new Error('unknown generator: ' + name +
+            ' (available: ' + GENERATORS.join(', ') + ')');
+    }
+    const srcpath = node_path_1.default.join(project.pkg, 'env', 'lambda', name + '.ts');
+    if (!node_fs_1.default.existsSync(srcpath)) {
+        throw new Error('template source not shipped by installed ' +
+            '@voxgig/build (' + pkgVersion(project) + ') - needs >= 4.1.0');
+    }
+    const dest = node_path_1.default.join(project.gen, name + '.ts');
+    if (node_fs_1.default.existsSync(dest)) {
+        throw new Error('already ejected: ' + node_path_1.default.relative(start, dest));
+    }
+    let src = node_fs_1.default.readFileSync(srcpath, 'utf8');
+    // Package-internal imports -> public API.
+    src = src
+        .replace(/from '\.\/generate'/g, "from '@voxgig/build'")
+        .replace(/from '\.\.\/\.\.\/shape\/msg'/g, "from '@voxgig/build'")
+        .replace(/from '\.\.\/\.\.\/shape\/conf'/g, "from '@voxgig/build'")
+        .replace(/from '\.\.\/\.\.\/yml\/res_dynamo_yml'/g, "from '@voxgig/build'");
+    const version = pkgVersion(project);
+    src = '// Ejected from @voxgig/build ' + version +
+        ' (env/lambda/' + name + '.ts).\n' +
+        '// This project copy now OWNS this generator: the build action uses\n' +
+        '// it instead of the package default. After editing, run:\n' +
+        '//   npm run build && npm run model-build\n' +
+        '// Compare with the package version: voxgig-system template diff\n' +
+        src;
+    node_fs_1.default.mkdirSync(project.gen, { recursive: true });
+    node_fs_1.default.writeFileSync(dest, src);
+    const prov = readProvenance(project);
+    prov['code:' + name] = {
+        package: '@voxgig/build',
+        version,
+        sha256: sha256(node_fs_1.default.readFileSync(srcpath)),
+    };
+    writeProvenance(project, prov);
+    return dest;
+}
+// For each ejected template, report upstream drift (package version now
+// differs from what was ejected) and show package-vs-project diffs.
+function diffTemplates(start) {
+    const project = resolveProject(start);
+    const prov = readProvenance(project);
+    const rows = [];
+    for (const key of Object.keys(prov).sort()) {
+        const rec = prov[key];
+        const isCode = key.startsWith('code:');
+        const name = isCode ? key.substring(5) : key;
+        const pkgfile = isCode ?
+            node_path_1.default.join(project.pkg, 'env', 'lambda', name + '.ts') :
+            node_path_1.default.join(project.pkgtm, name);
+        const projfile = isCode ?
+            node_path_1.default.join(project.gen, name + '.ts') :
+            node_path_1.default.join(project.tm, name);
+        if (!node_fs_1.default.existsSync(pkgfile)) {
+            rows.push({ name: key, upstream: 'missing' });
+            continue;
+        }
+        const upstream = sha256(node_fs_1.default.readFileSync(pkgfile)) === rec.sha256 ?
+            'unchanged' : 'changed';
+        let diff = undefined;
+        if (node_fs_1.default.existsSync(projfile)) {
+            const res = (0, node_child_process_1.spawnSync)('diff', ['-u', pkgfile, projfile], { encoding: 'utf8' });
+            diff = 0 === res.status ? '' : res.stdout;
+        }
+        rows.push({ name: key, upstream, diff });
+    }
+    return rows;
+}
+//# sourceMappingURL=template.js.map

package/dist/lib/template.js.map

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

package/dist/system.d.ts

@@ -2,6 +2,7 @@ import type { Msg } from './lib/types';
 import { Utility } from './lib/utility';
 import { MakeSrv } from './srv/make';
 import { addEntity, addSrv, addMsg, addFields, resolveModelFiles } from './lib/add';
+import { listTemplates, ejectFragment, ejectCode, diffTemplates } from './lib/template';
 declare function messages(seneca: any, options: any, reload: any): void;
 declare function gubuify(params: any, Gubu: any): any;
 declare function prepare(seneca: any, require: any): void;
@@ -26,4 +27,10 @@ declare const Add: {
     fields: typeof addFields;
     resolveModelFiles: typeof resolveModelFiles;
 };
-export { Add, gubuify, System, MakeSrv, Utility, Local, Live, };
+declare const Template: {
+    list: typeof listTemplates;
+    eject: typeof ejectFragment;
+    ejectCode: typeof ejectCode;
+    diff: typeof diffTemplates;
+};
+export { Add, Template, gubuify, System, MakeSrv, Utility, Local, Live, };

package/dist/system.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.Utility = exports.MakeSrv = exports.System = exports.Add = void 0;
+exports.Utility = exports.MakeSrv = exports.System = exports.Template = exports.Add = void 0;
 exports.gubuify = gubuify;
 exports.Local = Local;
 exports.Live = Live;
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "Utility", { enumerable: true, get: function () {
 const make_1 = require("./srv/make");
 Object.defineProperty(exports, "MakeSrv", { enumerable: true, get: function () { return make_1.MakeSrv; } });
 const add_1 = require("./lib/add");
+const template_1 = require("./lib/template");
 const { srvmsgs, deep } = utility_1.Utility;
 function messages(seneca, options, reload) {
     let srvname = seneca.fixedargs.plugin$.name.replace(/^srv_/, '');
@@ -155,4 +156,11 @@ const Add = {
     resolveModelFiles: add_1.resolveModelFiles,
 };
 exports.Add = Add;
+const Template = {
+    list: template_1.listTemplates,
+    eject: template_1.ejectFragment,
+    ejectCode: template_1.ejectCode,
+    diff: template_1.diffTemplates,
+};
+exports.Template = Template;
 //# sourceMappingURL=system.js.map

package/dist/system.js.map

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

package/lib/template.ts

@@ -0,0 +1,278 @@
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+
+// Template customization tooling: list / eject / diff for the generation
+// templates provided by @voxgig/build.
+//
+// Layered resolution (first hit wins):
+//   1. backend/src/gen/<name>.ts   compiled generator override (deep custom)
+//   2. backend/tm/lambda/<frag>    project fragment (text-level custom)
+//   3. @voxgig/build               package defaults
+//
+// eject copies a package fragment (or, with code=true, a template source
+// rewired to the package's public API) into the project, recording
+// provenance in tm/lambda/.ejected.json so diff can show upstream drift
+// after package upgrades.
+
+import Crypto from 'node:crypto'
+import Fs from 'node:fs'
+import Path from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+import { resolveModelFiles } from './add'
+
+
+// The code-level template generators (env/lambda/<name>.ts in the package).
+const GENERATORS = ['srv_yml', 'srv_handler', 'res_yml']
+
+// Generator shorthand -> default fragment.
+const GENERATOR_FRAG: Record<string, string> = {
+  srv_yml: 'srv.yml.frag',
+  srv_handler: 'srv_handler.ts.frag',
+  res_yml: 'res.role.yml.frag',
+}
+
+
+export type Project = {
+  backend: string     // the project backend folder (holds model/, tm/, src/)
+  tm: string          // backend/tm/lambda
+  gen: string         // backend/src/gen
+  pkg: string         // resolved @voxgig/build package folder
+  pkgtm: string       // package tm/lambda
+}
+
+
+function resolveProject(start: string): Project {
+  const files = resolveModelFiles(start)
+  const backend = Path.dirname(files.folder)
+
+  let pkgjson: string
+  try {
+    pkgjson = require.resolve('@voxgig/build/package.json', {
+      paths: [backend, files.folder, start],
+    })
+  }
+  catch (e: any) {
+    throw new Error('@voxgig/build not found from ' + backend +
+      ' - is it installed? (npm install)')
+  }
+  const pkg = Path.dirname(pkgjson)
+
+  return {
+    backend,
+    tm: Path.join(backend, 'tm', 'lambda'),
+    gen: Path.join(backend, 'src', 'gen'),
+    pkg,
+    pkgtm: Path.join(pkg, 'tm', 'lambda'),
+  }
+}
+
+
+function pkgVersion(project: Project): string {
+  return JSON.parse(
+    Fs.readFileSync(Path.join(project.pkg, 'package.json'), 'utf8')).version
+}
+
+function sha256(content: string | Buffer): string {
+  return Crypto.createHash('sha256').update(content).digest('hex')
+}
+
+
+type Provenance = Record<string, {
+  package: string, version: string, sha256: string
+}>
+
+function readProvenance(project: Project): Provenance {
+  const p = Path.join(project.tm, '.ejected.json')
+  return Fs.existsSync(p) ? JSON.parse(Fs.readFileSync(p, 'utf8')) : {}
+}
+
+function writeProvenance(project: Project, prov: Provenance) {
+  Fs.mkdirSync(project.tm, { recursive: true })
+  Fs.writeFileSync(Path.join(project.tm, '.ejected.json'),
+    JSON.stringify(prov, null, 2) + '\n')
+}
+
+
+export type TemplateRow = {
+  name: string        // fragment or generator name
+  kind: 'fragment' | 'generator'
+  layer: string       // which layer currently provides it
+}
+
+// List each template with the layer that currently provides it.
+function listTemplates(start: string): TemplateRow[] {
+  const project = resolveProject(start)
+
+  const rows: TemplateRow[] = []
+
+  for (const gen of GENERATORS) {
+    const override = Path.join(project.gen, gen + '.ts')
+    rows.push({
+      name: gen,
+      kind: 'generator',
+      layer: Fs.existsSync(override) ?
+        'project (src/gen/' + gen + '.ts)' : 'package',
+    })
+  }
+
+  const frags = Fs.readdirSync(project.pkgtm)
+    .filter((f) => f.endsWith('.frag')).sort()
+  for (const frag of frags) {
+    rows.push({
+      name: frag,
+      kind: 'fragment',
+      layer: Fs.existsSync(Path.join(project.tm, frag)) ?
+        'project (tm/lambda/' + frag + ')' : 'package',
+    })
+  }
+
+  return rows
+}
+
+
+// Eject a fragment (text template) into backend/tm/lambda/.
+function ejectFragment(start: string, name: string): string {
+  const project = resolveProject(start)
+
+  const frag = GENERATOR_FRAG[name] || name
+  const srcpath = Path.join(project.pkgtm, frag)
+  if (!Fs.existsSync(srcpath)) {
+    const avail = Fs.readdirSync(project.pkgtm)
+      .filter((f) => f.endsWith('.frag')).sort()
+    throw new Error('unknown fragment: ' + frag +
+      ' (available: ' + avail.join(', ') + ')')
+  }
+
+  const dest = Path.join(project.tm, frag)
+  if (Fs.existsSync(dest)) {
+    throw new Error('already ejected: ' + Path.relative(start, dest))
+  }
+
+  const content = Fs.readFileSync(srcpath, 'utf8')
+  Fs.mkdirSync(project.tm, { recursive: true })
+  Fs.writeFileSync(dest, content)
+
+  const prov = readProvenance(project)
+  prov[frag] = {
+    package: '@voxgig/build',
+    version: pkgVersion(project),
+    sha256: sha256(content),
+  }
+  writeProvenance(project, prov)
+
+  return dest
+}
+
+
+// Eject a generator source (compiled component override) into
+// backend/src/gen/<name>.ts, rewiring package-internal imports to the
+// public '@voxgig/build' API.
+function ejectCode(start: string, name: string): string {
+  const project = resolveProject(start)
+
+  if (!GENERATORS.includes(name)) {
+    throw new Error('unknown generator: ' + name +
+      ' (available: ' + GENERATORS.join(', ') + ')')
+  }
+
+  const srcpath = Path.join(project.pkg, 'env', 'lambda', name + '.ts')
+  if (!Fs.existsSync(srcpath)) {
+    throw new Error('template source not shipped by installed ' +
+      '@voxgig/build (' + pkgVersion(project) + ') - needs >= 4.1.0')
+  }
+
+  const dest = Path.join(project.gen, name + '.ts')
+  if (Fs.existsSync(dest)) {
+    throw new Error('already ejected: ' + Path.relative(start, dest))
+  }
+
+  let src = Fs.readFileSync(srcpath, 'utf8')
+
+  // Package-internal imports -> public API.
+  src = src
+    .replace(/from '\.\/generate'/g, "from '@voxgig/build'")
+    .replace(/from '\.\.\/\.\.\/shape\/msg'/g, "from '@voxgig/build'")
+    .replace(/from '\.\.\/\.\.\/shape\/conf'/g, "from '@voxgig/build'")
+    .replace(/from '\.\.\/\.\.\/yml\/res_dynamo_yml'/g, "from '@voxgig/build'")
+
+  const version = pkgVersion(project)
+  src = '// Ejected from @voxgig/build ' + version +
+    ' (env/lambda/' + name + '.ts).\n' +
+    '// This project copy now OWNS this generator: the build action uses\n' +
+    '// it instead of the package default. After editing, run:\n' +
+    '//   npm run build && npm run model-build\n' +
+    '// Compare with the package version: voxgig-system template diff\n' +
+    src
+
+  Fs.mkdirSync(project.gen, { recursive: true })
+  Fs.writeFileSync(dest, src)
+
+  const prov = readProvenance(project)
+  prov['code:' + name] = {
+    package: '@voxgig/build',
+    version,
+    sha256: sha256(Fs.readFileSync(srcpath)),
+  }
+  writeProvenance(project, prov)
+
+  return dest
+}
+
+
+export type DiffRow = {
+  name: string
+  upstream: 'unchanged' | 'changed' | 'missing'
+  diff?: string       // unified diff of package vs project copy
+}
+
+// For each ejected template, report upstream drift (package version now
+// differs from what was ejected) and show package-vs-project diffs.
+function diffTemplates(start: string): DiffRow[] {
+  const project = resolveProject(start)
+  const prov = readProvenance(project)
+
+  const rows: DiffRow[] = []
+
+  for (const key of Object.keys(prov).sort()) {
+    const rec = prov[key]
+    const isCode = key.startsWith('code:')
+    const name = isCode ? key.substring(5) : key
+
+    const pkgfile = isCode ?
+      Path.join(project.pkg, 'env', 'lambda', name + '.ts') :
+      Path.join(project.pkgtm, name)
+    const projfile = isCode ?
+      Path.join(project.gen, name + '.ts') :
+      Path.join(project.tm, name)
+
+    if (!Fs.existsSync(pkgfile)) {
+      rows.push({ name: key, upstream: 'missing' })
+      continue
+    }
+
+    const upstream =
+      sha256(Fs.readFileSync(pkgfile)) === rec.sha256 ?
+        'unchanged' : 'changed'
+
+    let diff: string | undefined = undefined
+    if (Fs.existsSync(projfile)) {
+      const res = spawnSync('diff', ['-u', pkgfile, projfile],
+        { encoding: 'utf8' })
+      diff = 0 === res.status ? '' : res.stdout
+    }
+
+    rows.push({ name: key, upstream, diff })
+  }
+
+  return rows
+}
+
+
+export {
+  resolveProject,
+  listTemplates,
+  ejectFragment,
+  ejectCode,
+  diffTemplates,
+  GENERATORS,
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/system",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "main": "dist/system.js",
   "type": "commonjs",
   "types": "dist/system.d.ts",

package/system.ts

@@ -14,6 +14,7 @@ import { Utility } from './lib/utility'
 import { MakeSrv } from './srv/make'
 
 import { addEntity, addSrv, addMsg, addFields, resolveModelFiles } from './lib/add'
+import { listTemplates, ejectFragment, ejectCode, diffTemplates } from './lib/template'
 
 
 
@@ -224,8 +225,16 @@ const Add = {
   resolveModelFiles,
 }
 
+const Template = {
+  list: listTemplates,
+  eject: ejectFragment,
+  ejectCode,
+  diff: diffTemplates,
+}
+
 export {
   Add,
+  Template,
   gubuify,
   System,
   MakeSrv,