@hozu/cli 0.21.1 → 0.23.0

package/dist/gen/go.js

@@ -0,0 +1,443 @@
+import { canonicalStringify } from '@hozu/core/ir';
+const pascal = (text) => {
+    const name = text
+        .replace(/(^|[^A-Za-z0-9])([A-Za-z0-9])/g, (_, __, c) => c.toUpperCase())
+        .replace(/[^A-Za-z0-9]/g, '');
+    return /^[0-9]/.test(name) ? `X${name}` : name || 'X';
+};
+const methodOf = (ref) => ref.split('.').map(pascal).join('');
+const isRef = (t) => /^(\[\]|map\[|\*|json\.)/.test(t);
+/** Columns padded the way gofmt aligns consecutive struct fields. */
+const aligned = (rows) => {
+    const widths = [];
+    for (const row of rows)
+        row.slice(0, -1).forEach((cell, i) => (widths[i] = Math.max(widths[i] ?? 0, cell.length)));
+    return rows.map((row) => `\t${row.map((cell, i) => (i < row.length - 1 ? cell.padEnd(widths[i]) : cell)).join(' ')}`.trimEnd());
+};
+const render = (s) => {
+    if (s.members)
+        return `type ${s.name} string\n\nconst (\n${aligned(s.members.map(([name, value]) => [name, s.name, `= ${value}`])).join('\n')}\n)`;
+    return s.fields.length
+        ? `type ${s.name} struct {\n${aligned(s.fields).join('\n')}\n}`
+        : `type ${s.name} struct{}`;
+};
+class Types {
+    structs = [];
+    #byShape = new Map();
+    #names = new Set();
+    constructor(reserved) {
+        for (const r of reserved)
+            this.#names.add(r);
+    }
+    /** The Go type of a schema; `name` is used when it needs a new struct and has no `title`. */
+    type(schema, name, root = schema) {
+        const ref = schema.$ref;
+        if (typeof ref === 'string') {
+            const key = ref.replace(/^#\/\$defs\//, '');
+            const def = root.$defs?.[key];
+            return def ? this.type(def, pascal(key), root) : 'json.RawMessage';
+        }
+        const any = (schema.anyOf ?? schema.oneOf);
+        if (any) {
+            const rest = any.filter((s) => s.type !== 'null');
+            if (rest.length === 1) {
+                const t = this.type(rest[0], name, root);
+                return rest.length < any.length && !isRef(t) ? `*${t}` : t;
+            }
+            return 'json.RawMessage';
+        }
+        const values = (schema.enum ?? (schema.const !== undefined ? [schema.const] : null));
+        if (schema.enum && values?.every((v) => typeof v === 'string'))
+            return this.#enum(values, typeof schema.title === 'string' ? pascal(schema.title) : name);
+        if (values)
+            return values.every((v) => typeof v === 'string') ? 'string' : 'json.RawMessage';
+        const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+        const nullable = types.includes('null');
+        const base = this.#base(types.find((t) => t !== 'null'), schema, name, root);
+        return nullable && !isRef(base) ? `*${base}` : base;
+    }
+    #base(type, schema, name, root) {
+        switch (type) {
+            case 'string':
+                return 'string';
+            case 'boolean':
+                return 'bool';
+            case 'integer':
+                return 'int64';
+            case 'number':
+                return 'float64';
+            case 'array':
+                return schema.items
+                    ? `[]${this.type(schema.items, `${name}Item`, root)}`
+                    : '[]json.RawMessage';
+            case 'object': {
+                const props = schema.properties;
+                const extra = schema.additionalProperties;
+                if (!props && extra && typeof extra === 'object')
+                    return `map[string]${this.type(extra, `${name}Value`, root)}`;
+                return this.struct(schema, name, root);
+            }
+            default:
+                return 'json.RawMessage';
+        }
+    }
+    struct(schema, name, root = schema, fixed = false) {
+        const { title, description: _, ...shape } = schema;
+        const props = Object.entries(schema.properties ?? {});
+        if (!fixed && !props.length)
+            return this.#empty();
+        if (!fixed && typeof title === 'string')
+            return this.#named(pascal(title), () => this.#fields(schema, pascal(title), root), canonicalStringify(shape));
+        return this.#add(name, (unique) => this.#fields(schema, unique, root));
+    }
+    #enum(values, name) {
+        return this.#named(name, () => [], JSON.stringify(values), (unique) => {
+            const used = new Set();
+            return values.map((v) => {
+                let constant = `${unique}${pascal(v)}`;
+                for (let n = 2; used.has(constant) || this.#names.has(constant); n++)
+                    constant = `${unique}${pascal(v)}${n}`;
+                used.add(constant);
+                this.#names.add(constant);
+                return [constant, JSON.stringify(v)];
+            });
+        });
+    }
+    #empty() {
+        if (!this.structs.some((s) => s.name === 'Empty'))
+            this.structs.push({ name: 'Empty', fields: [] });
+        return 'Empty';
+    }
+    /** A titled shape is one Go type wherever it appears; the same title with another shape gets a number. */
+    #named(name, fields, shape = '{}', members) {
+        const key = `${name} ${shape}`;
+        const known = this.#byShape.get(key);
+        if (known)
+            return known;
+        const unique = this.#add(name, () => fields(), members);
+        this.#byShape.set(key, unique);
+        return unique;
+    }
+    #add(wanted, fields, members) {
+        let unique = wanted;
+        for (let n = 2; this.#names.has(unique); n++)
+            unique = `${wanted}${n}`;
+        this.#names.add(unique);
+        const struct = { name: unique, fields: [] };
+        this.structs.push(struct);
+        if (members)
+            struct.members = members(unique);
+        else
+            struct.fields = fields(unique);
+        return unique;
+    }
+    #fields(schema, owner, root) {
+        const required = new Set(schema.required ?? []);
+        return Object.entries(schema.properties ?? {}).map(([prop, s]) => {
+            const t = this.type(s, `${owner}${pascal(prop)}`, root);
+            const optional = !required.has(prop);
+            const values = (s.enum ?? null);
+            const named = values?.every((v) => typeof v === 'string');
+            return [
+                pascal(prop),
+                `${optional && !isRef(t) ? '*' : ''}${t}`,
+                `\`json:"${prop}${optional ? ',omitempty' : ''}"\``,
+                ...(values && !named ? [`// one of ${values.map((v) => JSON.stringify(v)).join(', ')}`] : []),
+            ];
+        });
+    }
+}
+const describe = (e, errors) => {
+    const parts = [
+        `${e.ref} (${e.kind}${e.session ? ', with the session' : ', no session: public data'})`,
+        ...(errors.length ? [`errors: ${errors.join(', ')}`] : []),
+        ...(e.invalid ? ['may return Invalid'] : []),
+    ];
+    return `\t// ${parts.join('; ')}`;
+};
+/** The Go contract of one `remote()` group: types, the Resolvers interface and the HTTP handler (ADR 0068). */
+const tidy = (go) => go.replace(/\n{3,}/g, '\n\n');
+export function goContract(contract, pkg) {
+    const types = new Types([
+        'Invalid',
+        'Ctx',
+        'Options',
+        'Resolvers',
+        'Handler',
+        'Fingerprint',
+        'Empty',
+        'Upload',
+        'Forbidden',
+    ]);
+    const session = contract.session ? types.struct(contract.session, 'Session', contract.session, true) : null;
+    const errorTypes = [];
+    const methods = contract.effects.map((e) => {
+        const base = methodOf(e.ref);
+        const input = types.type(e.input, `${base}Input`);
+        const output = types.type(e.output, `${base}Output`);
+        const errors = Object.entries(e.errors).map(([name, schema]) => {
+            const type = types.struct(schema, `${base}${pascal(name)}`, schema, true);
+            errorTypes.push(`func (e ${type}) Error() string { return "${e.ref}: ${name}" }\nfunc (e ${type}) failure() (string, string, any) {\n\treturn "${e.ref}", "${name}", e\n}`);
+            return type;
+        });
+        return { e, base, input, output, errors };
+    });
+    const sessionType = session ?? 'struct{}';
+    return tidy(`// Code generated by hozu gen from the Hozu declarations. DO NOT EDIT.
+// Change the declarations in TypeScript, then run hozu gen (ADR 0068).
+
+package ${pkg}
+
+import (
+\t"context"
+\t"crypto/subtle"
+\t"encoding/json"
+\t"errors"
+\t"log"
+\t"net/http"
+\t"reflect"
+\t"strings"
+)
+
+// Fingerprint is the contract of one effect this file was generated from, or "" for another effect. Every call
+// carries its effect's, so changing one declaration answers 409 for that effect alone.
+func Fingerprint(effect string) string {
+\tswitch effect {
+${contract.effects.map((e) => `\tcase "${e.ref}":\n\t\treturn "${e.fingerprint}"`).join('\n')}
+\t}
+\treturn ""
+}
+
+${types.structs.map(render).join('\n\n')}
+
+${errorTypes.join('\n\n')}
+
+// Invalid is the framework error of mutations and endpoints: a message and one message per input field.
+type Invalid struct {
+\tMessage string            \`json:"message"\`
+\tFields  map[string]string \`json:"fields"\`
+}
+
+func (e Invalid) Error() string                  { return "Invalid: " + e.Message }
+func (e Invalid) failure() (string, string, any) { return "", "Invalid", e }
+
+// Forbidden answers as access does when the visitor may not have it (user-scoped queries and mutations).
+type Forbidden struct {
+\tMessage string \`json:"message,omitempty"\`
+}
+
+func (e Forbidden) Error() string                  { return "Forbidden: " + e.Message }
+func (e Forbidden) failure() (string, string, any) { return "", "Forbidden", e }
+
+// Ctx is one call. Session is nil when the visitor is signed out or the effect reads no session. Preview is
+// true in preview mode; Header holds an endpoint's request headers (no cookie).
+type Ctx struct {
+\tContext context.Context
+\tSession *${sessionType}
+\tPreview bool
+\tHeader  http.Header
+\tfiles   map[string]Upload
+\tchanged bool
+\tnext    *${sessionType}
+}
+
+// Upload is a file a form sent with the call; Data holds its bytes.
+type Upload struct {
+\tName string \`json:"name"\`
+\tType string \`json:"type"\`
+\tSize int64  \`json:"size"\`
+\tData []byte \`json:"data"\`
+}
+
+// File returns the upload a form field's token names, or nil (mutations and endpoints only).
+func (c *Ctx) File(token string) *Upload {
+\tif f, ok := c.files[token]; ok {
+\t\treturn &f
+\t}
+\treturn nil
+}
+
+// SetSession signs the visitor in as s (mutations and endpoints only).
+func (c *Ctx) SetSession(s ${sessionType}) { c.changed, c.next = true, &s }
+
+// SignOut ends the visitor's session (mutations and endpoints only).
+func (c *Ctx) SignOut() { c.changed, c.next = true, nil }
+
+// Resolvers implements the effects that app.ts lists in remote(). Return a declared error as the error value.
+type Resolvers interface {
+${methods.map((m) => `${describe(m.e, m.errors)}\n\t${m.base}(ctx *Ctx, in ${m.input}) (${m.output}, error)`).join('\n')}
+}
+
+// Options configures Handler. Secret (16 characters or more) must equal the x-hozu-secret header of every call:
+// the handler trusts the session a call carries, so it answers only the Hozu server.
+type Options struct {
+\tSecret string
+}
+
+type failure interface {
+\terror
+\tfailure() (effect string, name string, data any)
+}
+
+type request struct {
+${aligned([
+        ['Effect', 'string', '`json:"effect"`'],
+        ['Input', 'json.RawMessage', '`json:"input"`'],
+        ['Session', `*${sessionType}`, '`json:"session"`'],
+        ['Preview', 'bool', '`json:"preview"`'],
+        ['Headers', 'map[string]string', '`json:"headers"`'],
+        ['Files', 'map[string]Upload', '`json:"files"`'],
+    ]).join('\n')}
+}
+
+func call[I any, O any](ctx *Ctx, raw json.RawMessage, f func(*Ctx, I) (O, error)) (any, error) {
+\tvar in I
+\tif err := json.Unmarshal(raw, &in); err != nil {
+\t\treturn nil, err
+\t}
+\tout, err := f(ctx, in)
+\treturn filled(out), err
+}
+
+// filled replaces nil slices and maps with empty ones, so a list answers [] and never null.
+func filled(v any) any {
+\trv := reflect.New(reflect.TypeOf(v)).Elem()
+\trv.Set(reflect.ValueOf(v))
+\tfill(rv)
+\treturn rv.Interface()
+}
+
+func fill(v reflect.Value) {
+\tswitch v.Kind() {
+\tcase reflect.Slice:
+\t\tif v.IsNil() && v.CanSet() {
+\t\t\tv.Set(reflect.MakeSlice(v.Type(), 0, 0))
+\t\t}
+\t\tfor i := 0; i < v.Len(); i++ {
+\t\t\tfill(v.Index(i))
+\t\t}
+\tcase reflect.Map:
+\t\tif v.IsNil() && v.CanSet() {
+\t\t\tv.Set(reflect.MakeMap(v.Type()))
+\t\t}
+\tcase reflect.Pointer:
+\t\tif !v.IsNil() {
+\t\t\tfill(v.Elem())
+\t\t}
+\tcase reflect.Struct:
+\t\tfor i := 0; i < v.NumField(); i++ {
+\t\t\tif v.Type().Field(i).IsExported() {
+\t\t\t\tfill(v.Field(i))
+\t\t\t}
+\t\t}
+\t}
+}
+
+// Handler answers the calls of the Hozu server: POST { effect, input, session } → { ok } | { fail } (+ session).
+func Handler(r Resolvers, o Options) http.Handler {
+\tif len(o.Secret) < 16 {
+\t\tpanic("hozu: Options.Secret must hold the 16 or more characters of the app's remote() secret")
+\t}
+\treturn http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
+\t\tif req.Method != http.MethodPost {
+\t\t\thttp.Error(w, "POST only", http.StatusMethodNotAllowed)
+\t\t\treturn
+\t\t}
+\t\tif subtle.ConstantTimeCompare([]byte(req.Header.Get("X-Hozu-Secret")), []byte(o.Secret)) != 1 {
+\t\t\thttp.Error(w, "wrong x-hozu-secret", http.StatusUnauthorized)
+\t\t\treturn
+\t\t}
+\t\tvar body request
+\t\tif err := json.NewDecoder(req.Body).Decode(&body); err != nil {
+\t\t\thttp.Error(w, err.Error(), http.StatusBadRequest)
+\t\t\treturn
+\t\t}
+\t\twant := Fingerprint(body.Effect)
+\t\tif want == "" {
+\t\t\thttp.Error(w, "unknown effect "+body.Effect, http.StatusNotFound)
+\t\t\treturn
+\t\t}
+\t\tif got := req.Header.Get("X-Hozu-Fingerprint"); got != want {
+\t\t\thttp.Error(w, body.Effect+" is "+want+" here, not "+got+": run hozu gen and rebuild", http.StatusConflict)
+\t\t\treturn
+\t\t}
+\t\tid := req.Header.Get("X-Hozu-Call")
+\t\tctx := &Ctx{Context: req.Context(), Session: body.Session, Preview: body.Preview, Header: http.Header{}, files: body.Files}
+\t\tfor k, v := range body.Headers {
+\t\t\tctx.Header.Set(k, v)
+\t\t}
+\t\tvar out any
+\t\tvar err error
+\t\tswitch body.Effect {
+${methods.map((m) => `\t\tcase "${m.e.ref}":\n\t\t\tout, err = call(ctx, body.Input, r.${m.base})`).join('\n')}
+\t\t}
+\t\tres := map[string]any{}
+\t\tvar f failure
+\t\tswitch {
+\t\tcase err == nil:
+\t\t\tres["ok"] = out
+\t\tcase errors.As(err, &f):
+\t\t\teffect, name, data := f.failure()
+\t\t\tif effect != "" && effect != body.Effect {
+\t\t\t\tlog.Printf("hozu: %s (call %s) returned %s, an error of %s", body.Effect, id, name, effect)
+\t\t\t\thttp.Error(w, "resolver failed: "+name+" is an error of "+effect, http.StatusInternalServerError)
+\t\t\t\treturn
+\t\t\t}
+\t\t\tres["fail"] = map[string]any{"name": name, "data": data}
+\t\tdefault:
+\t\t\tlog.Printf("hozu: %s (call %s): %v", body.Effect, id, err)
+\t\t\tline, _, _ := strings.Cut(err.Error(), "\\n")
+\t\t\thttp.Error(w, "resolver failed: "+line, http.StatusInternalServerError)
+\t\t\treturn
+\t\t}
+\t\tif ctx.changed {
+\t\t\tres["session"] = ctx.next
+\t\t}
+\t\tw.Header().Set("Content-Type", "application/json")
+\t\tif err := json.NewEncoder(w).Encode(res); err != nil {
+\t\t\tlog.Printf("hozu: %s (call %s): %v", body.Effect, id, err)
+\t\t}
+\t})
+}
+`);
+}
+/** The fingerprint of each effect a generated Go contract declares, by ref. */
+export const goFingerprints = (text) => Object.fromEntries([...text.matchAll(/^\tcase "([^"]+)":\n\t\treturn "([0-9a-f]+)"$/gm)].map((m) => [m[1], m[2]]));
+const counted = /^(id|count|qty|quantity|cents)$|(Id|_id|ID|Count|_count|Qty|Quantity|Cents|_cents)$/;
+/**
+ * Number fields named like an id or a count: `z.number()` is float64 in Go, so they are notes suggesting `z.int()`
+ * (ADR 0070 C4), not diagnostics.
+ */
+export function goNotes(contract) {
+    const notes = new Set();
+    const walk = (schema, path, root, seen) => {
+        const ref = schema.$ref;
+        if (typeof ref === 'string') {
+            const key = ref.replace(/^#\/\$defs\//, '');
+            const def = root.$defs?.[key];
+            if (def && !seen.has(key))
+                walk(def, path, root, new Set([...seen, key]));
+            return;
+        }
+        for (const s of (schema.anyOf ?? schema.oneOf ?? []))
+            walk(s, path, root, seen);
+        if (schema.items)
+            walk(schema.items, `${path}[]`, root, seen);
+        for (const [prop, s] of Object.entries(schema.properties ?? {})) {
+            const number = [s, ...(s.anyOf ?? s.oneOf ?? [])].some((x) => (Array.isArray(x.type) ? x.type : [x.type]).includes('number'));
+            if (number && counted.test(prop))
+                notes.add(`${path}.${prop} is a number (float64 in Go); if it holds whole numbers, declare it z.int() (int64)`);
+            walk(s, `${path}.${prop}`, root, seen);
+        }
+    };
+    for (const e of contract.effects) {
+        walk(e.input, `${e.ref}: input`, e.input, new Set());
+        walk(e.output, `${e.ref}: output`, e.output, new Set());
+        for (const [name, schema] of Object.entries(e.errors))
+            walk(schema, `${e.ref}: ${name}`, schema, new Set());
+    }
+    if (contract.session)
+        walk(contract.session, 'session', contract.session, new Set());
+    return [...notes];
+}
+//# sourceMappingURL=go.js.map

package/dist/gen/go.js.map

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

package/dist/main.d.ts

@@ -11,6 +11,7 @@ type Token = {
     value?: string | undefined;
 };
 export declare function browsePlan(tokens: Token[]): Pick<BrowseOptions, 'actors' | 'plan'>;
+export declare function cli(argv: string[]): Promise<void>;
 export declare function main(argv: string[], cwd?: string, out?: (s: string) => void): Promise<number>;
 export {};
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,sBAAsB,CAAA;AAwH7B,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAaxE;AAED,eAAO,MAAM,cAAc,UAAW,MAAM,GAAG,SAAS,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAQzF,CAAA;AAQD,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAExE,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,MAAM,CAAC,CA8ClF;AAED,wBAAsB,IAAI,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,SAAgB,EACnB,GAAG,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAqC,GACxD,OAAO,CAAC,MAAM,CAAC,CA2VjB"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,sBAAsB,CAAA;AA4H7B,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAaxE;AAED,eAAO,MAAM,cAAc,UAAW,MAAM,GAAG,SAAS,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAQzF,CAAA;AAQD,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAExE,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,MAAM,CAAC,CA8ClF;AAMD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CASvD;AAED,wBAAsB,IAAI,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,SAAgB,EACnB,GAAG,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAqC,GACxD,OAAO,CAAC,MAAM,CAAC,CAqWjB"}

package/dist/main.js

@@ -3,7 +3,7 @@ import { relative, resolve } from 'node:path';
 import { parseArgs } from 'node:util';
 import { describeAdd, runAddFeature } from './commands/add.js';
 import { describeAddComponent, runAddComponent } from './commands/add-component.js';
-import { BuildFailed } from './commands/app.js';
+import { BuildFailed, disposeApps } from './commands/app.js';
 import { browseFailed, describeBrowse, runBrowse, stepsOf, } from './commands/browse.js';
 import { runBuild } from './commands/build.js';
 import { describeCall, runCall } from './commands/call.js';
@@ -14,6 +14,7 @@ import { describeDevtoolsMessages, messagesFileOf, runDevtoolsMessages } from '.
 import { runDocs } from './commands/docs.js';
 import { describeEnv, runEnv } from './commands/env.js';
 import { describeExport, runExport } from './commands/export.js';
+import { describeGen, runGen } from './commands/gen.js';
 import { runInspect } from './commands/inspect.js';
 import { describeAddKit, runAddKit } from './commands/kits.js';
 import { describeMap, runMap } from './commands/map.js';
@@ -64,6 +65,9 @@ Commands:
   get <path>...             Request pages in-process (no server): status, title, alerts, visible text, forms
   env [--example]           Every env variable the app reads: side, required, default, set now, internal URL;
                             --example writes .env.example
+  gen                       Write the contract of every remote() in app.ts (a Go file: types, the Resolvers
+                            interface, the HTTP handler) for resolvers in another language; hozu check reports a
+                            stale one (HZ093)
   call <feature>.<effect>   Run one query, mutation or endpoint in-process (no server) through the app's own
                             handler: --input '<json>', --session '<json>', --header 'Name: value' (endpoints);
                             a mutation or a POST endpoint writes real data and needs --write
@@ -202,6 +206,18 @@ export function browsePlan(tokens) {
     }
     return { actors, plan };
 }
+let running = false;
+const flushed = (stream) => new Promise((done) => stream.write('', () => done()));
+export async function cli(argv) {
+    const code = await main(argv);
+    if (running) {
+        process.exitCode = code;
+        return;
+    }
+    await disposeApps(undefined, (line) => process.stderr.write(`hozu: ${line}\n`));
+    await Promise.all([flushed(process.stdout), flushed(process.stderr)]);
+    process.exit(code);
+}
 export async function main(argv, cwd = process.cwd(), out = (s) => process.stdout.write(s)) {
     let asJson = false;
     try {
@@ -272,6 +288,7 @@ export async function main(argv, cwd = process.cwd(), out = (s) => process.stdou
             'get',
             'call',
             'env',
+            'gen',
             'browse',
             'add',
             'inspect',
@@ -390,6 +407,7 @@ export async function main(argv, cwd = process.cwd(), out = (s) => process.stdou
             await runDev(loaded, values['no-devtools'] === true ? false : (values.devtools ?? 'builder'), (line) => out(`${line}\n`), values['no-devtools'] === true
                 ? null
                 : messagesFileOf(values['devtools-messages'], cwd, (line) => out(`${line}\n`)));
+            running = true;
             return 0;
         }
         if (command === 'devtools') {
@@ -432,7 +450,10 @@ export async function main(argv, cwd = process.cwd(), out = (s) => process.stdou
             return result.ok ? 0 : 1;
         }
         if (command === 'serve') {
-            await runServe(loaded, (line) => out(`${line}\n`));
+            const server = await runServe(loaded, (line) => out(`${line}\n`));
+            running = true;
+            for (const signal of ['SIGINT', 'SIGTERM'])
+                process.once(signal, () => void server.close().finally(() => process.exit(0)));
             return 0;
         }
         if (command === 'map') {
@@ -445,6 +466,11 @@ export async function main(argv, cwd = process.cwd(), out = (s) => process.stdou
             out(asJson ? json(result) : describeEnv(result));
             return 0;
         }
+        if (command === 'gen') {
+            const result = await runGen(loaded, cwd);
+            out(asJson ? json(result) : describeGen(result));
+            return 0;
+        }
         if (command === 'call') {
             const result = await runCall(loaded, {
                 target,