runwork 0.15.0 → 0.15.2

package/dist/utils/prompt.js

@@ -1,42 +0,0 @@
-import { select, text, confirm, isCancel } from '@clack/prompts';
-export async function promptSelect(message, choices) {
-    if (choices.length === 0) {
-        throw new Error('No choices available');
-    }
-    if (choices.length === 1) {
-        console.log(`${message}: ${choices[0].label}`);
-        return choices[0];
-    }
-    const result = await select({
-        message,
-        options: choices.map((c, i) => ({
-            value: i,
-            label: c.label,
-        })),
-    });
-    if (isCancel(result)) {
-        console.log('Cancelled.');
-        process.exit(0);
-    }
-    return choices[result];
-}
-export async function promptInput(message, defaultValue) {
-    const result = await text({
-        message,
-        defaultValue,
-        placeholder: defaultValue,
-    });
-    if (isCancel(result)) {
-        console.log('Cancelled.');
-        process.exit(0);
-    }
-    return result.trim() || defaultValue || '';
-}
-export async function promptConfirm(message) {
-    const result = await confirm({ message });
-    if (isCancel(result)) {
-        console.log('Cancelled.');
-        process.exit(0);
-    }
-    return result;
-}

package/dist/utils/resolve.d.ts

@@ -1,12 +0,0 @@
-import type { ApiClient } from '../api/client.js';
-import type { AppInfo, WorkspaceInfo } from '../types.js';
-/**
- * Resolve a workspace by name or ID from the user's accessible workspaces.
- * Tries exact ID match first, then case-insensitive name match.
- */
-export declare function resolveWorkspace(client: ApiClient, nameOrId: string): Promise<WorkspaceInfo>;
-/**
- * Resolve an app by name or ID from the user's accessible apps.
- * Tries exact ID match first, then case-insensitive name match.
- */
-export declare function resolveApp(client: ApiClient, nameOrId: string): Promise<AppInfo>;

package/dist/utils/resolve.js

@@ -1,52 +0,0 @@
-/**
- * Resolve a workspace by name or ID from the user's accessible workspaces.
- * Tries exact ID match first, then case-insensitive name match.
- */
-export async function resolveWorkspace(client, nameOrId) {
-    const workspaces = await client.listWorkspaces();
-    if (workspaces.length === 0) {
-        console.error('No workspaces found. Create one at runwork.ai first.');
-        process.exit(1);
-    }
-    // Exact ID match
-    const byId = workspaces.find(w => w.id === nameOrId);
-    if (byId)
-        return byId;
-    // Case-insensitive name match
-    const lower = nameOrId.toLowerCase();
-    const byName = workspaces.filter(w => w.name.toLowerCase() === lower);
-    if (byName.length === 1)
-        return byName[0];
-    if (byName.length > 1) {
-        console.error(`Ambiguous workspace name "${nameOrId}". Matches: ${byName.map(w => `${w.name} (${w.id})`).join(', ')}`);
-        process.exit(1);
-    }
-    console.error(`Workspace "${nameOrId}" not found. Available: ${workspaces.map(w => w.name).join(', ')}`);
-    process.exit(1);
-}
-/**
- * Resolve an app by name or ID from the user's accessible apps.
- * Tries exact ID match first, then case-insensitive name match.
- */
-export async function resolveApp(client, nameOrId) {
-    const apps = await client.listApps();
-    if (apps.length === 0) {
-        console.error('No apps found.');
-        process.exit(1);
-    }
-    // Exact ID match
-    const byId = apps.find(a => a.id === nameOrId);
-    if (byId)
-        return byId;
-    // Case-insensitive name match
-    const lower = nameOrId.toLowerCase();
-    const byName = apps.filter(a => a.name.toLowerCase() === lower);
-    if (byName.length === 1)
-        return byName[0];
-    if (byName.length > 1) {
-        console.error(`Ambiguous app name "${nameOrId}". Matches: ${byName.map(a => `${a.name} (${a.id})`).join(', ')}`);
-        process.exit(1);
-    }
-    console.error(`App "${nameOrId}" not found. Available: ${apps.map(a => a.name).join(', ')}`);
-    process.exit(1);
-}

package/dist/utils/setup-state.d.ts

@@ -1,3 +0,0 @@
-import type { SetupState } from '../types.js';
-/** Load setup state, checking project-level then user-level. */
-export declare function loadSetupState(): SetupState | null;

package/dist/utils/setup-state.js

@@ -1,19 +0,0 @@
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-/** Load setup state, checking project-level then user-level. */
-export function loadSetupState() {
-    const projectPath = join(process.cwd(), '.runwork', 'setup.json');
-    const userPath = join(homedir(), '.runwork', 'setup.json');
-    for (const p of [projectPath, userPath]) {
-        if (existsSync(p)) {
-            try {
-                return JSON.parse(readFileSync(p, 'utf-8'));
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    return null;
-}

package/dist/utils/sqlite-adapter.d.ts

@@ -1,48 +0,0 @@
-/**
- * Runtime SQLite adapter.
- *
- * Selects a SQLite backend at module load time:
- *   1. `bun:sqlite` when running under Bun (the compiled standalone CLI binary)
- *   2. `node:sqlite` when running on Node >= 22.5 (the `npx runwork@latest` path)
- *   3. null, in which case SQLite-backed telemetry features degrade gracefully
- *      instead of breaking install
- *
- * This replaces the previous hard dependency on `better-sqlite3`, which
- * required a native npm build and failed in restricted sandboxes, locked-down
- * corporate environments, and low-privilege containers.
- */
-type SqliteFlavor = 'bun' | 'node';
-interface StatementHandle {
-    get(...params: unknown[]): unknown;
-    all(...params: unknown[]): unknown[];
-    run(...params: unknown[]): unknown;
-}
-/**
- * Returns true when a SQLite runtime is available.
- * Use this to gate telemetry / agent-stats features that can degrade gracefully.
- */
-export declare function sqliteAvailable(): boolean;
-/**
- * Returns the name of the SQLite backend in use, or null if none is available.
- * Intended for doctor / diagnostic output.
- */
-export declare function sqliteFlavor(): SqliteFlavor | null;
-export declare function queryReadonlySqlite(dbPath: string, sql: string): string;
-/**
- * Handle returned by `openWritableSqlite` for write operations.
- * Callers are responsible for calling `close()` when done.
- */
-export interface WritableSqlite {
-    prepare(sql: string): StatementHandle;
-    close(): void;
-    readonly flavor: SqliteFlavor;
-}
-/**
- * Open a writable SQLite database. Returns null when no SQLite runtime is
- * available, letting the caller degrade gracefully instead of crashing.
- *
- * On failure to open the database (missing file, permission denied, locked),
- * this also returns null.
- */
-export declare function openWritableSqlite(dbPath: string): WritableSqlite | null;
-export {};

package/dist/utils/sqlite-adapter.js

@@ -1,147 +0,0 @@
-/**
- * Runtime SQLite adapter.
- *
- * Selects a SQLite backend at module load time:
- *   1. `bun:sqlite` when running under Bun (the compiled standalone CLI binary)
- *   2. `node:sqlite` when running on Node >= 22.5 (the `npx runwork@latest` path)
- *   3. null, in which case SQLite-backed telemetry features degrade gracefully
- *      instead of breaking install
- *
- * This replaces the previous hard dependency on `better-sqlite3`, which
- * required a native npm build and failed in restricted sandboxes, locked-down
- * corporate environments, and low-privilege containers.
- */
-let adapter = null;
-async function loadAdapter() {
-    // Try bun:sqlite first. Bun defines a global `Bun` object we can sniff for.
-    const bunGlobal = globalThis.Bun;
-    if (typeof bunGlobal !== 'undefined') {
-        try {
-            const specifier = 'bun:sqlite';
-            const mod = (await import(/* @vite-ignore */ specifier));
-            if (mod?.Database) {
-                return {
-                    flavor: 'bun',
-                    Database: mod.Database,
-                    readOnlyOptionKey: 'readonly',
-                    readOnlyOptionValue: true,
-                };
-            }
-        }
-        catch {
-            // bun:sqlite unavailable despite Bun global; fall through to Node path
-        }
-    }
-    // Try node:sqlite. Available in Node >= 22.5 stable.
-    try {
-        const specifier = 'node:sqlite';
-        const mod = (await import(/* @vite-ignore */ specifier));
-        if (mod?.DatabaseSync) {
-            return {
-                flavor: 'node',
-                Database: mod.DatabaseSync,
-                readOnlyOptionKey: 'readOnly',
-                readOnlyOptionValue: true,
-            };
-        }
-    }
-    catch {
-        // node:sqlite unavailable (older Node, or flag off)
-    }
-    return null;
-}
-// Top-level await: module load blocks until an adapter is chosen.
-// The CLI is an ESM package running on Bun or modern Node, both of which
-// support top-level await.
-adapter = await loadAdapter();
-/**
- * Returns true when a SQLite runtime is available.
- * Use this to gate telemetry / agent-stats features that can degrade gracefully.
- */
-export function sqliteAvailable() {
-    return adapter !== null;
-}
-/**
- * Returns the name of the SQLite backend in use, or null if none is available.
- * Intended for doctor / diagnostic output.
- */
-export function sqliteFlavor() {
-    return adapter?.flavor ?? null;
-}
-/**
- * Execute a read-only SQL query against a SQLite database and return the rows
- * serialised as `value1|value2|value3` per row, newline separated. Matches the
- * legacy `querySqlite` contract so existing parsers do not have to change.
- *
- * Returns an empty string on any failure (missing database, locked, corrupt,
- * unavailable runtime). Callers must tolerate the empty-string path.
- */
-const BUSY_TIMEOUT_MS = 5000;
-function setBusyTimeout(db) {
-    // bun:sqlite has no `timeout` constructor option and node:sqlite had a
-    // moving target across versions, so set busy_timeout via a PRAGMA that
-    // works on every SQLite build. PRAGMA busy_timeout is a per-connection
-    // runtime setting and does not require write permissions.
-    try {
-        db.prepare(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`).run();
-    }
-    catch {
-        /* some flavors refuse PRAGMA on readonly; best-effort */
-    }
-}
-export function queryReadonlySqlite(dbPath, sql) {
-    if (!adapter)
-        return '';
-    let db = null;
-    try {
-        const options = {
-            [adapter.readOnlyOptionKey]: adapter.readOnlyOptionValue,
-        };
-        db = new adapter.Database(dbPath, options);
-        setBusyTimeout(db);
-        const rows = db.prepare(sql).all();
-        return rows.map((row) => Object.values(row).join('|')).join('\n');
-    }
-    catch {
-        return '';
-    }
-    finally {
-        try {
-            db?.close();
-        }
-        catch {
-            /* ignore close errors */
-        }
-    }
-}
-/**
- * Open a writable SQLite database. Returns null when no SQLite runtime is
- * available, letting the caller degrade gracefully instead of crashing.
- *
- * On failure to open the database (missing file, permission denied, locked),
- * this also returns null.
- */
-export function openWritableSqlite(dbPath) {
-    if (!adapter)
-        return null;
-    try {
-        const db = new adapter.Database(dbPath);
-        setBusyTimeout(db);
-        const flavor = adapter.flavor;
-        return {
-            prepare: (sql) => db.prepare(sql),
-            close: () => {
-                try {
-                    db.close();
-                }
-                catch {
-                    /* ignore close errors */
-                }
-            },
-            flavor,
-        };
-    }
-    catch {
-        return null;
-    }
-}

package/dist/utils/sqlite.d.ts

@@ -1,14 +0,0 @@
-/**
- * Read-only SQLite query helper used by agent stats readers.
- *
- * This file used to hard-depend on `better-sqlite3`, which required a native
- * npm build and failed in low-privilege containers and corporate sandboxes.
- * It now re-exports the runtime-aware adapter which picks `bun:sqlite` in the
- * compiled standalone binary, `node:sqlite` when running under `npx`, and a
- * structured "unavailable" path otherwise (returns empty string).
- *
- * The `querySqlite` name is preserved so existing call sites and mocks in
- * tests keep working.
- */
-export { queryReadonlySqlite as querySqlite } from './sqlite-adapter.js';
-export { openWritableSqlite, sqliteAvailable, sqliteFlavor, type WritableSqlite } from './sqlite-adapter.js';

package/dist/utils/sqlite.js

@@ -1,14 +0,0 @@
-/**
- * Read-only SQLite query helper used by agent stats readers.
- *
- * This file used to hard-depend on `better-sqlite3`, which required a native
- * npm build and failed in low-privilege containers and corporate sandboxes.
- * It now re-exports the runtime-aware adapter which picks `bun:sqlite` in the
- * compiled standalone binary, `node:sqlite` when running under `npx`, and a
- * structured "unavailable" path otherwise (returns empty string).
- *
- * The `querySqlite` name is preserved so existing call sites and mocks in
- * tests keep working.
- */
-export { queryReadonlySqlite as querySqlite } from './sqlite-adapter.js';
-export { openWritableSqlite, sqliteAvailable, sqliteFlavor } from './sqlite-adapter.js';

package/dist/utils/subprocess.d.ts

@@ -1,19 +0,0 @@
-/**
- * Thin wrappers around `child_process.execFileSync` and `spawn` that
- * default `windowsHide: true`. On Windows, every console-subsystem
- * subprocess we spawn (git, where.exe, registry queries) creates its
- * own console window unless this flag is set. With our hot paths --
- * auto-commit's git invocations, manifest's `git ls-files`, the sync
- * loop's git rebase / fetch / push -- a missing flag visibly flashes a
- * console window every few seconds, which Codex Desktop users see as
- * "empty terminals keep popping up."
- *
- * Use these as drop-in replacements for the `child_process` exports.
- * Existing options the caller passes still win (so you can opt back to
- * `windowsHide: false` if you genuinely need the window, e.g. for
- * interactive prompts -- though we don't have any of those in our
- * subprocess paths today).
- */
-import { execFileSync as cpExecFileSync, spawn as cpSpawn } from 'child_process';
-export declare const execFileSync: typeof cpExecFileSync;
-export declare const spawn: typeof cpSpawn;

package/dist/utils/subprocess.js

@@ -1,27 +0,0 @@
-/**
- * Thin wrappers around `child_process.execFileSync` and `spawn` that
- * default `windowsHide: true`. On Windows, every console-subsystem
- * subprocess we spawn (git, where.exe, registry queries) creates its
- * own console window unless this flag is set. With our hot paths --
- * auto-commit's git invocations, manifest's `git ls-files`, the sync
- * loop's git rebase / fetch / push -- a missing flag visibly flashes a
- * console window every few seconds, which Codex Desktop users see as
- * "empty terminals keep popping up."
- *
- * Use these as drop-in replacements for the `child_process` exports.
- * Existing options the caller passes still win (so you can opt back to
- * `windowsHide: false` if you genuinely need the window, e.g. for
- * interactive prompts -- though we don't have any of those in our
- * subprocess paths today).
- */
-import { execFileSync as cpExecFileSync, spawn as cpSpawn, } from 'child_process';
-// We re-export with the *exact* `typeof` signature of the originals so
-// caller-side overload narrowing (encoding -> string vs Buffer return
-// type) keeps working. The implementation forwards through the original
-// after merging in `windowsHide: true` as a default.
-export const execFileSync = ((file, args, options) => {
-    return cpExecFileSync(file, args, { windowsHide: true, ...(options ?? {}) });
-});
-export const spawn = ((command, args, options) => {
-    return cpSpawn(command, args ?? [], { windowsHide: true, ...(options ?? {}) });
-});

package/dist/utils/which.d.ts

@@ -1,14 +0,0 @@
-/**
- * Cross-platform binary detection.
- * Uses `which` on macOS/Linux, `where.exe` on Windows.
- * Returns the resolved path on success, null if not found.
- */
-export declare function whichBinary(name: string): string | null;
-/**
- * Check if a desktop app is currently running by process name.
- * On macOS: checks for the .app bundle process via pgrep.
- * On Windows: uses tasklist to find the .exe.
- * On Linux: uses pgrep for the binary name.
- * Returns true if the process is found, false otherwise.
- */
-export declare function isAppRunning(appName: string): boolean;

package/dist/utils/which.js

@@ -1,47 +0,0 @@
-import { execFileSync } from './subprocess.js';
-import { platform } from 'os';
-/**
- * Cross-platform binary detection.
- * Uses `which` on macOS/Linux, `where.exe` on Windows.
- * Returns the resolved path on success, null if not found.
- */
-export function whichBinary(name) {
-    try {
-        const cmd = platform() === 'win32' ? 'where.exe' : 'which';
-        const result = execFileSync(cmd, [name], { stdio: 'pipe' }).toString().trim();
-        // `where.exe` may return multiple lines; take the first
-        return result.split(/[\r\n]+/)[0].trim() || null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Check if a desktop app is currently running by process name.
- * On macOS: checks for the .app bundle process via pgrep.
- * On Windows: uses tasklist to find the .exe.
- * On Linux: uses pgrep for the binary name.
- * Returns true if the process is found, false otherwise.
- */
-export function isAppRunning(appName) {
-    try {
-        const os = platform();
-        if (os === 'darwin') {
-            // pgrep -f matches against the full command line, catching Electron apps
-            execFileSync('pgrep', ['-f', `${appName}.app`], { stdio: 'pipe' });
-            return true;
-        }
-        else if (os === 'win32') {
-            const result = execFileSync('tasklist', ['/FI', `IMAGENAME eq ${appName}.exe`, '/NH'], { stdio: 'pipe' }).toString();
-            return result.includes(`${appName}.exe`);
-        }
-        else {
-            execFileSync('pgrep', ['-x', appName.toLowerCase()], { stdio: 'pipe' });
-            return true;
-        }
-    }
-    catch {
-        // pgrep exits non-zero when no processes match
-        return false;
-    }
-}

package/dist/utils/zip.d.ts

@@ -1,7 +0,0 @@
-export declare function extractZip(zipData: ArrayBuffer, targetDir: string): void;
-/**
- * Walk `sourceDir` recursively and write a zip file at `outputPath`.
- * Entry paths inside the zip are forward-slash relative paths from
- * `sourceDir`, matching the cross-platform convention that zip tools use.
- */
-export declare function createZipFromDir(sourceDir: string, outputPath: string): void;

package/dist/utils/zip.js

@@ -1,42 +0,0 @@
-import { mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'fs';
-import { join, dirname, relative, sep } from 'path';
-import { unzipSync, zipSync } from 'fflate';
-export function extractZip(zipData, targetDir) {
-    const files = unzipSync(new Uint8Array(zipData));
-    for (const [path, data] of Object.entries(files)) {
-        const fullPath = join(targetDir, path);
-        // Directory entries end with /
-        if (path.endsWith('/')) {
-            mkdirSync(fullPath, { recursive: true });
-            continue;
-        }
-        // Ensure parent directory exists
-        mkdirSync(dirname(fullPath), { recursive: true });
-        writeFileSync(fullPath, data);
-    }
-}
-/**
- * Walk `sourceDir` recursively and write a zip file at `outputPath`.
- * Entry paths inside the zip are forward-slash relative paths from
- * `sourceDir`, matching the cross-platform convention that zip tools use.
- */
-export function createZipFromDir(sourceDir, outputPath) {
-    const files = {};
-    const walk = (dir) => {
-        for (const entry of readdirSync(dir)) {
-            const absPath = join(dir, entry);
-            const stats = statSync(absPath);
-            if (stats.isDirectory()) {
-                walk(absPath);
-            }
-            else if (stats.isFile()) {
-                const relPath = relative(sourceDir, absPath).split(sep).join('/');
-                files[relPath] = readFileSync(absPath);
-            }
-        }
-    };
-    walk(sourceDir);
-    const zipped = zipSync(files);
-    mkdirSync(dirname(outputPath), { recursive: true });
-    writeFileSync(outputPath, zipped);
-}

package/dist/validate/__tests__/validate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/validate/__tests__/validate.test.js

@@ -1,42 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { summarizeFreshness } from '../freshness.js';
-import { detectViteError } from '../preview.js';
-describe('validate/freshness summarizeFreshness()', () => {
-    const base = { localSha: 'a', remoteSha: 'a', ahead: 0, behind: 0, uncommitted: false };
-    it('is in-sync when local==remote, no ahead/behind, clean tree', () => {
-        expect(summarizeFreshness(base).inSync).toBe(true);
-    });
-    it('is not in-sync with uncommitted changes', () => {
-        expect(summarizeFreshness({ ...base, uncommitted: true }).inSync).toBe(false);
-    });
-    it('is not in-sync when ahead of the remote', () => {
-        expect(summarizeFreshness({ ...base, ahead: 2 }).inSync).toBe(false);
-    });
-    it('is not in-sync when behind the remote', () => {
-        expect(summarizeFreshness({ ...base, behind: 1 }).inSync).toBe(false);
-    });
-    it('is not in-sync when there is no remote ref', () => {
-        expect(summarizeFreshness({ ...base, remoteSha: null }).inSync).toBe(false);
-    });
-    it('is not in-sync when there is no local HEAD', () => {
-        expect(summarizeFreshness({ ...base, localSha: null }).inSync).toBe(false);
-    });
-    it('passes through the raw counts', () => {
-        const f = summarizeFreshness({ localSha: 'x', remoteSha: 'y', ahead: 3, behind: 1, uncommitted: true });
-        expect(f).toMatchObject({ ahead: 3, behind: 1, uncommitted: true, inSync: false });
-    });
-});
-describe('validate/preview detectViteError()', () => {
-    it('detects the Vite error overlay element', () => {
-        expect(detectViteError('<vite-error-overlay></vite-error-overlay>')).toBe(true);
-    });
-    it('detects a plugin transform error', () => {
-        expect(detectViteError('[plugin:vite:react-babel] Unexpected token')).toBe(true);
-    });
-    it('detects a failed import resolution', () => {
-        expect(detectViteError('Failed to resolve import "./missing" from "src/App.tsx"')).toBe(true);
-    });
-    it('returns false for a healthy HTML document', () => {
-        expect(detectViteError('<!DOCTYPE html><html><body><div id="root"></div></body></html>')).toBe(false);
-    });
-});

package/dist/validate/freshness.d.ts

@@ -1,28 +0,0 @@
-/**
- * Git sync-freshness: how the local working tree relates to the deploy remote
- * (`runwork/main`). Answers "do I have changes that aren't synced/deployed?"
- * without scraping the sandbox (friction log #10).
- */
-export interface Freshness {
-    localSha: string | null;
-    remoteSha: string | null;
-    ahead: number;
-    behind: number;
-    uncommitted: boolean;
-    /** true when local == remote and the tree is clean. */
-    inSync: boolean;
-}
-export interface FreshnessInput {
-    localSha: string | null;
-    remoteSha: string | null;
-    ahead: number;
-    behind: number;
-    uncommitted: boolean;
-}
-/** Pure: derive the in-sync verdict from the raw git counts/flags. */
-export declare function summarizeFreshness(input: FreshnessInput): Freshness;
-/**
- * Collect git freshness for `cwd`. Best-effort fetches `runwork/main` first so
- * the comparison reflects the real remote tip; tolerates offline/no-remote.
- */
-export declare function getGitFreshness(cwd: string): Freshness;

package/dist/validate/freshness.js

@@ -1,48 +0,0 @@
-import { execFileSync } from '../utils/subprocess.js';
-/** Pure: derive the in-sync verdict from the raw git counts/flags. */
-export function summarizeFreshness(input) {
-    const inSync = input.localSha !== null &&
-        input.remoteSha !== null &&
-        input.ahead === 0 &&
-        input.behind === 0 &&
-        !input.uncommitted;
-    return { ...input, inSync };
-}
-function gitOut(cwd, args) {
-    try {
-        return execFileSync('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Collect git freshness for `cwd`. Best-effort fetches `runwork/main` first so
- * the comparison reflects the real remote tip; tolerates offline/no-remote.
- */
-export function getGitFreshness(cwd) {
-    // Best-effort: refresh the remote-tracking ref. Failure (offline, no remote)
-    // just means we compare against whatever ref we already have.
-    try {
-        execFileSync('git', ['fetch', 'runwork', 'main'], { cwd, stdio: 'pipe' });
-    }
-    catch {
-        /* offline or no runwork remote -- non-fatal */
-    }
-    const localSha = gitOut(cwd, ['rev-parse', 'HEAD']);
-    const remoteSha = gitOut(cwd, ['rev-parse', 'runwork/main']);
-    let ahead = 0;
-    let behind = 0;
-    if (localSha && remoteSha) {
-        // `<behind>\t<ahead>` relative to runwork/main...HEAD
-        const counts = gitOut(cwd, ['rev-list', '--left-right', '--count', 'runwork/main...HEAD']);
-        if (counts) {
-            const [b, a] = counts.split(/\s+/).map(n => parseInt(n, 10));
-            behind = Number.isFinite(b) ? b : 0;
-            ahead = Number.isFinite(a) ? a : 0;
-        }
-    }
-    const porcelain = gitOut(cwd, ['status', '--porcelain']);
-    const uncommitted = porcelain !== null && porcelain.length > 0;
-    return summarizeFreshness({ localSha, remoteSha, ahead, behind, uncommitted });
-}

package/dist/validate/preview.d.ts

@@ -1,21 +0,0 @@
-/**
- * Liveness of the preview deployment: does it respond, and is it serving a
- * working build (vs a Vite error overlay)? This is the cheap "is my change
- * live and compiling" signal the friction log (#10) reached for by hand.
- */
-export interface PreviewLiveness {
-    url: string | null;
-    responds: boolean;
-    status: number | null;
-    /** A Vite/build error overlay was detected in the served HTML. */
-    errorDetected: boolean;
-    error?: string;
-}
-/**
- * Heuristically detect a Vite dev-server error overlay / transform error in
- * served HTML. These are the markers Vite injects when a module fails to
- * compile, so their presence means the preview is serving a broken build.
- */
-export declare function detectViteError(html: string): boolean;
-/** Fetch the preview URL and report whether it's live and error-free. */
-export declare function checkPreview(url: string | null): Promise<PreviewLiveness>;