@glubean/cli 0.8.3 → 0.8.4

package/dist/commands/dry-run.d.ts

@@ -0,0 +1,100 @@
+export interface DryRunCommandOptions {
+    dir?: string;
+    json?: boolean;
+    out?: string;
+}
+/** One projected test, merged from static scan metadata + dynamic dry-run shape. */
+export interface ProjectedTest {
+    testId: string;
+    exportName: string;
+    file: string;
+    description?: string;
+    deprecated?: string;
+    requires?: string;
+    defaultRun?: string;
+    tags?: string[];
+    assertions: Array<{
+        kind: string;
+        message?: string;
+        branch?: string;
+    }>;
+    endpoints: Array<{
+        method: string;
+        url: string;
+        branch?: string;
+    }>;
+    assertionCount: number;
+    projectionComplete: boolean;
+    incompleteReason?: string;
+    skipped?: boolean;
+}
+/** One projected contract (C1) — the scanner's static normalized contract, plus
+ *  derived head fields, for upload to /projections/contract. */
+export interface ProjectedContract {
+    contractId: string;
+    protocol: string;
+    target?: string;
+    description?: string;
+    deprecated?: string;
+    tags?: string[];
+    caseCount: number;
+    /** Full normalized contract (cases + schemas). */
+    projection: unknown;
+    projectionComplete: boolean;
+    incompleteReason?: string;
+}
+/** One projected workflow (C1) — the scanner's static normalized workflow. */
+export interface ProjectedWorkflow {
+    workflowId: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    nodeCount: number;
+    /** Full normalized workflow (node tree + phases). */
+    projection: unknown;
+    projectionComplete: boolean;
+    incompleteReason?: string;
+}
+export interface ProjectionResult {
+    projected: ProjectedTest[];
+    files: string[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    /** Scanner warnings (e.g. "Failed to extract metadata from <file>: …") — a
+     *  file whose metadata couldn't be extracted is omitted from `files`/`projected`
+     *  entirely, so a full-snapshot sync must treat these as fatal. */
+    warnings: string[];
+    /** Test-named files that yielded ZERO exports (parser recovered from a syntax
+     *  error, or a misnamed module) — silently dropped, so also fatal for sync. */
+    emptyTestFiles: string[];
+    /** Statically-projected contracts (declarative — no dry-run). */
+    contracts: ProjectedContract[];
+    /** Statically-projected workflows (declarative — no dry-run). */
+    workflows: ProjectedWorkflow[];
+    /** OpenAPI 3.1 doc rendered from the project's HTTP contracts, for the Cloud
+     *  api-reference view (endpoints/schemas with constraints/formats/enums). `null`
+     *  when the project has no HTTP endpoints (a full sync then clears any stale doc).
+     *  See `openapiFailed` for the render-error case. */
+    openapi?: Record<string, unknown> | null;
+    /** True when OpenAPI rendering THREW (bootstrap/extract/render). Distinct from a
+     *  `null` doc: sync SKIPS the openapi upload on failure, so a transient error never
+     *  wipes the project's previously-synced API reference. */
+    openapiFailed?: boolean;
+}
+/**
+ * Scan + dry-run a directory and merge static scan metadata
+ * (description/deprecated/requires/defaultRun/bareBranchCount) with each test's
+ * dynamic dry-run shape. Shared by `glubean dry-run` (print) and `glubean sync`
+ * (upload).
+ */
+export declare function buildProjections(dir: string): Promise<ProjectionResult>;
+/**
+ * `glubean dry-run` — project the SHAPE of every simple test (assertions made,
+ * endpoints hit) without running them, for cloud team review. Combines static
+ * scan metadata (description/deprecated/bareBranchCount) with the dynamic
+ * dry-run projection.
+ */
+export declare function dryRunCommand(options?: DryRunCommandOptions): Promise<void>;
+//# sourceMappingURL=dry-run.d.ts.map

package/dist/commands/dry-run.d.ts.map

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

package/dist/commands/dry-run.js

@@ -0,0 +1,237 @@
+import { resolve, basename } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { scan, extractContractsFromProject } from "@glubean/scanner";
+import { dryRunFiles, bootstrap } from "@glubean/runner";
+import { renderArtifact, openapiArtifact, } from "@glubean/sdk";
+const colors = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    red: "\x1b[31m",
+};
+/**
+ * Scan + dry-run a directory and merge static scan metadata
+ * (description/deprecated/requires/defaultRun/bareBranchCount) with each test's
+ * dynamic dry-run shape. Shared by `glubean dry-run` (print) and `glubean sync`
+ * (upload).
+ */
+export async function buildProjections(dir) {
+    // Bootstrap the project's SDK runtime/plugins BEFORE any contract/flow module is
+    // imported — both `scan` (below) and `extractContractsFromProject` (for the OpenAPI
+    // render) import them. A project that relies on `glubean.setup.*` to make its
+    // contracts importable would otherwise cache a FAILED ESM evaluation from scan's
+    // first import, breaking every later extraction (the OpenAPI render would silently
+    // go null). Best-effort: a bootstrap failure must NOT break scan / dry-run for
+    // projects that don't need setup.
+    try {
+        await bootstrap(dir);
+    }
+    catch {
+        // ignore — scan/dry-run may still work; the OpenAPI extract fail-softs below
+    }
+    const scanResult = await scan(dir);
+    // Build a lookup of static metadata keyed by absolute file + export name.
+    const metaByKey = new Map();
+    const fileSet = new Set();
+    for (const [relPath, fileMeta] of Object.entries(scanResult.files)) {
+        const absPath = resolve(dir, relPath);
+        for (const exp of fileMeta.exports) {
+            // Only simple tests have a dry-runnable body; workflows are statically shaped.
+            if (exp.workflow)
+                continue;
+            fileSet.add(absPath);
+            metaByKey.set(`${absPath}::${exp.exportName}`, {
+                description: exp.description,
+                deprecated: exp.deprecated,
+                requires: exp.requires,
+                defaultRun: exp.defaultRun,
+                tags: exp.tags,
+                bareBranchCount: exp.bareBranchCount,
+            });
+        }
+    }
+    const files = [...fileSet];
+    const { shapes, errors } = await dryRunFiles(files, { cwd: dir });
+    const projected = shapes.map((s) => {
+        const meta = metaByKey.get(`${s.file}::${s.exportName}`) ?? {};
+        let projectionComplete = s.projectionComplete;
+        let incompleteReason = s.incompleteReason;
+        // Fold the static bare-branch signal: a native if/switch means only one arm
+        // was followed, so the shape is partial even if execution succeeded.
+        if (projectionComplete && meta.bareBranchCount && meta.bareBranchCount > 0) {
+            projectionComplete = false;
+            incompleteReason = `${meta.bareBranchCount} bare branch/loop(s) — use ctx.when()/ctx.switch()/ctx.while() for full projection`;
+        }
+        return {
+            testId: s.testId,
+            exportName: s.exportName,
+            file: s.file,
+            description: meta.description,
+            deprecated: meta.deprecated,
+            requires: meta.requires,
+            defaultRun: meta.defaultRun,
+            // Prefer the RUNTIME shape's tags (test.meta.tags) so data-driven `tagFields`
+            // row tags survive; fall back to the static scan tags when the project's
+            // runner predates shape tags (version skew), so statically-tagged tests
+            // aren't published with empty tags.
+            ...((s.tags ?? meta.tags)?.length ? { tags: s.tags ?? meta.tags } : {}),
+            assertions: s.assertions,
+            endpoints: s.endpoints,
+            assertionCount: s.assertionCount,
+            projectionComplete,
+            ...(incompleteReason ? { incompleteReason } : {}),
+            ...(s.skipped ? { skipped: true } : {}),
+        };
+    });
+    projected.sort((a, b) => a.testId.localeCompare(b.testId));
+    // Contracts + workflows are DECLARATIVE — the scanner already produced their full
+    // normalized projection statically (no dry-run). Map to the upload shape; the
+    // normalized blob is the reviewable body, the head fields derive from it.
+    const contracts = (scanResult.contractsProjection ?? []).map((c) => ({
+        contractId: c.id,
+        protocol: c.protocol,
+        target: c.target,
+        description: c.description,
+        deprecated: c.deprecated,
+        tags: c.tags,
+        caseCount: c.cases?.length ?? 0,
+        projection: c,
+        projectionComplete: !(c.unprojectableSchemas && c.unprojectableSchemas.length > 0),
+        ...(c.unprojectableSchemas && c.unprojectableSchemas.length > 0
+            ? { incompleteReason: `${c.unprojectableSchemas.length} declared schema(s) couldn't be projected` }
+            : {}),
+    }));
+    const workflows = (scanResult.workflows ?? []).map((w) => {
+        const g = w.gradeSummary ?? { full: 0, partial: 0, opaque: 0 };
+        const nodeCount = (g.full ?? 0) + (g.partial ?? 0) + (g.opaque ?? 0);
+        return {
+            workflowId: w.id,
+            name: w.name,
+            description: w.description,
+            tags: w.tags,
+            nodeCount,
+            projection: w,
+            projectionComplete: (g.opaque ?? 0) === 0,
+            ...((g.opaque ?? 0) > 0
+                ? { incompleteReason: `${g.opaque} node(s) projected opaque — not fully statically shaped` }
+                : {}),
+        };
+    });
+    contracts.sort((a, b) => a.contractId.localeCompare(b.contractId));
+    workflows.sort((a, b) => a.workflowId.localeCompare(b.workflowId));
+    // Render an OpenAPI 3.1 doc from the SAME contracts, so Cloud can show
+    // endpoints/schemas with the published api-reference view. This needs the
+    // RUNTIME extraction (real schema objects → JSON Schema); the static scan's
+    // `contractsProjection` can't produce it. Same-process ESM import is cached,
+    // so this doesn't re-run contract module side effects. Best-effort — a failure
+    // here never blocks the test/contract/workflow projection.
+    // Three DISTINCT states, because sync treats them differently:
+    //   • a real doc (has HTTP paths)   → upload it
+    //   • no HTTP endpoints (null)      → upload null, clearing any stale doc
+    //   • render FAILED (openapiFailed) → sync SKIPS the upload, preserving the prior doc
+    // (so a transient bootstrap/extract/render error never wipes the API reference).
+    let openapi = null;
+    let openapiFailed = false;
+    try {
+        // bootstrap already ran at the top of buildProjections (before scan imported the
+        // contract modules), so the runtime extraction below resolves cleanly.
+        const { contracts: rawContracts, errors: extractErrors } = await extractContractsFromProject(dir);
+        if (extractErrors && extractErrors.length > 0) {
+            // Per-file import/synthesis failures are REPORTED here (not thrown). A partial
+            // extraction must not publish a half-doc or clear the prior one — skip + preserve.
+            openapiFailed = true;
+        }
+        else if (rawContracts.length > 0) {
+            const doc = renderArtifact(openapiArtifact, rawContracts, { title: basename(dir) || "API Specification" });
+            // An empty fallback (non-HTTP / inbound-only contracts) carries no paths — that's
+            // "no API reference" (null → clear), NOT a real doc.
+            const paths = doc?.paths;
+            openapi = paths && Object.keys(paths).length > 0 ? doc : null;
+        }
+    }
+    catch {
+        // Render threw — keep `openapi` null but flag the failure so sync skips the upload
+        // instead of clearing a previously-synced doc.
+        openapiFailed = true;
+    }
+    return {
+        projected,
+        files,
+        errors,
+        warnings: scanResult.warnings,
+        emptyTestFiles: scanResult.emptyTestFiles,
+        contracts,
+        workflows,
+        openapi,
+        openapiFailed,
+    };
+}
+/**
+ * `glubean dry-run` — project the SHAPE of every simple test (assertions made,
+ * endpoints hit) without running them, for cloud team review. Combines static
+ * scan metadata (description/deprecated/bareBranchCount) with the dynamic
+ * dry-run projection.
+ */
+export async function dryRunCommand(options = {}) {
+    const dir = options.dir ? resolve(options.dir) : process.cwd();
+    const { projected, files, errors, warnings, emptyTestFiles, openapi } = await buildProjections(dir);
+    // Files that contribute NO projection though they look like tests — a sync
+    // would silently drop them (see syncCommand).
+    const dropped = [
+        ...warnings.filter((w) => w.startsWith("Failed to extract metadata from")),
+        ...emptyTestFiles.map((f) => `${f} — a Glubean test file with no extractable tests (syntax error, or tests removed/unrecognized?)`),
+    ];
+    if (options.out) {
+        await writeFile(resolve(options.out), JSON.stringify({ tests: projected, errors, warnings, emptyTestFiles, openapi }, null, 2));
+    }
+    if (options.json) {
+        console.log(JSON.stringify({ tests: projected, errors, warnings, emptyTestFiles, openapi }, null, 2));
+        return;
+    }
+    // ── Human-readable ──
+    console.log(`\n${colors.bold}${colors.blue}🔬 Glubean Dry-Run (shape projection)${colors.reset}\n`);
+    console.log(`${colors.dim}Directory: ${dir}${colors.reset}`);
+    console.log(`${colors.dim}Projected: ${projected.length} test(s) from ${files.length} file(s)${colors.reset}\n`);
+    for (const t of projected) {
+        const flag = t.skipped
+            ? `${colors.yellow}(skipped)${colors.reset}`
+            : t.projectionComplete
+                ? `${colors.green}● complete${colors.reset}`
+                : `${colors.yellow}◐ partial${colors.reset}`;
+        console.log(`${colors.bold}${t.testId}${colors.reset}  ${flag}`);
+        if (t.description)
+            console.log(`  ${colors.dim}${t.description}${colors.reset}`);
+        if (t.deprecated)
+            console.log(`  ${colors.yellow}⚠ deprecated: ${t.deprecated}${colors.reset}`);
+        if (t.endpoints.length) {
+            const eps = t.endpoints.map((e) => `${e.method} ${e.url}`).join(", ");
+            console.log(`  ${colors.dim}endpoints:${colors.reset} ${eps}`);
+        }
+        console.log(`  ${colors.dim}assertions (${t.assertionCount}):${colors.reset}`);
+        for (const a of t.assertions) {
+            const label = a.message ? `${a.kind} "${a.message}"` : a.kind;
+            const branch = a.branch ? ` ${colors.dim}[${a.branch}]${colors.reset}` : "";
+            console.log(`    - ${label}${branch}`);
+        }
+        if (!t.projectionComplete && t.incompleteReason) {
+            console.log(`  ${colors.yellow}⚠ partial: ${t.incompleteReason}${colors.reset}`);
+        }
+        console.log();
+    }
+    if (errors.length) {
+        console.log(`${colors.red}Import errors:${colors.reset}`);
+        for (const e of errors)
+            console.log(`  ${colors.red}✗ ${e.file}: ${e.message}${colors.reset}`);
+        console.log();
+    }
+    if (dropped.length) {
+        console.log(`${colors.red}Dropped files (their tests are omitted — sync would delete them):${colors.reset}`);
+        for (const w of dropped)
+            console.log(`  ${colors.red}✗ ${w}${colors.reset}`);
+        console.log();
+    }
+}
+//# sourceMappingURL=dry-run.js.map

package/dist/commands/dry-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../src/commands/dry-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,UAAU;CAChB,CAAC;AAiFF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,iFAAiF;IACjF,oFAAoF;IACpF,8EAA8E;IAC9E,iFAAiF;IACjF,mFAAmF;IACnF,+EAA+E;IAC/E,kCAAkC;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAEnC,0EAA0E;IAC1E,MAAM,SAAS,GAAG,IAAI,GAAG,EAUtB,CAAC;IACJ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnC,+EAA+E;YAC/E,IAAI,GAAG,CAAC,QAAQ;gBAAE,SAAS;YAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,GAAG,CAAC,UAAU,EAAE,EAAE;gBAC7C,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,eAAe,EAAE,GAAG,CAAC,eAAe;aACrC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAElE,MAAM,SAAS,GAAoB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC;QAC9C,IAAI,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;QAC1C,4EAA4E;QAC5E,qEAAqE;QACrE,IAAI,kBAAkB,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC3E,kBAAkB,GAAG,KAAK,CAAC;YAC3B,gBAAgB,GAAG,GAAG,IAAI,CAAC,eAAe,oFAAoF,CAAC;QACjI,CAAC;QACD,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,8EAA8E;YAC9E,yEAAyE;YACzE,wEAAwE;YACxE,oCAAoC;YACpC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,kBAAkB;YAClB,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3D,kFAAkF;IAClF,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,SAAS,GAAwB,CAAC,UAAU,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxF,UAAU,EAAE,CAAC,CAAC,EAAE;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;QAC/B,UAAU,EAAE,CAAC;QACb,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC;QAClF,GAAG,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC;YAC7D,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC,oBAAoB,CAAC,MAAM,2CAA2C,EAAE;YACnG,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC,CAAC;IACJ,MAAM,SAAS,GAAwB,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5E,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QACrE,OAAO;YACL,UAAU,EAAE,CAAC,CAAC,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS;YACT,UAAU,EAAE,CAAC;YACb,kBAAkB,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;YACzC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;gBACrB,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC,MAAM,yDAAyD,EAAE;gBAC5F,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACnE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnE,uEAAuE;IACvE,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,+EAA+E;IAC/E,2DAA2D;IAC3D,+DAA+D;IAC/D,gDAAgD;IAChD,0EAA0E;IAC1E,sFAAsF;IACtF,iFAAiF;IACjF,IAAI,OAAO,GAAmC,IAAI,CAAC;IACnD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,CAAC;QACH,iFAAiF;QACjF,uEAAuE;QACvE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,2BAA2B,CAAC,GAAG,CAAC,CAAC;QAClG,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,+EAA+E;YAC/E,mFAAmF;YACnF,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,cAAc,CACxB,eAAe,EACf,YAA0E,EAC1E,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,mBAAmB,EAAE,CACrB,CAAC;YAC7B,kFAAkF;YAClF,qDAAqD;YACrD,MAAM,KAAK,GAAG,GAAG,EAAE,KAA4C,CAAC;YAChE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;QACnF,+CAA+C;QAC/C,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,OAAO;QACL,SAAS;QACT,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,SAAS;QACT,SAAS;QACT,OAAO;QACP,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpG,2EAA2E;IAC3E,8CAA8C;IAC9C,MAAM,OAAO,GAAG;QACd,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;QAC1E,GAAG,cAAc,CAAC,GAAG,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,iGAAiG,CAC7G;KACF,CAAC;IAEF,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClI,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtG,OAAO;IACT,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,wCAAwC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,cAAc,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,cAAc,SAAS,CAAC,MAAM,iBAAiB,KAAK,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAEjH,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO;YACpB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,EAAE;YAC5C,CAAC,CAAC,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,aAAa,MAAM,CAAC,KAAK,EAAE;gBAC5C,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC,WAAW;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,CAAC,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,iBAAiB,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,aAAa,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/E,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,cAAc,CAAC,CAAC,gBAAgB,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,iBAAiB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,oEAAoE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7G,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/commands/run.d.ts

@@ -44,6 +44,10 @@ interface RunOptions {
     includeOptIn?: boolean;
     upload?: boolean;
     uploadReceiptJson?: string;
+    /** ART1-B escape hatch — keep this run's local screenshot files after a
+     *  successful `--upload` instead of the default post-upload cleanup
+     *  (which unlinks only server-confirmed, whitelist-contained files). */
+    keepLocal?: boolean;
     project?: string;
     /**
      * Upload TARGET (the API/system under test the runs belong to). Resolved from
@@ -115,6 +119,20 @@ interface RunOptions {
      * per-profile gates that the legacy flat-shape path can't express.
      */
     thresholds?: import("@glubean/sdk").ThresholdConfig;
+    /**
+     * B2 M3 — `{id, rowIndex}` selector protocol.
+     *
+     * `onlyId` — run only the test(s) with a matching id (repeatable). For `.each`
+     * rows, pass the concrete expanded id (e.g. `user-0`).
+     *
+     * `row` — with a single `onlyId`, isolate the 0-based `.each` row index.
+     *
+     * `rerunFailed` — re-run only the tests that failed in the last `glubean run`
+     * (reads `.glubean/last-run.result.json`). Mutually exclusive with onlyId/row.
+     */
+    onlyId?: string[];
+    row?: number;
+    rerunFailed?: boolean;
 }
 export declare function findProjectConfig(startDir: string): Promise<{
     rootDir: string;

package/dist/commands/run.d.ts.map

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

package/dist/commands/run.js

@@ -1,4 +1,5 @@
 import { bootstrap, evaluateThresholds, MetricCollector, ProjectRunner, buildRunContext, } from "@glubean/runner";
+import { buildOnlySelectorsFromFlags, deriveRerunSelectors } from "../lib/only-selectors.js";
 import { basename, dirname, isAbsolute, relative, resolve } from "node:path";
 import { randomUUID } from "node:crypto";
 import { stat, readdir, readFile, writeFile, mkdir, rm } from "node:fs/promises";
@@ -519,8 +520,8 @@ export async function runCommand(target, options = {}) {
     const interactive = capabilityProfile.browser;
     const traceCollector = [];
     console.log(`\n${colors.bold}${colors.blue}🧪 Glubean Test Runner${colors.reset}\n`);
-    const testFiles = await resolveTestFiles(target);
-    const isMultiFile = testFiles.length > 1;
+    let testFiles = await resolveTestFiles(target);
+    let isMultiFile = testFiles.length > 1;
     // Single string view of target for serialization / display paths
     // (result.json, junit, traces). Multi-suite passes an array; join with
     // ", " so downstream consumers still see a printable target field.
@@ -544,6 +545,59 @@ export async function runCommand(target, options = {}) {
     }
     const startDir = testFiles[0].substring(0, testFiles[0].lastIndexOf("/"));
     const { rootDir } = await findProjectConfig(startDir);
+    // ── B2 M3 — `{id, rowIndex}` "only" selectors ────────────────────────────
+    // Validate the --only-id / --row / --rerun-failed combo up front (single
+    // gate), then resolve the active selector set. `--rerun-failed` reads the
+    // previous run and narrows discovery to the files that failed; `--only-id` /
+    // `--row` narrow `testsToRun` below by template-matching concrete ids against
+    // static `.each` template ids. Either way the precise per-row filter runs in
+    // the harness subprocess via the GLUBEAN_RUNNER_ONLY_SELECTORS env channel.
+    let onlySelectors = [];
+    const selectorFlags = buildOnlySelectorsFromFlags({
+        onlyId: options.onlyId,
+        row: options.row,
+        rerunFailed: options.rerunFailed,
+    });
+    if (!selectorFlags.ok) {
+        console.error(`\n${colors.red}❌ ${selectorFlags.error}${colors.reset}\n`);
+        process.exit(1);
+    }
+    if (options.rerunFailed) {
+        const lastRunPath = resolve(rootDir, ".glubean", "last-run.result.json");
+        let lastRun;
+        try {
+            lastRun = JSON.parse(await readFile(lastRunPath, "utf-8"));
+        }
+        catch {
+            console.error(`\n${colors.red}❌ No previous run found. Run \`glubean run\` first.${colors.reset}\n` +
+                `${colors.dim}--rerun-failed reads ${lastRunPath}.${colors.reset}\n`);
+            process.exit(1);
+        }
+        const { selectors, files } = deriveRerunSelectors({ tests: lastRun.tests ?? [] });
+        if (selectors.length === 0) {
+            console.log(`\n${colors.green}✓ Last run had no failures — nothing to rerun.${colors.reset}\n`);
+            process.exit(0);
+        }
+        // Narrow discovery to the files that contained a failure. `files` were
+        // written relative to rootDir (resultPayload.tests.filePath) — rootDir is the
+        // stable basis (the dir holding .glubean/), so rerun resolves correctly even
+        // when invoked from a different cwd than the original run. Resolve both sides
+        // to absolute for an exact match against the discovered testFiles.
+        const failedFilesAbs = new Set(files.map((f) => resolve(rootDir, f)));
+        testFiles = testFiles.filter((f) => failedFilesAbs.has(resolve(f)));
+        isMultiFile = testFiles.length > 1;
+        if (testFiles.length === 0) {
+            console.error(`\n${colors.red}❌ --rerun-failed: none of the ${failedFilesAbs.size} failed file(s) ` +
+                `from the last run are in the current target.${colors.reset}\n`);
+            process.exit(1);
+        }
+        onlySelectors = selectors;
+        console.log(`${colors.dim}--rerun-failed: ${selectors.length} failed test(s) across ` +
+            `${testFiles.length} file(s)${colors.reset}\n`);
+    }
+    else {
+        onlySelectors = selectorFlags.selectors;
+    }
     // Config consolidation (docs/06 P2): the legacy package.json `glubean`
     // flat-shape is no longer read. Profile runs get run/redaction/thresholds
     // from the resolved plan (threaded via `options`); non-profile target runs
@@ -797,7 +851,7 @@ export async function runCommand(target, options = {}) {
     }
     const hasTags = options.tags && options.tags.length > 0;
     const hasExcludeTags = options.excludeTags && options.excludeTags.length > 0;
-    const testsToRun = allFileTests.filter((ft) => {
+    let testsToRun = allFileTests.filter((ft) => {
         const tc = ft.test;
         if (tc.meta.skip)
             return false;
@@ -811,6 +865,26 @@ export async function runCommand(target, options = {}) {
             return false;
         return true;
     });
+    // B2 M3 — narrow testsToRun for --only-id / --row. Selector ids are CONCRETE
+    // (e.g. `user-0`); a `.each` export appears in discovery under its TEMPLATE id
+    // (e.g. `user-$index`). Template-match each selector id against the discovered
+    // template ids so concrete selectors reach the right export — the harness then
+    // applies the precise per-row filter at runtime. (Rerun narrows by file above.)
+    if (onlySelectors.length > 0 && !options.rerunFailed) {
+        const selectorIds = Array.from(new Set(onlySelectors.map((s) => (typeof s === "string" ? s : s.id))));
+        const indexed = testsToRun.map((ft) => ({ id: ft.test.meta.id, ft }));
+        const kept = new Set();
+        for (const selId of selectorIds) {
+            const match = findTemplateMatch(indexed, selId);
+            if (match)
+                kept.add(match.ft);
+        }
+        testsToRun = testsToRun.filter((ft) => kept.has(ft));
+        if (testsToRun.length === 0) {
+            console.error(`\n${colors.red}❌ No tests match --only-id ${selectorIds.join(", ")}${colors.reset}\n`);
+            process.exit(1);
+        }
+    }
     if (testsToRun.length === 0) {
         if (options.filter || hasTags) {
             const parts = [];
@@ -952,6 +1026,15 @@ export async function runCommand(target, options = {}) {
         delete process.env["GLUBEAN_RUNNER_BOOTSTRAP_INPUT_MAP"];
         delete process.env["GLUBEAN_RUNNER_FORCE_STANDALONE_IDS"];
     }
+    // B2 M3 — hand the resolved selector set to the harness subprocess (it applies
+    // the precise per-row filter at runtime). Clear it otherwise so a stale value
+    // never leaks across in-process invocations (parity with the input maps above).
+    if (onlySelectors.length > 0) {
+        process.env["GLUBEAN_RUNNER_ONLY_SELECTORS"] = JSON.stringify(onlySelectors);
+    }
+    else {
+        delete process.env["GLUBEAN_RUNNER_ONLY_SELECTORS"];
+    }
     if (options.pick) {
         process.env.GLUBEAN_PICK = options.pick;
         console.log(`${colors.dim}  pick: ${options.pick}${colors.reset}`);
@@ -1024,6 +1107,7 @@ export async function runCommand(target, options = {}) {
     let currentTestItems;
     let testId = "";
     let testName = "";
+    let testRowIndex = undefined;
     let testItem = null;
     let startTime = Date.now();
     let testEvents = [];
@@ -1089,6 +1173,7 @@ export async function runCommand(target, options = {}) {
             success: skippedClean ? true : finalSuccess,
             durationMs: duration,
             groupId: testItem?.meta.groupId,
+            rowIndex: testRowIndex,
         });
         addLogEntry("result", skippedClean ? "SKIPPED" : finalSuccess ? "PASSED" : "FAILED", {
             duration,
@@ -1406,6 +1491,10 @@ export async function runCommand(target, options = {}) {
                             (currentTestItems ? findFileTestByRuntimeId(currentTestItems, event.id) : undefined);
                         testId = event.id;
                         testName = entry?.test.meta.name || event.name || event.id;
+                        // rowIndex (B2 M3): the runtime start event is authoritative for the
+                        // per-row `.each` index (static discovery only sees the template id,
+                        // so it carries no rowIndex). undefined for non-each tests.
+                        testRowIndex = event.rowIndex;
                         testItem = entry?.test || null;
                         startTime = Date.now();
                         testEvents = [];
@@ -1871,6 +1960,12 @@ export async function runCommand(target, options = {}) {
             success: r.success,
             durationMs: r.durationMs,
             events: r.events,
+            // B2 M3 — persist rowIndex + filePath so `--rerun-failed` can reconstruct
+            // the failed `{id, rowIndex}` selector set and narrow to the failed files.
+            // filePath is relative to rootDir (the stable .glubean/ basis), NOT cwd, so
+            // rerun resolves correctly when run from a different working directory.
+            ...(r.rowIndex !== undefined && { rowIndex: r.rowIndex }),
+            filePath: relative(rootDir, r.filePath),
         })),
         ...(thresholdSummary && { thresholds: thresholdSummary }),
         ...(options.meta && Object.keys(options.meta).length > 0 && { customMetadata: options.meta }),
@@ -1924,29 +2019,30 @@ export async function runCommand(target, options = {}) {
         }
     }
     // ── Screenshot paths ──────────────────────────────────────────────────
-    {
-        const screenshotPaths = [];
-        for (const run of collectedRuns) {
-            for (const event of run.events) {
-                if (event.type !== "event")
-                    continue;
-                const ev = event.data;
-                if (ev.type === "browser:screenshot" && typeof ev.data?.path === "string") {
-                    screenshotPaths.push(resolve(rootDir, ev.data.path));
-                }
+    // This run's exact screenshot files, pulled from the `browser:screenshot`
+    // event stream. Doubles as the upload whitelist below so `--upload` attaches
+    // only THIS run's screenshots, not every file in the shared dir (ART1).
+    const screenshotPaths = [];
+    for (const run of collectedRuns) {
+        for (const event of run.events) {
+            if (event.type !== "event")
+                continue;
+            const ev = event.data;
+            if (ev.type === "browser:screenshot" && typeof ev.data?.path === "string") {
+                screenshotPaths.push(resolve(rootDir, ev.data.path));
             }
         }
-        if (screenshotPaths.length > 0) {
-            for (const p of screenshotPaths) {
-                console.log(`${colors.dim}Screenshot: ${colors.reset}${p}`);
-            }
-            console.log();
+    }
+    if (screenshotPaths.length > 0) {
+        for (const p of screenshotPaths) {
+            console.log(`${colors.dim}Screenshot: ${colors.reset}${p}`);
         }
+        console.log();
     }
     // ── Cloud upload ────────────────────────────────────────────────────────
     if (options.upload) {
         const { resolveToken, resolveProjectId, resolveApiUrl } = await import("../lib/auth.js");
-        const { uploadToCloud } = await import("../lib/upload.js");
+        const { uploadToCloud, removeUploadedScreenshots } = await import("../lib/upload.js");
         const authOpts = {
             token: options.token,
             project: options.project,
@@ -2096,7 +2192,27 @@ export async function runCommand(target, options = {}) {
                     targetId,
                     envFile: effectiveRun.envFile,
                     rootDir,
+                    // Upload only THIS run's screenshots (whitelist), not the whole
+                    // shared `.glubean/screenshots` dir which accumulates prior runs.
+                    screenshotPaths,
                 });
+                // ART1-B — the shared screenshots dir only ever grows, so once the
+                // Cloud confirmed it received this run's screenshots, delete the local
+                // copies. Deletes ONLY uploadedFiles ∩ screenshotPaths (both server-
+                // confirmed and provably this run's), realpath-contained to
+                // `.glubean/screenshots`, and only while the on-disk file still has
+                // its upload-time stat identity (re-checked just before each unlink)
+                // — a failed/partial upload keeps its files, and a concurrently
+                // recreated path is kept.
+                if (!options.keepLocal &&
+                    uploadReceipt.artifactUpload.status === "uploaded" &&
+                    uploadReceipt.artifactUpload.uploadedFiles?.length &&
+                    screenshotPaths.length > 0) {
+                    const { removed } = await removeUploadedScreenshots(rootDir, screenshotPaths, uploadReceipt.artifactUpload.uploadedFiles);
+                    if (removed > 0) {
+                        console.log(`${colors.dim}Cleaned up ${removed} uploaded screenshot(s) from .glubean/screenshots (use --keep-local to keep them)${colors.reset}`);
+                    }
+                }
                 if (options.uploadReceiptJson) {
                     const receiptPath = resolveOutputPath(options.uploadReceiptJson, process.cwd());
                     await mkdir(dirname(receiptPath), { recursive: true });