@tangle-network/browser-agent-driver 0.30.0 → 0.31.0

package/dist/cli-jobs.js

@@ -0,0 +1,262 @@
+/**
+ * `bad jobs` — declarative comparative-audit jobs.
+ *
+ * Subcommands:
+ *   bad jobs create --spec <file.json>   # mints a job from a JSON spec, runs it
+ *   bad jobs status <jobId> [--json]     # show a job's current state
+ *   bad jobs list [--json]               # recent jobs
+ *   bad jobs estimate --spec <file.json> # pre-flight cost estimate, no execution
+ *
+ * The spec file is JSON (no yaml dep). See `JobSpec` in src/jobs/types.ts.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import chalk from 'chalk';
+import { cliError } from './cli-ui.js';
+import { discoverTargets } from './discover/index.js';
+function die(msg) {
+    cliError(msg);
+    process.exit(1);
+}
+import { createJob, runJob, loadJob, listJobs, estimateCost, } from './jobs/index.js';
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--spec')
+            out.spec = argv[++i];
+        else if (a === '--json')
+            out.json = true;
+        else if (a === '--yes' || a === '-y')
+            out.yes = true;
+        else if (a === '--max-iterations')
+            out.maxIterations = Number(argv[++i]);
+        else if (!a.startsWith('-') && !out.jobId)
+            out.jobId = a;
+    }
+    return out;
+}
+function readSpec(specPath) {
+    if (!fs.existsSync(specPath))
+        die(`spec file not found: ${specPath}`);
+    const raw = fs.readFileSync(specPath, 'utf-8');
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        die(`spec file is not valid JSON: ${err.message}`);
+    }
+}
+export async function runJobsCli(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    const opts = parseArgs(rest);
+    if (sub === 'list')
+        return cmdList(opts);
+    if (sub === 'status')
+        return cmdStatus(opts);
+    if (sub === 'estimate')
+        return cmdEstimate(opts);
+    if (sub === 'create')
+        return cmdCreate(opts);
+    if (sub === 'resume')
+        return cmdResume(opts);
+    if (sub === 'orchestrate')
+        return cmdOrchestrate(opts);
+    die(`Unknown subcommand: ${sub}. Use create | list | status | estimate | resume | orchestrate.`);
+}
+function cmdList(opts) {
+    const entries = listJobs();
+    if (opts.json) {
+        console.log(JSON.stringify(entries, null, 2));
+        return;
+    }
+    if (entries.length === 0) {
+        console.log(chalk.dim('No jobs yet. Try `bad jobs create --spec <file>`.'));
+        return;
+    }
+    for (const e of entries.slice(0, 50)) {
+        const status = e.status === 'completed' ? chalk.green(e.status)
+            : e.status === 'failed' || e.status === 'cancelled' ? chalk.red(e.status)
+                : e.status === 'partial' ? chalk.yellow(e.status)
+                    : chalk.dim(e.status);
+        console.log(`  ${e.jobId}  ${status}  targets=${e.targetCount}  ${chalk.dim(e.createdAt)}  ${e.label ?? ''}`);
+    }
+}
+function cmdStatus(opts) {
+    if (!opts.jobId)
+        die('jobId is required: bad jobs status <jobId>');
+    const job = loadJob(opts.jobId);
+    if (!job)
+        die(`job not found: ${opts.jobId}`);
+    if (opts.json) {
+        console.log(JSON.stringify(job, null, 2));
+        return;
+    }
+    const ok = job.results.filter(r => r.status === 'ok').length;
+    const failed = job.results.filter(r => r.status === 'failed').length;
+    console.log(`  ${chalk.bold(job.jobId)}  ${chalk.dim(job.status)}`);
+    if (job.spec.label)
+        console.log(`  label: ${job.spec.label}`);
+    console.log(`  targets: ${job.targets.length}  ·  ok: ${ok}  ·  failed: ${failed}`);
+    console.log(`  cost: $${job.totalCostUSD.toFixed(2)}`);
+    console.log(`  created: ${job.createdAt}`);
+    if (job.completedAt)
+        console.log(`  completed: ${job.completedAt}`);
+}
+async function cmdEstimate(opts) {
+    if (!opts.spec)
+        die('--spec is required for estimate');
+    const spec = readSpec(opts.spec);
+    const targets = await discoverTargets(spec.discover);
+    const { computePerAuditFromHistory } = await import('./jobs/cost-history.js');
+    const adaptive = computePerAuditFromHistory();
+    const est = estimateCost(spec, targets.length, adaptive.perAuditUSD);
+    if (opts.json) {
+        console.log(JSON.stringify({ spec, ...est, costSource: adaptive.source, jobsObserved: adaptive.jobsObserved }, null, 2));
+        return;
+    }
+    console.log(`  Targets: ${est.targetCount}`);
+    console.log(`  Per-audit: $${est.perAuditUSD.toFixed(2)} ${chalk.dim(`(${adaptive.source}${adaptive.source === 'history' ? `, n=${adaptive.targetsObserved}` : ''})`)}`);
+    console.log(`  Estimated total: $${est.estimatedTotalUSD.toFixed(2)}`);
+    if (est.exceedsCap && spec.maxCostUSD !== undefined) {
+        console.log(chalk.yellow(`  ⚠ exceeds cap of $${spec.maxCostUSD.toFixed(2)}`));
+    }
+}
+async function cmdCreate(opts) {
+    if (!opts.spec)
+        die('--spec is required: bad jobs create --spec <file.json>');
+    const spec = readSpec(opts.spec);
+    const targets = await discoverTargets(spec.discover);
+    if (targets.length === 0)
+        die('discover yielded zero targets — check your URLs / wayback range');
+    const est = estimateCost(spec, targets.length);
+    console.log(`  Targets discovered: ${targets.length}`);
+    console.log(`  Estimated cost: $${est.estimatedTotalUSD.toFixed(2)}`);
+    if (est.exceedsCap && spec.maxCostUSD !== undefined) {
+        die(`Estimated cost $${est.estimatedTotalUSD.toFixed(2)} exceeds maxCostUSD $${spec.maxCostUSD.toFixed(2)}. Raise the cap or shrink the job.`);
+    }
+    const job = createJob(spec, targets);
+    console.log(`  Created job ${chalk.bold(job.jobId)}`);
+    const auditFn = await buildAuditFn(spec);
+    await runJob(job, { auditFn });
+    const final = loadJob(job.jobId);
+    console.log(`  Status: ${chalk.bold(final?.status ?? 'unknown')}  ·  ok: ${final?.results.filter(r => r.status === 'ok').length ?? 0}/${final?.targets.length ?? 0}  ·  $${final?.totalCostUSD.toFixed(2)}`);
+}
+async function cmdResume(opts) {
+    if (!opts.jobId)
+        die('jobId is required: bad jobs resume <jobId>');
+    const job = loadJob(opts.jobId);
+    if (!job)
+        die(`job not found: ${opts.jobId}`);
+    const remaining = job.targets.filter(t => {
+        const key = t.snapshotUrl ?? t.url;
+        return !job.results.some(r => (r.snapshotUrl ?? r.url) === key && (r.status === 'ok' || r.status === 'skipped'));
+    });
+    if (remaining.length === 0) {
+        console.log(chalk.green(`  Nothing to resume — all ${job.targets.length} targets already completed or skipped.`));
+        return;
+    }
+    console.log(`  Resuming job ${chalk.bold(job.jobId)}  ·  ${remaining.length}/${job.targets.length} targets remain`);
+    const auditFn = await buildAuditFn(job.spec);
+    await runJob(job, { auditFn, resume: true });
+    const final = loadJob(job.jobId);
+    console.log(`  Status: ${chalk.bold(final?.status ?? 'unknown')}  ·  ok: ${final?.results.filter(r => r.status === 'ok').length ?? 0}/${final?.targets.length ?? 0}`);
+}
+async function cmdOrchestrate(opts) {
+    if (!opts.spec)
+        die('--spec is required: bad jobs orchestrate --spec <file.json>');
+    const spec = readSpec(opts.spec);
+    const targets = await discoverTargets(spec.discover);
+    if (targets.length === 0)
+        die('discover yielded zero targets — check your URLs / wayback range');
+    const est = estimateCost(spec, targets.length);
+    console.log(`  Targets discovered: ${targets.length}`);
+    console.log(`  Estimated cost: $${est.estimatedTotalUSD.toFixed(2)}`);
+    if (est.exceedsCap && spec.maxCostUSD !== undefined) {
+        die(`Estimated cost $${est.estimatedTotalUSD.toFixed(2)} exceeds maxCostUSD $${spec.maxCostUSD.toFixed(2)}`);
+    }
+    const job = createJob(spec, targets);
+    console.log(`  Created job ${chalk.bold(job.jobId)} (orchestrator mode)`);
+    const auditFn = await buildAuditFn(spec);
+    const { orchestrateJob } = await import('./jobs/orchestrator.js');
+    await orchestrateJob(job, { auditFn, verbose: true, maxIterations: opts.maxIterations });
+    const final = loadJob(job.jobId);
+    console.log(`  Status: ${chalk.bold(final?.status ?? 'unknown')}  ·  ok: ${final?.results.filter(r => r.status === 'ok').length ?? 0}/${final?.targets.length ?? 0}  ·  $${final?.totalCostUSD.toFixed(2)}`);
+}
+/**
+ * Wire the runner to the design-audit pipeline. Imported lazily so `bad jobs
+ * list` doesn't pull in Playwright. Each target gets its own output dir so
+ * we can deterministically locate `report.json` after the audit returns.
+ */
+async function buildAuditFn(_spec) {
+    const { runDesignAudit, extractDesignTokens } = await import('./cli-design-audit.js');
+    const { detectBlock } = await import('./jobs/anti-bot.js');
+    let counter = 0;
+    return async (target, opts) => {
+        const url = target.snapshotUrl ?? target.url;
+        counter += 1;
+        const slug = `${slugify(url)}-${Date.now()}-${counter}`;
+        const outputDir = path.join('audit-results', 'jobs', slug);
+        await runDesignAudit({
+            url,
+            pages: opts?.pages ?? 1,
+            output: outputDir,
+            json: true,
+            headless: opts?.headless ?? true,
+            audience: opts?.audience?.join(','),
+            audienceVulnerability: opts?.audienceVulnerability?.join(','),
+            modality: opts?.modality,
+            regulatoryContext: opts?.regulatoryContext?.join(','),
+            skipEthics: opts?.skipEthics,
+        });
+        const reportJson = path.resolve(outputDir, 'report.json');
+        if (!fs.existsSync(reportJson)) {
+            throw new Error(`audit completed but report.json missing at ${reportJson}`);
+        }
+        const data = JSON.parse(fs.readFileSync(reportJson, 'utf-8'));
+        const page = data.pages?.[0];
+        const rollupScore = page?.auditResultV2?.rollup?.score ?? page?.rollup?.score ?? page?.score;
+        const pageType = page?.auditResultV2?.classification?.type ?? page?.classification?.type;
+        // Anti-bot / blocked-page detection. When fired, runOne records skipped.
+        const blockedReason = detectBlock(data) ?? undefined;
+        let tokensPath;
+        // Skip token extraction on blocked pages — there's no real DOM to mine.
+        if (opts?.extractTokens && !blockedReason) {
+            try {
+                const tokensDir = path.join(outputDir, 'tokens');
+                const { tokens } = await extractDesignTokens({ url, headless: opts?.headless ?? true, outputDir: tokensDir });
+                tokensPath = path.resolve(tokensDir, 'tokens.json');
+                // extractDesignTokens persists its own files; ensure tokens.json exists at the canonical path,
+                // and stamp it with our schemaVersion so future readers can refuse incompatible shapes.
+                const tokensWithVersion = { schemaVersion: 1, ...tokens };
+                if (!fs.existsSync(tokensPath)) {
+                    fs.writeFileSync(tokensPath, JSON.stringify(tokensWithVersion, null, 2));
+                }
+                else {
+                    // Re-stamp existing file with schemaVersion if missing.
+                    const existing = JSON.parse(fs.readFileSync(tokensPath, 'utf-8'));
+                    if (typeof existing.schemaVersion !== 'number') {
+                        fs.writeFileSync(tokensPath, JSON.stringify({ schemaVersion: 1, ...existing }, null, 2));
+                    }
+                }
+            }
+            catch (err) {
+                // Token extraction is additive — never let it fail the parent audit.
+                console.warn(`  ${chalk.dim('tokens:')} extraction failed for ${url}: ${err.message}`);
+            }
+        }
+        return {
+            runId: outputDir, // The output dir is the de-facto runId for jobs.
+            resultPath: reportJson,
+            rollupScore,
+            pageType,
+            tokensPath,
+            blockedReason,
+        };
+    };
+}
+function slugify(url) {
+    return url.replace(/^https?:\/\//, '').replace(/[^a-z0-9]+/gi, '-').replace(/^-|-$/g, '').slice(0, 60).toLowerCase();
+}
+//# sourceMappingURL=cli-jobs.js.map

package/dist/cli-jobs.js.map

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

package/dist/cli-patterns.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Layer 5 — `bad patterns` subcommand surface.
+ *
+ * Provides pattern query and inspection via CLI. Mining runs as a periodic
+ * Cloudflare Worker cron in production; locally it reads from ~/.bad/patterns/.
+ *
+ *   bad patterns query [--category <cat>] [--page-type <type>] [--weak-dimension <dim>]
+ *   bad patterns show <patternId>
+ *   bad patterns mine [--dir <path>]
+ */
+import type { Dimension, PageType } from './design/audit/v2/types.js';
+export interface PatternsQueryOptions {
+    category?: string;
+    pageType?: PageType;
+    weakDimension?: Dimension;
+    minApplications?: number;
+    minSuccessRate?: number;
+    json?: boolean;
+    dir?: string;
+}
+export declare function runPatternsQuery(opts: PatternsQueryOptions): Promise<void>;
+export declare function runPatternsShow(patternId: string, opts?: {
+    json?: boolean;
+    dir?: string;
+}): Promise<void>;
+//# sourceMappingURL=cli-patterns.d.ts.map

package/dist/cli-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-patterns.d.ts","sourceRoot":"","sources":["../src/cli-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhF;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnH"}

package/dist/cli-patterns.js

@@ -0,0 +1,49 @@
+/**
+ * Layer 5 — `bad patterns` subcommand surface.
+ *
+ * Provides pattern query and inspection via CLI. Mining runs as a periodic
+ * Cloudflare Worker cron in production; locally it reads from ~/.bad/patterns/.
+ *
+ *   bad patterns query [--category <cat>] [--page-type <type>] [--weak-dimension <dim>]
+ *   bad patterns show <patternId>
+ *   bad patterns mine [--dir <path>]
+ */
+import { queryPatterns, loadPatterns } from './design/audit/patterns/store.js';
+export async function runPatternsQuery(opts) {
+    const query = {
+        category: opts.category,
+        pageType: opts.pageType,
+        weakDimension: opts.weakDimension,
+        minApplications: opts.minApplications,
+        minSuccessRate: opts.minSuccessRate,
+    };
+    const patterns = await queryPatterns(query, opts.dir);
+    if (patterns.length === 0) {
+        console.log('No patterns found. The pattern library is empty until fleet data accumulates (Layer 5 cold-start).');
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(patterns, null, 2));
+        return;
+    }
+    for (const p of patterns) {
+        console.log(`\n[${p.patternId}] ${p.scaffold.description}`);
+        console.log(`  Category: ${p.category} | Type: ${p.classification.type}`);
+        console.log(`  Fleet: N=${p.fleetEvidence.applications} tenants=${p.fleetEvidence.sampleTenants} success=${(p.fleetEvidence.successRate * 100).toFixed(0)}%`);
+        console.log(`  Key decisions: ${p.scaffold.keyDecisions.join('; ')}`);
+    }
+}
+export async function runPatternsShow(patternId, opts = {}) {
+    const all = await loadPatterns(opts.dir);
+    const pattern = all.find(p => p.patternId === patternId);
+    if (!pattern) {
+        console.error(`Pattern ${patternId} not found.`);
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(pattern, null, 2));
+        return;
+    }
+    console.log(JSON.stringify(pattern, null, 2));
+}
+//# sourceMappingURL=cli-patterns.js.map

package/dist/cli-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-patterns.js","sourceRoot":"","sources":["../src/cli-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAa9E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA0B;IAC/D,MAAM,KAAK,GAAiB;QAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAA;IACD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IAErD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,oGAAoG,CAAC,CAAA;QACjH,OAAM;IACR,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC9C,OAAM;IACR,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;QAC3D,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,QAAQ,YAAY,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAA;QACzE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,aAAa,CAAC,YAAY,YAAY,CAAC,CAAC,aAAa,CAAC,aAAa,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC7J,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAyC,EAAE;IAClG,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,SAAS,aAAa,CAAC,CAAA;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC7C,OAAM;IACR,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC/C,CAAC"}

package/dist/cli-reports.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `bad reports generate` — produce a markdown artifact from a job's results.
+ *
+ *   bad reports generate --job <id> --template <leaderboard|longitudinal|batch-comparison>
+ *     [--out <file>] [--top <N>] [--by-type <type>] [--buckets 10,100,200]
+ *     [--narrate] [--context "...one-line context for the LLM..."]
+ *
+ * The report is the deterministic body. `--narrate` prepends an LLM exec
+ * summary; without it, the artifact is pure data.
+ */
+export declare function runReportsCli(args: string[]): Promise<void>;
+//# sourceMappingURL=cli-reports.d.ts.map

package/dist/cli-reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-reports.d.ts","sourceRoot":"","sources":["../src/cli-reports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoDH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CjE"}

package/dist/cli-reports.js

@@ -0,0 +1,97 @@
+/**
+ * `bad reports generate` — produce a markdown artifact from a job's results.
+ *
+ *   bad reports generate --job <id> --template <leaderboard|longitudinal|batch-comparison>
+ *     [--out <file>] [--top <N>] [--by-type <type>] [--buckets 10,100,200]
+ *     [--narrate] [--context "...one-line context for the LLM..."]
+ *
+ * The report is the deterministic body. `--narrate` prepends an LLM exec
+ * summary; without it, the artifact is pure data.
+ */
+import * as fs from 'node:fs';
+import chalk from 'chalk';
+import { cliError } from './cli-ui.js';
+import { loadJob } from './jobs/index.js';
+function die(msg) {
+    cliError(msg);
+    process.exit(1);
+}
+import { aggregateJob, renderLeaderboard, renderLongitudinal, renderBatchComparison, renderBrandEvolution, renderJobHeader, narrateReport, } from './reports/index.js';
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--job')
+            out.job = argv[++i];
+        else if (a === '--template')
+            out.template = argv[++i];
+        else if (a === '--out')
+            out.out = argv[++i];
+        else if (a === '--top')
+            out.top = Number(argv[++i]);
+        else if (a === '--by-type')
+            out.byType = argv[++i];
+        else if (a === '--buckets')
+            out.buckets = argv[++i].split(',').map(s => Number(s.trim())).filter(n => Number.isFinite(n));
+        else if (a === '--narrate')
+            out.narrate = true;
+        else if (a === '--context')
+            out.context = argv[++i];
+        else if (a === '--json')
+            out.json = true;
+    }
+    return out;
+}
+const TEMPLATES = new Set(['leaderboard', 'longitudinal', 'batch-comparison', 'brand-evolution']);
+export async function runReportsCli(args) {
+    const sub = args[0];
+    if (sub !== 'generate')
+        die(`Unknown subcommand: ${sub}. Use generate.`);
+    const opts = parseArgs(args.slice(1));
+    if (!opts.job)
+        die('--job is required');
+    if (!opts.template)
+        die('--template is required (leaderboard | longitudinal | batch-comparison)');
+    if (!TEMPLATES.has(opts.template))
+        die(`Unknown template: ${opts.template}. Valid: ${[...TEMPLATES].join(', ')}`);
+    const job = loadJob(opts.job);
+    if (!job)
+        die(`job not found: ${opts.job}`);
+    const rows = aggregateJob(job);
+    let body;
+    if (opts.template === 'leaderboard') {
+        body = renderLeaderboard(rows, { topN: opts.top, byType: opts.byType, buckets: opts.buckets });
+    }
+    else if (opts.template === 'longitudinal') {
+        body = renderLongitudinal(rows);
+    }
+    else if (opts.template === 'brand-evolution') {
+        body = renderBrandEvolution(job);
+    }
+    else {
+        body = renderBatchComparison(rows);
+    }
+    const header = renderJobHeader(job) + '\n\n---\n\n';
+    let final = header + body;
+    if (opts.narrate) {
+        try {
+            const { Brain } = await import('./brain/index.js');
+            const brain = new Brain();
+            final = await narrateReport(final, { brain, context: opts.context });
+        }
+        catch (err) {
+            console.warn(chalk.yellow(`narrate failed, falling back to deterministic body: ${err.message}`));
+        }
+    }
+    if (opts.out) {
+        fs.writeFileSync(opts.out, final, 'utf-8');
+        console.log(`  Report written → ${opts.out}`);
+    }
+    else if (opts.json) {
+        console.log(JSON.stringify({ jobId: job.jobId, template: opts.template, markdown: final }, null, 2));
+    }
+    else {
+        console.log(final);
+    }
+}
+//# sourceMappingURL=cli-reports.js.map

package/dist/cli-reports.js.map

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

package/dist/cli.js

@@ -77,6 +77,19 @@ async function main() {
     loadLocalEnvFiles(process.cwd());
     setCliVersion(readCliVersion());
     setInvocation(process.argv.slice(2)[0] || 'unknown', process.argv.slice(2));
+    // Subcommand groups with their own arg shape — dispatch before the strict
+    // parent parser (which only knows the run/design-audit/auth/showcase flags).
+    const subArgs = process.argv.slice(2);
+    if (subArgs[0] === 'jobs') {
+        const { runJobsCli } = await import('./cli-jobs.js');
+        await runJobsCli(subArgs.slice(1));
+        process.exit(0);
+    }
+    if (subArgs[0] === 'reports') {
+        const { runReportsCli } = await import('./cli-reports.js');
+        await runReportsCli(subArgs.slice(1));
+        process.exit(0);
+    }
     const { values, positionals } = parseArgs({
         allowPositionals: true,
         allowNegative: true,
@@ -123,6 +136,15 @@ async function main() {
             reproducibility: { type: 'boolean' },
             'rubrics-dir': { type: 'string' },
             'audit-passes': { type: 'string' },
+            // Layer 7 — domain ethics gate. --skip-ethics bypasses the rollup floor
+            // for testing scenarios; --ethics-rules-dir overrides the builtin rule set.
+            'skip-ethics': { type: 'boolean' },
+            'ethics-rules-dir': { type: 'string' },
+            // Layer 6 / 7 — audience predicate hints. Comma-separated.
+            audience: { type: 'string' },
+            'regulatory-context': { type: 'string' },
+            'audience-vulnerability': { type: 'string' },
+            modality: { type: 'string' },
             // bad view
             port: { type: 'string' },
             'no-open': { type: 'boolean' },
@@ -296,6 +318,12 @@ async function main() {
             reproducibility: values.reproducibility,
             rubricsDir: values['rubrics-dir'],
             auditPasses: values['audit-passes'],
+            skipEthics: values['skip-ethics'],
+            ethicsRulesDir: values['ethics-rules-dir'],
+            audience: values.audience,
+            regulatoryContext: values['regulatory-context'],
+            audienceVulnerability: values['audience-vulnerability'],
+            modality: values.modality,
         });
         process.exit(0);
     }
@@ -489,7 +517,7 @@ async function main() {
         }
     }
     if (command !== 'run' && command !== 'attach') {
-        cliError(`Unknown command: ${command}. Use "run", "attach", "preview", "runs", "view", "share", "chrome-debug", "design-audit", "showcase", or "auth".`);
+        cliError(`Unknown command: ${command}. Use "run", "attach", "preview", "runs", "view", "share", "chrome-debug", "design-audit", "showcase", "auth", "jobs", or "reports".`);
         process.exit(1);
     }
     // Validate inputs