@modularizer/plat 0.16.1 → 0.17.1

package/README.md

@@ -484,6 +484,34 @@ plat serve
 
 The CLI is available from both Node and Python packaging surfaces, with capability moving toward parity.
 
+Method names are forgiving: `createOrder`, `create-order`, `create_order` and `create order` are the same command.
+
+### Extending the CLI (don't write your own)
+
+`runCli` / `runHttpCli` (and the engine under them, `runCliCore`) take options for everything an app might
+want to do differently, so you never need to bypass plat's CLI:
+
+```ts
+import { runHttpCli } from '@modularizer/plat-cli'   // zero dependencies; or runCli from '@modularizer/plat'
+
+await runHttpCli({
+  baseUrl: () => discoverServer(),                    // or a string; spec defaults to GET /openapi.json
+  headers: () => ({ authorization: `Bearer ${token()}` }),
+  commands: { host: (ctx) => manageHosts(ctx.argv) },  // CLI-only commands; win over spec methods
+  overrides: { runSql: async (ctx, next) => confirmWrites(ctx) && next() },  // wrap/replace a method
+  positional: { runSql: ['datasource', 'query'] },     // `cli run sql shop "select 1"`
+  beforeCall: (ctx) => { ctx.input.limit ??= 100 },    // rewrite input
+  afterCall: (result) => unwrap(result),               // rewrite output
+  onUnknown: ({ candidates }) => suggest(candidates),  // fallback; return true if handled
+  onError: (err) => prettyPrint(err),
+  formatters: { md: toMarkdown }, defaultFormat: 'md',
+  help: (commands) => myHelp(commands),
+})
+```
+
+Also replaceable: `parseArgs`, `resolveName`, `call` (the transport), `spec` (object or async function), `io`.
+If you need something these don't cover, add an option to plat instead of forking the CLI.
+
 ## 🧩 Plugin architecture
 
 The plugin architecture matters, but mostly as an implementation and extension story.

package/dist/args/index.d.ts

@@ -1,2 +1,3 @@
-export * from './z2';
+export * from './z2.js';
+export * from './method_name.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/args/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/args/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/args/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAA;AACpB,cAAc,eAAe,CAAA"}

package/dist/args/index.js

@@ -1,2 +1,3 @@
 export * from './z2.js';
+export * from './method_name.js';
 //# sourceMappingURL=index.js.map

package/dist/args/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/args/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/args/index.ts"],"names":[],"mappings":"AACA,cAAc,MAAM,CAAA;AACpB,cAAc,eAAe,CAAA"}

package/dist/args/method_name.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Forgiving method names for CLIs: `runCloneFeed`, `run-clone-feed`, `run_clone_feed` and
+ * `run clone feed` all name the same operation.
+ *
+ * Pure (no node/DOM imports) so the lightweight client package can ship it.
+ */
+/** Split a name into lowercase words on camelCase, acronym, `-`, `_`, `.` and whitespace boundaries. */
+export declare function nameWords(name: string): string[];
+/** The canonical comparison key: all words, lowercased, joined with no separator. */
+export declare function normalizeName(name: string): string;
+export type ResolvedCommand = {
+    ok: true;
+    name: string;
+    consumed: number;
+} | {
+    ok: false;
+    reason: 'unknown' | 'ambiguous';
+    candidates: string[];
+};
+/**
+ * Resolve the leading bare tokens of `argv` to one of `names`. The longest run of leading tokens
+ * whose normalized join matches wins (so `run clone feed` beats a shorter `run`); a lone token spelled
+ * exactly like a name wins over look-alikes. `consumed` is how many argv
+ * tokens the command used. Two names that normalize identically are `ambiguous`, never guessed.
+ */
+export declare function resolveCommand(names: readonly string[], argv: readonly string[]): ResolvedCommand;
+//# sourceMappingURL=method_name.d.ts.map

package/dist/args/method_name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method_name.d.ts","sourceRoot":"","sources":["../../src/args/method_name.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wGAAwG;AACxG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,MAAM,MAAM,eAAe,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAO1E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAmBjG"}

package/dist/args/method_name.js

@@ -0,0 +1,52 @@
+/**
+ * Forgiving method names for CLIs: `runCloneFeed`, `run-clone-feed`, `run_clone_feed` and
+ * `run clone feed` all name the same operation.
+ *
+ * Pure (no node/DOM imports) so the lightweight client package can ship it.
+ */
+/** Split a name into lowercase words on camelCase, acronym, `-`, `_`, `.` and whitespace boundaries. */
+export function nameWords(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .split(/[\s_\-.]+/)
+        .filter(Boolean)
+        .map((word) => word.toLowerCase());
+}
+/** The canonical comparison key: all words, lowercased, joined with no separator. */
+export function normalizeName(name) {
+    return nameWords(name).join('');
+}
+/** True for tokens that can be part of a command name (not flags, `key=value` or JSON). */
+function isNameToken(token) {
+    return !token.startsWith('-') && !token.startsWith('{') && !token.startsWith('[') && !token.includes('=');
+}
+/**
+ * Resolve the leading bare tokens of `argv` to one of `names`. The longest run of leading tokens
+ * whose normalized join matches wins (so `run clone feed` beats a shorter `run`); a lone token spelled
+ * exactly like a name wins over look-alikes. `consumed` is how many argv
+ * tokens the command used. Two names that normalize identically are `ambiguous`, never guessed.
+ */
+export function resolveCommand(names, argv) {
+    const byKey = new Map();
+    for (const name of names) {
+        const key = normalizeName(name);
+        byKey.set(key, [...(byKey.get(key) ?? []), name]);
+    }
+    let run = 0;
+    while (run < argv.length && isNameToken(argv[run]))
+        run += 1;
+    for (let length = run; length >= 1; length -= 1) {
+        // A single token spelled exactly like a name is never ambiguous, even if siblings normalize alike.
+        if (length === 1 && names.includes(argv[0]))
+            return { ok: true, name: argv[0], consumed: 1 };
+        const matches = byKey.get(normalizeName(argv.slice(0, length).join(' ')));
+        if (matches === undefined)
+            continue;
+        if (matches.length === 1)
+            return { ok: true, name: matches[0], consumed: length };
+        return { ok: false, reason: 'ambiguous', candidates: matches };
+    }
+    return { ok: false, reason: 'unknown', candidates: [] };
+}
+//# sourceMappingURL=method_name.js.map

package/dist/args/method_name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method_name.js","sourceRoot":"","sources":["../../src/args/method_name.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wGAAwG;AACxG,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,OAAO,IAAI;SACN,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,KAAK,CAAC,WAAW,CAAC;SAClB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AAC1C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACnC,CAAC;AAMD,2FAA2F;AAC3F,SAAS,WAAW,CAAC,KAAa;IAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC7G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAwB,EAAE,IAAuB;IAC5E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAC/B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;IACrD,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC;QAAE,GAAG,IAAI,CAAC,CAAA;IAE7D,KAAK,IAAI,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9C,mGAAmG;QACnG,IAAI,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;QAC9F,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACzE,IAAI,OAAO,KAAK,SAAS;YAAE,SAAQ;QACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;IAClE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;AAC3D,CAAC"}

package/dist/args/validate.d.ts

@@ -4,7 +4,7 @@
  * Lean validator covering the JSON Schema subset that gen-schema.ts produces.
  * Coerces before validating (string→number, string→date, trim, etc.)
  */
-import { type JsonSchema } from './coerce';
+import { type JsonSchema } from './coerce.js';
 export declare class ValidationError extends Error {
     issues: string[];
     constructor(issues: string[]);

package/dist/args/z2.d.ts

@@ -19,9 +19,9 @@
  *   hex, digits, numeric, upper, lower, title, slug,
  *   num, int, posint, pos, percent, limit, offset
  */
-export { parse, safeParse, ValidationError } from './validate';
+export { parse, safeParse, ValidationError } from './validate.js';
 export type { ParseResult } from './validate';
-export { coerce, parseDateish, parseRelativeDate, registerCoerce, Coerce } from './coerce';
+export { coerce, parseDateish, parseRelativeDate, registerCoerce, Coerce } from './coerce.js';
 export type { JsonSchema } from './coerce';
 export type { str, char, text, word, token, line, email, url, uuid, ip, ipv6, hostname, datestr, datetime, time, json, pattern, grep, like, ilike, hex, digits, numeric, upper, lower, alpha, alphanum, title, slug, semver, base64, base58, phone, color, locale, mimetype, filepath, cuid, ulid, nanoid, jwt, countrycode, currency, lang, cron, num, float, double, int, pos, neg, notneg, posint, percent, limit, offset, port, byte, timestamp, age, cents, lat, lng, flag, } from './scalars';
 //# sourceMappingURL=z2.d.ts.map

package/dist/bridge/http-forwarder.d.ts

@@ -1,5 +1,5 @@
-import { type ClientSideServerInstanceInfo } from '../client-side-server/protocol';
-import type { ClientSideServerRequestHandler } from '../client-side-server/mqtt-webrtc';
+import { type ClientSideServerInstanceInfo } from '../client-side-server/protocol.js';
+import type { ClientSideServerRequestHandler } from '../client-side-server/mqtt-webrtc.js';
 export interface HTTPForwarderOptions {
     /** Base URL of the upstream HTTP server (e.g. "http://localhost:8080"). */
     upstream?: string;

package/dist/bridge/index.d.ts

@@ -6,9 +6,9 @@
  * HTTP server on the same LAN. Responses are shipped back as
  * `PLAT_RESPONSE` messages on the same data channel.
  */
-import { type ClientSideServerMQTTWebRTCOptions, type ClientSideServerWorkerInfo } from '../client-side-server/mqtt-webrtc';
-import type { ClientSideServerInstanceInfo } from '../client-side-server/protocol';
-export { createHTTPForwarder, type HTTPForwarderOptions } from './http-forwarder';
+import { type ClientSideServerMQTTWebRTCOptions, type ClientSideServerWorkerInfo } from '../client-side-server/mqtt-webrtc.js';
+import type { ClientSideServerInstanceInfo } from '../client-side-server/protocol.js';
+export { createHTTPForwarder, type HTTPForwarderOptions } from './http-forwarder.js';
 export interface PLATHTTPBridgeOptions extends ClientSideServerMQTTWebRTCOptions {
     /** css:// name the bridge registers as (e.g. "my-api" or "authority.com/my-api"). */
     name: string;

package/dist/cli/commands/api-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-proxy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/api-proxy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmKH;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwFzE"}
+{"version":3,"file":"api-proxy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/api-proxy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8KH;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGzE"}

package/dist/cli/commands/api-proxy.js

@@ -7,6 +7,7 @@ import path from 'path';
 import { OpenAPIClient } from '../../client/openapi-client.js';
 import { createClientSideServerMQTTWebRTCTransportPlugin } from '../../client-side-server/mqtt-webrtc.js';
 import { PLAT_AUTHORITY_URL } from '../../client-side-server/authority-default.js';
+import { resolveCommand } from '../../args/method_name.js';
 /**
  * Parse CLI arguments into params object and options
  * Supports multiple formats:
@@ -113,6 +114,16 @@ function findOperation(spec, operationId) {
     }
     return null;
 }
+function operationIds(spec) {
+    const ids = [];
+    for (const methods of Object.values(spec.paths)) {
+        for (const operation of Object.values(methods)) {
+            if (operation.operationId)
+                ids.push(operation.operationId);
+        }
+    }
+    return ids;
+}
 /**
  * Check if a string is an HTTP method
  */
@@ -145,13 +156,23 @@ export async function apiProxy(cwd, argv) {
         let methodOverride;
         let pathOverride;
         let argsStartIndex = 1;
-        if (isHttpMethod(argv[0]) && argv.length > 1) {
+        // Spec paths always start with `/`, so `get user` is the operation name, not `GET user`.
+        if (isHttpMethod(argv[0]) && argv[1]?.startsWith('/')) {
             methodOverride = argv[0].toUpperCase();
             pathOverride = argv[1];
             argsStartIndex = 2;
         }
         else {
-            operationId = argv[0];
+            // Any spelling of the name works: runCloneFeed, run-clone-feed, run_clone_feed, `run clone feed`.
+            const resolved = resolveCommand(operationIds(spec), argv);
+            if (!resolved.ok) {
+                console.error(resolved.reason === 'ambiguous'
+                    ? `❌ Error: '${argv[0]}' is ambiguous. Could be: ${resolved.candidates.join(', ')}`
+                    : `❌ Error: Operation '${argv[0]}' not found in OpenAPI spec`);
+                process.exit(1);
+            }
+            operationId = resolved.name;
+            argsStartIndex = resolved.consumed;
         }
         let operation = null;
         // If we have method + path override, find the operation by those

package/dist/cli/commands/api-proxy.js.map

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

package/dist/cli/core.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The extensible CLI engine behind `plat run`, generated CLIs and any app-specific CLI.
+ *
+ * Everything an application might want to do differently is an option here, so nobody has to
+ * bypass plat's CLI to get custom behaviour: add CLI-only commands, wrap or replace a method,
+ * map bare words to parameters, discover the server, rewrite input or output, handle unknown
+ * commands, format errors. Pure: no network, no node-only imports. The transport is `call`.
+ */
+import { type ResolvedCommand } from '../args/method_name.js';
+import { type CliFormatter } from './format.js';
+/** One operation from the OpenAPI spec. */
+export interface CliCommandInfo {
+    name: string;
+    method: string;
+    path: string;
+    summary?: string;
+    params: {
+        name: string;
+        required: boolean;
+    }[];
+}
+/** Pull the callable operations out of an OpenAPI document. */
+export declare function extractCommands(spec: any): CliCommandInfo[];
+export interface CliParsed {
+    input: Record<string, any>;
+    format: string;
+    /** Bare words after the command, in order (for `positional`). */
+    words: string[];
+}
+export interface CliContext {
+    /** The tokens after the command name (flags, `--k=v`, bare words). */
+    argv: readonly string[];
+    /** The matched spec operation; null for a CLI-only command. */
+    command: CliCommandInfo | null;
+    /** The name that matched, canonical (`runCloneFeed`, or your custom command's key). */
+    name: string;
+    /** What will be sent. `beforeCall` and overrides may change it. */
+    input: Record<string, any>;
+    format: string;
+    spec: any;
+    options: CliOptions;
+    /** Print helpers that honour `options.io`. */
+    log: (text: string) => void;
+    error: (text: string) => void;
+}
+export type CliCall = (command: CliCommandInfo, input: Record<string, any>, ctx: CliContext) => Promise<unknown>;
+/** A CLI-only command. Return a value to have it printed in the chosen format, or print yourself. */
+export type CliCustomCommand = (ctx: CliContext) => unknown | Promise<unknown>;
+/** Wrap or replace a spec method for the CLI. `next` performs the normal call (with the current input). */
+export type CliOverride = (ctx: CliContext, next: (input?: Record<string, any>) => Promise<unknown>) => unknown | Promise<unknown>;
+export interface CliUnknown {
+    argv: readonly string[];
+    reason: 'unknown' | 'ambiguous';
+    candidates: string[];
+    spec: any;
+}
+export interface CliOptions {
+    /** The OpenAPI document, or a function that gets it (fetch it, read a file, discover a server).
+     *  Loaded lazily: only when a spec method, help or onUnknown needs it, never for a CLI-only command. */
+    spec: any | (() => any | Promise<any>);
+    /** The transport. Plat's runtime supplies one over `OpenAPIClient`; the light entry over `fetch`. */
+    call: CliCall;
+    /** CLI-only commands, matched before spec methods; they win on a name clash (a custom `describe` is
+     *  never turned into a longer stitched method like `describeRelation`). A custom `help` replaces the
+     *  built-in help for `help`, `--help` and `-h`. Multi-word keys work. */
+    commands?: Record<string, CliCustomCommand>;
+    /** Wraps EVERY spec call (outermost): confirmations, retries, logging. `next` does the rest of the chain. */
+    around?: (ctx: CliContext, next: (input?: Record<string, any>) => Promise<unknown>) => unknown | Promise<unknown>;
+    /** Per-method CLI behaviour layered on top of a spec method. */
+    overrides?: Record<string, CliOverride>;
+    /** `{ sql: ['datasource', 'query'] }` — bare words after the command fill these params, in order. */
+    positional?: Record<string, string[]>;
+    /** Replace argument parsing entirely. */
+    parseArgs?: (argv: readonly string[], command: CliCommandInfo | null) => CliParsed;
+    /** Replace how a typed name maps to a command (default: any spelling, longest match). */
+    resolveName?: (names: readonly string[], argv: readonly string[]) => ResolvedCommand;
+    /** Runs before every spec call; mutate `ctx.input`, throw to abort. */
+    beforeCall?: (ctx: CliContext) => void | Promise<void>;
+    /** Runs on every spec result; return what to print. */
+    afterCall?: (result: unknown, ctx: CliContext) => unknown | Promise<unknown>;
+    /** Fallback for an unknown or ambiguous command. Return true if you handled it. */
+    onUnknown?: (info: CliUnknown, ctx: Pick<CliContext, 'log' | 'error' | 'options'>) => boolean | void | Promise<boolean | void>;
+    /** Replace how errors are reported. Default: print the message and exit 1. */
+    onError?: (err: unknown, ctx: Pick<CliContext, 'log' | 'error' | 'options'>) => void;
+    /** Replace the help text (return the string to print, or print yourself and return undefined). */
+    help?: (commands: CliCommandInfo[], options: CliOptions, spec: any) => string | void;
+    /** Extra or replacement `--format` values. */
+    formatters?: Record<string, CliFormatter>;
+    defaultFormat?: string;
+    /** Title line in the default help. */
+    title?: string;
+    /** Override console/exit (tests, embedding). */
+    io?: {
+        log?: (t: string) => void;
+        error?: (t: string) => void;
+        exit?: (code: number) => never;
+    };
+}
+export declare function defaultParseArgs(argv: readonly string[]): CliParsed;
+export declare function defaultHelp(commands: CliCommandInfo[], options: CliOptions, spec: any): string;
+/** Run the CLI. Resolves when done; failures go through `onError` (default: exit 1). */
+export declare function runCliCore(options: CliOptions, argv: readonly string[]): Promise<void>;
+//# sourceMappingURL=core.d.ts.map

package/dist/cli/core.d.ts.map

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

package/dist/cli/core.js

@@ -0,0 +1,177 @@
+/**
+ * The extensible CLI engine behind `plat run`, generated CLIs and any app-specific CLI.
+ *
+ * Everything an application might want to do differently is an option here, so nobody has to
+ * bypass plat's CLI to get custom behaviour: add CLI-only commands, wrap or replace a method,
+ * map bare words to parameters, discover the server, rewrite input or output, handle unknown
+ * commands, format errors. Pure: no network, no node-only imports. The transport is `call`.
+ */
+import { resolveCommand } from '../args/method_name.js';
+import { defaultFormatters } from './format.js';
+/** Pull the callable operations out of an OpenAPI document. */
+export function extractCommands(spec) {
+    const commands = [];
+    for (const [urlPath, methods] of Object.entries(spec?.paths ?? {})) {
+        for (const [httpMethod, _op] of Object.entries(methods)) {
+            const op = _op;
+            if (!op?.operationId)
+                continue;
+            const params = [];
+            for (const p of op.parameters ?? [])
+                params.push({ name: p.name, required: p.required ?? false });
+            const schema = op.requestBody?.content?.['application/json']?.schema;
+            if (schema?.properties) {
+                const required = new Set(schema.required ?? []);
+                for (const name of Object.keys(schema.properties))
+                    params.push({ name, required: required.has(name) });
+            }
+            commands.push({ name: op.operationId, method: httpMethod.toUpperCase(), path: urlPath, summary: op.summary, params });
+        }
+    }
+    return commands;
+}
+export function defaultParseArgs(argv) {
+    const input = {};
+    const words = [];
+    let format = '';
+    for (const arg of argv) {
+        const m = arg.match(/^--([\w-]+)=(.*)$/) || arg.match(/^--([\w-]+)$/);
+        if (!m) {
+            words.push(arg);
+            continue;
+        }
+        if (m[1] === 'format') {
+            format = m[2] ?? '';
+            continue;
+        }
+        const key = m[1].replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        let val = m[2] ?? true;
+        if (val === 'true')
+            val = true;
+        else if (val === 'false')
+            val = false;
+        else if (typeof val === 'string' && /^-?\d+(\.\d+)?$/.test(val))
+            val = Number(val);
+        else if (typeof val === 'string' && (val.startsWith('{') || val.startsWith('['))) {
+            try {
+                val = JSON.parse(val);
+            }
+            catch { }
+        }
+        input[key] = val;
+    }
+    return { input, format, words };
+}
+export function defaultHelp(commands, options, spec) {
+    const lines = [`${options.title ?? spec?.info?.title ?? 'API'} CLI\n`];
+    lines.push('Usage: <command> [--key=value ...] [--format=json|yaml|table|csv|human]\n');
+    lines.push('Commands:');
+    for (const name of Object.keys(options.commands ?? {}))
+        lines.push(`  ${name}`);
+    for (const cmd of commands) {
+        const params = cmd.params.map(p => p.required ? `--${p.name}` : `[--${p.name}]`).join(' ');
+        const summary = cmd.summary ? `  — ${cmd.summary}` : '';
+        lines.push(`  ${cmd.name.padEnd(30)} ${params}${summary}`);
+    }
+    return lines.join('\n');
+}
+/** Run the CLI. Resolves when done; failures go through `onError` (default: exit 1). */
+export async function runCliCore(options, argv) {
+    const log = options.io?.log ?? ((t) => console.log(t));
+    const error = options.io?.error ?? ((t) => console.error(t));
+    const exit = options.io?.exit ?? ((code) => process.exit(code));
+    const base = { log, error, options };
+    const fail = (err) => {
+        if (options.onError)
+            return options.onError(err, base);
+        error(err instanceof Error ? err.message : String(err));
+        exit(1);
+    };
+    try {
+        const custom = options.commands ?? {};
+        const formatters = { ...defaultFormatters, ...options.formatters };
+        let loaded;
+        const load = async () => {
+            if (!loaded) {
+                const spec = typeof options.spec === 'function' ? await options.spec() : options.spec;
+                loaded = { spec, commands: extractCommands(spec) };
+            }
+            return loaded;
+        };
+        const resolver = options.resolveName ?? resolveCommand;
+        const [first] = argv;
+        const wantsHelp = first === undefined || first === 'help' || first === '--help' || first === '-h';
+        if (wantsHelp && !custom.help) {
+            const { spec, commands } = await load();
+            const text = (options.help ?? defaultHelp)(commands, options, spec);
+            if (text !== undefined)
+                log(text);
+            return exit(0);
+        }
+        // CLI-only commands first, so the spec (and the network) is only needed for spec methods.
+        let resolved = resolver(Object.keys(custom), wantsHelp ? ['help'] : argv);
+        // A replaced resolver may answer with a spec name it was never offered; only custom names count here.
+        if (resolved.ok && !custom[resolved.name])
+            resolved = { ok: false, reason: 'unknown', candidates: [] };
+        let spec = undefined;
+        let commands = [];
+        if (!resolved.ok && resolved.reason === 'unknown') {
+            ;
+            ({ spec, commands } = await load());
+            resolved = resolver(commands.map(c => c.name), argv);
+        }
+        if (!resolved.ok) {
+            const handled = await options.onUnknown?.({ argv, reason: resolved.reason, candidates: resolved.candidates, spec }, base);
+            if (handled === true)
+                return;
+            return fail(new Error(resolved.reason === 'ambiguous'
+                ? `Ambiguous command: ${first}. Could be: ${resolved.candidates.join(', ')}.`
+                : `Unknown command: ${first}. Run with --help for available commands.`));
+        }
+        if (wantsHelp)
+            resolved = { ...resolved, consumed: first === undefined ? 0 : 1 };
+        const command = custom[resolved.name] ? null : commands.find(c => c.name === resolved.name) ?? null;
+        const rest = argv.slice(resolved.consumed);
+        const parsed = (options.parseArgs ?? defaultParseArgs)(rest, command);
+        const input = { ...parsed.input };
+        const positional = options.positional?.[resolved.name] ?? [];
+        positional.forEach((param, index) => {
+            const word = parsed.words[index];
+            if (word !== undefined && input[param] === undefined)
+                input[param] = word;
+        });
+        const format = parsed.format || options.defaultFormat || 'json';
+        const ctx = { ...base, argv: rest, command, name: resolved.name, input, format, spec };
+        const print = (value) => {
+            if (value === undefined)
+                return;
+            const formatter = formatters[format];
+            if (!formatter)
+                throw new Error(`Unknown format: ${format}. Available: ${Object.keys(formatters).join(', ')}`);
+            log(formatter(value));
+        };
+        const customRun = custom[resolved.name];
+        if (customRun)
+            return print(await customRun(ctx));
+        if (!command)
+            return;
+        const call = async (override) => {
+            if (override)
+                ctx.input = override;
+            await options.beforeCall?.(ctx);
+            const result = await options.call(command, ctx.input, ctx);
+            return options.afterCall ? options.afterCall(result, ctx) : result;
+        };
+        const override = options.overrides?.[resolved.name];
+        const inner = override ? () => override(ctx, call) : () => call();
+        print(options.around ? await options.around(ctx, async (input) => {
+            if (input)
+                ctx.input = input;
+            return inner();
+        }) : await inner());
+    }
+    catch (err) {
+        fail(err);
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/cli/core.js.map

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

package/dist/cli/format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in CLI output formatters. Pure (no node-only imports besides the optional terminal width),
+ * so the lightweight client package can ship them.
+ */
+export declare function formatJson(data: any): string;
+export declare function formatYaml(data: any, indent?: number): string;
+export declare function formatHuman(data: any, indent?: number): string;
+export declare function formatTable(data: any): string;
+export declare function formatCsv(data: any): string;
+export type CliFormatter = (data: any) => string;
+/** Name → formatter. A CLI adds or replaces entries through `CliOptions.formatters`. */
+export declare const defaultFormatters: Record<string, CliFormatter>;
+//# sourceMappingURL=format.d.ts.map

package/dist/cli/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAE5C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,SAAI,GAAG,MAAM,CAyBxD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,SAAI,GAAG,MAAM,CAiBzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CA0D7C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAoB3C;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAA;AAEhD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAM1D,CAAA"}