@heyditto/cli 3.8.1 → 3.10.0

package/dist/profiles.js

@@ -0,0 +1,325 @@
+/**
+ * `heyditto profile`: named endpoint profiles, and the one place the CLI asks
+ * "which endpoint does the user mean when they did not say?".
+ *
+ * Selection order for a command that reads the default endpoint:
+ *   --profile <name>  (this command only)
+ *   DITTO_PROFILE      (this shell only)
+ *   the active profile (`heyditto profile use <name>`)
+ * With no saved profiles, the implicit `default` profile is `defaultEndpoint`,
+ * so an existing install behaves exactly as before.
+ */
+import { Option } from "commander";
+import { findEndpoint, listEndpoints } from "./api.js";
+import { LEGACY_PROFILE, materialize, profileView, profilesPatch, setProfileEndpointPatch, unknownProfileMessage, validateProfileName, } from "./profile-state.js";
+import { readStoredAuth, updateStoredAuth } from "./store.js";
+let flagOverride;
+/** Set by `--profile` for the duration of one command. */
+export function setProfileOverride(name) {
+    flagOverride = name?.trim() || undefined;
+}
+/** The profile the user named for this command (flag, then env), if any. */
+export function requestedProfile() {
+    if (flagOverride)
+        return { name: flagOverride, source: "flag" };
+    const env = process.env.DITTO_PROFILE?.trim();
+    return env ? { name: env, source: "env" } : undefined;
+}
+function select(stored, view = profileView(stored)) {
+    const requested = requestedProfile();
+    if (requested) {
+        const profile = view.profiles[requested.name];
+        if (!profile) {
+            const via = requested.source === "env" ? " (from DITTO_PROFILE)" : "";
+            throw new Error(unknownProfileMessage(requested.name, view) + via);
+        }
+        return { name: requested.name, profile, source: requested.source, implicit: view.implicit };
+    }
+    return { name: view.active, profile: view.profiles[view.active], source: "active", implicit: view.implicit };
+}
+export async function selectedProfile() {
+    return select(await readStoredAuth());
+}
+/** The endpoint used when --endpoint is omitted: the selected profile's. */
+export async function readDefaultEndpoint() {
+    return (await selectedProfile()).profile.endpoint?.trim() || undefined;
+}
+/** Saves (or clears) the endpoint of the selected profile; other profiles are untouched. */
+export async function writeDefaultEndpoint(endpoint) {
+    const stored = await readStoredAuth();
+    const selected = select(stored);
+    await updateStoredAuth(setProfileEndpointPatch(stored, selected.name, endpoint));
+    return selected.name;
+}
+/**
+ * The endpoint of a profile the user explicitly named (--profile or
+ * DITTO_PROFILE), for a launch that should treat it like --endpoint. Undefined
+ * when no profile was named; an error when the named one has no endpoint.
+ */
+export async function explicitProfileEndpoint() {
+    const requested = requestedProfile();
+    if (!requested)
+        return undefined;
+    const selected = await selectedProfile();
+    const endpoint = selected.profile.endpoint?.trim();
+    if (!endpoint) {
+        throw new Error(`profile "${selected.name}" has no endpoint. Set one with \`heyditto profile set ${selected.name} --endpoint <slug>\`.`);
+    }
+    return { name: selected.name, endpoint, source: requested.source };
+}
+/** After an endpoint's slug changes, follow it in every profile that named it. */
+export async function renameEndpointInProfiles(oldSlug, newSlug) {
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    if (view.implicit) {
+        if (stored?.defaultEndpoint === oldSlug)
+            await updateStoredAuth({ defaultEndpoint: newSlug });
+        return;
+    }
+    let changed = false;
+    const profiles = {};
+    for (const [name, profile] of Object.entries(view.profiles)) {
+        if (profile.endpoint === oldSlug) {
+            profiles[name] = { ...profile, endpoint: newSlug };
+            changed = true;
+        }
+        else
+            profiles[name] = profile;
+    }
+    if (changed)
+        await updateStoredAuth(profilesPatch(profiles, view.active));
+}
+/** After an endpoint is archived, drop it from every profile that named it (by slug or id). */
+export async function forgetEndpointInProfiles(refs) {
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    const matches = (value) => value !== undefined && refs.includes(value);
+    if (view.implicit) {
+        if (matches(stored?.defaultEndpoint))
+            await updateStoredAuth({ defaultEndpoint: undefined });
+        return;
+    }
+    let changed = false;
+    const profiles = {};
+    for (const [name, profile] of Object.entries(view.profiles)) {
+        if (matches(profile.endpoint)) {
+            const { endpoint: _dropped, ...rest } = profile;
+            profiles[name] = rest;
+            changed = true;
+        }
+        else
+            profiles[name] = profile;
+    }
+    if (changed)
+        await updateStoredAuth(profilesPatch(profiles, view.active));
+}
+const tagged = new WeakSet();
+/** `--profile <name>` for a command that reads the default endpoint. */
+export function addProfileOption(cmd) {
+    tagged.add(cmd);
+    return cmd.option("--profile <name>", "use this endpoint profile for this command only (default: DITTO_PROFILE, then the active profile)");
+}
+/**
+ * Applies `--profile` before any action runs. Only commands tagged by
+ * addProfileOption are read, so `repo apply --profile` and `review local
+ * --profile`, which mean something else, are left alone.
+ */
+export function installProfileHook(program) {
+    program.hook("preAction", (_root, action) => {
+        setProfileOverride(tagged.has(action) ? action.getOptionValue("profile") : undefined);
+    });
+}
+const json = (options) => options.output === "json";
+const print = (value) => { process.stdout.write(`${JSON.stringify(value, null, 2)}\n`); };
+function inferenceOf(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw !== "router" && raw !== "cliproxy")
+        throw new Error("--inference must be router or cliproxy");
+    return raw;
+}
+/** Resolves an endpoint ref through the catalog and returns its canonical slug. */
+async function canonicalEndpoint(ref) {
+    const catalog = await listEndpoints();
+    const match = findEndpoint(catalog.endpoints, ref.trim());
+    if (!match)
+        throw new Error(`no endpoint named "${ref.trim()}". Available: ${catalog.endpoints.map((e) => e.slug).join(", ") || "(none)"}`);
+    return match.slug;
+}
+function listJSON(view) {
+    return {
+        activeProfile: view.active,
+        implicit: view.implicit,
+        profiles: Object.keys(view.profiles).sort().map((name) => ({
+            name,
+            endpoint: view.profiles[name].endpoint ?? null,
+            inference: view.profiles[name].inference ?? "cliproxy",
+            active: name === view.active,
+        })),
+    };
+}
+export async function cmdProfileList(options) {
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    const requested = requestedProfile();
+    if (json(options))
+        return print({ ...listJSON(view), ...(requested ? { selected: requested.name, selectedBy: requested.source } : {}) });
+    const rows = listJSON(view).profiles;
+    const width = Math.max(...rows.map((r) => r.name.length), 4);
+    process.stdout.write(`  ${"NAME".padEnd(width)}  ENDPOINT  (INFERENCE)\n`);
+    for (const row of rows) {
+        process.stdout.write(`${row.active ? "*" : " "} ${row.name.padEnd(width)}  ${row.endpoint ?? "(none)"}  (${row.inference})\n`);
+    }
+    if (view.implicit)
+        process.stdout.write("\nNo profiles saved yet; `default` is your saved default endpoint. Create one with `heyditto profile create <name> --endpoint <slug>`.\n");
+    if (requested)
+        process.stdout.write(`\n${requested.source === "env" ? "DITTO_PROFILE" : "--profile"} selects "${requested.name}" for this command.\n`);
+}
+export async function cmdProfileCreate(rawName, options) {
+    const name = validateProfileName(rawName);
+    const inference = inferenceOf(options.inference);
+    const assertCreatable = (view) => {
+        if (!view.implicit && Object.hasOwn(view.profiles, name))
+            throw new Error(`profile "${name}" already exists; change it with \`heyditto profile set ${name}\``);
+        if (view.implicit && name === LEGACY_PROFILE && view.profiles[LEGACY_PROFILE].endpoint) {
+            throw new Error(`"${LEGACY_PROFILE}" already names your saved default endpoint; change it with \`heyditto profile set ${LEGACY_PROFILE} --endpoint <slug>\``);
+        }
+    };
+    // Fail fast on a name clash before the network lookup...
+    assertCreatable(profileView(await readStoredAuth()));
+    const endpoint = await canonicalEndpoint(options.endpoint);
+    // ...but build the write from state read after it: another heyditto may
+    // have changed profiles while the lookup was in flight, and a patch built
+    // from the earlier snapshot would silently drop that change.
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    assertCreatable(view);
+    const { profiles, active } = materialize(stored);
+    const created = { endpoint, ...(inference ? { inference } : {}), createdAt: new Date().toISOString() };
+    const nextActive = options.use || active === undefined ? name : active;
+    await updateStoredAuth(profilesPatch({ ...profiles, [name]: created }, nextActive));
+    if (json(options))
+        return print({ name, endpoint, inference: inference ?? "cliproxy", active: nextActive === name, activeProfile: nextActive });
+    process.stdout.write(`Created profile ${name} → ${endpoint}${nextActive === name ? " (active)" : ""}.\n`);
+    if (view.implicit && profiles[LEGACY_PROFILE]) {
+        process.stdout.write(`Your previous default endpoint is saved as profile "${LEGACY_PROFILE}"${nextActive === LEGACY_PROFILE ? " and stays active" : ""}.\n`);
+    }
+    if (nextActive !== name)
+        process.stdout.write(`Switch with \`heyditto profile use ${name}\`, or pass --profile ${name} to one command.\n`);
+}
+export async function cmdProfileSet(rawName, options) {
+    const name = rawName.trim();
+    const inference = inferenceOf(options.inference);
+    if (options.endpoint === undefined && inference === undefined)
+        throw new Error("nothing to change: pass --endpoint and/or --inference");
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    if (!Object.hasOwn(view.profiles, name))
+        throw new Error(unknownProfileMessage(name, view));
+    const endpoint = options.endpoint !== undefined ? await canonicalEndpoint(options.endpoint) : undefined;
+    let profiles;
+    let active;
+    if (view.implicit && inference === undefined) {
+        await updateStoredAuth({ defaultEndpoint: endpoint });
+    }
+    else {
+        ({ profiles, active } = materialize(stored));
+        // An implicit default with no endpoint is not materialized; recreate it.
+        const current = profiles[name] ?? {};
+        const next = { ...current, ...(endpoint ? { endpoint } : {}), ...(inference ? { inference } : {}) };
+        await updateStoredAuth(profilesPatch({ ...profiles, [name]: next }, active ?? name));
+    }
+    const after = profileView(await readStoredAuth()).profiles[name];
+    if (json(options))
+        return print({ name, endpoint: after.endpoint ?? null, inference: after.inference ?? "cliproxy" });
+    process.stdout.write(`Profile ${name} → ${after.endpoint ?? "(none)"} (${after.inference ?? "cliproxy"}).\n`);
+}
+export async function cmdProfileUse(rawName, options) {
+    const name = rawName.trim();
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    if (!Object.hasOwn(view.profiles, name))
+        throw new Error(unknownProfileMessage(name, view));
+    if (!view.implicit)
+        await updateStoredAuth(profilesPatch(view.profiles, name));
+    const endpoint = view.profiles[name].endpoint ?? null;
+    if (json(options))
+        return print({ activeProfile: name, endpoint });
+    process.stdout.write(`Active profile: ${name} → ${endpoint ?? "(no endpoint yet)"}. New heyditto sessions use it; existing T3 providers keep their own endpoints.\n`);
+    if (process.env.DITTO_PROFILE?.trim() && process.env.DITTO_PROFILE.trim() !== name) {
+        process.stderr.write(`Note: DITTO_PROFILE=${process.env.DITTO_PROFILE.trim()} still overrides it in this shell.\n`);
+    }
+}
+export async function cmdProfileRename(rawOld, rawNew, options) {
+    const from = rawOld.trim();
+    const to = validateProfileName(rawNew);
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    if (!Object.hasOwn(view.profiles, from))
+        throw new Error(unknownProfileMessage(from, view));
+    if (from === to)
+        throw new Error("the new name is the same as the old one");
+    if (Object.hasOwn(view.profiles, to))
+        throw new Error(`profile "${to}" already exists`);
+    const { profiles, active } = materialize(stored);
+    const renamed = {};
+    for (const [name, profile] of Object.entries(profiles))
+        renamed[name === from ? to : name] = profile;
+    if (!Object.hasOwn(renamed, to))
+        renamed[to] = { ...view.profiles[from] };
+    await updateStoredAuth(profilesPatch(renamed, active === from || active === undefined ? to : active));
+    if (json(options))
+        return print({ renamed: from, to });
+    process.stdout.write(`Renamed profile ${from} → ${to}. T3 providers created from it keep their instance id and endpoint.\n`);
+}
+export async function cmdProfileDelete(rawName, options) {
+    const name = rawName.trim();
+    const stored = await readStoredAuth();
+    const view = profileView(stored);
+    if (!Object.hasOwn(view.profiles, name))
+        throw new Error(unknownProfileMessage(name, view));
+    if (name === view.active)
+        throw new Error(`profile "${name}" is active; switch to another with \`heyditto profile use <name>\` before deleting it`);
+    const { profiles, active } = materialize(stored);
+    const { [name]: _removed, ...rest } = profiles;
+    await updateStoredAuth(profilesPatch(rest, active));
+    if (json(options))
+        return print({ deleted: name });
+    process.stdout.write(`Deleted profile ${name}. Its endpoint and any T3 provider made from it are unchanged.\n`);
+}
+export function registerProfileCommands(program, addExamples, outputOption) {
+    const profile = program
+        .command("profile")
+        .description("named endpoint profiles: switch which endpoint (and its MCP tools) new sessions use")
+        .summary("manage named endpoint profiles")
+        .showHelpAfterError()
+        .addHelpText("after", `
+A profile names an endpoint. The active one is used when --endpoint is
+omitted; --profile <name> or DITTO_PROFILE=<name> picks another for one
+command or one shell. Profiles are local to this machine and hold no keys.
+(\`heyditto profiles\` is an older alias of \`heyditto endpoints\`.)`);
+    addExamples(profile.command("list", { isDefault: true }).description("list profiles (* = active)").addOption(outputOption()).action(cmdProfileList), `  heyditto profile
+  heyditto profile list --output json`);
+    addExamples(profile
+        .command("create")
+        .description("save a profile for an endpoint (your current default is kept as profile \"default\")")
+        .argument("<name>", "profile name (lowercase letters, digits, - or _)")
+        .requiredOption("--endpoint <slug>", "endpoint slug or id")
+        .addOption(new Option("--inference <mode>", "inference route for `heyditto t3 setup --profile` (default cliproxy)").choices(["cliproxy", "router"]))
+        .option("--use", "make it the active profile")
+        .addOption(outputOption())
+        .action(cmdProfileCreate), `  heyditto profile create subnet --endpoint my-subnet-endpoint
+  heyditto profile create work --endpoint work-router --inference router --use`);
+    profile
+        .command("set")
+        .description("change a profile's endpoint or inference route")
+        .argument("<name>")
+        .option("--endpoint <slug>", "endpoint slug or id")
+        .addOption(new Option("--inference <mode>", "inference route for T3 setup").choices(["cliproxy", "router"]))
+        .addOption(outputOption())
+        .action(cmdProfileSet);
+    profile.command("use").alias("switch").description("make a profile active for new sessions").argument("<name>").addOption(outputOption()).action(cmdProfileUse);
+    profile.command("rename").description("rename a profile").argument("<old>").argument("<new>").addOption(outputOption()).action(cmdProfileRename);
+    profile.command("delete").alias("rm").description("delete a profile (not the active one)").argument("<name>").addOption(outputOption()).action(cmdProfileDelete);
+}
+//# sourceMappingURL=profiles.js.map

package/dist/profiles.js.map

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

package/dist/remote/plugin-server.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
 import { apiFetch, findEndpoint, listEndpoints } from "../api.js";
 import { resolveApiKey } from "../config.js";
 import { findProfileEndpoint, repoDefaultProfile } from "../dittoconfig/profiles.js";
-import { readStoredAuth } from "../store.js";
+import { readDefaultEndpoint } from "../profiles.js";
 import { runChannelServer } from "./channel-server.js";
 import { remoteSessionURL, UNLINKABLE_SESSION_NOTICE } from "./session-link.js";
 /** Only these locally constructed setup errors may be shown verbatim. API,
@@ -30,7 +30,7 @@ export async function preparePluginSession(cwd = process.env.DITTO_REMOTE_CWD ??
     const catalog = await listEndpoints();
     const explicit = process.env.DITTO_REMOTE_ENDPOINT?.trim();
     const profile = explicit ? undefined : await repoDefaultProfile(cwd);
-    const selected = explicit ?? (await readStoredAuth())?.defaultEndpoint;
+    const selected = explicit ?? (await readDefaultEndpoint());
     const endpoint = profile
         ? await findProfileEndpoint(profile, catalog.endpoints)
         : selected ? findEndpoint(catalog.endpoints, selected) : catalog.endpoints.length === 1 ? catalog.endpoints[0] : undefined;

package/dist/remote/plugin-server.js.map

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

package/dist/review-commands.d.ts

@@ -93,7 +93,11 @@ interface LocalOptions extends ScopeOptions {
     timeout?: string;
     requestId?: string;
     gate?: boolean;
+    trace?: string;
+    issue?: string;
 }
+/** Exit code for a completed local review whose verdict requests changes. */
+export declare const REQUEST_CHANGES_EXIT = 2;
 export declare function cmdReviewLocal(options: LocalOptions): Promise<void>;
 export declare function cmdReviewLocalStatus(id: string, options: ScopeOptions & {
     gate?: boolean;

package/dist/review-commands.js

@@ -7,7 +7,8 @@ import { cmdReviewAccess, diagnoseLinkRefusal, guideAccessForAdd } from "./githu
 import { registerReviewFindingCommands } from "./review-findings.js";
 import { readStoredAuth } from "./store.js";
 import { captureReviewSnapshot, reviewGit } from "./review-snapshot.js";
-import { findingsList, formatRecommendation, isVisibleFinding, gateExitCode, malformedLocalRun, recommendLocalReview } from "./review-recommendation.js";
+import { findingsList, formatRecommendation, isVisibleFinding, gateExitCode, malformedLocalRun, recommendLocalReview, scopeOutcome } from "./review-recommendation.js";
+import { freezeAgentTrace, readAgentTrace } from "./review-trace.js";
 /** The server's bounds (backend reviewLimits). */
 const MIN_MAX_MINUTES = 5;
 const MAX_MAX_MINUTES = 45;
@@ -28,6 +29,8 @@ export async function listReviewRepositories(company) {
     const out = await apiFetch(`/api/v5/review${scopeQuery(company)}`);
     return out.repositories ?? [];
 }
+/** Exit code for a completed local review whose verdict requests changes. */
+export const REQUEST_CHANGES_EXIT = 2;
 function repositoryFromRemote(remote) {
     const match = /^(?:git@github\.com:|https?:\/\/github\.com\/|ssh:\/\/git@github\.com\/)([^/\s]+\/[^/\s]+?)(?:\.git)?\/?$/.exec(remote.trim());
     if (!match)
@@ -54,6 +57,9 @@ function printLocalRun(run, options) {
     }
     else
         process.stdout.write("No review result is available for this run.\n");
+    printScope(result?.scope);
+    if (result?.verdict)
+        printVerdict(result.verdict);
     if (!result?.complete || run.status !== "completed")
         process.stdout.write("Review incomplete; check coverage and errors before relying on this result.\n");
     if (result?.local?.contextComplete === false)
@@ -70,6 +76,46 @@ function printLocalRun(run, options) {
     process.stdout.write(formatRecommendation(recommendation));
     return recommendation;
 }
+function printScope(scope) {
+    if (!scope)
+        return;
+    const name = scope.key ? `${scope.key}${scope.url ? ` (${scope.url})` : ""}` : "the agent's task prompt";
+    if (scope.status !== "checked") {
+        const why = { no_items: "no checkable written requirements", not_found: "issue not found; scope not checked", unavailable: "issue could not be read; scope not checked", incomplete: "scope check incomplete" };
+        process.stdout.write(`\nLinked issue ${name}: ${why[scope.status] ?? scope.status}${scope.error ? ` (${scope.error})` : ""}\n`);
+        return;
+    }
+    const outcome = scopeOutcome({ scope });
+    if (outcome.kind === "unchecked") {
+        process.stdout.write(`\nLinked issue ${name}: ${outcome.reason}\n`);
+        return;
+    }
+    const items = (Array.isArray(scope.items) ? scope.items : []).filter((i) => typeof i === "object" && i !== null);
+    // The recommendation's rule: required unless explicitly false, met only when true.
+    const required = items.filter(i => i.required !== false);
+    process.stdout.write(`\nLinked issue ${name}: ${required.filter(i => i.met === true).length} of ${required.length} written requirements met${scope.error ? ` (${scope.error})` : ""}\n`);
+    for (const it of items) {
+        const mark = it.required === false ? "-" : it.met === true ? "✓" : "✗";
+        const detail = it.met === true ? (it.evidence_refs ?? []).slice(0, 3).join(", ") : it.reason ?? "";
+        process.stdout.write(`  ${mark} ${it.scope_item}${detail ? `\n      ${detail}` : ""}\n`);
+    }
+}
+function printVerdict(v) {
+    if (v.event === "REQUEST_CHANGES") {
+        const reasons = [];
+        if (v.blockingFindings)
+            reasons.push(`${v.blockingFindings} blocking finding${v.blockingFindings === 1 ? "" : "s"} (${v.blockingSeverity ?? "high"} or above)`);
+        if (v.scopeUnmet?.length)
+            reasons.push(`${v.scopeUnmet.length} written requirement${v.scopeUnmet.length === 1 ? "" : "s"} of ${v.scopeKey || "the task"} not met`);
+        process.stdout.write(`\nVerdict: changes requested — ${reasons.join("; ")}\n`);
+        for (const it of v.scopeUnmet ?? [])
+            process.stdout.write(`  missing: "${it.scope_item}"\n`);
+    }
+    else if (v.event === "APPROVE")
+        process.stdout.write("\nVerdict: approved\n");
+    else
+        process.stdout.write(`\nVerdict: no verdict (${v.reason === "scope_unverified" ? "the linked issue's requirements could not be checked" : "the review is incomplete"})\n`);
+}
 async function pollLocalRun(route, signal) {
     for (let attempt = 0;; attempt++) {
         try {
@@ -105,6 +151,12 @@ export async function cmdReviewLocal(options) {
     const context = options.contextFile ? new TextDecoder("utf-8", { fatal: true }).decode(await readFile(options.contextFile)) : undefined;
     if (context && (Buffer.byteLength(context) > 16000 || context.includes("\0")))
         throw new Error("--context-file must contain at most 16000 UTF-8 bytes without NUL characters");
+    const issueKey = options.issue?.trim().toUpperCase();
+    if (issueKey && !/^[A-Z][A-Z0-9_]{1,9}-[1-9][0-9]{0,8}$/.test(issueKey))
+        throw new Error("--issue must be an issue key such as DITTO-123");
+    // The trace is only read; it stays where the agent wrote it.
+    const trace = options.trace ? await readAgentTrace(options.trace) : undefined;
+    const linked = { ...(issueKey ? { issueKey } : {}), ...(trace ? { trace } : {}) };
     // Preview deliberately has no auth or network dependency.
     const company = options.preview ? undefined : await resolveScope(options);
     const repos = options.preview ? [] : await listReviewRepositories(company);
@@ -116,7 +168,7 @@ export async function cmdReviewLocal(options) {
     process.on("SIGTERM", onTerm);
     const timer = setTimeout(() => { timedOut = true; controller.abort(); }, timeout);
     const requestId = options.requestId?.toLowerCase() ?? randomUUID();
-    const recovery = () => {
+    const recovery = async () => {
         const args = ["heyditto", "review", "local", "--request-id", requestId, "--profile", profile];
         if (capturedRoot)
             args.push("--directory", capturedRoot);
@@ -126,6 +178,18 @@ export async function cmdReviewLocal(options) {
             args.push("--base", options.base);
         if (options.contextFile)
             args.push("--context-file", path.resolve(options.contextFile));
+        // The session file keeps growing; recover with the exact trace sent.
+        if (trace) {
+            // Never fall back to the live session file: it may have grown since.
+            try {
+                args.push("--trace", await freezeAgentTrace(trace, requestId));
+            }
+            catch (error) {
+                return `unavailable: the exact trace could not be saved (${error instanceof Error ? error.message : String(error)})`;
+            }
+        }
+        if (issueKey)
+            args.push("--issue", issueKey);
         if (options.repository)
             args.push("--repository", options.repository);
         if (company)
@@ -139,7 +203,9 @@ export async function cmdReviewLocal(options) {
         const preview = {
             requestId, profile, snapshotDigest: snapshot.digest, mode: snapshot.mode, baseSha: snapshot.baseSha,
             changedPaths: snapshot.changedPaths, baseFileCount: snapshot.baseFiles.length, headFileCount: snapshot.headFiles.length,
-            contentBytes: captured.bytes, payloadBytes: Buffer.byteLength(JSON.stringify({ requestId, snapshot, profile, context })),
+            contentBytes: captured.bytes, payloadBytes: Buffer.byteLength(JSON.stringify({ requestId, snapshot, profile, context, ...linked })),
+            ...(issueKey ? { issueKey } : {}),
+            ...(trace ? { trace: { format: trace.format, promptBytes: Buffer.byteLength(trace.initialPrompt), steps: trace.steps.length, truncated: trace.truncated === true } } : {}),
             contextComplete: snapshot.contextComplete, omittedContext: snapshot.omittedContext, skipped: snapshot.skipped,
         };
         if (options.preview) {
@@ -148,6 +214,10 @@ export async function cmdReviewLocal(options) {
             process.stdout.write(`Local review preview · ${profile}\nSnapshot: ${snapshot.digest}\nSelected changes: ${snapshot.changedPaths.length}\nContext files: ${snapshot.headFiles.length} (${captured.bytes} decoded bytes; ${preview.payloadBytes} payload bytes)\n`);
             for (const file of snapshot.changedPaths)
                 process.stdout.write(`  ${file}\n`);
+            if (issueKey)
+                process.stdout.write(`Linked issue: ${issueKey}\n`);
+            if (trace)
+                process.stdout.write(`Agent trace: ${trace.format}, ${trace.steps.length} steps${trace.truncated ? " (middle steps omitted)" : ""}\n`);
             process.stdout.write(`Omitted context: ${snapshot.omittedContext.length}; skipped files: ${snapshot.skipped.length}\nNo source uploaded; no review started.\n`);
             return;
         }
@@ -173,7 +243,7 @@ export async function cmdReviewLocal(options) {
         // Complete the admission response even on Ctrl-C so a returned run can be
         // cancelled. An uncertain POST is never retried automatically.
         let run = await apiFetch(`/api/v5/review/repositories/${encodeURIComponent(repo.id)}/local${scopeQuery(company)}`, {
-            method: "POST", body: { requestId, snapshot, profile, ...(context ? { context } : {}) }, signal: AbortSignal.timeout(30000),
+            method: "POST", body: { requestId, snapshot, profile, ...(context ? { context } : {}), ...linked }, signal: AbortSignal.timeout(30000),
         });
         try {
             runPath(run?.runId);
@@ -213,6 +283,13 @@ export async function cmdReviewLocal(options) {
                     process.exitCode = gateExitCode(recommendation);
                 else if (["failed", "cancelled", "partial"].includes(run.status) || (run.status === "completed" && run.result?.complete !== true) || malformedLocalRun(run).length)
                     process.exitCode = 1;
+                // Without --gate only completeness and the linked issue's written scope
+                // set the exit status (findings alone keep 0, as before), by the rule
+                // --gate uses: 2 for an unmet requirement, 1 for a scope not fully checked.
+                else if (scopeOutcome(run.result).kind === "changes")
+                    process.exitCode = REQUEST_CHANGES_EXIT;
+                else if (scopeOutcome(run.result).kind === "unchecked")
+                    process.exitCode = 1;
                 return;
             }
             if (!ACTIVE_REVIEW_STATUSES.has(run.status))
@@ -234,7 +311,7 @@ export async function cmdReviewLocal(options) {
         if (interrupted || timedOut) {
             process.stderr.write(`${timedOut ? "Local review timed out" : "Local review interrupted"}${runId ? ` (run ${runId})` : posted ? `; admission outcome is unknown (request ${requestId})` : ""}.\n`);
             if (posted && !runId)
-                process.stderr.write(`Recover the same admission: ${recovery()}\nChanged source, profile or context is refused; no automatic retry was made.\n`);
+                process.stderr.write(`Recover the same admission: ${await recovery()}\nChanged source, profile or context is refused; no automatic retry was made.\n`);
             if (isJSON(options)) {
                 const status = timedOut ? "timed_out" : "interrupted";
                 writeJSON({ status, requestId, ...(runId ? { runId } : {}), recommendation: { verdict: "none", approved: false, reasons: [timedOut ? "local review timed out; a timed-out run is never approval" : "local review interrupted; an interrupted run is never approval"], blocking: 0, nits: 0 } });
@@ -248,7 +325,7 @@ export async function cmdReviewLocal(options) {
             throw new Error(`Ditto refused the local review request (HTTP ${error.status}${refusalDetail(error.body)}). No review was admitted and nothing was approved.`);
         }
         if (posted && !runId)
-            throw new Error(`${error instanceof Error ? error.message : String(error)}\nAdmission outcome is unknown; request ${requestId}.\nRecover the same admission: ${recovery()}\nChanged source, profile or context is refused; no automatic retry was made.`);
+            throw new Error(`${error instanceof Error ? error.message : String(error)}\nAdmission outcome is unknown; request ${requestId}.\nRecover the same admission: ${await recovery()}\nChanged source, profile or context is refused; no automatic retry was made.`);
         throw error;
     }
     finally {
@@ -707,8 +784,10 @@ export function registerReviewCommands(program, addExamples, outputOption, orgOp
         .option("--preview", "inspect selected paths and upload size locally; no auth, upload or inference")
         .option("--timeout <seconds>", "cancel after this many seconds including capture and queue time (1-1800; default 1200, 1800 for deep)")
         .option("--request-id <uuid>", "recover an uncertain admission with exactly the same source, profile and context")
-        .option("--gate", "exit 0 only on an approve recommendation, 2 on changes requested, 1 when there is no recommendation; a timeout (124) or interrupt (130/143) keeps its own code and is never approval"))
-        .action(cmdReviewLocal), `  heyditto review local --preview\n  heyditto review local --staged --profile quick --org omniaura\n  heyditto review local --base main --context-file .tmp/task.md --output json`);
+        .option("--gate", "exit 0 only on an approve recommendation, 2 on changes requested, 1 when there is no recommendation; a timeout (124) or interrupt (130/143) keeps its own code and is never approval")
+        .option("--trace <file>", "the coding agent's session (Claude Code or Codex JSONL): its prompt and steps become review input, and its linked issue's written requirements are checked; read only, never deleted")
+        .option("--issue <key>", "the Jira issue this change delivers (default: a [KEY-1] tag or tracker link in the trace prompt or context)"))
+        .action(cmdReviewLocal), `  heyditto review local --preview\n  heyditto review local --staged --profile quick --org omniaura\n  heyditto review local --base main --context-file .tmp/task.md --output json\n  heyditto review local --base main --trace ~/.claude/projects/<project>/<session>.jsonl --issue DITTO-2434\n\nExit status: 0 approved or no blocking issue, 1 incomplete or failed, ${REQUEST_CHANGES_EXIT} changes requested.`);
     scoped(review.command("local-status").description("inspect a pre-PR review run without starting or retrying it")
         .argument("<run-id>", "local review run UUID")
         .option("--gate", "exit 0 only on approve (never, since status cannot verify the working tree), 2 on changes, 1 otherwise")).action(cmdReviewLocalStatus);