@omochi-ui/cli 0.1.2 → 0.2.0

package/dist/cli.js

@@ -1,454 +0,0 @@
-#!/usr/bin/env bun
-import { hostname, networkInterfaces } from 'node:os';
-import process from 'node:process';
-import { createStaticLocator, gatewayEndpointKey, loadNodeIdentity, omochiConfigRoot, openTrustStore, pairWithGateway, parseGatewayTarget, startGateway, } from '@omochi-ui/discovery';
-import { generateCatalog } from './catalog-codegen.js';
-import { helpText, helpTopic } from './help.js';
-import { startHub } from './hub/hub.js';
-import { startSshGateway, validateSshTarget } from './hub/ssh-gateway.js';
-import { startStdioWebSocketBridge } from './stdio-websocket-bridge.js';
-import { loadComposition, openBrowser, startCompositionServices } from './up.js';
-/**
- * An address another machine could actually dial.
- *
- * A wildcard bind is what the gateway listens on, not somewhere anyone can connect to,
- * so printing it back would send a person to `0.0.0.0`.
- */
-function reachableHost(bound) {
-    if (bound !== '0.0.0.0' && bound !== '::' && bound !== '')
-        return bound;
-    for (const addresses of Object.values(networkInterfaces())) {
-        for (const address of addresses ?? []) {
-            if (address.family === 'IPv4' && !address.internal)
-                return address.address;
-        }
-    }
-    return hostname();
-}
-function usage(message = 'Invalid or incomplete arguments.') {
-    process.stderr.write(`[omochi-ui] ${message}\n\n${helpText(topic) ?? helpText()}`);
-    process.exit(2);
-}
-const args = process.argv.slice(2);
-// Stop scanning at -- so e.g. `dev -- python app.py --help` reaches the app.
-const separatorIndex = args.indexOf('--');
-const ownArgs = separatorIndex < 0 ? args : args.slice(0, separatorIndex);
-const explicitHelp = ownArgs[0] === 'help';
-const helpArgs = explicitHelp ? ownArgs.slice(1) : ownArgs;
-const topic = helpTopic(helpArgs.filter((arg) => arg !== '--help' && arg !== '-h'));
-if (!args.length || explicitHelp || ownArgs.some((arg) => arg === '--help' || arg === '-h')) {
-    const text = helpText(topic);
-    if (text === undefined || (explicitHelp && helpArgs.length > (topic.includes(' ') ? 2 : 1))) {
-        usage(`Unknown help topic: ${helpArgs.join(' ')}`);
-    }
-    process.stdout.write(text);
-    process.exit(0);
-}
-const commandName = args.shift();
-if (commandName === 'generate') {
-    if (args.shift() !== 'catalog')
-        usage();
-    const options = { catalog: '' };
-    while (args.length) {
-        const option = args.shift();
-        if (option === '--check') {
-            options.check = true;
-            continue;
-        }
-        const value = args.shift();
-        if (!value)
-            usage();
-        if (option === '--catalog')
-            options.catalog = value;
-        else if (option === '--name')
-            options.name = value;
-        else if (option === '--typescript')
-            options.typescript = value;
-        else if (option === '--python')
-            options.python = value;
-        else if (option === '--rust')
-            options.rust = value;
-        else
-            usage();
-    }
-    if (!options.catalog)
-        usage();
-    await generateCatalog(options);
-    process.exit(0);
-}
-if (commandName === 'id') {
-    let nodeName;
-    while (args.length) {
-        const option = args.shift();
-        const value = args.shift();
-        if (!value || option !== '--node-name')
-            usage();
-        nodeName = value;
-    }
-    const identity = await loadNodeIdentity(nodeName === undefined ? {} : { name: nodeName });
-    process.stdout.write(`${identity.nodeId}\t${identity.name}\n`);
-    process.stderr.write(`[omochi-ui] identity stored in ${omochiConfigRoot()}\n`);
-    process.exit(0);
-}
-if (commandName === 'pair') {
-    const target = args.shift();
-    if (!target)
-        usage();
-    const parsed = parseGatewayTarget(target);
-    if (!parsed || parsed.endpoint.kind !== 'tcp')
-        usage();
-    let code;
-    while (args.length) {
-        const option = args.shift();
-        const value = args.shift();
-        if (!value || option !== '--code')
-            usage();
-        code = value;
-    }
-    // Reading the code from stdin keeps it out of shell history.
-    if (code === undefined) {
-        process.stderr.write('[omochi-ui] pairing code: ');
-        code = await new Promise((resolvePromise) => {
-            let typed = '';
-            process.stdin.setEncoding('utf8');
-            process.stdin.on('data', (chunk) => {
-                typed += chunk;
-                const line = typed.indexOf('\n');
-                if (line >= 0) {
-                    process.stdin.pause();
-                    resolvePromise(typed.slice(0, line));
-                }
-            });
-            process.stdin.on('end', () => resolvePromise(typed));
-        });
-    }
-    const identity = await loadNodeIdentity();
-    const trust = await openTrustStore();
-    try {
-        const peer = await pairWithGateway(parsed.endpoint, { identity, trust, code });
-        process.stderr.write(`[omochi-ui] paired with ${peer.nodeId} (${peer.name})\n`);
-        process.stderr.write(`[omochi-ui] reach it with: omochi-ui hub --gateway ${peer.nodeId}@${peer.addresses[0]}\n`);
-        process.exit(0);
-    }
-    catch (error) {
-        process.stderr.write(`[omochi-ui] ${error instanceof Error ? error.message : String(error)}\n`);
-        process.exit(1);
-    }
-}
-if (commandName === 'trust') {
-    const action = args.shift();
-    if (action !== 'list' && action !== 'forget')
-        usage('Expected trust list or trust forget <nodeId>.');
-    if (action === 'list' && args.length !== 0)
-        usage('trust list takes no arguments.');
-    if (action === 'forget' && args.length !== 1)
-        usage('trust forget requires exactly one node ID.');
-    const store = await openTrustStore();
-    if (action === 'list') {
-        const peers = store.list();
-        if (store.legacy)
-            process.stderr.write('[omochi-ui] old TLS-PSK pairings are unsupported; pair devices again\n');
-        if (!peers.length)
-            process.stderr.write(`[omochi-ui] no paired peers in ${store.file}\n`);
-        for (const peer of peers) {
-            const seen = peer.lastSeenAt ? ` last seen ${peer.lastSeenAt}` : '';
-            process.stdout.write(`${peer.nodeId}\t${peer.role}\t${peer.name}\tpaired ${peer.pairedAt}${seen}\n`);
-        }
-        process.exit(0);
-    }
-    if (action === 'forget') {
-        const nodeId = args.shift();
-        if (!nodeId)
-            usage();
-        const forgotten = await store.forget(nodeId);
-        process.stderr.write(forgotten
-            ? `[omochi-ui] forgot ${nodeId}\n`
-            : `[omochi-ui] no paired peer ${nodeId}\n`);
-        process.exit(forgotten ? 0 : 1);
-    }
-    usage();
-}
-if (commandName === 'gateway') {
-    let root;
-    let socketPath;
-    let nodeName;
-    let listen;
-    let pairing;
-    let advertise = false;
-    while (args.length) {
-        const option = args.shift();
-        // `--lan` is sugar; accepting hubs and advertising stay separate switches.
-        if (option === '--lan') {
-            listen = { host: '0.0.0.0', port: 5556 };
-            advertise = true;
-            continue;
-        }
-        if (option === '--advertise') {
-            advertise = true;
-            continue;
-        }
-        if (option === '--pair') {
-            pairing = {};
-            continue;
-        }
-        const value = args.shift();
-        if (!value)
-            usage();
-        if (option === '--root')
-            root = value;
-        else if (option === '--socket')
-            socketPath = value;
-        else if (option === '--node-name')
-            nodeName = value;
-        else if (option === '--listen') {
-            const target = parseGatewayTarget(value);
-            if (!target || target.endpoint.kind !== 'tcp')
-                usage();
-            listen = { host: target.endpoint.host, port: target.endpoint.port };
-        }
-        else
-            usage();
-    }
-    if ((pairing || advertise) && !listen)
-        usage('--pair and --advertise require --listen HOST:PORT or --lan.');
-    const gateway = await startGateway({ root, socketPath, name: nodeName, listen, pairing, advertise })
-        .catch((error) => {
-        // Two gateways on one machine is the common mistake here, and a stack trace is a
-        // poor way to say so.
-        if (error.code === 'EADDRINUSE' && listen) {
-            process.stderr.write(`[omochi-ui] ${listen.host}:${listen.port} is already in use; another gateway may be running\n`);
-            process.exit(1);
-        }
-        if (error.code === 'EADDRINUSE') {
-            process.stderr.write('[omochi-ui] a gateway is already listening on this machine\n');
-            process.exit(1);
-        }
-        throw error;
-    });
-    process.stderr.write(`[omochi-ui] gateway ${gateway.nodeId} (${gateway.name})\n[omochi-ui] publishing services from ${gateway.root}\n[omochi-ui] listening on ${gateway.socketPath}\n`);
-    if (gateway.address) {
-        const peers = (await openTrustStore()).list().filter((peer) => peer.role === 'hub').length;
-        process.stderr.write(`[omochi-ui] reachable from the local network on ${gateway.address.host}:${gateway.address.port}; ${peers} hub(s) paired\n`);
-        if (advertise)
-            process.stderr.write(`[omochi-ui] advertising as _${'omochi-ui'}._tcp\n`);
-    }
-    if (gateway.pairing) {
-        const seconds = Math.round((gateway.pairing.expiresAt - Date.now()) / 1000);
-        process.stderr.write([
-            `[omochi-ui] pairing code: ${gateway.pairing.display}   (valid ${seconds}s, one use)`,
-            `[omochi-ui] on the other machine: omochi-ui pair ${reachableHost(gateway.pairingAddress.host)}:${gateway.pairingAddress.port}`,
-            '',
-        ].join('\n'));
-        void gateway.pairing.ended.then((reason) => {
-            // The gateway keeps running either way; only the window is over.
-            process.stderr.write(`[omochi-ui] pairing window closed: ${reason}\n`);
-        });
-    }
-    const stop = () => void gateway.close().then(() => process.exit(0));
-    process.on('SIGINT', stop);
-    process.on('SIGTERM', stop);
-}
-else if (commandName === 'up') {
-    let host = '127.0.0.1';
-    let port = 5555;
-    let shouldOpen = false;
-    const allowOrigins = [];
-    let file = 'omochi.toml';
-    let foundFile = false;
-    while (args.length) {
-        const option = args.shift();
-        if (option === '--open') {
-            shouldOpen = true;
-            continue;
-        }
-        if (!option.startsWith('-')) {
-            if (foundFile)
-                usage('up accepts at most one composition file.');
-            file = option;
-            foundFile = true;
-            continue;
-        }
-        const value = args.shift();
-        if (!value)
-            usage();
-        if (option === '--host')
-            host = value;
-        else if (option === '--port' && Number.isInteger(Number(value)))
-            port = Number(value);
-        else if (option === '--allow-origin')
-            allowOrigins.push(value);
-        else
-            usage();
-    }
-    if (port < 0 || port > 65535)
-        usage('--port must be an integer from 0 to 65535.');
-    let services;
-    let hub;
-    let shutdown;
-    const stop = (code = 0) => shutdown ??= (async () => {
-        await services?.close();
-        await hub?.close();
-        process.exit(code);
-    })();
-    process.on('SIGINT', () => { void stop(130); });
-    process.on('SIGTERM', () => { void stop(143); });
-    try {
-        const identity = await loadNodeIdentity();
-        const composition = await loadComposition(file, identity.nodeId);
-        services = startCompositionServices(composition.services);
-        hub = await startHub({ host, port, allowOrigins, presets: [composition.preset] });
-        const url = new URL(hub.httpUrl);
-        url.searchParams.set('preset', composition.id);
-        process.stderr.write(`[omochi-ui] composition ${composition.id}: ${composition.services.length} services\n[omochi-ui] ${url.toString()}\n`);
-        if (shouldOpen) {
-            if (['0.0.0.0', '::'].includes(url.hostname))
-                url.hostname = '127.0.0.1';
-            openBrowser(url.toString());
-        }
-    }
-    catch (error) {
-        process.stderr.write(`[omochi-ui] ${error instanceof Error ? error.message : String(error)}\n`);
-        await services?.close();
-        await hub?.close();
-        process.exit(1);
-    }
-}
-else if (commandName === 'hub') {
-    let host = '127.0.0.1';
-    let port = 5555;
-    let autoGateway = true;
-    let discoverLan = false;
-    let sshHost;
-    let sshSocket;
-    const peers = [];
-    const peerIds = new Map();
-    const allowOrigins = [];
-    while (args.length) {
-        const option = args.shift();
-        if (option === '--no-auto-gateway') {
-            autoGateway = false;
-            continue;
-        }
-        if (option === '--discover-lan') {
-            discoverLan = true;
-            continue;
-        }
-        const value = args.shift();
-        if (!value)
-            usage();
-        if (option === '--host')
-            host = value;
-        else if (option === '--port' && Number.isInteger(Number(value)))
-            port = Number(value);
-        else if (option === '--ssh') {
-            if (sshHost !== undefined)
-                usage();
-            sshHost = value;
-        }
-        else if (option === '--ssh-socket') {
-            if (sshSocket !== undefined)
-                usage();
-            sshSocket = value;
-        }
-        else if (option === '--gateway') {
-            const target = parseGatewayTarget(value);
-            if (!target)
-                usage();
-            peers.push(target.endpoint);
-            if (target.nodeId)
-                peerIds.set(gatewayEndpointKey(target.endpoint), target.nodeId);
-        }
-        else if (option === '--allow-origin')
-            allowOrigins.push(value);
-        else
-            usage();
-    }
-    // Naming a gateway replaces the default, so `--gateway` can point at another machine
-    // without also picking up whatever happens to be running locally.
-    if (sshSocket !== undefined && sshHost === undefined)
-        usage();
-    if (port < 0 || port > 65535)
-        usage('--port must be an integer from 0 to 65535.');
-    let tunnel;
-    let hub;
-    const abort = new AbortController();
-    let stopping = false;
-    let pending;
-    let shutdown;
-    const stop = (code = 0) => shutdown ??= (async () => {
-        stopping = true;
-        abort.abort();
-        await pending?.catch(() => { });
-        await hub?.close();
-        await tunnel?.close();
-        process.exit(code);
-    })();
-    // Install these before SSH can prompt, so cancellation also cleans partial startup.
-    process.on('SIGINT', () => { void stop(130); });
-    process.on('SIGTERM', () => { void stop(143); });
-    try {
-        if (sshHost !== undefined) {
-            validateSshTarget(sshHost, sshSocket);
-            tunnel = await (pending = startSshGateway({ host: sshHost, remoteSocket: sshSocket, signal: abort.signal }));
-            peers.push({ kind: 'unix', socketPath: tunnel.socketPath });
-        }
-        const gateways = peers.length ? [createStaticLocator(peers, peerIds)] : undefined;
-        hub = await (pending = startHub({ host, port, allowOrigins, gateways, discoverLan, autoGateway: autoGateway && !peers.length }));
-        if (tunnel)
-            void tunnel.exited.then((error) => {
-                if (!stopping) {
-                    process.stderr.write(`[omochi-ui] ${error.message}\n`);
-                    void stop(1);
-                }
-            });
-    }
-    catch (error) {
-        process.stderr.write(`[omochi-ui] ${error instanceof Error ? error.message : error}\n`);
-        await stop(1);
-        process.exit(1);
-    }
-    // Connections are still being established, so name the targets rather than count them.
-    const named = peers.length
-        ? peers.map((peer) => (peer.kind === 'unix' ? peer.socketPath : `${peer.host}:${peer.port}`)).join(', ')
-        : 'the local gateway';
-    const targets = discoverLan ? `${named} and any gateway on the local link` : named;
-    process.stderr.write(`[omochi-ui] merging ${targets}\n[omochi-ui] ${hub.httpUrl}\nA2UI endpoint: ${hub.url}\n`);
-    if (host !== '127.0.0.1' && host !== 'localhost' && host !== '::1') {
-        process.stderr.write('[omochi-ui] warning: hub has no authentication or TLS\n');
-    }
-}
-else {
-    if (commandName !== 'dev')
-        usage(`Unknown command: ${commandName}`);
-    const separator = args.indexOf('--');
-    if (separator < 0)
-        usage('dev requires -- followed by the application command.');
-    const optionArgs = args.slice(0, separator);
-    const childCommand = args.slice(separator + 1);
-    let host = '127.0.0.1';
-    let port = 5555;
-    for (let index = 0; index < optionArgs.length; index += 1) {
-        const option = optionArgs[index];
-        const value = optionArgs[index + 1];
-        if (option === '--host' && value)
-            host = value;
-        else if (option === '--port' && value && Number.isInteger(Number(value)))
-            port = Number(value);
-        else
-            usage();
-        index += 1;
-    }
-    if (!childCommand.length)
-        usage();
-    if (port < 0 || port > 65535)
-        usage('--port must be an integer from 0 to 65535.');
-    const handle = await startStdioWebSocketBridge({ command: childCommand, host, port });
-    process.stderr.write(`[omochi-ui] bridge: ${handle.url}\nStart the browser preview in another terminal: bun run --filter @omochi-ui/dev-server dev\nOpen: http://127.0.0.1:5173/?ws=${encodeURIComponent(handle.url)}\n`);
-    if (host !== '127.0.0.1' && host !== 'localhost' && host !== '::1')
-        process.stderr.write('[omochi-ui] warning: bridge has no authentication or TLS\n');
-    const forward = (signal) => { if (handle.child.exitCode === null)
-        handle.child.kill(signal); };
-    process.on('SIGINT', forward);
-    process.on('SIGTERM', forward);
-    process.exitCode = await handle.exited;
-}

package/dist/help.d.ts

@@ -1,3 +0,0 @@
-export declare function helpText(topic?: string): string | undefined;
-/** Only command words select a topic; options and child arguments never do. */
-export declare function helpTopic(args: string[]): string;

package/dist/help.js

@@ -1,187 +0,0 @@
-const overview = `omochi-ui — attach a declarative UI to your program
-
-Usage: omochi-ui <command> [options]
-
-Develop an app:
-  dev -- <command> [args...]   Run an app behind a stdio/WebSocket bridge
-  generate catalog           Generate typed bindings from a local catalog
-
-Compose dashboards:
-  up [FILE]                  Start a composition and its dashboard preset
-  hub                        Serve the dashboard UI; auto-start a local gateway
-  gateway                    Publish running apps on this machine
-
-Connect machines:
-  id                         Show or name this machine's identity
-  pair HOST:PORT             Pair with a gateway using its one-time code
-  trust list                 List paired peers
-  trust forget <nodeId>      Remove a paired peer
-
-Start here:
-  omochi-ui dev -- <command>  Preview one app (requires a separate UI server)
-  omochi-ui up --open         Start ./omochi.toml and open its preset
-  omochi-ui hub               Open dashboards at http://127.0.0.1:5555/
-
-Use omochi-ui <command> --help or omochi-ui help <command> for options.
-`;
-const topics = {
-    up: `Start services and a read-only dashboard preset from a TOML composition.
-
-Usage: omochi-ui up [options] [FILE]
-
-Options:
-  --host HOST            Hub bind address (default: 127.0.0.1)
-  --port PORT            Hub port (default: 5555; 0 selects a port)
-  --allow-origin ORIGIN  Allow an additional exact browser origin; repeatable
-  --open                 Open the selected preset in the desktop browser
-
-FILE defaults to ./omochi.toml. Commands run without an implicit shell and
-receive OMOCHI_SERVICE. Utility entries invoke the matching omochi-utils mode.
-The preset is temporary; use Save as dashboard in the hub to keep and edit it.
-If a child service exits, its view becomes unavailable while the hub continues.
-`,
-    dev: `Run an application and bridge its JSONL stdin/stdout to WebSocket.
-
-Usage: omochi-ui dev [options] -- <command> [args...]
-
-Options:
-  --host HOST    Bind address (default: 127.0.0.1)
-  --port PORT    WebSocket port (default: 5555; 0 selects an available port)
-
-This command starts the app and bridge. Start the browser preview separately:
-  bun run --filter @omochi-ui/dev-server dev
-  omochi-ui dev -- uv run --project examples/python examples/python/app.py
-
-Open http://127.0.0.1:5173/ with the default bridge port. For another port,
-use the ?ws= URL printed at startup. All arguments after -- go to the app.
-The bridge has no authentication or TLS; keep the loopback default.
-`,
-    hub: `Serve dashboards combining surfaces from running applications.
-
-Usage: omochi-ui hub [options]
-
-Options:
-  --host HOST            HTTP/WebSocket bind address (default: 127.0.0.1)
-  --port PORT            HTTP/WebSocket port (default: 5555; 0 selects a port)
-  --gateway TARGET       Gateway socket path or <nodeId>@HOST:PORT; repeatable
-  --ssh HOST             Reach a remote gateway through SSH (one target)
-  --ssh-socket PATH      Override the remote socket; requires --ssh
-  --no-auto-gateway      Do not start a missing local gateway
-  --discover-lan         Also discover paired gateways through mDNS
-  --allow-origin ORIGIN  Allow an additional exact browser origin; repeatable
-
-With no target, the hub reuses or starts the local gateway. --gateway and
---ssh replace that default; add --gateway with the local socket to include it.
-The hub serves its own UI at http://127.0.0.1:5555/; no Vite server is needed.
-Apps must already be running with UnixSocketServerTransport.
-
-Examples:
-  omochi-ui hub
-  omochi-ui hub --ssh user@remote
-  omochi-ui hub --gateway <nodeId>@192.168.1.42:5556
-
-SSH requires a running remote gateway. TCP requires pairing first.
-The hub has no authentication or TLS; keep the loopback default.
-`,
-    gateway: `Discover and publish the current user's running apps on one machine.
-
-Usage: omochi-ui gateway [options]
-
-Options:
-  --root DIR        App registry directory (default: $XDG_RUNTIME_DIR/omochi)
-  --socket PATH     Gateway socket (default: <root>/gateway.sock)
-  --node-name NAME  Set this machine's display name
-  --listen HOST:PORT  Enable the certificate-authenticated mTLS listener
-  --advertise       Advertise with mDNS; requires --listen or --lan
-  --pair            Open a one-time pairing window; requires --listen or --lan
-  --lan             Shorthand for --listen 0.0.0.0:5556 --advertise
-
-The gateway discovers apps; it does not launch them or serve a browser UI.
-Without network flags, it listens only on a Unix socket. If XDG_RUNTIME_DIR
-is unset, the registry is <temp>/omochi-<uid>/omochi.
-
-Examples:
-  omochi-ui gateway
-  omochi-ui gateway --lan --pair
-`,
-    id: `Show this machine's persistent node ID and display name.
-
-Usage: omochi-ui id [--node-name NAME]
-
-Creates an identity on first use. --node-name sets its display name.
-Configuration: $XDG_CONFIG_HOME/omochi (default: ~/.config/omochi).
-`,
-    pair: `Pair this machine with a gateway accepting a one-time code.
-
-Usage: omochi-ui pair HOST:PORT [--code CODE]
-
-Start omochi-ui gateway --lan --pair on the machine running the apps first.
-Without --code, read the code from stdin to keep it out of shell history.
-Use the printed random pairing port; it differs from the normal mTLS port.
-After pairing, use the printed hub --gateway command to connect.
-
-Example:
-  omochi-ui pair 192.168.1.42:42317  # use the printed random pairing port
-`,
-    trust: `Manage paired peers stored in $XDG_CONFIG_HOME/omochi/peers.json.
-
-Usage:
-  omochi-ui trust list
-  omochi-ui trust forget <nodeId>
-
-list shows peer IDs, roles, names, and pairing times.
-forget removes the local entry and waits for running processes to close revoked connections.
-The machines must pair again to reconnect.
-`,
-    'trust list': `List this machine's paired peers.
-
-Usage: omochi-ui trust list
-
-Prints peer IDs, roles, names, pairing times, and last-seen times when known.
-`,
-    'trust forget': `Remove a peer from this machine's trust store.
-
-Usage: omochi-ui trust forget <nodeId>
-
-Use omochi-ui trust list to find its ID. Pair again to reconnect.
-Returns exit code 1 if the peer was not found.
-`,
-    generate: `Generate SDK bindings from local schema files.
-
-Usage: omochi-ui generate catalog [options]
-
-Use omochi-ui generate catalog --help for required inputs and output flags.
-`,
-    'generate catalog': `Generate typed SDK bindings from a local A2UI v0.9 catalog.
-
-Usage: omochi-ui generate catalog --catalog FILE [options]
-
-Options:
-  --catalog FILE     Required local catalog JSON file
-  --name NAME        Type name (default: catalog title or GeneratedCatalog)
-  --typescript FILE Write TypeScript bindings
-  --python FILE     Write Python bindings
-  --rust FILE       Write Rust bindings
-  --check           Fail if output files are missing or stale; do not write
-
-Choose at least one output language. Output directories must already exist.
-Schema resolution is local-only; no network fetches are performed.
-
-Example:
-  omochi-ui generate catalog --catalog ./catalog.json --typescript ./catalog.ts
-`,
-};
-export function helpText(topic = '') {
-    if (!topic)
-        return overview;
-    const body = Object.hasOwn(topics, topic) ? topics[topic] : undefined;
-    return body === undefined ? undefined : `${body}\n  -h, --help    Show this help\n`;
-}
-/** Only command words select a topic; options and child arguments never do. */
-export function helpTopic(args) {
-    const command = args[0] ?? '';
-    const subcommand = args[1];
-    return (command === 'trust' || command === 'generate') && subcommand && !subcommand.startsWith('-')
-        ? `${command} ${subcommand}`
-        : command;
-}

package/dist/hub/dashboards.d.ts

@@ -1,17 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { type Dashboard, type DashboardInput, type DashboardPreset } from '@omochi-ui/hub-ui/contracts';
-export declare function validateDashboard(value: unknown): DashboardInput;
-/** Re-read under the mutation queue and cross-process lock; failed writes never replace the last good file. */
-export declare class DashboardStore {
-    private readonly root;
-    private queue;
-    private readonly file;
-    constructor(root?: string);
-    private read;
-    list(): Promise<Dashboard[]>;
-    mutate(id: string | null, input: unknown, remove?: boolean): Promise<Dashboard | null>;
-}
-export declare function dashboardEndpoints(store: DashboardStore, allowed: (origin: string | undefined) => boolean): (request: IncomingMessage, response: ServerResponse) => boolean;
-export declare function validatePresets(values: readonly DashboardPreset[]): DashboardPreset[];
-/** Read-only presets live only for the lifetime of this hub process. */
-export declare function presetEndpoints(presets: readonly DashboardPreset[], allowed: (origin: string | undefined) => boolean): (request: IncomingMessage, response: ServerResponse) => boolean;