flakelab 0.1.0 → 0.1.2

package/dist/solari/executor.js

@@ -4,13 +4,16 @@ import { SandboxClient } from "@solarisdk/sandbox";
 import { z } from "zod";
 import { createHash } from "node:crypto";
 import { setTimeout as delay } from "node:timers/promises";
-import { installFault } from "../faults/install.js";
+import { installFaults } from "../faults/install.js";
 import { normalizeProviderError, ProviderFailure, solariResponseFailure, } from "../providers/errors.js";
 import { CHECKOUT_APP_DIRECTORY, CHECKOUT_PORT, checkoutServerSource, } from "./checkout-fixture.js";
 import { retryTransient } from "./retry.js";
 import { ResourceUsageTracker } from "./usage.js";
 import { SecureWebSocketProxy } from "./websocket-proxy.js";
-const SANDBOX_TIMEOUT_MS = 5 * 60_000;
+export const SOLARI_SANDBOX_TEMPLATE = "base";
+export const SOLARI_SANDBOX_TIMEOUT_MS = 5 * 60_000;
+export const CHECKOUT_START_SHELL = "sh";
+export const CHECKOUT_START_COMMAND = `cd ${CHECKOUT_APP_DIRECTORY} && nohup python3 server.py >server.log 2>&1 &`;
 const PREVIEW_ATTEMPTS = 20;
 const rawSessionSchema = z.object({
     sessionId: z.string().min(1),
@@ -44,47 +47,50 @@ export class SolariParallelExecutor {
     #browsers;
     #options;
     #sandboxes;
-    #tracker = new ResourceUsageTracker();
+    #tracker;
     #liveBrowsers = new Map();
     #liveSandboxes = new Map();
     #previewUrl;
     #snapshotId;
     constructor(options) {
         this.#options = options;
+        this.#tracker = new ResourceUsageTracker(options.snapshotKey);
         this.#sandboxes = new SandboxClient({ apiKey: options.apiKey, baseUrl: options.baseUrl });
         this.#browsers = new Solari({ apiKey: options.apiKey, baseUrl: options.baseUrl });
     }
     async prepare() {
         this.#options.signal?.throwIfAborted();
-        const cachedSnapshots = await retryTransient(async () => this.#sandboxes.listSnapshots({ template: "base", limit: 100 }), this.#retryOptions());
-        const cached = cachedSnapshots.snapshots.find((snapshot) => snapshot.kind === "sandbox" && snapshot.name === this.#options.snapshotName);
+        const cachedSnapshots = await retryTransient(async () => this.#sandboxes.listSnapshots({
+            template: SOLARI_SANDBOX_TEMPLATE,
+            limit: 100,
+        }), this.#retryOptions());
+        const snapshotName = `flakelab-${this.#options.snapshotKey}`;
+        const cached = cachedSnapshots.snapshots.find((snapshot) => snapshot.kind === "sandbox" && snapshot.name === snapshotName);
         if (cached) {
             this.#snapshotId = cached.id;
-            this.#tracker.snapshotCacheHit();
+            this.#tracker.snapshotCacheHit("Found a prepared snapshot whose key matches every preparation input.");
             await this.#createSharedTarget();
             return;
         }
+        this.#tracker.snapshotCacheMiss("No prepared snapshot matched every preparation input; created a new snapshot.");
         const source = await retryTransient(async () => this.#sandboxes.create({
-            template: "base",
-            timeoutMs: SANDBOX_TIMEOUT_MS,
+            template: SOLARI_SANDBOX_TEMPLATE,
+            timeoutMs: SOLARI_SANDBOX_TIMEOUT_MS,
             metadata: { product: "flakelab", role: "source" },
         }), this.#retryOptions());
         this.#trackSandbox(source);
         try {
             await source.connect();
             await source.files.write(`${CHECKOUT_APP_DIRECTORY}/server.py`, checkoutServerSource);
-            const command = await source.commands.run("sh", {
-                args: [
-                    "-c",
-                    `cd ${CHECKOUT_APP_DIRECTORY} && nohup python3 server.py >server.log 2>&1 &`,
-                ],
+            const command = await source.commands.run(CHECKOUT_START_SHELL, {
+                args: ["-c", CHECKOUT_START_COMMAND],
             });
             if (command.exitCode !== 0) {
                 throw new Error("Checkout fixture failed to start in the prepared sandbox");
             }
             const preview = await source.previewUrl(CHECKOUT_PORT);
             await waitForPreview(preview.url, this.#options.signal);
-            this.#snapshotId = await source.snapshot(this.#options.snapshotName);
+            this.#snapshotId = await source.snapshot(snapshotName);
         }
         finally {
             await this.#releaseSandbox(source);
@@ -158,9 +164,9 @@ export class SolariParallelExecutor {
             throw new Error("Solari executor must be prepared before trials run");
         }
         const fork = await retryTransient(async () => this.#sandboxes.create({
-            template: "base",
+            template: SOLARI_SANDBOX_TEMPLATE,
             fromSnapshot: this.#snapshotId,
-            timeoutMs: SANDBOX_TIMEOUT_MS,
+            timeoutMs: SOLARI_SANDBOX_TIMEOUT_MS,
             lifecycle: { onTimeout: "kill" },
             metadata: { product: "flakelab", role: "shared-target" },
         }), this.#retryOptions());
@@ -190,7 +196,9 @@ export class SolariParallelExecutor {
     async #exerciseCheckout(browser, previewUrl, trial, startedAt) {
         const context = await browser.newContext();
         const page = await context.newPage();
-        const removeFault = trial.fault ? await installFault(page, trial.fault) : undefined;
+        const removeFault = trial.faults.length > 0
+            ? await installFaults(page, trial.faults)
+            : undefined;
         try {
             await page.goto(previewUrl);
             await page.getByRole("button", { name: "Place order" }).click();

package/dist/solari/executor.js.map

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

package/dist/solari/run-demo.d.ts

@@ -11,7 +11,19 @@ export interface SolariDemoOptions {
     seed: number;
     signal?: AbortSignal;
 }
-export declare function snapshotCacheKey(commit: string, lockfile: string, fixture: string): string;
+export interface SnapshotPreparationInput {
+    appDirectory: string;
+    commit: string;
+    fixture: string;
+    lockfile: string;
+    port: number;
+    runtime: string;
+    startShell: string;
+    startCommand: string;
+    template: string;
+    timeoutMs: number;
+}
+export declare function snapshotCacheKey(input: SnapshotPreparationInput): string;
 export interface SolariDemoResult extends DiagnosticResult {
     artifactPath: string;
     metricsPath: string;

package/dist/solari/run-demo.js

@@ -6,25 +6,44 @@ import { promisify } from "node:util";
 import { createNdjsonWriter } from "../artifacts/ndjson.js";
 import { runRequestSchema } from "../domain/schema.js";
 import { runLocalDiagnostics } from "../runner/local.js";
-import { checkoutServerSource } from "./checkout-fixture.js";
-import { SolariParallelExecutor } from "./executor.js";
+import { CHECKOUT_APP_DIRECTORY, CHECKOUT_PORT, checkoutServerSource, } from "./checkout-fixture.js";
+import { CHECKOUT_START_COMMAND, CHECKOUT_START_SHELL, SOLARI_SANDBOX_TEMPLATE, SOLARI_SANDBOX_TIMEOUT_MS, SolariParallelExecutor, } from "./executor.js";
 const execFileAsync = promisify(execFile);
-export function snapshotCacheKey(commit, lockfile, fixture) {
+export function snapshotCacheKey(input) {
+    const stableInput = {
+        appDirectory: input.appDirectory,
+        commit: input.commit,
+        fixture: input.fixture,
+        lockfile: input.lockfile,
+        port: input.port,
+        runtime: input.runtime,
+        startShell: input.startShell,
+        startCommand: input.startCommand,
+        template: input.template,
+        timeoutMs: input.timeoutMs,
+    };
     return createHash("sha256")
-        .update(commit)
-        .update("\0")
-        .update(lockfile)
-        .update("\0")
-        .update(fixture)
+        .update(JSON.stringify(stableInput))
         .digest("hex")
         .slice(0, 24);
 }
-async function snapshotName(projectRoot) {
+async function snapshotKey(projectRoot) {
     const [{ stdout: commit }, lockfile] = await Promise.all([
         execFileAsync("git", ["rev-parse", "HEAD"], { cwd: projectRoot, encoding: "utf8" }),
         readFile(resolve(projectRoot, "pnpm-lock.yaml"), "utf8"),
     ]);
-    return `flakelab-${snapshotCacheKey(commit.trim(), lockfile, checkoutServerSource)}`;
+    return snapshotCacheKey({
+        appDirectory: CHECKOUT_APP_DIRECTORY,
+        commit: commit.trim(),
+        fixture: checkoutServerSource,
+        lockfile,
+        port: CHECKOUT_PORT,
+        runtime: "python3",
+        startCommand: CHECKOUT_START_COMMAND,
+        startShell: CHECKOUT_START_SHELL,
+        template: SOLARI_SANDBOX_TEMPLATE,
+        timeoutMs: SOLARI_SANDBOX_TIMEOUT_MS,
+    });
 }
 export async function runSolariDemo(options) {
     const runDirectory = resolve(options.artifactDirectory, `solari-${Date.now()}`);
@@ -35,17 +54,17 @@ export async function runSolariDemo(options) {
         runs: options.runs,
         seed: options.seed,
         artifactDirectory: runDirectory,
-        fault: {
-            kind: "network-delay",
-            pattern: "**/api/checkout",
-            delayMs: options.delayMs,
-        },
+        faults: [{
+                kind: "network-delay",
+                pattern: "**/api/checkout",
+                delayMs: options.delayMs,
+            }],
     });
     const executor = new SolariParallelExecutor({
         apiKey: options.apiKey,
         baseUrl: options.baseUrl,
         signal: options.signal,
-        snapshotName: await snapshotName(options.projectRoot),
+        snapshotKey: await snapshotKey(options.projectRoot),
     });
     let result;
     let snapshotId;

package/dist/solari/run-demo.js.map

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

package/dist/solari/usage.d.ts

@@ -7,16 +7,22 @@ export interface ResourceUsage {
     browserSessionsCreated: number;
     browserSessionsClosed: number;
     infrastructureRetries: number;
-    snapshotCacheHit: boolean;
+    snapshotCache: {
+        key: string;
+        reason: string;
+        status: "hit" | "miss" | "pending";
+    };
 }
 export declare class ResourceUsageTracker {
     #private;
+    constructor(snapshotKey: string);
     sandboxCreated(): void;
     sandboxKilled(): void;
     browserCreated(): void;
     browserClosed(): void;
     retry(): void;
-    snapshotCacheHit(): void;
+    snapshotCacheHit(reason: string): void;
+    snapshotCacheMiss(reason: string): void;
     trialStarted(): number;
     trialCompleted(startedAt: number): void;
     snapshot(): ResourceUsage;

package/dist/solari/usage.js

@@ -7,8 +7,15 @@ export class ResourceUsageTracker {
     #peakConcurrency = 0;
     #sandboxesCreated = 0;
     #sandboxesKilled = 0;
-    #snapshotCacheHit = false;
+    #snapshotCache;
     #trialRuntimeMs = 0;
+    constructor(snapshotKey) {
+        this.#snapshotCache = {
+            key: snapshotKey,
+            reason: "Snapshot lookup has not completed.",
+            status: "pending",
+        };
+    }
     sandboxCreated() {
         this.#sandboxesCreated += 1;
     }
@@ -24,8 +31,11 @@ export class ResourceUsageTracker {
     retry() {
         this.#infrastructureRetries += 1;
     }
-    snapshotCacheHit() {
-        this.#snapshotCacheHit = true;
+    snapshotCacheHit(reason) {
+        this.#snapshotCache = { ...this.#snapshotCache, reason, status: "hit" };
+    }
+    snapshotCacheMiss(reason) {
+        this.#snapshotCache = { ...this.#snapshotCache, reason, status: "miss" };
     }
     trialStarted() {
         this.#activeTrials += 1;
@@ -46,7 +56,7 @@ export class ResourceUsageTracker {
             browserSessionsCreated: this.#browserSessionsCreated,
             browserSessionsClosed: this.#browserSessionsClosed,
             infrastructureRetries: this.#infrastructureRetries,
-            snapshotCacheHit: this.#snapshotCacheHit,
+            snapshotCache: { ...this.#snapshotCache },
         };
     }
 }

package/dist/solari/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/solari/usage.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,oBAAoB;IACtB,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAChC,aAAa,GAAG,CAAC,CAAA;IACjB,sBAAsB,GAAG,CAAC,CAAA;IAC1B,uBAAuB,GAAG,CAAC,CAAA;IAC3B,sBAAsB,GAAG,CAAC,CAAA;IAC1B,gBAAgB,GAAG,CAAC,CAAA;IACpB,iBAAiB,GAAG,CAAC,CAAA;IACrB,gBAAgB,GAAG,CAAC,CAAA;IACpB,iBAAiB,GAAG,KAAK,CAAA;IACzB,eAAe,GAAG,CAAC,CAAA;IAEnB,cAAc;QACZ,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,aAAa;QACX,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,uBAAuB,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;IAC/B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC3E,OAAO,IAAI,CAAC,GAAG,EAAE,CAAA;IACnB,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IAChD,CAAC;IAED,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU;YACxC,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,sBAAsB,EAAE,IAAI,CAAC,uBAAuB;YACpD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;YAClD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;YAClD,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;SACzC,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/solari/usage.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,oBAAoB;IACtB,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAChC,aAAa,GAAG,CAAC,CAAA;IACjB,sBAAsB,GAAG,CAAC,CAAA;IAC1B,uBAAuB,GAAG,CAAC,CAAA;IAC3B,sBAAsB,GAAG,CAAC,CAAA;IAC1B,gBAAgB,GAAG,CAAC,CAAA;IACpB,iBAAiB,GAAG,CAAC,CAAA;IACrB,gBAAgB,GAAG,CAAC,CAAA;IACpB,cAAc,CAAgC;IAC9C,eAAe,GAAG,CAAC,CAAA;IAEnB,YAAY,WAAmB;QAC7B,IAAI,CAAC,cAAc,GAAG;YACpB,GAAG,EAAE,WAAW;YAChB,MAAM,EAAE,oCAAoC;YAC5C,MAAM,EAAE,SAAS;SAClB,CAAA;IACH,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,aAAa;QACX,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,uBAAuB,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,gBAAgB,CAAC,MAAc;QAC7B,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IACzE,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;IAC1E,CAAC;IAED,YAAY;QACV,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC3E,OAAO,IAAI,CAAC,GAAG,EAAE,CAAA;IACnB,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IAChD,CAAC;IAED,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU;YACxC,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,sBAAsB,EAAE,IAAI,CAAC,uBAAuB;YACpD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;YAClD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;YAClD,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE;SAC1C,CAAA;IACH,CAAC;CACF"}

package/dist/ui/boundary.d.ts

@@ -0,0 +1,17 @@
+import type { DocumentRow } from "./document.js";
+import type { TerminalTheme } from "./theme.js";
+export interface ProviderBoundary {
+    /** Extra facts a reader needs before authorizing the work, such as a model. */
+    rows?: DocumentRow[];
+    credentials: string[];
+    /** What leaves the machine, in one sentence. */
+    detail: string;
+    stage: string;
+}
+/**
+ * The one place FlakeLab announces that the next step leaves the local machine.
+ * It always names the work, what is transmitted, the credentials in use, and the
+ * ceilings that bound it, so the cost and security boundary is visible before a
+ * chargeable operation starts.
+ */
+export declare function formatProviderBoundary(boundary: ProviderBoundary, theme?: TerminalTheme): string;

package/dist/ui/boundary.js

@@ -0,0 +1,18 @@
+import { TerminalDocument } from "./document.js";
+import { PLAIN_THEME } from "./theme.js";
+/**
+ * The one place FlakeLab announces that the next step leaves the local machine.
+ * It always names the work, what is transmitted, the credentials in use, and the
+ * ceilings that bound it, so the cost and security boundary is visible before a
+ * chargeable operation starts.
+ */
+export function formatProviderBoundary(boundary, theme = PLAIN_THEME) {
+    const document = new TerminalDocument(theme);
+    document.entry("warning", `provider work · ${boundary.stage}`, boundary.detail);
+    const rows = [
+        { label: "Credentials", value: boundary.credentials.join(" · ") || "none" },
+        ...(boundary.rows ?? []),
+    ];
+    return document.rows(rows).render();
+}
+//# sourceMappingURL=boundary.js.map

package/dist/ui/boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.js","sourceRoot":"","sources":["../../src/ui/boundary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAWxC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA0B,EAC1B,QAAuB,WAAW;IAElC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAC5C,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC/E,MAAM,IAAI,GAAkB;QAC1B,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE;QAC3E,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;KACzB,CAAA;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA;AACrC,CAAC"}

package/dist/ui/console.d.ts

@@ -0,0 +1,4 @@
+/** Human summaries keep the stream they already used; only the presentation changes. */
+export declare function writeStdout(text: string): void;
+/** Progress, provider notices, and errors are diagnostics: they belong on stderr. */
+export declare function writeStderr(text: string): void;

package/dist/ui/console.js

@@ -0,0 +1,11 @@
+/** Human summaries keep the stream they already used; only the presentation changes. */
+export function writeStdout(text) {
+    process.stdout.write(`${text}
+`);
+}
+/** Progress, provider notices, and errors are diagnostics: they belong on stderr. */
+export function writeStderr(text) {
+    process.stderr.write(`${text}
+`);
+}
+//# sourceMappingURL=console.js.map

package/dist/ui/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/ui/console.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI;CAC7B,CAAC,CAAA;AACF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI;CAC7B,CAAC,CAAA;AACF,CAAC"}

package/dist/ui/document.d.ts

@@ -0,0 +1,40 @@
+import type { StatusTone } from "./status.js";
+import type { TerminalTheme } from "./theme.js";
+export interface DocumentRow {
+    label: string;
+    tone?: StatusTone;
+    value: string;
+}
+export declare function labelColumn(rows: DocumentRow[]): number;
+/**
+ * Builds one command's terminal output from a small, shared set of primitives:
+ * a heading, semantic status lines, aligned key/value rows, grouped sections,
+ * evidence paths, and copyable commands. Every value that can originate outside
+ * FlakeLab is sanitized before it reaches the terminal.
+ */
+export declare class TerminalDocument {
+    #private;
+    constructor(theme?: TerminalTheme);
+    blank(): this;
+    /** One bold line and a single thin rule. Nothing else. */
+    banner(text: string): this;
+    /**
+     * The product name and the command that produced this output. A leading blank
+     * line separates it from stage progress and from a previous command summary.
+     */
+    heading(title: string): this;
+    section(title: string): this;
+    /** The single most important line of a command: its result. */
+    verdict(tone: StatusTone, label: string, detail?: string): this;
+    /** One item in a list of observations, checks, or trials. */
+    entry(tone: StatusTone, label: string, detail?: string): this;
+    /** Secondary prose beneath a verdict or entry, wrapped to the terminal width. */
+    detail(text: string, tone?: StatusTone): this;
+    rows(rows: DocumentRow[], labelWidth?: number): this;
+    /** Quiet supporting prose aligned with rows and commands. */
+    note(value: string): this;
+    /** A copyable command. Never prefixed with a shell sigil. */
+    command(value: string): this;
+    text(value: string): this;
+    render(): string;
+}

package/dist/ui/document.js

@@ -0,0 +1,120 @@
+import { statusMark, toneStyle } from "./status.js";
+import { paint } from "./style.js";
+import { displayWidth, padRight, sanitizeLine, sanitizeText, truncate, wrapText } from "./text.js";
+import { PLAIN_THEME } from "./theme.js";
+const INDENT = "  ";
+const MARK_INDENT = "     ";
+const MAXIMUM_LABEL_WIDTH = 22;
+const MAXIMUM_DETAIL_LENGTH = 600;
+export function labelColumn(rows) {
+    const widest = rows.reduce((width, row) => Math.max(width, displayWidth(row.label)), 0);
+    return Math.min(widest, MAXIMUM_LABEL_WIDTH);
+}
+/**
+ * Builds one command's terminal output from a small, shared set of primitives:
+ * a heading, semantic status lines, aligned key/value rows, grouped sections,
+ * evidence paths, and copyable commands. Every value that can originate outside
+ * FlakeLab is sanitized before it reaches the terminal.
+ */
+export class TerminalDocument {
+    #lines = [];
+    #theme;
+    constructor(theme = PLAIN_THEME) {
+        this.#theme = theme;
+    }
+    blank() {
+        if (this.#lines.length > 0 && this.#lines[this.#lines.length - 1] !== "") {
+            this.#lines.push("");
+        }
+        return this;
+    }
+    /** One bold line and a single thin rule. Nothing else. */
+    banner(text) {
+        const safe = sanitizeLine(text);
+        this.#lines.push(paint(this.#theme, "bold", safe));
+        const rule = (this.#theme.unicode ? "─" : "-").repeat(Math.min(displayWidth(safe), this.#theme.width));
+        this.#lines.push(paint(this.#theme, "dim", rule));
+        return this;
+    }
+    /**
+     * The product name and the command that produced this output. A leading blank
+     * line separates it from stage progress and from a previous command summary.
+     */
+    heading(title) {
+        this.#lines.push("");
+        return this.banner(`FlakeLab ${this.#theme.unicode ? "·" : "-"} ${title}`);
+    }
+    section(title) {
+        this.blank();
+        this.#lines.push(paint(this.#theme, "bold", sanitizeLine(title)));
+        return this;
+    }
+    /** The single most important line of a command: its result. */
+    verdict(tone, label, detail) {
+        this.blank();
+        this.#lines.push(`${INDENT}${statusMark(this.#theme, tone)}  ${paint(this.#theme, "bold", sanitizeLine(label))}`);
+        return detail === undefined ? this : this.detail(detail);
+    }
+    /** One item in a list of observations, checks, or trials. */
+    entry(tone, label, detail) {
+        this.#lines.push(`${INDENT}${statusMark(this.#theme, tone)}  ${sanitizeLine(label)}`);
+        return detail === undefined ? this : this.detail(detail);
+    }
+    /** Secondary prose beneath a verdict or entry, wrapped to the terminal width. */
+    detail(text, tone = "muted") {
+        const safe = truncate(sanitizeText(text), MAXIMUM_DETAIL_LENGTH);
+        const width = Math.max(this.#theme.width - MARK_INDENT.length, 24);
+        for (const line of wrapText(safe, width)) {
+            const rendered = tone === "muted" ? paint(this.#theme, "dim", line) : line;
+            this.#lines.push(`${MARK_INDENT}${rendered}`);
+        }
+        return this;
+    }
+    rows(rows, labelWidth) {
+        const column = labelWidth ?? labelColumn(rows);
+        for (const row of rows) {
+            this.#appendRow(row, column);
+        }
+        return this;
+    }
+    /** Quiet supporting prose aligned with rows and commands. */
+    note(value) {
+        const width = Math.max(this.#theme.width - INDENT.length, 24);
+        for (const line of wrapText(sanitizeText(value), width)) {
+            this.#lines.push(`${INDENT}${paint(this.#theme, "dim", line)}`);
+        }
+        return this;
+    }
+    /** A copyable command. Never prefixed with a shell sigil. */
+    command(value) {
+        this.#lines.push(`${INDENT}${paint(this.#theme, "cyan", sanitizeLine(value))}`);
+        return this;
+    }
+    text(value) {
+        for (const line of wrapText(sanitizeText(value), this.#theme.width - INDENT.length)) {
+            this.#lines.push(line === "" ? "" : `${INDENT}${line}`);
+        }
+        return this;
+    }
+    render() {
+        return this.#lines.join("\n");
+    }
+    #appendRow(row, column) {
+        const label = paint(this.#theme, "dim", padRight(sanitizeLine(row.label), column));
+        const available = this.#theme.width - INDENT.length - column - 2;
+        const wrapped = wrapText(sanitizeLine(row.value), available)
+            .map((line) => this.#paintValue(line, row.tone));
+        this.#lines.push(`${INDENT}${label}  ${wrapped[0] ?? ""}`);
+        const continuation = " ".repeat(INDENT.length + column + 2);
+        for (const line of wrapped.slice(1)) {
+            this.#lines.push(`${continuation}${line}`);
+        }
+    }
+    #paintValue(line, tone) {
+        if (tone === undefined) {
+            return line;
+        }
+        return paint(this.#theme, tone === "muted" ? "dim" : toneStyle(tone), line);
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/ui/document.js.map

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

package/dist/ui/format.d.ts

@@ -0,0 +1,8 @@
+/** Compact, comparable durations. Milliseconds below a second, then seconds. */
+export declare function formatDuration(milliseconds: number): string;
+export declare function formatSeconds(seconds: number): string;
+export declare function formatUsd(value: number, fractionDigits?: number): string;
+export declare function formatRate(rate: number): string;
+export declare function formatCount(value: number, singular: string, plural?: string): string;
+/** Quotes a value for a copyable shell command without inviting injection. */
+export declare function shellArgument(value: string): string;

package/dist/ui/format.js

@@ -0,0 +1,32 @@
+const SECOND = 1_000;
+const MINUTE = 60 * SECOND;
+/** Compact, comparable durations. Milliseconds below a second, then seconds. */
+export function formatDuration(milliseconds) {
+    const value = Math.max(0, Math.round(milliseconds));
+    if (value < SECOND) {
+        return `${value} ms`;
+    }
+    if (value < MINUTE) {
+        return `${(value / SECOND).toFixed(1)}s`;
+    }
+    const minutes = Math.floor(value / MINUTE);
+    const seconds = Math.round((value % MINUTE) / SECOND);
+    return `${minutes}m ${seconds}s`;
+}
+export function formatSeconds(seconds) {
+    return formatDuration(seconds * SECOND);
+}
+export function formatUsd(value, fractionDigits = 2) {
+    return `$${value.toFixed(fractionDigits)}`;
+}
+export function formatRate(rate) {
+    return `${(rate * 100).toFixed(1)}%`;
+}
+export function formatCount(value, singular, plural = `${singular}s`) {
+    return `${value} ${value === 1 ? singular : plural}`;
+}
+/** Quotes a value for a copyable shell command without inviting injection. */
+export function shellArgument(value) {
+    return /^[\w./@:=-]+$/u.test(value) ? value : JSON.stringify(value);
+}
+//# sourceMappingURL=format.js.map

package/dist/ui/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/ui/format.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,KAAK,CAAA;AACpB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAA;AAE1B,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;IACnD,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;QACnB,OAAO,GAAG,KAAK,KAAK,CAAA;IACtB,CAAC;IACD,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IAC1C,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAA;IACrD,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,cAAc,CAAC,OAAO,GAAG,MAAM,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,cAAc,GAAG,CAAC;IACzD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAM,GAAG,GAAG,QAAQ,GAAG;IAClF,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;AACtD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC"}