harnery 0.9.0 → 0.11.0

package/dist/commands/browse.js

@@ -2,7 +2,7 @@ import { mkdirSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, isAbsolute, resolve } from "node:path";
 import { resolveBinName } from "../core/config.js";
-import { Browser, captureDevOverlay, } from "../lib/browser/index.js";
+import { Browser, captureDevOverlay, wslHeadedLaunchArgs, } from "../lib/browser/index.js";
 import { diffAgainstBaseline, saveBaseline, } from "../lib/browser/visual-diff.js";
 import { CookieJar } from "../lib/cookies/index.js";
 /**
@@ -62,6 +62,11 @@ export function registerBrowseCommand(program, emitParam, context) {
         .option("--viewport <preset|WxH>", "Viewport: mobile (390x844), tablet (820x1180), desktop (1280x800), hd (1920x1080), or explicit '1920x1080'", "desktop")
         .option("--login", "Headed mode for one-time auth flow (cookies persist in profile)")
         .option("--headed", "Headed mode for one-off (no auth-flow framing)")
+        .option("--browser-arg <flag>", "Extra Chromium launch flag, passed straight to the browser (repeatable). " +
+        "e.g. --browser-arg --disable-gpu. Also settable machine-wide via the " +
+        "HARNERY_BROWSER_ARGS env var (whitespace-separated). Under WSL, headed " +
+        "launches auto-add --disable-gpu to fix blank-window paint; opt out with " +
+        "HARNERY_BROWSER_NO_WSL_DEFAULTS=1.", (value, prev = []) => [...prev, value], [])
         .option("--no-cookies", "Skip cookie-jar attach and persist")
         .option("--store <path>", `Cookie store path (default ${DEFAULT_STORE})`)
         .option("--profile <dir>", `Persistent Chromium profile dir (default ${DEFAULT_PROFILE})`)
@@ -137,6 +142,7 @@ async function runBrowse(url, opts, context) {
         waitUntil: opts.waitUntil,
         recordHarPath: opts.networkHar ? resolve(opts.networkHar) : undefined,
         extraHeaders: context?.extraHeaders,
+        launchArgs: resolveLaunchArgs(opts, Boolean(headed)),
     });
     // Print mode: --snapshot / --html / --json all suppress file writes.
     const printMode = opts.snapshot || opts.html || opts.json;
@@ -598,6 +604,26 @@ function summarizeDiagnostics(diag) {
         failedRequests: diag.failedRequests,
     };
 }
+/**
+ * Merge Chromium launch flags from three sources, in order, de-duped:
+ *   1. WSLg headed default (`--disable-gpu`) — auto-applied for headed launches
+ *      under WSL so the window actually paints. Opt out with
+ *      HARNERY_BROWSER_NO_WSL_DEFAULTS=1.
+ *   2. HARNERY_BROWSER_ARGS env (whitespace-separated) — a machine-wide default.
+ *   3. --browser-arg flags on this invocation (repeatable).
+ */
+function resolveLaunchArgs(opts, headed) {
+    const args = [];
+    if (headed && !process.env.HARNERY_BROWSER_NO_WSL_DEFAULTS) {
+        args.push(...wslHeadedLaunchArgs());
+    }
+    const envArgs = process.env.HARNERY_BROWSER_ARGS?.trim();
+    if (envArgs)
+        args.push(...envArgs.split(/\s+/));
+    if (opts.browserArg && opts.browserArg.length > 0)
+        args.push(...opts.browserArg);
+    return [...new Set(args)];
+}
 function parseViewport(spec) {
     const preset = VIEWPORT_PRESETS[spec.toLowerCase()];
     if (preset)

package/dist/commands/claude-desktop.d.ts

@@ -0,0 +1,19 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+/**
+ * `claude-desktop`: make Claude desktop-app sessions survive account
+ * switches.
+ *
+ * The desktop app scopes its Claude Code session sidebar per signed-in
+ * account (plain JSON entry files under
+ * `<dataDir>/claude-code-sessions/<account-uuid>/<env-id>/`), while the
+ * transcripts live account-agnostically under `~/.claude/projects/`. A user
+ * who hops accounts (e.g. when one hits its usage limit) loses sidebar
+ * access to every session the other account created — even though the data
+ * is all still on disk. `mirror` copies the entry files across account
+ * directories so each account's sidebar lists the union; restarting the
+ * desktop app picks the copies up, and opening one resumes with full
+ * history.
+ */
+export declare function registerClaudeDesktopCommand(program: Command, emit: EmitContext): void;
+//# sourceMappingURL=claude-desktop.d.ts.map

package/dist/commands/claude-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/commands/claude-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAUnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAgKtF"}

package/dist/commands/claude-desktop.js

@@ -0,0 +1,168 @@
+import { applyMirror, findDesktopDataDirs, listAccounts, planMirror, readCliAccount, } from "../lib/claude-desktop.js";
+/**
+ * `claude-desktop`: make Claude desktop-app sessions survive account
+ * switches.
+ *
+ * The desktop app scopes its Claude Code session sidebar per signed-in
+ * account (plain JSON entry files under
+ * `<dataDir>/claude-code-sessions/<account-uuid>/<env-id>/`), while the
+ * transcripts live account-agnostically under `~/.claude/projects/`. A user
+ * who hops accounts (e.g. when one hits its usage limit) loses sidebar
+ * access to every session the other account created — even though the data
+ * is all still on disk. `mirror` copies the entry files across account
+ * directories so each account's sidebar lists the union; restarting the
+ * desktop app picks the copies up, and opening one resumes with full
+ * history.
+ */
+export function registerClaudeDesktopCommand(program, emit) {
+    const cmd = program
+        .command("claude-desktop")
+        .description("Claude desktop-app session index: list accounts/sessions, mirror sessions across accounts")
+        .action(() => {
+        const dirs = requireDataDirs(emit, undefined);
+        for (const dir of dirs) {
+            emit.data({
+                data_dir: dir,
+                accounts: listAccounts(dir).map((a) => accountSummary(a)),
+                cli_account: readCliAccount(),
+            });
+        }
+    });
+    cmd
+        .command("accounts")
+        .description("List account directories + session counts (labels the CLI's account when known)")
+        .option("--data-dir <path>", "Explicit desktop-app data directory")
+        .action((opts) => {
+        const dirs = requireDataDirs(emit, opts.dataDir);
+        const cli = readCliAccount();
+        emit.data(dirs.map((dir) => ({
+            data_dir: dir,
+            accounts: listAccounts(dir).map((a) => ({
+                ...accountSummary(a),
+                is_cli_account: cli !== null && a.accountUuid === cli.accountUuid,
+                cli_email: cli !== null && a.accountUuid === cli.accountUuid ? cli.email : null,
+            })),
+        })));
+    });
+    cmd
+        .command("sessions")
+        .description("List session entries across every account (newest activity first)")
+        .option("--data-dir <path>", "Explicit desktop-app data directory")
+        .option("--account <uuid-prefix>", "Only this account (uuid prefix match)")
+        .option("--archived", "Include archived entries")
+        .action((opts) => {
+        const dirs = requireDataDirs(emit, opts.dataDir);
+        const rows = [];
+        for (const dir of dirs) {
+            for (const account of listAccounts(dir)) {
+                if (opts.account && !account.accountUuid.startsWith(opts.account))
+                    continue;
+                for (const e of account.entries) {
+                    if (e.isArchived && !opts.archived)
+                        continue;
+                    rows.push({
+                        account_uuid: account.accountUuid,
+                        cli_session_id: e.cliSessionId,
+                        title: e.title,
+                        cwd: e.cwd,
+                        model: e.model,
+                        archived: e.isArchived,
+                        last_activity_at: e.lastActivityAt,
+                    });
+                }
+            }
+        }
+        rows.sort((a, b) => (b.last_activity_at ?? 0) - (a.last_activity_at ?? 0));
+        emit.data(rows);
+    });
+    cmd
+        .command("mirror")
+        .description("Copy session entries across accounts so each sidebar lists the union. " +
+        "Dry-run by default; --yes applies. Restart the desktop app afterward to pick up copies.")
+        .option("--data-dir <path>", "Explicit desktop-app data directory")
+        .option("--session <id-or-title>", "Only sessions matching this cliSessionId or title substring (repeatable)", collect, [])
+        .option("--all", "Mirror every (non-archived) session")
+        .option("--to <uuid-prefix>", "Only copy INTO accounts matching this prefix (repeatable)", collect, [])
+        .option("--from <uuid-prefix>", "Only copy FROM accounts matching this prefix (repeatable)", collect, [])
+        .option("--include-archived", "Also mirror archived entries")
+        .option("--yes", "Apply the plan (default is dry-run)")
+        .action((opts) => {
+        if (!opts.all && opts.session.length === 0) {
+            emit.error({
+                code: "no_selection",
+                message: "pass --session <id-or-title> (repeatable) or --all",
+            });
+            process.exit(2);
+        }
+        const dirs = requireDataDirs(emit, opts.dataDir);
+        for (const dir of dirs) {
+            const accounts = listAccounts(dir);
+            if (accounts.length < 2) {
+                emit.error({
+                    code: "single_account",
+                    message: `only ${accounts.length} account dir(s) under ${dir} — nothing to mirror across`,
+                });
+                process.exit(2);
+            }
+            const plan = planMirror(accounts, {
+                to: opts.to,
+                from: opts.from,
+                sessions: opts.all ? undefined : opts.session,
+                includeArchived: opts.includeArchived,
+            });
+            const planned = plan.actions.map((a) => ({
+                title: a.entry.title,
+                cli_session_id: a.entry.cliSessionId,
+                to_account: a.targetAccountUuid,
+                to_file: a.to,
+            }));
+            if (!opts.yes) {
+                emit.data({
+                    data_dir: dir,
+                    dry_run: true,
+                    planned,
+                    skipped_existing: plan.skippedExisting,
+                    skipped_archived: plan.skippedArchived,
+                    hint: plan.actions.length > 0 ? "re-run with --yes to apply" : "nothing to copy",
+                });
+                continue;
+            }
+            const { copied } = applyMirror(plan);
+            emit.data({
+                data_dir: dir,
+                dry_run: false,
+                copied,
+                planned,
+                skipped_existing: plan.skippedExisting,
+                skipped_archived: plan.skippedArchived,
+                hint: copied > 0
+                    ? "fully quit the Claude desktop app (tray icon, not the X) and relaunch to see the sessions"
+                    : "nothing to copy",
+            });
+        }
+    });
+}
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+function accountSummary(a) {
+    return {
+        account_uuid: a.accountUuid,
+        sessions: a.entries.length,
+        archived: a.entries.filter((e) => e.isArchived).length,
+        latest_title: a.entries[0]?.title ?? null,
+        latest_activity_at: a.entries[0]?.lastActivityAt ?? null,
+    };
+}
+function requireDataDirs(emit, explicit) {
+    const dirs = findDesktopDataDirs(explicit);
+    if (dirs.length === 0) {
+        emit.error({
+            code: "not_found",
+            message: "no Claude desktop-app data directory with a claude-code-sessions/ index found " +
+                "(is the desktop app installed? pass --data-dir or set HARNERY_CLAUDE_DESKTOP_DIR)",
+        });
+        process.exit(2);
+    }
+    return dirs;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAS1E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAiDN"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAiB1E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAqKN"}

package/dist/commands/context.js

@@ -1,3 +1,5 @@
+import { monorepoRoot, readHeartbeat, resolveOwner } from "../core/agents/index.js";
+import { checkpointContext, readContextState, readLatestCapsule, } from "../core/context/index.js";
 import { buildContext, DEFAULT_SECTIONS, OPT_IN_SECTIONS, } from "../lib/context/index.js";
 /**
  * `harn context`: one-shot orientation snapshot.
@@ -7,7 +9,7 @@ import { buildContext, DEFAULT_SECTIONS, OPT_IN_SECTIONS, } from "../lib/context
  * dispatching subagents. Fail-open per section.
  */
 export function registerContextCommand(program, emit, context) {
-    program
+    const command = program
         .command("context")
         .description(`One-shot orientation snapshot: self, repo, submodules, peers, recent commits. Default sections: ${DEFAULT_SECTIONS.join(" / ")}. Opt-in: ${OPT_IN_SECTIONS.join(" / ")}.`)
         .option("--section <name>", `Limit to specific sections (comma-list or repeated; valid: ${[...DEFAULT_SECTIONS, ...OPT_IN_SECTIONS].join(", ")})`, collectSections, [])
@@ -37,6 +39,152 @@ export function registerContextCommand(program, emit, context) {
             process.exit(1);
         }
     });
+    command
+        .command("status")
+        .description("Show context-continuity phase, generation, and latest telemetry")
+        .option("--session <id>", "Session id (defaults to the current agent heartbeat)")
+        .option("--instance <id>", "Agent instance id (defaults to the current owner)")
+        .option("--json", "Structured JSON output")
+        .action((opts) => {
+        try {
+            const json = opts.json || Boolean(command.opts().json);
+            const identity = resolveContinuityIdentity(context, opts);
+            const state = readContextState(identity.coordRoot, identity.sessionId);
+            if (json) {
+                emit.config({ format: "json" });
+                emit.data({ state, identity });
+                return;
+            }
+            if (!state) {
+                emit.text(`No context continuity state for session ${identity.sessionId}.\n`);
+                return;
+            }
+            const sample = state.latest_context;
+            const usage = sample
+                ? `${sample.used_tokens ?? "?"}/${sample.window_tokens ?? "?"} tokens${sample.used_percent === undefined ? "" : ` (${sample.used_percent}%)`}`
+                : "not reported by harness";
+            emit.text(`${[
+                `Session:    ${state.session_id}`,
+                `Phase:      ${state.phase}`,
+                `Generation: ${state.generation}`,
+                `Telemetry:  ${usage}`,
+                `Capsule:    ${state.latest_capsule ?? "none"}`,
+                state.degraded_reason ? `Degraded:   ${state.degraded_reason}` : "",
+            ]
+                .filter(Boolean)
+                .join("\n")}\n`);
+        }
+        catch (err) {
+            emitCommandError(emit, "context_status_failed", err);
+        }
+    });
+    command
+        .command("checkpoint")
+        .description("Create a durable context-continuity capsule for the current work")
+        .option("--session <id>", "Session id (defaults to the current agent heartbeat)")
+        .option("--instance <id>", "Agent instance id (defaults to the current owner)")
+        .option("--harness <id>", "claude-code, codex, or cursor (inferred from heartbeat)")
+        .option("--reason <reason>", "manual, pressure, pre_compact, or session_end", "manual")
+        .option("--note <text>", "Short continuation note for the recovered agent")
+        .option("--json", "Structured JSON output")
+        .action((opts) => {
+        try {
+            const json = opts.json || Boolean(command.opts().json);
+            const reason = parseCheckpointReason(opts.reason);
+            const identity = resolveContinuityIdentity(context, opts);
+            if (!identity.harness) {
+                throw new Error("could not infer the harness; pass --harness claude-code|codex|cursor");
+            }
+            const result = checkpointContext(identity.coordRoot, {
+                sessionId: identity.sessionId,
+                instanceId: identity.instanceId,
+                harness: identity.harness,
+                cwd: context?.repoRoot ?? process.cwd(),
+                reason,
+                continuationNote: opts.note,
+            });
+            const output = {
+                capsule_id: result.capsule.capsule_id,
+                generation: result.capsule.generation,
+                path: result.state.latest_capsule,
+                phase: result.state.phase,
+                reused: result.reused,
+            };
+            if (json) {
+                emit.config({ format: "json" });
+                emit.data(output);
+                return;
+            }
+            emit.text(`Checkpointed context generation ${output.generation}: ${output.path ?? result.path}\n`);
+        }
+        catch (err) {
+            emitCommandError(emit, "context_checkpoint_failed", err);
+        }
+    });
+    command
+        .command("show")
+        .description("Show the latest durable context-continuity capsule")
+        .option("--session <id>", "Session id (defaults to the current agent heartbeat)")
+        .option("--instance <id>", "Agent instance id (defaults to the current owner)")
+        .option("--json", "Structured JSON output")
+        .action((opts) => {
+        try {
+            const json = opts.json || Boolean(command.opts().json);
+            const identity = resolveContinuityIdentity(context, opts);
+            const capsule = readLatestCapsule(identity.coordRoot, identity.sessionId);
+            if (!capsule) {
+                throw new Error(`no context capsule exists for session ${identity.sessionId}`);
+            }
+            if (json)
+                emit.config({ format: "json" });
+            emit.data(capsule);
+        }
+        catch (err) {
+            emitCommandError(emit, "context_show_failed", err);
+        }
+    });
+}
+function resolveContinuityIdentity(context, opts) {
+    const coordRoot = context?.resolveCoordRoot?.() ?? context?.repoRoot ?? monorepoRoot();
+    if (!coordRoot)
+        throw new Error("could not resolve a project containing .harnery/");
+    const instanceId = opts.instance ?? resolveOwner();
+    if (!instanceId) {
+        throw new Error("could not resolve the current agent; pass --instance and --session");
+    }
+    const heartbeat = readHeartbeat(instanceId);
+    const sessionId = opts.session ?? heartbeat?.session_id ?? instanceId;
+    const harness = opts.harness
+        ? parseHarness(opts.harness)
+        : harnessFromPlatform(heartbeat?.platform);
+    return { coordRoot, instanceId, sessionId, harness };
+}
+function harnessFromPlatform(platform) {
+    if (platform === "claude_code" || platform === "claude-code")
+        return "claude-code";
+    if (platform === "cursor")
+        return "cursor";
+    if (platform === "codex")
+        return "codex";
+    return null;
+}
+function parseHarness(value) {
+    if (value === "claude-code" || value === "codex" || value === "cursor")
+        return value;
+    throw new Error(`invalid harness "${value}"; expected claude-code, codex, or cursor`);
+}
+function parseCheckpointReason(value) {
+    if (value === "manual" ||
+        value === "pressure" ||
+        value === "pre_compact" ||
+        value === "session_end") {
+        return value;
+    }
+    throw new Error(`invalid reason "${value}"; expected manual, pressure, pre_compact, or session_end`);
+}
+function emitCommandError(emit, code, err) {
+    emit.error({ code, message: err instanceof Error ? err.message : String(err) });
+    emit.setExitCode(1);
 }
 function collectSections(value, prev) {
     const all = [...DEFAULT_SECTIONS, ...OPT_IN_SECTIONS];

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAYnD,KAAK,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAmD/E;AAED,wBAAgB,SAAS,IAAI,KAAK,EAAE,CAgBnC"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAanD,KAAK,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAmD/E;AAED,wBAAgB,SAAS,IAAI,KAAK,EAAE,CAcnC"}

package/dist/commands/doctor.js

@@ -15,6 +15,7 @@ import { existsSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { resolveBinName, ripgrepAutoInstall } from "../core/config.js";
+import { BUILTIN_HARNESS_IDS } from "../core/harnesses/index.js";
 import { loadHarnessWiring } from "../core/hooks/harness/wiring.js";
 import { probeBilling } from "../core/workflow/billing.js";
 import { HARNESS_BINARIES, HARNESS_INSTALL_HINTS, HARNESS_LOGIN_HINTS, } from "../core/workflow/harnesses.js";
@@ -71,9 +72,7 @@ export function runChecks() {
         checkRipgrep(),
         checkHarneryDir(),
         checkHarnessHooks(),
-        checkWorkflowHarness("claude-code"),
-        checkWorkflowHarness("codex"),
-        checkWorkflowHarness("cursor"),
+        ...BUILTIN_HARNESS_IDS.map(checkWorkflowHarness),
         checkRestic(),
         checkRclone(),
         checkPlaywright(),

package/dist/commands/eml.d.ts

@@ -1,4 +1,36 @@
 import type { Command } from "commander";
+import { type ParsedMail } from "mailparser";
 import type { EmitContext } from "../commander.js";
+/**
+ * `eml` - Parse Gmail .eml thread exports into clean chronological markdown.
+ *
+ * Gmail exports a thread as a single .eml where older messages are nested
+ * inside `<div class="gmail_quote">` blocks with attribution lines in
+ * `<div class="gmail_attr">`. This command reconstructs the full thread
+ * in chronological order. Falls back to plain-text quote parsing (`> `
+ * prefixes + "On ... wrote:") when HTML is unavailable. Uses the injected
+ * EmitContext so composed and standalone consumers share one code path.
+ */
+interface ThreadMessage {
+    from: string;
+    date: Date | null;
+    body: string;
+}
 export declare function registerEmlCommand(program: Command, emit: EmitContext): void;
+export interface EmlOpts {
+    output?: string;
+    format: string;
+    headers?: boolean;
+    attachments?: boolean;
+}
+/**
+ * Extract individual messages from the parsed email.
+ * Strategy: use HTML body (Gmail quote structure) first, fall back to plain text.
+ */
+export declare function extractThread(parsed: ParsedMail): ThreadMessage[];
+/**
+ * Render the thread as markdown.
+ */
+export declare function renderMarkdown(parsed: ParsedMail, messages: ThreadMessage[], opts: EmlOpts): string;
+export {};
 //# sourceMappingURL=eml.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"eml.d.ts","sourceRoot":"","sources":["../../src/commands/eml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAmBnD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAkB5E"}
+{"version":3,"file":"eml.d.ts","sourceRoot":"","sources":["../../src/commands/eml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;GASG;AAEH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAkB5E;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAuCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,EAAE,CAYjE;AA4VD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,EAAE,OAAO,GACZ,MAAM,CAyDR"}

package/dist/commands/eml.js

@@ -7,7 +7,7 @@ export function registerEmlCommand(program, emit) {
         .argument("<file>", "Path to the .eml file")
         .option("-o, --output <path>", "Write output to a file instead of stdout")
         .option("--format <type>", "Output format: markdown, json", "markdown")
-        .option("--headers", "Include full email headers per message")
+        .option("--headers", "Include the source message's full email headers")
         .option("--attachments", "List attachment filenames and sizes")
         .action(async (file, opts) => {
         try {
@@ -58,7 +58,7 @@ async function handleEml(file, opts, emit) {
  * Extract individual messages from the parsed email.
  * Strategy: use HTML body (Gmail quote structure) first, fall back to plain text.
  */
-function extractThread(parsed) {
+export function extractThread(parsed) {
     if (parsed.html && typeof parsed.html === "string") {
         const messages = extractFromHtml(parsed.html, parsed);
         if (messages.length > 0)
@@ -369,7 +369,7 @@ function formatAddress(addr) {
 /**
  * Render the thread as markdown.
  */
-function renderMarkdown(parsed, messages, opts) {
+export function renderMarkdown(parsed, messages, opts) {
     const subject = parsed.subject ?? "Untitled Thread";
     const participants = new Map();
     for (const m of messages) {
@@ -384,6 +384,19 @@ function renderMarkdown(parsed, messages, opts) {
     lines.push(`**Participants:** ${[...participants.keys()].join(", ")}`);
     lines.push(`**Date range:** ${minDate} to ${maxDate}`);
     lines.push(`**Messages:** ${messages.length}`);
+    if (opts.headers && parsed.headerLines?.length) {
+        // A Gmail thread export is a SINGLE .eml (older messages are quoted HTML,
+        // not separate MIME parts), so there is one real header set — the source
+        // message's. Render it verbatim.
+        lines.push("");
+        lines.push("**Source headers:**");
+        lines.push("");
+        lines.push("```");
+        for (const h of parsed.headerLines) {
+            lines.push(h.line);
+        }
+        lines.push("```");
+    }
     if (opts.attachments && parsed.attachments?.length) {
         lines.push("");
         lines.push("**Attachments:**");

package/dist/commands/harness.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+import { type BenchResult, type HarnessBenchReport } from "../core/harnesses/index.js";
+import type { HarnessProfile } from "../core/harnesses/types.js";
+export declare function registerHarnessCommand(program: Command, emit: EmitContext): void;
+export declare function renderProfileTable(profiles: readonly HarnessProfile[]): string;
+export declare function renderProfile(profile: HarnessProfile): string;
+export declare function renderBenchReport(report: HarnessBenchReport): string;
+/** Kept exported so command tests can assert row semantics without model calls. */
+export type { BenchResult };
+//# sourceMappingURL=harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/commands/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EAExB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAYjE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA6DhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAU9E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAkB7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAcpE;AAgBD,mFAAmF;AACnF,YAAY,EAAE,WAAW,EAAE,CAAC"}