mimetic-cli 0.1.0

package/dist/observer-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-assets.js","sourceRoot":"","sources":["../src/observer-assets.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgxCR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2/BR,CAAC;AACF,CAAC"}

package/dist/observer-data.d.ts

@@ -0,0 +1,53 @@
+import type { RunBundle, RunEvent, RunSimulation, RunStream, RunStreamKind } from "./run.js";
+export declare const OBSERVER_DATA_SCHEMA = "mimetic.observer-data.v1";
+export interface ObserverArtifactLink {
+    label: string;
+    href: string;
+    kind: string;
+}
+export interface ObserverData {
+    schema: typeof OBSERVER_DATA_SCHEMA;
+    schemaVersion: 1;
+    generatedAt: string;
+    run: {
+        runId: string;
+        mode: RunBundle["mode"];
+        status: "contract_proof_only" | "running" | "complete" | "failed";
+        title: string;
+        createdAt: string;
+        simCount: number;
+        persona: RunBundle["persona"];
+        scenario: RunBundle["scenario"];
+        packageName: string | null;
+        redaction: RunBundle["redaction"];
+        lifecycle: RunBundle["lifecycle"];
+        knownGaps: string[];
+    };
+    summary: {
+        streams: number;
+        byKind: Record<RunStreamKind, number>;
+        active: number;
+        blocked: number;
+        warnings: number;
+    };
+    streams: ObserverStream[];
+    events: RunEvent[];
+    artifactLinks: ObserverArtifactLink[];
+    publicSafety: {
+        publishable: false;
+        note: string;
+    };
+    raw: {
+        bundleSchema: string;
+        artifactRoot: string;
+    };
+}
+export interface ObserverStream extends RunStream {
+    sim: RunSimulation;
+    kindLabel: string;
+    statusLabel: string;
+    terminalPlain: string;
+    timeline: RunEvent[];
+}
+export declare function buildObserverData(bundle: RunBundle, generatedAt?: string): ObserverData;
+export declare function stripAnsi(value: string): string;

package/dist/observer-data.js

@@ -0,0 +1,123 @@
+export const OBSERVER_DATA_SCHEMA = "mimetic.observer-data.v1";
+const allKinds = ["ui", "browser", "terminal", "tui", "codex-ui", "artifact", "summary"];
+export function buildObserverData(bundle, generatedAt = new Date().toISOString()) {
+    const byKind = Object.fromEntries(allKinds.map((kind) => [kind, 0]));
+    const events = [...(bundle.events ?? [])];
+    const streams = (bundle.streams ?? []).map((stream) => {
+        const sim = bundle.simulations.find((candidate) => candidate.id === stream.simId) ?? fallbackSimulation(bundle, stream);
+        byKind[stream.kind] += 1;
+        return {
+            ...stream,
+            sim,
+            kindLabel: kindLabel(stream.kind),
+            statusLabel: statusLabel(stream.status),
+            terminalPlain: stripAnsi(stream.terminal?.tail ?? ""),
+            timeline: events.filter((event) => event.simId === sim.id || event.streamId === stream.id)
+        };
+    });
+    const warnings = events.filter((event) => event.level === "warn").length;
+    const blocked = streams.filter((stream) => stream.status === "blocked" || stream.status === "failed").length;
+    const active = streams.filter((stream) => stream.status === "running" || stream.status === "preparing").length;
+    return {
+        schema: OBSERVER_DATA_SCHEMA,
+        schemaVersion: 1,
+        generatedAt,
+        run: {
+            runId: bundle.runId,
+            mode: bundle.mode,
+            status: bundle.review.verdict,
+            title: `${bundle.scenario.title} - ${bundle.persona.name}`,
+            createdAt: bundle.createdAt,
+            simCount: bundle.simCount ?? bundle.simulations.length,
+            persona: bundle.persona,
+            scenario: bundle.scenario,
+            packageName: bundle.source.packageName,
+            redaction: bundle.redaction,
+            lifecycle: bundle.lifecycle,
+            knownGaps: bundle.review.gaps
+        },
+        summary: {
+            streams: streams.length,
+            byKind,
+            active,
+            blocked,
+            warnings
+        },
+        streams,
+        events,
+        artifactLinks: [
+            { label: "run bundle", href: "../run.json", kind: "bundle" },
+            { label: "review JSON", href: "../review.json", kind: "review" },
+            { label: "review Markdown", href: "../review.md", kind: "review" },
+            { label: "event log", href: "../events.ndjson", kind: "events" },
+            { label: "observer data", href: "observer-data.json", kind: "observer" }
+        ],
+        publicSafety: {
+            publishable: false,
+            note: "Observer artifacts are local evidence. Before filing a public issue, use `mimetic feedback issue` so redaction and public-safety checks gate the payload."
+        },
+        raw: {
+            bundleSchema: bundle.schema,
+            artifactRoot: bundle.artifactRoot
+        }
+    };
+}
+export function stripAnsi(value) {
+    return value
+        .replace(/\u001b\[[0-9;?]*[ -/]*[@-~]/g, "")
+        .replace(/\u001b\][^\u0007]*(?:\u0007|\u001b\\)/g, "");
+}
+function fallbackSimulation(bundle, stream) {
+    return {
+        id: stream.simId,
+        index: bundle.simulations.length + 1,
+        personaId: bundle.persona.id,
+        scenarioId: bundle.scenario.id,
+        status: stream.status,
+        streamKind: stream.kind,
+        mode: "cli-sim",
+        progress: 0,
+        currentStep: "Unknown sim stream",
+        summary: "This stream did not include matching sim metadata.",
+        streamIds: [stream.id],
+        startedAt: bundle.createdAt,
+        updatedAt: stream.updatedAt
+    };
+}
+function kindLabel(kind) {
+    switch (kind) {
+        case "ui":
+            return "UI";
+        case "browser":
+            return "Browser";
+        case "terminal":
+            return "CLI";
+        case "tui":
+            return "TUI";
+        case "codex-ui":
+            return "Codex UI";
+        case "artifact":
+            return "Artifact";
+        case "summary":
+            return "Summary";
+    }
+}
+function statusLabel(status) {
+    switch (status) {
+        case "contract_proof_only":
+            return "Contract proof";
+        case "preparing":
+            return "Preparing";
+        case "queued":
+            return "Queued";
+        case "running":
+            return "Running";
+        case "complete":
+            return "Complete";
+        case "blocked":
+            return "Blocked";
+        case "failed":
+            return "Failed";
+    }
+}
+//# sourceMappingURL=observer-data.js.map

package/dist/observer-data.js.map

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

package/dist/observer.d.ts

@@ -0,0 +1,36 @@
+export declare const OBSERVER_SCHEMA = "mimetic.observer-result.v1";
+export interface ObserverResult {
+    schema: typeof OBSERVER_SCHEMA;
+    ok: boolean;
+    cwd: string;
+    run: string;
+    observerPath?: string;
+    observerDataPath?: string;
+    eventsPath?: string;
+    observerUrl?: string;
+    serverUrl?: string;
+    bundlePath?: string;
+    opened?: boolean;
+    openCommand?: string;
+    warnings: string[];
+    error?: {
+        code: "MIMETIC_RUN_NOT_FOUND" | "MIMETIC_INVALID_RUN_BUNDLE";
+        message: string;
+    };
+}
+export interface ObserverOptions {
+    open?: boolean;
+}
+export interface ObserverServeOptions {
+    open?: boolean;
+    port?: number;
+}
+export interface ObserverServer {
+    url: string;
+    opened: boolean;
+    openCommand?: string;
+    warning?: string;
+    close(): Promise<void>;
+}
+export declare function renderObserver(cwdInput: string, runInput: string, options?: ObserverOptions): Promise<ObserverResult>;
+export declare function serveObserver(result: ObserverResult, options?: ObserverServeOptions): Promise<ObserverServer>;

package/dist/observer.js

@@ -0,0 +1,360 @@
+import { spawn } from "node:child_process";
+import { createServer } from "node:http";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { buildObserverData } from "./observer-data.js";
+import { observerClientJs, observerCss } from "./observer-assets.js";
+import { listRuns, loadRunBundle, verifyRun } from "./run.js";
+export const OBSERVER_SCHEMA = "mimetic.observer-result.v1";
+export async function renderObserver(cwdInput, runInput, options = {}) {
+    const cwd = path.resolve(cwdInput);
+    const verified = await verifyRun(cwd, runInput);
+    if (!verified.ok) {
+        return {
+            schema: OBSERVER_SCHEMA,
+            ok: false,
+            cwd,
+            run: runInput,
+            warnings: [],
+            error: {
+                code: verified.error?.code === "MIMETIC_RUN_NOT_FOUND" ? "MIMETIC_RUN_NOT_FOUND" : "MIMETIC_INVALID_RUN_BUNDLE",
+                message: verified.error?.message ?? "Run bundle failed verification."
+            }
+        };
+    }
+    const loaded = await loadRunBundle(cwd, runInput);
+    if (!loaded) {
+        return {
+            schema: OBSERVER_SCHEMA,
+            ok: false,
+            cwd,
+            run: runInput,
+            warnings: [],
+            error: {
+                code: "MIMETIC_RUN_NOT_FOUND",
+                message: `Run not found: ${runInput}`
+            }
+        };
+    }
+    const observerDir = path.join(loaded.runDir, "observer");
+    const observerPath = path.join(observerDir, "index.html");
+    const observerDataPath = path.join(observerDir, "observer-data.json");
+    const eventsPath = path.join(loaded.runDir, "events.ndjson");
+    const observerData = buildObserverData(loaded.bundle);
+    await mkdir(observerDir, { recursive: true });
+    await writeJson(observerDataPath, observerData);
+    await writeFile(observerPath, renderObserverHtml(observerData), "utf8");
+    const relativeObserverPath = path.relative(cwd, observerPath);
+    const observerUrl = pathToFileURL(observerPath).href;
+    const openResult = options.open === true ? openTarget(observerPath) : { opened: false };
+    return {
+        schema: OBSERVER_SCHEMA,
+        ok: true,
+        cwd,
+        run: loaded.bundle.runId,
+        observerPath: relativeObserverPath,
+        observerDataPath: path.relative(cwd, observerDataPath),
+        eventsPath: path.relative(cwd, eventsPath),
+        observerUrl,
+        bundlePath: loaded.bundlePath,
+        opened: openResult.opened,
+        ...(openResult.command ? { openCommand: openResult.command } : {}),
+        warnings: [
+            "Observer renders local evidence only; dry-run lanes do not claim product behavior proof.",
+            "Before filing public feedback, use `mimetic feedback issue` so redaction and public-safety checks gate the payload.",
+            ...(openResult.warning ? [openResult.warning] : [])
+        ]
+    };
+}
+export async function serveObserver(result, options = {}) {
+    if (!result.ok || !result.observerPath) {
+        throw new Error("Cannot serve an observer result that did not render successfully.");
+    }
+    const cwd = path.resolve(result.cwd);
+    const observerPath = path.join(cwd, result.observerPath);
+    const runRoot = path.dirname(path.dirname(observerPath));
+    const proofRoot = path.dirname(runRoot);
+    const server = createServer(async (request, response) => {
+        try {
+            const url = new URL(request.url ?? "/", `http://${request.headers.host ?? "127.0.0.1"}`);
+            if (url.pathname === "/") {
+                response.writeHead(302, { location: "/observer/index.html" });
+                response.end();
+                return;
+            }
+            if (url.pathname === "/_mimetic/history.json") {
+                const history = await buildHistoryIndex(cwd);
+                writeResponse(response, 200, JSON.stringify(history, null, 2), "application/json; charset=utf-8");
+                return;
+            }
+            const runRoute = matchRunRoute(url.pathname);
+            if (runRoute) {
+                const targetRoot = path.join(proofRoot, runRoute.runId);
+                await serveRunPath(targetRoot, runRoute.relativePath || "observer/index.html", response);
+                return;
+            }
+            await serveRunPath(runRoot, decodeURIComponent(url.pathname.slice(1)), response);
+        }
+        catch (error) {
+            writeResponse(response, 500, error instanceof Error ? error.message : String(error), "text/plain; charset=utf-8");
+        }
+    });
+    const port = await listen(server, options.port ?? 0);
+    const url = `http://127.0.0.1:${port}/observer/index.html`;
+    const openResult = options.open === true ? openTarget(url) : { opened: false };
+    return {
+        url,
+        opened: openResult.opened,
+        ...(openResult.command ? { openCommand: openResult.command } : {}),
+        ...(openResult.warning ? { warning: openResult.warning } : {}),
+        close: () => closeServer(server)
+    };
+}
+function renderObserverHtml(data) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Mimetic Observer - ${escapeHtml(data.run.runId)}</title>
+<style>${observerCss()}</style>
+</head>
+<body>
+<div class="app" id="app">
+  <header class="rp" id="rp">
+    <div class="rp-bar">
+      <div class="rp-brand">
+        <span class="rp-brand-mark" aria-hidden="true"></span>
+        <span class="rp-brand-text">Mimetic - Observer</span>
+      </div>
+      <span class="rp-divider"></span>
+      <div class="rp-current">
+        <span class="pulse-dot" id="rp-current-pulse"></span>
+        <span class="rp-current-label" id="rp-current-label">Initializing</span>
+        <span class="rp-current-step" id="rp-current-step">- step 0/0</span>
+      </div>
+      <div class="rp-progress" id="rp-progress"><span></span></div>
+      <span class="rp-meta" id="rp-meta"></span>
+      <div class="rp-chips" id="rp-chips"></div>
+      <button type="button" class="rp-toggle" id="rp-toggle" aria-expanded="false">Phases</button>
+    </div>
+    <div class="rp-stepper" id="rp-stepper" hidden></div>
+  </header>
+
+  <div class="sub-bar" id="sub-bar">
+    <span class="obs-eyebrow" id="sub-mode">Watch grid</span>
+    <span class="sub-count"><strong id="sub-count">0</strong> streams</span>
+    <span class="sub-divider"></span>
+    <div class="sub-filters" id="sub-filters"></div>
+    <span class="sub-divider"></span>
+    <div class="sub-kind-filters" id="sub-kind-filters"></div>
+    <div class="sub-spacer">
+      <button class="sub-action" id="history-toggle" aria-expanded="false" hidden>Runs</button>
+      <span class="sub-divider" id="history-divider" hidden></span>
+      <span class="obs-eyebrow">Scale</span>
+      <button class="sub-density-btn" data-density="2" aria-pressed="false">2x</button>
+      <button class="sub-density-btn" data-density="3" aria-pressed="false">3x</button>
+      <button class="sub-density-btn" data-density="4" aria-pressed="true">4x</button>
+      <button class="sub-density-btn" data-density="5" aria-pressed="false">5x</button>
+      <span class="sub-divider"></span>
+      <button class="sub-action" id="media-toggle" data-mode-toggle="true" aria-pressed="false">Live</button>
+      <button class="sub-action" id="focus-mode" aria-pressed="false">Focus</button>
+      <button class="sub-action" id="grid-mode" aria-pressed="true">Grid</button>
+    </div>
+  </div>
+
+  <main class="grid-shell" id="grid-shell">
+    <div class="tile-grid" id="streams" data-density="4" data-stream-count="${data.streams.length}" aria-label="${data.streams.length} watchable streams"></div>
+  </main>
+
+  <section class="focus" id="focus" hidden aria-live="polite"></section>
+  <aside class="history-panel" id="history-panel" hidden aria-label="Run history">
+    <header class="history-head">
+      <div>
+        <span class="obs-eyebrow">Run history</span>
+        <h2>Past Mimetic runs</h2>
+      </div>
+      <button type="button" class="history-close" id="history-close" aria-label="Close run history">x</button>
+    </header>
+    <div class="history-current" id="history-current"></div>
+    <div class="history-list" id="history-list"></div>
+  </aside>
+</div>
+<script id="observer-data" type="application/json">${escapeJsonScript(data)}</script>
+<script>${observerClientJs()}</script>
+</body>
+</html>
+`;
+}
+async function serveRunPath(runRoot, relativePath, response) {
+    const root = path.resolve(runRoot);
+    const cleanedRelativePath = relativePath === "" ? "observer/index.html" : relativePath;
+    const filePath = path.resolve(root, cleanedRelativePath);
+    if (!isPathInside(root, filePath)) {
+        writeResponse(response, 403, "Forbidden", "text/plain; charset=utf-8");
+        return;
+    }
+    if (cleanedRelativePath === "observer/index.html") {
+        const observerData = await readObserverData(root);
+        if (!observerData) {
+            writeResponse(response, 404, "Observer data not found", "text/plain; charset=utf-8");
+            return;
+        }
+        writeResponse(response, 200, renderObserverHtml(observerData), "text/html; charset=utf-8");
+        return;
+    }
+    try {
+        const body = await readFile(filePath);
+        response.writeHead(200, {
+            "cache-control": "no-store",
+            "content-type": contentTypeForPath(filePath)
+        });
+        response.end(body);
+    }
+    catch {
+        writeResponse(response, 404, "Not found", "text/plain; charset=utf-8");
+    }
+}
+async function readObserverData(runRoot) {
+    try {
+        return JSON.parse(await readFile(path.join(runRoot, "observer", "observer-data.json"), "utf8"));
+    }
+    catch { }
+    try {
+        const bundle = JSON.parse(await readFile(path.join(runRoot, "run.json"), "utf8"));
+        return buildObserverData(bundle);
+    }
+    catch { }
+    return null;
+}
+async function buildHistoryIndex(cwd) {
+    const listed = await listRuns(cwd);
+    const runs = await Promise.all(listed.runs.slice(0, 80).map(async (run) => {
+        const root = path.join(cwd, run.path);
+        const data = await readObserverData(root);
+        return {
+            runId: run.runId,
+            createdAt: run.createdAt,
+            mode: run.mode,
+            href: `/_mimetic/runs/${encodeURIComponent(run.runId)}/observer/index.html`,
+            status: data?.run.status ?? "unknown",
+            streamCount: data?.streams.length ?? 0
+        };
+    }));
+    return { latestRunId: listed.latest, runs };
+}
+function matchRunRoute(pathname) {
+    const match = pathname.match(/^\/_mimetic\/runs\/([^/]+)(?:\/(.*))?$/);
+    if (!match)
+        return null;
+    return {
+        runId: decodeURIComponent(match[1] ?? ""),
+        relativePath: decodeURIComponent(match[2] || "observer/index.html")
+    };
+}
+function writeJson(filePath, value) {
+    return writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+function writeResponse(response, status, body, contentType) {
+    response.writeHead(status, {
+        "cache-control": "no-store",
+        "content-type": contentType
+    });
+    response.end(body);
+}
+function contentTypeForPath(filePath) {
+    switch (path.extname(filePath)) {
+        case ".html":
+            return "text/html; charset=utf-8";
+        case ".json":
+            return "application/json; charset=utf-8";
+        case ".md":
+            return "text/markdown; charset=utf-8";
+        case ".ndjson":
+            return "application/x-ndjson; charset=utf-8";
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".webp":
+            return "image/webp";
+        default:
+            return "text/plain; charset=utf-8";
+    }
+}
+function openTarget(target) {
+    const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", target] : [target];
+    try {
+        const child = spawn(command, args, {
+            detached: true,
+            stdio: "ignore"
+        });
+        child.unref();
+        return { opened: true, command: [command, ...args].join(" ") };
+    }
+    catch (error) {
+        return {
+            opened: false,
+            command: [command, ...args].join(" "),
+            warning: `Could not open observer automatically: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+function listen(server, port) {
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, "127.0.0.1", () => {
+            server.off("error", reject);
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                reject(new Error("Observer server did not bind to a TCP port."));
+                return;
+            }
+            resolve(address.port);
+        });
+    });
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error) {
+                reject(error);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+function isPathInside(root, filePath) {
+    const relative = path.relative(root, filePath);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function escapeHtml(value) {
+    return value.replace(/[&<>"']/g, (char) => {
+        switch (char) {
+            case "&":
+                return "&amp;";
+            case "<":
+                return "&lt;";
+            case ">":
+                return "&gt;";
+            case "\"":
+                return "&quot;";
+            default:
+                return "&#39;";
+        }
+    });
+}
+function escapeJsonScript(value) {
+    return JSON.stringify(value)
+        .replace(/</g, "\\u003c")
+        .replace(/>/g, "\\u003e")
+        .replace(/&/g, "\\u0026")
+        .replace(/\u2028/g, "\\u2028")
+        .replace(/\u2029/g, "\\u2029");
+}
+//# sourceMappingURL=observer.js.map

package/dist/observer.js.map

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

package/dist/oss-lab.d.ts

@@ -0,0 +1,50 @@
+export declare const OSS_LAB_SCHEMA = "mimetic.oss-lab-result.v1";
+export declare const DEFAULT_OSS_REPOS: readonly ["developit/mitt", "lukeed/clsx", "sindresorhus/is-plain-obj", "ai/nanoid"];
+export interface OssLabOptions {
+    cwd: string;
+    keep?: boolean;
+    limit?: number;
+    repos?: string[];
+    runId?: string;
+}
+export interface OssLabStep {
+    durationMs: number;
+    name: string;
+    ok: boolean;
+    summary: string;
+}
+export interface OssLabRepoResult {
+    changedFiles: string[];
+    clonePath: string;
+    mimeticRunId?: string;
+    observerPath?: string;
+    ok: boolean;
+    repo: string;
+    steps: OssLabStep[];
+    url: string;
+    warnings: string[];
+}
+export interface OssLabResult {
+    schema: typeof OSS_LAB_SCHEMA;
+    ok: boolean;
+    cleanup: {
+        kept: boolean;
+        sandboxRemoved: boolean;
+    };
+    completedAt: string;
+    cwd: string;
+    error?: {
+        code: "MIMETIC_INVALID_OSS_REPO" | "MIMETIC_INVALID_OSS_LIMIT";
+        message: string;
+    };
+    reportJsonPath?: string;
+    reportMarkdownPath?: string;
+    repos: OssLabRepoResult[];
+    runId: string;
+    sandboxPath: string;
+    startedAt: string;
+    warnings: string[];
+}
+export declare function normalizeOssRepoSlugs(input: string[] | undefined): string[];
+export declare function validateOssRepoSlug(slug: string): boolean;
+export declare function runOssLab(options: OssLabOptions): Promise<OssLabResult>;