assisted-review 0.0.1

package/README.md

@@ -0,0 +1,195 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="web/public/logo-dark.svg" />
+    <img alt="assisted-review" src="web/public/logo.svg" width="440" />
+  </picture>
+</p>
+
+## What is assisted-review?
+
+PR review fatigue is real. Large diffs overwhelm reviewers — context gets lost, subtle bugs slip through, and reviewers rush to finish. Standard GitHub review shows everything at once with no focus and no dedicated workspace.
+
+assisted-review fetches a PR and presents it one hunk at a time in a focused browser UI. Each chunk gets its own page. Claude analyzes each chunk upfront and answers follow-up questions in a sidebar. Jira context (story + epic) appears on the overview page when configured. State persists to disk so you can resume a review across sessions.
+
+You stay in control. Claude assists.
+
+It is a standalone CLI: it fetches the PR with `gh`, parses the diff into chunks, and serves a paginated React UI from a localhost-only server. AI commentary streams from headless Claude Code. No data leaves your machine except the comments you choose to post.
+
+> Status: early / in-progress — see the [changelog](./CHANGELOG.md) for what's shipped and the [roadmap](./ROADMAP.md) for what's planned.
+
+## Requirements
+
+- Node >= 20.18
+- [`gh`](https://cli.github.com/) authenticated (`gh auth status`)
+- [`claude`](https://claude.com/claude-code) CLI on `PATH` (for AI commentary)
+- [pnpm](https://pnpm.io) — only for working on the project (not for the global install)
+
+## Install
+
+### Global install
+
+Install directly from GitHub. No clone or pnpm required. Builds on install.
+
+```bash
+npm i -g github:moui72/assisted-review
+assisted-review <owner/repo#N | PR URL>
+```
+
+To update, re-run the same `npm i -g …` command. To remove, `npm uninstall -g assisted-review`.
+
+> The install builds itself from source, which needs the dev toolchain (`vite`, `tsc`).
+> npm installs those automatically for the build and prunes them afterward. If you've
+> globally set `npm config set omit=dev`, that build step can't fetch them and the
+> install fails with e.g. `vite: not found`. In that case, install with:
+> `npm i -g --include=dev github:moui72/assisted-review`
+
+### From a checkout
+
+```bash
+pnpm install
+pnpm build:web                        # build the UI once
+pnpm cli <owner/repo#N | PR URL>      # fetch, serve, open the browser
+```
+
+Example:
+
+```bash
+pnpm cli https://github.com/owner/repo/pull/123
+```
+
+## Configuration
+
+### Jira (optional)
+
+When Jira credentials are configured, the overview page pulls the referenced story and epic from the Jira REST API. Without credentials, it shows a setup banner instead.
+
+| Variable | Required | Description |
+|---|---|---|
+| `JIRA_BASE_URL` | Yes | Base URL of your Jira instance, e.g. `https://your-org.atlassian.net` |
+| `JIRA_USER` | Yes | Your Jira account email |
+| `JIRA_TOKEN` | Yes | Jira API token |
+| `JIRA_EPIC_FIELD` | No | Epic-Link custom field ID (default: `customfield_10008`) |
+
+Variables are read from the environment with the first match winning:
+
+1. Real environment variables (always win)
+2. `$DOTENV_CONFIG_PATH`, if set
+3. `./.env` in the current directory (useful in a checkout — copy `.env.example`)
+4. `~/.assisted-review/.env` (user-global; use this for a global install)
+
+All `.env` files are gitignored.
+
+**Example `~/.assisted-review/.env`:**
+
+```ini
+JIRA_BASE_URL=https://your-org.atlassian.net
+JIRA_USER=you@example.com
+JIRA_TOKEN=your-jira-api-token
+# JIRA_EPIC_FIELD=customfield_10008
+```
+
+### State directory
+
+Review state is stored in `~/.assisted-review/` by default. Override with:
+
+```bash
+ASSISTED_REVIEW_STATE_DIR=/path/to/state
+```
+
+### Inline env vars
+
+You can pass configuration inline for a one-off run:
+
+```bash
+JIRA_BASE_URL=https://your-org.atlassian.net JIRA_USER=you@example.com JIRA_TOKEN=<token> assisted-review owner/repo#123
+```
+
+## Usage
+
+```bash
+assisted-review <owner/repo#N | PR URL>
+```
+
+### Flags
+
+| Flag | Effect |
+|---|---|
+| `--no-open` | Don't open the browser automatically |
+| `--api-only` | Serve only the API (pair with `pnpm dev:web`) |
+| `--port <n>` | Listen port (default 4319) |
+| `--mock-ai` | Fill chunks with placeholder commentary (offline use) |
+
+### Keyboard shortcuts
+
+| Key | Action |
+|---|---|
+| `→` / `j` | Next chunk |
+| `←` / `k` | Previous chunk |
+| `⌘→` / `⌘←` (Ctrl on Win/Linux) | Next / previous unread chunk |
+| `↵` | Mark viewed and advance |
+| `esc` | Mark unread |
+| `f` | Flag chunk |
+| `c` | Comment |
+| `a` | Ask Claude |
+| `?` | Show help |
+
+## Submitting
+
+When you're done reviewing, hit **Submit** in the top bar to publish to GitHub. Choose a verdict (Approve / Comment / Request changes), add an optional summary, and the drafted line comments are posted as a single PR review via `gh api`. Whole-chunk comments anchor to the chunk's last changed line.
+
+If the PR was force-pushed since you started, the head SHA the comments were drafted against is no longer valid. In that case, submission is blocked with a stale-SHA warning rather than posting mis-anchored comments. Re-fetch the PR to re-anchor your comments to the new SHA.
+
+## Architecture
+
+```
+src/         TypeScript backend (CommonJS, ts-node)
+  cli.ts        entry: parse ref → gh fetch → chunks → Jira → serve
+  fetch.ts · parse-ref.ts · parse-diff.ts   diff/PR ingestion
+  server.ts     localhost server: /api/review, /api/state, /api/action, /api/claude (SSE), /api/submit
+  state.ts      persisted review state (~/.assisted-review/<owner>-<repo>-<n>.json)
+  claude.ts     headless Claude bridge (stream-json)
+  submit.ts     publish drafted comments as a real PR review via `gh api`
+  jira.ts       Jira REST fetch (env-configured)
+web/         Vite + React + Tailwind UI → builds into dist/, served by the server
+```
+
+- **`cli.ts`** — entry point; parses the PR ref, fetches the diff and metadata, extracts Jira keys, and hands off to the server.
+- **`fetch.ts` / `parse-ref.ts` / `parse-diff.ts`** — fetch the raw diff and PR metadata via `gh`, parse the ref format, and slice the unified diff into reviewable chunks.
+- **`server.ts`** — Express server providing the REST and SSE API. Serves the pre-built React UI from `dist/` unless `--api-only` is set.
+- **`state.ts`** — loads and persists review state (viewed, flagged, comments, AI notes) as JSON in `~/.assisted-review/`.
+- **`claude.ts`** — spawns headless `claude` as a subprocess and streams JSON-formatted commentary back to the server.
+- **`submit.ts`** — assembles drafted comments into a single PR review payload and posts it via `gh api`.
+- **`jira.ts`** — fetches issue and epic data from the Jira REST API using env-configured credentials.
+
+State lives in `~/.assisted-review/` (override with `ASSISTED_REVIEW_STATE_DIR`).
+
+## Contributing
+
+### Dev setup
+
+```bash
+pnpm install
+pnpm dev        # API server on :4319 + Vite HMR on :5173
+```
+
+Open `http://localhost:5173` for the live-reloading UI. Set a default PR with `PR_REF=owner/repo#N` in `.env` (copy `.env.example`).
+
+### Scripts
+
+| Script | What it does |
+|---|---|
+| `dev` | Starts the API server and Vite HMR server concurrently |
+| `build` | Compiles TypeScript (server → `build/`) and bundles the UI (→ `dist/`) |
+| `build:web` | Builds only the React UI with Vite |
+| `test` | Runs Jest unit tests |
+| `test:watch` | Runs Jest in watch mode |
+| `lint` | Runs ESLint |
+| `format` | Runs Prettier |
+
+### Adding a language
+
+Syntax highlighting is registered in `web/src/highlight.ts`. Import the language grammar from `highlight.js` there and add it to the `hljs.registerLanguage` calls.
+
+### PRs welcome
+
+Open a PR against `main`. CI runs lint and tests on every push. Please keep commits focused and include tests for new behavior where applicable.

package/build/claude.js

@@ -0,0 +1,154 @@
+// Headless Claude bridge. Spawns `claude -p` in stream-json mode, feeds the
+// prompt on stdin, and surfaces text deltas + completion. Runs in a temp cwd
+// with tools disabled so it answers purely from the prompt (the diff), without
+// loading this project's context or touching the filesystem.
+import { spawn } from 'node:child_process';
+import { tmpdir } from 'node:os';
+const MAX_DIFF_CHARS = 12000;
+const MAX_JIRA_DESC = 1200;
+const NO_TOOLS = [
+    'Bash',
+    'Edit',
+    'Write',
+    'Read',
+    'Grep',
+    'Glob',
+    'WebFetch',
+    'WebSearch',
+    'Task',
+    'NotebookEdit',
+];
+/** Build the prompt for a chunk. Empty question → an "explain this hunk" note. */
+export function buildPrompt(chunk, kind, question) {
+    const intro = 'You are assisting a code reviewer reviewing a GitHub pull request. ' +
+        'Be concise and direct — lead with the most important point, no hedging, no preamble. ' +
+        'Answer only from the diff shown; do not use tools.';
+    const ctx = `File: ${chunk.file}\n\nDiff hunk:\n\`\`\`diff\n${chunk.diff}\n\`\`\``;
+    if (kind === 'investigation' && question.trim()) {
+        return `${intro}\n\nThe reviewer asks about this hunk: "${question.trim()}"\n\n${ctx}\n\nAnswer in 2-5 sentences or a few short bullets.`;
+    }
+    return (`${intro}\n\n${ctx}\n\n` +
+        `Flag the most important thing the reviewer should notice about this change in 2-4 sentences ` +
+        `(a risk, bug, or behavior change); if nothing stands out, say so briefly. ` +
+        `Then add a final line in exactly this format: "Suggested action: <one concrete next step>" ` +
+        `— e.g., ask the author to clarify X, request a change to Y, or verify Z. Keep the action to one sentence. ` +
+        `Do not number or add headings to the two parts.`);
+}
+function clip(s, max) {
+    return s.length > max ? s.slice(0, max) + '\n… (truncated)' : s;
+}
+/** Build the whole-PR overview prompt. Empty question → summarize; else answer it. */
+export function buildOverviewPrompt(meta, chunks, jira, question) {
+    const files = [...new Set(chunks.map((c) => c.file))];
+    const combinedDiff = clip(chunks.map((c) => c.diff).join('\n'), MAX_DIFF_CHARS);
+    const task = question.trim()
+        ? `Answer the reviewer's question about this pull request: "${question.trim()}". Be concise and concrete.`
+        : `In 3-6 sentences, orient the reviewer: summarize what this PR changes and why — the intent and the shape of the change across files. Ground it in the description and ticket if provided. No preamble, no headings, no "suggested action" line.`;
+    const parts = [
+        `You are orienting a code reviewer before they review a pull request. ${task}`,
+        `PR title: ${meta.title}`,
+    ];
+    if (meta.body.trim())
+        parts.push(`PR description:\n${clip(meta.body.trim(), 4000)}`);
+    if (jira.available && jira.issues.length) {
+        const tix = jira.issues
+            .map((i) => `${i.key} [${i.type} · ${i.status}]: ${i.summary}\n${clip(i.description, MAX_JIRA_DESC)}`)
+            .join('\n\n');
+        let block = `Linked Jira issue(s):\n${tix}`;
+        if (jira.epic)
+            block += `\n\nParent epic ${jira.epic.key}: ${jira.epic.summary}\n${clip(jira.epic.description, MAX_JIRA_DESC)}`;
+        parts.push(block);
+    }
+    parts.push(`Files changed (${files.length}): ${files.join(', ')}`);
+    parts.push(`Combined diff (may be truncated):\n\`\`\`diff\n${combinedDiff}\n\`\`\``);
+    return parts.join('\n\n');
+}
+/**
+ * Split an initial note into its observation body and the trailing
+ * "Suggested action: …" line (tolerant of markdown bold around the label).
+ */
+export function splitSuggestedAction(text) {
+    // Strip a leading enumerator/heading the model sometimes adds (e.g. "1. ").
+    const clean = (s) => s.trim().replace(/^\s*\d+\.\s+/, '');
+    const m = text.match(/\n+\s*\*{0,2}\s*suggested\s+action\s*\*{0,2}\s*:\s*\*{0,2}\s*/i);
+    if (!m || m.index === undefined)
+        return { body: clean(text) };
+    const action = text.slice(m.index + m[0].length).trim();
+    if (!action)
+        return { body: clean(text) };
+    return { body: clean(text.slice(0, m.index)), suggestedAction: action };
+}
+/** Spawn claude and stream its answer. Returns a cancel function. */
+export function streamClaude(prompt, handlers) {
+    const child = spawn('claude', [
+        '-p',
+        '--output-format',
+        'stream-json',
+        '--include-partial-messages',
+        '--verbose',
+        '--disallowed-tools',
+        ...NO_TOOLS,
+    ], { cwd: tmpdir(), stdio: ['pipe', 'pipe', 'pipe'] });
+    let buf = '';
+    let full = '';
+    let settled = false;
+    let stderr = '';
+    function finishOk(text) {
+        if (settled)
+            return;
+        settled = true;
+        handlers.onDone(text);
+    }
+    function finishErr(msg) {
+        if (settled)
+            return;
+        settled = true;
+        handlers.onError(msg);
+    }
+    child.stdout.on('data', (chunk) => {
+        buf += chunk.toString();
+        let nl;
+        while ((nl = buf.indexOf('\n')) >= 0) {
+            const line = buf.slice(0, nl);
+            buf = buf.slice(nl + 1);
+            if (!line.trim())
+                continue;
+            let ev;
+            try {
+                ev = JSON.parse(line);
+            }
+            catch {
+                continue; // ignore non-JSON noise
+            }
+            if (ev.type === 'stream_event') {
+                const inner = ev.event;
+                if (inner?.type === 'content_block_delta' && inner.delta?.type === 'text_delta') {
+                    const t = inner.delta.text ?? '';
+                    full += t;
+                    handlers.onDelta(t);
+                }
+            }
+            else if (ev.type === 'result') {
+                if (ev.is_error)
+                    finishErr(typeof ev.result === 'string' ? ev.result : 'Claude returned an error');
+                else
+                    finishOk(typeof ev.result === 'string' ? ev.result : full);
+            }
+        }
+    });
+    child.stderr.on('data', (d) => (stderr += d.toString()));
+    child.on('error', (e) => finishErr(`failed to start claude: ${e.message} (is the \`claude\` CLI installed and on PATH?)`));
+    child.on('close', (code) => {
+        if (code === 0)
+            finishOk(full);
+        else
+            finishErr(stderr.trim() || `claude exited with code ${code}`);
+    });
+    child.stdin.write(prompt);
+    child.stdin.end();
+    return () => {
+        if (!child.killed)
+            child.kill();
+    };
+}
+//# sourceMappingURL=claude.js.map

package/build/claude.js.map

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

package/build/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+// assisted-review <owner/repo#N | PR URL>
+//
+// Slice 1: fetch a PR, parse it into grouped hunks, serve a browser UI that
+// lets you navigate the chunks. No commenting/submit/Claude yet.
+//
+// Flags:
+//   --no-open    don't open the browser
+//   --api-only   serve only /api (pair with `pnpm dev:web` Vite server)
+//   --mock-ai    attach placeholder (lorem) AI commentary to each chunk
+//   --port <n>   listen port (default 4319)
+import './env.js'; // load .env before any module reads process.env
+import { execFile } from 'node:child_process';
+import { parseRef } from './parse-ref.js';
+import { startServer } from './server.js';
+import { saveState } from './state.js';
+import { loadReview } from './review.js';
+function openBrowser(url) {
+    const [cmd, args] = process.platform === 'darwin'
+        ? ['open', [url]]
+        : process.platform === 'win32'
+            ? ['cmd', ['/c', 'start', '', url]]
+            : ['xdg-open', [url]];
+    execFile(cmd, args, () => { });
+}
+function parseArgs(argv) {
+    let ref = process.env.PR_REF;
+    let noOpen = false;
+    let apiOnly = false;
+    let mockAi = false;
+    let port = 4319;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--no-open')
+            noOpen = true;
+        else if (a === '--api-only')
+            apiOnly = true;
+        else if (a === '--mock-ai')
+            mockAi = true;
+        else if (a === '--port')
+            port = Number(argv[++i]);
+        else if (!a.startsWith('-'))
+            ref = a;
+    }
+    return { ref, noOpen, apiOnly, mockAi, port };
+}
+async function main() {
+    const { ref, noOpen, apiOnly, mockAi, port } = parseArgs(process.argv.slice(2));
+    let pr;
+    try {
+        pr = parseRef(ref);
+    }
+    catch (err) {
+        console.error(`error: ${err.message}`);
+        console.error('usage: assisted-review <owner/repo#N | PR URL>');
+        process.exit(2);
+    }
+    console.error(`Fetching ${pr.owner}/${pr.repo}#${pr.number} ...`);
+    let review, state;
+    try {
+        ({ review, state } = await loadReview(pr, { mockAi }));
+        console.error(`Parsed ${review.chunks.length} chunk(s) across the diff.`);
+        const jira = review.overview.jira;
+        const keys = jira.keys;
+        if (keys.length) {
+            console.error(jira.available
+                ? `Jira: linked ${jira.issues.map((i) => i.key).join(', ') || '(none fetched)'}${jira.epic ? ` · epic ${jira.epic.key}` : ''}.`
+                : `Jira: unavailable (${jira.reason}). Overview will show a setup banner.`);
+        }
+    }
+    catch (err) {
+        console.error(`error: failed to fetch/parse PR: ${err.message}`);
+        console.error('hint: is `gh` installed and authenticated? try `gh auth status`.');
+        process.exit(1);
+    }
+    const priorCount = state.comments.length + state.flagged.length + state.viewed.length;
+    if (priorCount > 0) {
+        console.error(`Resumed state: ${state.comments.length} comment(s), ${state.flagged.length} flagged, ${state.viewed.length} viewed.`);
+    }
+    await saveState(state);
+    const { url } = await startServer({ review, state }, { port, serveUi: !apiOnly, mockAi });
+    if (apiOnly) {
+        console.error(`\n  assisted-review API serving at ${url}/api/review`);
+        console.error(`  Start the UI with: pnpm dev:web  (proxies /api here)\n`);
+    }
+    else {
+        console.error(`\n  assisted-review serving at ${url}`);
+        console.error(`  ${review.meta.title}`);
+        console.error(`  Press Ctrl+C to stop.\n`);
+        if (!noOpen)
+            openBrowser(url);
+    }
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/build/cli.js.map

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

package/build/env.js

@@ -0,0 +1,26 @@
+// Load a .env file into process.env before any other module reads it. Import
+// this FIRST in the CLI entrypoint.
+//
+// dotenv never overrides a variable already present in the environment, and for
+// any given key the FIRST file that sets it wins. The list below is therefore in
+// precedence order, and a missing file is a no-op. This lets a global install
+// pick up credentials (e.g. Jira) from ~/.assisted-review/.env no matter which
+// directory `assisted-review` is run from, while a checkout's own .env still wins
+// during development.
+//
+//   1. real environment variables          (always win — dotenv won't override)
+//   2. $DOTENV_CONFIG_PATH                  (explicit override)
+//   3. ./.env                               (current dir — local / dev)
+//   4. ~/.assisted-review/.env              (user-global default; matches state root)
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { config } from 'dotenv';
+const candidates = [
+    process.env.DOTENV_CONFIG_PATH,
+    '.env',
+    join(homedir(), '.assisted-review', '.env'),
+].filter((p) => Boolean(p));
+for (const path of candidates) {
+    config({ path, quiet: true });
+}
+//# sourceMappingURL=env.js.map

package/build/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,oCAAoC;AACpC,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,sBAAsB;AACtB,EAAE;AACF,gFAAgF;AAChF,gEAAgE;AAChE,wEAAwE;AACxE,sFAAsF;AAEtF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,UAAU,GAAG;IACjB,OAAO,CAAC,GAAG,CAAC,kBAAkB;IAC9B,MAAM;IACN,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,MAAM,CAAC;CAC5C,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/build/fetch.js

@@ -0,0 +1,41 @@
+// Fetch PR diff + metadata via the `gh` CLI, then parse the diff into
+// grouped hunks (pure TS — see parse-diff.ts).
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+function ghTarget({ owner, repo, number }) {
+    return { repo: `${owner}/${repo}`, number: String(number) };
+}
+export async function fetchDiff(ref) {
+    const { repo, number } = ghTarget(ref);
+    const { stdout } = await execFileAsync('gh', ['pr', 'diff', number, '--repo', repo], {
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    return stdout;
+}
+export async function fetchMeta(ref) {
+    const { repo, number } = ghTarget(ref);
+    const fields = [
+        'title',
+        'author',
+        'baseRefName',
+        'headRefName',
+        'isDraft',
+        'url',
+        'headRefOid',
+        'body',
+    ].join(',');
+    const { stdout } = await execFileAsync('gh', ['pr', 'view', number, '--repo', repo, '--json', fields], { maxBuffer: 8 * 1024 * 1024 });
+    const raw = JSON.parse(stdout);
+    return {
+        title: raw.title,
+        author: raw.author?.login ?? 'unknown',
+        base_ref: raw.baseRefName,
+        head_ref: raw.headRefName,
+        is_draft: raw.isDraft,
+        url: raw.url,
+        head_sha: raw.headRefOid,
+        body: raw.body ?? '',
+    };
+}
+//# sourceMappingURL=fetch.js.map

package/build/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,+CAA+C;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,SAAS,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAS;IAC9C,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAU;IACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QACnF,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAU;IACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG;QACb,OAAO;QACP,QAAQ;QACR,aAAa;QACb,aAAa;QACb,SAAS;QACT,KAAK;QACL,YAAY;QACZ,MAAM;KACP,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,IAAI,EACJ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EACxD,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAC/B,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAa,CAAC;IAC3C,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS;QACtC,QAAQ,EAAE,GAAG,CAAC,WAAW;QACzB,QAAQ,EAAE,GAAG,CAAC,WAAW;QACzB,QAAQ,EAAE,GAAG,CAAC,OAAO;QACrB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,QAAQ,EAAE,GAAG,CAAC,UAAU;QACxB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;KACrB,CAAC;AACJ,CAAC"}

package/build/jira.js

@@ -0,0 +1,119 @@
+// Best-effort Jira background for the overview page. Fetches the referenced
+// story (and its epic) straight from the Jira REST API using credentials from
+// the environment — the tool is agnostic about how they're provided.
+//
+//   JIRA_BASE_URL   e.g. https://your-org.atlassian.net
+//   JIRA_USER       account email
+//   JIRA_TOKEN      API token
+//   JIRA_EPIC_FIELD optional; the "Epic Link" custom field (default customfield_10008)
+//
+// If any are missing, returns { available: false } with a setup hint so the UI
+// can show a banner instead of failing.
+const BASE_URL = (process.env.JIRA_BASE_URL ?? '').replace(/\/$/, '');
+const USER = process.env.JIRA_USER ?? '';
+const TOKEN = process.env.JIRA_TOKEN ?? '';
+const EPIC_FIELD = process.env.JIRA_EPIC_FIELD || 'customfield_10008';
+const SETUP_HINT = "assisted-review can't reach Jira. Set JIRA_BASE_URL, JIRA_USER, and JIRA_TOKEN " +
+    '(an API token) in the environment to pull in ticket and epic context.';
+/** Extract Jira issue keys (e.g. FEN-2622) from any number of text sources. */
+export function extractIssueKeys(...texts) {
+    const re = /\b[A-Z][A-Z0-9]+-\d+\b/g;
+    const seen = new Set();
+    for (const t of texts) {
+        if (!t)
+            continue;
+        for (const m of t.match(re) ?? [])
+            seen.add(m);
+    }
+    return [...seen];
+}
+function configured() {
+    return Boolean(BASE_URL && USER && TOKEN);
+}
+/** Recursively flatten Atlassian Document Format to plain text. */
+function adfToText(node) {
+    if (!node)
+        return '';
+    if (typeof node === 'string')
+        return node;
+    const n = node;
+    const kids = n.content ?? [];
+    const inner = () => kids.map(adfToText).join('');
+    switch (n.type) {
+        case 'text':
+            return n.text ?? '';
+        case 'hardBreak':
+            return '\n';
+        case 'paragraph':
+        case 'listItem':
+        case 'blockquote':
+        case 'heading':
+            return inner() + '\n';
+        case 'bulletList':
+        case 'orderedList':
+            return kids.map((c) => '  - ' + adfToText(c).trim() + '\n').join('');
+        default:
+            return inner();
+    }
+}
+async function fetchIssue(key) {
+    const auth = Buffer.from(`${USER}:${TOKEN}`).toString('base64');
+    const fields = `summary,status,issuetype,description,parent,${EPIC_FIELD}`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 8000);
+    try {
+        const res = await fetch(`${BASE_URL}/rest/api/3/issue/${encodeURIComponent(key)}?fields=${fields}`, {
+            headers: { authorization: `Basic ${auth}`, accept: 'application/json' },
+            signal: ctrl.signal,
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const f = data.fields ?? {};
+        const parent = f.parent;
+        const epicLink = f[EPIC_FIELD];
+        return {
+            key: data.key,
+            summary: f.summary ?? '',
+            status: f.status?.name ?? '',
+            type: f.issuetype?.name ?? '',
+            description: adfToText(f.description).trim(),
+            url: `${BASE_URL}/browse/${data.key}`,
+            epic_key: (typeof epicLink === 'string' ? epicLink : undefined) ?? parent?.key,
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Build the Jira context for the given issue keys (best effort). */
+export async function buildJiraContext(keys) {
+    if (!configured()) {
+        return {
+            available: false,
+            reason: 'Jira credentials not configured',
+            setup_hint: SETUP_HINT,
+            keys,
+            issues: [],
+        };
+    }
+    if (keys.length === 0)
+        return { available: true, keys, issues: [] };
+    const issues = (await Promise.all(keys.slice(0, 4).map(fetchIssue))).filter((i) => i !== null);
+    if (issues.length === 0) {
+        return {
+            available: false,
+            reason: `Could not fetch ${keys.join(', ')} (check JIRA_TOKEN scope and access)`,
+            setup_hint: SETUP_HINT,
+            keys,
+            issues: [],
+        };
+    }
+    const epicKey = issues.find((i) => i.epic_key)?.epic_key;
+    const epic = epicKey ? await fetchIssue(epicKey) : null;
+    return { available: true, keys, issues, epic };
+}
+//# sourceMappingURL=jira.js.map