pyric-tools 0.1.0-alpha.7

package/dist/serve/bundler.js

@@ -0,0 +1,452 @@
+/**
+ * `pyric dev` SDK bundler — builds the browser-standalone ESM bundles the
+ * import map points `firebase/*` at (`/__pyric/sdk/*.js`).
+ *
+ * esbuild (a real dependency — the `pyric` bin runs under node via npx, so
+ * Bun.build is unavailable) bundles the wrapper entries in `entries/` with
+ * SPLITTING so the shared runtime chunk holds exactly ONE sandbox per page:
+ * both the auth and firestore bundles must close over the same instance.
+ *
+ * Three bundler plugins make pyric browser-standalone:
+ *   - `pyric/*` resolver — resolves `pyric/...` specifiers from THIS package's
+ *     dependency context (entries may live in a temp dir that lacks pyric).
+ *   - `firebase/*` peer stubs — pyric's PROD backends import the real SDK; the
+ *     sandbox-served page never takes those code paths, so each `firebase/x`
+ *     resolves to an INERT proxy module (every member returns the proxy on
+ *     get/call/construct — it never throws, because pyric builds its prod
+ *     representations EAGERLY even on the sandbox path, e.g. `where()` calls
+ *     `fb.where(...)`). The export-name list is GENERATED by scanning pyric's
+ *     dist — both `import/export { … } from 'firebase/x'` named bindings AND
+ *     `import * as fb` namespace-member accesses (`fb.where`, …) — so it cannot
+ *     drift when pyric does. See `collectFirebaseBindings` / `stubModuleSource`.
+ *   - node-builtin shims (`url`/`fs`/`path`) — still load-bearing despite the
+ *     Phase U resolver split: `pyric/firestore` re-exports the agent tool
+ *     factories (`firestore/index.js` → `rules/tools.js`), and tools.js
+ *     statically imports the NODE module resolver. The browser path never
+ *     calls into disk reads, so benign shims suffice. Droppable only when
+ *     pyric breaks that static chain (tracked in #553).
+ *
+ * Output is cached under `~/.pyric/serve-cache/<pyric-version>-<hash>/` so a
+ * warm `pyric dev` start skips the (~seconds) bundle step. `--no-cache`
+ * bypasses.
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, readdirSync, existsSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as esbuild from 'esbuild';
+/** Modules the import map serves. Keys are the bare specifiers app code uses. */
+export const SDK_MODULES = [
+    'firebase/app',
+    'firebase/auth',
+    'firebase/firestore',
+    'firebase/database',
+    'firebase/storage',
+];
+/**
+ * The wrapper entries shipped with pyric-tools, located relative to this
+ * module: compiled `.js` siblings when running from dist (npx install), `.ts`
+ * sources in the workspace (tests / dev). esbuild bundles either.
+ */
+export function defaultSdkEntries() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pick = (name) => {
+        const js = join(here, 'entries', `${name}.js`);
+        if (existsSync(js))
+            return js;
+        const ts = join(here, 'entries', `${name}.ts`);
+        if (existsSync(ts))
+            return ts;
+        throw new Error(`pyric dev: missing SDK entry '${name}' next to ${here}`);
+    };
+    return {
+        app: pick('app'),
+        auth: pick('auth'),
+        firestore: pick('firestore'),
+        database: pick('database'),
+        storage: pick('storage'),
+        init: pick('init'),
+    };
+}
+/**
+ * Resolve the built Studio app dir (the plugin's `ui` option + the CLI's
+ * `--ui`). Reached by file path so pyric-tools never imports `@pyric/studio`:
+ * the packaged location (`dist/serve/studio-ui`, copied at build) or, in the
+ * monorepo, the sibling studio build. Null when neither exists. The standalone
+ * binary embeds these same bytes instead (see `standalone-assets.ts`).
+ */
+export function resolveStudioUiDir() {
+    const candidates = [
+        new URL('./studio-ui/', import.meta.url),
+        new URL('../../../studio/dist/app/', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        const dir = fileURLToPath(candidate);
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+/**
+ * Resolve the built playground app dir. `pyric dev --ui` embeds this as the
+ * first-class Studio Playground tab under `/__pyric/playground/`.
+ */
+export function resolvePlaygroundUiDir() {
+    const candidates = [
+        new URL('./playground-ui/', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        const dir = fileURLToPath(candidate);
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+/**
+ * Resolve the built docs site dir (site-docs). `pyric dev --ui` embeds it so
+ * the Studio Docs tab has local docs without the hosted site. Built with base
+ * `/__pyric/ui/` (see scripts/build.sh) so every page/asset/twin URL resolves
+ * under the CLI mount: pages at `/__pyric/ui/docs/<slug>/`, assets at
+ * `/__pyric/ui/_astro/*`, the search index at `/__pyric/ui/docs/index.json`,
+ * and the shell chrome's tab links back at `/__pyric/ui/<tab>`. The dir holds
+ * the site-docs `dist/` verbatim: `docs/`, `_astro/`, `index.html`, `llms.txt`.
+ */
+export function resolveDocsUiDir() {
+    const candidates = [
+        new URL('./docs-ui/', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        const dir = fileURLToPath(candidate);
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+// ─── pyric dist discovery ─────────────────────────────────────────────
+/** Locate the installed pyric package root (works in the workspace and when
+ *  pyric-tools is npm-installed — pyric is a direct dependency). */
+export function pyricPackageRoot() {
+    // Resolve a real exported subpath, then walk up to the package root.
+    const entry = fileURLToPath(import.meta.resolve('pyric/firestore'));
+    let dir = dirname(entry);
+    while (dir.includes(sep) && !existsSync(join(dir, 'package.json'))) {
+        dir = dirname(dir);
+    }
+    const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+    if (pkg.name !== 'pyric') {
+        throw new Error(`pyric dev: expected to resolve the pyric package, found '${pkg.name}' at ${dir}`);
+    }
+    return dir;
+}
+export function pyricVersion(root = pyricPackageRoot()) {
+    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+    return pkg.version ?? '0.0.0';
+}
+// ─── firebase/* stub generation ───────────────────────────────────────
+/**
+ * Scan pyric's dist for every binding it pulls from each `firebase/<mod>` peer,
+ * so the stub module can export all of them:
+ *   - named imports / re-exports (`import { X }` / `export { X } from`), which
+ *     hard-fail the build when missing; AND
+ *   - namespace-import members (`import * as fb` → `fb.where`, `fb.query`, …).
+ *     These MUST be covered too: pyric builds its prod representation eagerly
+ *     even on the sandbox path (e.g. `where()` calls `fb.where(...)`), so a
+ *     missing namespace member is hit at runtime ("(void 0) is not a function").
+ * Scanning the COMPILED dist means TS type-only accesses are already erased.
+ */
+export function collectFirebaseBindings(distDir) {
+    const bindings = new Map();
+    const files = readdirSync(distDir, { recursive: true });
+    const re = /(?:import|export)\s*\{([^}]*)\}\s*from\s*['"]firebase\/([a-z-]+)['"]/g;
+    // Namespace imports: `import * as fb from 'firebase/x'`. pyric accesses these
+    // peers via `fb.<member>` and — crucially — builds the prod representation
+    // EAGERLY even on the sandbox path (e.g. `where()` calls `fb.where(...)` to
+    // populate `_fbFilter`, which the sandbox path then ignores). So `fb.<member>`
+    // IS touched in a sandbox-served page; the stub MUST export every accessed
+    // member or the call hits `undefined` ("(void 0) is not a function"). We scan
+    // the COMPILED dist, so TS type-only accesses (`fb.WhereFilterOp`) are already
+    // erased and don't pollute the set.
+    const nsRe = /import\s*\*\s*as\s+([A-Za-z_$][\w$]*)\s+from\s*['"]firebase\/([a-z-]+)['"]/g;
+    for (const rel of files) {
+        if (!rel.endsWith('.js'))
+            continue;
+        const source = readFileSync(join(distDir, rel), 'utf8');
+        for (const m of source.matchAll(re)) {
+            const mod = `firebase/${m[2]}`;
+            const set = bindings.get(mod) ?? new Set();
+            for (const piece of m[1].split(',')) {
+                // `X as Y` — the EXPORT name (X) is what the stub must provide.
+                const name = piece.trim().split(/\s+as\s+/)[0]?.trim();
+                if (name)
+                    set.add(name);
+            }
+            bindings.set(mod, set);
+        }
+        for (const m of source.matchAll(nsRe)) {
+            const alias = m[1];
+            const mod = `firebase/${m[2]}`;
+            const set = bindings.get(mod) ?? new Set();
+            const memberRe = new RegExp(`\\b${alias}\\.([A-Za-z_$][\\w$]*)`, 'g');
+            for (const mm of source.matchAll(memberRe))
+                set.add(mm[1]);
+            bindings.set(mod, set);
+        }
+    }
+    return bindings;
+}
+/**
+ * Synthesize the stub module source for one `firebase/<mod>` specifier.
+ *
+ * The stub is an INERT proxy: every access returns the proxy, every call /
+ * construct returns the proxy (NOT a throw). pyric builds prod representations
+ * eagerly even on the sandbox path — `where()` calls `fb.where(...)`, `or()`
+ * calls `fb.or(...)`, `new fb.Bytes()` — and the SANDBOX path then ignores the
+ * result. A throwing stub would break those constructors; an inert one lets
+ * them produce a harmless sentinel that's never used. The sandbox-served page
+ * never takes the real prod path, so the inert result is never consumed. (The
+ * loud provenance banner remains the "this is not the real SDK" signal.)
+ */
+export function stubModuleSource(_specifier, names) {
+    const deny = `const deny = new Proxy(function () {}, {
+  apply() { return deny; },
+  construct() { return deny; },
+  get() { return deny; },
+});
+export default deny;`;
+    const named = [...names].map((n) => `export const ${n} = deny;`).join('\n');
+    return `${deny}\n${named}\n`;
+}
+// ─── plugins ──────────────────────────────────────────────────────────
+function firebaseStubPlugin(bindings) {
+    return {
+        name: 'pyric-serve-firebase-stub',
+        setup(build) {
+            build.onResolve({ filter: /^firebase\// }, (args) => ({
+                path: args.path,
+                namespace: 'pyric-firebase-stub',
+            }));
+            build.onLoad({ filter: /.*/, namespace: 'pyric-firebase-stub' }, (args) => ({
+                contents: stubModuleSource(args.path, bindings.get(args.path) ?? new Set()),
+                loader: 'js',
+            }));
+        },
+    };
+}
+/** Resolve `pyric/*` specifiers from THIS package's own dependency context
+ *  (`import.meta.resolve`) rather than from the entry file's directory —
+ *  entries may live in a temp dir or the user's project, neither of which
+ *  has pyric in scope; pyric-tools always does (direct dependency). */
+function pyricResolvePlugin() {
+    return {
+        name: 'pyric-serve-resolve-pyric',
+        setup(build) {
+            build.onResolve({ filter: /^pyric(\/|$)/ }, (args) => ({
+                path: fileURLToPath(import.meta.resolve(args.path)),
+            }));
+        },
+    };
+}
+/** The node builtins pyric's browser graph reaches for (via the rules module
+ *  resolver). Bare and `node:`-prefixed both match. */
+export const NODE_BUILTIN_RE = /^(node:)?(url|fs|path)$/;
+/** Benign browser shim SOURCE per builtin (see header — droppable only when
+ *  pyric breaks the `firestore/index → rules/tools → modules/resolver` static
+ *  chain, #553). Exported so the Vite plugin (`./vite`) reuses the SAME shims
+ *  through its own resolveId/load + optimizeDeps esbuild pass, instead of
+ *  re-deriving them. */
+export const NODE_BUILTIN_SHIMS = {
+    fs: `const no = () => { throw new Error('pyric dev: fs is not available in the browser'); };
+export const readFileSync = no; export const existsSync = () => false;
+export const readdirSync = no; export const writeFileSync = no;
+export default { readFileSync, existsSync, readdirSync, writeFileSync };`,
+    url: `export const fileURLToPath = (u) => String(u).replace('file://', '');
+export const pathToFileURL = (p) => new URL('file://' + p);
+export default { fileURLToPath, pathToFileURL };`,
+    path: `export const join = (...p) => p.join('/');
+export const dirname = (p) => p.split('/').slice(0, -1).join('/') || '/';
+export const resolve = (...p) => p.join('/');
+export const basename = (p) => p.split('/').pop() ?? '';
+export default { join, dirname, resolve, basename };`,
+};
+function nodeShimPlugin() {
+    return {
+        name: 'pyric-serve-node-shims',
+        setup(build) {
+            build.onResolve({ filter: NODE_BUILTIN_RE }, (args) => ({
+                path: args.path.replace(/^node:/, ''),
+                namespace: 'pyric-node-shim',
+            }));
+            build.onLoad({ filter: /.*/, namespace: 'pyric-node-shim' }, (args) => ({
+                contents: NODE_BUILTIN_SHIMS[args.path],
+                loader: 'js',
+            }));
+        },
+    };
+}
+/** Bump when bundler logic changes in a way that must invalidate caches. */
+const BUNDLER_REV = 3; // 3: collect firebase namespace members + inert (non-throwing) stub
+export function cacheKey(opts, version) {
+    const h = createHash('sha256');
+    h.update(`rev${BUNDLER_REV}`);
+    h.update(version);
+    // Hash the WHOLE local graph, not just the entry files: entries import
+    // sibling modules (runtime, auth-helper-*) whose edits must invalidate the
+    // cache — hashing entries alone served stale bundles (caught by the P3
+    // browser gate). pyric's own dist is covered by the version component.
+    const dirs = new Set();
+    for (const [name, file] of Object.entries(opts.entries).sort()) {
+        h.update(name);
+        h.update(readFileSync(file, 'utf8'));
+        dirs.add(dirname(file));
+    }
+    for (const dir of [...dirs].sort()) {
+        for (const sibling of readdirSync(dir).sort()) {
+            if (!sibling.endsWith('.ts') && !sibling.endsWith('.js'))
+                continue;
+            h.update(sibling);
+            h.update(readFileSync(join(dir, sibling), 'utf8'));
+        }
+    }
+    return `${version}-${h.digest('hex').slice(0, 12)}`;
+}
+// ─── the bundle step ──────────────────────────────────────────────────
+export async function bundleSdk(opts) {
+    const root = pyricPackageRoot();
+    const version = pyricVersion(root);
+    const key = cacheKey(opts, version);
+    const cacheRoot = opts.cacheRoot ?? join(homedir(), '.pyric', 'serve-cache');
+    const outDir = join(cacheRoot, key, 'sdk');
+    if (!opts.noCache && existsSync(join(outDir, '.complete'))) {
+        const files = readdirSync(outDir)
+            .filter((f) => f.endsWith('.js'))
+            .map((f) => join(outDir, f));
+        return { outDir, files, cached: true };
+    }
+    mkdirSync(outDir, { recursive: true });
+    const bindings = collectFirebaseBindings(join(root, 'dist'));
+    const result = await esbuild.build({
+        entryPoints: Object.fromEntries(Object.entries(opts.entries).map(([name, file]) => [name, file])),
+        outdir: outDir,
+        bundle: true,
+        format: 'esm',
+        platform: 'browser',
+        splitting: true,
+        sourcemap: 'linked',
+        minify: opts.minify ?? true,
+        logLevel: 'silent',
+        // Provenance: any stack frame or "view source" into these bundles must
+        // self-identify as the sandbox shim, not the real Firebase SDK.
+        chunkNames: 'pyric-sandbox-[hash]',
+        banner: {
+            js: '/* pyric dev: pyric sandbox shim serving firebase/* — NOT the real Firebase SDK */',
+        },
+        plugins: [pyricResolvePlugin(), nodeShimPlugin(), firebaseStubPlugin(bindings)],
+    });
+    if (result.errors.length > 0) {
+        throw new Error(`pyric dev: SDK bundle failed:\n${result.errors.map((e) => e.text).join('\n')}`);
+    }
+    writeFileSync(join(outDir, '.complete'), new Date().toISOString());
+    const files = readdirSync(outDir)
+        .filter((f) => f.endsWith('.js'))
+        .map((f) => join(outDir, f));
+    return { outDir, files, cached: false };
+}
+// ─── the SharedWorker bundle (Phase 3c.A) ─────────────────────────────────
+/**
+ * Locate the SharedWorker entry (`worker/entry.ts`) — compiled `.js` sibling
+ * from dist, `.ts` source in the workspace. Same dual-resolution as
+ * `defaultSdkEntries`.
+ */
+export function workerEntryPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const js = join(here, 'worker', 'entry.js');
+    if (existsSync(js))
+        return js;
+    const ts = join(here, 'worker', 'entry.ts');
+    if (existsSync(ts))
+        return ts;
+    throw new Error(`pyric dev: missing SharedWorker entry next to ${here}`);
+}
+/**
+ * Content hash of the worker source graph + pyric version. The worker bundle
+ * shares the SDK `outDir` (keyed by the SDK entries), which does NOT cover the
+ * `worker/` sources — so the worker bundle carries its OWN content marker: a
+ * worker-only edit changes this hash and forces a rebuild even when the SDK
+ * cache is warm. (pyric library changes are covered by the version component,
+ * the same model `bundleSdk` uses.)
+ */
+export function workerSourceHash() {
+    const h = createHash('sha256');
+    h.update(`rev${BUNDLER_REV}`);
+    h.update(pyricVersion());
+    const dir = dirname(workerEntryPath());
+    for (const f of readdirSync(dir).sort()) {
+        if (!f.endsWith('.ts') && !f.endsWith('.js'))
+            continue;
+        h.update(f);
+        h.update(readFileSync(join(dir, f), 'utf8'));
+    }
+    return h.digest('hex').slice(0, 16);
+}
+/**
+ * Bundle the SharedWorker entry into a single classic worker script served at
+ * `/__pyric/sdk/worker.js`.
+ *
+ * WHY A SEPARATE BUILD (not part of `bundleSdk`'s splitting graph): a
+ * SharedWorker script is loaded by URL into its OWN realm — it cannot share
+ * the page's runtime chunk. So it is bundled standalone: `splitting: false`,
+ * `format: 'iife'` (the client opens it with `new SharedWorker(url, { type:
+ * 'classic' })`), everything inlined into one file. It reuses the same three
+ * browser-standalone plugins as the SDK bundle (pyric-resolve + node-shims +
+ * firebase-stub) so `pyric/*`, node builtins, and the `firebase/*` peer stubs
+ * resolve identically.
+ *
+ * NOTE: the worker legitimately holds the whole sandbox engine — it IS the
+ * backend — so this bundle is large, but it loads ONCE per origin (not per
+ * page). Trimming node/admin dead paths is tracked as Phase 3b.
+ *
+ * The `.worker-complete` marker is independent of `bundleSdk`'s `.complete`.
+ * Folding the worker source graph into `bundleSdk`'s cache key (so a
+ * worker-only edit invalidates the shared `outDir`) lands with the serve
+ * wiring in 3c.E; until then callers pass `noCache` when iterating.
+ */
+export async function bundleWorker(opts) {
+    const outFile = join(opts.outDir, 'worker.js');
+    const marker = join(opts.outDir, '.worker-complete');
+    const hash = workerSourceHash();
+    if (!opts.noCache &&
+        existsSync(outFile) &&
+        existsSync(marker) &&
+        readFileSync(marker, 'utf8') === hash) {
+        return outFile;
+    }
+    mkdirSync(opts.outDir, { recursive: true });
+    const root = pyricPackageRoot();
+    const bindings = collectFirebaseBindings(join(root, 'dist'));
+    const result = await esbuild.build({
+        entryPoints: [workerEntryPath()],
+        outfile: outFile,
+        bundle: true,
+        format: 'iife',
+        platform: 'browser',
+        splitting: false,
+        sourcemap: 'linked',
+        minify: opts.minify ?? true,
+        logLevel: 'silent',
+        // Bake the build hash so the worker can report its version (staleness
+        // guard): the page warns when a still-running OLD worker is older than the
+        // served bundle. Matches the `<meta name="pyric-worker-v">` value.
+        define: { __PYRIC_WORKER_VERSION__: JSON.stringify(hash) },
+        banner: {
+            js: '/* pyric dev: SharedWorker sandbox host serving firebase/* — NOT the real Firebase SDK */',
+        },
+        plugins: [pyricResolvePlugin(), nodeShimPlugin(), firebaseStubPlugin(bindings)],
+    });
+    if (result.errors.length > 0) {
+        throw new Error(`pyric dev: SharedWorker bundle failed:\n${result.errors.map((e) => e.text).join('\n')}`);
+    }
+    writeFileSync(marker, hash);
+    return outFile;
+}
+//# sourceMappingURL=bundler.js.map

package/dist/serve/bundler.js.map

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

package/dist/serve/capture-store.d.ts

@@ -0,0 +1,27 @@
+/** Relative path (from project root) where the serve capture lives.
+ *  Mirrors `SERVE_CAPTURE_PATH` in `verify.ts` — keep in lockstep. */
+export declare const CAPTURE_RELATIVE_PATH: string;
+export interface CaptureStore {
+    /** Absolute path of the capture file (`<projectDir>/.pyric/last-session.json`). */
+    path: string;
+    /**
+     * Write the fixture JSON verbatim. Creates `.pyric/` if absent.
+     * The body is the page's own JSON-serialized fixture; we store it
+     * as-is so `pyric verify` can hand it straight to the replay engine.
+     */
+    write(fixtureJson: string): void;
+    /**
+     * Read back the last-written fixture JSON verbatim, or `null` when the
+     * capture file does not exist yet (nothing captured this run). Powers
+     * GET /__pyric/capture, which the served SharedWorker fetches on boot to
+     * re-hydrate its in-memory event history after a worker death.
+     */
+    read(): string | null;
+}
+/**
+ * Create a capture store rooted at `projectDir`. Returns a tiny sink that
+ * mirrors the minimal shape of `state-store.ts`: a `path` for banner
+ * reporting and a `write` for the route handler.
+ */
+export declare function createCaptureStore(projectDir: string): CaptureStore;
+//# sourceMappingURL=capture-store.d.ts.map

package/dist/serve/capture-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-store.d.ts","sourceRoot":"","sources":["../../src/serve/capture-store.ts"],"names":[],"mappings":"AAoBA;sEACsE;AACtE,eAAO,MAAM,qBAAqB,QAAsC,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;;OAKG;IACH,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAiBnE"}

package/dist/serve/capture-store.js

@@ -0,0 +1,47 @@
+/**
+ * Capture store for `pyric dev --capture` — the write-side of the
+ * `pyric verify` loop.
+ *
+ * `pyric dev` captures the in-page sandbox session (history + snapshot +
+ * rules) and pushes it here whenever the sandbox changes. `pyric verify`
+ * (no positional arg) reads `SERVE_CAPTURE_PATH` and replays it against
+ * your current rules to surface real divergences. The loop is:
+ *
+ *   pyric dev  →  use your app  →  pyric verify
+ *
+ * The body is stored VERBATIM (the page sends its own JSON.stringify'd
+ * fixture — we never re-serialize it so no wrapper-type drift is
+ * introduced here). The path is intentionally next to the persist store
+ * (.pyric/state/…) so it fits the same .gitignore pattern and feels like
+ * one artifact family.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Relative path (from project root) where the serve capture lives.
+ *  Mirrors `SERVE_CAPTURE_PATH` in `verify.ts` — keep in lockstep. */
+export const CAPTURE_RELATIVE_PATH = join('.pyric', 'last-session.json');
+/**
+ * Create a capture store rooted at `projectDir`. Returns a tiny sink that
+ * mirrors the minimal shape of `state-store.ts`: a `path` for banner
+ * reporting and a `write` for the route handler.
+ */
+export function createCaptureStore(projectDir) {
+    const path = join(projectDir, CAPTURE_RELATIVE_PATH);
+    return {
+        path,
+        write(fixtureJson) {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, fixtureJson);
+        },
+        read() {
+            try {
+                return readFileSync(path, 'utf8');
+            }
+            catch {
+                // ENOENT (nothing captured yet) or any read error → treat as absent.
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=capture-store.js.map

package/dist/serve/capture-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-store.js","sourceRoot":"","sources":["../../src/serve/capture-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;sEACsE;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAoBzE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IACrD,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,WAAmB;YACvB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACnC,CAAC;QACD,IAAI;YACF,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/serve/discovery.d.ts

@@ -0,0 +1,71 @@
+/** Ports probed when the pointer is absent — serve's default scan window PLUS
+ *  the vite-plugin default (5174), which the plain 3473+ window would miss (so a
+ *  vite-only project was never found by scan). The standalone `pyric bridge`
+ *  serves `/health` (not `/__pyric/health`) and writes no pointer, so it is
+ *  registered directly via `claude mcp add`, not discovered here. */
+export declare const SCAN_PORTS: number[];
+export declare const POINTER: string;
+export interface HealthLite {
+    mode?: string;
+    instanceId?: string;
+    /** Whether a browser tab is currently connected as the sandbox peer. */
+    sandboxConnected?: boolean;
+}
+export interface Discovered {
+    mcpUrl: string;
+    /**
+     * The CANONICAL display URL — what a human/browser should OPEN. Comes from
+     * the serve-written pointer when present (`http://localhost:<port>` for the
+     * default host, the explicit `--host` otherwise); falls back to
+     * `http://localhost:<port>`. NEVER a literal loopback address: to a browser
+     * `localhost` and `127.0.0.1` are DIFFERENT ORIGINS (different
+     * SharedWorkers, so different sandboxes), and serve's banner/auto-open use
+     * `localhost` — guidance built from this field must land on the SAME origin.
+     * Node-side connectivity uses `base`/`mcpUrl` instead.
+     */
+    url: string;
+    /** `http://<family>:<port>` the server actually answered on. */
+    base: string;
+    /** Identity pinned at discovery. Null only when talking to an older server
+     *  that predates the instanceId field (matching is then skipped). */
+    instanceId: string | null;
+    source: string;
+}
+/**
+ * Probe BOTH loopback families on a port and return the base that answers.
+ *
+ * Hostname-based URLs are a trap here: serve writes `http://localhost:...`
+ * for humans (browsers dual-stack fine), but `localhost` resolution differs
+ * by runtime — node/undici prefers IPv6 `::1`, and a serve under one runtime
+ * may bind `127.0.0.1`-only while under another binds `::1`-only. So a
+ * discovery client never trusts the hostname: it takes the PORT and tries
+ * explicit `127.0.0.1` and `[::1]`, using whichever the server is actually on.
+ */
+export declare function basesForPort(port: number): string[];
+export declare function probeHealth(base: string): Promise<HealthLite | null>;
+/**
+ * First loopback base on `port` whose health reports a sandbox bridge. With an
+ * `expectedInstanceId`, returns ONLY a family whose health identity matches —
+ * so when two sandboxes collide on one port across families, the client locks
+ * onto the one the pointer names, not merely the first to answer. (An older
+ * server with no `instanceId` field can't be identity-checked; matching is
+ * skipped in that case so the pointer still resolves.)
+ */
+export declare function healthyBase(port: number, expectedInstanceId?: string | null): Promise<{
+    base: string;
+    instanceId: string | null;
+} | null>;
+/**
+ * Canonical display URL for a serve on `port`. Prefers the pointer's own
+ * `url` (serve writes `http://<requested host>:<port>` — `localhost` for the
+ * default, the explicit `--host` otherwise) so guidance shares the origin the
+ * banner/auto-open used; falls back to `http://localhost:<port>` (browsers
+ * resolve `localhost` dual-stack, so it reaches either loopback family).
+ */
+export declare function canonicalServeUrl(port: number, pointerUrl?: string): string;
+/** Find the running serve: pointer first (in `cwd`), then a port scan. The
+ *  pointer gives the PORT and (when present) the identity; the family is
+ *  resolved by probing, so the returned base always uses the address the
+ *  server is actually reachable on. */
+export declare function discoverServe(cwd: string, log?: (m: string) => void, scanPorts?: number[]): Promise<Discovered | null>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/serve/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/serve/discovery.ts"],"names":[],"mappings":"AAqBA;;;;qEAIqE;AACrE,eAAO,MAAM,UAAU,UAAuC,CAAC;AAC/D,eAAO,MAAM,OAAO,QAA+B,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb;yEACqE;IACrE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAS1E;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CAU7D;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAY3E;AAED;;;uCAGuC;AACvC,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAe,EAGnC,SAAS,GAAE,MAAM,EAAe,GAC/B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAwD5B"}