saga-cli 0.2.0__tar.gz → 0.3.1__tar.gz

saga_cli-0.3.1/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv run *)",
+      "Bash(.venv/bin/python -m pytest tests/test_comments.py -q)"
+    ]
+  }
+}

{saga_cli-0.2.0 → saga_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: saga-cli
-Version: 0.2.0
+Version: 0.3.1
 Summary: Generate a self-contained static HTML saga of a git diff — a chapter-by-chapter guided tour of a change.
 Project-URL: Homepage, https://github.com/JakeBeresford/saga
 Project-URL: Repository, https://github.com/JakeBeresford/saga
@@ -42,6 +42,8 @@ the data). Open it offline, email it, commit it, or drop it on any static host.
 
 - Python 3.11+
 - `git`
+- The [`gh`](https://cli.github.com) CLI, authenticated — only for reviewing a PR
+  by URL (`saga <pr-url>`) or pushing review comments
 - An API key for your chosen provider, in the standard environment variable:
   `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, or `OPENROUTER_API_KEY` — or a running
   local server (Ollama / LM Studio) and no key, with a `local/` model
@@ -83,14 +85,32 @@ Run it from anywhere with `--repo`:
 saga --repo ~/src/some-project --base main --head my-feature -o out.html
 ```
 
+### From a GitHub PR URL
+
+Point saga straight at a pull request by passing its URL as the first argument.
+No checkout is needed and it works from any directory:
+
+```sh
+saga https://github.com/owner/repo/pull/5
+saga https://github.com/owner/repo/pull/5 --model openai/gpt-4o -o pr5.html
+```
+
+This fetches the PR's diff, commits, and branch names with the
+[`gh`](https://cli.github.com) CLI (so `gh` must be installed and authenticated),
+then builds the saga exactly as it would for a local branch. In this mode the PR
+defines the change set, so `--base`, `--head`, and `--repo` are ignored.
+
+The optional positional argument is a GitHub PR URL (as above); all flags below
+apply to both modes.
+
 | Flag                   | Default                     | Meaning                                                                                            |
 | ---------------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
-| `--base`               | `main`                      | Base ref to diff against                                                                           |
-| `--head`               | current branch              | Head ref to walk through                                                                           |
+| `--base`               | auto-detected               | Base ref to diff against (defaults to the repo's default branch, e.g. `origin/main`); local mode only |
+| `--head`               | current branch              | Head ref to walk through; local mode only                                                          |
 | `--intent PATH`        | —                           | Optional plan/spec describing the change's intent, for plan-aware narration and deviation flagging |
 | `--model`              | `anthropic/claude-opus-4-8` | `provider/model` string (see [Providers](#providers)); also `$SAGA_MODEL`                          |
 | `-o, --output`         | `saga.html`                 | Output file                                                                                        |
-| `--repo`               | cwd                         | A path inside the target git repo                                                                  |
+| `--repo`               | cwd                         | A path inside the target git repo; local mode only                                                |
 | `--open` / `--no-open` | on                          | Open the result in a browser (on by default; `--no-open` to disable)                               |
 
 ## Providers
@@ -156,7 +176,7 @@ boots an agent per run) and subject to your subscription's usage limits.
 
 ## As a Claude Code skill
 
-The `skills/` directory contains two Claude Code skills. To install both:
+The `skills/` directory contains a Claude Code skill. To install it:
 
 ```sh
 cp -R "$(pwd)/skills" ~/.claude/skills/saga
@@ -164,8 +184,6 @@ cp -R "$(pwd)/skills" ~/.claude/skills/saga
 
 - **`saga`** — say **"/saga"** (or "give me a walkthrough of this branch") to generate a
   saga. It resolves the base/head refs and runs the tool for you.
-- **`saga-comments`** — say **"/saga-comments"** (or "address the saga comments") to read an
-  exported `saga.comments.json` and act on the reviewer's feedback in code.
 
 ## Reviewing: comments
 
@@ -175,26 +193,28 @@ kinds of comments — **inline** (click a line's number in any chapter's diff),
 (the box at the top of the Chapters list). Comments are drafted in your browser's
 `localStorage`, so they survive a reload.
 
-When you're done, click **Export comments** to download a `saga.comments.json` sidecar next
-to the HTML. (Export is disabled in the [hosted example](https://jakeberesford.github.io/saga/example.html)
-so it never writes a file — every other part of the review UX works.) Two commands consume it:
+When you're done, click one of the copy buttons. Each puts a ready-to-run command on your
+clipboard with the comments encoded inline (`--data`), so there's no file to find on disk —
+paste it wherever you need it:
 
 ```sh
-# Post everything as a single PENDING review on the PR (you submit it on GitHub).
-saga comments push --comments saga.comments.json
+# "Copy for GitHub" → post everything as a single PENDING review (you submit it on GitHub).
+saga comments push --data <base64>
 
-# Emit the comments as JSON on stdout — for a coding agent to act on.
-saga comments read --comments saga.comments.json
+# "Copy for agent" → emit the comments as JSON on stdout for a coding agent to act on.
+saga comments read --data <base64>
 ```
 
-`push` uses the `gh` CLI: it finds the open PR for the sidecar's branch and creates one
+Prefer a file? Both commands also accept `--comments <path>` for a `saga.comments.json` you
+write yourself (handy for scripting). `push` uses the `gh` CLI: it finds the open PR for the branch and creates one
 pending review (inline → line comments, per-file → a note anchored to the file's first
 changed line, overall → the review body). Nothing is submitted until you review and submit
 it on GitHub. Requires the [`gh`](https://cli.github.com) CLI, authenticated.
 
 ## How it works
 
-1. `diff.py` computes `git diff base...head` (no checkout) and the commit list.
+1. `diff.py` computes `git diff base...head` (no checkout) and the commit list —
+   or, given a PR URL, fetches the same diff and metadata from GitHub via `gh`.
 2. `model.py` splits the diff into stable-id hunks (`h0, h1, …`).
 3. `generate.py` sends the labeled diff + commits (+ optional intent) to the chosen
    model via `instructor`, which returns chapters as schema-validated JSON. Coverage

{saga_cli-0.2.0 → saga_cli-0.3.1}/README.md

@@ -15,6 +15,8 @@ the data). Open it offline, email it, commit it, or drop it on any static host.
 
 - Python 3.11+
 - `git`
+- The [`gh`](https://cli.github.com) CLI, authenticated — only for reviewing a PR
+  by URL (`saga <pr-url>`) or pushing review comments
 - An API key for your chosen provider, in the standard environment variable:
   `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, or `OPENROUTER_API_KEY` — or a running
   local server (Ollama / LM Studio) and no key, with a `local/` model
@@ -56,14 +58,32 @@ Run it from anywhere with `--repo`:
 saga --repo ~/src/some-project --base main --head my-feature -o out.html
 ```
 
+### From a GitHub PR URL
+
+Point saga straight at a pull request by passing its URL as the first argument.
+No checkout is needed and it works from any directory:
+
+```sh
+saga https://github.com/owner/repo/pull/5
+saga https://github.com/owner/repo/pull/5 --model openai/gpt-4o -o pr5.html
+```
+
+This fetches the PR's diff, commits, and branch names with the
+[`gh`](https://cli.github.com) CLI (so `gh` must be installed and authenticated),
+then builds the saga exactly as it would for a local branch. In this mode the PR
+defines the change set, so `--base`, `--head`, and `--repo` are ignored.
+
+The optional positional argument is a GitHub PR URL (as above); all flags below
+apply to both modes.
+
 | Flag                   | Default                     | Meaning                                                                                            |
 | ---------------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
-| `--base`               | `main`                      | Base ref to diff against                                                                           |
-| `--head`               | current branch              | Head ref to walk through                                                                           |
+| `--base`               | auto-detected               | Base ref to diff against (defaults to the repo's default branch, e.g. `origin/main`); local mode only |
+| `--head`               | current branch              | Head ref to walk through; local mode only                                                          |
 | `--intent PATH`        | —                           | Optional plan/spec describing the change's intent, for plan-aware narration and deviation flagging |
 | `--model`              | `anthropic/claude-opus-4-8` | `provider/model` string (see [Providers](#providers)); also `$SAGA_MODEL`                          |
 | `-o, --output`         | `saga.html`                 | Output file                                                                                        |
-| `--repo`               | cwd                         | A path inside the target git repo                                                                  |
+| `--repo`               | cwd                         | A path inside the target git repo; local mode only                                                |
 | `--open` / `--no-open` | on                          | Open the result in a browser (on by default; `--no-open` to disable)                               |
 
 ## Providers
@@ -129,7 +149,7 @@ boots an agent per run) and subject to your subscription's usage limits.
 
 ## As a Claude Code skill
 
-The `skills/` directory contains two Claude Code skills. To install both:
+The `skills/` directory contains a Claude Code skill. To install it:
 
 ```sh
 cp -R "$(pwd)/skills" ~/.claude/skills/saga
@@ -137,8 +157,6 @@ cp -R "$(pwd)/skills" ~/.claude/skills/saga
 
 - **`saga`** — say **"/saga"** (or "give me a walkthrough of this branch") to generate a
   saga. It resolves the base/head refs and runs the tool for you.
-- **`saga-comments`** — say **"/saga-comments"** (or "address the saga comments") to read an
-  exported `saga.comments.json` and act on the reviewer's feedback in code.
 
 ## Reviewing: comments
 
@@ -148,26 +166,28 @@ kinds of comments — **inline** (click a line's number in any chapter's diff),
 (the box at the top of the Chapters list). Comments are drafted in your browser's
 `localStorage`, so they survive a reload.
 
-When you're done, click **Export comments** to download a `saga.comments.json` sidecar next
-to the HTML. (Export is disabled in the [hosted example](https://jakeberesford.github.io/saga/example.html)
-so it never writes a file — every other part of the review UX works.) Two commands consume it:
+When you're done, click one of the copy buttons. Each puts a ready-to-run command on your
+clipboard with the comments encoded inline (`--data`), so there's no file to find on disk —
+paste it wherever you need it:
 
 ```sh
-# Post everything as a single PENDING review on the PR (you submit it on GitHub).
-saga comments push --comments saga.comments.json
+# "Copy for GitHub" → post everything as a single PENDING review (you submit it on GitHub).
+saga comments push --data <base64>
 
-# Emit the comments as JSON on stdout — for a coding agent to act on.
-saga comments read --comments saga.comments.json
+# "Copy for agent" → emit the comments as JSON on stdout for a coding agent to act on.
+saga comments read --data <base64>
 ```
 
-`push` uses the `gh` CLI: it finds the open PR for the sidecar's branch and creates one
+Prefer a file? Both commands also accept `--comments <path>` for a `saga.comments.json` you
+write yourself (handy for scripting). `push` uses the `gh` CLI: it finds the open PR for the branch and creates one
 pending review (inline → line comments, per-file → a note anchored to the file's first
 changed line, overall → the review body). Nothing is submitted until you review and submit
 it on GitHub. Requires the [`gh`](https://cli.github.com) CLI, authenticated.
 
 ## How it works
 
-1. `diff.py` computes `git diff base...head` (no checkout) and the commit list.
+1. `diff.py` computes `git diff base...head` (no checkout) and the commit list —
+   or, given a PR URL, fetches the same diff and metadata from GitHub via `gh`.
 2. `model.py` splits the diff into stable-id hunks (`h0, h1, …`).
 3. `generate.py` sends the labeled diff + commits (+ optional intent) to the chosen
    model via `instructor`, which returns chapters as schema-validated JSON. Coverage

{saga_cli-0.2.0 → saga_cli-0.3.1}/docs/example.html

@@ -520,8 +520,8 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
 // diff). This file renders it — a table of contents (the entry point) and a
 // chapter reader — tracks per-chapter mark-as-read in localStorage, and lets a
 // reviewer leave inline / per-file / overall comments (also drafted in
-// localStorage) that Export downloads as a saga.comments.json sidecar. No
-// server, no fetch.
+// localStorage) that the Copy buttons hand off to the `saga comments` CLI as a
+// base64 `--data` payload. No server, no fetch.
 
 (function () {
   const data = window.__sagaData || {chapters: [], verdict: null, branch: ''};
@@ -588,7 +588,7 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
     localStorage.setItem(readKey(), JSON.stringify([...s]));
   }
 
-  // --- comments (localStorage draft, exported as a sidecar) ----------
+  // --- comments (localStorage draft, copied to the CLI as --data) ----
 
   let comments = {files: {}, overall: ''};
 
@@ -779,15 +779,64 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
     });
   }
 
-  function exportComments() {
-    // Hosted demo: export is disabled so the example never writes a
-    // saga.comments.json sidecar. The button still confirms visually.
-    const btn = $('saga-export');
-    if (!btn) return;
-    const label = btn.textContent;
-    btn.textContent = 'Exported ✓';
-    btn.disabled = true;
-    setTimeout(() => { btn.textContent = label; btn.disabled = false; }, 1500);
+  // Assemble the comments payload — the same shape the CLI validates.
+  function buildPayload() {
+    const files = {};
+    Object.keys(comments.files).forEach((p) => {
+      const e = comments.files[p];
+      const inline = (e.inline || []).filter((c) => c.body && c.body.trim());
+      const fc = (e.file_comment || '').trim();
+      if (!inline.length && !fc) return;
+      const out = {};
+      if (fc) {
+        out.file_comment = fc;
+        if (e.file_anchor) out.file_anchor = e.file_anchor;
+      }
+      if (inline.length) out.inline = inline;
+      files[p] = out;
+    });
+    return {
+      branch: data.branch || '',
+      base: data.base || '',
+      overall: (comments.overall || '').trim(),
+      files: files,
+    };
+  }
+
+  // base64(UTF-8 JSON) — the payload rides inside the copied command as
+  // `--data`, so the reviewer never has to find a file on disk.
+  function encodePayload() {
+    const bytes = new TextEncoder().encode(JSON.stringify(buildPayload()));
+    let bin = '';
+    for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
+    return btoa(bin);
+  }
+
+  function copyText(text) {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      return navigator.clipboard.writeText(text);
+    }
+    // file:// fallback where the async clipboard API is unavailable.
+    const ta = document.createElement('textarea');
+    ta.value = text;
+    ta.style.position = 'fixed';
+    ta.style.opacity = '0';
+    document.body.appendChild(ta);
+    ta.select();
+    try { document.execCommand('copy'); } finally { ta.remove(); }
+    return Promise.resolve();
+  }
+
+  // Copy a ready-to-run `saga comments <sub> --data …` command. The reviewer
+  // pastes it into their terminal (push) or coding agent (read).
+  function copyCommand(sub, btn) {
+    const cmd = 'saga comments ' + sub + ' --data ' + encodePayload();
+    copyText(cmd).then(() => {
+      const label = btn.dataset.label;
+      btn.textContent = 'Copied ✓';
+      btn.disabled = true;
+      setTimeout(() => { btn.textContent = label; btn.disabled = false; }, 1500);
+    });
   }
 
   // --- entry ----------------------------------------------------------
@@ -796,28 +845,65 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
     chapters = data.chapters || [];
     comments = loadComments();
     initTheme();
-    renderVerdict(data.verdict);
+    renderHead();
+    renderVerdict(data.verdict, data.stats);
     renderTOC();
   }
 
+  // --- header (title, summary, provenance) ----------------------------
+
+  function renderHead() {
+    if (data.title) $('saga-title').textContent = data.title;
+    const sum = $('saga-summary');
+    if (sum && data.summary) { sum.textContent = data.summary; sum.hidden = false; }
+    const meta = $('saga-meta');
+    if (meta) {
+      const parts = [];
+      if (data.commit_sha) parts.push(data.commit_sha.slice(0, 7));
+      const rel = relativeTime(data.generated_at);
+      if (rel) parts.push('generated ' + rel);
+      meta.textContent = parts.join(' · ');
+    }
+  }
+
+  function relativeTime(iso) {
+    if (!iso) return '';
+    const then = new Date(iso).getTime();
+    if (isNaN(then)) return '';
+    const secs = Math.round((Date.now() - then) / 1000);
+    if (secs < 60) return 'just now';
+    const units = [['year', 31536000], ['month', 2592000], ['week', 604800],
+                   ['day', 86400], ['hour', 3600], ['minute', 60]];
+    for (const [name, size] of units) {
+      const n = Math.floor(secs / size);
+      if (n >= 1) return n + ' ' + name + (n === 1 ? '' : 's') + ' ago';
+    }
+    return 'just now';
+  }
+
   // --- verdict line --------------------------------------------------
 
-  function renderVerdict(v) {
+  function renderVerdict(v, stats) {
     if (!v) return;
-    const parts = [
-      v.chapters + (v.chapters === 1 ? ' chapter' : ' chapters'),
-      v.deviations + (v.deviations === 1 ? ' deviation' : ' deviations'),
-      v.low_confidence + ' low-confidence',
-    ];
-    if (v.qa && v.qa !== 'n/a') parts.push('QA ' + v.qa);
-    $('saga-verdict').textContent = parts.join(' · ');
-    // Shift the top status rail to the loudest state present:
-    // deviation (red) > attention (amber) > clear (green).
+    // Scope segments read neutral; attention flags echo the amber rail so a
+    // reviewer can spot what needs a look. All text is generated (no user
+    // content), so building innerHTML here is injection-safe.
+    const seg = [{ t: v.chapters + (v.chapters === 1 ? ' chapter' : ' chapters') }];
+    if (stats && stats.files) seg.push({ t: stats.files + (stats.files === 1 ? ' file' : ' files') });
+    if (stats && (stats.added || stats.removed)) {
+      seg.push({ html: '<span class="saga-add">+' + (stats.added || 0) + '</span> ' +
+                       '<span class="saga-del">−' + (stats.removed || 0) + '</span>' });
+    }
+    if (v.deviations > 0) seg.push({ t: v.deviations + (v.deviations === 1 ? ' differs from plan' : ' differ from plan'), flag: true });
+    if (v.low_confidence > 0) seg.push({ t: v.low_confidence + (v.low_confidence === 1 ? ' needs a closer look' : ' need a closer look'), flag: true });
+    $('saga-verdict').innerHTML = seg
+      .map((s) => (s.html ? s.html : s.flag ? '<span class="saga-flag">' + s.t + '</span>' : s.t))
+      .join(' · ');
+    // Two-tier status rail: amber when anything is flagged, else green.
     const rail = $('saga-rail');
     if (rail) {
-      rail.classList.remove('saga-rail-ok', 'saga-rail-attn', 'saga-rail-dev');
-      if (v.deviations > 0) rail.classList.add('saga-rail-dev');
-      else if (v.low_confidence > 0 || v.qa === 'attention') rail.classList.add('saga-rail-attn');
+      rail.classList.remove('saga-rail-ok', 'saga-rail-attn');
+      if (v.deviations > 0 || v.low_confidence > 0) rail.classList.add('saga-rail-attn');
       else rail.classList.add('saga-rail-ok');
     }
   }
@@ -827,9 +913,9 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
   function badges(ch, read) {
     const out = [];
     if (ch.plan_step) out.push('<span class="saga-badge saga-plan">' + esc(ch.plan_step) + '</span>');
-    if (ch.deviation) out.push('<span class="saga-badge saga-dev">⚠ Deviation</span>');
-    if (ch.confidence === 'low') out.push('<span class="saga-badge saga-low">Low confidence</span>');
-    if (ch.qa && ch.qa.status === 'green') out.push('<span class="saga-badge saga-qa">✓ QA</span>');
+    if (ch.deviation) out.push('<span class="saga-badge saga-dev">Differs from plan</span>');
+    if (ch.confidence === 'low') out.push('<span class="saga-badge saga-low">Needs a closer look</span>');
+    if (ch.qa) out.push('<span class="saga-badge saga-qa">⚠ QA</span>');
     if (read) out.push('<span class="saga-badge saga-read">✓ Read</span>');
     return out.join('');
   }
@@ -845,7 +931,8 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
       '<textarea id="saga-overall" class="saga-cmt-input saga-overall" placeholder="Overall review comment…"></textarea>' +
       '<div class="saga-review-actions">' +
       '<span class="saga-cmt-count" id="saga-cmt-count"></span>' +
-      '<button class="saga-btn" id="saga-export">Export comments</button>' +
+      '<button class="saga-btn" id="saga-copy-agent" data-label="Copy for agent">Copy for agent</button>' +
+      '<button class="saga-btn" id="saga-copy-gh" data-label="Copy for GitHub">Copy for GitHub</button>' +
       '</div>' +
       '</div>' +
       '<h2 class="saga-toc-title">Chapters</h2>';
@@ -867,8 +954,10 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
       overall.value = comments.overall || '';
       overall.addEventListener('input', () => { comments.overall = overall.value; persist(); });
     }
-    const exp = $('saga-export');
-    if (exp) exp.addEventListener('click', exportComments);
+    const agentBtn = $('saga-copy-agent');
+    if (agentBtn) agentBtn.addEventListener('click', () => copyCommand('read', agentBtn));
+    const ghBtn = $('saga-copy-gh');
+    if (ghBtn) ghBtn.addEventListener('click', () => copyCommand('push', ghBtn));
     updateCount();
   }
 
@@ -883,13 +972,13 @@ window.__sagaData = {"branch": "tui-gui", "base": "main", "verdict": {"chapters"
     reader.hidden = false;
 
     const devBanner = ch.deviation
-      ? '<div class="saga-deviation"><strong>⚠ Deviation from plan.</strong> ' + esc(ch.deviation) + '</div>'
+      ? '<div class="saga-deviation"><strong>Differs from the plan.</strong> ' + esc(ch.deviation) + ' Worth confirming this was intentional.</div>'
       : '';
     const lowBanner = ch.confidence === 'low'
-      ? '<div class="saga-lowconf">Low confidence — this chapter needs close review.</div>'
+      ? '<div class="saga-lowconf"><strong>Needs a closer look.</strong> The walkthrough is unsure here — read the diff rather than just trusting the summary.</div>'
       : '';
-    const qaLine = ch.qa && ch.qa.note
-      ? '<div class="saga-qanote">' + (ch.qa.status === 'green' ? '✓ ' : '') + esc(ch.qa.note) + '</div>'
+    const qaLine = ch.qa
+      ? '<div class="saga-qanote">⚠ Manual QA: ' + esc(ch.qa) + '</div>'
       : '';
 
     // Class-based (not id-based) so the same nav can render at top and bottom.

{saga_cli-0.2.0 → saga_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "saga-cli"
-version = "0.2.0"
+version = "0.3.1"
 description = "Generate a self-contained static HTML saga of a git diff — a chapter-by-chapter guided tour of a change."
 readme = "README.md"
 requires-python = ">=3.11"

{saga_cli-0.2.0 → saga_cli-0.3.1}/saga/assets/base.css

@@ -17,6 +17,12 @@ body { font-family: var(--font-sans); background: var(--bg); color: var(--text);
 .d2h-file-diff { background: var(--bg); }
 .d2h-code-line-ctn, .d2h-code-line { background: var(--bg) !important; color: var(--text) !important; }
 .d2h-code-linenumber { background: var(--surface) !important; color: var(--text-faint) !important; border-color: var(--line) !important; }
+/* Wrap long lines instead of overflowing the file wrapper (its overflow:hidden
+   was clipping them). diff2html defaults to a fixed-width nowrap/pre line; here
+   the code line fills its cell and wraps, hang-indented past the
+   absolutely-positioned line-number gutter (~7.5em wide). */
+.d2h-code-line { display: block; width: auto; padding: 0 1em 0 8em; white-space: normal; }
+.d2h-code-line-ctn { display: inline; width: auto; white-space: pre-wrap; overflow-wrap: anywhere; }
 .d2h-del { background: var(--diff-del-bg) !important; }
 .d2h-ins { background: var(--diff-add-bg) !important; }
 .d2h-del .d2h-code-line-ctn { background: var(--diff-del-bg) !important; }

{saga_cli-0.2.0 → saga_cli-0.3.1}/saga/assets/saga.css

@@ -13,16 +13,42 @@
 }
 .saga-theme-toggle:hover { border-color: var(--accent); color: var(--text); }
 
-.saga-crumbs { font-size: var(--fs-sm); color: var(--text-dim); margin-bottom: 10px; }
+.saga-crumbs { font-size: var(--fs-sm); color: var(--text-dim); margin-bottom: 8px; }
 .saga-crumbs a { color: var(--accent); text-decoration: none; }
 .saga-crumbs a:hover { color: var(--accent-bright); text-decoration: underline; }
-.saga-crumb-sep { margin: 0 8px; color: var(--text-faint); }
-.saga-crumb-current { color: var(--text); }
+
+.header h1 { line-height: 1.2; }
+
+.saga-summary {
+  color: var(--text-dim);
+  font-size: var(--fs-md);
+  line-height: 1.45;
+  margin-top: 4px;
+}
+
+.saga-statusline {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  gap: 8px 24px;
+  flex-wrap: wrap;
+  margin-top: 10px;
+}
 
 .saga-verdict {
   color: var(--text-dim);
   font-size: var(--fs-sm);
-  margin-top: 6px;
+  font-family: var(--font-mono);
+  letter-spacing: var(--tracking-mono);
+}
+.saga-verdict .saga-flag { color: var(--warn); }
+/* diff add/remove hues, matching the diff body's green/red */
+.saga-verdict .saga-add { color: var(--ok); }
+.saga-verdict .saga-del { color: var(--danger); }
+
+.saga-meta {
+  color: var(--text-faint);
+  font-size: var(--fs-xs);
   font-family: var(--font-mono);
   letter-spacing: var(--tracking-mono);
 }
@@ -86,15 +112,11 @@
   border: 1px solid var(--line); color: var(--text-dim); background: var(--surface-2);
 }
 .saga-plan { color: var(--text-dim); }
-.saga-qa { color: var(--ok); border-color: var(--ok-solid); background: var(--ok-tint); }
 .saga-read { color: var(--accent); border-color: var(--accent-solid); background: var(--accent-tint); }
-/* Deviations must be loud. */
-.saga-dev {
-  color: var(--danger-ink); background: var(--danger-loud); border-color: var(--danger); font-weight: 600;
-}
-/* Low confidence flagged for close review (amber). */
-.saga-low {
-  color: var(--warn-ink); background: var(--warn); border-color: var(--warn-solid); font-weight: 600;
+/* Agent attention flags (QA, differs-from-plan, closer-look) share one calm
+   amber; the label carries the meaning, not the colour. */
+.saga-qa, .saga-dev, .saga-low {
+  color: var(--warn); border-color: var(--warn-solid); background: var(--warn-tint);
 }
 
 /* --- chapter reader --- */
@@ -120,10 +142,10 @@
 .saga-chapter-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
 .saga-chapter-title { font-size: var(--fs-xl); font-weight: 600; margin: 0; }
 
-/* Loud deviation banner. */
+/* Differs-from-plan banner (amber attention, same family as low-confidence). */
 .saga-deviation {
-  background: var(--danger-loud-bg); border: 1px solid var(--danger); border-left: 4px solid var(--danger);
-  color: var(--danger-ink); border-radius: var(--radius); padding: 12px 16px; margin: 14px 0; font-size: var(--fs-base);
+  background: var(--warn-tint); border: 1px solid var(--warn-solid); border-left: 4px solid var(--warn);
+  color: var(--warn); border-radius: var(--radius); padding: 12px 16px; margin: 14px 0; font-size: var(--fs-base);
 }
 .saga-lowconf {
   background: var(--warn-tint); border: 1px solid var(--warn-solid); border-left: 4px solid var(--warn);
@@ -139,7 +161,7 @@
   font-family: var(--font-mono); font-size: var(--fs-sm);
 }
 
-.saga-qanote { color: var(--ok); font-size: var(--fs-sm); margin: 8px 0; }
+.saga-qanote { color: var(--warn); font-size: var(--fs-sm); margin: 8px 0; }
 
 .saga-readmark {
   display: inline-flex; align-items: center; gap: 6px;
@@ -215,6 +237,11 @@
 .saga-file-cmt-panel[hidden] { display: none; }
 .saga-file-cmt-panel .saga-cmt-input { flex: 1 1 240px; min-height: 44px; }
 
+/* The clickable file path in a diff header inherits diff2html's file-name colour;
+   only the hover underline distinguishes it, keeping the header uncluttered. */
+.saga-file-link { color: inherit; text-decoration: none; }
+.saga-file-link:hover { text-decoration: underline; }
+
 /* --- narrow screens: tighten the reader gutter (the 1000px max-width already
    goes fluid below that width) and shrink the chapter title. --- */
 @media (max-width: 640px) {