@pyric/cli 0.1.0-alpha.9

package/dist/cli/index.js

@@ -0,0 +1,379 @@
+#!/usr/bin/env node
+/**
+ * `pyric` CLI — front door to the bridge + project tooling.
+ *
+ * Subcommands:
+ *   pyric bridge [--port N] [--project ID]
+ *   pyric dev [--port N] [--host H] [--no-cache] [--bridge] [--ui] [--seed FILE] [--no-watch] [--no-open] [--no-capture] [--no-run] [--json] [--persist] [--fresh] [-- <cmd>]
+ *   pyric init [dir] [--template web|node] [--name N] [--force] [--json]
+ *   pyric vendor [dir] [--json]
+ *   pyric snapshot [--out FILE] [--port N] [--force] [--json] [--include-passwords]
+ *   pyric mcp
+ *   pyric firestore rules lint <path>
+ *   pyric firestore rules validate <path>
+ *   pyric firestore rules simulate [--stdin]
+ *   pyric firestore rules resolve <path> [--out <path>]
+ *   pyric firestore indexes generate <path...> [--out <path>]
+ *   pyric storage rules lint <path>
+ *   pyric storage rules simulate [--stdin]
+ *   pyric database rules lint <path>
+ *   pyric database rules validate <path>
+ *   pyric database rules simulate [--stdin]
+ *   pyric database rules generate [--config <path>] [--out <path>]
+ *   pyric --help
+ *   pyric --version
+ *
+ * Env vars:
+ *   PYRIC_PORT                       — bridge port (default 5174)
+ *   PYRIC_PROJECT                    — project label for bridge health and audit output
+ *   PYRIC_VERBOSE                    — set to 1 for per-tool-call logging
+ *   FIREBASE_SA_BASE64               — base64-encoded service-account JSON (Rules Test API verify)
+ *   GOOGLE_APPLICATION_CREDENTIALS   — path to service-account JSON (Rules Test API verify)
+ *
+ * Exit codes:
+ *   0  success
+ *   1  usage error
+ *   2  runtime error
+ */
+import { startServer } from '@pyric/cli/bridge';
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from './parse-args.js';
+import { runInit, runVendor } from './init.js';
+import { runServe } from './serve.js';
+import { runSnapshot } from './snapshot.js';
+import { runVerify } from './verify.js';
+import { runMcpProxy } from './mcp-proxy.js';
+import { pyricVersion } from '../serve/standalone-assets.js';
+import { cliVersion } from '../pkg-version.js';
+import { FIREBASE_TESTED_AGAINST } from '../version/compat-target.js';
+import { dispatchServiceCommand } from './service-commands.js';
+// The standalone binary bakes the real `pyric` version onto the embedded-assets
+// global; the npm bin has no such global and falls back to '0.0.0'.
+const VERSION = pyricVersion();
+function printUsage() {
+    process.stdout.write(`pyric ${VERSION}
+Firebase for agents — bridge an in-browser pyric sandbox to external MCP
+clients (Claude Code, Cursor, ...).
+
+USAGE
+  pyric bridge [flags]
+  pyric dev [flags] [-- <cmd>]
+  pyric init [dir] [--template=web|node]
+  pyric snapshot [--out=FILE]
+  pyric verify [fixture|dir] [--engine sandbox|rules-test-api|both]
+  pyric verify cases [fixture] [--service firestore] [--out FILE]
+  pyric firestore rules lint <path>
+  pyric firestore rules validate <path>
+  pyric firestore rules simulate [--stdin]
+  pyric firestore rules resolve <path> [--out <path>]
+  pyric firestore indexes generate <path...> [--out <path>]
+  pyric storage rules lint <path>
+  pyric storage rules simulate [--stdin]
+  pyric database rules lint <path>
+  pyric database rules validate <path>
+  pyric database rules simulate [--stdin]
+  pyric database rules generate [--config <path>] [--out <path>]
+  pyric --help
+  pyric --version
+
+COMMANDS
+  bridge                     Start the HTTP+WebSocket bridge external MCP clients point at.
+  dev                        Serve the app locally with the pyric sandbox standing in for
+                             Firebase — unmodified firebase/* imports hit an in-page sandbox
+                             with your firestore.rules deployed. Also runs your own dev
+                             command (\`-- <cmd>\`, else the package.json \`dev\` script) with
+                             unchanged firebase-admin/firebase imports routed to the
+                             sandbox (PYRIC_SANDBOX + \`--import @pyric/cli/register\`). A
+                             firebase.json Functions source is discovered automatically;
+                             supported RTDB onValueCreated exports run in isolated Node.
+  init [dir]                 Scaffold a pyric project. --template=web (default; Vite app
+                             on \`@pyric/cli/vite\`), static (\`pyric dev\`), or node.
+                             --name=NAME --force (overwrite scaffold files) --json (machine
+                             output on stdout). Never prompts; rerunning is safe.
+                             Greenfield shortcut: \`npm create pyric [dir]\`.
+  vendor [dir]               Retrofit: vendor pyric + @pyric/cli into an existing
+                             project (lay file: tarballs into vendor/ + merge their
+                             deps into package.json). Scaffolds nothing. Then run
+                             bun install. Standalone binary only.
+  mcp                        Stdio MCP server for editors (Cursor / Claude /
+                             Antigravity). Hosts a headless in-process sandbox,
+                             or attaches to a running \`pyric dev --bridge\`
+                             (found via .pyric/serve.json) for shared-live Studio.
+  snapshot [--out=FILE]      Promote lived sandbox state (live dev --persist, else
+                             .pyric/state/state.json) to a committable fixture that
+                             \`pyric dev --seed FILE\` re-serves. Passwords are redacted
+                             by default (--include-passwords keeps them). --port, --force, --json.
+  verify [fixture|dir]       Replay a captured sandbox session against candidate rules
+                             for the Firestore/RTDB services present in the fixture.
+                             No arg replays the latest \`pyric dev\` capture
+                             (.pyric/last-session.json). --service filters services.
+                             --engine sandbox (default), rules-test-api, or both.
+                             Hosted Rules Test API verification is Firestore-only
+                             and uses --project plus the configured Google credentials.
+                             --rules service=path overrides firebase.json resolution
+                             (repeat for mixed captures). --json. Exit 1 on divergence.
+  verify cases [fixture]     Derive Firestore Rules Test API cases from a captured
+                             fixture and print JSON, or write with --out FILE.
+  firestore rules lint       Run the Firestore rules linter against a file.
+  firestore rules validate   Validate Firestore rules structure against a file.
+  firestore rules simulate   Run the local Firestore rules simulator.
+  firestore rules resolve    Resolve Firestore 2+modules imports to one ruleset.
+  firestore indexes generate Generate firestore.indexes.json from application source.
+  storage rules lint         Check Storage rules syntax locally.
+  storage rules simulate     Run the local Storage rules evaluator.
+  database rules lint        Run the Realtime Database rules expression linter.
+  database rules validate    Validate Realtime Database rules expressions.
+  database rules simulate    Run the local Realtime Database rules simulator.
+  database rules generate    Compile a constraints module to database.rules.json.
+CORE FLAGS (dev)
+  --port             Port to serve on. Default 3473 — "FIRE" on a phone keypad (scans forward when taken;
+                     macOS AirPlay squats 5000).
+  --host             Host to bind. Default localhost.
+  --no-cache         Rebuild the served pyric SDK bundles (skip ~/.pyric/serve-cache).
+  --only hosting     Accepted for firebase-serve parity (hosting is all v1 serves).
+  --bridge           Also mount the MCP bridge on the serve origin — agents point
+                     at http://<host>:<port>/__pyric/mcp and drive the sandbox
+                     living in the served page. --project labels health/audit.
+  --ui               Also serve the Pyric Studio app at <url>/__pyric/ui/ (and
+                     mount its disk-backed workspace + project data routes).
+                     Auto-opens Studio instead of the served page. Needs a full
+                     build so the app assets are present.
+  --seed FILE        JSON map of "collection/doc" → fields, loaded admin-style.
+                     Also accepts a pyric state file (from \`pyric snapshot\`,
+                     detected by its version key) — seeds docs + auth users.
+                     into the page sandbox before app code runs.
+  --no-watch         Disable firestore.rules hot-reload (on by default).
+  --no-open          Don't auto-open the browser. dev opens the served page
+                     by default (the sandbox is browser-resident); auto-open
+                     is already suppressed under --json, no TTY, and CI.
+  --no-capture       Don't write the session capture. dev writes
+                     .pyric/last-session.json by default so \`pyric verify\`
+                     can replay your session; --no-capture disables it.
+  --allowed-host H   Allow an extra Host header past the DNS-rebinding guard
+                     (comma-separated; localhost/127.0.0.1 always allowed).
+  --persist          Persist sandbox state (docs + auth users) to
+                     .pyric/state/state.json — survives reloads and dev
+                     restarts. Once a state file exists it wins; --seed
+                     applies only on the first (state-less) run. Ephemeral
+                     is the default.
+  --fresh            Requires --persist: discard the existing state file and
+                     re-seed from scratch (escape hatch when you've edited
+                     seed.json). Without --persist, --fresh errors — there is
+                     no state file to discard. Half-reset warning: a browser
+                     tab that already has sandbox data in IndexedDB keeps it
+                     and writes it back to the new file; also clear the
+                     browser store (Studio → Settings → Reset, or an
+                     incognito window) for a full reset.
+  -- <cmd>           Run <cmd> once the host is up, with PYRIC_SANDBOX set and
+                     NODE_OPTIONS extended with --import @pyric/cli/register
+                     so firebase-admin/firebase resolve to the sandbox. When
+                     omitted, the package.json \`dev\` script runs (via the
+                     detected package manager); no script → host-only.
+  --no-run           Don't run the project's dev command (for users with their
+                     own process manager). A declared Functions source still
+                     runs. --json skips the dev command unless a \`-- <cmd>\`
+                     is given explicitly.
+  --json             One machine-readable line on stdout ({url, port, mcpUrl,
+                     rulesHash, persist, restoredDocs, restoredUsers}); the
+                     banner moves to stderr. Readiness probe:
+                     GET <url>/__pyric/init.json → 200 (live rules hash).
+
+CORE FLAGS (bridge)
+  --port             Port to bind on 127.0.0.1. Default 5174. Env: PYRIC_PORT.
+  --project          Project label surfaced in /health + audit output.
+                     Env: PYRIC_PROJECT.
+
+CREDENTIALS
+  Rules Test API verification resolves existing Google credentials:
+    1. FIREBASE_SA_BASE64            base64-encoded service-account JSON (CI)
+    2. GOOGLE_APPLICATION_CREDENTIALS  path to a service-account JSON file
+    3. ADC                           \`gcloud auth application-default login\` (ambient)
+  PYRIC_PROJECT / --project          Firebase project id for Rules Test API verification
+`);
+}
+function printVersion() {
+    process.stdout.write(`@pyric/cli ${cliVersion()}\n` +
+        `Firebase ${FIREBASE_TESTED_AGAINST} (conformance-tested against this release)\n`);
+}
+async function runBridge(parsed) {
+    const removedFlags = [
+        'mode',
+        'auto-approve',
+        'require-confirm',
+        'require-confirm-all',
+        'confirm-timeout',
+        'non-interactive',
+    ];
+    for (const flag of removedFlags) {
+        if (parsed.flags.has(flag)) {
+            process.stderr.write(`pyric: unknown option '--${flag}' for pyric bridge.\n`);
+            return 1;
+        }
+    }
+    const flagPort = parsed.flags.get('port');
+    const port = typeof flagPort === 'string'
+        ? Number(flagPort)
+        : process.env.PYRIC_PORT
+            ? Number(process.env.PYRIC_PORT)
+            : undefined;
+    if (port !== undefined && (!Number.isFinite(port) || port < 1 || port > 65535)) {
+        process.stderr.write(`pyric: invalid --port '${flagPort ?? process.env.PYRIC_PORT}'.\n`);
+        return 1;
+    }
+    const flagProject = parsed.flags.get('project');
+    const project = typeof flagProject === 'string' ? flagProject : process.env.PYRIC_PROJECT ?? undefined;
+    let handle;
+    try {
+        handle = await startServer({
+            port,
+            project,
+        });
+    }
+    catch (err) {
+        process.stderr.write(`pyric: failed to start bridge: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 2;
+    }
+    // Graceful shutdown. Idempotent because:
+    //   1. npx forwards SIGINT to its child AND the terminal sends SIGINT
+    //      to the process group, so one Ctrl-C delivers SIGINT TWICE to
+    //      this process — without a guard, the handler ran twice and
+    //      printed everything twice.
+    //   2. An impatient user mashing Ctrl-C expects "now I mean it" to
+    //      force-exit, not enqueue more clean-shutdowns.
+    let shuttingDown = false;
+    const stop = async (signal) => {
+        if (shuttingDown) {
+            process.stderr.write('pyric: force-exiting\n');
+            process.exit(130);
+        }
+        shuttingDown = true;
+        process.stdout.write(`\npyric: received ${signal}, stopping bridge...\n`);
+        // Hard safety net: clean shutdown is ~instant once sockets are
+        // forcibly closed (see handle.stop in standalone.ts). If something
+        // hangs anyway — peer pre-handshake, MCP transport in mid-write —
+        // don't make the user wait forever.
+        const forceExitTimer = setTimeout(() => {
+            process.stderr.write('pyric: shutdown taking longer than expected, force-exiting\n');
+            process.exit(130);
+        }, 2000);
+        forceExitTimer.unref();
+        try {
+            await handle.stop();
+        }
+        catch (err) {
+            process.stderr.write(`pyric: error during shutdown: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        clearTimeout(forceExitTimer);
+        process.exit(signal === 'SIGINT' ? 130 : 0);
+    };
+    process.on('SIGINT', () => void stop('SIGINT'));
+    process.on('SIGTERM', () => void stop('SIGTERM'));
+    process.stdout.write(`\npyric bridge ${VERSION} ready\n` +
+        `  target:  sandbox\n` +
+        `  project: ${handle.bridge.project}\n` +
+        `  health:  ${handle.url}/health\n` +
+        `  mcp:     ${handle.url}/mcp\n` +
+        `  sandbox: ${handle.url.replace('http://', 'ws://')}/sandbox\n` +
+        (handle.auditLogPath ? `  audit:   ${handle.auditLogPath}\n` : '') +
+        `\nRegister with Claude Code:\n` +
+        `  claude mcp add --transport http pyric ${handle.url}/mcp --scope project\n` +
+        `\nBridge will log peer connect/disconnect to stderr. Set PYRIC_VERBOSE=1 for per-tool-call logs.\n` +
+        `Press Ctrl-C to stop.\n`);
+    // Keep the event loop alive.
+    return await new Promise(() => { });
+}
+/**
+ * Dispatch a parsed CLI invocation to its subcommand handler.
+ * Exported so the test suite can drive the dispatcher directly
+ * without spawning a child process. `process.exit` is not called
+ * here — the caller (the top-level `main()` below) does that.
+ */
+export async function dispatch(parsed) {
+    if (parsed.flags.get('help') || parsed.flags.get('h')) {
+        printUsage();
+        return 0;
+    }
+    if (parsed.flags.get('version') || parsed.flags.get('v')) {
+        printVersion();
+        return 0;
+    }
+    const serviceCommand = await dispatchServiceCommand(parsed);
+    if (serviceCommand !== null)
+        return serviceCommand;
+    switch (parsed.subcommand) {
+        case null:
+        case undefined:
+            printUsage();
+            return parsed.subcommand === null ? 0 : 1;
+        case 'bridge':
+            return await runBridge(parsed);
+        case 'dev':
+            return await runServe(parsed);
+        case 'snapshot':
+            return await runSnapshot(parsed);
+        case 'verify':
+            return await runVerify(parsed);
+        case 'mcp':
+            return await runMcpProxy(parsed);
+        case 'init':
+            return await runInit(parsed);
+        case 'vendor':
+            return await runVendor(parsed);
+        default:
+            process.stderr.write(`pyric: unknown command '${parsed.subcommand}'.\n\n`);
+            printUsage();
+            return 1;
+    }
+}
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    return dispatch(parsed);
+}
+// Re-export parseArgs so the bin script + tests can share the parser.
+export { parseArgs } from './parse-args.js';
+/**
+ * True when this module is the executable entry rather than an import.
+ *
+ * Bun identifies source and compiled entry points with `import.meta.main`.
+ * Node does not, so compare real paths there: resolving both sides preserves
+ * npm's `node_modules/.bin/pyric` symlink behavior that a textual path check
+ * previously broke.
+ */
+export function isDirectRun() {
+    if (import.meta.main)
+        return true;
+    const argvEntry = process.argv[1];
+    if (!argvEntry)
+        return false;
+    try {
+        return realpathSync(argvEntry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectRun()) {
+    main().then((code) => exitAfterFlush(code), (err) => {
+        process.stderr.write(`pyric: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+        exitAfterFlush(2);
+    });
+}
+/**
+ * Drain stdout + stderr before exiting. `process.exit()` does NOT wait
+ * for pipe-buffered output to flush — `process.stdout.write(text)`
+ * against a pipe (which `bash -c '$(pyric --help)'` creates) queues
+ * the data, and a bare `process.exit(0)` discards it on Linux Node 20.
+ * Symptom: `pyric --help | cat` prints nothing in CI but works in a
+ * TTY. The zero-byte write + callback pattern below queues behind any
+ * pending writes and only exits once they've been flushed to the
+ * underlying fd. See nodejs/node #6379.
+ */
+function exitAfterFlush(code) {
+    let pending = 2;
+    const done = () => { if (--pending === 0)
+        process.exit(code); };
+    process.stdout.write('', done);
+    process.stderr.write('', done);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `pyric init` — scaffold a pyric project (v2, agent-first).
+ *
+ *   pyric init [dir] [--name N] [--template web|node|static] [--force] [--json]
+ *              [--deps vendor|npm] [--pyric-version X]
+ *
+ * Scaffold templates and file writing live in `create-pyric`. This module
+ * adds standalone-binary vendor mode (`--deps vendor`) and `pyric vendor`.
+ */
+import { writeFile, readFile, mkdir } from 'node:fs/promises';
+import type { ParsedArgs } from './parse-args.js';
+import { TEMPLATES, applyDepsMode, mergeIntoExistingPackageJson, type ScaffoldTemplate, type DepsMode } from 'create-pyric';
+export type { DepsMode, ScaffoldTemplate };
+export { TEMPLATES, applyDepsMode, mergeIntoExistingPackageJson };
+export declare function resolveDepsMode(parsed: ParsedArgs, env?: Record<string, string | undefined>): DepsMode;
+export interface InitResult {
+    template: 'web' | 'node' | 'static';
+    dir: string;
+    depsMode: DepsMode;
+    created: string[];
+    merged: string[];
+    skipped: string[];
+    conflicts: Array<{
+        key: string;
+        existing: unknown;
+        wanted: unknown;
+    }>;
+    nextSteps: string[];
+}
+export interface InitDeps {
+    writeFile?: typeof writeFile;
+    readFile?: typeof readFile;
+    mkdir?: typeof mkdir;
+    exists?: (path: string) => Promise<boolean>;
+    cwd?: string;
+    stdout?: {
+        write(s: string): void;
+    };
+    stderr?: {
+        write(s: string): void;
+    };
+}
+export declare function runInit(parsed: ParsedArgs, deps?: InitDeps): Promise<number>;
+export declare const VENDOR_TEMPLATE: ScaffoldTemplate;
+/**
+ * `pyric vendor [dir]` — lay vendored tarballs into an existing project.
+ * Standalone-binary only.
+ */
+export declare function runVendor(parsed: ParsedArgs, deps?: InitDeps): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAU,MAAM,kBAAkB,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,SAAS,EACT,aAAa,EACb,4BAA4B,EAI5B,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EAEd,MAAM,cAAc,CAAC;AAQtB,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,4BAA4B,EAAE,CAAC;AAElE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,QAAQ,CAMV;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,QAAQ,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACrC;AAeD,wBAAsB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAyEtF;AAED,eAAO,MAAM,eAAe,EAAE,gBAO7B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqFxF"}

package/dist/cli/init.js

@@ -0,0 +1,182 @@
+/**
+ * `pyric init` — scaffold a pyric project (v2, agent-first).
+ *
+ *   pyric init [dir] [--name N] [--template web|node|static] [--force] [--json]
+ *              [--deps vendor|npm] [--pyric-version X]
+ *
+ * Scaffold templates and file writing live in `create-pyric`. This module
+ * adds standalone-binary vendor mode (`--deps vendor`) and `pyric vendor`.
+ */
+import { writeFile, readFile, mkdir, access } from 'node:fs/promises';
+import { join, basename, resolve } from 'node:path';
+import { TEMPLATES, applyDepsMode, mergeIntoExistingPackageJson, packageJsonFor, normalizeBoolFlags as normalizeScaffoldBoolFlags, runScaffold, } from 'create-pyric';
+import { isStandalone, hasEmbeddedTarballs, embeddedVersion, materializeVendorTarballs, } from '../serve/standalone-assets.js';
+export { TEMPLATES, applyDepsMode, mergeIntoExistingPackageJson };
+export function resolveDepsMode(parsed, env = process.env) {
+    const flag = parsed.flags.get('deps');
+    if (flag === 'vendor' || flag === 'npm')
+        return flag;
+    const fromEnv = env.PYRIC_INIT_DEPS;
+    if (fromEnv === 'vendor' || fromEnv === 'npm')
+        return fromEnv;
+    return isStandalone() && hasEmbeddedTarballs() ? 'vendor' : 'npm';
+}
+async function defaultExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeBoolFlags(parsed) {
+    normalizeScaffoldBoolFlags(parsed.flags, parsed.positional);
+}
+export async function runInit(parsed, deps = {}) {
+    const err = deps.stderr ?? process.stderr;
+    normalizeBoolFlags(parsed);
+    const templateFlag = parsed.flags.get('template');
+    const templateName = typeof templateFlag === 'string' ? templateFlag : 'web';
+    if (templateName !== 'web' && templateName !== 'node' && templateName !== 'static') {
+        err.write(`pyric init: unknown template '${templateName}' (expected web|node|static)\n`);
+        return 1;
+    }
+    const depsFlag = parsed.flags.get('deps');
+    if (depsFlag !== undefined && depsFlag !== 'vendor' && depsFlag !== 'npm') {
+        err.write(`pyric init: --deps must be 'vendor' or 'npm' (got '${String(depsFlag)}')\n`);
+        return 1;
+    }
+    const depsMode = resolveDepsMode(parsed);
+    if (depsMode === 'vendor' && !(isStandalone() && hasEmbeddedTarballs())) {
+        err.write(`pyric init: --deps vendor needs the standalone binary (with embedded packages). Use --deps npm.\n`);
+        return 1;
+    }
+    const versionFlag = parsed.flags.get('pyric-version');
+    const pinVersion = typeof versionFlag === 'string' && versionFlag.length > 0
+        ? versionFlag
+        : isStandalone()
+            ? embeddedVersion()
+            : null;
+    const cwd = deps.cwd ?? process.cwd();
+    const dir = parsed.positional[0] ? resolve(cwd, parsed.positional[0]) : cwd;
+    const nameFlag = parsed.flags.get('name');
+    const projectName = typeof nameFlag === 'string' && nameFlag.length > 0 ? nameFlag : basename(dir);
+    const template = TEMPLATES[templateName];
+    let effective = template;
+    const preCreated = [];
+    if (depsMode === 'vendor') {
+        try {
+            const vendorSpecs = await materializeVendorTarballs(dir);
+            for (const spec of Object.values(vendorSpecs))
+                preCreated.push(spec.replace(/^file:/, ''));
+            effective = applyDepsMode(template, 'vendor', { vendorSpecs });
+        }
+        catch (e) {
+            err.write(`pyric init: failed to vendor packages: ${e instanceof Error ? e.message : String(e)}\n`);
+            return 2;
+        }
+    }
+    else {
+        effective = applyDepsMode(template, 'npm', { version: pinVersion });
+    }
+    return runScaffold({
+        dir,
+        template: templateName,
+        name: projectName,
+        force: parsed.flags.get('force') === true,
+        json: parsed.flags.get('json') === true,
+        depsMode,
+        effectiveTemplate: effective,
+        pinVersion,
+        commandLabel: 'pyric init',
+        preCreated,
+    }, deps);
+}
+export const VENDOR_TEMPLATE = {
+    scripts: {},
+    dependencies: {},
+    devDependencies: { '@pyric/cli': '*' },
+    dirs: [],
+    files: () => [],
+    nextSteps: [],
+};
+/**
+ * `pyric vendor [dir]` — lay vendored tarballs into an existing project.
+ * Standalone-binary only.
+ */
+export async function runVendor(parsed, deps = {}) {
+    const out = deps.stdout ?? process.stdout;
+    const err = deps.stderr ?? process.stderr;
+    const cwd = deps.cwd ?? process.cwd();
+    const write = deps.writeFile ?? writeFile;
+    const read = deps.readFile ?? readFile;
+    const mk = deps.mkdir ?? mkdir;
+    const exists = deps.exists ?? defaultExists;
+    normalizeBoolFlags(parsed);
+    const json = parsed.flags.get('json') === true;
+    const report = json ? err : out;
+    if (!(isStandalone() && hasEmbeddedTarballs())) {
+        err.write('pyric vendor: needs the standalone binary (it carries the embedded pyric / ' +
+            '@pyric/cli tarballs). A monorepo/npm checkout has nothing to vendor; depend ' +
+            'on the packages directly instead.\n');
+        return 1;
+    }
+    const dir = parsed.positional[0] ? resolve(cwd, parsed.positional[0]) : cwd;
+    const projectName = basename(dir);
+    let vendorSpecs;
+    try {
+        await mk(dir, { recursive: true });
+        vendorSpecs = await materializeVendorTarballs(dir);
+    }
+    catch (e) {
+        err.write(`pyric vendor: failed to lay down vendor tarballs: ${e instanceof Error ? e.message : String(e)}\n`);
+        return 2;
+    }
+    const effective = applyDepsMode(VENDOR_TEMPLATE, 'vendor', { vendorSpecs });
+    const pkgPath = join(dir, 'package.json');
+    let added;
+    let conflicts = [];
+    let created = false;
+    try {
+        if (await exists(pkgPath)) {
+            const raw = String(await read(pkgPath, 'utf-8'));
+            const merge = mergeIntoExistingPackageJson(raw, projectName, effective);
+            conflicts = merge.conflicts;
+            added = merge.added;
+            if (!merge.unchanged)
+                await write(pkgPath, merge.contents, 'utf-8');
+        }
+        else {
+            await write(pkgPath, packageJsonFor(projectName, effective), 'utf-8');
+            added = [];
+            created = true;
+        }
+    }
+    catch (e) {
+        err.write(`pyric vendor: failed to update package.json: ${e instanceof Error ? e.message : String(e)}\n`);
+        return 2;
+    }
+    report.write(`pyric vendor: vendored pyric + @pyric/cli into ${join(dir, 'vendor')}\n`);
+    for (const spec of Object.values(vendorSpecs)) {
+        report.write(`  + ${spec.replace(/^file:/, '')}\n`);
+    }
+    if (created) {
+        report.write('  + package.json (created)\n');
+    }
+    else if (added.length === 0) {
+        report.write('  · package.json already had the vendored deps\n');
+    }
+    else {
+        report.write(`  ~ package.json (added: ${added.join(', ')})\n`);
+    }
+    for (const c of conflicts) {
+        report.write(`  · ${c.key}: kept ${JSON.stringify(c.existing)} (pyric would set ${JSON.stringify(c.wanted)})\n`);
+    }
+    report.write('\n  next: run `bun install` (or npm/pnpm install) to install the vendored packages.\n');
+    if (json) {
+        out.write(JSON.stringify({ dir, vendored: Object.keys(vendorSpecs), added, conflicts, created }) + '\n');
+    }
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/mcp-proxy.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedArgs } from './parse-args.js';
+import { discoverServe } from '../serve/discovery.js';
+export { discoverServe } from '../serve/discovery.js';
+/** Injectable seams for testing the attach-vs-headless selection. */
+export interface McpProxyDeps {
+    discover?: typeof discoverServe;
+    headless?: (cwd: string) => Promise<number>;
+}
+export declare function runMcpProxy(_parsed: ParsedArgs, cwd?: string, deps?: McpProxyDeps): Promise<number>;
+//# sourceMappingURL=mcp-proxy.d.ts.map

package/dist/cli/mcp-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-proxy.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-proxy.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAc,MAAM,uBAAuB,CAAC;AAKlE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAsBtD,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,aAAa,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,GAAE,MAAsB,EAC3B,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,CAAC,CAsHjB"}