@ashlr/hub 3.4.0 → 3.5.1

package/dist/core/verse/github-repo.js

@@ -0,0 +1,476 @@
+/**
+ * core/verse/github-repo.ts — per-root GitHub surfacing for Ashlr Verse
+ * (docs/VERSE-WORKSPACES.md §2). READ-ONLY. NEVER THROWS.
+ *
+ * ── AUTH ───────────────────────────────────────────────────────────────────
+ * The `gh` CLI owns its own credentials, exactly as core/integrations/github.ts
+ * does. This module spawns the same binary with the same env hygiene and holds
+ * NO token of its own. There is no second credential path here, and no code
+ * path in this file reads, stores, or emits one.
+ *
+ * ── WHY IT SPAWNS `gh` AT ALL, GIVEN github.ts EXISTS ──────────────────────
+ * github.ts does the hard part and this module reuses its conventions
+ * verbatim (same binary, same 8 s timeout, same env, same never-throw
+ * contract). It does not reuse its two list functions, for two reasons that
+ * are contract-level rather than stylistic:
+ *
+ *   1. CI STATE. `listPrs()` requests `number,title,url,state,author` and
+ *      `PrSummary` has no checks field; `githubStatus().ci` is repo-wide,
+ *      derived from the last five *workflow runs*, and cannot say which PR is
+ *      red. §2 asks for "open PRs and their CI state", which needs
+ *      `statusCheckRollup` on the PR query. github.ts exports no runner to
+ *      borrow (`runGh` is private), so the query is issued here.
+ *   2. FAILURE vs EMPTY. `listPrs()`/`listIssues()` return `[]` both when gh
+ *      fails and when nothing is open. An operator staring at an empty panel
+ *      must be able to tell "nothing to do" from "could not look", so this
+ *      module keeps gh's null and projects it as `prsAvailable` /
+ *      `issuesAvailable`.
+ *
+ * Two `gh` calls per root, both list reads. Remote identity and default branch
+ * come from core/git.ts and cost no network at all.
+ *
+ * ── NO URL LEAVES THIS MODULE ──────────────────────────────────────────────
+ * `resolveGitHubOriginAuthorityDetails()` returns fetch/push URLs, and a
+ * supported GitHub HTTPS transport may carry credentials in its userinfo. Only
+ * `nameWithOwner` is read, so no remote URL can reach a response, a log, or an
+ * SSE frame. `gh`'s own stderr is never surfaced either — a failure becomes a
+ * fixed sentence, not a passthrough of whatever the tool printed.
+ */
+import { spawnSync } from 'node:child_process';
+import { statSync } from 'node:fs';
+import { basename, isAbsolute } from 'node:path';
+import { defaultBranch, isRepo, resolveGitHubOriginAuthority } from '../git.js';
+// ---------------------------------------------------------------------------
+// Constants — mirrored from core/integrations/github.ts on purpose
+// ---------------------------------------------------------------------------
+const GH_BIN = 'gh';
+const TIMEOUT_MS = 8_000;
+/** gh refuses --limit outside 1..100 on issue list; PRs get the same bound. */
+const MIN_LIMIT = 1;
+const MAX_LIMIT = 100;
+const DEFAULT_PR_LIMIT = 20;
+const DEFAULT_ISSUE_LIMIT = 20;
+/** Refuse implausible JSON rather than walking it. Mirrors MAX_PR_VIEW_JSON_LENGTH's intent. */
+const MAX_LIST_JSON_LENGTH = 512 * 1024;
+const MAX_PATH_CHARS = 4_096;
+const MAX_TITLE_CHARS = 256;
+const MAX_URL_CHARS = 2_048;
+const MAX_STATE_CHARS = 32;
+const MAX_REF_CHARS = 256;
+const MAX_AUTHOR_CHARS = 128;
+const MAX_LABELS = 32;
+const MAX_LABEL_CHARS = 128;
+/** A rollup longer than this is summarised from the first N; GitHub caps well below. */
+const MAX_ROLLUP_ENTRIES = 200;
+const realGit = {
+    isRepo: (path) => isRepo(path),
+    defaultBranch: (path) => defaultBranch(path),
+    nameWithOwner: (path) => resolveGitHubOriginAuthority(path),
+};
+/**
+ * Same spawn shape as github.ts's private `runGh`: no shell, array args, tight
+ * timeout, colourless non-interactive env. Returns null on spawn error
+ * (including ENOENT when gh is absent), non-zero exit, or non-string stdout.
+ */
+const realGh = (cwd, args) => {
+    try {
+        const res = spawnSync(GH_BIN, [...args], {
+            cwd,
+            timeout: TIMEOUT_MS,
+            stdio: 'pipe',
+            encoding: 'utf8',
+            env: {
+                ...process.env,
+                GH_HOST: 'github.com',
+                GH_NO_UPDATE_NOTIFIER: '1',
+                GH_PROMPT_DISABLED: '1',
+                NO_COLOR: '1',
+            },
+        });
+        if (res.error)
+            return null;
+        if (res.status !== 0)
+            return null;
+        if (typeof res.stdout !== 'string')
+            return null;
+        return res.stdout.trim();
+    }
+    catch {
+        return null;
+    }
+};
+// ---------------------------------------------------------------------------
+// Small parsing helpers
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function safeJson(raw) {
+    if (!raw)
+        return null;
+    if (raw.length > MAX_LIST_JSON_LENGTH)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function boundedString(value, max) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    if (trimmed.length === 0 || trimmed.length > max)
+        return null;
+    return trimmed;
+}
+function positiveInt(value) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0)
+        return null;
+    return value;
+}
+/** gh nests author as `{ login }`; a ghost author is null. Mirrors listPrs(). */
+function authorLogin(value) {
+    if (typeof value === 'string')
+        return value.slice(0, MAX_AUTHOR_CHARS);
+    if (isRecord(value)) {
+        const login = value['login'];
+        if (typeof login === 'string')
+            return login.slice(0, MAX_AUTHOR_CHARS);
+    }
+    return '';
+}
+function clampLimit(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value))
+        return fallback;
+    return Math.min(MAX_LIMIT, Math.max(MIN_LIMIT, value));
+}
+// ---------------------------------------------------------------------------
+// Check rollup
+// ---------------------------------------------------------------------------
+const PENDING_CHECK_STATUSES = new Set([
+    'in_progress',
+    'queued',
+    'waiting',
+    'requested',
+    'pending',
+]);
+const FAILURE_CONCLUSIONS = new Set([
+    'failure',
+    'cancelled',
+    'timed_out',
+    'action_required',
+    'startup_failure',
+]);
+const SUCCESS_CONCLUSIONS = new Set(['success', 'skipped', 'neutral']);
+const PENDING_CONTEXT_STATES = new Set(['pending', 'expected']);
+const FAILURE_CONTEXT_STATES = new Set(['failure', 'error']);
+const UNKNOWN_CHECKS = {
+    state: 'unknown',
+    total: 0,
+    passed: 0,
+    failed: 0,
+    pending: 0,
+};
+/**
+ * Summarise one PR's `statusCheckRollup`.
+ *
+ * Handles both GraphQL variants gh emits: `CheckRun` (`status`/`conclusion`)
+ * and `StatusContext` (`state`). Entries of neither shape are counted as
+ * pending rather than silently dropped — an unrecognised check is not a
+ * passing one.
+ *
+ * FAILING WINS OVER PENDING, deliberately diverging from
+ * `resolveCiStatus()`'s first-match-wins scan in github.ts: that function
+ * summarises the last five workflow *runs* of a repo, where "something is
+ * running" is the useful headline. Here the operator is deciding whether to
+ * touch a specific PR, and a red check must not be hidden behind a queued one.
+ */
+export function summarizeCheckRollup(rollup) {
+    if (!Array.isArray(rollup))
+        return { ...UNKNOWN_CHECKS };
+    if (rollup.length === 0) {
+        return { state: 'none', total: 0, passed: 0, failed: 0, pending: 0 };
+    }
+    let passed = 0;
+    let failed = 0;
+    let pending = 0;
+    for (const entry of rollup.slice(0, MAX_ROLLUP_ENTRIES)) {
+        if (!isRecord(entry)) {
+            pending += 1;
+            continue;
+        }
+        const status = typeof entry['status'] === 'string' ? entry['status'].toLowerCase() : '';
+        const conclusion = typeof entry['conclusion'] === 'string' ? entry['conclusion'].toLowerCase() : '';
+        const contextState = typeof entry['state'] === 'string' ? entry['state'].toLowerCase() : '';
+        if (status) {
+            if (PENDING_CHECK_STATUSES.has(status)) {
+                pending += 1;
+            }
+            else if (FAILURE_CONCLUSIONS.has(conclusion)) {
+                failed += 1;
+            }
+            else if (status === 'completed' && conclusion && !SUCCESS_CONCLUSIONS.has(conclusion)) {
+                failed += 1;
+            }
+            else if (SUCCESS_CONCLUSIONS.has(conclusion)) {
+                passed += 1;
+            }
+            else {
+                // Completed with no conclusion yet, or a status gh has not documented.
+                pending += 1;
+            }
+            continue;
+        }
+        if (contextState) {
+            if (PENDING_CONTEXT_STATES.has(contextState))
+                pending += 1;
+            else if (FAILURE_CONTEXT_STATES.has(contextState))
+                failed += 1;
+            else if (contextState === 'success')
+                passed += 1;
+            else
+                pending += 1;
+            continue;
+        }
+        pending += 1;
+    }
+    const total = passed + failed + pending;
+    let state;
+    if (total === 0)
+        state = 'none';
+    else if (failed > 0)
+        state = 'failing';
+    else if (pending > 0)
+        state = 'pending';
+    else
+        state = 'passing';
+    return { state, total, passed, failed, pending };
+}
+// ---------------------------------------------------------------------------
+// PR + issue parsing
+// ---------------------------------------------------------------------------
+const PR_JSON_FIELDS = 'number,title,url,state,author,isDraft,headRefName,baseRefName,statusCheckRollup';
+const ISSUE_JSON_FIELDS = 'number,title,url,state,author,labels';
+/**
+ * Parse `gh pr list --json <PR_JSON_FIELDS>` output.
+ *
+ * Malformed entries are DROPPED, not defaulted — the same choice
+ * `listIssues()` makes and the opposite of `listPrs()`, which coerces a
+ * missing number to 0. A PR row that cannot name its own number or URL is not
+ * something an operator should be offered a link to.
+ */
+export function parsePrList(parsed) {
+    if (!Array.isArray(parsed))
+        return [];
+    const out = [];
+    for (const raw of parsed) {
+        if (!isRecord(raw))
+            continue;
+        const number = positiveInt(raw['number']);
+        const title = boundedString(raw['title'], MAX_TITLE_CHARS);
+        const url = boundedString(raw['url'], MAX_URL_CHARS);
+        const state = boundedString(raw['state'], MAX_STATE_CHARS);
+        if (number === null || title === null || url === null || state === null)
+            continue;
+        out.push({
+            number,
+            title,
+            url,
+            state: state.toLowerCase(),
+            author: authorLogin(raw['author']),
+            draft: raw['isDraft'] === true,
+            headRefName: boundedString(raw['headRefName'], MAX_REF_CHARS),
+            baseRefName: boundedString(raw['baseRefName'], MAX_REF_CHARS),
+            checks: summarizeCheckRollup(raw['statusCheckRollup']),
+        });
+    }
+    return out;
+}
+function parseLabels(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const raw of value.slice(0, MAX_LABELS)) {
+        const name = isRecord(raw) ? boundedString(raw['name'], MAX_LABEL_CHARS) : null;
+        if (name)
+            out.push(name);
+    }
+    return out;
+}
+/** Parse `gh issue list --json <ISSUE_JSON_FIELDS>`. Malformed entries dropped. */
+export function parseIssueList(parsed) {
+    if (!Array.isArray(parsed))
+        return [];
+    const out = [];
+    for (const raw of parsed) {
+        if (!isRecord(raw))
+            continue;
+        const number = positiveInt(raw['number']);
+        const title = boundedString(raw['title'], MAX_TITLE_CHARS);
+        const url = boundedString(raw['url'], MAX_URL_CHARS);
+        const state = boundedString(raw['state'], MAX_STATE_CHARS);
+        if (number === null || title === null || url === null || state === null)
+            continue;
+        out.push({
+            number,
+            title,
+            url,
+            state: state.toLowerCase(),
+            author: authorLogin(raw['author']),
+            labels: parseLabels(raw['labels']),
+        });
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// The reader
+// ---------------------------------------------------------------------------
+function realIsDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function emptySnapshot(path, remote, observedAt, detail) {
+    return {
+        path,
+        name: basename(path) || path,
+        remote,
+        prs: [],
+        issues: [],
+        listsRequested: false,
+        prsAvailable: false,
+        issuesAvailable: false,
+        observedAt,
+        detail,
+    };
+}
+/**
+ * Read one workspace root. Never throws, never returns a remote URL, and never
+ * mutates anything — the only subprocesses are `git` reads via core/git.ts and
+ * two `gh` list reads.
+ */
+export function readVerseGithubRepo(path, opts = {}) {
+    const now = opts.now ?? (() => new Date());
+    const observedAt = now().toISOString();
+    const gh = opts.gh ?? realGh;
+    const git = opts.git ?? realGit;
+    const isDirectory = opts.isDirectory ?? realIsDirectory;
+    const prLimit = clampLimit(opts.prLimit, DEFAULT_PR_LIMIT);
+    const issueLimit = clampLimit(opts.issueLimit, DEFAULT_ISSUE_LIMIT);
+    const notARepo = {
+        state: 'not-a-repo',
+        nameWithOwner: null,
+        defaultBranch: null,
+    };
+    if (typeof path !== 'string' || path.length === 0 || path.length > MAX_PATH_CHARS) {
+        return emptySnapshot(typeof path === 'string' ? path : '', notARepo, observedAt, 'invalid path');
+    }
+    if (!isAbsolute(path)) {
+        return emptySnapshot(path, notARepo, observedAt, 'path is not absolute');
+    }
+    if (!isDirectory(path)) {
+        return emptySnapshot(path, notARepo, observedAt, 'not a directory');
+    }
+    let repoIsGit = false;
+    try {
+        repoIsGit = git.isRepo(path);
+    }
+    catch {
+        repoIsGit = false;
+    }
+    if (!repoIsGit) {
+        return emptySnapshot(path, notARepo, observedAt, 'not a git repository');
+    }
+    let branch = null;
+    try {
+        branch = git.defaultBranch(path);
+    }
+    catch {
+        branch = null;
+    }
+    let nameWithOwner = null;
+    try {
+        nameWithOwner = git.nameWithOwner(path);
+    }
+    catch {
+        nameWithOwner = null;
+    }
+    if (!nameWithOwner) {
+        return emptySnapshot(path, { state: 'not-github', nameWithOwner: null, defaultBranch: branch }, observedAt, 'origin does not resolve to a single GitHub repository');
+    }
+    const remote = {
+        state: 'github',
+        nameWithOwner,
+        defaultBranch: branch,
+    };
+    if (opts.includeLists === false) {
+        return emptySnapshot(path, remote, observedAt, 'pull requests and issues not requested for this root');
+    }
+    const prRaw = runList(gh, path, 'pr', PR_JSON_FIELDS, prLimit);
+    const issueRaw = runList(gh, path, 'issue', ISSUE_JSON_FIELDS, issueLimit);
+    const prsAvailable = prRaw !== null;
+    const issuesAvailable = issueRaw !== null;
+    const prs = prsAvailable ? parsePrList(prRaw) : [];
+    const issues = issuesAvailable ? parseIssueList(issueRaw) : [];
+    return {
+        path,
+        name: basename(path) || path,
+        remote,
+        prs,
+        issues,
+        listsRequested: true,
+        prsAvailable,
+        issuesAvailable,
+        observedAt,
+        detail: describe(prsAvailable, issuesAvailable, prs.length, issues.length),
+    };
+}
+/** One `gh <kind> list` read. Null (not []) when gh could not answer. */
+function runList(gh, cwd, kind, fields, limit) {
+    const raw = gh(cwd, [
+        kind,
+        'list',
+        '--state',
+        'open',
+        '--limit',
+        String(limit),
+        '--json',
+        fields,
+    ]);
+    if (raw === null)
+        return null;
+    const parsed = safeJson(raw);
+    // gh answered but the payload is not a list: treat as unavailable rather
+    // than as "nothing open", which would be a lie the UI cannot detect.
+    return Array.isArray(parsed) ? parsed : null;
+}
+function describe(prsAvailable, issuesAvailable, prCount, issueCount) {
+    if (!prsAvailable && !issuesAvailable) {
+        return 'gh could not answer — it may be missing, unauthenticated, or offline';
+    }
+    const parts = [];
+    parts.push(prsAvailable ? `${prCount} open pull request${prCount === 1 ? '' : 's'}` : 'pull requests unavailable');
+    parts.push(issuesAvailable ? `${issueCount} open issue${issueCount === 1 ? '' : 's'}` : 'issues unavailable');
+    return parts.join(', ');
+}
+/** Read several roots in order, de-duplicated by path. Never throws. */
+export function readVerseGithubSnapshot(paths, opts = {}) {
+    const now = opts.now ?? (() => new Date());
+    const seen = new Set();
+    const repos = [];
+    for (const path of paths) {
+        if (typeof path !== 'string' || seen.has(path))
+            continue;
+        seen.add(path);
+        repos.push(readVerseGithubRepo(path, opts));
+    }
+    return { repos, observedAt: now().toISOString() };
+}
+//# sourceMappingURL=github-repo.js.map

package/dist/core/verse/github-repo.js.map

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

package/dist/core/verse/github-types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * core/verse/github-types.ts — the GitHub wire contract for Ashlr Verse
+ * (docs/VERSE-WORKSPACES.md §2).
+ *
+ * `src/core/integrations/github.ts` already does the hard part; none of it was
+ * reachable from Verse. These are the shapes that carry it across the wire,
+ * plus the one shape the hub never had: a DISCLOSURE of what an approved
+ * proposal of kind `pr` is about to do, computed BEFORE the operator clicks.
+ *
+ * TWO RULES ENCODED HERE RATHER THAN LEFT TO THE UI
+ *
+ * 1. NO REMOTE URL EVER APPEARS IN THESE SHAPES. A git remote URL may carry
+ *    credentials in its userinfo (`https://x-access-token:<token>@github.com/…`
+ *    is a supported GitHub transport, and core/git.ts's canonicaliser accepts
+ *    it). Repository identity therefore travels ONLY as `nameWithOwner`, which
+ *    is derived from the URL and cannot contain one. `pushUrl`/`fetchUrls` from
+ *    `resolveGitHubOriginAuthorityDetails()` are deliberately dropped on the
+ *    floor; see test/verse-github-repo.test.ts for the guard that keeps it so.
+ *
+ * 2. THE PR PLAN IS A PREDICTION, AND SAYS SO. Before apply, `branch` and
+ *    `base` are what `core/inbox/apply.ts` WOULD use; after apply they are what
+ *    it DID use, read back off `proposal.remoteHandoff`. `baseSource` and
+ *    `branchSource` name which of the two an operator is looking at, because a
+ *    disclosure that cannot distinguish a prediction from a record is not a
+ *    disclosure.
+ *
+ * Nothing here is a new source of truth — every field is a projection of state
+ * the hub already computes.
+ */
+/**
+ * Aggregate state of one pull request's check rollup.
+ *
+ * `none`    — the head commit has no checks at all.
+ * `unknown` — gh returned no rollup for this PR (old gh, partial JSON). NOT
+ *             the same as `none`, and never collapsed into it.
+ */
+export type VerseGithubCheckState = 'passing' | 'failing' | 'pending' | 'none' | 'unknown';
+/** Counts behind a `VerseGithubCheckState`, so the UI can show "3 of 9 failing". */
+export interface VerseGithubChecks {
+    state: VerseGithubCheckState;
+    total: number;
+    passed: number;
+    failed: number;
+    pending: number;
+}
+/** One open pull request, with the CI state `listPrs()` cannot supply. */
+export interface VerseGithubPr {
+    number: number;
+    title: string;
+    url: string;
+    /** gh's PR state, lowercased: `open` for everything this route returns. */
+    state: string;
+    /** Login, or `''` for a ghost/deleted author — never null, mirroring listPrs(). */
+    author: string;
+    draft: boolean;
+    headRefName: string | null;
+    baseRefName: string | null;
+    checks: VerseGithubChecks;
+}
+/** One open issue — the work a seat could be pointed at. */
+export interface VerseGithubIssue {
+    number: number;
+    title: string;
+    url: string;
+    state: string;
+    author: string;
+    labels: string[];
+}
+/**
+ * Whether a root is a git repo at all, and whether its `origin` resolves to a
+ * single GitHub repository. `not-github` covers both "no origin" and "origin
+ * points somewhere we refuse to reason about" (rewrite rules, divergent
+ * fetch/push destinations) — core/git.ts fails closed there and so do we.
+ */
+export type VerseGithubRemoteState = 'github' | 'not-github' | 'not-a-repo';
+/** Repository identity. Deliberately URL-free — see rule 1 in the header. */
+export interface VerseGithubRemote {
+    state: VerseGithubRemoteState;
+    /** Lowercase `owner/name`, or null when `state !== 'github'`. */
+    nameWithOwner: string | null;
+    /** `origin/HEAD`, else the checked-out branch, else `main`. Null when not a repo. */
+    defaultBranch: string | null;
+}
+/**
+ * Everything Verse shows for one workspace root. Reads only; never throws.
+ *
+ * THREE STATES, NOT TWO. `gh` is a synchronous subprocess with an 8 s ceiling,
+ * so a multi-root listing deliberately does not call it — it answers with
+ * `listsRequested: false` and identity only, and the UI asks for one root at a
+ * time to fill in the rest. `prsAvailable` / `issuesAvailable` then mean
+ * something narrower but honest: gh WAS asked and could not answer (absent,
+ * unauthenticated, offline, rate-limited). An empty list with `available:
+ * true` genuinely means zero open. The UI must be able to tell "nothing open"
+ * from "could not look" from "have not looked yet", and a bare `[]` collapses
+ * all three.
+ */
+export interface VerseGithubRepoSnapshot {
+    path: string;
+    name: string;
+    remote: VerseGithubRemote;
+    prs: VerseGithubPr[];
+    issues: VerseGithubIssue[];
+    /** False when this read was identity-only and gh was never invoked. */
+    listsRequested: boolean;
+    prsAvailable: boolean;
+    issuesAvailable: boolean;
+    /** ISO-8601. */
+    observedAt: string;
+    /** One short human sentence: why a list is empty or unavailable. */
+    detail: string;
+}
+/** `GET /api/verse/github` — one entry per requested/known root. */
+export interface VerseGithubSnapshot {
+    repos: VerseGithubRepoSnapshot[];
+    observedAt: string;
+}
+/**
+ * `ready`       — this is a `pr` proposal that has not been applied; branch
+ *                 and base below are the PREDICTION.
+ * `opened`      — a pull request already exists for it; the fields are a RECORD.
+ * `unavailable` — not a `pr` proposal, or it carries no repo, so there is
+ *                 nothing outward-facing to disclose.
+ */
+export type VerseGithubPrPlanState = 'ready' | 'opened' | 'unavailable';
+/** Where a field came from — prediction, or read back off the applied proposal. */
+export type VerseGithubPrPlanSource = 'predicted' | 'recorded' | 'unknown';
+/**
+ * The pre-click disclosure for an approved proposal of kind `pr`.
+ *
+ * `core/inbox/apply.ts` applies a `pr` proposal by creating the branch
+ * `ashlr/proposal/<id>` in a throwaway worktree and calling
+ * `createPr(repo, { title, body: summary, head: branch })` with NO `base` —
+ * so GitHub resolves the base to the repository's default branch. `base` below
+ * reproduces that resolution locally; `baseSource: 'predicted'` marks it as
+ * our reading of what gh will choose, not something gh was told.
+ *
+ * `publishesBranch` is true and constant for a `ready` plan: `applyPr` never
+ * runs `git push`; `gh pr create --head <branch>` publishes the branch as a
+ * side effect. An operator approving this is publishing a branch, and the
+ * disclosure says so rather than implying a local-only step.
+ */
+export interface VerseGithubPrPlan {
+    proposalId: string;
+    state: VerseGithubPrPlanState;
+    /** The proposal's kind, verbatim, so the UI need not re-derive it. */
+    kind: string;
+    /** Filesystem root the PR is opened from. */
+    repoPath: string | null;
+    /** Lowercase `owner/name` the PR will land on, when origin resolves. */
+    nameWithOwner: string | null;
+    /** Branch that will be created and published, e.g. `ashlr/proposal/prop-…`. */
+    branch: string | null;
+    branchSource: VerseGithubPrPlanSource;
+    /** Branch the PR will target. */
+    base: string | null;
+    baseSource: VerseGithubPrPlanSource;
+    /** PR title — `proposal.title`, verbatim, as `createPr` receives it. */
+    title: string | null;
+    /** First lines of the PR body (`proposal.summary`), bounded. */
+    bodyPreview: string | null;
+    /** True when the body was longer than the preview. */
+    bodyTruncated: boolean;
+    /** Set once a PR exists. Null for a `ready` plan. */
+    prUrl: string | null;
+    /** True when approving this publishes a branch to the remote. */
+    publishesBranch: boolean;
+    /** One human sentence naming the outward-facing effect. */
+    detail: string;
+}
+/** `GET /api/verse/github/pr-plan` — plans for the requested proposals. */
+export interface VerseGithubPrPlanResponse {
+    plans: VerseGithubPrPlan[];
+    observedAt: string;
+}