agent-debrief 0.1.0__tar.gz

agent_debrief-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+uv.lock.bak
+
+# Node
+node_modules/
+apps/web/dist/
+*.tsbuildinfo
+
+# Built frontend that ships inside the Python wheel (produced by `npm run build:web`)
+backend/agent_debrief/web_dist/
+
+# Local data / secrets — never commit
+.agent-debrief/
+*.sqlite
+*.sqlite-wal
+*.sqlite-shm
+.env
+.env.*
+!.env.example
+secrets.json
+token
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+# Stray Windows cache folder (created by an unexpanded %SystemDrive% path)
+%SystemDrive%/

agent_debrief-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+Thanks for helping make AI-written code easier to understand. This project's one rule: **an explanation must
+point at evidence, and must never present a guess as a fact.** Please read [docs/development.md](docs/development.md)
+for setup, conventions and how to add concepts, risks, languages and agents.
+
+## Quick start
+
+```bash
+uv sync && npm install && npm run build:web
+uv run pytest && uv run ruff check backend
+npm run typecheck && npm run test:web
+```
+
+## Before you open a pull request
+
+- Tests added or updated; the whole suite passes (`uv run pytest`, `npm run test:web`).
+- `uv run ruff check backend` and `npm run typecheck` are clean.
+- API shape changes update **both** `backend/agent_debrief/models/` and `packages/shared-types/src/index.ts`,
+  and `docs/api-specification.md`.
+- New facts carry a verification status (`verified` / `agent_reported` / `inferred` / `unverified`) and an evidence
+  record. Heuristics are `inferred`; unresolvable relationships produce no edge.
+- Anything that can send data off the machine is documented in `docs/security.md`.
+- Do not claim support for an agent or language until it has been tested on a clean environment.
+
+## Good first contributions
+
+- More concepts in `communication/concepts_catalog.py` (with tests).
+- Risk heuristics in `analysis/risk_analyzer.py`.
+- Real-world Claude Code transcripts/hook payload shapes that the parser mishandles (please redact secrets).
+- Tree-sitter based analysis for another language behind the existing `ModuleInfo` shape.
+- Codex / Cursor adapters (see `docs/event-contracts.md#adding-an-agent`).
+
+## Reporting bugs
+
+Run `agent-debrief doctor` and include its output, your OS, Python version and whether the task was captured by
+hooks or imported. Please **redact** anything sensitive from logs/payloads. For security issues use a private
+advisory (see `docs/security.md`).
+
+## License
+
+By contributing you agree your contribution is licensed under the MIT License.

agent_debrief-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Debrief contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_debrief-0.1.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.5
+Name: agent-debrief
+Version: 0.1.0
+Summary: Understand what your AI coding agent actually built — summaries, flows, lessons, voice and Q&A, all backed by evidence.
+Project-URL: Homepage, https://github.com/kishore600/agent-debrief
+Project-URL: Repository, https://github.com/kishore600/agent-debrief
+Project-URL: Issues, https://github.com/kishore600/agent-debrief/issues
+Project-URL: Documentation, https://github.com/kishore600/agent-debrief/tree/main/docs
+Author: Agent Debrief contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai,claude-code,code-understanding,coding-agent,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Requires-Dist: uvicorn>=0.30
+Description-Content-Type: text/markdown
+
+# Agent Debrief
+
+**Understand what your AI coding agent actually built.**
+
+AI coding agents finish tasks faster than you can read the diff. Agent Debrief connects to your agent,
+records what it did, analyses the resulting code, and explains it five ways — every explanation tied to
+evidence, and every claim labelled as *verified*, *agent-reported*, *inferred* or *unverified*.
+
+| | Experience | What you get |
+|---|---|---|
+| 1 | **Quick Summary** | The completed task in ~30 seconds: ≤5 bullets, files, tests, risks, remaining work |
+| 2 | **Visual Flow** | The application flow (entry → handler → logic → data → response) and the agent's own execution flow |
+| 3 | **Teach Me** | The technical concepts the code uses, one at a time, at beginner / developer / advanced level |
+| 4 | **Talk to Me** | A spoken explanation you can interrupt, continue and question (optional, browser speech) |
+| 5 | **Ask Questions** | Evidence-backed answers: direct answer → code references → flow → limitations |
+
+![Dashboard](docs/images/dashboard.jpg)
+![Summary](docs/images/summary.jpg)
+![Visual flow](docs/images/visual-flow.jpg)
+
+*Screenshots show the built-in **simulated** demo session (`agent-debrief demo`), not a real agent run.*
+
+## Status
+
+`v0.1.0` — **Claude Code + Python.** Local-first, no account, no external database.
+
+| Area | State |
+|---|---|
+| Claude Code integration (hooks + transcript) | Implemented. Verified against simulated hook payloads and transcripts; **please test it on your machine** and report problems (see [Known limitations](#known-limitations)). |
+| Python analysis (AST, calls, routes, architecture) | Implemented and tested |
+| Codex, Cursor | **Not supported.** Documented placeholders only. |
+| Other languages | Not yet (changed non-Python files are listed, not analysed) |
+| AI explanations | Optional. Works fully offline with template-based explanations; add an API key for AI-written ones |
+
+## Install
+
+Requires **Python 3.11+** and **git**. Node.js is *not* needed to use the tool.
+
+```bash
+# recommended
+uv tool install agent-debrief          # or: pipx install agent-debrief
+
+agent-debrief init
+agent-debrief connect claude           # asks before touching ~/.claude/settings.json
+agent-debrief serve                    # opens http://127.0.0.1:8765
+```
+
+`debrief` is a short alias for `agent-debrief`. For installing from a source checkout and for Windows, macOS and
+Linux details, see [docs/installation.md](docs/installation.md).
+
+Want to look around first? `agent-debrief demo` creates a throw-away project and replays a *simulated*
+Claude Code session so you can explore every tab without running an agent.
+
+## How it works
+
+```
+Claude Code ──hooks──▶ event pipeline ──▶ SQLite ──▶ analysis worker ──▶ task understanding ──▶ 5 experiences
+                         (redact, normalize,          (git baseline diff,    (one common,          (local web UI)
+                          correlate, dedupe)           AST, relationships,    evidence-linked
+                                                       evidence, risks)       model)
+```
+
+1. **Hooks** (`SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`, `SessionEnd`) call a tiny
+   command that stores each event — secrets redacted — straight into a local SQLite file. The hook never
+   prints, never blocks and always exits 0.
+2. When the prompt is submitted, a **baseline** of your git working tree is snapshotted. After the agent stops,
+   only changes *since that baseline* are attributed to the task — a dirty tree is never blamed on the agent.
+3. The **understanding engine** parses changed Python (AST), resolves calls, classifies architecture layers,
+   parses test output, flags risky patterns and attaches an evidence record to every fact.
+4. The **communication engine** turns that one model into the five experiences. With an AI provider configured,
+   an LLM rewrites the wording — but it can only cite real evidence, cannot add flow edges, and any claim naming
+   something that is not in the evidence is downgraded to *unverified*.
+
+Details: [docs/architecture.md](docs/architecture.md) · [docs/event-contracts.md](docs/event-contracts.md) ·
+[docs/api-specification.md](docs/api-specification.md) · [docs/security.md](docs/security.md)
+
+## Trust model
+
+Every statement carries one of four labels:
+
+| Label | Meaning |
+|---|---|
+| **Verified** | Observed directly: a git diff, an AST fact, a recorded tool call, parsed test output |
+| **Agent reported** | The agent said so; not independently checked |
+| **Inferred** | An LLM/heuristic interpretation that cites real evidence — never presented as fact |
+| **Unverified** | No usable evidence — a hypothesis |
+
+"Completed" always means *the agent stopped*; Agent Debrief never re-runs your tests or your code.
+
+## Privacy
+
+Local-first. Nothing leaves your machine unless **you** configure an AI provider, and then only the redacted
+context shown by *AI context* on every task (you can turn off sending code and prompts separately). Hook
+installation is explicit and reversible (`agent-debrief disconnect`), and you can delete a session or all data
+from the UI or the CLI. See [docs/security.md](docs/security.md).
+
+## Commands
+
+| Command | |
+|---|---|
+| `agent-debrief init` | Create the data directory, config and database |
+| `agent-debrief connect claude` | Install the Claude Code hooks (backs up your settings first) |
+| `agent-debrief status` | Integrations, captured data, AI provider |
+| `agent-debrief sessions` | List captured tasks (`--available` lists importable Claude transcripts) |
+| `agent-debrief import` | Import past Claude Code sessions from transcripts |
+| `agent-debrief analyze <task>` | Analyse a task from the terminal (`latest` works) |
+| `agent-debrief serve` | Start the web interface (loopback only) |
+| `agent-debrief doctor` | Diagnose configuration, including a real hook self-test |
+| `agent-debrief disconnect` / `uninstall` | Remove the hooks (`--purge-data` removes everything) |
+| `agent-debrief demo` | Explore with a simulated session |
+
+## Known limitations
+
+- **Real Claude Code runs are not part of the automated tests.** The hook and transcript code follows the
+  documented formats and is tested with realistic simulated payloads; the transcript format is not a stable public
+  contract. `agent-debrief doctor` and the log at `<data dir>/logs/hook.log` help diagnose mismatches.
+- Hooks start a short Python process on state-changing tool calls and on every completed tool call
+  (typically tens of milliseconds each). `doctor` prints the measured time.
+- Static analysis is Python-only. Calls through unknown objects are not resolved (no edge is drawn) rather than guessed.
+- "Why did the agent do X?" can only be answered when the agent said why; events record *what*, not *why*.
+- Speech uses your browser's Web Speech API (quality and availability vary; Chrome/Edge/Safari). It is optional.
+- Codex and Cursor adapters are planned (release 0.6).
+
+## Development
+
+```bash
+git clone https://github.com/kishore600/agent-debrief.git && cd agent-debrief
+uv sync
+npm install && npm run build:web     # builds the UI into the Python package
+uv run agent-debrief init && uv run agent-debrief serve
+uv run pytest                        # backend tests
+npm run typecheck && npm run test:web
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/development.md](docs/development.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

agent_debrief-0.1.0/README.md

@@ -0,0 +1,139 @@
+# Agent Debrief
+
+**Understand what your AI coding agent actually built.**
+
+AI coding agents finish tasks faster than you can read the diff. Agent Debrief connects to your agent,
+records what it did, analyses the resulting code, and explains it five ways — every explanation tied to
+evidence, and every claim labelled as *verified*, *agent-reported*, *inferred* or *unverified*.
+
+| | Experience | What you get |
+|---|---|---|
+| 1 | **Quick Summary** | The completed task in ~30 seconds: ≤5 bullets, files, tests, risks, remaining work |
+| 2 | **Visual Flow** | The application flow (entry → handler → logic → data → response) and the agent's own execution flow |
+| 3 | **Teach Me** | The technical concepts the code uses, one at a time, at beginner / developer / advanced level |
+| 4 | **Talk to Me** | A spoken explanation you can interrupt, continue and question (optional, browser speech) |
+| 5 | **Ask Questions** | Evidence-backed answers: direct answer → code references → flow → limitations |
+
+![Dashboard](docs/images/dashboard.jpg)
+![Summary](docs/images/summary.jpg)
+![Visual flow](docs/images/visual-flow.jpg)
+
+*Screenshots show the built-in **simulated** demo session (`agent-debrief demo`), not a real agent run.*
+
+## Status
+
+`v0.1.0` — **Claude Code + Python.** Local-first, no account, no external database.
+
+| Area | State |
+|---|---|
+| Claude Code integration (hooks + transcript) | Implemented. Verified against simulated hook payloads and transcripts; **please test it on your machine** and report problems (see [Known limitations](#known-limitations)). |
+| Python analysis (AST, calls, routes, architecture) | Implemented and tested |
+| Codex, Cursor | **Not supported.** Documented placeholders only. |
+| Other languages | Not yet (changed non-Python files are listed, not analysed) |
+| AI explanations | Optional. Works fully offline with template-based explanations; add an API key for AI-written ones |
+
+## Install
+
+Requires **Python 3.11+** and **git**. Node.js is *not* needed to use the tool.
+
+```bash
+# recommended
+uv tool install agent-debrief          # or: pipx install agent-debrief
+
+agent-debrief init
+agent-debrief connect claude           # asks before touching ~/.claude/settings.json
+agent-debrief serve                    # opens http://127.0.0.1:8765
+```
+
+`debrief` is a short alias for `agent-debrief`. For installing from a source checkout and for Windows, macOS and
+Linux details, see [docs/installation.md](docs/installation.md).
+
+Want to look around first? `agent-debrief demo` creates a throw-away project and replays a *simulated*
+Claude Code session so you can explore every tab without running an agent.
+
+## How it works
+
+```
+Claude Code ──hooks──▶ event pipeline ──▶ SQLite ──▶ analysis worker ──▶ task understanding ──▶ 5 experiences
+                         (redact, normalize,          (git baseline diff,    (one common,          (local web UI)
+                          correlate, dedupe)           AST, relationships,    evidence-linked
+                                                       evidence, risks)       model)
+```
+
+1. **Hooks** (`SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`, `SessionEnd`) call a tiny
+   command that stores each event — secrets redacted — straight into a local SQLite file. The hook never
+   prints, never blocks and always exits 0.
+2. When the prompt is submitted, a **baseline** of your git working tree is snapshotted. After the agent stops,
+   only changes *since that baseline* are attributed to the task — a dirty tree is never blamed on the agent.
+3. The **understanding engine** parses changed Python (AST), resolves calls, classifies architecture layers,
+   parses test output, flags risky patterns and attaches an evidence record to every fact.
+4. The **communication engine** turns that one model into the five experiences. With an AI provider configured,
+   an LLM rewrites the wording — but it can only cite real evidence, cannot add flow edges, and any claim naming
+   something that is not in the evidence is downgraded to *unverified*.
+
+Details: [docs/architecture.md](docs/architecture.md) · [docs/event-contracts.md](docs/event-contracts.md) ·
+[docs/api-specification.md](docs/api-specification.md) · [docs/security.md](docs/security.md)
+
+## Trust model
+
+Every statement carries one of four labels:
+
+| Label | Meaning |
+|---|---|
+| **Verified** | Observed directly: a git diff, an AST fact, a recorded tool call, parsed test output |
+| **Agent reported** | The agent said so; not independently checked |
+| **Inferred** | An LLM/heuristic interpretation that cites real evidence — never presented as fact |
+| **Unverified** | No usable evidence — a hypothesis |
+
+"Completed" always means *the agent stopped*; Agent Debrief never re-runs your tests or your code.
+
+## Privacy
+
+Local-first. Nothing leaves your machine unless **you** configure an AI provider, and then only the redacted
+context shown by *AI context* on every task (you can turn off sending code and prompts separately). Hook
+installation is explicit and reversible (`agent-debrief disconnect`), and you can delete a session or all data
+from the UI or the CLI. See [docs/security.md](docs/security.md).
+
+## Commands
+
+| Command | |
+|---|---|
+| `agent-debrief init` | Create the data directory, config and database |
+| `agent-debrief connect claude` | Install the Claude Code hooks (backs up your settings first) |
+| `agent-debrief status` | Integrations, captured data, AI provider |
+| `agent-debrief sessions` | List captured tasks (`--available` lists importable Claude transcripts) |
+| `agent-debrief import` | Import past Claude Code sessions from transcripts |
+| `agent-debrief analyze <task>` | Analyse a task from the terminal (`latest` works) |
+| `agent-debrief serve` | Start the web interface (loopback only) |
+| `agent-debrief doctor` | Diagnose configuration, including a real hook self-test |
+| `agent-debrief disconnect` / `uninstall` | Remove the hooks (`--purge-data` removes everything) |
+| `agent-debrief demo` | Explore with a simulated session |
+
+## Known limitations
+
+- **Real Claude Code runs are not part of the automated tests.** The hook and transcript code follows the
+  documented formats and is tested with realistic simulated payloads; the transcript format is not a stable public
+  contract. `agent-debrief doctor` and the log at `<data dir>/logs/hook.log` help diagnose mismatches.
+- Hooks start a short Python process on state-changing tool calls and on every completed tool call
+  (typically tens of milliseconds each). `doctor` prints the measured time.
+- Static analysis is Python-only. Calls through unknown objects are not resolved (no edge is drawn) rather than guessed.
+- "Why did the agent do X?" can only be answered when the agent said why; events record *what*, not *why*.
+- Speech uses your browser's Web Speech API (quality and availability vary; Chrome/Edge/Safari). It is optional.
+- Codex and Cursor adapters are planned (release 0.6).
+
+## Development
+
+```bash
+git clone https://github.com/kishore600/agent-debrief.git && cd agent-debrief
+uv sync
+npm install && npm run build:web     # builds the UI into the Python package
+uv run agent-debrief init && uv run agent-debrief serve
+uv run pytest                        # backend tests
+npm run typecheck && npm run test:web
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/development.md](docs/development.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

agent_debrief-0.1.0/apps/web/index.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="color-scheme" content="light dark" />
+    <meta name="description" content="Understand what your AI coding agent actually built." />
+    <title>Agent Debrief</title>
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='8' fill='%234f46e5'/%3E%3Cpath d='M9 11h14M9 16h9M9 21h14' stroke='white' stroke-width='2.4' stroke-linecap='round'/%3E%3C/svg%3E"
+    />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

agent_debrief-0.1.0/apps/web/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@agent-debrief/web",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Agent Debrief local web interface (React + TypeScript).",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.json --noEmit && vite build",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.node.json --noEmit",
+    "test": "vitest run",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@agent-debrief/shared-types": "*",
+    "@dagrejs/dagre": "1.1.8",
+    "@tanstack/react-query": "5.106.1",
+    "@xyflow/react": "12.12.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-router-dom": "6.30.6"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.43",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.7",
+    "@vitejs/plugin-react": "4.7.0",
+    "typescript": "5.9.3",
+    "vite": "5.4.21",
+    "vitest": "2.1.9"
+  }
+}

agent_debrief-0.1.0/apps/web/src/App.tsx

@@ -0,0 +1,25 @@
+import { Route, Routes } from "react-router-dom";
+import { AppLayout } from "@/layouts/AppLayout";
+import { DashboardPage } from "@/pages/DashboardPage";
+import { NotFoundPage } from "@/pages/NotFoundPage";
+import { ProjectsPage } from "@/pages/ProjectsPage";
+import { SessionDetailPage } from "@/pages/SessionDetailPage";
+import { SessionsPage } from "@/pages/SessionsPage";
+import { SettingsPage } from "@/pages/SettingsPage";
+import { TaskPage } from "@/pages/TaskPage";
+
+export function App() {
+  return (
+    <Routes>
+      <Route element={<AppLayout />}>
+        <Route index element={<DashboardPage />} />
+        <Route path="sessions" element={<SessionsPage />} />
+        <Route path="sessions/:id" element={<SessionDetailPage />} />
+        <Route path="projects" element={<ProjectsPage />} />
+        <Route path="settings" element={<SettingsPage />} />
+        <Route path="tasks/:taskId/:tab?" element={<TaskPage />} />
+        <Route path="*" element={<NotFoundPage />} />
+      </Route>
+    </Routes>
+  );
+}

agent_debrief-0.1.0/apps/web/src/components/ClaimList.tsx

@@ -0,0 +1,43 @@
+import type { Claim } from "@agent-debrief/shared-types";
+import { VerificationBadge } from "./badges";
+import { EvidenceChips } from "./evidence";
+import { Icon } from "./Icon";
+
+export function UnverifiedMentions({ mentions }: { mentions: readonly string[] }) {
+  if (mentions.length === 0) return null;
+  return (
+    <p className="mention-warning" role="note">
+      <Icon name="alert" size={13} /> Not found in this task's evidence:{" "}
+      {mentions.map((m, i) => (
+        <span key={m}>
+          {i > 0 ? ", " : ""}
+          <code>{m}</code>
+        </span>
+      ))}
+    </p>
+  );
+}
+
+export function ClaimItem({ claim }: { claim: Claim }) {
+  return (
+    <div className="claim">
+      <div>{claim.text}</div>
+      <div className="row" style={{ gap: "0.5rem" }}>
+        <VerificationBadge status={claim.verification_status} compact />
+        <EvidenceChips ids={claim.evidence_ids} />
+      </div>
+      <UnverifiedMentions mentions={claim.unverified_mentions} />
+    </div>
+  );
+}
+
+export function ClaimList({ claims, empty }: { claims: readonly Claim[]; empty?: string }) {
+  if (claims.length === 0) return empty ? <p className="muted" style={{ padding: "0.9rem 1.1rem" }}>{empty}</p> : null;
+  return (
+    <div>
+      {claims.map((claim, i) => (
+        <ClaimItem key={i} claim={claim} />
+      ))}
+    </div>
+  );
+}

agent_debrief-0.1.0/apps/web/src/components/CodeBlock.tsx

@@ -0,0 +1,81 @@
+import { useState } from "react";
+import { Icon } from "./Icon";
+
+interface CodeBlockProps {
+  code: string;
+  caption?: string;
+  /** Show line numbers starting here. */
+  startLine?: number | null;
+  language?: string | null;
+  maxHeight?: number;
+}
+
+export function CodeBlock({ code, caption, startLine, language, maxHeight }: CodeBlockProps) {
+  const [copied, setCopied] = useState(false);
+  const lines = code.replace(/\n$/, "").split("\n");
+
+  const copy = async () => {
+    try {
+      await navigator.clipboard.writeText(code);
+      setCopied(true);
+      window.setTimeout(() => setCopied(false), 1500);
+    } catch {
+      // Clipboard may be unavailable (insecure context); ignore.
+    }
+  };
+
+  return (
+    <figure style={{ margin: 0 }}>
+      <div className="code-caption">
+        <span className="mono break">{caption ?? language ?? ""}</span>
+        <button type="button" className="btn btn--ghost btn--sm" onClick={copy}>
+          <Icon name={copied ? "check" : "file"} size={14} />
+          {copied ? "Copied" : "Copy"}
+        </button>
+      </div>
+      <div className="code" style={maxHeight ? { maxHeight } : undefined} tabIndex={0} role="region" aria-label={caption ?? "Code"}>
+        <pre>
+          <code style={{ background: "none", padding: 0 }}>
+            {lines.map((line, i) => (
+              <span key={i} style={{ display: "block" }}>
+                {startLine != null ? <span className="ln">{startLine + i}</span> : null}
+                {line || " "}
+              </span>
+            ))}
+          </code>
+        </pre>
+      </div>
+    </figure>
+  );
+}
+
+/** Unified diff with +/- colouring. Colour is reinforced by the leading +/- characters. */
+export function DiffView({ diff, truncated }: { diff: string; truncated?: boolean }) {
+  const lines = diff.replace(/\n$/, "").split("\n");
+  return (
+    <figure style={{ margin: 0 }}>
+      <div className="code" tabIndex={0} role="region" aria-label="Unified diff">
+        <pre style={{ padding: "0.5rem 0" }}>
+          {lines.map((line, i) => {
+            let cls = "diff-line";
+            if (line.startsWith("@@")) cls += " diff-line--hunk";
+            else if (line.startsWith("+++") || line.startsWith("---") || line.startsWith("diff ") || line.startsWith("index "))
+              cls += " diff-line--meta";
+            else if (line.startsWith("+")) cls += " diff-line--add";
+            else if (line.startsWith("-")) cls += " diff-line--del";
+            return (
+              <span key={i} className={cls}>
+                {line || " "}
+              </span>
+            );
+          })}
+        </pre>
+      </div>
+      {truncated ? (
+        <p className="faint small" style={{ marginTop: 6 }}>
+          Diff truncated — only the first part is shown.
+        </p>
+      ) : null}
+    </figure>
+  );
+}