@voxgig/system 1.2.0 → 1.3.0

package/README.md

@@ -1,2 +1,58 @@
-# System
+# @voxgig/system
 
+Runtime and tooling for Voxgig system projects: service loading
+(`MakeSrv`, `Local`, `Live`), message wiring from the model (`System`),
+and the `voxgig-system` command line.
+
+## voxgig-system CLI
+
+Add elements to a Voxgig system project (as created by
+`npm create @voxgig/system`). Run inside the project (or its `backend/`
+folder); the commands append jsonic blocks to the model source files —
+aontu unification merges them, and your formatting and comments are
+preserved. Run `npm run model-build` afterwards to compile.
+
+```
+voxgig-system add entity [name|spec]           add an entity (name may be zone/name)
+voxgig-system add srv    [name|spec]           add a service
+voxgig-system add msg    [name|spec]           add a message (path: thing.save.item)
+voxgig-system add field  <entity> [field...]   add field(s) to an entity
+voxgig-system add fields <entity> [field...]   alias of add field
+```
+
+Each element takes either a **String(name)** — an empty element of that
+name is added — or a **Jsonic(spec)** — a jsonic definition with config
+options:
+
+```bash
+# empty elements by name
+voxgig-system add entity thing            # zone defaults ('app', or the file's zone)
+voxgig-system add entity shop/order       # zone-qualified
+voxgig-system add srv thing
+voxgig-system add msg thing.get.info      # 'aim' is prepended if missing
+
+# jsonic specs with config options
+voxgig-system add entity '{name:thing,field:{title:{kind:String}}}'
+voxgig-system add srv    '{name:pub,user:{required:false}}'
+voxgig-system add msg    "{name:thing.save.item,params:{item:{'\$\$':'Open',title:String}}}"
+
+# fields: name | name:Kind | name:{...def} | {name:...,...def}
+voxgig-system add field thing title 'done:Boolean' 'note:{kind:String,valid:Skip}'
+```
+
+Message `params` validate the full message (data usually rides under a
+property like `item`). Gubu param objects are closed by default; mark an
+object with `'$$': 'Open'` (the same convention as entity `valid`) to
+allow additional properties.
+
+The add API is also exported for programmatic use:
+
+```js
+const { Add } = require('@voxgig/system')
+Add.entity(folder, 'thing')
+Add.fields(folder, 'thing', ['title', 'done:Boolean'])
+```
+
+## License
+
+MIT. Copyright (c) Voxgig Ltd.

package/cmd.ts

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+
+// voxgig-system: command line for working with a Voxgig system project.
+//
+//   voxgig-system add entity [String(name)|Jsonic(spec)]
+//   voxgig-system add srv    [String(name)|Jsonic(spec)]
+//   voxgig-system add msg    [String(name)|Jsonic(spec)]
+//   voxgig-system add field  <entity> [String(name)|Jsonic(spec)] ...
+//   voxgig-system add fields <entity> [String(name)|Jsonic(spec)] ...
+//
+// String(name): the element name - an empty element is added.
+// Jsonic(spec): a jsonic definition of the element with config options.
+//
+// Run inside a project (or its backend/ folder); the model source files
+// are found via model/model.jsonic and appended to. Run the project's
+// model build (npm run model-build) afterwards to compile.
+
+import { addEntity, addSrv, addMsg, addFields } from './lib/add'
+
+
+const USAGE = `Usage: voxgig-system add <element> [args...]
+
+  add entity [name|spec]           add an entity (name may be zone/name)
+  add srv    [name|spec]           add a service
+  add msg    [name|spec]           add a message (path: thing.save.item)
+  add field  <entity> [field...]   add field(s) to an entity
+  add fields <entity> [field...]   alias of add field
+
+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}}}'
+       add srv    '{name:thing,user:{required:false}}'
+       add msg    '{name:thing.save.item,params:{title:String}}'
+       add field  thing title 'done:Boolean' 'note:{kind:String,valid:Skip}'
+
+Run inside the project (or backend/) folder. Then: npm run model-build
+`
+
+
+async function main() {
+  const argv = process.argv.slice(2)
+
+  if (0 === argv.length || argv.includes('-h') || argv.includes('--help')) {
+    console.log(USAGE)
+    process.exit(0 === argv.length ? 1 : 0)
+  }
+
+  const [cmd, element, ...args] = argv
+
+  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')
+      const res = addEntity(start, args[0])
+      report([res])
+    }
+    else if ('srv' === element) {
+      requireArgs(args, 1, 'add srv')
+      const res = addSrv(start, args[0])
+      report([res])
+    }
+    else if ('msg' === element) {
+      requireArgs(args, 1, 'add msg')
+      const res = addMsg(start, args[0])
+      report([res])
+    }
+    else if ('field' === element || 'fields' === element) {
+      requireArgs(args, 2, 'add field')
+      const res = addFields(start, args[0], args.slice(1))
+      report(res)
+    }
+    else {
+      console.error('voxgig-system: unknown element: ' + element)
+      console.log(USAGE)
+      process.exit(1)
+    }
+
+    console.log('\nNow run: npm run model-build')
+  }
+  catch (e: any) {
+    console.error('voxgig-system: ' + e.message)
+    process.exit(1)
+  }
+}
+
+
+function requireArgs(args: string[], n: number, what: string) {
+  if (args.length < n) {
+    throw new Error(what + ': missing argument(s)')
+  }
+}
+
+function report(results: { file: string, text: string }[]) {
+  for (const res of results) {
+    console.log('appended to ' + res.file + ':')
+    console.log(res.text)
+  }
+}
+
+
+if (require.main === module) {
+  main()
+}
+
+
+export {
+  main,
+}

package/dist/cmd.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+declare function main(): Promise<void>;
+export { main, };

package/dist/cmd.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+"use strict";
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+// voxgig-system: command line for working with a Voxgig system project.
+//
+//   voxgig-system add entity [String(name)|Jsonic(spec)]
+//   voxgig-system add srv    [String(name)|Jsonic(spec)]
+//   voxgig-system add msg    [String(name)|Jsonic(spec)]
+//   voxgig-system add field  <entity> [String(name)|Jsonic(spec)] ...
+//   voxgig-system add fields <entity> [String(name)|Jsonic(spec)] ...
+//
+// String(name): the element name - an empty element is added.
+// Jsonic(spec): a jsonic definition of the element with config options.
+//
+// Run inside a project (or its backend/ folder); the model source files
+// 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...]
+
+  add entity [name|spec]           add an entity (name may be zone/name)
+  add srv    [name|spec]           add a service
+  add msg    [name|spec]           add a message (path: thing.save.item)
+  add field  <entity> [field...]   add field(s) to an entity
+  add fields <entity> [field...]   alias of add field
+
+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}}}'
+       add srv    '{name:thing,user:{required:false}}'
+       add msg    '{name:thing.save.item,params:{title:String}}'
+       add field  thing title 'done:Boolean' 'note:{kind:String,valid:Skip}'
+
+Run inside the project (or backend/) folder. Then: npm run model-build
+`;
+async function main() {
+    const argv = process.argv.slice(2);
+    if (0 === argv.length || argv.includes('-h') || argv.includes('--help')) {
+        console.log(USAGE);
+        process.exit(0 === argv.length ? 1 : 0);
+    }
+    const [cmd, element, ...args] = argv;
+    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');
+            const res = (0, add_1.addEntity)(start, args[0]);
+            report([res]);
+        }
+        else if ('srv' === element) {
+            requireArgs(args, 1, 'add srv');
+            const res = (0, add_1.addSrv)(start, args[0]);
+            report([res]);
+        }
+        else if ('msg' === element) {
+            requireArgs(args, 1, 'add msg');
+            const res = (0, add_1.addMsg)(start, args[0]);
+            report([res]);
+        }
+        else if ('field' === element || 'fields' === element) {
+            requireArgs(args, 2, 'add field');
+            const res = (0, add_1.addFields)(start, args[0], args.slice(1));
+            report(res);
+        }
+        else {
+            console.error('voxgig-system: unknown element: ' + element);
+            console.log(USAGE);
+            process.exit(1);
+        }
+        console.log('\nNow run: npm run model-build');
+    }
+    catch (e) {
+        console.error('voxgig-system: ' + e.message);
+        process.exit(1);
+    }
+}
+function requireArgs(args, n, what) {
+    if (args.length < n) {
+        throw new Error(what + ': missing argument(s)');
+    }
+}
+function report(results) {
+    for (const res of results) {
+        console.log('appended to ' + res.file + ':');
+        console.log(res.text);
+    }
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=cmd.js.map

package/dist/cmd.js.map

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

package/dist/lib/add.d.ts

@@ -0,0 +1,19 @@
+export type ModelFiles = {
+    folder: string;
+    model: string;
+    ent: string;
+    msg: string;
+    srv: string;
+};
+export type AddResult = {
+    file: string;
+    text: string;
+};
+declare function resolveModelFolder(start: string): string;
+declare function resolveModelFiles(start: string): ModelFiles;
+declare function fmt(val: any, depth: number): string;
+declare function addEntity(start: string, arg: string): AddResult;
+declare function addSrv(start: string, arg: string): AddResult;
+declare function addMsg(start: string, arg: string): AddResult;
+declare function addFields(start: string, entref: string, fieldargs: string[]): AddResult[];
+export { resolveModelFolder, resolveModelFiles, addEntity, addSrv, addMsg, addFields, fmt, };

package/dist/lib/add.js

@@ -0,0 +1,306 @@
+"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.resolveModelFolder = resolveModelFolder;
+exports.resolveModelFiles = resolveModelFiles;
+exports.addEntity = addEntity;
+exports.addSrv = addSrv;
+exports.addMsg = addMsg;
+exports.addFields = addFields;
+exports.fmt = fmt;
+// Add elements (entity, srv, msg, field) to a Voxgig system project by
+// appending jsonic blocks to the project's model source files. Appending
+// works because aontu unifies repeated paths, and it preserves the user's
+// existing formatting and comments.
+//
+// Each add* function takes either a String(name) - an empty element of
+// that name is added - or a Jsonic(spec) - a jsonic definition of the
+// element with config options.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const jsonic_next_1 = require("@jsonic/jsonic-next");
+// Values emitted bare (aontu type/token names); everything else is quoted.
+const BARE_TOKENS = ['String', 'Number', 'Boolean', 'Skip'];
+// Locate the model folder from a starting folder: <start>/model,
+// <start>/backend/model, or <start> itself if it holds model.jsonic.
+function resolveModelFolder(start) {
+    const candidates = [
+        start,
+        node_path_1.default.join(start, 'model'),
+        node_path_1.default.join(start, 'backend', 'model'),
+    ];
+    for (const c of candidates) {
+        if (node_fs_1.default.existsSync(node_path_1.default.join(c, 'model.jsonic'))) {
+            return c;
+        }
+    }
+    throw new Error('model folder not found (looked for model.jsonic in ' +
+        candidates.join(', ') + ')');
+}
+// Resolve the entity/message/service source files from the @"file" refs
+// in model.jsonic (main: ent: @"..."), falling back to conventional names.
+function resolveModelFiles(start) {
+    const folder = resolveModelFolder(start);
+    const model = node_path_1.default.join(folder, 'model.jsonic');
+    const src = node_fs_1.default.readFileSync(model, 'utf8');
+    const ref = (key, fallback) => {
+        const m = src.match(new RegExp('main:\\s*' + key + ':\\s*@"([^"]+)"'));
+        return node_path_1.default.join(folder, m ? m[1] : fallback);
+    };
+    return {
+        folder,
+        model,
+        ent: ref('ent', 'ent.jsonic'),
+        msg: ref('msg', 'msg.jsonic'),
+        srv: ref('srv', 'srv.jsonic'),
+    };
+}
+// Format a value as jsonic source. Objects use multiline path-free style;
+// known aontu tokens (String, Skip, ...) are emitted bare.
+function fmt(val, depth) {
+    const pad = '  '.repeat(depth);
+    const padIn = '  '.repeat(depth + 1);
+    if (null == val) {
+        return 'null';
+    }
+    else if ('string' === typeof val) {
+        return BARE_TOKENS.includes(val) ? val :
+            "'" + val.replace(/'/g, "\\'") + "'";
+    }
+    else if ('object' !== typeof val) {
+        return String(val);
+    }
+    else if (Array.isArray(val)) {
+        return '[' + val.map((v) => fmt(v, depth + 1)).join(', ') + ']';
+    }
+    const entries = Object.entries(val);
+    if (0 === entries.length) {
+        return '{}';
+    }
+    return '{\n' +
+        entries.map(([k, v]) => padIn + fmtKey(k) + ': ' + fmt(v, depth + 1))
+            .join('\n') +
+        '\n' + pad + '}';
+}
+function fmtKey(k) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(k) ? k :
+        "'" + k.replace(/'/g, "\\'") + "'";
+}
+function append(file, text) {
+    const existing = node_fs_1.default.readFileSync(file, 'utf8');
+    const sep = existing.endsWith('\n') ? '\n' : '\n\n';
+    node_fs_1.default.appendFileSync(file, sep + text + '\n');
+    return { file, text };
+}
+// Parse a name-or-spec argument. Returns { name, def } where def is the
+// element definition object ({} for the plain-name form).
+function parseArg(arg, kind) {
+    let parsed;
+    try {
+        parsed = (0, jsonic_next_1.Jsonic)(arg);
+    }
+    catch (e) {
+        throw new Error('invalid ' + kind + ' argument (jsonic parse failed): ' +
+            arg + ' - ' + e.message);
+    }
+    if ('string' === typeof parsed) {
+        return { name: parsed, def: {} };
+    }
+    if (null != parsed && 'object' === typeof parsed && !Array.isArray(parsed)) {
+        // { name: 'foo', ...def }
+        if ('string' === typeof parsed.name) {
+            const def = { ...parsed };
+            delete def.name;
+            return { name: parsed.name, def };
+        }
+        // { foo: {...def} } - single-key form
+        const keys = Object.keys(parsed);
+        if (1 === keys.length && 'object' === typeof parsed[keys[0]]) {
+            return { name: keys[0], def: parsed[keys[0]] };
+        }
+    }
+    throw new Error('invalid ' + kind + ' argument: ' + arg +
+        ' - provide a name, {name:...,...spec}, or {thename:{...spec}}');
+}
+// Default zone for entities: the single non-sys zone shape spread already
+// in the entity file (`<zone>: &: ...`), else 'app'.
+function defaultZone(entFile) {
+    const src = node_fs_1.default.readFileSync(entFile, 'utf8');
+    const zones = [...src.matchAll(/^([a-z][a-z0-9_]*):\s*&:/mg)]
+        .map((m) => m[1])
+        .filter((z) => 'sys' !== z);
+    const uniq = [...new Set(zones)];
+    return 1 === uniq.length ? uniq[0] : 'app';
+}
+// add entity [String(name)|Jsonic(spec)]
+// Names may be zone-qualified: app/thing. Spec: { name, zone?, ...def }.
+function addEntity(start, arg) {
+    const files = resolveModelFiles(start);
+    const { name: rawname, def } = parseArg(arg, 'entity');
+    let zone = def.zone;
+    delete def.zone;
+    let name = rawname;
+    if (rawname.includes('/')) {
+        const parts = rawname.split('/');
+        zone = parts[0];
+        name = parts[1];
+    }
+    zone = zone || defaultZone(files.ent);
+    if (null == def.field) {
+        def.field = {};
+    }
+    if (null == def.valid) {
+        def.valid = { '$$': 'Open' };
+    }
+    const src = node_fs_1.default.readFileSync(files.ent, 'utf8');
+    const shapeLine = new RegExp('^' + zone + ':\\s*&:', 'm').test(src) ? '' :
+        zone + ': &: $.main.shape.ent\n\n';
+    const text = '\n' + shapeLine +
+        zone + ': ' + name + ': ' + fmt(def, 0);
+    return append(files.ent, text);
+}
+// add srv [String(name)|Jsonic(spec)]
+// The plain-name form wires the service to its aim messages and a private
+// web area (matching the standard project scaffold).
+function addSrv(start, arg) {
+    const files = resolveModelFiles(start);
+    const { name, def } = parseArg(arg, 'srv');
+    if (null == def.in) {
+        def.in = {
+            aim: { [name]: {} },
+        };
+    }
+    if (null == def.user) {
+        def.user = { required: true };
+    }
+    if (null == def.api) {
+        def.api = { web: { path: { area: 'private/', suffix: '' } } };
+    }
+    if (null == def.env) {
+        def.env = { lambda: { active: true } };
+    }
+    const text = '\n' + name + ': ' + fmt(def, 0);
+    return append(files.srv, text);
+}
+// add msg [String(name)|Jsonic(spec)]
+// Name form: a message path like thing.save.item (or thing:save:item);
+// 'aim' is prepended if missing. Spec: { name: 'thing.save.item', ...meta }
+// where meta (params, transport, file, ...) lands under the '$' key.
+function addMsg(start, arg) {
+    const files = resolveModelFiles(start);
+    // A pure message path (thing.save.item, aim:thing:save:item) is taken
+    // as-is - jsonic would otherwise parse the colon form as a nested map.
+    const pathform = /^[a-z0-9_-]+([.:/][a-z0-9_-]+)+$/i.test(arg.trim());
+    let parsed;
+    try {
+        parsed = pathform ? arg.trim() : (0, jsonic_next_1.Jsonic)(arg);
+    }
+    catch (e) {
+        throw new Error('invalid msg argument (jsonic parse failed): ' +
+            arg + ' - ' + e.message);
+    }
+    let path;
+    let meta = {};
+    if ('string' === typeof parsed) {
+        path = parsed.split(/[.:/]/).filter((p) => '' !== p);
+    }
+    else if (null != parsed && 'string' === typeof parsed.name) {
+        path = parsed.name.split(/[.:/]/).filter((p) => '' !== p);
+        meta = { ...parsed };
+        delete meta.name;
+    }
+    else {
+        throw new Error('invalid msg argument: ' + arg +
+            " - provide a message path like thing.save.item, or {name:'path',...meta}");
+    }
+    if ('aim' !== path[0]) {
+        path.unshift('aim');
+    }
+    if (path.length < 2) {
+        throw new Error('invalid msg path: ' + path.join('.'));
+    }
+    const prefix = path.join(': ');
+    const text = 0 === Object.keys(meta).length ?
+        '\n' + prefix + ': {}' :
+        '\n' + prefix + ": '$': " + fmt(meta, 0);
+    return append(files.msg, text);
+}
+// add field <entity> [String(name)|Jsonic(spec)] ...
+// Field forms: title | title:String | title:{kind:String,valid:'Min(1)'}
+//            | {name:title,kind:String}
+// A label is derived from the name when not given.
+function addFields(start, entref, fieldargs) {
+    const files = resolveModelFiles(start);
+    let zone;
+    let name;
+    if (entref.includes('/')) {
+        [zone, name] = entref.split('/');
+    }
+    else {
+        zone = defaultZone(files.ent);
+        name = entref;
+    }
+    if (0 === fieldargs.length) {
+        throw new Error('no fields given');
+    }
+    const out = [];
+    for (const arg of fieldargs) {
+        let parsed;
+        try {
+            parsed = (0, jsonic_next_1.Jsonic)(arg);
+        }
+        catch (e) {
+            throw new Error('invalid field argument (jsonic parse failed): ' +
+                arg + ' - ' + e.message);
+        }
+        let fname;
+        let def;
+        if ('string' === typeof parsed) {
+            fname = parsed;
+            def = {};
+        }
+        else if (null != parsed && 'object' === typeof parsed) {
+            if ('string' === typeof parsed.name) {
+                fname = parsed.name;
+                def = { ...parsed };
+                delete def.name;
+            }
+            else {
+                const keys = Object.keys(parsed);
+                if (1 !== keys.length) {
+                    throw new Error('invalid field argument: ' + arg);
+                }
+                fname = keys[0];
+                const val = parsed[fname];
+                def = 'string' === typeof val ? { kind: val } : { ...val };
+            }
+        }
+        else {
+            throw new Error('invalid field argument: ' + arg);
+        }
+        if (null == def.kind) {
+            def.kind = 'String';
+        }
+        if (null == def.label) {
+            def.label = fname
+                .split('_')
+                .map((p) => '' === p ? p : p[0].toUpperCase() + p.substring(1))
+                .join(' ');
+        }
+        // Emit label before kind, matching scaffold convention.
+        const ordered = { label: def.label, kind: def.kind };
+        for (const k of Object.keys(def)) {
+            if ('label' !== k && 'kind' !== k) {
+                ordered[k] = def[k];
+            }
+        }
+        const text = '\n' + zone + ': ' + name + ': field: ' + fname + ': ' +
+            fmt(ordered, 0);
+        out.push(append(files.ent, text));
+    }
+    return out;
+}
+//# sourceMappingURL=add.js.map

package/dist/lib/add.js.map

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

package/dist/lib/utility.d.ts

@@ -4,6 +4,6 @@ declare function listmsgs(point?: Record<string, any>): Msg[];
 declare const Utility: {
     srvmsgs: typeof srvmsgs;
     listmsgs: typeof listmsgs;
-    deep: typeof import("@jsonic/jsonic-next/dist/utility").deep;
+    deep: (base?: any, ...rest: any[]) => any;
 };
 export { Utility };

package/dist/lib/utility.js.map

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

package/dist/srv/make.js.map

@@ -1 +1 @@
-{"version":3,"file":"make.js","sourceRoot":"","sources":["../../srv/make.ts"],"names":[],"mappings":";;AAgBE,0BAAO;AAfT,sCAAkC;AAElC,SAAS,OAAO,CAAC,IAAY,EAAE,OAAY;IACzC,MAAM,GAAG,GAAG,UAAoB,OAAY;QAC1C,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAA;QAChD,eAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACtC,eAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,CAAA;IAE5D,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"make.js","sourceRoot":"","sources":["../../srv/make.ts"],"names":[],"mappings":";;QAgBE,OAAO;AAfT,sCAAkC;AAElC,SAAS,OAAO,CAAC,IAAY,EAAE,OAAY;IACzC,MAAM,GAAG,GAAG,UAAoB,OAAY;QAC1C,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAA;QAChD,eAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACtC,eAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,CAAA;IAE5D,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/system.d.ts

@@ -1,6 +1,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';
 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;
@@ -18,4 +19,11 @@ declare const System: {
     prepare: typeof prepare;
 };
 export type { Msg };
-export { gubuify, System, MakeSrv, Utility, Local, Live, };
+declare const Add: {
+    entity: typeof addEntity;
+    srv: typeof addSrv;
+    msg: typeof addMsg;
+    fields: typeof addFields;
+    resolveModelFiles: typeof resolveModelFiles;
+};
+export { Add, 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 = void 0;
+exports.Utility = exports.MakeSrv = exports.System = exports.Add = void 0;
 exports.gubuify = gubuify;
 exports.Local = Local;
 exports.Live = Live;
@@ -14,6 +14,7 @@ const utility_1 = require("./lib/utility");
 Object.defineProperty(exports, "Utility", { enumerable: true, get: function () { return utility_1.Utility; } });
 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 { srvmsgs, deep } = utility_1.Utility;
 function messages(seneca, options, reload) {
     let srvname = seneca.fixedargs.plugin$.name.replace(/^srv_/, '');
@@ -35,11 +36,28 @@ function gubuify(params, Gubu) {
     if (null == params) {
         return params;
     }
+    return Gubu(gubuify_spec(params, Gubu));
+}
+// Convert model param values into a gubu spec. The '$$': 'Open' marker
+// (same convention as entity valid) makes an object open: additional
+// properties are allowed. Without it gubu objects are closed, which made
+// open message params inexpressible in the model. Nested specs stay raw
+// (builder results, not Gubu instances) so attributes like openness
+// compose into the parent shape.
+function gubuify_spec(params, Gubu) {
+    if (null == params) {
+        return params;
+    }
+    let open = false;
+    if ('Open' === params['$$']) {
+        open = true;
+        delete params['$$'];
+    }
     for (let pn in params) {
         let m = null;
         let pv = params[pn];
         if ('object' === typeof pv) {
-            params[pn] = gubuify(pv, Gubu);
+            params[pn] = gubuify_spec(pv, Gubu);
         }
         else if ('string' === typeof pv &&
             -1 === pn.indexOf(':') && ('function' === typeof Gubu[(m = ((pv.match(/\s*([A-Z]\w+)([(.\s]|$)/) || []))[1])] ||
@@ -48,11 +66,8 @@ function gubuify(params, Gubu) {
             params[png] = pv;
             delete params[pn];
         }
-        else {
-            params[pn] = Gubu(pv);
-        }
     }
-    return Gubu(params);
+    return open ? Gubu.Open(params) : params;
 }
 function actpath(msg) {
     if (msg.meta.file) {
@@ -132,4 +147,12 @@ const System = {
     prepare,
 };
 exports.System = System;
+const Add = {
+    entity: add_1.addEntity,
+    srv: add_1.addSrv,
+    msg: add_1.addMsg,
+    fields: add_1.addFields,
+    resolveModelFiles: add_1.resolveModelFiles,
+};
+exports.Add = Add;
 //# 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/add.ts

@@ -0,0 +1,381 @@
+/* Copyright © 2026 Voxgig Ltd, MIT License. */
+
+// Add elements (entity, srv, msg, field) to a Voxgig system project by
+// appending jsonic blocks to the project's model source files. Appending
+// works because aontu unifies repeated paths, and it preserves the user's
+// existing formatting and comments.
+//
+// Each add* function takes either a String(name) - an empty element of
+// that name is added - or a Jsonic(spec) - a jsonic definition of the
+// element with config options.
+
+import Fs from 'node:fs'
+import Path from 'node:path'
+
+import { Jsonic } from '@jsonic/jsonic-next'
+
+
+// Values emitted bare (aontu type/token names); everything else is quoted.
+const BARE_TOKENS = ['String', 'Number', 'Boolean', 'Skip']
+
+
+export type ModelFiles = {
+  folder: string       // the model folder
+  model: string        // model.jsonic path
+  ent: string          // entity file path
+  msg: string          // message file path
+  srv: string          // service file path
+}
+
+export type AddResult = {
+  file: string         // file appended to
+  text: string         // the appended block
+}
+
+
+// Locate the model folder from a starting folder: <start>/model,
+// <start>/backend/model, or <start> itself if it holds model.jsonic.
+function resolveModelFolder(start: string): string {
+  const candidates = [
+    start,
+    Path.join(start, 'model'),
+    Path.join(start, 'backend', 'model'),
+  ]
+  for (const c of candidates) {
+    if (Fs.existsSync(Path.join(c, 'model.jsonic'))) {
+      return c
+    }
+  }
+  throw new Error('model folder not found (looked for model.jsonic in ' +
+    candidates.join(', ') + ')')
+}
+
+
+// Resolve the entity/message/service source files from the @"file" refs
+// in model.jsonic (main: ent: @"..."), falling back to conventional names.
+function resolveModelFiles(start: string): ModelFiles {
+  const folder = resolveModelFolder(start)
+  const model = Path.join(folder, 'model.jsonic')
+  const src = Fs.readFileSync(model, 'utf8')
+
+  const ref = (key: string, fallback: string) => {
+    const m = src.match(
+      new RegExp('main:\\s*' + key + ':\\s*@"([^"]+)"'))
+    return Path.join(folder, m ? m[1] : fallback)
+  }
+
+  return {
+    folder,
+    model,
+    ent: ref('ent', 'ent.jsonic'),
+    msg: ref('msg', 'msg.jsonic'),
+    srv: ref('srv', 'srv.jsonic'),
+  }
+}
+
+
+// Format a value as jsonic source. Objects use multiline path-free style;
+// known aontu tokens (String, Skip, ...) are emitted bare.
+function fmt(val: any, depth: number): string {
+  const pad = '  '.repeat(depth)
+  const padIn = '  '.repeat(depth + 1)
+
+  if (null == val) {
+    return 'null'
+  }
+  else if ('string' === typeof val) {
+    return BARE_TOKENS.includes(val) ? val :
+      "'" + val.replace(/'/g, "\\'") + "'"
+  }
+  else if ('object' !== typeof val) {
+    return String(val)
+  }
+  else if (Array.isArray(val)) {
+    return '[' + val.map((v) => fmt(v, depth + 1)).join(', ') + ']'
+  }
+
+  const entries = Object.entries(val)
+  if (0 === entries.length) {
+    return '{}'
+  }
+
+  return '{\n' +
+    entries.map(([k, v]) => padIn + fmtKey(k) + ': ' + fmt(v, depth + 1))
+      .join('\n') +
+    '\n' + pad + '}'
+}
+
+function fmtKey(k: string): string {
+  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(k) ? k :
+    "'" + k.replace(/'/g, "\\'") + "'"
+}
+
+
+function append(file: string, text: string): AddResult {
+  const existing = Fs.readFileSync(file, 'utf8')
+  const sep = existing.endsWith('\n') ? '\n' : '\n\n'
+  Fs.appendFileSync(file, sep + text + '\n')
+  return { file, text }
+}
+
+
+// Parse a name-or-spec argument. Returns { name, def } where def is the
+// element definition object ({} for the plain-name form).
+function parseArg(arg: string, kind: string): { name: string, def: any } {
+  let parsed: any
+  try {
+    parsed = Jsonic(arg)
+  }
+  catch (e: any) {
+    throw new Error('invalid ' + kind + ' argument (jsonic parse failed): ' +
+      arg + ' - ' + e.message)
+  }
+
+  if ('string' === typeof parsed) {
+    return { name: parsed, def: {} }
+  }
+
+  if (null != parsed && 'object' === typeof parsed && !Array.isArray(parsed)) {
+    // { name: 'foo', ...def }
+    if ('string' === typeof parsed.name) {
+      const def = { ...parsed }
+      delete def.name
+      return { name: parsed.name, def }
+    }
+
+    // { foo: {...def} } - single-key form
+    const keys = Object.keys(parsed)
+    if (1 === keys.length && 'object' === typeof parsed[keys[0]]) {
+      return { name: keys[0], def: parsed[keys[0]] }
+    }
+  }
+
+  throw new Error('invalid ' + kind + ' argument: ' + arg +
+    ' - provide a name, {name:...,...spec}, or {thename:{...spec}}')
+}
+
+
+// Default zone for entities: the single non-sys zone shape spread already
+// in the entity file (`<zone>: &: ...`), else 'app'.
+function defaultZone(entFile: string): string {
+  const src = Fs.readFileSync(entFile, 'utf8')
+  const zones = [...src.matchAll(/^([a-z][a-z0-9_]*):\s*&:/mg)]
+    .map((m) => m[1])
+    .filter((z) => 'sys' !== z)
+  const uniq = [...new Set(zones)]
+  return 1 === uniq.length ? uniq[0] : 'app'
+}
+
+
+// add entity [String(name)|Jsonic(spec)]
+// Names may be zone-qualified: app/thing. Spec: { name, zone?, ...def }.
+function addEntity(start: string, arg: string): AddResult {
+  const files = resolveModelFiles(start)
+  const { name: rawname, def } = parseArg(arg, 'entity')
+
+  let zone = def.zone
+  delete def.zone
+  let name = rawname
+  if (rawname.includes('/')) {
+    const parts = rawname.split('/')
+    zone = parts[0]
+    name = parts[1]
+  }
+  zone = zone || defaultZone(files.ent)
+
+  if (null == def.field) {
+    def.field = {}
+  }
+  if (null == def.valid) {
+    def.valid = { '$$': 'Open' }
+  }
+
+  const src = Fs.readFileSync(files.ent, 'utf8')
+  const shapeLine = new RegExp('^' + zone + ':\\s*&:', 'm').test(src) ? '' :
+    zone + ': &: $.main.shape.ent\n\n'
+
+  const text = '\n' + shapeLine +
+    zone + ': ' + name + ': ' + fmt(def, 0)
+
+  return append(files.ent, text)
+}
+
+
+// add srv [String(name)|Jsonic(spec)]
+// The plain-name form wires the service to its aim messages and a private
+// web area (matching the standard project scaffold).
+function addSrv(start: string, arg: string): AddResult {
+  const files = resolveModelFiles(start)
+  const { name, def } = parseArg(arg, 'srv')
+
+  if (null == def.in) {
+    def.in = {
+      aim: { [name]: {} },
+    }
+  }
+  if (null == def.user) {
+    def.user = { required: true }
+  }
+  if (null == def.api) {
+    def.api = { web: { path: { area: 'private/', suffix: '' } } }
+  }
+  if (null == def.env) {
+    def.env = { lambda: { active: true } }
+  }
+
+  const text = '\n' + name + ': ' + fmt(def, 0)
+
+  return append(files.srv, text)
+}
+
+
+// add msg [String(name)|Jsonic(spec)]
+// Name form: a message path like thing.save.item (or thing:save:item);
+// 'aim' is prepended if missing. Spec: { name: 'thing.save.item', ...meta }
+// where meta (params, transport, file, ...) lands under the '$' key.
+function addMsg(start: string, arg: string): AddResult {
+  const files = resolveModelFiles(start)
+
+  // A pure message path (thing.save.item, aim:thing:save:item) is taken
+  // as-is - jsonic would otherwise parse the colon form as a nested map.
+  const pathform = /^[a-z0-9_-]+([.:/][a-z0-9_-]+)+$/i.test(arg.trim())
+
+  let parsed: any
+  try {
+    parsed = pathform ? arg.trim() : Jsonic(arg)
+  }
+  catch (e: any) {
+    throw new Error('invalid msg argument (jsonic parse failed): ' +
+      arg + ' - ' + e.message)
+  }
+
+  let path: string[]
+  let meta: any = {}
+
+  if ('string' === typeof parsed) {
+    path = parsed.split(/[.:/]/).filter((p) => '' !== p)
+  }
+  else if (null != parsed && 'string' === typeof parsed.name) {
+    path = parsed.name.split(/[.:/]/).filter((p: string) => '' !== p)
+    meta = { ...parsed }
+    delete meta.name
+  }
+  else {
+    throw new Error('invalid msg argument: ' + arg +
+    " - provide a message path like thing.save.item, or {name:'path',...meta}")
+  }
+
+  if ('aim' !== path[0]) {
+    path.unshift('aim')
+  }
+  if (path.length < 2) {
+    throw new Error('invalid msg path: ' + path.join('.'))
+  }
+
+  const prefix = path.join(': ')
+  const text = 0 === Object.keys(meta).length ?
+    '\n' + prefix + ': {}' :
+    '\n' + prefix + ": '$': " + fmt(meta, 0)
+
+  return append(files.msg, text)
+}
+
+
+// add field <entity> [String(name)|Jsonic(spec)] ...
+// Field forms: title | title:String | title:{kind:String,valid:'Min(1)'}
+//            | {name:title,kind:String}
+// A label is derived from the name when not given.
+function addFields(start: string, entref: string, fieldargs: string[])
+  : AddResult[] {
+  const files = resolveModelFiles(start)
+
+  let zone: string
+  let name: string
+  if (entref.includes('/')) {
+    [zone, name] = entref.split('/')
+  }
+  else {
+    zone = defaultZone(files.ent)
+    name = entref
+  }
+
+  if (0 === fieldargs.length) {
+    throw new Error('no fields given')
+  }
+
+  const out: AddResult[] = []
+
+  for (const arg of fieldargs) {
+    let parsed: any
+    try {
+      parsed = Jsonic(arg)
+    }
+    catch (e: any) {
+      throw new Error('invalid field argument (jsonic parse failed): ' +
+        arg + ' - ' + e.message)
+    }
+
+    let fname: string
+    let def: any
+
+    if ('string' === typeof parsed) {
+      fname = parsed
+      def = {}
+    }
+    else if (null != parsed && 'object' === typeof parsed) {
+      if ('string' === typeof parsed.name) {
+        fname = parsed.name
+        def = { ...parsed }
+        delete def.name
+      }
+      else {
+        const keys = Object.keys(parsed)
+        if (1 !== keys.length) {
+          throw new Error('invalid field argument: ' + arg)
+        }
+        fname = keys[0]
+        const val = parsed[fname]
+        def = 'string' === typeof val ? { kind: val } : { ...val }
+      }
+    }
+    else {
+      throw new Error('invalid field argument: ' + arg)
+    }
+
+    if (null == def.kind) {
+      def.kind = 'String'
+    }
+    if (null == def.label) {
+      def.label = fname
+        .split('_')
+        .map((p: string) => '' === p ? p : p[0].toUpperCase() + p.substring(1))
+        .join(' ')
+    }
+
+    // Emit label before kind, matching scaffold convention.
+    const ordered: any = { label: def.label, kind: def.kind }
+    for (const k of Object.keys(def)) {
+      if ('label' !== k && 'kind' !== k) {
+        ordered[k] = def[k]
+      }
+    }
+
+    const text = '\n' + zone + ': ' + name + ': field: ' + fname + ': ' +
+      fmt(ordered, 0)
+
+    out.push(append(files.ent, text))
+  }
+
+  return out
+}
+
+
+export {
+  resolveModelFolder,
+  resolveModelFiles,
+  addEntity,
+  addSrv,
+  addMsg,
+  addFields,
+  fmt,
+}

package/lib/utility.ts

@@ -76,7 +76,7 @@ function walkmsgs(
 const Utility = {
   srvmsgs,
   listmsgs,
-  deep: util.deep,
+  deep: util.deep as (base?: any, ...rest: any[]) => any,
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/system",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "main": "dist/system.js",
   "type": "commonjs",
   "types": "dist/system.d.ts",
@@ -25,29 +25,40 @@
     "reset": "npm run clean && npm i && npm run build && npm test",
     "repo-tag": "REPO_VERSION=`node -e \"console.log(require('./package').version)\"` && echo TAG: v$REPO_VERSION && git commit -a -m v$REPO_VERSION && git push && git tag v$REPO_VERSION && git push --tags;",
     "repo-publish": "npm run clean && npm i && npm run repo-publish-quick",
-    "repo-publish-quick": "npm run build && npm run test && npm run repo-tag && npm publish --registry https://registry.npmjs.org --access=public"
+    "repo-publish-quick": "npm run build && npm run test && npm run repo-tag && npm run repo-stage-publish",
+    "repo-stage-publish": "aql vault exec --for=npm vxg:pub01 -- npm stage publish --registry https://registry.npmjs.org --access=public",
+    "repo-stage-publish-dry": "aql vault exec --dry-run --for=npm vxg:pub01 -- npm stage publish --registry https://registry.npmjs.org --access=public --dry-run",
+    "repo-stage-list": "aql vault exec --for=npm vxg:pub01 -- npm stage list",
+    "repo-stage-view": "aql vault exec --for=npm vxg:pub01 -- npm stage view",
+    "repo-stage-approve": "aql vault exec --for=npm vxg:pub01 -- npm stage approve",
+    "repo-stage-reject": "aql vault exec --for=npm vxg:pub01 -- npm stage reject"
   },
   "license": "MIT",
   "files": [
     "system.ts",
+    "cmd.ts",
     "lib",
     "srv",
     "dist",
     "LICENSE"
   ],
   "devDependencies": {
-    "@types/jest": "^29.5.12",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.20.1",
     "es-jest": "^2.1.0",
-    "esbuild": "^0.23.0",
-    "gubu": "^8.0.2",
-    "jest": "^29.7.0",
-    "typescript": "^5.5.3"
+    "esbuild": "^0.28.1",
+    "gubu": "^9.0.0",
+    "jest": "^30.4.2",
+    "typescript": "^7.0.2"
   },
   "peerDependencies": {
     "@voxgig/model": ">=2"
   },
   "dependencies": {
-    "@jsonic/jsonic-next": "^2.12.1",
-    "patrun": "^7.2.5"
+    "@jsonic/jsonic-next": "^2.14.0",
+    "patrun": "^7.3.0"
+  },
+  "bin": {
+    "voxgig-system": "dist/cmd.js"
   }
 }

package/system.ts

@@ -13,6 +13,8 @@ import { Utility } from './lib/utility'
 
 import { MakeSrv } from './srv/make'
 
+import { addEntity, addSrv, addMsg, addFields, resolveModelFiles } from './lib/add'
+
 
 
 const { srvmsgs, deep } = Utility
@@ -45,12 +47,32 @@ function gubuify(params: any, Gubu: any) {
   if (null == params) {
     return params
   }
+  return Gubu(gubuify_spec(params, Gubu))
+}
+
+
+// Convert model param values into a gubu spec. The '$$': 'Open' marker
+// (same convention as entity valid) makes an object open: additional
+// properties are allowed. Without it gubu objects are closed, which made
+// open message params inexpressible in the model. Nested specs stay raw
+// (builder results, not Gubu instances) so attributes like openness
+// compose into the parent shape.
+function gubuify_spec(params: any, Gubu: any): any {
+  if (null == params) {
+    return params
+  }
+
+  let open = false
+  if ('Open' === params['$$']) {
+    open = true
+    delete params['$$']
+  }
 
   for (let pn in params) {
     let m = null
     let pv = params[pn]
     if ('object' === typeof pv) {
-      params[pn] = gubuify(pv, Gubu)
+      params[pn] = gubuify_spec(pv, Gubu)
     }
     else if (
       'string' === typeof pv &&
@@ -63,11 +85,8 @@ function gubuify(params: any, Gubu: any) {
       params[png] = pv
       delete params[pn]
     }
-    else {
-      params[pn] = Gubu(pv)
-    }
   }
-  return Gubu(params)
+  return open ? Gubu.Open(params) : params
 }
 
 
@@ -197,7 +216,16 @@ export type {
   Msg
 }
 
+const Add = {
+  entity: addEntity,
+  srv: addSrv,
+  msg: addMsg,
+  fields: addFields,
+  resolveModelFiles,
+}
+
 export {
+  Add,
   gubuify,
   System,
   MakeSrv,