@corelayer-ai/cli 0.5.1 → 0.5.3

package/dist/commands/issues.js

@@ -1,14 +1,10 @@
 import { stdin as input, stdout as output } from "node:process";
 import { createInterface } from "node:readline/promises";
 import { CorelayerClient } from "../lib/api-client.js";
+import { readFlag } from "../lib/args.js";
 import { readConfig, resolveApiUrl, resolveToken } from "../lib/config.js";
 import { fail, formatDate, printJson, printTable } from "../lib/output.js";
-function readFlag(args, flag) {
-    const index = args.indexOf(flag);
-    if (index === -1)
-        return undefined;
-    return args[index + 1];
-}
+import { runIssueTickets } from "./issue-tickets.js";
 function hasFlag(args, flag) {
     return args.includes(flag);
 }
@@ -58,6 +54,7 @@ USAGE:
 SUBCOMMANDS:
   list                  List issues in a group
   get <id|slug>         Show details for one issue
+  ticket <action> <id>  Jira/Linear destinations, search, ensure, create, link, status
   summary               Summarize issue health for a group
   diff                  Show issues new or changed since a timestamp
   close <id|slug>       Close an issue (write operation)
@@ -80,6 +77,15 @@ OPTIONS:
                         Diff: ISO 8601 timestamp or preset (1hour, 24hours, 7days, 14days, 30days)
   --duration <duration>
                         Diff: human-friendly duration (e.g. 2hours, 4hours, 30m, 1d)
+  --provider jira|linear Ticket provider
+  --account <id>        Connected ticket account
+  --project <id>        Ticket project
+  --team <id>           Linear team
+  --type <id>           Jira issue type
+  --ticket <id>         Selected existing ticket (link)
+  --request-id <uuid>   Resume the same mutation or read its status
+  --revision <n>        Jira account revision from ticket destinations
+  --fields <json>       Required provider creation fields
   --yes                 Skip confirmation prompt (delete)
   --json                Output as JSON
   -h, --help            Print help
@@ -112,208 +118,206 @@ function parseDuration(value) {
         return Math.round(n * 24 * 60 * 60 * 1000);
     return null;
 }
-export async function runIssues(args, ctx) {
-    if (args.includes("--help") || args.includes("-h")) {
-        printHelp();
-        return;
+function resolveGroupId(args, config) {
+    const groupId = readFlag(args, "--group") || config.defaults?.group;
+    if (!groupId) {
+        fail("groupId is required. Use --group <groupId> or set default-group via corelayer config set default-group <groupId>");
     }
-    const sub = args[0];
-    const config = readConfig();
-    const token = resolveToken();
-    if (!token) {
-        fail("Not authenticated. Set CORELAYER_API_KEY or run: corelayer login");
+    return groupId;
+}
+async function runGetIssue(client, commandArgs, ctx) {
+    const issueIdentifier = commandArgs[0];
+    if (!issueIdentifier) {
+        fail("Usage: corelayer issues get <issueId|slug>");
     }
-    const apiUrl = resolveApiUrl(ctx.apiUrlOverride);
-    const client = new CorelayerClient(apiUrl, token);
-    const commandArgs = removeFlags(args.slice(1));
-    if (sub === "list") {
-        const groupId = readFlag(args, "--group") || config.defaults?.group;
-        if (!groupId) {
-            fail("groupId is required. Use --group <groupId> or set default-group via corelayer config set default-group <groupId>");
-        }
-        const result = await client.listIssues(groupId, {
-            status: readFlag(args, "--status"),
-            severity: readFlag(args, "--severity"),
-            limit: readFlag(args, "--limit"),
-            page: readFlag(args, "--page"),
-        });
-        if (ctx.json) {
-            printJson(result);
-            return;
-        }
-        const rows = result.issues.map((issue) => [
-            issue.id,
-            issue.slug || "-",
-            issue.severity || "-",
-            issue.status || "-",
-            issue.title || "-",
-            formatDate(issue.last_seen_at || issue.lastSeenAt),
-        ]);
-        printTable(["ID", "SLUG", "SEVERITY", "STATUS", "TITLE", "LAST SEEN"], rows);
-        if (!ctx.quiet) {
-            process.stdout.write(`Showing ${result.issues.length} of ${result.total} issues\n`);
-        }
+    const issue = await client.getIssue(issueIdentifier);
+    if (ctx.json) {
+        printJson(issue);
         return;
     }
-    if (sub === "get") {
-        const issueIdentifier = commandArgs[0];
-        if (!issueIdentifier) {
-            fail("Usage: corelayer issues get <issueId|slug>");
-        }
-        const issue = await client.getIssue(issueIdentifier);
-        if (ctx.json) {
-            printJson(issue);
-            return;
-        }
-        process.stdout.write(`Issue ${issue.slug || issue.id}: ${issue.title || ""}\n`);
-        process.stdout.write(`Status: ${issue.status || "-"}\n`);
-        process.stdout.write(`Severity: ${issue.severity || "-"}\n`);
-        process.stdout.write(`Created: ${formatDate(issue.createdAt || issue.created_at)}\n`);
-        process.stdout.write(`Last seen: ${formatDate(issue.lastSeenAt || issue.last_seen_at)}\n`);
-        process.stdout.write(`Events: ${issue.event_count || 0}\n`);
-        if (issue.whatHappened) {
-            process.stdout.write(`\nWhat happened:\n${issue.whatHappened}\n`);
-        }
-        if (issue.rootCause) {
-            process.stdout.write(`\nRoot cause:\n${issue.rootCause}\n`);
-        }
-        if (issue.nextSteps) {
-            process.stdout.write(`\nNext steps:\n${issue.nextSteps}\n`);
-        }
+    process.stdout.write(`Issue ${issue.slug || issue.id}: ${issue.title || ""}\n`);
+    process.stdout.write(`Status: ${issue.status || "-"}\n`);
+    process.stdout.write(`Severity: ${issue.severity || "-"}\n`);
+    process.stdout.write(`Created: ${formatDate(issue.createdAt || issue.created_at)}\n`);
+    process.stdout.write(`Last seen: ${formatDate(issue.lastSeenAt || issue.last_seen_at)}\n`);
+    process.stdout.write(`Events: ${issue.event_count || 0}\n`);
+    if (issue.whatHappened) {
+        process.stdout.write(`\nWhat happened:\n${issue.whatHappened}\n`);
+    }
+    if (issue.rootCause) {
+        process.stdout.write(`\nRoot cause:\n${issue.rootCause}\n`);
+    }
+    if (issue.nextSteps) {
+        process.stdout.write(`\nNext steps:\n${issue.nextSteps}\n`);
+    }
+}
+function issueRows(issues) {
+    return issues.map((issue) => [
+        issue.id,
+        issue.slug || "-",
+        issue.severity || "-",
+        issue.status || "-",
+        issue.title || "-",
+        formatDate(issue.last_seen_at || issue.lastSeenAt),
+    ]);
+}
+async function runListIssues({ args, client, config, ctx, }) {
+    const groupId = resolveGroupId(args, config);
+    const result = await client.listIssues(groupId, {
+        status: readFlag(args, "--status"),
+        severity: readFlag(args, "--severity"),
+        limit: readFlag(args, "--limit"),
+        page: readFlag(args, "--page"),
+    });
+    if (ctx.json) {
+        printJson(result);
         return;
     }
-    if (sub === "close") {
-        const issueIdentifier = commandArgs[0];
-        if (!issueIdentifier) {
-            fail('Usage: corelayer issues close <issueId|slug> [--feedback "..."]');
-        }
-        const feedback = readFlag(args, "--feedback");
-        const issue = await client.getIssue(issueIdentifier);
-        if (!issue.id) {
-            fail("Could not resolve issue identifier to an issue ID.");
-        }
-        await client.closeIssue(issue.id, feedback);
-        if (!ctx.quiet) {
-            process.stdout.write(`Issue ${issue.slug || issue.id} closed.\n`);
-        }
+    printTable(["ID", "SLUG", "SEVERITY", "STATUS", "TITLE", "LAST SEEN"], issueRows(result.issues));
+    if (!ctx.quiet) {
+        process.stdout.write(`Showing ${result.issues.length} of ${result.total} issues\n`);
+    }
+}
+async function runCloseIssue({ args, client, commandArgs, ctx, }) {
+    const issueIdentifier = commandArgs[0];
+    if (!issueIdentifier) {
+        fail('Usage: corelayer issues close <issueId|slug> [--feedback "..."]');
+    }
+    const feedback = readFlag(args, "--feedback");
+    const issue = await client.getIssue(issueIdentifier);
+    if (!issue.id) {
+        fail("Could not resolve issue identifier to an issue ID.");
+    }
+    await client.closeIssue(issue.id, feedback);
+    if (!ctx.quiet) {
+        process.stdout.write(`Issue ${issue.slug || issue.id} closed.\n`);
+    }
+}
+async function runBulkCloseIssues({ args, client, config, ctx, }) {
+    const groupId = resolveGroupId(args, config);
+    const lastSeenBefore = readFlag(args, "--last-seen-before");
+    const lastSeenBeforeOrOn = readFlag(args, "--last-seen-before-or-on");
+    if (!lastSeenBefore && !lastSeenBeforeOrOn) {
+        fail('Usage: corelayer issues bulk-close --group <groupId> (--last-seen-before <date|preset> | --last-seen-before-or-on <date|preset>) [--feedback "..."]');
+    }
+    const feedback = readFlag(args, "--feedback");
+    const result = await client.bulkIssueAction({
+        action: "close",
+        groupId,
+        feedback,
+        filters: {
+            status: readFlag(args, "--status") || "Open",
+            severity: readFlag(args, "--severity"),
+            lastSeenBefore,
+            lastSeenBeforeOrOn,
+        },
+    });
+    if (ctx.json) {
+        printJson(result);
         return;
     }
-    if (sub === "bulk-close") {
-        const groupId = readFlag(args, "--group") || config.defaults?.group;
-        if (!groupId) {
-            fail("groupId is required. Use --group <groupId> or set default-group via corelayer config set default-group <groupId>");
-        }
-        const lastSeenBefore = readFlag(args, "--last-seen-before");
-        const lastSeenBeforeOrOn = readFlag(args, "--last-seen-before-or-on");
-        if (!lastSeenBefore && !lastSeenBeforeOrOn) {
-            fail('Usage: corelayer issues bulk-close --group <groupId> (--last-seen-before <date|preset> | --last-seen-before-or-on <date|preset>) [--feedback "..."]');
-        }
-        const feedback = readFlag(args, "--feedback");
-        const result = await client.bulkIssueAction({
-            action: "close",
-            groupId,
-            feedback,
-            filters: {
-                status: readFlag(args, "--status") || "Open",
-                severity: readFlag(args, "--severity"),
-                lastSeenBefore,
-                lastSeenBeforeOrOn,
-            },
-        });
-        if (ctx.json) {
-            printJson(result);
+    process.stdout.write(`Bulk close complete. Closed ${result.affected} issues`);
+    if (result.skipped > 0) {
+        process.stdout.write(`, skipped ${result.skipped}`);
+    }
+    process.stdout.write(".\n");
+}
+async function runReopenIssue({ client, commandArgs, ctx, }) {
+    const issueId = commandArgs[0];
+    if (!issueId) {
+        fail("Usage: corelayer issues reopen <issueId>");
+    }
+    await client.reopenIssue(issueId);
+    if (!ctx.quiet) {
+        process.stdout.write(`Issue ${issueId} reopened.\n`);
+    }
+}
+async function runDeleteIssue({ args, client, commandArgs, ctx, }) {
+    const issueId = commandArgs[0];
+    if (!issueId) {
+        fail("Usage: corelayer issues delete <issueId> [--yes]");
+    }
+    const yes = hasFlag(args, "--yes");
+    if (!yes) {
+        const confirmed = await confirmDelete();
+        if (!confirmed) {
+            process.stdout.write("Aborted.\n");
             return;
         }
-        process.stdout.write(`Bulk close complete. Closed ${result.affected} issues`);
-        if (result.skipped > 0) {
-            process.stdout.write(`, skipped ${result.skipped}`);
-        }
-        process.stdout.write(".\n");
-        return;
     }
-    if (sub === "reopen") {
-        const issueId = commandArgs[0];
-        if (!issueId) {
-            fail("Usage: corelayer issues reopen <issueId>");
-        }
-        await client.reopenIssue(issueId);
-        if (!ctx.quiet) {
-            process.stdout.write(`Issue ${issueId} reopened.\n`);
-        }
-        return;
+    await client.deleteIssue(issueId);
+    if (!ctx.quiet) {
+        process.stdout.write(`Issue ${issueId} deleted.\n`);
     }
-    if (sub === "delete") {
-        const issueId = commandArgs[0];
-        if (!issueId) {
-            fail("Usage: corelayer issues delete <issueId> [--yes]");
-        }
-        const yes = hasFlag(args, "--yes");
-        if (!yes) {
-            const confirmed = await confirmDelete();
-            if (!confirmed) {
-                process.stdout.write("Aborted.\n");
-                return;
-            }
-        }
-        await client.deleteIssue(issueId);
-        if (!ctx.quiet) {
-            process.stdout.write(`Issue ${issueId} deleted.\n`);
-        }
+}
+async function runIssueSummary({ args, client, config, }) {
+    const groupId = resolveGroupId(args, config);
+    const summary = await client.getIssueSummary(groupId);
+    printJson(summary);
+}
+function resolveDiffSince(args) {
+    const sinceFlag = readFlag(args, "--since");
+    const durationFlag = readFlag(args, "--duration");
+    if (!sinceFlag && !durationFlag) {
+        fail("One of --since <timestamp|preset> or --duration <duration> is required.\n" +
+            "Examples: --since 2026-06-01T00:00:00Z  --since 24hours  --duration 2hours");
+    }
+    if (!durationFlag) {
+        return sinceFlag;
+    }
+    const ms = parseDuration(durationFlag);
+    if (ms === null) {
+        fail(`Invalid --duration value: "${durationFlag}". Examples: 30m, 2hours, 4h, 1d, 7days`);
+    }
+    return new Date(Date.now() - ms).toISOString();
+}
+async function runDiffIssues({ args, client, config, ctx, }) {
+    const groupId = resolveGroupId(args, config);
+    const result = await client.diffIssues(groupId, resolveDiffSince(args), {
+        limit: readFlag(args, "--limit"),
+        page: readFlag(args, "--page"),
+    });
+    if (ctx.json) {
+        printJson(result);
         return;
     }
-    if (sub === "summary") {
-        const groupId = readFlag(args, "--group") || config.defaults?.group;
-        if (!groupId) {
-            fail("groupId is required. Use --group <groupId> or set default-group via corelayer config set default-group <groupId>");
-        }
-        const summary = await client.getIssueSummary(groupId);
-        printJson(summary);
+    process.stdout.write(`DIFF SINCE ${result.since}\n`);
+    printTable(["ID", "SLUG", "SEVERITY", "STATUS", "TITLE", "LAST SEEN"], issueRows(result.issues));
+    if (!ctx.quiet) {
+        process.stdout.write(`${result.total} issue${result.total === 1 ? "" : "s"} changed since ${result.since}\n`);
+    }
+}
+const ISSUE_COMMAND_HANDLERS = {
+    "bulk-close": runBulkCloseIssues,
+    close: runCloseIssue,
+    delete: runDeleteIssue,
+    diff: runDiffIssues,
+    get: ({ client, commandArgs, ctx }) => runGetIssue(client, commandArgs, ctx),
+    list: runListIssues,
+    reopen: runReopenIssue,
+    summary: runIssueSummary,
+};
+export async function runIssues(args, ctx) {
+    if (args.includes("--help") || args.includes("-h")) {
+        printHelp();
         return;
     }
-    if (sub === "diff") {
-        const groupId = readFlag(args, "--group") || config.defaults?.group;
-        if (!groupId) {
-            fail("groupId is required. Use --group <groupId> or set default-group via corelayer config set default-group <groupId>");
-        }
-        const sinceFlag = readFlag(args, "--since");
-        const durationFlag = readFlag(args, "--duration");
-        if (!sinceFlag && !durationFlag) {
-            fail("One of --since <timestamp|preset> or --duration <duration> is required.\n" +
-                "Examples: --since 2026-06-01T00:00:00Z  --since 24hours  --duration 2hours");
-        }
-        let sinceValue;
-        if (durationFlag) {
-            const ms = parseDuration(durationFlag);
-            if (ms === null) {
-                fail(`Invalid --duration value: "${durationFlag}". Examples: 30m, 2hours, 4h, 1d, 7days`);
-            }
-            sinceValue = new Date(Date.now() - ms).toISOString();
-        }
-        else {
-            sinceValue = sinceFlag;
-        }
-        const result = await client.diffIssues(groupId, sinceValue, {
-            limit: readFlag(args, "--limit"),
-            page: readFlag(args, "--page"),
-        });
-        if (ctx.json) {
-            printJson(result);
-            return;
-        }
-        process.stdout.write(`DIFF SINCE ${result.since}\n`);
-        const rows = result.issues.map((issue) => [
-            issue.id,
-            issue.slug || "-",
-            issue.severity || "-",
-            issue.status || "-",
-            issue.title || "-",
-            formatDate(issue.last_seen_at || issue.lastSeenAt),
-        ]);
-        printTable(["ID", "SLUG", "SEVERITY", "STATUS", "TITLE", "LAST SEEN"], rows);
-        if (!ctx.quiet) {
-            process.stdout.write(`${result.total} issue${result.total === 1 ? "" : "s"} changed since ${result.since}\n`);
-        }
+    const sub = args[0];
+    const config = readConfig();
+    const token = resolveToken();
+    if (!token) {
+        fail("Not authenticated. Set CORELAYER_API_KEY or run: corelayer login");
+    }
+    const apiUrl = resolveApiUrl(ctx.apiUrlOverride);
+    const client = new CorelayerClient(apiUrl, token);
+    if (sub === "ticket") {
+        await runIssueTickets(args.slice(1), client, config, ctx);
         return;
     }
-    fail("Usage: corelayer issues <list|get|close|bulk-close|reopen|delete|summary|diff> [options]");
+    const commandArgs = removeFlags(args.slice(1));
+    const handler = ISSUE_COMMAND_HANDLERS[sub];
+    if (!handler) {
+        fail("Usage: corelayer issues <list|get|close|bulk-close|reopen|delete|summary|diff> [options]");
+    }
+    await handler({ args, client, commandArgs, config, ctx });
 }

package/dist/commands/login.js

@@ -1,12 +1,7 @@
+import { readFlag } from "../lib/args.js";
 import { loginWithBrowser, loginWithCodeDirect } from "../lib/auth.js";
 import { updateConfig } from "../lib/config.js";
 import { fail } from "../lib/output.js";
-function readFlag(args, flag) {
-    const index = args.indexOf(flag);
-    if (index === -1)
-        return undefined;
-    return args[index + 1];
-}
 function hasFlag(args, flag) {
     return args.includes(flag);
 }

package/dist/commands/logout.js

@@ -1,11 +1,14 @@
-import { clearToken } from "../lib/config.js";
+import { CorelayerClient } from "../lib/api-client.js";
+import { clearToken, readConfig } from "../lib/config.js";
 function printHelp() {
-    process.stdout.write(`corelayer logout - Sign out and clear local credentials
+    process.stdout
+        .write(`corelayer logout - Revoke the saved credential and clear it locally
 
 USAGE:
   corelayer logout
 
 OPTIONS:
+  --local-only Clear the saved credential without server revocation
   -h, --help    Print help
 `);
 }
@@ -14,8 +17,23 @@ export async function runLogout(args, ctx) {
         printHelp();
         return;
     }
+    const config = readConfig();
+    if (config.token && !args.includes("--local-only")) {
+        try {
+            await new CorelayerClient(config.apiUrl, config.token).logout();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Request failed";
+            throw new Error(`Could not revoke the saved credential: ${message}. Local credentials were kept. Retry, or use --local-only to clear them without revocation.`);
+        }
+    }
     clearToken();
+    if (process.env.CORELAYER_API_KEY) {
+        process.stderr.write("CORELAYER_API_KEY is still set. Unset it to stop using that credential.\n");
+    }
     if (!ctx.quiet) {
-        process.stdout.write("Logged out.\n");
+        process.stdout.write(args.includes("--local-only")
+            ? "Local credentials cleared; the server credential was not revoked.\n"
+            : "Logged out.\n");
     }
 }

package/dist/commands/preflight.js

@@ -1,10 +1,12 @@
-import { execSync } from "node:child_process";
+import { execFileSync } from "node:child_process";
 import { CorelayerClient } from "../lib/api-client.js";
-import { resolveToken, resolveApiUrl } from "../lib/config.js";
+import { readFlag } from "../lib/args.js";
+import { resolveApiUrl, resolveToken } from "../lib/config.js";
 import { fail, printJson } from "../lib/output.js";
 const MAX_DIFF_CHARS = 12_000;
 function printHelp() {
-    process.stdout.write(`corelayer preflight - Check a change against org memory before you push
+    process.stdout
+        .write(`corelayer preflight - Check a change against org memory before you push
 
 Surfaces failure modes and things to double-check that your org has hit before for
 changes like this one. Run inside a git repo with no arguments and it derives the PR
@@ -28,15 +30,9 @@ EXAMPLES:
   corelayer preflight --description "Add Redis cache to the payments worker" --repo payments-api
 `);
 }
-function readFlag(args, flag) {
-    const index = args.indexOf(flag);
-    if (index === -1)
-        return undefined;
-    return args[index + 1];
-}
 function git(args) {
     try {
-        return execSync(`git ${args}`, {
+        return execFileSync("git", args, {
             encoding: "utf8",
             stdio: ["ignore", "pipe", "ignore"],
         }).trim();
@@ -46,18 +42,23 @@ function git(args) {
     }
 }
 function detectRepo() {
-    const url = git("config --get remote.origin.url");
+    const url = git(["config", "--get", "remote.origin.url"]);
     if (!url)
         return undefined;
     const match = url.replace(/\.git$/, "").match(/([^/:]+)$/);
     return match ? match[1] : undefined;
 }
 function detectBase() {
-    const head = git("rev-parse --abbrev-ref origin/HEAD"); // e.g. origin/main
+    const head = git(["rev-parse", "--abbrev-ref", "origin/HEAD"]);
     if (head && head.startsWith("origin/"))
-        return head.slice("origin/".length);
+        return head;
     for (const candidate of ["main", "master"]) {
-        if (git(`rev-parse --verify ${candidate}`))
+        if (git([
+            "rev-parse",
+            "--verify",
+            "--end-of-options",
+            `${candidate}^{commit}`,
+        ]))
             return candidate;
     }
     return "main";
@@ -81,15 +82,28 @@ function printChecks(checks, noColor) {
         process.stdout.write(`   ${severityColor(check.severity, noColor)} · "${check.title}" · ${where}${seen}\n`);
     });
 }
-export async function runPreflight(args, ctx) {
-    if (args.includes("--help") || args.includes("-h")) {
-        printHelp();
-        return;
-    }
+function buildPreflightContext(args) {
     const base = readFlag(args, "--base") || detectBase();
-    const commits = git(`log ${base}..HEAD --pretty=format:%s%n%b`) || "";
-    const files = git(`diff --name-only ${base}...HEAD`) || "";
-    const branch = git("rev-parse --abbrev-ref HEAD");
+    const baseCommit = git([
+        "rev-parse",
+        "--verify",
+        "--end-of-options",
+        `${base}^{commit}`,
+    ]);
+    const commits = baseCommit
+        ? git(["log", "--pretty=format:%s%n%b", `${baseCommit}..HEAD`, "--"]) || ""
+        : "";
+    const files = baseCommit
+        ? git([
+            "diff",
+            "--no-ext-diff",
+            "--no-textconv",
+            "--name-only",
+            `${baseCommit}...HEAD`,
+            "--",
+        ]) || ""
+        : "";
+    const branch = git(["rev-parse", "--abbrev-ref", "HEAD"]);
     const repo = readFlag(args, "--repo") || detectRepo();
     const title = readFlag(args, "--title") || commits.split("\n")[0]?.trim() || branch;
     let description = readFlag(args, "--description");
@@ -101,11 +115,41 @@ export async function runPreflight(args, ctx) {
             parts.push(`Changed files:\n${files.trim()}`);
         description = parts.join("\n\n");
     }
-    if (args.includes("--diff")) {
-        const diff = git(`diff ${base}...HEAD`);
+    if (args.includes("--diff") && baseCommit) {
+        const diff = git([
+            "diff",
+            "--no-ext-diff",
+            "--no-textconv",
+            `${baseCommit}...HEAD`,
+            "--",
+        ]);
         if (diff)
             description += `\n\nDiff:\n${diff.slice(0, MAX_DIFF_CHARS)}`;
     }
+    return { base, description, repo, title };
+}
+function printPreflightResult(result, ctx) {
+    if (result.degraded) {
+        process.stderr.write(`⚠ Preflight could not run (${result.reason ?? "unknown reason"}). This is not an all-clear.\n`);
+        return;
+    }
+    if (result.checks.length === 0) {
+        if (!ctx.quiet) {
+            process.stdout.write("✓ Preflight: nothing in org memory to double-check for this change.\n");
+        }
+        return;
+    }
+    if (!ctx.quiet) {
+        process.stdout.write(`Preflight — ${result.checks.length} thing(s) to double-check before you push:\n\n`);
+    }
+    printChecks(result.checks, ctx.noColor);
+}
+export async function runPreflight(args, ctx) {
+    if (args.includes("--help") || args.includes("-h")) {
+        printHelp();
+        return;
+    }
+    const { base, description, repo, title } = buildPreflightContext(args);
     if (!description.trim()) {
         fail(`No PR context found. Run inside a git repo with commits ahead of "${base}", or pass --description.`);
     }
@@ -124,14 +168,5 @@ export async function runPreflight(args, ctx) {
         printJson(result);
         return;
     }
-    if (result.checks.length === 0) {
-        if (!ctx.quiet) {
-            process.stdout.write("✓ Preflight: nothing in org memory to double-check for this change.\n");
-        }
-        return;
-    }
-    if (!ctx.quiet) {
-        process.stdout.write(`Preflight — ${result.checks.length} thing(s) to double-check before you push:\n\n`);
-    }
-    printChecks(result.checks, ctx.noColor);
+    printPreflightResult(result, ctx);
 }