Purity / rebuild guarantee test (#30)

The cache is a rebuildable index over gitea, never a source of truth (D4).
Two tests lock that invariant where the durable cache actually lives:

- packages/core: cache-purity-v0.test.ts — file-backed node:sqlite. Build the
  SQLite mirror from a gitea snapshot, capture every re-derived field, delete the
  .sqlite file, rebuild from the same snapshot, assert byte-identical. Plus a
  structural D4 guard: every issues-table column must map to a gitea field, so a
  future user-authored column can't silently break rebuild-ability.

- apps/desktop: snapshot-store.test.ts — the shipped durable cache is the JSON
  snapshot-store. Delete the file → loadSnapshot returns null (degrades to
  no-cache, never throws), which is what forces the next getSnapshot to reconcile
  fresh from gitea. Corrupt/partial files are likewise treated as no-cache.
  Stands up vitest for the desktop main process (first unit tests there);
  electron is mocked, snapshot path is injected.

No native better-sqlite3 shipped: the SQLite mirror has no consumer on any hot
path yet, so wiring it into main (native module + asarUnpack + dmg re-verify)
would add packaging risk for no runtime benefit. The purity invariant is proven
at the seam for both caches; the native driver migration is deferred until
SQLite becomes load-bearing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.env.example

@@ -0,0 +1 @@
+GITEA_TOKEN=

.gitignore

@@ -3,7 +3,15 @@ dist/
 out/
 *.log
 .DS_Store
+
+# playwright e2e artifacts
+.artifacts/
+test-results/
+playwright-report/
+.last-run.json
 .env
+.env.*
+!.env.example
 .yarn/*
 !.yarn/patches
 !.yarn/plugins

README.md

@@ -25,6 +25,20 @@ yarn test       # unit tests (vitest)
 yarn typecheck
 ```
 
+### End-to-end (Electron + Playwright)
+
+```sh
+yarn workspace @commitea/desktop e2e        # build, then drive the built app
+yarn workspace @commitea/desktop e2e:only   # reuse existing out/ build (tight loop)
+yarn workspace @commitea/desktop e2e:report # open the last HTML report
+```
+
+Tests launch the built app (`out/main/index.js`) through Playwright's
+`_electron` API — no browser project, no chromium download. Fixtures and page
+objects live in `apps/desktop/e2e/`; screenshots land in
+`e2e/.artifacts/screens/` for visual review. Page objects use user-facing
+locators (`getByRole`/`getByText`), never CSS/DOM structure.
+
 ## Conventions
 
 - Yarn 4 workspaces; ESM everywhere; `.js` extensions on relative imports

apps/desktop/README.md

@@ -0,0 +1,42 @@
+# CommiTea (desktop)
+
+An AI project manager for Gitea, as an Electron desktop app. The token stays in
+the main process (OS keychain via `safeStorage`); the renderer never sees it.
+
+## Develop
+
+```bash
+yarn dev          # electron-vite dev, HMR renderer + main (logs → desktop.log)
+yarn typecheck
+yarn e2e          # builds, then Playwright against the built main (fixtures/demo)
+```
+
+For a live pass against a real Gitea, put a token in `.env.local`
+(`GITEA_TOKEN=…`) and run `GITEA_LIVE=1 yarn e2e live-onboarding`.
+
+## Package (shareable macOS .dmg)
+
+```bash
+yarn pack         # unpacked .app for the host arch (fast sanity check) → dist/
+yarn dist         # arm64 + x64 .dmg → dist/CommiTea-<version>[-arm64].dmg
+```
+
+Config is `electron-builder.yml`. Builds are **unsigned** (no Apple certs, by
+decision) — electron-builder ad-hoc signs so the app can run, but it is not
+notarized. Bump `version` in `package.json` for a new release; keep
+`electronVersion` in `electron-builder.yml` in sync with the `electron`
+devDependency.
+
+### Installing a shared build (teammates)
+
+macOS Gatekeeper blocks unsigned apps on first launch. To open:
+
+1. Open the `.dmg` and drag **CommiTea** to **Applications**.
+2. In Applications, **right-click CommiTea → Open**, then confirm **Open** in the
+   dialog. (Double-clicking the first time just shows "cannot be opened".)
+3. It opens to the connection screen — enter your Gitea base URL, `owner/repo`,
+   and a personal access token (repo scope). Each teammate uses their own token,
+   so activity is attributed correctly. A model URL is optional; chat is disabled
+   until one is configured, everything else works without it.
+
+Grab the `-arm64` dmg on Apple Silicon, the plain one on Intel.

apps/desktop/e2e/fixtures.ts

@@ -0,0 +1,48 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import {
+  _electron as electron,
+  expect,
+  test as base,
+  type ElectronApplication,
+  type Page,
+} from '@playwright/test'
+
+import { AppPage } from './pages/app.page.js'
+
+const here = dirname(fileURLToPath(import.meta.url))
+/** The built main-process entry Playwright launches. `yarn e2e` builds it first. */
+const MAIN_ENTRY = join(here, '..', 'out', 'main', 'index.js')
+
+interface CommiteaFixtures {
+  /** The launched Electron application. */
+  electronApp: ElectronApplication
+  /** The app's first (and only) BrowserWindow, as a Playwright Page. */
+  window: Page
+  /** Page Object over the app shell. */
+  app: AppPage
+}
+
+export const test = base.extend<CommiteaFixtures>({
+  electronApp: async ({}, use) => {
+    const electronApp = await electron.launch({
+      args: [MAIN_ENTRY],
+      env: { ...process.env, NODE_ENV: 'test', COMMITEA_E2E: '1' },
+    })
+    await use(electronApp)
+    await electronApp.close()
+  },
+
+  window: async ({ electronApp }, use) => {
+    const window = await electronApp.firstWindow()
+    await window.waitForLoadState('domcontentloaded')
+    await use(window)
+  },
+
+  app: async ({ window }, use) => {
+    await use(new AppPage(window))
+  },
+})
+
+export { expect }

apps/desktop/e2e/live-backlog.spec.ts

@@ -0,0 +1,87 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { _electron as electron, expect, test } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const MAIN = join(here, '..', 'out', 'main', 'index.js')
+
+// Opt-in only (GITEA_LIVE=1). Launches WITHOUT COMMITEA_E2E so the main process
+// reconciles the real repo via .env.local, and asserts real data renders.
+test.describe('live backlog', () => {
+  test('The pot + Focus render real gitea data', async () => {
+    test.skip(!process.env.GITEA_LIVE, 'GITEA_LIVE not set — opt-in live test')
+    test.setTimeout(90_000)
+    const app = await electron.launch({ args: [MAIN], env: { ...process.env } })
+    const win = await app.firstWindow()
+    await win.waitForLoadState('domcontentloaded')
+    const rail = win.getByRole('navigation', { name: 'Primary' })
+
+    // The pot — waiting here also lets the reconcile (issues + deps + timelines) complete
+    await rail.getByRole('button', { name: 'The pot' }).click()
+    await expect(win.getByText('Gitea read client behind an injected fetch')).toBeVisible({ timeout: 20000 })
+    // Lifecycle inference (#5): columns come from the real event stream — merged
+    // work lands in Done, so that column is non-empty (proves timelines drove it,
+    // not the three-column fallback which would still show closed issues in Done).
+    await expect(win.getByText('Done', { exact: true })).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-board.png'), fullPage: true, animations: 'disabled' })
+
+    // Back to Focus — the deterministic scheduler's real Now/Next/Later. These
+    // rationale phrases are emitted only by the scheduler, never by the demo fixture.
+    await rail.getByRole('button', { name: 'Morning service' }).click()
+    await expect(win.getByText(/on the critical path|unblocks #|waits on #|· ready/).first()).toBeVisible()
+    // Real Monte Carlo cone — this headline is emitted only for real forecasts.
+    await expect(win.getByText(/80% of the open backlog lands by/)).toBeVisible()
+    await expect(win.getByText(/Cold-start priors/)).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-focus.png'), fullPage: true, animations: 'disabled' })
+
+    // Runway → calibration surface, fitted from real closed-issue actuals (#1).
+    // With <20 estimated closes the repo is honestly cold-start; the note proves
+    // the fit ran on real data, not the fixture's "calibrated on 27".
+    await rail.getByRole('button', { name: 'Runway' }).click()
+    await expect(
+      win.getByText(/cold-start priors · \d+\/20 closed issues estimated|calibrated on \d+ closed/),
+    ).toBeVisible()
+    // Real per-milestone forecasts — these milestone names come from gitea, not the
+    // fixture (Beta / Pilot-ready / v1.0). The runway shows milestones with open
+    // scope; P5 is active (P2 is fully shipped, so it's correctly omitted).
+    await expect(win.getByText(/P5 — Dogfood/)).toBeVisible()
+    // Real capacity config from pm-state (christian/stephen), not the fixture (Stephen/Ana K.)
+    await expect(win.getByText('christian', { exact: true })).toBeVisible()
+    await expect(win.getByText(/pd\/day/).first()).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-runway.png'), fullPage: true, animations: 'disabled' })
+
+    // Milestone drill-in — clicking a real (active) milestone opens its real detail
+    await win.getByText(/P5 — Dogfood/).click()
+    await expect(win.getByRole('heading', { name: 'P5 — Dogfood + polish' })).toBeVisible()
+    await expect(win.getByText(/\d+ issues · est \d+d/)).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-milestone.png'), fullPage: true, animations: 'disabled' })
+    await rail.getByRole('button', { name: 'Runway' }).click()
+
+    await win.getByRole('button', { name: 'Full report' }).click()
+    await expect(win.getByText(/cold-start · \d+\/20|curve active · n ≥ 20/)).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-calibration.png'), fullPage: true, animations: 'disabled' })
+
+    // Write path (apply_changes): open the top scheduled issue, propose an
+    // estimate change, and confirm the propose-approve diff renders — then CANCEL
+    // so the live run never mutates the real repo (the PUT is unit-tested; a
+    // one-off change→revert verified it against gitea manually).
+    await rail.getByRole('button', { name: 'Morning service' }).click()
+    await win.getByRole('main').getByRole('link').first().click()
+    await expect(win.getByText(/· stephen\/commitea/)).toBeVisible()
+    await win.getByRole('button', { name: 'Adjust' }).click()
+    await expect(win.getByText('Adjust issue')).toBeVisible()
+    await win.getByRole('combobox').first().selectOption('est/8d')
+    await expect(win.getByText('Proposed change')).toBeVisible()
+    await expect(win.getByText(/est\/8d/).last()).toBeVisible()
+    // the unified tool also drives assignee + milestone — the pickers render and diff
+    await expect(win.getByText('Assignee', { exact: true })).toBeVisible()
+    await expect(win.getByText('Milestone', { exact: true })).toBeVisible()
+    await win.getByRole('combobox').nth(2).selectOption('') // Assignee → Unassigned
+    await expect(win.getByText('unassign', { exact: true })).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-apply-change.png'), fullPage: true, animations: 'disabled' })
+    await win.getByRole('button', { name: 'Cancel' }).click() // no mutation
+
+    await app.close()
+  })
+})

apps/desktop/e2e/live-capture.spec.ts

@@ -0,0 +1,37 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { _electron as electron, expect, test } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const MAIN = join(here, '..', 'out', 'main', 'index.js')
+
+// Opt-in (GITEA_LIVE=1 + COMMITEA_MODEL_LIVE=1 + a local model on :1234). Launches
+// WITHOUT COMMITEA_E2E so capture_work runs the real decomposition. It Discards at
+// the end so the run never files junk issues (the create-issue POST is unit-tested).
+test.describe('live capture_work', () => {
+  test('decomposes a braindump into a reviewable ticket set', async () => {
+    test.skip(!process.env.GITEA_LIVE || !process.env.COMMITEA_MODEL_LIVE, 'live model test — opt-in')
+    test.setTimeout(300_000)
+    const app = await electron.launch({ args: [MAIN], env: { ...process.env } })
+    const win = await app.firstWindow()
+    await win.waitForLoadState('domcontentloaded')
+    const rail = win.getByRole('navigation', { name: 'Primary' })
+
+    await rail.getByRole('button', { name: 'Capture' }).click()
+    await expect(win.getByRole('heading', { name: 'Capture' })).toBeVisible()
+    // the braindump is prefilled; run the real decomposition
+    await win.getByRole('button', { name: 'Brew tickets' }).click()
+
+    // capture_work → the review tray with a real, estimated ticket set
+    await expect(win.getByText(/tickets · ~\d+d of work/)).toBeVisible({ timeout: 240_000 })
+    await expect(win.getByRole('button', { name: 'Approve all' })).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-capture.png'), fullPage: true, animations: 'disabled' })
+
+    // Discard — never file junk issues into the real repo from a test
+    await win.getByRole('button', { name: 'Discard' }).click()
+    await expect(win.getByRole('button', { name: 'Brew tickets' })).toBeVisible()
+
+    await app.close()
+  })
+})

apps/desktop/e2e/live-directive.spec.ts

@@ -0,0 +1,32 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { _electron as electron, expect, test } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const MAIN = join(here, '..', 'out', 'main', 'index.js')
+
+// Opt-in (GITEA_LIVE=1 + COMMITEA_MODEL_LIVE=1 + a local model + the commitea-pm-state
+// repo). Reginald records a standing directive; it's appended to the real pm-state
+// ledger. The append is idempotent-ish (a fresh line each run); this only reads back
+// that a directive was consulted, and leaves the ledger intact.
+test.describe('live record_directive', () => {
+  test('logs a standing directive to the pm-state ledger', async () => {
+    test.skip(!process.env.GITEA_LIVE || !process.env.COMMITEA_MODEL_LIVE, 'live model test — opt-in')
+    test.setTimeout(300_000)
+    const app = await electron.launch({ args: [MAIN], env: { ...process.env } })
+    const win = await app.firstWindow()
+    await win.waitForLoadState('domcontentloaded')
+    await expect(win.getByText(/· local$/)).toBeVisible({ timeout: 20000 })
+
+    const composer = win.getByPlaceholder(/Tell me what to do/)
+    await composer.fill('Record a standing directive: freeze scope for beta, pilots come first.')
+    await composer.press('Enter')
+
+    // the agent logged it to the ledger (record_directive), not applied a change
+    await expect(win.getByText(/consulted the directive ledger/)).toBeVisible({ timeout: 240_000 })
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-directive.png'), fullPage: true, animations: 'disabled' })
+
+    await app.close()
+  })
+})

apps/desktop/e2e/live-onboarding.spec.ts

@@ -0,0 +1,85 @@
+import { dirname, join } from 'node:path'
+import { mkdtempSync, readFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+
+import { _electron as electron, expect, test } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const MAIN = join(here, '..', 'out', 'main', 'index.js')
+
+/** Read the real token from .env.local (walking up) so the test can fill the form. */
+function readToken(): string | null {
+  let dir = here
+  for (let i = 0; i < 6; i++) {
+    try {
+      const m = /^GITEA_TOKEN\s*=\s*(.+?)\s*$/m.exec(readFileSync(join(dir, '.env.local'), 'utf8'))
+      if (m) return m[1].trim()
+    } catch {
+      /* keep walking */
+    }
+    dir = dirname(dir)
+  }
+  return null
+}
+
+// Opt-in (GITEA_LIVE=1). Forces the onboarding path (COMMITEA_NO_ENV_LOCAL) with a
+// fresh userData, fills the real connection form, and asserts it lands on real data.
+test.describe('live onboarding', () => {
+  test('connect form → real board', async () => {
+    const token = process.env.GITEA_LIVE ? readToken() : null
+    test.skip(!token, 'GITEA_LIVE + a .env.local token required')
+    test.setTimeout(90_000)
+
+    const app = await electron.launch({
+      args: [MAIN],
+      env: { ...process.env, COMMITEA_NO_ENV_LOCAL: '1', COMMITEA_USERDATA: mkdtempSync(join(tmpdir(), 'commitea-')) },
+    })
+    const win = await app.firstWindow()
+    await win.waitForLoadState('domcontentloaded')
+
+    // Any uncaught render error in a real-data view builder must fail the test —
+    // this is the "it actually works on real data" guarantee.
+    const pageErrors: string[] = []
+    win.on('pageerror', (e) => pageErrors.push(e.message))
+
+    // the connection gate, not the app
+    await expect(win.getByText(/Connect your Gitea/)).toBeVisible({ timeout: 15000 })
+    await win.getByPlaceholder('your-org').fill('christian')
+    await win.getByPlaceholder('your-repo').fill('commitea')
+    await win.getByPlaceholder(/gitea PAT/).fill(token!)
+    await win.getByRole('button', { name: 'Connect' }).click()
+
+    const rail = win.getByRole('navigation', { name: 'Primary' })
+    const realTitle = /Model router|SQLite cache bootstrap|Purity\/rebuild/
+
+    // Board (real reconciled columns) — real issue titles prove the sync landed.
+    await rail.getByRole('button', { name: 'The pot' }).click()
+    await expect(win.getByText(realTitle).first()).toBeVisible({ timeout: 30000 })
+
+    // Gantt tab — scheduler-derived bars over the real open backlog.
+    await win.getByRole('tab', { name: 'Gantt' }).click()
+    await expect(win.getByText(realTitle).first()).toBeVisible()
+
+    // Dependencies tab — real dep graph. Just needs to render without throwing.
+    await win.getByRole('tab', { name: 'Dependencies' }).click()
+    await win.waitForTimeout(300)
+
+    // Issue drill-in — the machine-derived sidecar (lifecycle/forecast/deps) on a real issue.
+    await win.getByRole('tab', { name: 'Board' }).click()
+    await win.getByText(realTitle).first().click()
+    await expect(win.getByText('Machine-derived')).toBeVisible()
+    await win.getByRole('button', { name: 'Back' }).click()
+
+    // Standup + Inbox — scheduler plan / nag / inbox feed over real data.
+    await rail.getByRole('button', { name: 'Standup' }).click()
+    await expect(win.getByRole('heading', { name: 'Morning standup' })).toBeVisible()
+    await rail.getByRole('button', { name: 'Inbox' }).click()
+    await expect(win.getByRole('heading', { name: 'Inbox' })).toBeVisible()
+
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-onboarding.png'), fullPage: true, animations: 'disabled' })
+    expect(pageErrors, `uncaught render errors: ${pageErrors.join(' · ')}`).toEqual([])
+
+    await app.close()
+  })
+})

apps/desktop/e2e/live-persistence.spec.ts

@@ -0,0 +1,37 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { _electron as electron, expect, test } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const MAIN = join(here, '..', 'out', 'main', 'index.js')
+
+// Opt-in (GITEA_LIVE=1). A real launch persists the snapshot; a second launch with
+// gitea unreachable must still show the board + real scheduler output from the
+// persisted cache (offline reads). No model needed.
+test.describe('live persistence', () => {
+  test('offline: serves the persisted snapshot', async () => {
+    test.skip(!process.env.GITEA_LIVE, 'GITEA_LIVE not set — opt-in live test')
+    test.setTimeout(120_000)
+
+    // launch 1 — real reconcile writes the snapshot to disk
+    const app1 = await electron.launch({ args: [MAIN], env: { ...process.env } })
+    const w1 = await app1.firstWindow()
+    await w1.waitForLoadState('domcontentloaded')
+    // a scheduler-only phrase confirms real data reconciled (never emitted by fixtures)
+    await expect(w1.getByText(/on the critical path|unblocks #|waits on #|· ready/).first()).toBeVisible({ timeout: 30000 })
+    await app1.close()
+
+    // launch 2 — gitea unreachable; the reconcile must fall back to the persisted snapshot
+    const app2 = await electron.launch({
+      args: [MAIN],
+      env: { ...process.env, GITEA_BASE_URL: 'http://127.0.0.1:9' },
+    })
+    const w2 = await app2.firstWindow()
+    await w2.waitForLoadState('domcontentloaded')
+    // Focus still renders real scheduler output — proving it came from the cache, offline
+    await expect(w2.getByText(/on the critical path|unblocks #|waits on #|· ready/).first()).toBeVisible({ timeout: 20000 })
+    await w2.screenshot({ path: join(here, '.artifacts', 'screens', 'live-offline.png'), fullPage: true, animations: 'disabled' })
+    await app2.close()
+  })
+})

apps/desktop/e2e/live-reginald.spec.ts

@@ -0,0 +1,56 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { _electron as electron, expect, test } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const MAIN = join(here, '..', 'out', 'main', 'index.js')
+
+// Opt-in (GITEA_LIVE=1 + COMMITEA_MODEL_LIVE=1 + a local model on :1234). Launches
+// WITHOUT COMMITEA_E2E so Reginald runs the real agent loop against the real repo.
+test.describe('live Reginald', () => {
+  test('answers a question by consulting the real project', async () => {
+    test.skip(!process.env.GITEA_LIVE || !process.env.COMMITEA_MODEL_LIVE, 'live model test — opt-in')
+    test.setTimeout(300_000) // a big local model is slow: ~2 calls/turn + a reconcile
+    const app = await electron.launch({ args: [MAIN], env: { ...process.env } })
+    const win = await app.firstWindow()
+    await win.waitForLoadState('domcontentloaded')
+
+    // model configured → the live greeting + header (the loaded model, not the scripted demo)
+    await expect(win.getByText(/· local$/)).toBeVisible({ timeout: 20000 })
+    await expect(win.getByText(/I check the real board before I answer/)).toBeVisible()
+
+    const composer = win.getByPlaceholder(/Tell me what to do/)
+    await composer.fill('What should I work on right now?')
+    await composer.press('Enter')
+
+    // the agent loop ran end-to-end: it consulted the project, then answered
+    await expect(win.getByText(/consulted the project/)).toBeVisible({ timeout: 240_000 })
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-reginald.png'), fullPage: true, animations: 'disabled' })
+
+    await app.close()
+  })
+
+  test('proposes an estimate change for inline approval (writes via chat)', async () => {
+    test.skip(!process.env.GITEA_LIVE || !process.env.COMMITEA_MODEL_LIVE, 'live model test — opt-in')
+    test.setTimeout(300_000)
+    const app = await electron.launch({ args: [MAIN], env: { ...process.env } })
+    const win = await app.firstWindow()
+    await win.waitForLoadState('domcontentloaded')
+    await expect(win.getByText(/· local$/)).toBeVisible({ timeout: 20000 })
+
+    const composer = win.getByPlaceholder(/Tell me what to do/)
+    await composer.fill('Set the estimate on issue #3 to est/5d.')
+    await composer.press('Enter')
+
+    // propose_change → an inline propose-approve card (never an auto-write)
+    await expect(win.getByText('Proposed · #3')).toBeVisible({ timeout: 240_000 })
+    await expect(win.getByText(/→ est\/5d/)).toBeVisible()
+    await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-reginald-propose.png'), fullPage: true, animations: 'disabled' })
+    // Dismiss so the live run never mutates the repo (the write path itself is #41-tested)
+    await win.getByRole('button', { name: 'Dismiss' }).click()
+    await expect(win.getByText(/Left #3 as it was/)).toBeVisible()
+
+    await app.close()
+  })
+})

apps/desktop/e2e/pages/app.page.ts

@@ -0,0 +1,50 @@
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { expect, type Locator, type Page } from '@playwright/test'
+
+const here = dirname(fileURLToPath(import.meta.url))
+/** Where `screenshot()` drops PNGs — gitignored, readable for visual review. */
+const SCREENS_DIR = join(here, '..', '.artifacts', 'screens')
+
+/**
+ * Page Object over the CommiTea app shell. As real screens land (P3), add
+ * per-screen page objects and accessor methods here; keep locators
+ * user-facing (getByRole/getByText), never CSS/DOM structure.
+ */
+export class AppPage {
+  constructor(readonly page: Page) {}
+
+  /** The rail wordmark — present on every in-app view. */
+  get wordmark(): Locator {
+    return this.page.getByText('CommiTea', { exact: true })
+  }
+
+  /** Navigate via a left-rail entry by its label. Scoped to the Primary rail so
+   * it never collides with in-screen breadcrumb buttons of the same name, and
+   * matches by prefix so count badges (e.g. "Inbox 3") still resolve. */
+  nav(label: string): Locator {
+    return this.page.getByRole('navigation', { name: 'Primary' }).getByRole('button', { name: label })
+  }
+
+  /** Assert the shell has rendered. */
+  async expectLoaded(): Promise<void> {
+    await expect(this.wordmark).toBeVisible()
+  }
+
+  /** Read the `commitea` preload API surface from the renderer. */
+  async preloadApi(): Promise<Record<string, unknown> | undefined> {
+    return this.page.evaluate(
+      () => (globalThis as unknown as { commitea?: Record<string, unknown> }).commitea,
+    )
+  }
+
+  /** Capture a full-page screenshot for visual review; returns the path.
+   * `animations: 'disabled'` fast-forwards finite CSS animations to their end
+   * state, so fade-in screens (e.g. Standup) capture settled, not mid-fade. */
+  async screenshot(name: string): Promise<string> {
+    const path = join(SCREENS_DIR, `${name}.png`)
+    await this.page.screenshot({ path, fullPage: true, animations: 'disabled' })
+    return path
+  }
+}

apps/desktop/e2e/smoke.spec.ts

@@ -0,0 +1,146 @@
+import { expect, test } from './fixtures.js'
+
+test('boots into the shell with the Focus screen', async ({ app, window }) => {
+  await app.expectLoaded()
+  await expect(window.getByText('Reginald', { exact: true })).toBeVisible()
+  await expect(window.getByRole('heading', { name: 'Morning service' })).toBeVisible()
+  await app.screenshot('shell-light')
+})
+
+test('Focus shows Now/Next/Later cards and the burn-up cone', async ({ window }) => {
+  for (const slot of ['Now', 'Next', 'Later']) {
+    await expect(window.getByText(slot, { exact: true })).toBeVisible()
+  }
+  await expect(window.getByText('Fix lifecycle inference on merge events')).toBeVisible()
+  await expect(window.getByText(/scope · 42 issues/)).toBeVisible()
+})
+
+test('Standup renders the drift / plan / nag letter', async ({ app, window }) => {
+  await app.nav('Standup').click()
+  await expect(window.getByRole('heading', { name: 'Morning standup' })).toBeVisible()
+  await expect(window.getByText('Overnight drift')).toBeVisible()
+  await expect(window.getByText('Stephen', { exact: true })).toBeVisible()
+  await app.screenshot('standup')
+})
+
+test('Board: columns, search filter, and Gantt/Deps tabs', async ({ app, window }) => {
+  await app.nav('The pot').click()
+  await expect(window.getByRole('heading', { name: 'The pot' })).toBeVisible()
+  await expect(window.getByText('Diagnosis', { exact: true })).toBeVisible()
+  await expect(window.getByText('Steeping', { exact: true })).toBeVisible()
+  await app.screenshot('board')
+
+  await window.getByPlaceholder(/Search the pot/).fill('lifecycle')
+  await expect(window.getByText('Fix lifecycle inference on merge events')).toBeVisible()
+  await expect(window.getByText('Dark theme: cone fill too faint')).toBeHidden()
+  await window.getByPlaceholder(/Search the pot/).fill('')
+
+  await window.getByRole('tab', { name: 'Gantt' }).click()
+  await expect(window.getByText(/80% · Mar 3–12/)).toBeVisible()
+  await app.screenshot('gantt')
+
+  await window.getByRole('tab', { name: 'Dependencies' }).click()
+  await expect(window.getByText('critical path', { exact: true })).toBeVisible()
+  await app.screenshot('deps')
+})
+
+test('Runway: milestones, capacity, and drill-ins', async ({ app, window }) => {
+  await app.nav('Runway').click()
+  await expect(window.getByRole('heading', { name: 'Runway' })).toBeVisible()
+  await expect(window.getByText('Pilot-ready')).toBeVisible()
+  await expect(window.getByText('deadline/hard')).toBeVisible()
+  await app.screenshot('runway')
+
+  // milestone drill-in
+  await window.getByText('Beta', { exact: true }).click()
+  await expect(window.getByRole('heading', { name: 'Beta' })).toBeVisible()
+  await expect(window.getByText('42 issues · est 61d')).toBeVisible()
+  await app.screenshot('milestone')
+  await window.getByRole('main').getByRole('button', { name: 'Runway' }).click()
+
+  // calibration drill-in
+  await window.getByRole('button', { name: 'Full report' }).click()
+  await expect(window.getByRole('heading', { name: 'Calibration' })).toBeVisible()
+  await expect(window.getByText('The shape of hope')).toBeVisible()
+  await app.screenshot('calibration')
+})
+
+test('Inbox: notifications and mark-all-read', async ({ app, window }) => {
+  await app.nav('Inbox').click()
+  await expect(window.getByRole('heading', { name: 'Inbox' })).toBeVisible()
+  await expect(window.getByText(/window moved/)).toBeVisible()
+  await app.screenshot('inbox')
+  await window.getByRole('button', { name: 'Mark all read' }).click()
+  await expect(window.getByText('all read · nothing here rings twice')).toBeVisible()
+})
+
+test('Capture: braindump advances to the interview', async ({ app, window }) => {
+  await app.nav('Capture').click()
+  await expect(window.getByText("Tell me what you're planning")).toBeVisible()
+  await app.screenshot('capture')
+  await window.getByRole('button', { name: 'Brew tickets' }).click()
+  await expect(window.getByText(/Interview · 1 of 3/)).toBeVisible()
+})
+
+test('Directives: consequence diff + append-only ledger', async ({ app, window }) => {
+  await app.nav('Directives').click()
+  await expect(window.getByRole('heading', { name: 'Directives' })).toBeVisible()
+  await expect(window.getByText('Consequence diff')).toBeVisible()
+  await expect(window.getByText(/append-only · JSONL in pm-state/)).toBeVisible()
+  await app.screenshot('directives')
+  // resolving the pending directive moves it into the ledger
+  await window.getByRole('button', { name: 'Make it so' }).click()
+  await expect(window.getByText('Consequence diff')).toBeHidden()
+  await expect(window.getByText(/Nothing awaits your word/)).toBeVisible()
+})
+
+test('Settings: connection, schema, and appearance sync with theme', async ({ app, window }) => {
+  await app.nav('Settings').click()
+  await expect(window.getByRole('heading', { name: 'Settings' })).toBeVisible()
+  await expect(window.getByRole('heading', { name: 'Connection' })).toBeVisible()
+  await app.screenshot('settings')
+  // the Evening (dark) radio drives the shared theme
+  await window.getByText('Evening (dark)').click()
+  await expect(window.locator('html')).toHaveAttribute('data-theme', 'dark')
+})
+
+test('Onboarding: full-window first-run flow with test gate', async ({ app, window }) => {
+  await app.nav('First run').click()
+  await expect(window.getByRole('heading', { name: 'Good morning.' })).toBeVisible()
+  // full-window: no rail wordmark link, brand only
+  await app.screenshot('onboarding')
+  await window.getByRole('button', { name: 'Begin' }).click()
+  await expect(window.getByRole('heading', { name: 'Your Gitea' })).toBeVisible()
+  // Continue is gated until the connection test passes
+  await expect(window.getByRole('button', { name: 'Continue' })).toBeDisabled()
+  await window.getByRole('button', { name: 'Test connection' }).click()
+  await expect(window.getByText(/connected · 3 repos visible/)).toBeVisible()
+  await expect(window.getByRole('button', { name: 'Continue' })).toBeEnabled()
+})
+
+test('issue drill-in from a Focus card and back-stack of one', async ({ app, window }) => {
+  await window.getByRole('link', { name: 'Fix lifecycle inference on merge events' }).click()
+  await expect(window.getByText('#87 · stephen/commitea')).toBeVisible()
+  await expect(window.getByText('Machine-derived')).toBeVisible()
+  await app.screenshot('issue')
+  await window.getByRole('button', { name: 'Back' }).click()
+  await expect(window.getByRole('heading', { name: 'Morning service' })).toBeVisible()
+})
+
+test('Evening service toggle flips the document theme', async ({ app, window }) => {
+  await window.getByText('Evening service', { exact: true }).click()
+  await expect(window.locator('html')).toHaveAttribute('data-theme', 'dark')
+  await app.screenshot('shell-dark')
+})
+
+test('offline sim shows the banner and disables the composer', async ({ window }) => {
+  await window.getByRole('button', { name: /Connection/ }).click()
+  await expect(window.getByText(/Gitea isn.t answering/)).toBeVisible()
+  await expect(window.getByRole('textbox')).toBeDisabled()
+})
+
+test('exposes the commitea preload API', async ({ app }) => {
+  const api = await app.preloadApi()
+  expect(api).toBeDefined()
+  expect(api).toHaveProperty('platform')
+})

apps/desktop/e2e/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["node"],
+    "moduleResolution": "Bundler",
+    "noEmit": true
+  },
+  "include": ["."]
+}

apps/desktop/electron-builder.yml

@@ -0,0 +1,51 @@
+appId: io.stephenmann.commitea
+productName: CommiTea
+copyright: © CommiTea
+
+# Pinned because electron is hoisted by the yarn workspace and declared with a
+# caret range, which electron-builder can't resolve on its own. Keep in sync with
+# the electron devDependency.
+electronVersion: 34.5.8
+
+directories:
+  buildResources: build
+  output: dist
+
+# The renderer, preload, and main are already bundled into out/ by electron-vite
+# (@commitea/core, react, react-dom are all inlined). So the packaged app needs
+# nothing from node_modules except the Electron runtime that electron-builder
+# supplies — ship only the build output.
+files:
+  - out/**
+  - '!**/*.map'
+npmRebuild: false
+electronLanguages:
+  - en
+
+mac:
+  target:
+    - target: dmg
+      arch:
+        - arm64
+        - x64
+  category: public.app-category.developer-tools
+  icon: build/icon.png
+  # Unsigned, per the distribution decision (macOS, no certs). Teammates
+  # right-click → Open the first time to get past Gatekeeper.
+  identity: null
+  # Keep hardened-runtime off — it only matters for signed/notarized builds
+  # and can block an unsigned app from launching.
+  hardenedRuntime: false
+  gatekeeperAssess: false
+
+dmg:
+  title: CommiTea ${version}
+  # A plain drag-to-Applications layout.
+  contents:
+    - x: 130
+      y: 220
+      type: file
+    - x: 410
+      y: 220
+      type: link
+      path: /Applications

apps/desktop/package.json

@@ -1,5 +1,8 @@
 {
   "name": "@commitea/desktop",
+  "version": "0.1.0",
+  "description": "CommiTea — an AI project manager for Gitea",
+  "author": "CommiTea",
   "private": true,
   "type": "module",
   "main": "./out/main/index.js",
@@ -7,7 +10,13 @@
     "dev": "electron-vite dev 2>&1 | tee desktop.log",
     "build": "electron-vite build",
     "start": "electron-vite preview",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "e2e": "electron-vite build && playwright test",
+    "e2e:only": "playwright test",
+    "e2e:report": "playwright show-report e2e/.artifacts/report",
+    "pack": "electron-vite build && electron-builder --dir",
+    "dist": "electron-vite build && electron-builder --mac"
   },
   "dependencies": {
     "@commitea/core": "workspace:*",
@@ -15,15 +24,18 @@
     "react-dom": "^18.3.1"
   },
   "devDependencies": {
+    "@playwright/test": "^1.61.1",
     "@types/node": "^22.13.1",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
     "@vitejs/plugin-react": "^4.3.4",
     "autoprefixer": "^10.4.20",
     "electron": "^34.0.0",
+    "electron-builder": "^25",
     "electron-vite": "^3.1.0",
     "postcss": "^8.5.1",
     "tailwindcss": "^3.4.17",
+    "tsx": "^4",
     "typescript": "^5.7.3",
     "vite": "^6.1.0"
   }

apps/desktop/playwright.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from '@playwright/test'
+
+/**
+ * E2E harness for the Electron app. Tests launch the *built* app
+ * (`out/main/index.js`) through Playwright's `_electron` API — see
+ * `e2e/fixtures.ts`. There is no browser project and no chromium download:
+ * `_electron` drives the app's own bundled electron.
+ *
+ * Run `yarn e2e` (builds first) for a fresh run, or `yarn e2e:only` to reuse
+ * the existing `out/` build during a tight iteration loop.
+ */
+export default defineConfig({
+  testDir: './e2e',
+  outputDir: './e2e/.artifacts/test-results',
+  fullyParallel: false,
+  workers: 1, // one electron instance at a time — deterministic, avoids window races
+  forbidOnly: !!process.env.CI,
+  retries: 0,
+  timeout: 30_000,
+  expect: { timeout: 5_000 },
+  reporter: [['list'], ['html', { outputFolder: './e2e/.artifacts/report', open: 'never' }]],
+  use: {
+    trace: 'retain-on-failure',
+    screenshot: 'only-on-failure',
+  },
+})

apps/desktop/scripts/dogfood-report.ts

@@ -0,0 +1,142 @@
+/**
+ * Dogfood (#31): run CommiTea's own deterministic engine against the live
+ * christian/commitea backlog and print the project report each screen derives —
+ * board, critical path, schedule, Monte Carlo forecast, per-milestone runway.
+ *
+ * This is the core brain (schedule + forecast + capacity), the exact code the
+ * desktop app runs. Read-only. Run:  yarn tsx scripts/dogfood-report.ts
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import {
+  createGiteaClient,
+  forecast,
+  inferLifecycle,
+  parseCapacityConfig,
+  capacityPerWorkday,
+  scheduleWithCapacity,
+  type GiteaIssue,
+  type DependencyEdge,
+  type Worker,
+} from '@commitea/core'
+
+const here = dirname(fileURLToPath(import.meta.url))
+
+function token(): string {
+  let dir = here
+  for (let i = 0; i < 6; i++) {
+    try {
+      const m = /^GITEA_TOKEN\s*=\s*(.+?)\s*$/m.exec(readFileSync(join(dir, '.env.local'), 'utf8'))
+      if (m) return m[1].trim()
+    } catch {
+      /* keep walking up */
+    }
+    dir = dirname(dir)
+  }
+  throw new Error('no GITEA_TOKEN in any .env.local up the tree')
+}
+
+/** working-day offset → calendar date (skip Sat/Sun), then a short label. */
+function addWorkingDays(base: Date, n: number): Date {
+  const d = new Date(base)
+  let left = Math.ceil(n)
+  while (left > 0) {
+    d.setDate(d.getDate() + 1)
+    const day = d.getDay()
+    if (day !== 0 && day !== 6) left--
+  }
+  return d
+}
+const fmt = (d: Date) => d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })
+
+async function main() {
+  const client = createGiteaClient(
+    { baseUrl: 'https://gitea.stephenmann.io', owner: 'christian', repo: 'commitea', token: token() },
+    fetch,
+  )
+
+  const all = await client.listIssues({ state: 'all' })
+  const open = all.filter((i) => i.state === 'open')
+  const closed = all.filter((i) => i.state === 'closed')
+
+  // Real dependency edges (open issues only — the scheduler drops out-of-scope endpoints anyway).
+  const edges: DependencyEdge[] = []
+  for (const i of open) {
+    for (const dep of await client.getIssueDependencies(i.number)) edges.push({ issue: i.number, dependsOn: dep })
+  }
+
+  // Capacity lanes from the pm-state repo (a separate repo, exactly like the app's
+  // pmStateClient — NOT the managed repo).
+  const pmClient = createGiteaClient(
+    { baseUrl: 'https://gitea.stephenmann.io', owner: 'christian', repo: 'commitea-pm-state', token: token() },
+    fetch,
+  )
+  let workers: Worker[] = []
+  try {
+    const f = await pmClient.getFile('capacity/members.json')
+    if (f) {
+      const members = parseCapacityConfig(JSON.parse(Buffer.from(f.contentBase64, 'base64').toString('utf8')))
+      workers = members.map((m) => ({ person: m.person, speed: capacityPerWorkday(m) }))
+    }
+  } catch {
+    /* no capacity → single serial worker */
+  }
+
+  const toSchedulable = (issues: GiteaIssue[]) =>
+    issues.map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+      assignee: i.assignee,
+    }))
+
+  const plan = scheduleWithCapacity(toSchedulable(open), edges, workers)
+  const today = new Date()
+  const f = forecast(toSchedulable(open), edges, { workers })
+
+  const bar = '─'.repeat(64)
+  console.log(`\n${bar}\n CommiTea, on itself — ${fmt(today)} ${today.getFullYear()}\n${bar}`)
+  console.log(` Board: ${open.length} open · ${closed.length} done`)
+  console.log(` Team:  ${workers.length ? workers.map((w) => `${w.person} (${w.speed.toFixed(2)}/day)`).join(', ') : 'single serial worker'}`)
+  const unassigned = open.filter((i) => !i.assignee).length
+  if (unassigned) console.log(` ⚠  ${unassigned}/${open.length} open issues have no assignee`)
+
+  console.log(`\n Schedule (dependency + priority order, ${workers.length || 1} lane${workers.length === 1 ? '' : 's'}):`)
+  for (const it of plan.items) {
+    const crit = it.critical ? ' ★crit' : ''
+    const lane = it.worker ? ` [${it.worker}]` : ''
+    const blocks = it.blocks.length ? `  blocks ${it.blocks.map((b) => '#' + b).join(',')}` : ''
+    console.log(
+      `  #${String(it.number).padEnd(3)} ${fmt(addWorkingDays(today, it.startDay))}→${fmt(addWorkingDays(today, it.endDay))}${crit.padEnd(7)}${lane} ${it.title.slice(0, 38)}${blocks}`,
+    )
+  }
+  if (plan.cycle) console.log(`  ⚠ dependency cycle: ${plan.cycle.join(' → ')}`)
+
+  const p90 = f.curve.length ? f.curve[f.curve.length - 1].p90Day : f.p95Day
+  console.log(`\n Forecast (Monte Carlo, ${f.trials} trials, ${f.coldStart ? 'cold-start priors' : 'fitted'}):`)
+  console.log(`  whole backlog lands  p50 ${fmt(addWorkingDays(today, f.p50Day))} · p80 ${fmt(addWorkingDays(today, f.p80Day))} · p90 ${fmt(addWorkingDays(today, p90))}`)
+
+  // Per-milestone runway.
+  const ms = await client.listMilestones()
+  console.log(`\n Runway (per open milestone):`)
+  for (const m of ms.filter((x) => x.state === 'open')) {
+    const scope = open.filter((i) => i.milestone?.id === m.id)
+    if (!scope.length) continue
+    const mf = forecast(toSchedulable(scope), edges, { workers })
+    const mp90 = mf.curve.length ? mf.curve[mf.curve.length - 1].p90Day : mf.p95Day
+    const due = m.dueOn ? fmt(new Date(m.dueOn)) : 'no due date'
+    console.log(
+      `  ${m.title.padEnd(28)} ${scope.length} open · p50 ${fmt(addWorkingDays(today, mf.p50Day))}–p90 ${fmt(addWorkingDays(today, mp90))}  (due: ${due})`,
+    )
+  }
+  console.log(`\n${bar}\n`)
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

apps/desktop/src/main/config-store.ts

@@ -0,0 +1,101 @@
+/**
+ * Persistent app config for a shared/team build. The gitea PAT is encrypted at
+ * rest with Electron's safeStorage (OS keychain-backed) and only ever lives in
+ * the main process — the renderer receives everything *except* the token. Config
+ * lives in userData so each teammate has their own; a `.env.local` remains a dev
+ * fallback (see resolveConfig). Nothing here runs under COMMITEA_E2E.
+ */
+
+import { readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { app, safeStorage } from 'electron'
+
+export interface AppConfig {
+  baseUrl: string
+  owner: string
+  repo: string
+  token: string
+  /** Defaults to `${repo}-pm-state` when omitted. */
+  pmStateRepo?: string
+  /** OpenAI-compatible base for Reginald; chat stays off when absent. */
+  modelUrl?: string
+}
+
+/** The renderer-safe view — everything but the token, plus whether one is set. */
+export type PublicConfig = Omit<AppConfig, 'token'> & { hasToken: boolean }
+
+interface StoredConfig {
+  baseUrl: string
+  owner: string
+  repo: string
+  tokenEnc: string | null // base64 of safeStorage-encrypted token
+  pmStateRepo?: string
+  modelUrl?: string
+}
+
+function configPath(): string {
+  return join(app.getPath('userData'), 'commitea-config.json')
+}
+
+function readStored(): StoredConfig | null {
+  try {
+    return JSON.parse(readFileSync(configPath(), 'utf8')) as StoredConfig
+  } catch {
+    return null
+  }
+}
+
+/** Full config incl. the decrypted token, or null when unset. Main-process only. */
+export function loadConfig(): AppConfig | null {
+  const s = readStored()
+  if (!s || !s.baseUrl || !s.owner || !s.repo) return null
+  let token = ''
+  if (s.tokenEnc) {
+    try {
+      token = safeStorage.decryptString(Buffer.from(s.tokenEnc, 'base64'))
+    } catch {
+      token = '' // key rotated / different machine — treat as no token
+    }
+  }
+  if (!token) return null
+  return { baseUrl: s.baseUrl, owner: s.owner, repo: s.repo, token, pmStateRepo: s.pmStateRepo, modelUrl: s.modelUrl }
+}
+
+/** The renderer-safe view of the saved config (never includes the token). */
+export function publicConfig(): PublicConfig | null {
+  const s = readStored()
+  if (!s) return null
+  return {
+    baseUrl: s.baseUrl,
+    owner: s.owner,
+    repo: s.repo,
+    pmStateRepo: s.pmStateRepo,
+    modelUrl: s.modelUrl,
+    hasToken: !!s.tokenEnc,
+  }
+}
+
+/** Encrypt the token + persist. Best-effort; throws only on a genuine write failure. */
+export function saveConfig(cfg: AppConfig): void {
+  const tokenEnc = cfg.token
+    ? Buffer.from(safeStorage.encryptString(cfg.token)).toString('base64')
+    : (readStored()?.tokenEnc ?? null) // keep the existing token if none supplied
+  const stored: StoredConfig = {
+    baseUrl: cfg.baseUrl.trim().replace(/\/+$/, ''),
+    owner: cfg.owner.trim(),
+    repo: cfg.repo.trim(),
+    tokenEnc,
+    pmStateRepo: cfg.pmStateRepo?.trim() || undefined,
+    modelUrl: cfg.modelUrl?.trim() || undefined,
+  }
+  writeFileSync(configPath(), JSON.stringify(stored, null, 2), 'utf8')
+}
+
+export function clearConfig(): void {
+  try {
+    writeFileSync(configPath(), JSON.stringify({ baseUrl: '', owner: '', repo: '', tokenEnc: null }), 'utf8')
+  } catch {
+    // ignore
+  }
+}

apps/desktop/src/main/gitea.ts

@@ -0,0 +1,375 @@
+/**
+ * Main-process gitea bridge. All gitea traffic runs here — the token never
+ * reaches the renderer (which is CSP-locked to 'self' anyway). The renderer
+ * calls these over IPC (see preload). Config for the dogfood slice comes from
+ * the environment or the repo's .env.local; Settings/Onboarding wire it up
+ * properly later.
+ */
+
+import { randomUUID } from 'node:crypto'
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+import {
+  appendDirective,
+  createGiteaClient,
+  GiteaApiError,
+  type DirectiveEntry,
+  type GiteaClient,
+  type GiteaConfig,
+  type GiteaLabel,
+  type IssueChange,
+  isLabelChange,
+  type LifecycleEvent,
+  makeDirectiveEntry,
+  parseCapacityConfig,
+  parseDirectiveLog,
+  planIssueChange,
+  type ProjectSnapshot,
+  type DirectiveInput,
+} from '@commitea/core'
+import { ipcMain } from 'electron'
+
+import { type AppConfig, clearConfig, loadConfig, publicConfig, saveConfig } from './config-store.js'
+import { loadSnapshot, saveSnapshot } from './snapshot-store.js'
+
+/** Walk up from cwd looking for a .env.local with a GITEA_TOKEN (dev convenience). */
+function loadEnvLocalToken(): string | undefined {
+  let dir = process.cwd()
+  for (let i = 0; i < 6; i++) {
+    try {
+      const txt = readFileSync(join(dir, '.env.local'), 'utf8')
+      const m = /^GITEA_TOKEN\s*=\s*(.+?)\s*$/m.exec(txt)
+      if (m) return m[1].trim()
+    } catch {
+      // not in this dir — keep walking up
+    }
+    const parent = dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  return undefined
+}
+
+/** Saved config wins (team build); a `.env.local` is the dev fallback; e2e uses fixtures. */
+export function resolveConfig(): GiteaConfig | null {
+  // E2E runs against fixtures — never hit the network from the test harness.
+  if (process.env.COMMITEA_E2E === '1') return null
+  const saved = loadConfig()
+  if (saved) return { baseUrl: saved.baseUrl, token: saved.token, owner: saved.owner, repo: saved.repo }
+  // COMMITEA_NO_ENV_LOCAL forces the onboarding path (no .env.local fallback) for testing.
+  if (process.env.COMMITEA_NO_ENV_LOCAL === '1') return null
+  // dev fallback — .env.local / env vars
+  const token = process.env.GITEA_TOKEN ?? loadEnvLocalToken()
+  if (!token) return null
+  return {
+    baseUrl: process.env.GITEA_BASE_URL ?? 'https://gitea.stephenmann.io',
+    token,
+    owner: process.env.GITEA_OWNER ?? 'christian',
+    repo: process.env.GITEA_REPO ?? 'commitea',
+  }
+}
+
+/** The pm-state repo name: configured, else `${repo}-pm-state`, else the env override. */
+function pmStateRepoName(config: GiteaConfig): string {
+  return loadConfig()?.pmStateRepo ?? process.env.COMMITEA_PMSTATE_REPO ?? `${config.repo}-pm-state`
+}
+
+// Memoized clients; reset via resetClients() when the config changes.
+let sharedClient: GiteaClient | null | undefined
+let pmStateClient: GiteaClient | null | undefined
+
+/** Drop the cached clients + snapshot so the next call re-reads the new config. */
+export function resetClients(): void {
+  sharedClient = undefined
+  pmStateClient = undefined
+  labelCache = null
+  invalidateSnapshot()
+}
+
+export function getGiteaClient(): GiteaClient | null {
+  if (sharedClient === undefined) {
+    const config = resolveConfig()
+    sharedClient = config ? createGiteaClient(config, fetch) : null
+  }
+  return sharedClient
+}
+
+// The pm-state repo holds machine-derived state (the directive ledger). Same
+// token/host as the work repo, a different repo (the purity split, decisions D4).
+export function getPmStateClient(): GiteaClient | null {
+  if (pmStateClient === undefined) {
+    const config = resolveConfig()
+    pmStateClient = config ? createGiteaClient({ ...config, repo: pmStateRepoName(config) }, fetch) : null
+  }
+  return pmStateClient
+}
+
+const DIRECTIVE_LOG_PATH = 'directives/log.jsonl'
+
+async function readDirectiveLog(client: GiteaClient): Promise<{ text: string; sha: string | null }> {
+  const file = await client.getFile(DIRECTIVE_LOG_PATH)
+  if (!file) return { text: '', sha: null }
+  return { text: Buffer.from(file.contentBase64, 'base64').toString('utf8'), sha: file.sha }
+}
+
+/** Record a directive: read the ledger, append, write it back (concatenation merge). */
+export async function appendDirectiveEntry(client: GiteaClient, input: DirectiveInput): Promise<DirectiveEntry> {
+  const entry = makeDirectiveEntry(input, randomUUID(), new Date().toISOString())
+  const { text, sha } = await readDirectiveLog(client)
+  const next = appendDirective(text, entry)
+  await client.putFile(DIRECTIVE_LOG_PATH, {
+    contentBase64: Buffer.from(next, 'utf8').toString('base64'),
+    message: `directive: ${entry.kind}`,
+    sha: sha ?? undefined,
+  })
+  return entry
+}
+
+export async function readDirectives(client: GiteaClient) {
+  const { text } = await readDirectiveLog(client)
+  return parseDirectiveLog(text)
+}
+
+const CAPACITY_PATH = 'capacity/members.json'
+
+/** Read the capacity config from the pm-state repo (empty when absent). */
+export async function readCapacity(client: GiteaClient) {
+  const file = await client.getFile(CAPACITY_PATH)
+  if (!file) return []
+  try {
+    return parseCapacityConfig(JSON.parse(Buffer.from(file.contentBase64, 'base64').toString('utf8')))
+  } catch {
+    return []
+  }
+}
+
+/** Full reconcile: issues + milestones + native deps + lifecycle timelines. */
+export async function reconcileSnapshot(
+  client: GiteaClient,
+): Promise<ProjectSnapshot & { milestones: Awaited<ReturnType<GiteaClient['listMilestones']>> }> {
+  const [issues, milestones] = await Promise.all([client.listIssues(), client.listMilestones()])
+  // dependency edges among the open scope (the scheduler only plans what's left)
+  const open = issues.filter((i) => i.state === 'open')
+  const perIssue = await Promise.all(
+    open.map(async (i) => ({ issue: i.number, dependsOn: await client.getIssueDependencies(i.number) })),
+  )
+  const deps = perIssue.flatMap(({ issue, dependsOn }) => dependsOn.map((d) => ({ issue, dependsOn: d })))
+  // lifecycle timelines for every issue (open → columns/badges, closed → calibration actuals)
+  const timelineEntries = await Promise.all(
+    issues.map(async (i) => [i.number, await client.getIssueTimeline(i.number)] as const),
+  )
+  const timelines: Record<number, LifecycleEvent[]> = Object.fromEntries(timelineEntries)
+  return { issues, milestones, deps, timelines }
+}
+
+type Snapshot = Awaited<ReturnType<typeof reconcileSnapshot>>
+
+/**
+ * A single in-memory reconcile cache shared across the app. A full reconcile is
+ * ~2N gitea calls (deps + timelines per issue); without this, every agent tool
+ * call refetched the whole repo. Reads within `maxAgeMs` reuse the cache;
+ * `getSnapshot({ maxAgeMs: 0 })` forces a fresh pull (the explicit UI reconcile),
+ * and any write calls `invalidateSnapshot()` so the next read sees it. The cache
+ * is rebuildable — the durable truth stays in gitea (the purity split, D4).
+ */
+let snapshotCache: { snap: Snapshot; at: number } | null = null
+
+export async function getSnapshot(client: GiteaClient, opts?: { maxAgeMs?: number }): Promise<Snapshot> {
+  const maxAgeMs = opts?.maxAgeMs ?? 0
+  if (snapshotCache && maxAgeMs > 0 && Date.now() - snapshotCache.at <= maxAgeMs) {
+    return snapshotCache.snap
+  }
+  const snap = await reconcileSnapshot(client)
+  snapshotCache = { snap, at: Date.now() }
+  saveSnapshot(snap, new Date().toISOString()) // persist for instant boot + offline
+  return snap
+}
+
+/** Drop the cache so the next read reflects a just-made write. */
+export function invalidateSnapshot(): void {
+  snapshotCache = null
+}
+
+/**
+ * The last persisted snapshot (from a previous session), for instant boot. The
+ * renderer shows it immediately, then a real reconcile supersedes it
+ * (stale-while-revalidate). Returns null when there's nothing on disk; its
+ * `savedAt` marks staleness. It does NOT seed the cache — agent tool calls
+ * always reconcile fresh so they never reason over stale data.
+ */
+export function bootSnapshot(): (Snapshot & { savedAt: string }) | null {
+  const persisted = loadSnapshot()
+  if (!persisted) return null
+  return {
+    issues: persisted.issues,
+    milestones: persisted.milestones,
+    deps: persisted.deps,
+    timelines: persisted.timelines,
+    savedAt: persisted.savedAt,
+  } as unknown as Snapshot & { savedAt: string }
+}
+
+/** Agent tool calls tolerate a slightly stale snapshot (seconds) to stay responsive. */
+export const AGENT_SNAPSHOT_TTL_MS = 30_000
+
+// Label cache is reset with the clients (module-level so resetClients can clear it).
+let labelCache: GiteaLabel[] | null = null
+async function resolveLabelIds(client: GiteaClient, names: string[]): Promise<number[]> {
+  const lookup = () => new Map(labelCache!.map((l) => [l.name, l.id]))
+  if (!labelCache) labelCache = await client.listLabels()
+  let byName = lookup()
+  if (names.some((n) => !byName.has(n))) {
+    labelCache = await client.listLabels() // a name we don't know — refetch once
+    byName = lookup()
+  }
+  return names.map((n) => byName.get(n)).filter((id): id is number => id != null)
+}
+
+export function registerGiteaIpc(): void {
+  ipcMain.handle('gitea:status', () => {
+    const cfg = resolveConfig()
+    return {
+      configured: !!cfg,
+      repo: cfg ? `${cfg.owner}/${cfg.repo}` : null,
+      demo: process.env.COMMITEA_E2E === '1',
+    }
+  })
+
+  // Instant boot: the last persisted snapshot, shown before the fresh reconcile lands.
+  ipcMain.handle('gitea:boot', () => {
+    if (!getGiteaClient()) return { configured: false }
+    const persisted = bootSnapshot()
+    return persisted ? { configured: true, cached: true, ...persisted } : { configured: true, cached: false }
+  })
+
+  ipcMain.handle('gitea:reconcile', async () => {
+    const client = getGiteaClient()
+    if (!client) return { configured: false, issues: [], milestones: [], deps: [], timelines: {} }
+    try {
+      // explicit UI sync — force fresh, and warm the cache for agent tool calls
+      const snap = await getSnapshot(client, { maxAgeMs: 0 })
+      return { configured: true, stale: false, ...snap }
+    } catch (e) {
+      // offline / gitea down — serve the last persisted snapshot rather than error out
+      const persisted = bootSnapshot()
+      if (persisted) return { configured: true, stale: true, ...persisted }
+      throw e
+    }
+  })
+
+  ipcMain.handle('gitea:getIssue', async (_event, index: number) => {
+    const client = getGiteaClient()
+    if (!client) return null
+    return client.getIssue(index)
+  })
+
+  // The write path (apply_changes), applied only after the renderer's propose-
+  // approve. Label swaps (est/p) return the plan; field writes (assign, milestone)
+  // return the freshly-read issue directly. Either way the snapshot is invalidated
+  // so the board + forecast reflect the change.
+  ipcMain.handle('gitea:applyChange', async (_event, change: IssueChange) => {
+    const client = getGiteaClient()
+    if (!client) return { ok: false as const, reason: 'unconfigured' as const }
+
+    if (isLabelChange(change)) {
+      const current = await client.getIssue(change.issue)
+      const plan = planIssueChange(current.labels, change)
+      if (plan.noop) return { ok: true as const, plan, issue: current }
+      const ids = await resolveLabelIds(client, plan.labels)
+      await client.setIssueLabels(change.issue, ids)
+      const issue = await client.getIssue(change.issue)
+      invalidateSnapshot()
+      return { ok: true as const, plan, issue }
+    }
+
+    // Field writes — the client returns the updated issue.
+    const issue =
+      change.kind === 'assign'
+        ? await client.setIssueAssignees(change.issue, change.assignee ? [change.assignee] : [])
+        : await client.setIssueMilestone(change.issue, change.milestone)
+    invalidateSnapshot()
+    return { ok: true as const, issue }
+  })
+
+  // capture_work filing: open each approved issue with its est/* + p/* labels.
+  // Only touches the CommiTea label namespaces — no invented labels (zero-pollution).
+  ipcMain.handle(
+    'gitea:createIssues',
+    async (_event, issues: { title: string; body?: string; estimate?: string; priority?: string }[]) => {
+      const client = getGiteaClient()
+      if (!client) return { ok: false as const, reason: 'unconfigured' as const }
+      const created: { number: number; title: string }[] = []
+      for (const it of issues) {
+        const names = [it.estimate, it.priority].filter((n): n is string => !!n)
+        const labelIds = await resolveLabelIds(client, names)
+        const issue = await client.createIssue({ title: it.title, body: it.body, labelIds })
+        created.push({ number: issue.number, title: issue.title })
+      }
+      if (created.length) invalidateSnapshot() // new issues enter the board/scope
+      return { ok: true as const, created }
+    },
+  )
+
+  // Read the directive ledger from the pm-state repo (for the Directives screen).
+  ipcMain.handle('pmstate:directives', async () => {
+    const pm = getPmStateClient()
+    if (!pm) return { ok: false as const, reason: 'unconfigured' as const }
+    try {
+      return { ok: true as const, directives: await readDirectives(pm) }
+    } catch (e) {
+      return { ok: false as const, reason: 'error' as const, message: e instanceof Error ? e.message : String(e) }
+    }
+  })
+
+  // Read the capacity config from the pm-state repo (for capacity-aware forecasts).
+  ipcMain.handle('pmstate:capacity', async () => {
+    const pm = getPmStateClient()
+    if (!pm) return { ok: false as const, reason: 'unconfigured' as const, members: [] }
+    try {
+      return { ok: true as const, members: await readCapacity(pm) }
+    } catch {
+      return { ok: true as const, members: [] }
+    }
+  })
+
+  // Assignable people (repo collaborators) for the Adjust dialog's assignee picker.
+  ipcMain.handle('gitea:collaborators', async () => {
+    const client = getGiteaClient()
+    if (!client) return []
+    try {
+      return await client.listCollaborators()
+    } catch {
+      return []
+    }
+  })
+
+  // ---- config (team onboarding) ----
+  ipcMain.handle('config:get', () => publicConfig())
+
+  ipcMain.handle('config:set', (_event, cfg: AppConfig) => {
+    saveConfig(cfg)
+    resetClients() // new config takes effect without a restart
+    return { ok: true as const }
+  })
+
+  ipcMain.handle('config:clear', () => {
+    clearConfig()
+    resetClients()
+    return { ok: true as const }
+  })
+
+  // Validate a token + repo before saving: any authed read on the repo proves access.
+  ipcMain.handle('config:test', async (_event, cfg: AppConfig) => {
+    try {
+      const c = createGiteaClient(
+        { baseUrl: cfg.baseUrl.replace(/\/+$/, ''), owner: cfg.owner.trim(), repo: cfg.repo.trim(), token: cfg.token },
+        fetch,
+      )
+      await c.listLabels()
+      return { ok: true as const }
+    } catch (e) {
+      return { ok: false as const, error: e instanceof GiteaApiError ? `${e.status}` : e instanceof Error ? e.message : String(e) }
+    }
+  })
+}

apps/desktop/src/main/index.ts

@@ -2,6 +2,12 @@ import { join } from 'node:path'
 
 import { BrowserWindow, app, shell } from 'electron'
 
+// Test hook: isolate config/cache to a throwaway dir (must run before any getPath).
+if (process.env.COMMITEA_USERDATA) app.setPath('userData', process.env.COMMITEA_USERDATA)
+
+import { registerGiteaIpc } from './gitea.js'
+import { registerModelIpc } from './model.js'
+
 function createWindow(): void {
   const win = new BrowserWindow({
     width: 1440,
@@ -32,6 +38,8 @@ function createWindow(): void {
 }
 
 void app.whenReady().then(() => {
+  registerGiteaIpc()
+  registerModelIpc()
   createWindow()
 
   app.on('activate', () => {

apps/desktop/src/main/model.ts

@@ -0,0 +1,189 @@
+/**
+ * Main-process model bridge — Reginald's brain runs here. Model traffic (like
+ * gitea's) stays in main: the renderer is CSP-locked and never talks to the
+ * LLM directly. On `model:chat` it drives the agent loop against the configured
+ * OpenAI-compatible endpoint, executing `query_project` by reconciling the repo
+ * and building the requested view. v0 is read-only — writes still go through the
+ * propose-approve controls.
+ */
+
+import {
+  buildProjectView,
+  captureWork,
+  type ChangeProposal,
+  type ChatMessage,
+  createChatClient,
+  type ModelRouter,
+  type ProjectView,
+  proposalsFor,
+  type ProposeChangeArgs,
+  type QueryFilters,
+  REGINALD_SYSTEM,
+  REGINALD_TOOLS,
+  runAgentTurn,
+  toDirectiveInput,
+} from '@commitea/core'
+import { app, ipcMain } from 'electron'
+
+import { loadConfig } from './config-store.js'
+import {
+  AGENT_SNAPSHOT_TTL_MS,
+  appendDirectiveEntry,
+  getGiteaClient,
+  getPmStateClient,
+  getSnapshot,
+} from './gitea.js'
+
+/** Small local model for prose + the read tool; big model reserved for later decomposition. */
+function resolveModelRouter(): ModelRouter | null {
+  if (process.env.COMMITEA_E2E === '1') return null // e2e uses the scripted fixture Reginald
+  // Config wins (team build); env is the dev override; localhost is a dev convenience only.
+  const baseUrl =
+    loadConfig()?.modelUrl ??
+    process.env.COMMITEA_MODEL_URL ??
+    (app.isPackaged ? undefined : 'http://localhost:1234/v1')
+  if (!baseUrl) return null
+  return {
+    small: { baseUrl, model: process.env.COMMITEA_MODEL_SMALL ?? '' },
+    big: { baseUrl, model: process.env.COMMITEA_MODEL_BIG ?? '' },
+  }
+}
+
+/** Probe the endpoint for a usable model; null when unreachable (chat then stays off). */
+async function probeModel(baseUrl: string): Promise<string | null> {
+  try {
+    const model = await resolveLoadedModel(baseUrl, process.env.COMMITEA_MODEL_SMALL ?? '')
+    // resolveLoadedModel only returns a real id when the server answered; the default
+    // fallback means unreachable, so confirm with a lightweight models call.
+    const res = await fetch(`${baseUrl.replace(/\/+$/, '')}/models`)
+    return res.ok ? model : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Resolve which model to actually ask for. An explicit env override wins;
+ * otherwise ask the server which model is *loaded* (LM Studio's native
+ * `/api/v0/models`) so Reginald follows whatever you load — no config churn on a
+ * model switch. Falls back to the first non-embedding model, then a sane default.
+ */
+async function resolveLoadedModel(baseUrl: string, override: string): Promise<string> {
+  if (override) return override
+  const root = baseUrl.replace(/\/v1\/?$/, '')
+  try {
+    const res = await fetch(`${root}/api/v0/models`)
+    if (res.ok) {
+      const data = (await res.json()) as { data?: { id: string; state?: string; type?: string }[] }
+      const loaded = (data.data ?? []).find((m) => m.state === 'loaded' && m.type !== 'embeddings')
+      if (loaded) return loaded.id
+    }
+  } catch {
+    // native API unavailable — fall through to the OpenAI listing
+  }
+  try {
+    const res = await fetch(`${baseUrl.replace(/\/+$/, '')}/models`)
+    if (res.ok) {
+      const data = (await res.json()) as { data?: { id: string }[] }
+      const first = (data.data ?? []).find((m) => !/embed/i.test(m.id))
+      if (first) return first.id
+    }
+  } catch {
+    // ignore — use the default
+  }
+  return 'google/gemma-4-e4b'
+}
+
+export function registerModelIpc(): void {
+  ipcMain.handle('model:status', async () => {
+    const r = resolveModelRouter() // resolve fresh so a saved modelUrl takes effect
+    if (!r) return { configured: false, model: null }
+    const model = await probeModel(r.small.baseUrl) // only "configured" if a model actually answers
+    return { configured: !!model, model }
+  })
+
+  ipcMain.handle('model:chat', async (event, messages: ChatMessage[]) => {
+    const router = resolveModelRouter()
+    if (!router) return { ok: false as const, reason: 'unconfigured' as const }
+    const client = getGiteaClient()
+    const model = await resolveLoadedModel(router.small.baseUrl, router.small.model)
+    const chat = createChatClient({ ...router.small, model }, fetch)
+    // stream the model's prose to the renderer token-by-token
+    const onToken = (delta: string) => {
+      if (!event.sender.isDestroyed()) event.sender.send('model:chat:token', delta)
+    }
+
+    // Proposals the model formulates this turn; the renderer approves them (the
+    // write happens through gitea:applyChange, never inside the loop).
+    const proposals: ChangeProposal[] = []
+
+    const execute = async (name: string, args: unknown) => {
+      if (!client) return { error: 'gitea is not configured' }
+      if (name === 'query_project') {
+        // reuse a recent reconcile — a multi-tool turn shouldn't refetch the repo each call
+        const snap = await getSnapshot(client, { maxAgeMs: AGENT_SNAPSHOT_TTL_MS })
+        const a = (args ?? {}) as { view: ProjectView; filters?: QueryFilters }
+        return buildProjectView(a.view, a.filters, snap, new Date())
+      }
+      if (name === 'propose_change') {
+        const a = (args ?? {}) as ProposeChangeArgs
+        const issue = await client.getIssue(a.issue).catch(() => null)
+        if (!issue) return { error: `issue #${a.issue} not found` }
+        // Milestone titles + current assignee/milestone let a proposal label the
+        // milestone and skip a no-op assign/move.
+        const milestones = (a.milestone !== undefined ? await client.listMilestones().catch(() => []) : []).map(
+          (m) => ({ id: m.id, title: m.title }),
+        )
+        const built = proposalsFor(a, issue.labels, issue.title, {
+          currentAssignee: issue.assignee,
+          currentMilestoneId: issue.milestone?.id ?? null,
+          milestones,
+        })
+        proposals.push(...built)
+        return built.length
+          ? { proposed: built.map((p) => ({ issue: a.issue, diff: p.summary })) }
+          : { proposed: [], note: 'no change — already at that value' }
+      }
+      if (name === 'record_directive') {
+        const pm = getPmStateClient()
+        if (!pm) return { error: 'pm-state is not configured' }
+        try {
+          const entry = await appendDirectiveEntry(pm, toDirectiveInput(args))
+          return { recorded: { kind: entry.kind, quote: entry.quote } }
+        } catch (e) {
+          return { error: `could not record — is the pm-state repo created? (${e instanceof Error ? e.message : e})` }
+        }
+      }
+      return { error: `unknown tool: ${name}` }
+    }
+
+    try {
+      const turn = await runAgentTurn({
+        complete: (m, t, ot) => chat.complete(m, t, ot),
+        messages: [{ role: 'system', content: REGINALD_SYSTEM }, ...messages],
+        tools: REGINALD_TOOLS,
+        execute,
+        onToken,
+      })
+      return { ok: true as const, content: turn.content, steps: turn.steps, proposals }
+    } catch (e) {
+      return { ok: false as const, reason: 'error' as const, message: e instanceof Error ? e.message : String(e) }
+    }
+  })
+
+  // capture_work — braindump → proposed issue set. The big model does the
+  // decomposition (with one loaded local model, that's the loaded one). Returns
+  // a proposal; nothing is filed until the Capture tray approves it.
+  ipcMain.handle('model:capture', async (_event, braindump: string) => {
+    const router = resolveModelRouter()
+    if (!router) return { ok: false as const, reason: 'unconfigured' as const }
+    const model = await resolveLoadedModel(router.big.baseUrl, router.big.model)
+    const chat = createChatClient({ ...router.big, model }, fetch)
+    try {
+      const proposal = await captureWork((m, t) => chat.complete(m, t), braindump)
+      return { ok: true as const, ...proposal }
+    } catch (e) {
+      return { ok: false as const, reason: 'error' as const, message: e instanceof Error ? e.message : String(e) }
+    }
+  })
+}

apps/desktop/src/main/snapshot-store.test.ts

@@ -0,0 +1,86 @@
+/**
+ * Purity / rebuild guarantee for the *shipped* durable cache (#30, D4). The app's
+ * on-disk reconcile cache is this JSON snapshot-store. The invariant: delete it
+ * and lose nothing — the durable truth is in gitea, the file is only a boot/offline
+ * mirror. This test deletes the real file and asserts the store degrades to
+ * "no cache" (null), which is what forces the next `getSnapshot` to reconcile
+ * fresh from gitea rather than serve stale or missing data.
+ */
+import { existsSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+// electron can't be imported outside the Electron runtime; the store only needs
+// app.getPath for its default path, which every test overrides with an injected path.
+vi.mock('electron', () => ({ app: { getPath: () => tmpdir() } }))
+
+import { loadSnapshot, type PersistedSnapshot, saveSnapshot } from './snapshot-store.js'
+
+const SNAP: Omit<PersistedSnapshot, 'savedAt'> = {
+  issues: [{ number: 1, title: 'An issue', state: 'open', labels: ['est/5d', 'p/1'] }],
+  milestones: [{ id: 7, title: 'P2' }],
+  deps: [{ issue: 1, dependsOn: 2 }],
+  timelines: { 1: [{ type: 'opened', at: '2026-07-01T00:00:00Z' }] },
+}
+
+describe('snapshot-store purity (#30)', () => {
+  let dir: string | null = null
+  const path = () => {
+    if (!dir) dir = mkdtempSync(join(tmpdir(), 'commitea-snap-'))
+    return join(dir, 'commitea-snapshot.json')
+  }
+  afterEach(() => {
+    if (dir) rmSync(dir, { recursive: true, force: true })
+    dir = null
+  })
+
+  it('round-trips a saved snapshot', () => {
+    const p = path()
+    saveSnapshot(SNAP, '2026-07-09T00:00:00Z', p)
+    const back = loadSnapshot(p)
+    expect(back).toEqual({ ...SNAP, savedAt: '2026-07-09T00:00:00Z' })
+  })
+
+  it('delete the cache file → load returns null (degrades to no-cache, not a crash)', () => {
+    const p = path()
+    saveSnapshot(SNAP, '2026-07-09T00:00:00Z', p)
+    expect(loadSnapshot(p)).not.toBeNull()
+
+    rmSync(p) // delete the durable cache
+    expect(existsSync(p)).toBe(false)
+
+    // The store must NOT throw and must report "no cache" so the next reconcile
+    // rebuilds from gitea. If this ever returned stale data or threw, D4 breaks.
+    expect(loadSnapshot(p)).toBeNull()
+  })
+
+  it('a corrupt / partial file is treated as no-cache, never a crash', () => {
+    const p = path()
+    writeFileSync(p, '{ this is not json', 'utf8')
+    expect(loadSnapshot(p)).toBeNull()
+    // valid JSON but wrong shape (no issues array) is also rejected
+    writeFileSync(p, JSON.stringify({ savedAt: 'x' }), 'utf8')
+    expect(loadSnapshot(p)).toBeNull()
+  })
+
+  it('re-saving after a delete restores the cache — the rebuild is lossless', () => {
+    const p = path()
+    saveSnapshot(SNAP, '2026-07-09T00:00:00Z', p)
+    const before = loadSnapshot(p)
+
+    rmSync(p)
+    expect(loadSnapshot(p)).toBeNull()
+
+    // a resync would call saveSnapshot again with the freshly reconciled data
+    saveSnapshot(SNAP, '2026-07-09T01:00:00Z', p)
+    const after = loadSnapshot(p)
+
+    // same durable payload, only the savedAt marker differs
+    expect(after!.issues).toEqual(before!.issues)
+    expect(after!.milestones).toEqual(before!.milestones)
+    expect(after!.deps).toEqual(before!.deps)
+    expect(after!.timelines).toEqual(before!.timelines)
+  })
+})

apps/desktop/src/main/snapshot-store.ts

@@ -0,0 +1,52 @@
+/**
+ * Durable snapshot store — the reconcile cache, persisted to disk. On boot the
+ * app shows the last snapshot instantly (stale-while-revalidate) instead of a
+ * blank board while ~2N gitea calls run; if gitea is unreachable, reads fall
+ * back to it (offline). It's a rebuildable mirror — the durable truth stays in
+ * gitea (the purity split, D4). A plain JSON file: the whole snapshot fits in
+ * memory at this scale, so indexed SQL buys nothing yet (see the PR).
+ */
+
+import { readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { app } from 'electron'
+
+/** The shape we persist — kept loose so a schema drift degrades to "no cache", not a crash. */
+export interface PersistedSnapshot {
+  issues: unknown[]
+  milestones: unknown[]
+  deps: unknown[]
+  timelines: Record<number, unknown[]>
+  /** ISO time the snapshot was reconciled — shown as "cached since". */
+  savedAt: string
+}
+
+function snapshotPath(): string {
+  return join(app.getPath('userData'), 'commitea-snapshot.json')
+}
+
+/**
+ * Load the last persisted snapshot, or null if absent/corrupt. Never throws — a
+ * deleted or unreadable cache degrades to "no cache" (the purity guarantee, D4:
+ * the next reconcile rebuilds it from gitea). `path` is injectable for tests;
+ * production always uses the userData file.
+ */
+export function loadSnapshot(path: string = snapshotPath()): PersistedSnapshot | null {
+  try {
+    const parsed = JSON.parse(readFileSync(path, 'utf8')) as PersistedSnapshot
+    if (parsed && Array.isArray(parsed.issues)) return parsed
+    return null
+  } catch {
+    return null // missing file, bad JSON, or drift — treat as no cache
+  }
+}
+
+/** Persist a freshly reconciled snapshot. Best-effort — a write failure never breaks a reconcile. */
+export function saveSnapshot(snap: Omit<PersistedSnapshot, 'savedAt'>, savedAt: string, path: string = snapshotPath()): void {
+  try {
+    writeFileSync(path, JSON.stringify({ ...snap, savedAt }), 'utf8')
+  } catch {
+    // disk full / permissions — the in-memory cache still works this session
+  }
+}

apps/desktop/src/preload/index.ts

@@ -1,7 +1,53 @@
-import { contextBridge } from 'electron'
+import { contextBridge, ipcRenderer } from 'electron'
 
 const api = {
   platform: process.platform,
+  gitea: {
+    /** Whether the main process has a gitea token + target repo configured. */
+    status: () => ipcRenderer.invoke('gitea:status'),
+    /** The last persisted snapshot, for instant boot before the fresh reconcile. */
+    boot: () => ipcRenderer.invoke('gitea:boot'),
+    /** Full read of the managed repo — every issue + milestone. */
+    reconcile: () => ipcRenderer.invoke('gitea:reconcile'),
+    /** One issue by index, normalized (or null if unconfigured). */
+    getIssue: (index: number) => ipcRenderer.invoke('gitea:getIssue', index),
+    /** Apply an estimate/priority change (the write path); resolves to the plan + fresh issue. */
+    applyChange: (change: unknown) => ipcRenderer.invoke('gitea:applyChange', change),
+    /** File a set of captured issues with their est/* + p/* labels. */
+    createIssues: (issues: unknown) => ipcRenderer.invoke('gitea:createIssues', issues),
+    /** Assignable people (repo collaborators) for the assignee picker. */
+    collaborators: () => ipcRenderer.invoke('gitea:collaborators'),
+  },
+  pmstate: {
+    /** Read the directive ledger from the pm-state repo. */
+    directives: () => ipcRenderer.invoke('pmstate:directives'),
+    /** Read the capacity config from the pm-state repo. */
+    capacity: () => ipcRenderer.invoke('pmstate:capacity'),
+  },
+  config: {
+    /** The saved config (never the token) — null when unset. */
+    get: () => ipcRenderer.invoke('config:get'),
+    /** Validate a token + repo before saving. */
+    test: (cfg: unknown) => ipcRenderer.invoke('config:test', cfg),
+    /** Save config (token encrypted in main); takes effect without restart. */
+    set: (cfg: unknown) => ipcRenderer.invoke('config:set', cfg),
+    /** Forget the saved config. */
+    clear: () => ipcRenderer.invoke('config:clear'),
+  },
+  model: {
+    /** Whether a model endpoint is configured (else the UI keeps the scripted Reginald). */
+    status: () => ipcRenderer.invoke('model:status'),
+    /** One agent turn: messages in, Reginald's prose + the tools it consulted out. */
+    chat: (messages: unknown) => ipcRenderer.invoke('model:chat', messages),
+    /** Subscribe to streamed prose tokens for the in-flight turn; returns an unsubscribe. */
+    onToken: (cb: (delta: string) => void) => {
+      const listener = (_e: unknown, delta: string) => cb(delta)
+      ipcRenderer.on('model:chat:token', listener)
+      return () => ipcRenderer.removeListener('model:chat:token', listener)
+    },
+    /** Decompose a braindump into a proposed issue set (capture_work). */
+    capture: (braindump: string) => ipcRenderer.invoke('model:capture', braindump),
+  },
 }
 
 export type CommiteaApi = typeof api

apps/desktop/src/renderer/src/app.tsx

@@ -1,26 +1,5 @@
-import { extractLabelFacts } from '@commitea/core'
-
-const facts = extractLabelFacts(['est/3d', 'p/2', 'deadline/hard'])
+import { AppShell } from './components/shell/app-shell.js'
 
 export function App() {
-  return (
-    <main className="min-h-screen bg-paper-0 font-sans text-ink-1">
-      <div className="mx-auto max-w-[1120px] px-7 py-16">
-        <header className="border-b-[3px] border-double border-ink-1 pb-4">
-          <h1 className="font-display text-5xl">CommiTea</h1>
-          <p className="mt-2 font-mono text-sm text-ink-3">
-            scaffold · phase 0 · gitea connection pending
-          </p>
-        </header>
-        <p className="mt-8 max-w-[60ch] font-agent text-lg leading-relaxed">
-          Good morning. The scaffold stands and the kettle is on, but I have nothing to manage
-          yet. Connect me to gitea and we shall put the pot to work.
-        </p>
-        <p className="mt-6 font-mono text-sm text-ink-2">
-          label parse check: est/{facts.estimateDays}d · p/{facts.priority} · hard{' '}
-          {String(facts.hardDeadline)}
-        </p>
-      </div>
-    </main>
-  )
+  return <AppShell />
 }

apps/desktop/src/renderer/src/components/charts/chart.tsx

@@ -0,0 +1,183 @@
+import type { BurnUpData } from '../../lib/dates.js'
+
+/**
+ * Charts — geometry, not decoration. Ported from the handoff's Chart.js. When a
+ * `data` prop is supplied the cone is drawn from real Monte Carlo output
+ * (#10); without it, the fixed sample paths below stand in (demo mode). The
+ * shapes (cone from today, 80% band, today rule) are final.
+ */
+
+export interface BurnUpConeProps {
+  width?: number
+  height?: number
+  /** Real forecast geometry. When present it replaces the demo sample paths. */
+  data?: BurnUpData
+}
+
+export function BurnUpCone({ width = 640, height = 220, data }: BurnUpConeProps) {
+  if (data) return <BurnUpConeReal width={width} height={height} data={data} />
+  const pad = { l: 34, r: 96, t: 16, b: 26 }
+  const W = width - pad.l - pad.r
+  const H = height - pad.t - pad.b
+  const x = (f: number) => pad.l + f * W
+  const y = (f: number) => pad.t + (1 - f) * H
+
+  const today = 0.58
+  const actual: number[][] = [
+    [0, 0],
+    [0.08, 0.05],
+    [0.18, 0.13],
+    [0.26, 0.16],
+    [0.36, 0.27],
+    [0.46, 0.38],
+    [0.58, 0.47],
+  ]
+  const coneHi: number[][] = [
+    [0.58, 0.47],
+    [0.72, 0.66],
+    [0.86, 0.88],
+    [0.95, 1.0],
+  ]
+  const coneLo: number[][] = [
+    [0.58, 0.47],
+    [0.74, 0.58],
+    [0.9, 0.74],
+    [1.0, 0.86],
+  ]
+  const mid: number[][] = [
+    [0.58, 0.47],
+    [0.76, 0.63],
+    [0.92, 0.83],
+    [1.0, 0.93],
+  ]
+  const pts = (arr: number[][]) => arr.map(([a, b]) => `${x(a)},${y(b)}`).join(' ')
+  const cone = [...coneHi, ...[...coneLo].reverse()]
+
+  return (
+    <svg width="100%" viewBox={`0 0 ${width} ${height}`} style={{ display: 'block' }}>
+      {/* gridlines */}
+      {[0, 0.25, 0.5, 0.75, 1].map((f) => (
+        <line key={f} x1={pad.l} x2={width - pad.r} y1={y(f)} y2={y(f)} stroke="var(--line-1)" strokeWidth="1" />
+      ))}
+      {/* scope */}
+      <line x1={pad.l} x2={width - pad.r} y1={y(1)} y2={y(1)} stroke="var(--line-2)" strokeWidth="1.5" />
+      <text x={pad.l} y={y(1) - 6} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--ink-3)' }}>
+        scope · 42 issues
+      </text>
+      {/* cone */}
+      <polygon points={pts(cone)} fill="var(--cone-fill)" />
+      <polyline points={pts(coneHi)} fill="none" stroke="var(--cone-line)" strokeWidth="1.2" strokeDasharray="3 3" />
+      <polyline points={pts(coneLo)} fill="none" stroke="var(--cone-line)" strokeWidth="1.2" strokeDasharray="3 3" />
+      <polyline points={pts(mid)} fill="none" stroke="var(--cone-line)" strokeWidth="1.4" />
+      {/* actual */}
+      <polyline points={pts(actual)} fill="none" stroke="var(--cone-actual)" strokeWidth="2" />
+      <circle cx={x(0.58)} cy={y(0.47)} r="3.5" fill="var(--cone-actual)" />
+      {/* today rule */}
+      <line x1={x(today)} x2={x(today)} y1={pad.t} y2={height - pad.b} stroke="var(--jade)" strokeWidth="1" />
+      <text x={x(today) + 5} y={pad.t + 10} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--jade-7)' }}>
+        today
+      </text>
+      {/* 80% band label */}
+      <text x={width - pad.r + 10} y={y(0.95)} style={{ font: '500 11.5px var(--font-mono)', fill: 'var(--ink-1)' }}>
+        80%
+      </text>
+      <text x={width - pad.r + 10} y={y(0.95) + 14} style={{ font: '400 11px var(--font-mono)', fill: 'var(--ink-2)' }}>
+        Mar 3–12
+      </text>
+      {/* x labels */}
+      <text x={pad.l} y={height - 8} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--ink-3)' }}>
+        Jan 6
+      </text>
+      <text x={width - pad.r - 34} y={height - 8} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--ink-3)' }}>
+        Mar 15
+      </text>
+    </svg>
+  )
+}
+
+/** Data-driven twin of BurnUpCone — same visual grammar, real forecast geometry. */
+function BurnUpConeReal({ width, height, data }: { width: number; height: number; data: BurnUpData }) {
+  const pad = { l: 34, r: 96, t: 16, b: 26 }
+  const W = width - pad.l - pad.r
+  const H = height - pad.t - pad.b
+  const x = (day: number) => pad.l + (day / data.horizonDays) * W
+  const y = (frac: number) => pad.t + (1 - frac) * H
+
+  const hi = data.band.map((p) => `${x(p.hiDay)},${y(p.fraction)}`).join(' ')
+  const lo = data.band.map((p) => `${x(p.loDay)},${y(p.fraction)}`).join(' ')
+  const mid = data.band.map((p) => `${x(p.midDay)},${y(p.fraction)}`).join(' ')
+  const cone = [
+    ...data.band.map((p) => `${x(p.hiDay)},${y(p.fraction)}`),
+    ...[...data.band].reverse().map((p) => `${x(p.loDay)},${y(p.fraction)}`),
+  ].join(' ')
+
+  return (
+    <svg width="100%" viewBox={`0 0 ${width} ${height}`} style={{ display: 'block' }}>
+      {[0, 0.25, 0.5, 0.75, 1].map((f) => (
+        <line key={f} x1={pad.l} x2={width - pad.r} y1={y(f)} y2={y(f)} stroke="var(--line-1)" strokeWidth="1" />
+      ))}
+      {/* scope */}
+      <line x1={pad.l} x2={width - pad.r} y1={y(1)} y2={y(1)} stroke="var(--line-2)" strokeWidth="1.5" />
+      <text x={pad.l} y={y(1) - 6} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--ink-3)' }}>
+        scope · {data.scope} {data.scope === 1 ? 'issue' : 'issues'}
+      </text>
+      {/* cone */}
+      <polygon points={cone} fill="var(--cone-fill)" />
+      <polyline points={hi} fill="none" stroke="var(--cone-line)" strokeWidth="1.2" strokeDasharray="3 3" />
+      <polyline points={lo} fill="none" stroke="var(--cone-line)" strokeWidth="1.2" strokeDasharray="3 3" />
+      <polyline points={mid} fill="none" stroke="var(--cone-line)" strokeWidth="1.4" />
+      {/* origin = today, 0% of remaining scope */}
+      <circle cx={x(0)} cy={y(0)} r="3.5" fill="var(--cone-actual)" />
+      {/* today rule */}
+      <line x1={x(0)} x2={x(0)} y1={pad.t} y2={height - pad.b} stroke="var(--jade)" strokeWidth="1" />
+      <text x={x(0) + 5} y={pad.t + 10} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--jade-7)' }}>
+        today
+      </text>
+      {/* 80% band label */}
+      <text x={width - pad.r + 10} y={y(0.95)} style={{ font: '500 11.5px var(--font-mono)', fill: 'var(--ink-1)' }}>
+        80%
+      </text>
+      <text x={width - pad.r + 10} y={y(0.95) + 14} style={{ font: '400 11px var(--font-mono)', fill: 'var(--ink-2)' }}>
+        {data.rangeLabel}
+      </text>
+      {/* x labels */}
+      <text x={pad.l} y={height - 8} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--ink-3)' }}>
+        {data.startLabel}
+      </text>
+      <text x={width - pad.r - 34} y={height - 8} style={{ font: '400 10.5px var(--font-mono)', fill: 'var(--ink-3)' }}>
+        {data.endLabel}
+      </text>
+    </svg>
+  )
+}
+
+export interface RunwayBarMilestone {
+  tone: 'ok' | 'warn'
+  pos: number
+  spread: number
+}
+
+/** Milestone due-date vs forecast-range position. Used by the Runway screen (P3-5). */
+export function RunwayBar({ m }: { m: RunwayBarMilestone }) {
+  const toneColor = m.tone === 'warn' ? 'var(--warn)' : 'var(--ok)'
+  const left = Math.max(0, (m.pos - m.spread / 2) * 100)
+  const w = Math.min(100 - left, m.spread * 100)
+  return (
+    <div style={{ position: 'relative', height: 22, background: 'var(--paper-2)', borderRadius: 4, overflow: 'hidden' }}>
+      <div
+        style={{
+          position: 'absolute',
+          left: `${left}%`,
+          width: `${w}%`,
+          top: 0,
+          bottom: 0,
+          background: 'var(--cone-fill)',
+          borderLeft: `1.5px solid ${toneColor}`,
+          borderRight: `1.5px solid ${toneColor}`,
+        }}
+      />
+      <div style={{ position: 'absolute', left: `${m.pos * 100}%`, top: 0, bottom: 0, width: 2, background: toneColor }} />
+      <div style={{ position: 'absolute', left: 'calc(88% - 1px)', top: 0, bottom: 0, width: 2, background: 'var(--ink-1)' }} />
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/gallery.tsx

@@ -0,0 +1,211 @@
+import React, { useState } from 'react'
+
+import {
+  Badge,
+  Button,
+  Card,
+  Checkbox,
+  Dialog,
+  Icon,
+  IconButton,
+  Input,
+  Radio,
+  Select,
+  Switch,
+  Tabs,
+  Tag,
+  Toast,
+  Tooltip,
+} from './ui/index.js'
+
+function Section({ title, children }: { title: string; children: React.ReactNode }) {
+  return (
+    <section className="mt-9">
+      <h2 className="mb-3 font-mono text-xs uppercase tracking-wider text-ink-3">{title}</h2>
+      <div className="flex flex-wrap items-start gap-3">{children}</div>
+    </section>
+  )
+}
+
+/**
+ * Visual + behavioral proof for the ported primitives (P3-1). Not a product
+ * screen — the real shell lands in P3-2. Exercises every primitive in both
+ * themes via the toggle.
+ */
+export function PrimitivesGallery() {
+  const [tab, setTab] = useState('board')
+  const [dialogOpen, setDialogOpen] = useState(false)
+  const [checked, setChecked] = useState(true)
+  const [radio, setRadio] = useState('a')
+  const [on, setOn] = useState(true)
+
+  return (
+    <main className="bg-paper-0 font-sans text-ink-1">
+      <div className="mx-auto max-w-[1120px]">
+        <header className="border-b-[3px] border-double border-ink-1 pb-4">
+          <h1 className="font-display text-4xl">Primitives</h1>
+          <p className="mt-1 font-mono text-sm text-ink-3">
+            15 components · toggle Evening service in the rail for dark
+          </p>
+        </header>
+
+        <Section title="Button">
+          <Button variant="primary" icon="sparkles">
+            Brew plan
+          </Button>
+          <Button variant="secondary">Amend</Button>
+          <Button variant="ghost" icon="clock">
+            Defer
+          </Button>
+          <Button variant="danger" icon="trash-2">
+            Withdraw
+          </Button>
+          <Button variant="primary" size="sm" iconRight="arrow-right">
+            Next
+          </Button>
+          <Button variant="secondary" disabled>
+            Disabled
+          </Button>
+        </Section>
+
+        <Section title="IconButton">
+          <IconButton icon="pencil" label="Edit" />
+          <IconButton icon="copy" label="Copy" />
+          <IconButton icon="ellipsis" label="More" variant="outline" />
+          <IconButton icon="x" label="Close" size="sm" />
+        </Section>
+
+        <Section title="Badge">
+          <Badge tone="ok" dot>
+            ahead
+          </Badge>
+          <Badge tone="warn" dot>
+            at risk
+          </Badge>
+          <Badge tone="danger" dot>
+            behind
+          </Badge>
+          <Badge tone="info">steeping</Badge>
+          <Badge tone="neutral">triage</Badge>
+          <Badge tone="jade">on track</Badge>
+        </Section>
+
+        <Section title="Tag">
+          <Tag label="est/3d" />
+          <Tag label="est/8d" />
+          <Tag label="p/1" />
+          <Tag label="p/2" />
+          <Tag label="p/3" />
+          <Tag label="p/4" />
+          <Tag label="deadline/hard" />
+          <Tag label="p/1" onRemove={() => {}} />
+        </Section>
+
+        <Section title="Card">
+          <Card
+            overline="Now"
+            title="Gitea read client"
+            jade
+            actions={<IconButton icon="external-link" label="Open" size="sm" />}
+            footer={
+              <>
+                <Button size="sm" variant="primary">
+                  Start
+                </Button>
+                <Button size="sm" variant="ghost">
+                  Defer
+                </Button>
+              </>
+            }
+            style={{ width: 340 }}
+          >
+            <p className="font-agent text-base leading-relaxed">
+              The tap-root. Everything sinks into it — grab it first.
+            </p>
+          </Card>
+          <Card title="Plain card" style={{ width: 260 }}>
+            <p className="text-sm text-ink-2">Hairline border, whispered shadow.</p>
+          </Card>
+        </Section>
+
+        <Section title="Tabs">
+          <Tabs
+            items={[
+              { id: 'board', label: 'Board', icon: 'square-kanban', count: 34 },
+              { id: 'gantt', label: 'Gantt', icon: 'chart-no-axes-gantt' },
+              { id: 'deps', label: 'Dependencies', icon: 'network', count: 51 },
+            ]}
+            active={tab}
+            onChange={setTab}
+          />
+        </Section>
+
+        <Section title="Icon">
+          <Icon name="coffee" size={20} />
+          <Icon name="leaf" size={20} />
+          <Icon name="git-branch" size={20} />
+          <Icon name="milestone" size={20} />
+          <Icon name="sparkles" size={20} />
+        </Section>
+
+        <Section title="Input & Select">
+          <Input label="Repository" placeholder="christian/commitea" style={{ width: 240 }} />
+          <Input label="Search" icon="search" placeholder="Filter issues" style={{ width: 220 }} />
+          <Input label="Token" mono error="Connection failed" placeholder="tok_xxx" style={{ width: 220 }} />
+          <Select
+            label="Priority"
+            options={[
+              { value: 'p/1', label: 'p/1 — urgent' },
+              { value: 'p/2', label: 'p/2' },
+              { value: 'p/3', label: 'p/3' },
+            ]}
+            style={{ width: 200 }}
+          />
+        </Section>
+
+        <Section title="Checkbox · Radio · Switch">
+          <Checkbox label="Hard deadline" checked={checked} onChange={(e) => setChecked(e.target.checked)} />
+          <Checkbox label="Disabled" checked disabled onChange={() => {}} />
+          <Radio label="Option A" name="g" value="a" checked={radio === 'a'} onChange={() => setRadio('a')} />
+          <Radio label="Option B" name="g" value="b" checked={radio === 'b'} onChange={() => setRadio('b')} />
+          <Switch label="Live sync" checked={on} onChange={(e) => setOn(e.target.checked)} />
+        </Section>
+
+        <Section title="Feedback">
+          <Toast tone="ok" title="Plan brewed" onDismiss={() => {}}>
+            Milestone P2 lands Mar 3–12.
+          </Toast>
+          <Toast tone="warn" title="Stale blocker">
+            #9 has waited 6 days.
+          </Toast>
+          <Tooltip content="Writes to gitea, as you">
+            <Button variant="secondary" icon="info">
+              Hover me
+            </Button>
+          </Tooltip>
+          <Button variant="primary" onClick={() => setDialogOpen(true)}>
+            Open dialog
+          </Button>
+        </Section>
+
+        <Dialog
+          open={dialogOpen}
+          onClose={() => setDialogOpen(false)}
+          title="Withdraw directive?"
+          footer={
+            <>
+              <Button variant="ghost" onClick={() => setDialogOpen(false)}>
+                Cancel
+              </Button>
+              <Button variant="danger" onClick={() => setDialogOpen(false)}>
+                Withdraw
+              </Button>
+            </>
+          }
+        >
+          <p>This removes the directive from the ledger. The schedule reverts to its prior state.</p>
+        </Dialog>
+      </div>
+    </main>
+  )
+}

apps/desktop/src/renderer/src/components/screens/board-screen.tsx

@@ -0,0 +1,103 @@
+import React from 'react'
+
+import { COLUMNS, type BoardColumn, type BoardIssue, type DepsData, type GanttData, type IssueRef } from '../../data/fixtures.js'
+import { Card, Tag, Badge, Tabs, IconButton, Input, Icon } from '../ui/index.js'
+import { EmptyState } from '../shell/states.js'
+import { GanttView } from './gantt-view.js'
+import { DepsGraph } from './deps-graph.js'
+
+// Board — kanban over inferred lifecycle, with Gantt/Dependencies stubs.
+// `columns` defaults to demo fixtures; the shell passes real reconciled data
+// when gitea is configured. `loading` covers the first reconcile.
+export function BoardScreen({
+  onOpenIssue,
+  columns = COLUMNS,
+  gantt,
+  deps,
+  loading = false,
+}: {
+  onOpenIssue: (issue: IssueRef) => void
+  columns?: BoardColumn[]
+  gantt?: GanttData
+  deps?: DepsData
+  loading?: boolean
+}) {
+  const [tab, setTab] = React.useState('board');
+  const [query, setQuery] = React.useState('');
+  const q = query.trim().toLowerCase();
+  const filtered = columns.map((c) => ({ ...c, issues: q ? c.issues.filter((i) => (i.title + ' #' + i.id).toLowerCase().includes(q)) : c.issues }));
+  const anyMatch = filtered.some((c) => c.issues.length > 0);
+  const openCount = columns.reduce((n, c) => n + (c.id === 'done' ? 0 : c.issues.length), 0);
+
+  const IssueCard = ({ issue }: { issue: BoardIssue }) => (
+    <div
+      onClick={() => onOpenIssue(issue)}
+      style={{
+        background: 'var(--surface-card)', border: '1px solid var(--line-1)',
+        borderRadius: 'var(--radius-2)', padding: '10px 12px', cursor: 'pointer',
+        boxShadow: 'var(--shadow-1)', display: 'flex', flexDirection: 'column', gap: 8,
+      }}
+      onMouseEnter={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.borderColor = 'var(--line-2)'; }}
+      onMouseLeave={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.borderColor = 'var(--line-1)'; }}
+    >
+      <div style={{ font: 'var(--text-small)', fontWeight: 500, color: 'var(--ink-1)' }}>{issue.title}</div>
+      <div style={{ display: 'flex', alignItems: 'center', gap: 6, flexWrap: 'wrap' }}>
+        <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)' }}>#{issue.id}</span>
+        {issue.labels.map((l) => <Tag key={l} label={l} style={{ transform: 'scale(0.95)', transformOrigin: 'left center' }} />)}
+        {issue.days ? <span style={{ font: '400 11px var(--font-mono)', color: 'var(--warn)' }}>{issue.days}</span> : null}
+        {issue.pr ? <span style={{ display: 'inline-flex', alignItems: 'center', gap: 3, font: '400 11px var(--font-mono)', color: 'var(--info)' }}><Icon name="git-pull-request" size={12} />{issue.pr}</span> : null}
+        <span style={{
+          marginLeft: 'auto', width: 20, height: 20, borderRadius: '50%',
+          background: 'var(--spruce-2)', color: 'var(--accent-text)',
+          font: '600 9px/20px var(--font-sans)', textAlign: 'center', flexShrink: 0,
+        }}>{issue.who}</span>
+      </div>
+    </div>
+  );
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 14, height: '100%', minHeight: 0 }}>
+      <header style={{ display: 'flex', alignItems: 'baseline', justifyContent: 'space-between', gap: 12 }}>
+        <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0, whiteSpace: 'nowrap' }}>The pot</h1>
+        <div style={{ width: 240 }}><Input icon="search" placeholder="Search the pot…" value={query} onChange={(e: React.ChangeEvent<HTMLInputElement>) => setQuery(e.target.value)} /></div>
+      </header>
+      <Tabs
+        items={[
+          { id: 'board', label: 'Board', icon: 'square-kanban', count: openCount },
+          { id: 'gantt', label: 'Gantt', icon: 'chart-no-axes-gantt' },
+          { id: 'deps', label: 'Dependencies', icon: 'network' },
+        ]}
+        active={tab} onChange={setTab}
+      />
+      {tab === 'board' ? (
+        loading ? (
+          <div style={{ flex: 1, display: 'flex', alignItems: 'center', justifyContent: 'center', gap: 8, color: 'var(--ink-3)' }}>
+            <Icon name="loader-circle" size={16} />
+            <span style={{ font: 'var(--text-small)' }}>Reconciling with gitea…</span>
+          </div>
+        ) : anyMatch ? (
+        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(5, 1fr)', gap: 12, alignItems: 'start', flex: 1, minHeight: 0, overflow: 'auto' }}>
+          {filtered.map((col) => (
+            <div key={col.id} style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
+              <div style={{ display: 'flex', alignItems: 'center', gap: 6, padding: '2px 2px 4px', borderBottom: '1px solid var(--line-1)', whiteSpace: 'nowrap' }}>
+                <span style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-2)' }}>{col.label}</span>
+                <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>{col.issues.length}</span>
+              </div>
+              {col.issues.map((i) => <IssueCard key={i.id} issue={i} />)}
+            </div>
+          ))}
+        </div>
+        ) : (
+          <div style={{ flex: 1, border: '1px dashed var(--line-2)', borderRadius: 'var(--radius-3)' }}>
+            <EmptyState icon="search" title="Nothing by that name"
+              line={`The pot holds ${columns.reduce((n, c) => n + c.issues.length, 0)} issues; none of them answer to “${query.trim()}”.`} />
+          </div>
+        )
+      ) : tab === 'deps' ? (
+        <DepsGraph onOpenIssue={onOpenIssue} data={deps} />
+      ) : (
+        <GanttView onOpenIssue={onOpenIssue} data={gantt} />
+      )}
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/screens/calibration-screen.tsx

@@ -0,0 +1,190 @@
+import React from 'react'
+
+import { CALIBRATION, type CalibrationData } from '../../data/fixtures.js'
+import { Badge, Card, Icon } from '../ui/index.js'
+
+// Calibration report — estimate-vs-actual evidence behind the cones.
+// `data` (real fit from closed-issue actuals) overrides the demo fixture.
+export function CalibrationScreen({ onBack, data }: { onBack: () => void; data?: CalibrationData }) {
+  const c = data ?? CALIBRATION
+
+  // scatter chart geometry
+  const W = 420,
+    H = 300,
+    pad = { l: 36, r: 16, t: 14, b: 30 }
+  const maxD = 9
+  const X = (d: number) => pad.l + (d / maxD) * (W - pad.l - pad.r)
+  const Y = (d: number) => H - pad.b - (d / maxD) * (H - pad.t - pad.b)
+
+  const BiasBar = ({ bias }: { bias: number | null }) => {
+    if (bias == null)
+      return <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>n too small</span>
+    return (
+      <div style={{ display: 'flex', alignItems: 'center', gap: 8, flex: 1 }}>
+        <div style={{ position: 'relative', flex: 1, height: 10, background: 'var(--paper-2)', borderRadius: 3 }}>
+          <div style={{ position: 'absolute', left: '30%', top: -2, bottom: -2, width: 1.5, background: 'var(--line-2)' }}></div>
+          <div
+            style={{
+              position: 'absolute',
+              left: '30%',
+              top: 1.5,
+              height: 7,
+              width: `${Math.min(bias * 1.6, 66)}%`,
+              background: bias > 15 ? 'var(--warn)' : 'var(--ok)',
+              borderRadius: '0 3px 3px 0',
+              opacity: 0.75,
+            }}
+          ></div>
+        </div>
+        <span style={{ font: '500 11.5px var(--font-mono)', color: bias > 15 ? 'var(--warn)' : 'var(--ok)', width: 42, textAlign: 'right' }}>
+          +{bias}%
+        </span>
+      </div>
+    )
+  }
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <div>
+        <button
+          type="button"
+          onClick={onBack}
+          style={{
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: 6,
+            background: 'none',
+            border: 'none',
+            font: '500 12.5px var(--font-sans)',
+            color: 'var(--ink-2)',
+            cursor: 'pointer',
+            padding: '2px 0',
+            marginBottom: 10,
+          }}
+        >
+          <Icon name="arrow-left" size={14} /> Runway
+        </button>
+        <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14, display: 'flex', alignItems: 'baseline', justifyContent: 'space-between', gap: 12 }}>
+          <div>
+            <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Calibration</h1>
+            <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0', whiteSpace: 'nowrap' }}>{c.n} closed issues with estimates · evidence, not opinion</p>
+          </div>
+          {c.active ? (
+            <Badge tone="ok" dot>curve active · n ≥ 20</Badge>
+          ) : (
+            <Badge tone="warn" dot>cold-start · {c.n}/20</Badge>
+          )}
+        </header>
+      </div>
+
+      <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 14, alignItems: 'start' }}>
+        {/* scatter */}
+        <Card overline="Estimate vs actual" title="The shape of hope" jade>
+          <svg width="100%" viewBox={`0 0 ${W} ${H}`} style={{ display: 'block' }}>
+            {[1, 3, 5, 8].map((d) => (
+              <React.Fragment key={d}>
+                <line x1={X(d)} x2={X(d)} y1={pad.t} y2={H - pad.b} stroke="var(--line-1)" strokeWidth="1" />
+                <text x={X(d)} y={H - 12} textAnchor="middle" style={{ font: '400 10px var(--font-mono)', fill: 'var(--ink-3)' }}>{d}d</text>
+                <line x1={pad.l} x2={W - pad.r} y1={Y(d)} y2={Y(d)} stroke="var(--line-1)" strokeWidth="1" />
+                <text x={pad.l - 6} y={Y(d) + 3} textAnchor="end" style={{ font: '400 10px var(--font-mono)', fill: 'var(--ink-3)' }}>{d}d</text>
+              </React.Fragment>
+            ))}
+            {/* perfect line */}
+            <line x1={X(0)} y1={Y(0)} x2={X(maxD)} y2={Y(maxD)} stroke="var(--line-2)" strokeWidth="1.2" strokeDasharray="4 4" />
+            <text x={X(7.6)} y={Y(7.6) + 14} style={{ font: '400 10px var(--font-mono)', fill: 'var(--ink-3)' }}>honest</text>
+            {/* fit */}
+            <line x1={X(0)} y1={Y(0)} x2={X(maxD / c.fit)} y2={Y(maxD)} stroke="var(--cone-line)" strokeWidth="1.6" />
+            <text x={X(4.1)} y={Y(4.1 * c.fit) - 8} style={{ font: '500 10px var(--font-mono)', fill: 'var(--cone-line)' }}>you · ×{c.fit}</text>
+            {/* points */}
+            {c.scatter.map(([e, a], i) => (
+              <circle key={i} cx={X(e) + ((i % 5) - 2) * 3} cy={Y(a)} r="3" fill="var(--accent)" opacity="0.55" />
+            ))}
+          </svg>
+          <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: '8px 0 0' }}>estimated (x) vs actual days (y) · actuals inferred from git events, never tracked</p>
+        </Card>
+
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 14 }}>
+          {/* per-label bias */}
+          <Card overline="Bias by estimate label" flush>
+            <div>
+              {c.labels.map((r, i) => (
+                <div
+                  key={r.label}
+                  style={{
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: 14,
+                    padding: '10px 20px',
+                    borderTop: i === 0 ? 'none' : '1px solid var(--line-1)',
+                  }}
+                >
+                  <span style={{ font: '500 11.5px var(--font-mono)', color: 'var(--ink-1)', width: 52 }}>{r.label}</span>
+                  <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', width: 66 }}>n={r.n} · {r.median}</span>
+                  <BiasBar bias={r.bias} />
+                </div>
+              ))}
+            </div>
+          </Card>
+
+          {/* per-person */}
+          <Card overline="By person" flush>
+            <div>
+              {c.people.map((p, i) => (
+                <div
+                  key={p.who}
+                  style={{
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: 12,
+                    padding: '11px 20px',
+                    borderTop: i === 0 ? 'none' : '1px solid var(--line-1)',
+                  }}
+                >
+                  <span
+                    style={{
+                      width: 24,
+                      height: 24,
+                      borderRadius: '50%',
+                      background: 'var(--spruce-2)',
+                      color: 'var(--accent-text)',
+                      font: '600 9px/24px var(--font-sans)',
+                      textAlign: 'center',
+                      flexShrink: 0,
+                    }}
+                  >
+                    {p.who
+                      .split(' ')
+                      .map((w) => w[0])
+                      .join('')}
+                  </span>
+                  <div style={{ flex: 1, minWidth: 0 }}>
+                    <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)' }}>{p.who}</span>
+                    <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}> · n={p.n} · {p.note}</span>
+                  </div>
+                  <span style={{ font: '500 12px var(--font-mono)', color: p.bias > 15 ? 'var(--warn)' : 'var(--ok)' }}>+{p.bias}%</span>
+                </div>
+              ))}
+            </div>
+          </Card>
+
+          {/* effect on forecasts */}
+          <Card overline="What this does to your forecasts">
+            <div style={{ display: 'flex', alignItems: 'center', gap: 10, flexWrap: 'wrap' }}>
+              <span style={{ font: '400 12.5px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>{c.effect.raw}</span>
+              <Icon name="arrow-right" size={14} style={{ color: 'var(--ink-3)' }} />
+              <span style={{ font: '500 12.5px var(--font-mono)', color: 'var(--ink-1)', whiteSpace: 'nowrap' }}>{c.effect.banded}</span>
+            </div>
+            <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '10px 0 0' }}>
+              {c.active
+                ? 'You are not bad at estimating; you are optimistic in a very stable way. Stable, I can work with.'
+                : 'Not enough closed history yet — I’m forecasting from cold-start priors and widening the cone to stay honest. The curve takes over at 20.'}
+              {!c.active && c.excludedSameDay > 0
+                ? ` And ${c.excludedSameDay} closed ${c.excludedSameDay === 1 ? 'issue' : 'issues'} closed the same day they were started — 0 working days can’t calibrate, so they don’t count toward the 20.`
+                : ''}
+            </p>
+          </Card>
+        </div>
+      </div>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/capture-screen.tsx

@@ -0,0 +1,303 @@
+import React from 'react'
+
+import type { ProposedIssue } from '@commitea/core'
+
+import { Badge, Button, Card, Icon, Select, Tag } from '../ui/index.js'
+
+// Capture interview — braindump → interview → approved ticket set (< 2 min).
+// With a model configured, "Brew tickets" runs real capture_work decomposition
+// and "Approve all" files the issues in gitea; otherwise the scripted demo runs.
+
+interface Ticket {
+  title: string
+  est: string
+  p: string
+  dep?: string
+  byReginald?: boolean
+}
+
+interface Question {
+  q: string
+  chips: string[]
+  set: (a: string) => void
+}
+
+export function CaptureScreen({ onDone }: { onDone: () => void }) {
+  const [stage, setStage] = React.useState<'dump' | 'interview' | 'review' | 'filed'>('dump')
+  const [dump, setDump] = React.useState(
+    'auth is flaky — token refresh dies silently, sometimes session storage goes stale. ' +
+      'also the webhook debounce thing keeps double-firing. and we owe docs for auth setup'
+  )
+  const [qi, setQi] = React.useState(0)
+  const [log, setLog] = React.useState<{ q: string; a: string }[]>([])
+  const [split, setSplit] = React.useState<boolean | null>(null)
+  const [webEst, setWebEst] = React.useState<string | null>(null)
+  const [secs, setSecs] = React.useState(0)
+
+  // live capture_work path (real model + gitea writes)
+  const [live, setLive] = React.useState(false)
+  const [brewing, setBrewing] = React.useState(false)
+  const [liveTickets, setLiveTickets] = React.useState<ProposedIssue[] | null>(null)
+  const [filedCount, setFiledCount] = React.useState(0)
+  const [error, setError] = React.useState<string | null>(null)
+
+  React.useEffect(() => {
+    let alive = true
+    window.commitea.model.status().then((s) => { if (alive) setLive(s.configured) }).catch(() => {})
+    return () => { alive = false }
+  }, [])
+
+  const editTicket = (i: number, field: 'estimate' | 'priority', value: string) =>
+    setLiveTickets((ts) => (ts ? ts.map((t, j) => (j === i ? { ...t, [field]: value } : t)) : ts))
+
+  // Decide live-vs-scripted at click time: re-check status if it hasn't resolved
+  // yet, so a configured model never falls into the scripted interview by a race.
+  const onBrew = async () => {
+    const configured = live || (await window.commitea.model.status().then((s) => s.configured).catch(() => false))
+    if (configured) {
+      setLive(true)
+      brew()
+    } else {
+      setStage('interview')
+    }
+  }
+
+  const brew = () => {
+    setError(null)
+    setBrewing(true)
+    window.commitea.model
+      .capture(dump)
+      .then((res) => {
+        setBrewing(false)
+        if (res.ok && res.issues.length) {
+          setLiveTickets(res.issues)
+          setStage('review')
+        } else {
+          setError(res.ok ? 'I could not find concrete work in that — try a bit more detail.' : `Capture failed: ${res.reason === 'error' ? res.message : 'no model'}`)
+        }
+      })
+      .catch(() => { setBrewing(false); setError('I could not reach the model.') })
+  }
+
+  const fileLive = () => {
+    if (!liveTickets) return
+    setBrewing(true)
+    window.commitea.gitea
+      .createIssues(liveTickets)
+      .then((res) => {
+        setBrewing(false)
+        if (res.ok) { setFiledCount(res.created.length); setStage('filed') }
+        else setError('Filing failed — gitea is not configured.')
+      })
+      .catch(() => { setBrewing(false); setError('Filing failed.') })
+  }
+
+  const running = stage === 'interview' || stage === 'review'
+  React.useEffect(() => {
+    if (!running) return
+    const t = setInterval(() => setSecs((s) => s + 1), 1000)
+    return () => clearInterval(t)
+  }, [running])
+  const clock = `${Math.floor(secs / 60)}:${String(secs % 60).padStart(2, '0')}`
+
+  const QUESTIONS: Question[] = [
+    {
+      q: 'The auth work — one ticket, or shall I split token refresh from session storage? They fail differently.',
+      chips: ['One ticket', 'Split them'],
+      set: (a) => setSplit(a === 'Split them'),
+    },
+    {
+      q: 'The webhook double-fire — how long? I should mention your "quick" has averaged two days.',
+      chips: ['est/1d', 'est/2d', 'est/3d'],
+      set: (a) => setWebEst(a),
+    },
+    {
+      q: 'Milestone Beta, I presume? It has room, provided the auth work stays under four days.',
+      chips: ['Beta', 'New milestone'],
+      set: () => {},
+    },
+  ]
+
+  const answer = (a: string) => {
+    QUESTIONS[qi].set(a)
+    setLog((l) => [...l, { q: QUESTIONS[qi].q, a }])
+    if (qi + 1 < QUESTIONS.length) setQi(qi + 1)
+    else setStage('review')
+  }
+
+  // draft tickets build as the interview progresses (scripted demo path)
+  const scripted: Ticket[] = []
+  if (split === true) {
+    scripted.push({ title: 'Token refresh: retry with backoff', est: 'est/2d', p: 'p/2' })
+    scripted.push({ title: 'Session storage: stale reads on wake', est: 'est/1d', p: 'p/3' })
+  } else if (split === false) {
+    scripted.push({ title: 'Auth: token refresh + session storage', est: 'est/3d', p: 'p/2' })
+  }
+  if (webEst) scripted.push({ title: 'Webhook debounce: double-fire guard', est: webEst, p: 'p/1', dep: 'blocked by auth work' })
+  if (!live && (stage === 'review' || stage === 'filed')) {
+    scripted.push({ title: 'Docs: auth setup guide', est: 'est/1d', p: 'p/4', byReginald: true })
+  }
+  // real capture_work output overrides the scripted set when present
+  const tickets: Ticket[] = liveTickets
+    ? liveTickets.map((i) => ({ title: i.title, est: i.estimate ?? 'est/2d', p: i.priority ?? 'p/3' }))
+    : scripted
+  const totalDays = tickets.reduce((n, t) => n + parseInt(t.est.replace('est/', ''), 10), 0)
+
+  const estOptions = ['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d'].map((v) => ({ value: v, label: v }))
+  const pOptions = ['p/1', 'p/2', 'p/3', 'p/4'].map((v) => ({ value: v, label: v }))
+
+  const Tray = ({ editable }: { editable?: boolean }) => (
+    <Card overline="The tray" title={tickets.length ? `${tickets.length} draft${tickets.length > 1 ? 's' : ''}` : 'Empty, for now'} flush>
+      <div>
+        {tickets.length === 0 ? (
+          <p style={{ font: 'var(--text-agent)', color: 'var(--ink-3)', margin: 0, padding: '14px 20px 18px' }}>
+            Tickets appear here as we talk.
+          </p>
+        ) : tickets.map((t, i) => (
+          <div key={t.title} style={{
+            display: 'flex', flexDirection: 'column', gap: 8,
+            padding: '12px 20px', borderTop: i === 0 ? 'none' : '1px solid var(--line-1)',
+          }}>
+            <div style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)' }}>{t.title}</div>
+            <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+              {editable ? (
+                <>
+                  <Select
+                    options={estOptions}
+                    value={liveTickets ? t.est : undefined}
+                    defaultValue={liveTickets ? undefined : t.est}
+                    onChange={(e) => editTicket(i, 'estimate', e.target.value)}
+                    style={{ width: 96 }}
+                  />
+                  <Select
+                    options={pOptions}
+                    value={liveTickets ? t.p : undefined}
+                    defaultValue={liveTickets ? undefined : t.p}
+                    onChange={(e) => editTicket(i, 'priority', e.target.value)}
+                    style={{ width: 76 }}
+                  />
+                </>
+              ) : (
+                <>
+                  <Tag label={t.est} />
+                  <Tag label={t.p} />
+                </>
+              )}
+              {t.dep ? <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', display: 'inline-flex', alignItems: 'center', gap: 4 }}><Icon name="network" size={11} />{t.dep}</span> : null}
+              {t.byReginald ? <Badge tone="jade">added by Reginald</Badge> : null}
+            </div>
+          </div>
+        ))}
+      </div>
+    </Card>
+  )
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14, display: 'flex', alignItems: 'baseline', justifyContent: 'space-between', gap: 12 }}>
+        <div>
+          <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Capture</h1>
+          <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0', whiteSpace: 'nowrap' }}>braindump → approved tickets</p>
+        </div>
+        {stage !== 'dump' ? (
+          <div style={{ textAlign: 'right' }}>
+            <div style={{ font: '400 24px/1 var(--font-serif-display)', color: secs > 120 ? 'var(--warn)' : 'var(--ink-1)' }}>{clock}</div>
+            <div style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', marginTop: 4 }}>budget 2:00</div>
+          </div>
+        ) : null}
+      </header>
+
+      {stage === 'dump' ? (
+        <Card overline="Braindump" title="Tell me what you're planning" jade>
+          <textarea
+            value={dump}
+            onChange={(e: React.ChangeEvent<HTMLTextAreaElement>) => setDump(e.target.value)}
+            rows={5}
+            style={{
+              width: '100%', resize: 'vertical', font: 'var(--text-body)', color: 'var(--ink-1)',
+              background: 'var(--paper-0)', border: '1px solid var(--line-2)', borderRadius: 'var(--radius-2)',
+              padding: '10px 12px', outline: 'none', lineHeight: 1.55,
+            }}
+          ></textarea>
+          <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '10px 0 14px' }}>
+            Sentences, fragments, grievances — all welcome. I'll sort it into tickets and only ask what I can't infer.
+          </p>
+          <Button icon="sparkles" onClick={() => void onBrew()} disabled={brewing}>
+            {brewing ? 'Brewing…' : 'Brew tickets'}
+          </Button>
+          {error ? (
+            <p style={{ font: 'var(--text-agent)', color: 'var(--danger)', margin: '10px 0 0' }}>{error}</p>
+          ) : null}
+        </Card>
+      ) : null}
+
+      {stage === 'interview' ? (
+        <div style={{ display: 'grid', gridTemplateColumns: '1.3fr 1fr', gap: 14, alignItems: 'start' }}>
+          <Card overline={`Interview · ${qi + 1} of ${QUESTIONS.length}`} jade>
+            <div style={{ display: 'flex', flexDirection: 'column', gap: 14 }}>
+              {log.map((e, i) => (
+                <div key={i} style={{ display: 'flex', flexDirection: 'column', gap: 6, opacity: 0.66 }}>
+                  <span style={{ font: 'var(--text-agent)', color: 'var(--ink-2)' }}>{e.q}</span>
+                  <span style={{ alignSelf: 'flex-start', font: 'var(--text-small)', background: 'var(--paper-2)', borderRadius: 'var(--radius-round)', padding: '4px 11px' }}>{e.a}</span>
+                </div>
+              ))}
+              <p style={{ font: 'var(--text-agent-lg)', color: 'var(--ink-1)', margin: 0 }}>{QUESTIONS[qi].q}</p>
+              <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
+                {QUESTIONS[qi].chips.map((c) => (
+                  <Button key={c} variant="secondary" size="sm" onClick={() => answer(c)}>{c}</Button>
+                ))}
+              </div>
+            </div>
+          </Card>
+          <Tray />
+        </div>
+      ) : null}
+
+      {stage === 'review' ? (
+        <div style={{ display: 'grid', gridTemplateColumns: '1fr 1.1fr', gap: 14, alignItems: 'start' }}>
+          <Card overline="Consequence" title={`${tickets.length} tickets · ~${totalDays}d of work`} jade
+                footer={<>
+                  <Button onClick={() => (live ? fileLive() : setStage('filed'))} disabled={brewing}>
+                    {brewing ? 'Filing…' : 'Approve all'}
+                  </Button>
+                  <Button variant="ghost" onClick={() => { setStage('dump'); setQi(0); setLog([]); setSplit(null); setWebEst(null); setSecs(0); setLiveTickets(null); setError(null); }}>Discard</Button>
+                </>}>
+            {live ? (
+              <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+                {tickets.length} issue{tickets.length === 1 ? '' : 's'} from your braindump, estimated and prioritized.
+                Adjust the labels, then approve — I'll open them in gitea with only est/* and p/* labels.
+              </p>
+            ) : (
+              <>
+                <p style={{ font: 'var(--text-body)', margin: '0 0 8px' }}>
+                  Beta's 80% window moves <span style={{ font: 'var(--text-data)' }}>Mar 3–12 → Mar 5–14</span>. Capacity absorbs the rest.
+                </p>
+                <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+                  I added the docs ticket you mentioned and wired the dependency. Shall I make it so?
+                </p>
+              </>
+            )}
+          </Card>
+          <Tray editable />
+        </div>
+      ) : null}
+
+      {stage === 'filed' ? (
+        <Card jade style={{ maxWidth: 560 }}>
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 10, alignItems: 'flex-start' }}>
+            <span style={{ color: 'var(--ok)', display: 'inline-flex', alignItems: 'center', gap: 8, font: 'var(--text-title)' }}>
+              <Icon name="circle-check" size={22} /> Filed
+            </span>
+            <p style={{ font: 'var(--text-body)', margin: 0 }}>
+              {live ? filedCount : tickets.length} issues opened in gitea with <span style={{ font: 'var(--text-data)' }}>est/*</span> and <span style={{ font: 'var(--text-data)' }}>p/*</span> labels — nothing else touched.
+            </p>
+            <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+              Elapsed {clock} — under budget. No bot comments, no synthetic issues; your repo remains yours.
+            </p>
+            <Button iconRight="arrow-right" onClick={onDone}>To morning service</Button>
+          </div>
+        </Card>
+      ) : null}
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/connect-screen.tsx

@@ -0,0 +1,117 @@
+import React from 'react'
+
+import type { PublicConfig } from '../../global.js'
+import logoIcon from '../../design/assets/logo-icon.png'
+import { Button, Card, Input } from '../ui/index.js'
+
+/**
+ * Real onboarding — each teammate connects their own Gitea with a personal access
+ * token. The token is validated (an authed read on the repo) then saved encrypted
+ * in the main process (never exposed to this renderer). Optional model URL wires
+ * Reginald; leave it blank and chat simply stays off.
+ */
+export function ConnectScreen({ onConnected, existing }: { onConnected: () => void; existing?: PublicConfig | null }) {
+  const [baseUrl, setBaseUrl] = React.useState(existing?.baseUrl ?? 'https://gitea.stephenmann.io')
+  const [owner, setOwner] = React.useState(existing?.owner ?? '')
+  const [repo, setRepo] = React.useState(existing?.repo ?? '')
+  const [token, setToken] = React.useState('')
+  const [modelUrl, setModelUrl] = React.useState(existing?.modelUrl ?? '')
+  const [state, setState] = React.useState<'idle' | 'testing' | 'saving'>('idle')
+  const [error, setError] = React.useState<string | null>(null)
+
+  const cfg = () => ({ baseUrl, owner, repo, token, modelUrl: modelUrl.trim() || undefined })
+  const ready = baseUrl.trim() && owner.trim() && repo.trim() && (token.trim() || existing?.hasToken)
+
+  const connect = async () => {
+    setError(null)
+    setState('testing')
+    // reuse the saved token when editing and the field is left blank
+    const payload = token.trim() ? cfg() : { ...cfg(), token: '' }
+    if (token.trim()) {
+      const test = await window.commitea.config.test(cfg()).catch(() => ({ ok: false, error: 'unreachable' }))
+      if (!test.ok) {
+        setState('idle')
+        setError(
+          test.error === '404'
+            ? "Couldn't find that repo — check owner/name and that the token can see it."
+            : test.error === '401' || test.error === '403'
+              ? 'The token was rejected — check it has repo + issue scopes.'
+              : `Connection failed${test.error ? ` (${test.error})` : ''}.`,
+        )
+        return
+      }
+    }
+    setState('saving')
+    await window.commitea.config.set(payload)
+    onConnected()
+  }
+
+  const field = (
+    label: string,
+    value: string,
+    set: (v: string) => void,
+    opts: { placeholder?: string; type?: string; hint?: string } = {},
+  ) => (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 5 }}>
+      <Input
+        label={label}
+        value={value}
+        type={opts.type}
+        placeholder={opts.placeholder}
+        onChange={(e) => set(e.target.value)}
+      />
+      {opts.hint ? <span style={{ font: 'var(--text-caption)', color: 'var(--ink-3)' }}>{opts.hint}</span> : null}
+    </div>
+  )
+
+  return (
+    <div
+      style={{
+        height: '100vh',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        background: 'var(--surface-app)',
+        padding: 24,
+      }}
+    >
+      <Card style={{ width: 460, maxWidth: '100%' }}>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 10, marginBottom: 6 }}>
+          <img src={logoIcon} width="28" height="28" alt="" style={{ borderRadius: 7, display: 'block' }} />
+          <span style={{ font: '400 24px/1 var(--font-serif-display)', color: 'var(--ink-1)' }}>
+            Commi<span style={{ color: 'var(--accent-text)' }}>Tea</span>
+          </span>
+        </div>
+        <p style={{ font: 'var(--text-body)', color: 'var(--ink-2)', margin: '0 0 18px' }}>
+          Connect your Gitea. Your token is stored encrypted on this machine and never leaves it.
+        </p>
+
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+          {field('Gitea URL', baseUrl, setBaseUrl, { placeholder: 'https://gitea.example.com' })}
+          <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 12 }}>
+            {field('Owner', owner, setOwner, { placeholder: 'your-org' })}
+            {field('Repository', repo, setRepo, { placeholder: 'your-repo' })}
+          </div>
+          {field('Access token', token, setToken, {
+            type: 'password',
+            placeholder: existing?.hasToken ? '•••••••• (saved — leave blank to keep)' : 'gitea PAT · scopes: repo + issue',
+          })}
+          {field('Model URL', modelUrl, setModelUrl, {
+            placeholder: 'http://localhost:1234/v1',
+            hint: 'Optional — an OpenAI-compatible endpoint for Reginald. Leave blank to keep chat off.',
+          })}
+        </div>
+
+        {error ? (
+          <p style={{ font: 'var(--text-agent)', color: 'var(--danger)', margin: '12px 0 0' }}>{error}</p>
+        ) : null}
+
+        <div style={{ display: 'flex', gap: 10, marginTop: 18 }}>
+          <Button onClick={() => void connect()} disabled={!ready || state !== 'idle'}>
+            {state === 'testing' ? 'Checking…' : state === 'saving' ? 'Connecting…' : existing ? 'Save' : 'Connect'}
+          </Button>
+        </div>
+      </Card>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/deps-graph.tsx

@@ -0,0 +1,130 @@
+import React from 'react'
+
+import { DEPS, type DepsData, type IssueRef } from '../../data/fixtures.js'
+import { Tag, Icon } from '../ui/index.js'
+
+// Dependency graph drill-in — layered DAG, critical path in spruce
+export function DepsGraph({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef) => void; data?: DepsData }) {
+  const g = data ?? DEPS
+
+  const PAD = 14, COLW = 206, ROWH = 106, NW = 176, NH = 84
+  const X = (c: number) => PAD + c * COLW
+  const Y = (r: number) => PAD + r * ROWH
+  const maxCol = g.milestone.col
+  const maxRow = Math.max(...g.nodes.map((n) => n.row), g.milestone.row)
+  const W = PAD * 2 + maxCol * COLW + NW
+  const H = PAD * 2 + maxRow * ROWH + NH
+  const MSW = 158, MSH = 44
+
+  const pos: Record<string, { x: number; y: number; w: number; h: number }> = {}
+  g.nodes.forEach((n) => { pos[n.id] = { x: X(n.col), y: Y(n.row), w: NW, h: NH } })
+  pos['ms'] = { x: X(g.milestone.col), y: Y(g.milestone.row) + (NH - MSH) / 2, w: MSW, h: MSH }
+
+  const edgePath = (e: { from: number; to: number | 'ms'; crit?: boolean }) => {
+    const a = pos[e.from], b = pos[e.to]
+    const x1 = a.x + a.w, y1 = a.y + a.h / 2
+    const x2 = b.x, y2 = b.y + b.h / 2
+    const dx = Math.max(28, (x2 - x1) / 2)
+    return `M ${x1} ${y1} C ${x1 + dx} ${y1}, ${x2 - dx} ${y2}, ${x2 - 5} ${y2}`
+  }
+
+  const STATES: Record<string, { icon: string; color: string; label: string }> = {
+    done: { icon: 'circle-check', color: 'var(--ok)', label: 'done' },
+    steeping: { icon: 'clock', color: 'var(--warn)', label: 'steeping' },
+    review: { icon: 'git-pull-request', color: 'var(--info)', label: 'in review' },
+    triage: { icon: 'circle-dot', color: 'var(--ink-3)', label: 'triage' },
+    diagnosis: { icon: 'circle-dashed', color: 'var(--ink-3)', label: 'diagnosis' },
+  }
+
+  const Node = ({ n }: { n: (typeof DEPS.nodes)[number] }) => {
+    const st = STATES[n.state]
+    const crit = g.critical.includes(n.id)
+    return (
+      <div
+        onClick={() => onOpenIssue({ id: n.id, title: n.title, labels: n.tags, rationale: n.rationale, days: n.state === 'steeping' ? n.days : undefined })}
+        style={{
+          position: 'absolute', left: pos[n.id].x, top: pos[n.id].y, width: NW, height: NH,
+          background: n.state === 'done' ? 'var(--paper-2)' : 'var(--surface-card)',
+          border: `1px solid ${crit ? 'var(--spruce-5)' : 'var(--line-1)'}`,
+          boxShadow: crit ? 'var(--shadow-1), inset 2px 0 0 var(--accent)' : 'var(--shadow-1)',
+          borderRadius: 'var(--radius-2)', padding: '9px 11px', cursor: 'pointer',
+          display: 'flex', flexDirection: 'column', gap: 6,
+          opacity: n.state === 'done' ? 0.72 : 1,
+          transition: 'border-color var(--duration-fast) var(--ease-out)',
+        }}
+        onMouseEnter={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.borderColor = crit ? 'var(--accent)' : 'var(--line-2)' }}
+        onMouseLeave={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.borderColor = crit ? 'var(--spruce-5)' : 'var(--line-1)' }}
+      >
+        <div style={{
+          font: '500 12px/1.3 var(--font-sans)', color: 'var(--ink-1)',
+          display: '-webkit-box', WebkitLineClamp: 2, WebkitBoxOrient: 'vertical', overflow: 'hidden',
+        }}>{n.title}</div>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 6, marginTop: 'auto' }}>
+          <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>#{n.id}</span>
+          <span style={{ display: 'inline-flex', alignItems: 'center', gap: 4, font: '400 10.5px var(--font-mono)', color: st.color, whiteSpace: 'nowrap' }}>
+            <Icon name={st.icon} size={11} />
+            {st.label}{n.state === 'steeping' && n.days ? ` ${n.days}` : ''}
+          </span>
+          {n.tags.filter((t) => t.startsWith('p/')).map((t) => (
+            <span key={t} style={{ font: '500 10.5px var(--font-mono)', color: 'var(--ink-3)', marginLeft: 'auto' }}>{t}</span>
+          ))}
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 12, flex: 1, minHeight: 0 }}>
+      {/* legend */}
+      <div style={{ display: 'flex', alignItems: 'center', gap: 18, font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>
+        <span style={{ display: 'inline-flex', alignItems: 'center', gap: 7 }}>
+          <span style={{ width: 22, height: 2, background: 'var(--accent)', display: 'inline-block' }}></span>critical path
+        </span>
+        <span style={{ display: 'inline-flex', alignItems: 'center', gap: 7 }}>
+          <span style={{ width: 22, height: 0, borderTop: '1.5px solid var(--line-2)', display: 'inline-block' }}></span>blocks
+        </span>
+        <span style={{ marginLeft: 'auto', color: 'var(--ink-3)' }}>unattached: {g.unattached.map((i) => `#${i}`).join(' · ')}</span>
+      </div>
+
+      {/* graph canvas */}
+      <div style={{ overflow: 'auto', flex: 1, minHeight: 0, border: '1px solid var(--line-1)', borderRadius: 'var(--radius-3)', background: 'var(--surface-app)' }}>
+        <div style={{ position: 'relative', width: W, height: H }}>
+          <svg width={W} height={H} style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>
+            <defs>
+              <marker id="dg-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+                <path d="M 0 0.5 L 7.5 4 L 0 7.5 z" fill="var(--line-2)"></path>
+              </marker>
+              <marker id="dg-arrow-crit" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+                <path d="M 0 0.5 L 7.5 4 L 0 7.5 z" fill="var(--accent)"></path>
+              </marker>
+            </defs>
+            {g.edges.map((e, i) => (
+              <path key={i} d={edgePath(e)} fill="none"
+                    stroke={e.crit ? 'var(--accent)' : 'var(--line-2)'}
+                    strokeWidth={e.crit ? 2 : 1.5}
+                    markerEnd={`url(#${e.crit ? 'dg-arrow-crit' : 'dg-arrow'})`} />
+            ))}
+          </svg>
+          {g.nodes.map((n) => <Node key={n.id} n={n} />)}
+          {/* milestone terminal */}
+          <div style={{
+            position: 'absolute', left: pos['ms'].x, top: pos['ms'].y, width: MSW, height: MSH,
+            display: 'flex', alignItems: 'center', gap: 8, padding: '0 14px',
+            background: 'var(--accent)', color: 'var(--ink-inverse)',
+            borderRadius: 'var(--radius-round)', boxShadow: 'var(--shadow-2)',
+          }}>
+            <Icon name="milestone" size={15} />
+            <div style={{ display: 'flex', flexDirection: 'column' }}>
+              <span style={{ font: '600 12.5px/1.2 var(--font-sans)' }}>{g.milestone.name}</span>
+              <span style={{ font: '400 10.5px/1.2 var(--font-mono)', opacity: 0.8 }}>due {g.milestone.due}</span>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+        Four issues sit on the critical path, and #87 is the cork in the bottle. Remove it and everything pours.
+      </p>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/directives-screen.tsx

@@ -0,0 +1,133 @@
+import React from 'react'
+
+import { DIRECTIVES, type DirectivePending, type DirectiveEntry } from '../../data/fixtures.js'
+import { Card, Button, Badge, Icon } from '../ui/index.js'
+
+// Directive log — append-only ledger + the consequence diff (propose-approve)
+export function DirectivesScreen() {
+  const [pending, setPending] = React.useState<DirectivePending | null>(DIRECTIVES.pending)
+  const [entries, setEntries] = React.useState<DirectiveEntry[]>(DIRECTIVES.entries)
+
+  // Real ledger from the pm-state repo, when it exists — else the fixture demo.
+  React.useEffect(() => {
+    let alive = true
+    window.commitea.pmstate
+      .directives()
+      .then((r) => {
+        if (!alive || !r.ok || r.directives.length === 0) return
+        setPending(null)
+        setEntries(
+          r.directives
+            .slice()
+            .reverse()
+            .map((d) => ({
+              seq: d.seq,
+              who: 'You',
+              when: new Date(d.ts).toLocaleDateString(),
+              what: d.quote,
+              why: d.rationale ?? '',
+              status: d.status === 'accepted' ? 'applied' : d.status === 'withdrawn' ? 'withdrawn' : 'superseded',
+              consequence: '',
+            })),
+        )
+      })
+      .catch(() => {})
+    return () => {
+      alive = false
+    }
+  }, [])
+
+  const resolve = (status: string) => {
+    setEntries((e) => [{
+      seq: pending!.seq, who: pending!.who, when: pending!.when, what: pending!.what, why: 'pilot demo on the 14th',
+      status, consequence: status === 'applied' ? '#78 +5d · Beta 80% Mar 5–14' : 'withdrawn before apply',
+    }, ...e]);
+    setPending(null);
+  };
+
+  const toneColor: Record<string, string> = { ok: 'var(--ok)', warn: 'var(--warn)', info: 'var(--info)', danger: 'var(--danger)' };
+  const statusBadge: Record<string, { tone: 'ok' | 'neutral' | 'info'; label: string }> = {
+    applied: { tone: 'ok', label: 'applied' },
+    withdrawn: { tone: 'neutral', label: 'withdrawn' },
+    superseded: { tone: 'info', label: 'superseded' },
+  };
+
+  return (
+    <div style={{ maxWidth: 760, margin: '0 auto', display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14 }}>
+        <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Directives</h1>
+        <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0' }}>append-only · JSONL in pm-state · who, when, what, why</p>
+      </header>
+
+      {pending ? (
+        <Card overline={`Awaiting your word · directive #00${pending.seq}`} title="Consequence diff" jade
+              footer={<>
+                <Button onClick={() => resolve('applied')}>Make it so</Button>
+                <Button variant="secondary" onClick={() => {}}>Amend</Button>
+                <Button variant="ghost" onClick={() => resolve('withdrawn')}>Withdraw</Button>
+              </>}>
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+            <p style={{ font: 'var(--text-body)', margin: 0, color: 'var(--ink-2)' }}>
+              <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)' }}>{pending.who}</span>
+              <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)' }}> · {pending.when}</span>
+              <br />“{pending.what}”
+            </p>
+            <div style={{ borderTop: '1px solid var(--line-1)' }}>
+              {pending.diff.map((r) => (
+                <div key={r.change} style={{ display: 'flex', alignItems: 'center', gap: 10, padding: '9px 0', borderBottom: '1px solid var(--line-1)' }}>
+                  <span style={{ width: 7, height: 7, borderRadius: '50%', background: toneColor[r.tone], flexShrink: 0 }}></span>
+                  <span style={{ font: 'var(--text-small)', color: 'var(--ink-1)', flex: 1 }}>{r.change}</span>
+                  <span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap' }}>
+                    {r.from} <span style={{ color: 'var(--ink-2)' }}>→</span> <span style={{ color: r.tone === 'warn' ? 'var(--warn)' : 'var(--ink-1)' }}>{r.to}</span>
+                  </span>
+                </div>
+              ))}
+            </div>
+            <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+              Cheap, as consequences go. Shall I make it so?
+            </p>
+          </div>
+        </Card>
+      ) : (
+        <div style={{ display: 'flex', alignItems: 'center', gap: 8, font: 'var(--text-small)', color: 'var(--ink-3)', padding: '2px 2px' }}>
+          <Icon name="circle-check" size={14} style={{ color: 'var(--ok)' }} />
+          Nothing awaits your word. Directives are given in chat; consequences appear here first.
+        </div>
+      )}
+
+      <Card overline="The ledger" flush>
+        <div>
+          {entries.map((e, i) => {
+            const sb = statusBadge[e.status];
+            return (
+              <div key={e.seq} style={{ display: 'flex', gap: 14, padding: '14px 20px', borderTop: i === 0 ? 'none' : '1px solid var(--line-1)' }}>
+                <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 6, flexShrink: 0 }}>
+                  <span style={{ font: '500 11px var(--font-mono)', color: 'var(--ink-3)' }}>#00{e.seq}</span>
+                  <span style={{ width: 1, flex: 1, background: 'var(--line-1)' }}></span>
+                </div>
+                <div style={{ flex: 1, minWidth: 0, display: 'flex', flexDirection: 'column', gap: 5 }}>
+                  <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+                    <span style={{
+                      width: 20, height: 20, borderRadius: '50%', background: 'var(--spruce-2)', color: 'var(--accent-text)',
+                      font: '600 8.5px/20px var(--font-sans)', textAlign: 'center', flexShrink: 0,
+                    }}>{e.who.split(' ').map((w: string) => w[0]).join('')}</span>
+                    <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)', whiteSpace: 'nowrap' }}>{e.who}</span>
+                    <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap' }}>{e.when}</span>
+                    {e.why ? <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap' }}>· why: {e.why}</span> : null}
+                    <span style={{ marginLeft: 'auto' }}><Badge tone={sb.tone}>{sb.label}</Badge></span>
+                  </div>
+                  <p style={{ font: 'var(--text-body)', color: 'var(--ink-1)', margin: 0 }}>“{e.what}”</p>
+                  <p style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)', margin: 0 }}>{e.consequence}</p>
+                </div>
+              </div>
+            );
+          })}
+        </div>
+      </Card>
+
+      <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: 0 }}>
+        Entries are never edited. Corrections are new entries — the ledger remembers everything, politely.
+      </p>
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/screens/focus-screen.tsx

@@ -0,0 +1,120 @@
+import React from 'react'
+
+import { FOCUS, type FocusIssue, type IssueRef, TODAY } from '../../data/fixtures.js'
+import { type ForecastView, type FocusView } from '../../lib/backlog.js'
+import { BurnUpCone } from '../charts/chart.js'
+import { Badge, Button, Card, IconButton, Tag } from '../ui/index.js'
+
+/**
+ * Morning service — the Now/Next/Later focus cards + the burn-up cone.
+ * `focus` (scheduler) and `forecast` (Monte Carlo) override the demo fixtures
+ * when gitea is configured; both fall back to the handoff demo otherwise.
+ */
+export function FocusScreen({
+  onOpenIssue,
+  focus,
+  forecast,
+}: {
+  onOpenIssue: (issue: IssueRef) => void
+  focus?: FocusView
+  forecast?: ForecastView
+}) {
+  const view: FocusView = focus ?? { now: FOCUS.now, next: FOCUS.next, later: FOCUS.later }
+  const FocusRow = ({ slot, issue, jade }: { slot: string; issue: FocusIssue; jade?: boolean }) => (
+    <Card
+      overline={slot}
+      jade={jade}
+      title={
+        <a
+          href="#"
+          onClick={(e) => {
+            e.preventDefault()
+            onOpenIssue({ id: issue.id, title: issue.title, labels: issue.labels })
+          }}
+          style={{ color: 'inherit', border: 'none' }}
+        >
+          {issue.title}
+        </a>
+      }
+      actions={<IconButton icon="ellipsis" label="More" size="sm" />}
+      footer={
+        jade ? (
+          <>
+            <Button size="sm">Start</Button>
+            <Button size="sm" variant="ghost">
+              Defer
+            </Button>
+            <span style={{ marginLeft: 'auto', font: 'var(--text-caption)', color: 'var(--ink-3)' }}>
+              scheduler pick · critical path
+            </span>
+          </>
+        ) : null
+      }
+    >
+      <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 10, flexWrap: 'wrap' }}>
+        <span style={{ font: 'var(--text-data)', color: 'var(--ink-3)' }}>#{issue.id}</span>
+        {issue.labels.map((l) => (
+          <Tag key={l} label={l} />
+        ))}
+        {issue.steeping ? (
+          <Badge tone="warn" dot>
+            steeping {issue.steeping}
+          </Badge>
+        ) : null}
+      </div>
+      <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>{issue.rationale}</p>
+    </Card>
+  )
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header
+        style={{
+          borderBottom: 'var(--rule-double)',
+          paddingBottom: 14,
+          display: 'flex',
+          alignItems: 'baseline',
+          justifyContent: 'space-between',
+          gap: 12,
+        }}
+      >
+        <div>
+          <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Morning service</h1>
+          <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0', whiteSpace: 'nowrap' }}>
+            {TODAY} · reconcile 3.2s
+          </p>
+        </div>
+        <Badge tone="ok" dot>
+          ahead of forecast
+        </Badge>
+      </header>
+
+      <div style={{ display: 'grid', gridTemplateColumns: '1.4fr 1fr 1fr', gap: 14, alignItems: 'start' }}>
+        {view.now ? <FocusRow slot="Now" issue={view.now} jade /> : null}
+        {view.next ? <FocusRow slot="Next" issue={view.next} /> : null}
+        {view.later ? <FocusRow slot="Later" issue={view.later} /> : null}
+      </div>
+
+      <Card
+        overline={forecast ? 'Backlog · open scope' : 'Milestone · Beta'}
+        title={
+          forecast ? (
+            <>80% of the open backlog lands by <span style={{ whiteSpace: 'nowrap' }}>{forecast.rangeLabel}</span></>
+          ) : (
+            <>80% this lands <span style={{ whiteSpace: 'nowrap' }}>Mar 3–12</span></>
+          )
+        }
+        actions={<IconButton icon="chart-line" label="Open runway" size="sm" />}
+      >
+        <BurnUpCone data={forecast?.cone} />
+        <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '10px 0 0' }}>
+          {forecast
+            ? forecast.coldStart
+              ? `${forecast.scope} open ${forecast.scope === 1 ? 'issue' : 'issues'} in scope. Cold-start priors — ${forecast.calibratedN}/20 estimated closes so far; the cone tightens as the team closes work.`
+              : `${forecast.scope} open ${forecast.scope === 1 ? 'issue' : 'issues'} in scope, calibrated on ${forecast.calibratedN} closed ${forecast.calibratedN === 1 ? 'issue' : 'issues'} of your own.`
+            : 'The cone has narrowed since Friday. I’m quietly pleased.'}
+        </p>
+      </Card>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/gantt-view.tsx

@@ -0,0 +1,105 @@
+import React from 'react'
+
+import { GANTT, type GanttData, type IssueRef } from '../../data/fixtures.js'
+import { Icon } from '../ui/index.js'
+
+// Gantt drill-in — scheduler-derived bars, critical chain, 80% forecast tails
+export function GanttView({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef) => void; data?: GanttData }) {
+  const g = data ?? GANTT;
+
+  const LABELW = 232, DAYW = 21, ROWH = 36, HEADH = 30;
+  const chartW = g.days * DAYW;
+  const W = LABELW + chartW;
+  const H = HEADH + g.rows.length * ROWH;
+  const X = (d: number) => LABELW + d * DAYW;
+
+  const BAR: Record<string, { bg: string; border: string; text: string }> = {
+    done: { bg: 'var(--paper-3)', border: 'transparent', text: 'var(--ink-3)' },
+    steeping: { bg: 'var(--accent)', border: 'transparent', text: 'var(--ink-inverse)' },
+    review: { bg: 'var(--info-tint)', border: 'var(--info)', text: 'var(--info)' },
+    scheduled: { bg: 'var(--spruce-2)', border: 'var(--spruce-3)', text: 'var(--accent-text)' },
+  };
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 12, flex: 1, minHeight: 0 }}>
+      {/* legend */}
+      <div style={{ display: 'flex', alignItems: 'center', gap: 16, font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap', flexWrap: 'wrap' }}>
+        {[['steeping', 'in work'], ['review', 'in review'], ['scheduled', 'scheduled'], ['done', 'done']].map(([k, label]) => (
+          <span key={k} style={{ display: 'inline-flex', alignItems: 'center', gap: 6 }}>
+            <span style={{ width: 16, height: 9, borderRadius: 3, background: BAR[k].bg, border: `1px solid ${BAR[k].border}`, display: 'inline-block' }}></span>{label}
+          </span>
+        ))}
+        <span style={{ display: 'inline-flex', alignItems: 'center', gap: 6 }}>
+          <span style={{ width: 18, height: 0, borderTop: '2px dotted var(--cone-line)', display: 'inline-block' }}></span>80% tail
+        </span>
+        <span style={{ display: 'inline-flex', alignItems: 'center', gap: 6 }}>
+          <span style={{ width: 2, height: 12, background: 'var(--jade)', display: 'inline-block' }}></span>today
+        </span>
+      </div>
+
+      {/* chart */}
+      <div style={{ overflow: 'auto', flex: 1, minHeight: 0, border: '1px solid var(--line-1)', borderRadius: 'var(--radius-3)', background: 'var(--surface-card)' }}>
+        <div style={{ position: 'relative', width: W, height: H }}>
+          {/* week gridlines + labels */}
+          {g.weeks.map((w) => (
+            <React.Fragment key={w.at}>
+              <div style={{ position: 'absolute', left: X(w.at), top: HEADH, bottom: 0, width: 1, background: 'var(--line-1)' }}></div>
+              <span style={{ position: 'absolute', left: X(w.at) + 5, top: 8, font: '400 10.5px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap' }}>{w.label}</span>
+            </React.Fragment>
+          ))}
+          {/* milestone 80% band */}
+          <div style={{ position: 'absolute', left: X(g.band.from), width: (g.band.to - g.band.from) * DAYW, top: HEADH, bottom: 0, background: 'var(--cone-fill)' }}></div>
+          <span style={{ position: 'absolute', left: X(g.band.from) + 5, bottom: 6, font: '500 10.5px var(--font-mono)', color: 'var(--cone-line)', whiteSpace: 'nowrap' }}>{g.band.label}</span>
+          {/* due marker */}
+          <div style={{ position: 'absolute', left: X(g.due.at) - 1, top: HEADH, bottom: 0, width: 2, background: 'var(--ink-1)' }}></div>
+          <span style={{ position: 'absolute', left: X(g.due.at) - 4, top: HEADH - 12, width: 8, height: 8, background: 'var(--ink-1)', transform: 'rotate(45deg)' }}></span>
+          {/* today rule */}
+          <div style={{ position: 'absolute', left: X(g.today), top: HEADH, bottom: 0, width: 2, background: 'var(--jade)' }}></div>
+
+          {/* rows */}
+          {g.rows.map((r, i) => {
+            const top = HEADH + i * ROWH;
+            const st = BAR[r.state];
+            return (
+              <React.Fragment key={r.id}>
+                {/* row hairline */}
+                <div style={{ position: 'absolute', left: 0, right: 0, top: top, height: 1, background: 'var(--line-1)', opacity: 0.6 }}></div>
+                {/* label cell (sticky) */}
+                <div
+                  onClick={() => onOpenIssue({ id: r.id, title: r.title, labels: [], days: r.state === 'steeping' ? '4d' : undefined })}
+                  style={{
+                    position: 'absolute', left: 0, width: LABELW, height: ROWH, top: top, zIndex: 2, cursor: 'pointer',
+                    display: 'flex', alignItems: 'center', gap: 8, padding: '0 12px 0 14px', background: 'var(--surface-card)',
+                    borderRight: '1px solid var(--line-1)',
+                    boxShadow: r.crit ? 'inset 2px 0 0 var(--accent)' : 'none',
+                  }}
+                >
+                  <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', flexShrink: 0 }}>#{r.id}</span>
+                  <span style={{ font: '500 12px/1.3 var(--font-sans)', color: 'var(--ink-1)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>{r.title}</span>
+                  <span style={{ font: '600 8.5px/16px var(--font-sans)', color: 'var(--accent-text)', background: 'var(--spruce-2)', width: 16, height: 16, borderRadius: '50%', textAlign: 'center', flexShrink: 0, marginLeft: 'auto' }}>{r.who}</span>
+                </div>
+                {/* bar */}
+                <div style={{
+                  position: 'absolute', left: X(r.start), width: (r.end - r.start) * DAYW, top: top + 9, height: 18,
+                  background: st.bg, border: `1px solid ${st.border}`, borderRadius: 4,
+                  boxShadow: r.crit && r.state !== 'steeping' ? 'inset 0 -2px 0 var(--accent)' : 'none',
+                }}></div>
+                {/* 80% tail */}
+                {r.p80 ? (
+                  <>
+                    <div style={{ position: 'absolute', left: X(r.end), width: (r.p80 - r.end) * DAYW, top: top + 17, height: 0, borderTop: '2px dotted var(--cone-line)' }}></div>
+                    <div style={{ position: 'absolute', left: X(r.p80) - 1, top: top + 13, width: 2, height: 10, background: 'var(--cone-line)' }}></div>
+                  </>
+                ) : null}
+              </React.Fragment>
+            );
+          })}
+        </div>
+      </div>
+
+      <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+        The path holds if #87 lands by Wednesday. The dotted tails are your own history, wagging.
+      </p>
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/screens/inbox-screen.tsx

@@ -0,0 +1,109 @@
+import React from 'react'
+
+import { INBOX, type InboxItem, type IssueRef } from '../../data/fixtures.js'
+import { Button, Card, Icon, Tabs } from '../ui/index.js'
+
+// Inbox — Reginald only rings the bell when it matters
+export function InboxScreen({
+  onOpenIssue,
+  onOpenDirectives,
+  readIds,
+  setReadIds,
+  data,
+}: {
+  onOpenIssue: (issue: IssueRef) => void
+  onOpenDirectives: () => void
+  readIds: number[]
+  setReadIds: React.Dispatch<React.SetStateAction<number[]>>
+  data?: InboxItem[]
+}) {
+  const all = data ?? INBOX
+  const [tab, setTab] = React.useState('all')
+
+  const isRead = (n: InboxItem) => !n.unread || readIds.includes(n.id)
+  const unreadCount = all.filter((n) => !isRead(n)).length
+
+  const FILTERS: Record<string, (n: InboxItem) => boolean> = {
+    all: () => true,
+    mentions: (n) => n.type === 'mention' || n.type === 'assignment',
+    drift: (n) => n.type === 'drift' || n.type === 'nag' || n.type === 'milestone',
+    system: (n) => n.type === 'system' || n.type === 'review',
+  }
+  const items = all.filter(FILTERS[tab])
+  const days = [...new Set(items.map((n) => n.day))]
+
+  const toneColor: Record<string, string> = { ok: 'var(--ok)', warn: 'var(--warn)', info: 'var(--info)', neutral: 'var(--ink-3)' }
+
+  const open = (n: InboxItem) => {
+    setReadIds((r) => (r.includes(n.id) ? r : [...r, n.id]))
+    if (n.issue) onOpenIssue(n.issue)
+    else if (n.to === 'directives') onOpenDirectives()
+  }
+
+  return (
+    <div style={{ maxWidth: 760, margin: '0 auto', display: 'flex', flexDirection: 'column', gap: 14 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14, display: 'flex', alignItems: 'baseline', justifyContent: 'space-between', gap: 12 }}>
+        <div>
+          <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Inbox</h1>
+          <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0', whiteSpace: 'nowrap' }}>
+            {unreadCount ? `${unreadCount} unread` : 'all read'} · nothing here rings twice
+          </p>
+        </div>
+        {unreadCount ? (
+          <Button variant="ghost" size="sm" onClick={() => setReadIds(all.map((n) => n.id))}>Mark all read</Button>
+        ) : null}
+      </header>
+
+      <Tabs
+        items={[
+          { id: 'all', label: 'All', count: all.length },
+          { id: 'mentions', label: 'Mentions', icon: 'message-square' },
+          { id: 'drift', label: 'Drift', icon: 'chart-line' },
+          { id: 'system', label: 'System', icon: 'refresh-cw' },
+        ]}
+        active={tab} onChange={setTab}
+      />
+
+      <Card flush>
+        <div>
+          {days.map((day) => (
+            <div key={day}>
+              <div style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', padding: '12px 20px 4px' }}>{day}</div>
+              {items.filter((n) => n.day === day).map((n) => {
+                const read = isRead(n)
+                return (
+                  <div key={n.id}
+                    onClick={() => open(n)}
+                    style={{
+                      display: 'flex', alignItems: 'flex-start', gap: 12, padding: '11px 20px',
+                      cursor: n.issue || n.to ? 'pointer' : 'default',
+                      opacity: read ? 0.72 : 1,
+                    }}
+                    onMouseEnter={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.background = 'var(--paper-2)' }}
+                    onMouseLeave={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.background = 'transparent' }}
+                  >
+                    <span style={{ width: 6, height: 6, borderRadius: '50%', background: read ? 'transparent' : 'var(--accent)', flexShrink: 0, marginTop: 7 }}></span>
+                    <span style={{ color: toneColor[n.tone], display: 'inline-flex', marginTop: 1, flexShrink: 0 }}>
+                      <Icon name={n.icon} size={15} />
+                    </span>
+                    <div style={{ flex: 1, minWidth: 0 }}>
+                      <div style={{ font: read ? 'var(--text-body)' : 'var(--text-body-strong)', color: 'var(--ink-1)' }}>
+                        {n.who ? <span style={{ fontWeight: 600 }}>{n.who} </span> : null}{n.text}
+                      </div>
+                      <div style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)', marginTop: 2 }}>{n.detail}</div>
+                    </div>
+                    <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap', marginTop: 2 }}>{n.time}</span>
+                  </div>
+                )
+              })}
+            </div>
+          ))}
+        </div>
+      </Card>
+
+      <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+        I only ring the bell when it matters. The rest can wait for morning service.
+      </p>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/issue-screen.tsx

@@ -0,0 +1,349 @@
+// Issue detail — human intent (gitea) on the left, machine-derived (pm-state) on the right
+import React, { useState } from 'react'
+
+import {
+  type EstimateLabel,
+  ESTIMATE_LABELS,
+  type IssueChange,
+  type PriorityLabel,
+  PRIORITY_LABELS,
+  summarizeChange,
+} from '@commitea/core'
+
+import { ISSUE_DETAIL, type IssueDetail, type IssueRef } from '../../data/fixtures.js'
+import { Badge, Button, Card, Dialog, Icon, Select, Tag } from '../ui/index.js'
+
+const NONE = '—'
+
+export function IssueScreen({
+  issue,
+  detail,
+  onBack,
+  onOpenIssue,
+  canWrite = false,
+  onApplyChange,
+  collaborators = [],
+  milestones = [],
+  currentAssignee = null,
+  currentMilestoneId = null,
+}: {
+  issue: IssueRef
+  detail?: IssueDetail
+  onBack: () => void
+  onOpenIssue: (issue: IssueRef) => void
+  canWrite?: boolean
+  onApplyChange?: (change: IssueChange) => Promise<{ ok: boolean }>
+  collaborators?: { login: string; name: string }[]
+  milestones?: { id: number; title: string }[]
+  currentAssignee?: string | null
+  currentMilestoneId?: number | null
+}) {
+  const det: IssueDetail = detail ?? ISSUE_DETAIL[issue.id] ?? {
+    state: 'triage',
+    assignee: 'Stephen',
+    milestone: 'Beta',
+    body: '',
+    comments: [],
+    lifecycle: [
+      { stage: 'Diagnosis', event: 'issue opened', when: 'Feb 4 · 10:20', icon: 'circle-dot', done: true },
+      { stage: 'Triage', event: 'labeled · milestoned Beta', when: 'Feb 5 · 09:12', icon: 'tag', done: true },
+      { stage: 'Work start', event: 'first branch or commit ref', when: 'pending', icon: 'git-commit-horizontal', done: false },
+      { stage: 'Deploy', event: 'PR merged', when: 'pending', icon: 'git-merge', done: false },
+      { stage: 'Complete', event: 'issue closed', when: 'pending', icon: 'circle-check', done: false },
+    ],
+    forecast: { p80: 'starts wk of Feb 16', note: 'queue position from scheduler' },
+    blocks: [],
+    blockedBy: [],
+    note: '',
+  }
+  const stateBadge = (
+    {
+      steeping: { tone: 'warn', label: `steeping${issue.days ? ' ' + issue.days : ''}` },
+      triage: { tone: 'neutral', label: 'triage' },
+      review: { tone: 'info', label: 'in review' },
+      done: { tone: 'ok', label: 'done' },
+    } as Record<string, { tone: 'warn' | 'neutral' | 'info' | 'ok'; label: string }>
+  )[det.state] || { tone: 'neutral', label: det.state }
+
+  // ---- propose-approve write path (apply_changes) ----
+  const labels = issue.labels ?? []
+  const curEstimate = labels.find((l) => l.startsWith('est/')) ?? ''
+  const curPriority = labels.find((l) => l.startsWith('p/')) ?? ''
+  const curAssignee = currentAssignee ?? ''
+  const curMilestone = currentMilestoneId != null ? String(currentMilestoneId) : ''
+  const [adjustOpen, setAdjustOpen] = useState(false)
+  const [estimate, setEstimate] = useState(curEstimate)
+  const [priority, setPriority] = useState(curPriority)
+  const [assignee, setAssignee] = useState(curAssignee)
+  const [milestone, setMilestone] = useState(curMilestone)
+  const [applying, setApplying] = useState(false)
+
+  const openAdjust = () => {
+    setEstimate(curEstimate)
+    setPriority(curPriority)
+    setAssignee(curAssignee)
+    setMilestone(curMilestone)
+    setAdjustOpen(true)
+  }
+
+  // the concrete changes this dialog would apply, one per field that differs
+  const pendingChanges: IssueChange[] = []
+  if (estimate !== curEstimate)
+    pendingChanges.push({ kind: 'reestimate', issue: issue.id, estimate: (estimate || null) as EstimateLabel | null })
+  if (priority !== curPriority)
+    pendingChanges.push({ kind: 'reprioritize', issue: issue.id, priority: (priority || null) as PriorityLabel | null })
+  if (assignee !== curAssignee)
+    pendingChanges.push({ kind: 'assign', issue: issue.id, assignee: assignee || null })
+  if (milestone !== curMilestone)
+    pendingChanges.push({
+      kind: 'remilestone',
+      issue: issue.id,
+      milestone: milestone ? Number(milestone) : null,
+      milestoneTitle: milestones.find((m) => String(m.id) === milestone)?.title ?? null,
+    })
+
+  const diffs = pendingChanges.map((c) => summarizeChange(c, labels))
+
+  const apply = async () => {
+    if (!onApplyChange || pendingChanges.length === 0) return
+    setApplying(true)
+    try {
+      for (const c of pendingChanges) await onApplyChange(c)
+      setAdjustOpen(false)
+    } finally {
+      setApplying(false)
+    }
+  }
+
+  const estOptions = [{ value: '', label: NONE }, ...ESTIMATE_LABELS.map((l) => ({ value: l, label: l }))]
+  const prioOptions = [{ value: '', label: NONE }, ...PRIORITY_LABELS.map((l) => ({ value: l, label: l }))]
+  const assigneeOptions = [
+    { value: '', label: 'Unassigned' },
+    ...collaborators.map((c) => ({ value: c.login, label: c.name })),
+  ]
+  const milestoneOptions = [
+    { value: '', label: NONE },
+    ...milestones.map((m) => ({ value: String(m.id), label: m.title })),
+  ]
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      {/* breadcrumb + header */}
+      <div>
+        <button type="button" onClick={onBack} style={{
+          display: 'inline-flex', alignItems: 'center', gap: 6, background: 'none', border: 'none',
+          font: '500 12.5px var(--font-sans)', color: 'var(--ink-2)', cursor: 'pointer', padding: '2px 0', marginBottom: 10,
+        }}>
+          <Icon name="arrow-left" size={14} /> Back
+        </button>
+        <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14, display: 'flex', alignItems: 'flex-start', gap: 16 }}>
+          <div style={{ flex: 1, minWidth: 0 }}>
+            <p style={{ font: '400 13px var(--font-mono)', color: 'var(--ink-3)', margin: '0 0 6px' }}>#{issue.id} · stephen/commitea</p>
+            <h1 style={{ font: 'var(--text-title)', color: 'var(--ink-1)', margin: 0 }}>{issue.title}</h1>
+            <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginTop: 10, flexWrap: 'wrap' }}>
+              <Badge tone={stateBadge.tone} dot>{stateBadge.label}</Badge>
+              {(issue.labels || []).map((l) => <Tag key={l} label={l} />)}
+              <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)', display: 'inline-flex', alignItems: 'center', gap: 5 }}>
+                <Icon name="milestone" size={12} />{det.milestone}
+              </span>
+              <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)', display: 'inline-flex', alignItems: 'center', gap: 5 }}>
+                <Icon name="user" size={12} />{det.assignee}
+              </span>
+            </div>
+          </div>
+          <div style={{ display: 'flex', gap: 8, flexShrink: 0 }}>
+            {canWrite ? (
+              <Button variant="secondary" icon="pencil" onClick={openAdjust}>
+                Adjust
+              </Button>
+            ) : null}
+            <Button variant="secondary" icon="arrow-up-right">Open in Gitea</Button>
+          </div>
+        </header>
+      </div>
+
+      <Dialog
+        open={adjustOpen}
+        onClose={() => setAdjustOpen(false)}
+        title="Adjust issue"
+        footer={
+          <>
+            <Button variant="ghost" onClick={() => setAdjustOpen(false)}>
+              Cancel
+            </Button>
+            <Button onClick={apply} disabled={pendingChanges.length === 0 || applying}>
+              {applying ? 'Applying…' : 'Apply to gitea'}
+            </Button>
+          </>
+        }
+      >
+        <div style={{ display: 'flex', gap: 14 }}>
+          <Select
+            label="Estimate"
+            options={estOptions}
+            value={estimate}
+            onChange={(e) => setEstimate(e.target.value)}
+          />
+          <Select
+            label="Priority"
+            options={prioOptions}
+            value={priority}
+            onChange={(e) => setPriority(e.target.value)}
+          />
+        </div>
+        {(collaborators.length > 0 || milestones.length > 0) && (
+          <div style={{ display: 'flex', gap: 14, marginTop: 12 }}>
+            {collaborators.length > 0 ? (
+              <Select
+                label="Assignee"
+                options={assigneeOptions}
+                value={assignee}
+                onChange={(e) => setAssignee(e.target.value)}
+              />
+            ) : null}
+            {milestones.length > 0 ? (
+              <Select
+                label="Milestone"
+                options={milestoneOptions}
+                value={milestone}
+                onChange={(e) => setMilestone(e.target.value)}
+              />
+            ) : null}
+          </div>
+        )}
+        <div style={{ marginTop: 14, minHeight: 40 }}>
+          {pendingChanges.length === 0 ? (
+            <p style={{ font: 'var(--text-agent)', color: 'var(--ink-3)', margin: 0 }}>
+              No change yet — pick a different estimate, priority, assignee, or milestone.
+            </p>
+          ) : (
+            <>
+              <p style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', margin: '0 0 6px' }}>
+                Proposed change
+              </p>
+              {diffs.map((d) => (
+                <div key={d} style={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>
+                  {d}
+                </div>
+              ))}
+              <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '8px 0 0' }}>
+                Writes to gitea and re-runs the plan. Nothing else changes.
+              </p>
+            </>
+          )}
+        </div>
+      </Dialog>
+
+      <div style={{ display: 'grid', gridTemplateColumns: '1fr 300px', gap: 16, alignItems: 'start' }}>
+        {/* left: human intent */}
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+          <Card overline="Description">
+            {det.body ? (
+              <p style={{ font: 'var(--text-body)', color: 'var(--ink-1)', margin: 0, lineHeight: 1.6 }}>{det.body}</p>
+            ) : (
+              <p style={{ font: 'var(--text-agent)', color: 'var(--ink-3)', margin: 0 }}>
+                No description was written. I have opinions about that, but I'll keep them warm.
+              </p>
+            )}
+          </Card>
+
+          <Card overline={`Comments · ${det.comments.length}`} flush>
+            <div>
+              {det.comments.map((c, i) => (
+                <div key={i} style={{ display: 'flex', gap: 12, padding: '14px 20px', borderBottom: '1px solid var(--line-1)' }}>
+                  <span style={{
+                    width: 24, height: 24, borderRadius: '50%', background: 'var(--spruce-2)', color: 'var(--accent-text)',
+                    font: '600 9px/24px var(--font-sans)', textAlign: 'center', flexShrink: 0,
+                  }}>{c.who.split(' ').map((w) => w[0]).join('')}</span>
+                  <div style={{ flex: 1, minWidth: 0 }}>
+                    <div style={{ display: 'flex', alignItems: 'baseline', gap: 8 }}>
+                      <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)', whiteSpace: 'nowrap' }}>{c.who}</span>
+                      <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap' }}>{c.when}</span>
+                    </div>
+                    <p style={{ font: 'var(--text-body)', color: 'var(--ink-1)', margin: '4px 0 0' }}>{c.text}</p>
+                  </div>
+                </div>
+              ))}
+              <div style={{ display: 'flex', gap: 8, padding: '14px 20px', alignItems: 'flex-end' }}>
+                <textarea placeholder="Comment — this writes to gitea, as you" rows={2} style={{
+                  flex: 1, resize: 'none', font: 'var(--text-body)', color: 'var(--ink-1)', lineHeight: 1.5,
+                  background: 'var(--paper-0)', border: '1px solid var(--line-2)', borderRadius: 'var(--radius-2)',
+                  padding: '8px 11px', outline: 'none',
+                }}></textarea>
+                <Button size="sm" variant="secondary">Comment</Button>
+              </div>
+            </div>
+          </Card>
+
+          {det.note ? (
+            <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0, padding: '0 2px' }}>{det.note}</p>
+          ) : null}
+        </div>
+
+        {/* right: machine-derived sidecar */}
+        <Card overline="Machine-derived" flush>
+          <div style={{ display: 'flex', flexDirection: 'column' }}>
+            {/* lifecycle */}
+            <div style={{ padding: '14px 20px', display: 'flex', flexDirection: 'column', gap: 0 }}>
+              {det.lifecycle.map((s, i) => (
+                <div key={s.stage} style={{ display: 'flex', gap: 10 }}>
+                  <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center' }}>
+                    <span style={{ display: 'inline-flex', color: s.done ? 'var(--ok)' : 'var(--ink-3)', padding: '2px 0' }}>
+                      <Icon name={s.icon} size={14} />
+                    </span>
+                    {i < det.lifecycle.length - 1 ? <span style={{ width: 1, flex: 1, minHeight: 14, background: s.done ? 'var(--spruce-3)' : 'var(--line-1)' }}></span> : null}
+                  </div>
+                  <div style={{ paddingBottom: i < det.lifecycle.length - 1 ? 12 : 0 }}>
+                    <div style={{ font: `500 12px var(--font-sans)`, color: s.done ? 'var(--ink-1)' : 'var(--ink-3)' }}>{s.stage}</div>
+                    <div style={{ font: '400 10.5px var(--font-mono)', color: 'var(--ink-3)', marginTop: 2, whiteSpace: 'nowrap' }}>{s.event}</div>
+                    <div style={{ font: '400 10.5px var(--font-mono)', color: s.done ? 'var(--ink-2)' : 'var(--ink-3)', whiteSpace: 'nowrap' }}>{s.when}</div>
+                  </div>
+                </div>
+              ))}
+            </div>
+            {/* forecast */}
+            <div style={{ padding: '12px 20px', borderTop: '1px solid var(--line-1)' }}>
+              <div style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', marginBottom: 6 }}>Forecast</div>
+              <div style={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>80% {det.forecast.p80}</div>
+              <div style={{ font: '400 10.5px var(--font-mono)', color: 'var(--ink-3)', marginTop: 3 }}>{det.forecast.note}</div>
+            </div>
+            {/* dependencies */}
+            <div style={{ padding: '12px 20px', borderTop: '1px solid var(--line-1)' }}>
+              <div style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', marginBottom: 6 }}>Dependencies</div>
+              {det.blocks.length === 0 && det.blockedBy.length === 0 ? (
+                <div style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)' }}>none</div>
+              ) : (
+                <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+                  {det.blocks.length ? (
+                    <div style={{ display: 'flex', alignItems: 'center', gap: 6, flexWrap: 'wrap' }}>
+                      <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>blocks</span>
+                      {det.blocks.map((b) => (
+                        <button key={b} type="button"
+                          onClick={() => onOpenIssue({ id: b })}
+                          style={{ font: '500 11px var(--font-mono)', color: 'var(--accent-text)', background: 'var(--spruce-1)', border: '1px solid var(--spruce-2)', borderRadius: 'var(--radius-1)', padding: '2px 7px', cursor: 'pointer' }}>
+                          #{b}
+                        </button>
+                      ))}
+                    </div>
+                  ) : null}
+                  {det.blockedBy.length ? (
+                    <div style={{ display: 'flex', alignItems: 'center', gap: 6 }}>
+                      <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>blocked by</span>
+                      {det.blockedBy.map((b) => <span key={b} style={{ font: '500 11px var(--font-mono)', color: 'var(--ink-2)' }}>#{b}</span>)}
+                    </div>
+                  ) : null}
+                </div>
+              )}
+            </div>
+            {/* provenance note */}
+            <div style={{ padding: '10px 20px 14px', borderTop: '1px solid var(--line-1)' }}>
+              <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: 0 }}>
+                Lives in pm-state. Your repo never sees any of it.
+              </p>
+            </div>
+          </div>
+        </Card>
+      </div>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/milestone-screen.tsx

@@ -0,0 +1,128 @@
+import React from 'react'
+
+import { COLUMNS, type IssueRef } from '../../data/fixtures.js'
+import { type MilestoneView } from '../../lib/backlog.js'
+import { BurnUpCone } from '../charts/chart.js'
+import { Badge, Button, Card, Icon, Tag } from '../ui/index.js'
+
+// Milestone detail — scope, cone, issues; forecasts stay ranges.
+// `data` (real milestone forecast) overrides the demo fixture when present.
+export function MilestoneScreen({
+  onBack,
+  onOpenIssue,
+  data,
+}: {
+  onBack: () => void
+  onOpenIssue: (issue: IssueRef) => void
+  data?: MilestoneView
+}) {
+  const cols = COLUMNS
+  const byState = (ids: number[]) =>
+    cols.flatMap((c) => c.issues.map((i) => ({ ...i, col: c.label }))).filter((i) => ids.includes(i.id))
+
+  const fixtureGroups = [
+    { label: 'Steeping', issues: byState([87, 84]) },
+    { label: 'In review', issues: byState([92]) },
+    { label: 'Queued', issues: byState([102, 103, 99, 96, 78]) },
+    { label: 'Done', issues: byState([71, 69, 65]), muted: true },
+  ]
+
+  // real or demo, in one shape the render loop understands
+  const groups = data
+    ? data.groups.map((g) => ({ label: g.label, issues: g.issues, muted: g.label === 'Done' }))
+    : fixtureGroups
+  const name = data ? data.name : 'Beta'
+  const dueLine = data
+    ? `milestone · due ${data.due} · ${data.soft ? 'soft — scope may flex' : 'hard deadline'}`
+    : 'milestone · due Mar 15 · soft — scope may flex'
+  const forecastLabel = data ? (data.forecastRange ? `80% ${data.forecastRange}` : 'all shipped') : '80% Mar 3–12'
+  const scopeStat = data ? `${data.scopeCount} issues · est ${data.scopeEstDays}d` : '42 issues · est 61d'
+  const doneStat = data ? `${data.doneCount} · ${data.donePct}%` : '24 · 57%'
+
+  const Stat = ({ label, value, tone }: { label: string; value: string; tone?: string }) => (
+    <div style={{ flex: 1, padding: '12px 18px', borderRight: '1px solid var(--line-1)' }}>
+      <div style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', marginBottom: 5 }}>{label}</div>
+      <div style={{ font: `500 14px var(--font-mono)`, color: tone || 'var(--ink-1)', whiteSpace: 'nowrap' }}>{value}</div>
+    </div>
+  )
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <div>
+        <button type="button" onClick={onBack} style={{
+          display: 'inline-flex', alignItems: 'center', gap: 6, background: 'none', border: 'none',
+          font: '500 12.5px var(--font-sans)', color: 'var(--ink-2)', cursor: 'pointer', padding: '2px 0', marginBottom: 10,
+        }}>
+          <Icon name="arrow-left" size={14} /> Runway
+        </button>
+        <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14, display: 'flex', alignItems: 'flex-start', gap: 16 }}>
+          <div style={{ flex: 1, minWidth: 0 }}>
+            <p style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-3)', margin: '0 0 6px', display: 'inline-flex', alignItems: 'center', gap: 6 }}>
+              <Icon name="milestone" size={13} /> {dueLine}
+            </p>
+            <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>{name}</h1>
+            <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginTop: 10 }}>
+              <Badge tone="ok" dot>{data ? `${data.doneCount}/${data.scopeCount} done` : 'ahead of forecast'}</Badge>
+              <span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>{forecastLabel}</span>
+            </div>
+          </div>
+          <Button variant="secondary" icon="arrow-up-right">Open in Gitea</Button>
+        </header>
+      </div>
+
+      {/* stats strip */}
+      <Card flush>
+        <div style={{ display: 'flex' }}>
+          <Stat label="Scope" value={scopeStat} />
+          <Stat label="Done" value={doneStat} />
+          <Stat label="Forecast" value={forecastLabel} />
+          <div style={{ flex: 1, padding: '12px 18px' }}>
+            <div style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', marginBottom: 5 }}>Remaining</div>
+            <div style={{ font: '500 14px var(--font-mono)', color: 'var(--ink-1)', whiteSpace: 'nowrap' }}>{data ? `${data.scopeCount - data.doneCount} open` : '−2d · cone narrowed'}</div>
+          </div>
+        </div>
+      </Card>
+
+      <div style={{ display: 'grid', gridTemplateColumns: '1.2fr 1fr', gap: 14, alignItems: 'start' }}>
+        <Card overline="Burn-up" title={<>80% this lands <span style={{ whiteSpace: 'nowrap' }}>{data ? (data.forecastRange ?? 'shipped') : 'Mar 3–12'}</span></>} jade>
+          <BurnUpCone data={data?.cone ?? undefined} />
+          <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '10px 0 0' }}>
+            {data
+              ? data.cone
+                ? `${data.scopeCount - data.doneCount} open of ${data.scopeCount}. Cone over what's left.`
+                : 'Everything here has shipped.'
+              : 'Comfortably ahead. Beta needs #87 more than it needs my commentary.'}
+          </p>
+        </Card>
+
+        <Card overline="Issues" flush>
+          <div>
+            {groups.map((g) => (
+              <div key={g.label}>
+                <div style={{ display: 'flex', alignItems: 'center', gap: 7, padding: '10px 20px 6px' }}>
+                  <span style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)' }}>{g.label}</span>
+                  <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>{g.issues.length}</span>
+                </div>
+                {g.issues.map((i) => (
+                  <div key={i.id}
+                    onClick={() => onOpenIssue({ id: i.id, title: i.title, labels: i.labels, days: i.days })}
+                    style={{
+                      display: 'flex', alignItems: 'center', gap: 8, padding: '7px 20px', cursor: 'pointer',
+                      opacity: g.muted ? 0.6 : 1,
+                    }}
+                    onMouseEnter={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.background = 'var(--paper-2)'; }}
+                    onMouseLeave={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.background = 'transparent'; }}
+                  >
+                    <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', width: 34, flexShrink: 0 }}>#{i.id}</span>
+                    <span style={{ font: 'var(--text-small)', color: 'var(--ink-1)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', flex: 1 }}>{i.title}</span>
+                    {(i.labels || []).filter((l) => l.startsWith('est/')).map((l) => <Tag key={l} label={l} />)}
+                  </div>
+                ))}
+              </div>
+            ))}
+          </div>
+        </Card>
+      </div>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/onboarding-screen.tsx

@@ -0,0 +1,169 @@
+import React from 'react'
+
+import logoIcon from '../../design/assets/logo-icon.png'
+import { Badge, Button, Icon, Input, Radio, Tag } from '../ui/index.js'
+
+// Onboarding / first connect — welcome → connect gitea → choose repo → bootstrap
+export function OnboardingScreen({ onDone }: { onDone: (dest: 'focus' | 'capture') => void }) {
+  const [step, setStep] = React.useState<number>(0)
+  const [conn, setConn] = React.useState<'idle' | 'testing' | 'ok'>('idle')
+  const [repo, setRepo] = React.useState('stephen/commitea')
+  const [boot, setBoot] = React.useState<number>(-1) // -1 idle, 0..2 running, 3 done
+
+  React.useEffect(() => {
+    if (conn !== 'testing') return
+    const t = setTimeout(() => setConn('ok'), 1100)
+    return () => clearTimeout(t)
+  }, [conn])
+
+  React.useEffect(() => {
+    if (boot < 0 || boot >= 3) return
+    const t = setTimeout(() => setBoot(boot + 1), 700)
+    return () => clearTimeout(t)
+  }, [boot])
+
+  const STEPS = ['Welcome', 'Connect', 'Repo', 'Bootstrap']
+  const BOOT_TASKS = [
+    'Create stephen/pm-state (the sidecar)',
+    'Apply the label schema to stephen/commitea',
+    'Install a webhook · endpoint :48731',
+  ]
+
+  const Frame = ({ children, footer }: { children: React.ReactNode; footer?: React.ReactNode }) => (
+    <div style={{
+      background: 'var(--surface-card)', border: '1px solid var(--line-1)', borderRadius: 'var(--radius-3)',
+      boxShadow: 'var(--shadow-jade-line), var(--shadow-2)', padding: '30px 36px',
+      display: 'flex', flexDirection: 'column', gap: 16, width: '100%',
+    }}>
+      {children}
+      {footer ? <div style={{ display: 'flex', gap: 8, justifyContent: 'flex-end', borderTop: '1px solid var(--line-1)', paddingTop: 16 }}>{footer}</div> : null}
+    </div>
+  )
+
+  return (
+    <div style={{
+      minHeight: '100vh', background: 'var(--surface-app)', display: 'flex', flexDirection: 'column',
+      alignItems: 'center', justifyContent: 'center', padding: 32, gap: 22,
+    }} data-screen-label="onboarding">
+      {/* brand */}
+      <div style={{ display: 'flex', alignItems: 'center', gap: 12 }}>
+        <img src={logoIcon} width="34" height="34" alt="" style={{ borderRadius: 8, display: 'block' }} />
+        <span style={{ font: '400 27px/1 var(--font-serif-display)', color: 'var(--ink-1)' }}>
+          Commi<span style={{ color: 'var(--accent-text)' }}>Tea</span>
+        </span>
+      </div>
+
+      {/* stepper */}
+      <div style={{ display: 'flex', alignItems: 'center', gap: 14 }}>
+        {STEPS.map((s, i) => (
+          <div key={s} style={{ display: 'flex', alignItems: 'center', gap: 14 }}>
+            <span style={{ display: 'inline-flex', alignItems: 'center', gap: 7 }}>
+              <span style={{
+                width: 20, height: 20, borderRadius: '50%', textAlign: 'center',
+                font: '500 10.5px/20px var(--font-mono)',
+                background: i < step ? 'var(--accent)' : i === step ? 'var(--spruce-2)' : 'var(--paper-2)',
+                color: i < step ? 'var(--ink-inverse)' : i === step ? 'var(--accent-text)' : 'var(--ink-3)',
+              }}>{i < step ? '✓' : i + 1}</span>
+              <span style={{ font: `${i === step ? 600 : 400} 12px/1 var(--font-sans)`, color: i === step ? 'var(--ink-1)' : 'var(--ink-3)' }}>{s}</span>
+            </span>
+            {i < STEPS.length - 1 ? <span style={{ width: 24, height: 1, background: 'var(--line-2)' }}></span> : null}
+          </div>
+        ))}
+      </div>
+
+      <div style={{ width: 'min(540px, 100%)' }}>
+        {step === 0 ? (
+          <Frame footer={<Button iconRight="arrow-right" onClick={() => setStep(1)}>Begin</Button>}>
+            <h1 style={{ font: 'var(--text-title)', color: 'var(--ink-1)', margin: 0 }}>Good morning.</h1>
+            <p style={{ font: 'var(--text-agent-lg)', color: 'var(--ink-2)', margin: 0 }}>
+              I'm Reginald, your project manager. I interview you instead of making you fill in forms,
+              I forecast in honest ranges, and I never do the arithmetic myself — there's a scheduler for that.
+            </p>
+            <p style={{ font: 'var(--text-body)', color: 'var(--ink-2)', margin: 0 }}>
+              Your plans live in your own Gitea as ordinary issues and labels. Delete me and nothing human is lost.
+            </p>
+          </Frame>
+        ) : null}
+
+        {step === 1 ? (
+          <Frame footer={<>
+            <Button variant="ghost" onClick={() => setStep(0)}>Back</Button>
+            <Button iconRight="arrow-right" disabled={conn !== 'ok'} onClick={() => setStep(2)}>Continue</Button>
+          </>}>
+            <h1 style={{ font: 'var(--text-title)', color: 'var(--ink-1)', margin: 0 }}>Your Gitea</h1>
+            <Input label="Base URL" icon="link" mono defaultValue="https://gitea.stephenmann.io" />
+            <Input label="Access token" icon="keyboard" mono type="password" defaultValue="ct_9f2e81c4a7d6" hint="Scopes: repo, issue. Nothing more." />
+            <div style={{ display: 'flex', alignItems: 'center', gap: 12 }}>
+              <Button variant="secondary" icon={conn === 'testing' ? 'loader-circle' : 'zap'} disabled={conn === 'testing'} onClick={() => setConn('testing')}>
+                {conn === 'testing' ? 'Ringing the bell…' : 'Test connection'}
+              </Button>
+              {conn === 'ok' ? <Badge tone="ok" dot>connected · 3 repos visible</Badge> : null}
+            </div>
+          </Frame>
+        ) : null}
+
+        {step === 2 ? (
+          <Frame footer={<>
+            <Button variant="ghost" onClick={() => setStep(1)}>Back</Button>
+            <Button iconRight="arrow-right" onClick={() => setStep(3)}>Continue</Button>
+          </>}>
+            <h1 style={{ font: 'var(--text-title)', color: 'var(--ink-1)', margin: 0 }}>Which repo shall I manage?</h1>
+            <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
+              {['stephen/commitea', 'stephen/novelpad', 'stephen/infra'].map((r: string) => (
+                <label key={r} style={{
+                  display: 'flex', alignItems: 'center', gap: 10, padding: '10px 14px', cursor: 'pointer',
+                  background: repo === r ? 'var(--spruce-1)' : 'var(--paper-0)',
+                  border: `1px solid ${repo === r ? 'var(--spruce-3)' : 'var(--line-1)'}`,
+                  borderRadius: 'var(--radius-2)',
+                }}>
+                  <Radio name="repo" checked={repo === r} onChange={() => setRepo(r)} />
+                  <Icon name="git-branch" size={14} style={{ color: 'var(--ink-3)' }} />
+                  <span style={{ font: 'var(--text-data)', color: 'var(--ink-1)' }}>{r}</span>
+                </label>
+              ))}
+            </div>
+            <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: 0 }}>One to start. You can add more later in Settings.</p>
+          </Frame>
+        ) : null}
+
+        {step === 3 ? (
+          <Frame footer={boot === 3 ? <>
+            <Button variant="ghost" onClick={() => onDone('focus')}>Just look around</Button>
+            <Button icon="sparkles" onClick={() => onDone('capture')}>Start a capture</Button>
+          </> : <>
+            <Button variant="ghost" onClick={() => setStep(2)} disabled={boot >= 0}>Back</Button>
+            <Button disabled={boot >= 0} onClick={() => setBoot(0)}>Make it so</Button>
+          </>}>
+            <h1 style={{ font: 'var(--text-title)', color: 'var(--ink-1)', margin: 0 }}>
+              {boot === 3 ? 'All set.' : 'With your approval'}
+            </h1>
+            <div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
+              {BOOT_TASKS.map((t: string, i: number) => (
+                <div key={t} style={{ display: 'flex', alignItems: 'center', gap: 10 }}>
+                  <span style={{ display: 'inline-flex', color: boot > i ? 'var(--ok)' : boot === i ? 'var(--warn)' : 'var(--ink-3)' }}>
+                    <Icon name={boot > i ? 'circle-check' : boot === i ? 'loader-circle' : 'circle-dashed'} size={15} />
+                  </span>
+                  <span style={{ font: 'var(--text-body)', color: boot > i ? 'var(--ink-1)' : 'var(--ink-2)', whiteSpace: 'nowrap' }}>{t}</span>
+                </div>
+              ))}
+              <div style={{ display: 'flex', flexWrap: 'wrap', gap: 5, paddingLeft: 25 }}>
+                {['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d', 'p/1', 'p/2', 'p/3', 'p/4', 'deadline/hard'].map((l: string) => <Tag key={l} label={l} />)}
+              </div>
+            </div>
+            {boot === 3 ? (
+              <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+                The pot is empty. Tell me what you're planning and I'll draw up the tickets.
+              </p>
+            ) : (
+              <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: 0 }}>
+                No bot comments, no body frontmatter, no synthetic issues — ever. Labels are the only footprint.
+              </p>
+            )}
+          </Frame>
+        ) : null}
+      </div>
+
+      <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>first run · everything reversible</span>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/runway-screen.tsx

@@ -0,0 +1,105 @@
+import React from 'react'
+
+import { type CapacityMember, capacityPerWorkday } from '@commitea/core'
+
+import { RunwayBar } from '../charts/chart.js'
+import { Card, Badge, Tag, Icon, IconButton } from '../ui/index.js'
+import { RUNWAY, CAPACITY, type RunwayMilestone } from '../../data/fixtures.js'
+
+// Runway — capacity vs milestone dates; ranges, never points.
+// `milestones` (real per-milestone forecasts) + `capacity` (real config) override the demo.
+export function RunwayScreen({
+  onOpenCalibration,
+  onOpenMilestone,
+  calibration,
+  milestones,
+  capacity,
+}: {
+  onOpenCalibration: () => void
+  onOpenMilestone: (id?: number) => void
+  calibration?: { n: number; coldStart: boolean; excludedSameDay?: number }
+  milestones?: RunwayMilestone[]
+  capacity?: CapacityMember[]
+}) {
+  const rows = milestones && milestones.length ? milestones : RUNWAY
+  const capacityRows =
+    capacity && capacity.length
+      ? capacity.map((m) => ({
+          who: m.person,
+          slices: `focus ${m.focusFactor} · alloc ${Math.round(m.allocation * 100)}%`,
+          hours: `${capacityPerWorkday(m).toFixed(2)} pd/day`,
+        }))
+      : CAPACITY
+  const excluded = calibration?.excludedSameDay ?? 0
+  const calibNote = calibration
+    ? calibration.coldStart
+      ? `cold-start priors · ${calibration.n}/20 closed issues estimated` +
+        (excluded > 0 ? ` · ${excluded} same-day close${excluded === 1 ? '' : 's'} can’t calibrate` : '')
+      : `calibrated on ${calibration.n} closed ${calibration.n === 1 ? 'issue' : 'issues'}`
+    : 'calibrated on 27 closed issues'
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14 }}>
+        <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Runway</h1>
+        <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0' }}>capacity vs milestone dates · {calibNote}</p>
+      </header>
+
+      <Card overline="Milestones" flush>
+        <div>
+          {rows.map((m, i) => (
+            <div key={m.name} onClick={() => onOpenMilestone(m.id)} style={{
+              display: 'grid', gridTemplateColumns: '160px 1fr 150px 90px', gap: 16, alignItems: 'center', cursor: 'pointer',
+              padding: '14px 20px', borderTop: i === 0 ? 'none' : '1px solid var(--line-1)',
+            }}
+            onMouseEnter={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.background = 'var(--paper-2)'; }}
+            onMouseLeave={(e: React.MouseEvent<HTMLDivElement>) => { e.currentTarget.style.background = 'transparent'; }}>
+              <div>
+                <div style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)', display: 'flex', alignItems: 'center', gap: 7 }}>
+                  <Icon name="milestone" size={14} style={{ color: 'var(--ink-3)' }} />{m.name}
+                </div>
+                <div style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)', marginTop: 3 }}>
+                  due {m.due}{m.hard ? ' ' : ''}
+                </div>
+                {m.hard ? <Tag label="deadline/hard" style={{ marginTop: 5 }} /> : null}
+              </div>
+              <RunwayBar m={m} />
+              <span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-2)' }}>80% {m.p80}</span>
+              <Badge tone={m.tone} dot>{m.note}</Badge>
+            </div>
+          ))}
+        </div>
+      </Card>
+
+      <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 14, alignItems: 'start' }}>
+        <Card overline="Capacity" flush>
+          <div>
+            {capacityRows.map((p, i) => (
+              <div key={p.who} style={{
+                display: 'flex', alignItems: 'center', gap: 12, padding: '12px 20px',
+                borderTop: i === 0 ? 'none' : '1px solid var(--line-1)',
+              }}>
+                <span style={{
+                  width: 26, height: 26, borderRadius: '50%', background: 'var(--spruce-2)', color: 'var(--accent-text)',
+                  font: '600 10px/26px var(--font-sans)', textAlign: 'center', flexShrink: 0,
+                }}>{p.who.split(' ').map((w: string) => w[0]).join('')}</span>
+                <div style={{ flex: 1, minWidth: 0 }}>
+                  <div style={{ font: 'var(--text-body-strong)' }}>{p.who}</div>
+                  <div style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)', marginTop: 2 }}>{p.slices}</div>
+                </div>
+                <span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-2)' }}>{p.hours}</span>
+              </div>
+            ))}
+          </div>
+        </Card>
+        <Card overline="Calibration" actions={<IconButton icon="arrow-up-right" label="Full report" size="sm" onClick={onOpenCalibration} />}>
+          <p style={{ font: 'var(--text-body)', margin: '0 0 8px' }}>
+            Your estimates run <strong>18% optimistic</strong> on <code>est/3d</code> and above. Smaller tickets are honest.
+          </p>
+          <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+            I widen the cone accordingly. No judgement — it's the most common shape of hope.
+          </p>
+        </Card>
+      </div>
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/screens/settings-screen.tsx

@@ -0,0 +1,160 @@
+import React from 'react'
+
+import type { PublicConfig } from '../../global.js'
+import { Badge, Button, Card, Icon, IconButton, Input, Radio, Select, Switch, Tag } from '../ui/index.js'
+
+// Settings — gitea connection, sync, model roles, labels, rituals, appearance
+export function SettingsScreen({
+  dark,
+  setDark,
+  connection,
+  onReconnect,
+  onDisconnect,
+}: {
+  dark: boolean
+  setDark: (v: boolean) => void
+  connection?: PublicConfig | null
+  onReconnect?: () => void
+  onDisconnect?: () => void
+}) {
+  const [webhooks, setWebhooks] = React.useState(true)
+  const [reconcile, setReconcile] = React.useState(true)
+  const [poll, setPoll] = React.useState(true)
+  const [nag, setNag] = React.useState(true)
+
+  const Row = ({ children, style }: { children: React.ReactNode; style?: React.CSSProperties }) => (
+    <div style={{ display: 'flex', alignItems: 'center', gap: 12, ...style }}>{children}</div>
+  )
+  const Note = ({ children }: { children: React.ReactNode }) => (
+    <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: 0 }}>{children}</p>
+  )
+
+  return (
+    <div style={{ maxWidth: 720, margin: '0 auto', display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14 }}>
+        <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Settings</h1>
+        <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0' }}>config lives in pm-state · versioned, portable</p>
+      </header>
+
+      <Card overline="Gitea" title="Connection">
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+          {connection ? (
+            <>
+              <Row style={{ padding: '8px 12px', background: 'var(--paper-0)', border: '1px solid var(--line-1)', borderRadius: 'var(--radius-2)' }}>
+                <Icon name="git-branch" size={14} style={{ color: 'var(--ink-3)' }} />
+                <span style={{ font: 'var(--text-data)', color: 'var(--ink-1)', flex: 1 }}>{connection.owner}/{connection.repo}</span>
+                <Badge tone="ok" dot>connected</Badge>
+              </Row>
+              <Row style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', gap: 6 }}>
+                <Icon name="link" size={12} />{connection.baseUrl}
+              </Row>
+              <Row style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', gap: 6 }}>
+                <Icon name="layers" size={12} />sidecar: {connection.pmStateRepo ?? `${connection.repo}-pm-state`}
+              </Row>
+              <Row style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', gap: 6 }}>
+                <Icon name="sparkles" size={12} />model: {connection.modelUrl ?? 'not set — chat off'}
+              </Row>
+              <Note>Your token is stored encrypted on this machine. Delete the sidecar and resync — no truth is lost.</Note>
+              <Row style={{ gap: 8, marginTop: 2 }}>
+                <Button variant="secondary" size="sm" icon="settings-2" onClick={onReconnect}>Reconfigure</Button>
+                <Button variant="ghost" size="sm" onClick={onDisconnect}>Disconnect</Button>
+              </Row>
+            </>
+          ) : (
+            <Row style={{ gap: 8 }}>
+              <Note>Not connected.</Note>
+              <Button variant="secondary" size="sm" onClick={onReconnect}>Connect</Button>
+            </Row>
+          )}
+        </div>
+      </Card>
+
+      <Card overline="Sync" title="Staying current">
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+          <Row>
+            <Switch label="Webhooks while running" checked={webhooks} onChange={(e) => setWebhooks(e.target.checked)} />
+            <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)', marginLeft: 'auto' }}>endpoint :48731 · healthy</span>
+          </Row>
+          <Switch label="Full reconcile on launch" checked={reconcile} onChange={(e) => setReconcile(e.target.checked)} />
+          <Row>
+            <Switch label="Poll fallback" checked={poll} onChange={(e) => setPoll(e.target.checked)} />
+            <div style={{ marginLeft: 'auto', width: 140 }}>
+              <Select options={[{ value: '2', label: 'every 2 min' }, { value: '5', label: 'every 5 min' }, { value: '15', label: 'every 15 min' }]} defaultValue="5" />
+            </div>
+          </Row>
+          <Note>last reconcile 3.2s · 500 issues · nothing lost</Note>
+        </div>
+      </Card>
+
+      <Card overline="Models" title="The router">
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 14 }}>
+          <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '12px 14px' }}>
+            <Select label="Prose & rituals" options={[
+              { value: 'gemma-4b', label: 'gemma-4b · local' },
+              { value: 'qwen-7b', label: 'qwen-7b · local' },
+            ]} defaultValue="gemma-4b" />
+            <Input label="Base URL" mono defaultValue="http://localhost:1234/v1" />
+            <Select label="Decomposition & negotiation" options={[
+              { value: 'qwen-72b', label: 'qwen-72b · lm-studio box' },
+              { value: 'gpt-4o', label: 'gpt-4o · OpenAI API' },
+            ]} defaultValue="qwen-72b" />
+            <Input label="Base URL" mono defaultValue="http://10.0.0.42:1234/v1" />
+          </div>
+          <Row>
+            <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)' }}>hot memory ≤ 2k tokens · math is never delegated to either</span>
+          </Row>
+          <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+            The small one writes my standup; the large one argues with your estimates. Neither is allowed near the arithmetic.
+          </p>
+        </div>
+      </Card>
+
+      <Card overline="Labels" title="Schema">
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
+          <Row style={{ flexWrap: 'wrap', gap: 6 }}>
+            {['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d'].map((l) => <Tag key={l} label={l} />)}
+          </Row>
+          <Row style={{ flexWrap: 'wrap', gap: 6 }}>
+            {['p/1', 'p/2', 'p/3', 'p/4'].map((l) => <Tag key={l} label={l} />)}
+            <Tag label="deadline/hard" />
+          </Row>
+          <Note>Fixed sets, human-meaningful, visible in gitea. Not configurable — that is rather the point.</Note>
+        </div>
+      </Card>
+
+      <Card overline="Rituals" title="Reginald's calendar">
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+          <Row>
+            <span style={{ font: 'var(--text-body)', color: 'var(--ink-1)' }}>Morning standup</span>
+            <div style={{ marginLeft: 'auto', width: 120 }}>
+              <Select options={[{ value: '0630', label: '06:30' }, { value: '0700', label: '07:00' }, { value: '0800', label: '08:00' }]} defaultValue="0700" />
+            </div>
+          </Row>
+          <Row>
+            <Switch label="Stale-blocker nagging" checked={nag} onChange={(e) => setNag(e.target.checked)} />
+            <div style={{ marginLeft: 'auto', width: 140 }}>
+              <Select options={[{ value: '2', label: 'after 2 days' }, { value: '3', label: 'after 3 days' }, { value: '5', label: 'after 5 days' }]} defaultValue="3" />
+            </div>
+          </Row>
+        </div>
+      </Card>
+
+      <Card overline="Appearance" title="Service">
+        <div style={{ display: 'flex', gap: 20 }}>
+          <Radio name="theme" label="Morning (light)" checked={!dark} onChange={() => setDark(false)} />
+          <Radio name="theme" label="Evening (dark)" checked={dark} onChange={() => setDark(true)} />
+        </div>
+      </Card>
+
+      <Card>
+        <Row>
+          <div style={{ flex: 1 }}>
+            <div style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)' }}>Forget this gitea</div>
+            <Note>Removes the connection and the local cache. Gitea itself is untouched.</Note>
+          </div>
+          <Button variant="danger">Forget</Button>
+        </Row>
+      </Card>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/screens/standup-screen.tsx

@@ -0,0 +1,212 @@
+import React from 'react'
+
+import { type IssueRef, STANDUP, type StandupData } from '../../data/fixtures.js'
+import { Badge, Button, Icon } from '../ui/index.js'
+
+const standupCSS = `
+@keyframes ct-standup-settle {
+  from { opacity: 0; transform: translateY(6px); }
+  to { opacity: 1; transform: none; }
+}
+.ct-standup-section { opacity: 1; }
+@media (prefers-reduced-motion: no-preference) {
+  .ct-standup-section { animation: ct-standup-settle 320ms var(--ease-out) both; }
+}
+`
+;(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-standup-css')) {
+    const s = document.createElement('style')
+    s.id = 'ct-standup-css'
+    s.textContent = standupCSS
+    document.head.appendChild(s)
+  }
+})()
+
+const toneColor: Record<string, string> = {
+  ok: 'var(--ok)',
+  warn: 'var(--warn)',
+  danger: 'var(--danger)',
+}
+
+/**
+ * Morning standup — a typeset letter from Reginald: overnight drift, today's
+ * plan, stale-blocker nag. Sections settle in once, reduced-motion-safe. Data
+ * is fixture (data.js) until the scheduler + lifecycle inference feed it.
+ */
+export function StandupScreen({
+  onBegin,
+  onOpenIssue,
+  data,
+}: {
+  onBegin: () => void
+  onOpenIssue: (issue: IssueRef) => void
+  data?: StandupData
+}) {
+  const s = data ?? STANDUP
+  const NAG_REF: IssueRef = {
+    id: s.nag.id,
+    days: s.nag.days,
+  }
+
+  const Section = ({ overline, order, children }: { overline: string; order: number; children: React.ReactNode }) => (
+    <section
+      className="ct-standup-section"
+      style={{ animationDelay: `${order * 90}ms`, display: 'flex', flexDirection: 'column', gap: 12 }}
+    >
+      <p
+        style={{
+          font: 'var(--text-overline)',
+          letterSpacing: 'var(--letter-spacing-wide)',
+          textTransform: 'uppercase',
+          color: 'var(--ink-3)',
+          margin: 0,
+          borderTop: '1px solid var(--line-1)',
+          paddingTop: 14,
+        }}
+      >
+        {overline}
+      </p>
+      {children}
+    </section>
+  )
+
+  return (
+    <div style={{ maxWidth: 660, margin: '0 auto' }}>
+      <article
+        style={{
+          background: 'var(--surface-card)',
+          border: '1px solid var(--line-1)',
+          borderRadius: 'var(--radius-3)',
+          boxShadow: 'var(--shadow-jade-line), var(--shadow-1)',
+          padding: '36px 44px 32px',
+          display: 'flex',
+          flexDirection: 'column',
+          gap: 20,
+        }}
+      >
+        <header className="ct-standup-section" style={{ borderBottom: 'var(--rule-double)', paddingBottom: 16 }}>
+          <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '0 0 8px' }}>{s.date} · prepared 07:00</p>
+          <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Morning standup</h1>
+        </header>
+
+        <Section overline="Overnight drift" order={1}>
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
+            {s.drift.map((d) => (
+              <div key={d.text} style={{ display: 'flex', alignItems: 'baseline', gap: 10 }}>
+                <span
+                  style={{
+                    width: 7,
+                    height: 7,
+                    borderRadius: '50%',
+                    background: toneColor[d.tone],
+                    flexShrink: 0,
+                    position: 'relative',
+                    top: -1,
+                  }}
+                />
+                <span style={{ font: 'var(--text-body)', color: 'var(--ink-1)', flex: 1 }}>{d.text}</span>
+                <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)', whiteSpace: 'nowrap' }}>
+                  {d.delta}
+                </span>
+              </div>
+            ))}
+          </div>
+        </Section>
+
+        <Section overline="Today's plan" order={2}>
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+            {s.plan.map((p) => (
+              <div key={p.who} style={{ display: 'flex', gap: 12, alignItems: 'flex-start' }}>
+                <span
+                  style={{
+                    width: 26,
+                    height: 26,
+                    borderRadius: '50%',
+                    background: 'var(--spruce-2)',
+                    color: 'var(--accent-text)',
+                    font: '600 10px/26px var(--font-sans)',
+                    textAlign: 'center',
+                    flexShrink: 0,
+                  }}
+                >
+                  {p.who
+                    .split(' ')
+                    .map((w) => w[0])
+                    .join('')}
+                </span>
+                <div style={{ flex: 1, minWidth: 0 }}>
+                  <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+                    <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)', whiteSpace: 'nowrap' }}>
+                      {p.who}
+                    </span>
+                    <span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-2)' }}>{p.pick}</span>
+                    <span style={{ font: 'var(--text-small)', color: 'var(--ink-2)' }}>{p.title}</span>
+                  </div>
+                  <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '4px 0 0' }}>{p.why}</p>
+                </div>
+              </div>
+            ))}
+          </div>
+        </Section>
+
+        <Section overline="Stale blockers" order={3}>
+          <div
+            role="button"
+            tabIndex={0}
+            onClick={() => onOpenIssue(NAG_REF)}
+            onKeyDown={(e) => {
+              if (e.key === 'Enter') onOpenIssue(NAG_REF)
+            }}
+            style={{
+              display: 'flex',
+              gap: 10,
+              alignItems: 'flex-start',
+              cursor: 'pointer',
+              background: 'var(--warn-tint)',
+              borderRadius: 'var(--radius-2)',
+              padding: '12px 14px',
+            }}
+          >
+            <span style={{ color: 'var(--warn)', display: 'inline-flex', marginTop: 2 }}>
+              <Icon name="clock" size={15} />
+            </span>
+            <div style={{ flex: 1 }}>
+              <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+                <span style={{ font: '500 12.5px var(--font-mono)', color: 'var(--ink-1)' }}>#{s.nag.id}</span>
+                <Badge tone="warn" dot>
+                  steeping {s.nag.days}
+                </Badge>
+                <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-3)' }}>
+                  blocks {s.nag.blocks.join(', ')}
+                </span>
+              </div>
+              <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '5px 0 0' }}>{s.nag.text}</p>
+            </div>
+          </div>
+        </Section>
+
+        <footer
+          className="ct-standup-section"
+          style={{
+            animationDelay: '360ms',
+            borderTop: '1px solid var(--line-1)',
+            paddingTop: 16,
+            display: 'flex',
+            alignItems: 'center',
+            gap: 10,
+          }}
+        >
+          <p style={{ font: 'var(--text-agent-lg)', color: 'var(--ink-1)', margin: 0, flex: 1 }}>
+            The kettle’s on. — R.
+          </p>
+          <Button variant="ghost" onClick={onBegin}>
+            Ask about the drift
+          </Button>
+          <Button iconRight="arrow-right" onClick={onBegin}>
+            Begin the day
+          </Button>
+        </footer>
+      </article>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/shell/app-shell.tsx

@@ -0,0 +1,506 @@
+import React, { useEffect, useState } from 'react'
+
+import logoIcon from '../../design/assets/logo-icon.png'
+import type { IssueChange } from '@commitea/core'
+
+import type { PublicConfig } from '../../global.js'
+import type { IssueRef } from '../../data/fixtures.js'
+import { ConnectScreen } from '../screens/connect-screen.js'
+import {
+  backlogCalibration,
+  capacityWorkers,
+  forecastBacklog,
+  issuesToBoardColumns,
+  milestoneView,
+  runwayView,
+  scheduleFocus,
+} from '../../lib/backlog.js'
+import { useBacklog } from '../../lib/use-backlog.js'
+import { useCapacity } from '../../lib/use-capacity.js'
+import { depsGraphView } from '../../lib/views/deps-graph.js'
+import { ganttView } from '../../lib/views/gantt-view.js'
+import { inboxView } from '../../lib/views/inbox-view.js'
+import { issueDetailView } from '../../lib/views/issue-detail.js'
+import type { ProjectData } from '../../lib/views/project-data.js'
+import { standupView } from '../../lib/views/standup-view.js'
+import { PrimitivesGallery } from '../gallery.js'
+import { BoardScreen } from '../screens/board-screen.js'
+import { CalibrationScreen } from '../screens/calibration-screen.js'
+import { CaptureScreen } from '../screens/capture-screen.js'
+import { DirectivesScreen } from '../screens/directives-screen.js'
+import { FocusScreen } from '../screens/focus-screen.js'
+import { InboxScreen } from '../screens/inbox-screen.js'
+import { IssueScreen } from '../screens/issue-screen.js'
+import { MilestoneScreen } from '../screens/milestone-screen.js'
+import { OnboardingScreen } from '../screens/onboarding-screen.js'
+import { RunwayScreen } from '../screens/runway-screen.js'
+import { SettingsScreen } from '../screens/settings-screen.js'
+import { StandupScreen } from '../screens/standup-screen.js'
+import { Icon, Switch } from '../ui/index.js'
+import { ChatPanel } from './chat-panel.js'
+import { PlaceholderScreen } from './placeholder-screen.js'
+import { OfflineBanner, StatesScreen } from './states.js'
+
+type View =
+  | 'standup'
+  | 'focus'
+  | 'inbox'
+  | 'capture'
+  | 'board'
+  | 'runway'
+  | 'directives'
+  | 'settings'
+  | 'states'
+  | 'firstrun'
+  | 'primitives'
+  | 'issue'
+  | 'calibration'
+  | 'milestone'
+
+interface NavEntry {
+  id: View
+  label: string
+  icon: string
+  count?: number | null
+}
+
+// which phase builds each not-yet-real view (shown on its placeholder)
+const PHASE: Partial<Record<View, string>> = {
+  standup: 'P3-3',
+  focus: 'P3-3',
+  inbox: 'P3-6',
+  capture: 'P3-7',
+  board: 'P3-4',
+  runway: 'P3-5',
+  directives: 'P3-8',
+  settings: 'P3-8',
+  firstrun: 'P3-8',
+  issue: 'P3-6',
+  calibration: 'P3-5',
+  milestone: 'P3-5',
+}
+
+const TITLE: Partial<Record<View, string>> = {
+  standup: 'Standup',
+  focus: 'Morning service',
+  inbox: 'Inbox',
+  capture: 'Capture',
+  board: 'The pot',
+  runway: 'Runway',
+  directives: 'Directives',
+  settings: 'Settings',
+  firstrun: 'First run',
+  issue: 'Issue',
+  calibration: 'Calibration',
+  milestone: 'Milestone',
+}
+
+const INBOX_UNREAD = 3
+
+export function AppShell() {
+  const [view, setView] = useState<View>('focus')
+  const [prevView, setPrevView] = useState<View>('focus')
+  const [dark, setDark] = useState(false)
+  const [offline, setOffline] = useState(false)
+  const [issue, setIssue] = useState<IssueRef | null>(null)
+  const [readIds, setReadIds] = useState<number[]>([])
+  const [milestoneId, setMilestoneId] = useState<number | null>(null)
+  const [gate, setGate] = useState<'checking' | 'connect' | 'ready'>('checking')
+  const [demo, setDemo] = useState(false)
+  const [pubConfig, setPubConfig] = useState<PublicConfig | null>(null)
+  const [collaborators, setCollaborators] = useState<{ login: string; name: string }[]>([])
+  const [backlog, refetchBacklog] = useBacklog()
+  const capacityMembers = useCapacity()
+  const workers = capacityWorkers(capacityMembers)
+  const boardColumns =
+    backlog.status === 'ready' ? issuesToBoardColumns(backlog.issues, backlog.timelines) : undefined
+  const focus =
+    backlog.status === 'ready' ? scheduleFocus(backlog.issues, backlog.deps, backlog.timelines) : undefined
+  const calibration =
+    backlog.status === 'ready' ? backlogCalibration(backlog.issues, backlog.timelines) : undefined
+  const forecast =
+    backlog.status === 'ready'
+      ? (forecastBacklog(backlog.issues, backlog.deps, new Date(), calibration?.model, workers) ?? undefined)
+      : undefined
+  const runwayMilestones =
+    backlog.status === 'ready'
+      ? runwayView(backlog.issues, backlog.milestones, backlog.deps, new Date(), workers)
+      : undefined
+  const milestone =
+    backlog.status === 'ready' && milestoneId != null
+      ? (milestoneView(
+          milestoneId,
+          backlog.issues,
+          backlog.milestones,
+          backlog.deps,
+          backlog.timelines,
+          calibration?.model,
+          new Date(),
+          workers,
+        ) ?? undefined)
+      : undefined
+
+  // The uniform input every real-data view builder consumes. Assembled once from
+  // the reconciled backlog + capacity; undefined until the first reconcile lands.
+  const projectData: ProjectData | undefined =
+    backlog.status === 'ready'
+      ? {
+          issues: backlog.issues,
+          milestones: backlog.milestones,
+          deps: backlog.deps,
+          timelines: backlog.timelines,
+          calibration: calibration?.model,
+          workers,
+          today: new Date(),
+        }
+      : undefined
+  const issueDetail =
+    projectData && issue ? (issueDetailView(issue.id, projectData) ?? undefined) : undefined
+  const standup = projectData ? standupView(projectData) : undefined
+  const inbox = projectData ? inboxView(projectData) : undefined
+  const gantt = projectData ? ganttView(projectData) : undefined
+  const depsGraph = projectData ? depsGraphView(projectData) : undefined
+  // The rail's unread badge tracks the real inbox once reconciled (still-unread
+  // minus what's been opened); demo shows the fixture count.
+  const inboxUnread = inbox
+    ? inbox.filter((n) => n.unread && !readIds.includes(n.id)).length
+    : INBOX_UNREAD
+
+  // The real connected host (from the saved config), for the rail's status line.
+  const hostLabel = (() => {
+    try {
+      return pubConfig?.baseUrl ? new URL(pubConfig.baseUrl).host : 'gitea'
+    } catch {
+      return pubConfig?.baseUrl ?? 'gitea'
+    }
+  })()
+
+  useEffect(() => {
+    document.documentElement.setAttribute('data-theme', dark ? 'dark' : 'light')
+  }, [dark])
+
+  // Gate: e2e/demo → the shell (fixtures); configured → the shell (real data);
+  // otherwise → the connect screen (each teammate brings their own token).
+  useEffect(() => {
+    window.commitea.gitea
+      .status()
+      .then((s) => {
+        setDemo(s.demo)
+        setGate(s.demo || s.configured ? 'ready' : 'connect')
+      })
+      .catch(() => setGate('connect'))
+    window.commitea.config.get().then(setPubConfig).catch(() => {})
+    // Assignable people for the Adjust dialog's assignee picker (empty when demo/unconfigured).
+    window.commitea.gitea.collaborators().then(setCollaborators).catch(() => {})
+  }, [])
+
+  // The open issue's current assignee + milestone (from the reconciled backlog),
+  // so the Adjust dialog can preselect and diff them. Milestones list feeds its picker.
+  const currentIssue =
+    backlog.status === 'ready' && issue ? backlog.issues.find((i) => i.number === issue.id) : undefined
+  const milestoneOptions =
+    backlog.status === 'ready' ? backlog.milestones.map((m) => ({ id: m.id, title: m.title })) : []
+
+  const openIssue = (ref: IssueRef) => {
+    if (view !== 'issue') setPrevView(view)
+    // Callers into the sidecar (e.g. a "blocks #N" chip) may know only the id.
+    // Backfill the real title + labels from the reconciled backlog so the header
+    // isn't blank; fall back to whatever the caller passed (demo fixtures).
+    let full = ref
+    if (backlog.status === 'ready' && (!ref.title || !ref.labels)) {
+      const found = backlog.issues.find((i) => i.number === ref.id)
+      if (found) full = { ...ref, id: found.number, title: found.title, labels: found.labels }
+    }
+    setIssue(full)
+    setView('issue')
+  }
+
+  // The write path: apply through the bridge, reflect the new labels on the open
+  // issue immediately, and re-reconcile so the board + forecast catch up.
+  const applyChange = async (change: IssueChange) => {
+    const res = await window.commitea.gitea.applyChange(change)
+    if (res.ok) {
+      setIssue((cur) => (cur && cur.id === res.issue.number ? { ...cur, labels: res.issue.labels } : cur))
+      refetchBacklog()
+    }
+    return res
+  }
+
+  const NAV: NavEntry[] = [
+    { id: 'standup', label: 'Standup', icon: 'sun' },
+    { id: 'focus', label: 'Morning service', icon: 'coffee' },
+    { id: 'inbox', label: 'Inbox', icon: 'bell', count: inboxUnread || null },
+    { id: 'capture', label: 'Capture', icon: 'plus' },
+    { id: 'board', label: 'The pot', icon: 'square-kanban' },
+    { id: 'runway', label: 'Runway', icon: 'chart-line' },
+    { id: 'directives', label: 'Directives', icon: 'flag' },
+  ]
+
+  const NavItem = ({ item }: { item: NavEntry }) => {
+    const active =
+      view === item.id ||
+      (view === 'issue' && prevView === item.id) ||
+      ((view === 'calibration' || view === 'milestone') && item.id === 'runway')
+    return (
+      <button
+        type="button"
+        onClick={() => setView(item.id)}
+        aria-current={active ? 'page' : undefined}
+        style={{
+          display: 'flex',
+          alignItems: 'center',
+          gap: 10,
+          width: '100%',
+          font: `${active ? 600 : 500} 13.5px/1 var(--font-sans)`,
+          color: active ? 'var(--ink-1)' : 'var(--ink-2)',
+          background: active ? 'var(--paper-2)' : 'transparent',
+          border: 'none',
+          borderRadius: 'var(--radius-2)',
+          padding: '9px 12px',
+          cursor: 'pointer',
+          textAlign: 'left',
+          transition: 'background var(--duration-fast) var(--ease-out)',
+        }}
+      >
+        <Icon name={item.icon} size={16} style={{ color: active ? 'var(--accent-text)' : 'var(--ink-3)' }} />
+        {item.label}
+        {item.count ? (
+          <span
+            style={{
+              marginLeft: 'auto',
+              font: '500 10.5px/16px var(--font-mono)',
+              color: 'var(--accent-text)',
+              background: 'var(--spruce-2)',
+              borderRadius: 'var(--radius-round)',
+              padding: '0 6px',
+            }}
+          >
+            {item.count}
+          </span>
+        ) : null}
+      </button>
+    )
+  }
+
+  const renderScreen = () => {
+    switch (view) {
+      case 'focus':
+        return <FocusScreen onOpenIssue={openIssue} focus={focus} forecast={forecast} />
+      case 'standup':
+        return <StandupScreen onBegin={() => setView('focus')} onOpenIssue={openIssue} data={standup} />
+      case 'board':
+        return (
+          <BoardScreen
+            onOpenIssue={openIssue}
+            columns={boardColumns}
+            gantt={gantt}
+            deps={depsGraph}
+            loading={backlog.status === 'loading'}
+          />
+        )
+      case 'runway':
+        return (
+          <RunwayScreen
+            onOpenCalibration={() => setView('calibration')}
+            onOpenMilestone={(id) => {
+              setMilestoneId(id ?? null)
+              setView('milestone')
+            }}
+            calibration={
+              calibration
+                ? {
+                    n: calibration.model.n,
+                    coldStart: calibration.model.coldStart,
+                    excludedSameDay: calibration.coverage.excludedSameDay,
+                  }
+                : undefined
+            }
+            milestones={runwayMilestones}
+            capacity={capacityMembers}
+          />
+        )
+      case 'calibration':
+        return <CalibrationScreen onBack={() => setView('runway')} data={calibration?.data} />
+      case 'milestone':
+        return <MilestoneScreen onBack={() => setView('runway')} onOpenIssue={openIssue} data={milestone} />
+      case 'inbox':
+        return (
+          <InboxScreen
+            onOpenIssue={openIssue}
+            onOpenDirectives={() => setView('directives')}
+            readIds={readIds}
+            setReadIds={setReadIds}
+            data={inbox}
+          />
+        )
+      case 'capture':
+        return <CaptureScreen onDone={() => setView('focus')} />
+      case 'directives':
+        return <DirectivesScreen />
+      case 'settings':
+        return (
+          <SettingsScreen
+            dark={dark}
+            setDark={setDark}
+            connection={pubConfig}
+            onReconnect={() => setGate('connect')}
+            onDisconnect={() => {
+              void window.commitea.config.clear().then(() => {
+                setPubConfig(null)
+                setGate('connect')
+              })
+            }}
+          />
+        )
+      case 'issue':
+        return issue ? (
+          <IssueScreen
+            issue={issue}
+            detail={issueDetail}
+            onBack={() => setView(prevView)}
+            onOpenIssue={openIssue}
+            canWrite={backlog.status === 'ready'}
+            onApplyChange={applyChange}
+            collaborators={collaborators}
+            milestones={milestoneOptions}
+            currentAssignee={currentIssue?.assignee ?? null}
+            currentMilestoneId={currentIssue?.milestone?.id ?? null}
+          />
+        ) : null
+      case 'states':
+        return <StatesScreen onCapture={() => setView('capture')} />
+      case 'primitives':
+        return <PrimitivesGallery />
+      default:
+        return <PlaceholderScreen title={TITLE[view] ?? view} phase={PHASE[view] ?? 'a later phase'} />
+    }
+  }
+
+  // Connection gate (real onboarding) comes before everything else.
+  if (gate === 'checking') {
+    return <div style={{ height: '100vh', background: 'var(--surface-app)' }} />
+  }
+  if (gate === 'connect') {
+    return (
+      <ConnectScreen
+        existing={pubConfig}
+        onConnected={() => {
+          window.commitea.config.get().then(setPubConfig).catch(() => {})
+          setGate('ready')
+          refetchBacklog()
+        }}
+      />
+    )
+  }
+
+  // First run is full-window — no rail, no chat panel
+  if (view === 'firstrun') {
+    return <OnboardingScreen onDone={(dest) => setView(dest)} />
+  }
+
+  return (
+    <div
+      data-screen-label={`app-${view}`}
+      style={{
+        display: 'flex',
+        height: '100vh',
+        minWidth: 1280,
+        background: 'var(--surface-app)',
+        overflow: 'hidden',
+      }}
+    >
+      {/* left rail */}
+      <nav
+        aria-label="Primary"
+        style={{
+          width: 208,
+          flexShrink: 0,
+          display: 'flex',
+          flexDirection: 'column',
+          gap: 4,
+          padding: '18px 12px 14px',
+          borderRight: '1px solid var(--line-1)',
+        }}
+      >
+        <div style={{ display: 'flex', alignItems: 'center', gap: 9, padding: '0 12px 16px' }}>
+          <img src={logoIcon} width="24" height="24" alt="" style={{ borderRadius: 6, display: 'block' }} />
+          <span style={{ font: '400 21px/1 var(--font-serif-display)', color: 'var(--ink-1)' }}>
+            Commi<span style={{ color: 'var(--accent-text)' }}>Tea</span>
+          </span>
+        </div>
+
+        {NAV.map((n) => (
+          <NavItem key={n.id} item={n} />
+        ))}
+
+        <div style={{ borderTop: '1px solid var(--line-1)', margin: '10px 8px' }} />
+        <NavItem item={{ id: 'settings', label: 'Settings', icon: 'settings-2' }} />
+        {/* Dev-only surfaces (fixture galleries / onboarding preview) — shown in dev
+            and in demo/e2e mode; hidden in a real configured, packaged app. */}
+        {import.meta.env.DEV || demo ? (
+          <>
+            <NavItem item={{ id: 'firstrun', label: 'First run', icon: 'play' }} />
+            <NavItem item={{ id: 'states', label: 'States', icon: 'circle-dashed' }} />
+            <NavItem item={{ id: 'primitives', label: 'Primitives', icon: 'layers' }} />
+          </>
+        ) : null}
+
+        <div style={{ marginTop: 'auto', padding: '0 12px', display: 'flex', flexDirection: 'column', gap: 12 }}>
+          <button
+            type="button"
+            onClick={() => setOffline((o) => !o)}
+            title="Toggle the connection (demo)"
+            aria-label={offline ? 'Connection: offline' : 'Connection: online'}
+            style={{
+              font: '400 11px var(--font-mono)',
+              color: 'var(--ink-3)',
+              display: 'flex',
+              alignItems: 'center',
+              gap: 6,
+              background: 'none',
+              border: 'none',
+              padding: 0,
+              cursor: 'pointer',
+              textAlign: 'left',
+            }}
+          >
+            <span
+              style={{
+                width: 6,
+                height: 6,
+                borderRadius: '50%',
+                background: offline ? 'var(--danger)' : 'var(--ok)',
+                display: 'inline-block',
+              }}
+            />
+            {hostLabel}
+          </button>
+          <Switch
+            label={<span style={{ font: 'var(--text-caption)' }}>Evening service</span>}
+            checked={dark}
+            onChange={(e) => setDark(e.target.checked)}
+          />
+        </div>
+      </nav>
+
+      {/* main */}
+      <main style={{ flex: 1, minWidth: 0, overflowY: 'auto', padding: '24px 28px' }}>
+        <div
+          style={{
+            maxWidth: 1120,
+            margin: '0 auto',
+            height: view === 'board' ? '100%' : 'auto',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 14,
+          }}
+        >
+          {offline ? <OfflineBanner /> : null}
+          {renderScreen()}
+        </div>
+      </main>
+
+      <ChatPanel onOpenDirectives={() => setView('directives')} offline={offline} onApplyChange={applyChange} />
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/shell/chat-panel.tsx

@@ -0,0 +1,207 @@
+import React, { useEffect, useRef, useState } from 'react'
+
+import type { IssueChange } from '@commitea/core'
+
+import { useChat } from '../../lib/use-chat.js'
+import { Button, Icon, IconButton } from '../ui/index.js'
+
+/**
+ * Reginald's panel — chat is the write-path (decisions.md D1). Wired to the
+ * model bridge via `useChat`: a configured model drives a real agent turn
+ * (query_project + prose, propose_change for edits); otherwise it echoes the
+ * scripted fixture reply. Proposed changes are approved inline here — the write
+ * runs through `onApplyChange`, the same guarded handler the Issue screen uses.
+ */
+export interface ChatPanelProps {
+  onOpenDirectives?: () => void
+  offline?: boolean
+  onApplyChange?: (change: IssueChange) => Promise<{ ok: boolean }>
+}
+
+export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPanelProps) {
+  const { msgs, thinking, live, model, steps, proposals, streaming, send: sendChat, approve, dismiss } = useChat(onApplyChange)
+  // shorten "google/gemma-4-26b-a4b-qat" → "gemma-4-26b" for the header chip
+  const modelLabel = model ? (model.split('/').pop() ?? model).replace(/-(qat|instruct|it|gguf)$/i, '') : 'gemma-4'
+  const [text, setText] = useState('')
+  const scrollRef = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    const el = scrollRef.current
+    if (el) el.scrollTop = el.scrollHeight
+  }, [msgs, thinking, streaming])
+
+  const send = () => {
+    const t = text.trim()
+    if (!t) return
+    setText('')
+    sendChat(t)
+  }
+
+  return (
+    <aside
+      style={{
+        width: 330,
+        flexShrink: 0,
+        display: 'flex',
+        flexDirection: 'column',
+        background: 'var(--surface-card)',
+        borderLeft: '1px solid var(--line-1)',
+        minHeight: 0,
+      }}
+    >
+      <header
+        style={{
+          display: 'flex',
+          alignItems: 'center',
+          gap: 8,
+          padding: '14px 16px',
+          borderBottom: '1px solid var(--line-1)',
+          flexShrink: 0,
+        }}
+      >
+        <Icon name="sparkles" size={16} style={{ color: offline ? 'var(--ink-3)' : 'var(--jade)' }} />
+        <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-1)' }}>Reginald</span>
+        <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)', marginLeft: 'auto' }}>
+          {offline ? 'offline · queueing' : live ? `${modelLabel} · local` : 'no model'}
+        </span>
+        <IconButton icon="history" label="Directive log" size="sm" onClick={onOpenDirectives} />
+      </header>
+
+      <div
+        ref={scrollRef}
+        style={{ flex: 1, overflowY: 'auto', padding: 16, display: 'flex', flexDirection: 'column', gap: 12, minHeight: 0 }}
+      >
+        {msgs.map((m, i) =>
+          m.from === 'agent' ? (
+            <div key={i} style={{ font: 'var(--text-agent)', color: 'var(--ink-1)', lineHeight: 1.55 }}>
+              {m.text}
+            </div>
+          ) : (
+            <div
+              key={i}
+              style={{
+                alignSelf: 'flex-end',
+                maxWidth: '85%',
+                background: 'var(--paper-2)',
+                borderRadius: '10px 10px 2px 10px',
+                padding: '8px 12px',
+                font: 'var(--text-small)',
+                color: 'var(--ink-1)',
+              }}
+            >
+              {m.text}
+            </div>
+          ),
+        )}
+        {offline ? (
+          <div style={{ font: 'var(--text-agent)', color: 'var(--ink-3)' }}>
+            The model is away from its desk. Reads still work; writes will wait their turn.
+          </div>
+        ) : null}
+        {streaming ? (
+          <div style={{ font: 'var(--text-agent)', color: 'var(--ink-1)', lineHeight: 1.55 }}>
+            {streaming}
+            <span style={{ opacity: 0.5 }}>▊</span>
+          </div>
+        ) : thinking ? (
+          <div style={{ font: 'var(--text-agent)', color: 'var(--ink-3)' }}>considering…</div>
+        ) : null}
+        {!thinking && steps.length ? (
+          <div style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', display: 'flex', alignItems: 'center', gap: 5 }}>
+            <Icon name="eye" size={11} /> consulted {Array.from(new Set(steps.map((s) => s.replace('query_project', 'the project').replace('propose_change', 'the labels').replace('record_directive', 'the directive ledger')))).join(', ')}
+          </div>
+        ) : null}
+        {proposals.map((p) => (
+          <div
+            key={`${p.change.issue}:${p.change.kind}`}
+            style={{
+              border: '1px solid var(--line-2)',
+              borderRadius: 'var(--radius-2)',
+              background: 'var(--paper-0)',
+              padding: '10px 12px',
+              display: 'flex',
+              flexDirection: 'column',
+              gap: 8,
+            }}
+          >
+            <div style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', textTransform: 'uppercase', letterSpacing: 'var(--letter-spacing-wide)' }}>
+              Proposed · #{p.change.issue}
+            </div>
+            <div style={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>{p.summary}</div>
+            <div style={{ display: 'flex', gap: 8 }}>
+              <Button size="sm" onClick={() => approve(p)} disabled={offline}>
+                Approve
+              </Button>
+              <Button size="sm" variant="ghost" onClick={() => dismiss(p)}>
+                Dismiss
+              </Button>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      <div style={{ padding: 14, borderTop: '1px solid var(--line-1)', flexShrink: 0 }}>
+        <div
+          style={{
+            display: 'flex',
+            alignItems: 'flex-end',
+            gap: 8,
+            background: 'var(--paper-0)',
+            border: '1px solid var(--line-2)',
+            borderRadius: 'var(--radius-2)',
+            padding: '8px 8px 8px 12px',
+          }}
+        >
+          <textarea
+            value={text}
+            onChange={(e) => setText(e.target.value)}
+            onKeyDown={(e) => {
+              if (e.key === 'Enter' && !e.shiftKey) {
+                e.preventDefault()
+                send()
+              }
+            }}
+            placeholder={offline ? 'Writes wait for the connection…' : live ? 'Tell me what to do…' : 'Add a Model URL in Settings…'}
+            disabled={offline || !live}
+            rows={1}
+            style={{
+              flex: 1,
+              resize: 'none',
+              border: 'none',
+              outline: 'none',
+              background: 'transparent',
+              font: 'var(--text-body)',
+              color: 'var(--ink-1)',
+              lineHeight: 1.45,
+              maxHeight: 96,
+            }}
+          />
+          <button
+            type="button"
+            onClick={send}
+            aria-label="Send"
+            disabled={offline || !live}
+            style={{
+              width: 30,
+              height: 30,
+              borderRadius: 'var(--radius-2)',
+              border: 'none',
+              cursor: offline || !live ? 'not-allowed' : 'pointer',
+              background: offline || !live ? 'var(--paper-3)' : 'var(--accent)',
+              color: offline || !live ? 'var(--ink-3)' : 'var(--ink-inverse)',
+              display: 'inline-flex',
+              alignItems: 'center',
+              justifyContent: 'center',
+              flexShrink: 0,
+            }}
+          >
+            <Icon name="send" size={14} />
+          </button>
+        </div>
+        <p style={{ font: 'var(--text-caption)', color: 'var(--ink-3)', margin: '8px 2px 0' }}>
+          Chat is the write-path. Destructive changes are proposed, never assumed.
+        </p>
+      </div>
+    </aside>
+  )
+}

apps/desktop/src/renderer/src/components/shell/placeholder-screen.tsx

@@ -0,0 +1,41 @@
+import { Button } from '../ui/index.js'
+import { EmptyState } from './states.js'
+
+/**
+ * Stand-in for views not yet built (Focus, Board, Runway, …). Keeps navigation
+ * live so the shell is demonstrable before the real screens land in P3-3+.
+ * `onOpenIssue`, when given, exercises the shell's issue drill-in + back-stack;
+ * real screens replace this with actual issue rows in P3-3+.
+ */
+export function PlaceholderScreen({
+  title,
+  phase,
+  onOpenIssue,
+}: {
+  title: string
+  phase: string
+  onOpenIssue?: () => void
+}) {
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14 }}>
+        <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>{title}</h1>
+        <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0' }}>
+          arrives in {phase} · the shell and navigation are live
+        </p>
+      </header>
+      <EmptyState
+        icon="coffee"
+        title="Not yet poured"
+        line="This view is on the boil for a later phase. The rail, routing, theme, and Reginald’s panel are already working around it."
+      />
+      {onOpenIssue ? (
+        <div style={{ display: 'flex', justifyContent: 'center' }}>
+          <Button variant="ghost" iconRight="arrow-right" onClick={onOpenIssue}>
+            Preview an issue page
+          </Button>
+        </div>
+      ) : null}
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/shell/states.tsx

@@ -0,0 +1,232 @@
+import React from 'react'
+
+import { Badge, Button, Icon } from '../ui/index.js'
+
+/**
+ * Shared empty/trouble states + the States gallery screen, ported from the
+ * handoff. EmptyState/OfflineBanner/ModelAwayState are reused across real
+ * screens as they land; StatesScreen is the specimen gallery.
+ */
+
+export interface EmptyStateProps {
+  icon: string
+  title: React.ReactNode
+  line: React.ReactNode
+  action?: string
+  onAction?: () => void
+  compact?: boolean
+}
+
+export function EmptyState({ icon, title, line, action, onAction, compact }: EmptyStateProps) {
+  return (
+    <div
+      style={{
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        textAlign: 'center',
+        gap: 10,
+        padding: compact ? '28px 20px' : '52px 24px',
+      }}
+    >
+      <span
+        style={{
+          width: 44,
+          height: 44,
+          borderRadius: '50%',
+          background: 'var(--paper-2)',
+          color: 'var(--ink-3)',
+          display: 'inline-flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+        }}
+      >
+        <Icon name={icon} size={19} />
+      </span>
+      <div style={{ font: '400 20px/1.25 var(--font-serif-display)', color: 'var(--ink-1)' }}>{title}</div>
+      <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0, maxWidth: 380 }}>{line}</p>
+      {action ? (
+        <Button style={{ marginTop: 6 }} onClick={onAction}>
+          {action}
+        </Button>
+      ) : null}
+    </div>
+  )
+}
+
+export interface OfflineBannerProps {
+  retryIn?: string
+}
+
+export function OfflineBanner({ retryIn }: OfflineBannerProps) {
+  return (
+    <div
+      style={{
+        display: 'flex',
+        alignItems: 'center',
+        gap: 10,
+        background: 'var(--warn-tint)',
+        border: '1px solid var(--warn)',
+        borderRadius: 'var(--radius-2)',
+        padding: '9px 14px',
+      }}
+    >
+      <span style={{ color: 'var(--warn)', display: 'inline-flex' }}>
+        <Icon name="triangle-alert" size={15} />
+      </span>
+      <span style={{ font: 'var(--text-small)', color: 'var(--ink-1)', flex: 1 }}>
+        Gitea isn’t answering. I’ll keep trying and say nothing more about it.
+      </span>
+      <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>
+        retry in {retryIn || '0:12'} · reads from cache
+      </span>
+    </div>
+  )
+}
+
+export function ModelAwayState() {
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 8, padding: '14px 16px' }}>
+      <div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
+        <span style={{ color: 'var(--ink-3)', display: 'inline-flex' }}>
+          <Icon name="sparkles" size={15} />
+        </span>
+        <span style={{ font: 'var(--text-body-strong)', color: 'var(--ink-2)' }}>Reginald</span>
+        <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>model offline</span>
+        <span style={{ marginLeft: 'auto' }}>
+          <Badge>queued: 1 directive</Badge>
+        </span>
+      </div>
+      <p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>
+        The model is away from its desk. Reads still work; writes will wait their turn.
+      </p>
+    </div>
+  )
+}
+
+function Specimen({ label, children }: { label: string; children: React.ReactNode }) {
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
+      <span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>{label}</span>
+      <div
+        style={{
+          border: '1px dashed var(--line-2)',
+          borderRadius: 'var(--radius-3)',
+          background: 'var(--surface-card)',
+          overflow: 'hidden',
+        }}
+      >
+        {children}
+      </div>
+    </div>
+  )
+}
+
+export function StatesScreen({ onCapture }: { onCapture?: () => void }) {
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <header style={{ borderBottom: 'var(--rule-double)', paddingBottom: 14 }}>
+        <h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>States</h1>
+        <p style={{ font: 'var(--text-data)', color: 'var(--ink-3)', margin: '6px 0 0' }}>
+          empty &amp; trouble · specimens as wired in the app
+        </p>
+      </header>
+
+      <p
+        style={{
+          font: 'var(--text-overline)',
+          letterSpacing: 'var(--letter-spacing-wide)',
+          textTransform: 'uppercase',
+          color: 'var(--ink-3)',
+          margin: '4px 0 0',
+        }}
+      >
+        Empty
+      </p>
+      <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 14 }}>
+        <Specimen label="the pot · no issues">
+          <EmptyState
+            compact
+            icon="inbox"
+            title="The pot is empty"
+            line="Tell me what you’re planning and I’ll draw up the tickets."
+            action="Start a capture"
+            onAction={onCapture}
+          />
+        </Specimen>
+        <Specimen label="morning service · nothing scheduled">
+          <EmptyState
+            compact
+            icon="coffee"
+            title="Nothing to pour"
+            line="Capture some work, or enjoy the silence — it never lasts."
+          />
+        </Specimen>
+        <Specimen label="directives · no entries">
+          <EmptyState
+            compact
+            icon="flag"
+            title="No directives yet"
+            line="When you overrule the scheduler, it goes on the record here — who, when, what, why."
+          />
+        </Specimen>
+        <Specimen label="board search · no match">
+          <EmptyState
+            compact
+            icon="search"
+            title="Nothing by that name"
+            line="The pot holds 24 issues; none of them answer to that."
+          />
+        </Specimen>
+      </div>
+
+      <p
+        style={{
+          font: 'var(--text-overline)',
+          letterSpacing: 'var(--letter-spacing-wide)',
+          textTransform: 'uppercase',
+          color: 'var(--ink-3)',
+          margin: '8px 0 0',
+        }}
+      >
+        Trouble
+      </p>
+      <div style={{ display: 'flex', flexDirection: 'column', gap: 14 }}>
+        <Specimen label="gitea unreachable · banner above main content (toggle the rail’s connection dot to see it live)">
+          <div style={{ padding: 12 }}>
+            <OfflineBanner />
+          </div>
+        </Specimen>
+        <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 14 }}>
+          <Specimen label="reginald’s panel · model offline">
+            <ModelAwayState />
+          </Specimen>
+          <Specimen label="webhooks down · poll fallback">
+            <div style={{ display: 'flex', alignItems: 'center', gap: 10, padding: '14px 16px' }}>
+              <Badge tone="warn" dot>
+                webhooks down
+              </Badge>
+              <span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)' }}>
+                polling every 2 min · updates may lag
+              </span>
+            </div>
+          </Specimen>
+        </div>
+        <Specimen label="first reconcile failed · full-screen">
+          <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', padding: '8px 0 20px' }}>
+            <EmptyState
+              compact
+              icon="refresh-cw"
+              title="The reconcile failed"
+              line="Gitea answered, then hung up mid-sentence. Your cache is intact; nothing human is lost."
+            />
+            <div style={{ display: 'flex', gap: 8, marginTop: -6 }}>
+              <Button>Try again</Button>
+              <Button variant="ghost">Work from cache</Button>
+            </div>
+          </div>
+        </Specimen>
+      </div>
+    </div>
+  )
+}

apps/desktop/src/renderer/src/components/ui/badge.tsx

@@ -0,0 +1,44 @@
+import React from 'react';
+
+/**
+ * Status pill — muted tint background, colored text. For state words like "ahead", "behind", "steeping".
+ */
+export interface BadgeProps {
+  /** @default 'neutral' */
+  tone?: 'ok' | 'warn' | 'danger' | 'info' | 'neutral' | 'jade';
+  /** Leading status dot @default false */
+  dot?: boolean;
+  children?: React.ReactNode;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-badge {
+  display: inline-flex; align-items: center; gap: 6px;
+  font: 500 12px/1 var(--font-sans);
+  padding: 4px 9px;
+  border-radius: var(--radius-round);
+}
+.ct-badge__dot { width: 6px; height: 6px; border-radius: 50%; background: currentColor; }
+.ct-badge--ok { background: var(--ok-tint); color: var(--ok); }
+.ct-badge--warn { background: var(--warn-tint); color: var(--warn); }
+.ct-badge--danger { background: var(--danger-tint); color: var(--danger); }
+.ct-badge--info { background: var(--info-tint); color: var(--info); }
+.ct-badge--neutral { background: var(--paper-2); color: var(--ink-2); }
+.ct-badge--jade { background: var(--jade-tint); color: var(--jade-7); }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-badge-css')) {
+    const s = document.createElement('style'); s.id = 'ct-badge-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Badge({ tone = 'neutral', dot = false, children, style, ...rest }: BadgeProps) {
+  return (
+    <span className={`ct-badge ct-badge--${tone}`} style={style} {...rest}>
+      {dot ? <span className="ct-badge__dot"></span> : null}
+      {children}
+    </span>
+  );
+}

apps/desktop/src/renderer/src/components/ui/button.tsx

@@ -0,0 +1,81 @@
+import React from 'react'
+
+import { Icon } from './icon.js'
+
+/**
+ * CommiTea button. Plain verbs only ("Approve", "Brew plan", "Defer") — never witty.
+ */
+export interface ButtonProps {
+  /** @default 'primary' */
+  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
+  /** @default 'md' */
+  size?: 'sm' | 'md';
+  /** Lucide icon name rendered before the label */
+  icon?: string;
+  /** Lucide icon name rendered after the label */
+  iconRight?: string;
+  disabled?: boolean;
+  onClick?: (e: React.MouseEvent) => void;
+  children?: React.ReactNode;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-btn {
+  display: inline-flex; align-items: center; justify-content: center; gap: 8px;
+  font: 600 14px/1 var(--font-sans);
+  border-radius: var(--radius-2);
+  border: 1px solid transparent;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: background var(--duration-fast) var(--ease-out),
+              border-color var(--duration-fast) var(--ease-out),
+              color var(--duration-fast) var(--ease-out);
+}
+.ct-btn:disabled { opacity: 0.45; cursor: not-allowed; }
+.ct-btn--md { height: 34px; padding: 0 14px; }
+.ct-btn--sm { height: 28px; padding: 0 10px; font-size: 13px; }
+.ct-btn--primary { background: var(--accent); color: var(--text-on-accent); }
+.ct-btn--primary:hover:not(:disabled) { background: var(--accent-hover); }
+.ct-btn--primary:active:not(:disabled) { background: var(--accent-pressed); }
+.ct-btn--secondary { background: var(--surface-card); border-color: var(--line-2); color: var(--ink-1); }
+.ct-btn--secondary:hover:not(:disabled) { background: var(--paper-2); }
+.ct-btn--secondary:active:not(:disabled) { background: var(--paper-3); }
+.ct-btn--ghost { background: transparent; color: var(--ink-2); }
+.ct-btn--ghost:hover:not(:disabled) { background: var(--paper-2); color: var(--ink-1); }
+.ct-btn--ghost:active:not(:disabled) { background: var(--paper-3); }
+.ct-btn--danger { background: var(--danger); color: var(--ink-inverse); }
+.ct-btn--danger:hover:not(:disabled) { filter: brightness(0.92); }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-button-css')) {
+    const s = document.createElement('style'); s.id = 'ct-button-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Button({
+  variant = 'primary',
+  size = 'md',
+  icon,
+  iconRight,
+  disabled = false,
+  children,
+  style,
+  ...rest
+}: ButtonProps) {
+  const iconSize = size === 'sm' ? 15 : 17;
+  return (
+    <button
+      type="button"
+      className={`ct-btn ct-btn--${size} ct-btn--${variant}`}
+      disabled={disabled}
+      style={style}
+      {...rest}
+    >
+      {icon ? <Icon name={icon} size={iconSize} /> : null}
+      {children}
+      {iconRight ? <Icon name={iconRight} size={iconSize} /> : null}
+    </button>
+  );
+}

apps/desktop/src/renderer/src/components/ui/card.tsx

@@ -0,0 +1,79 @@
+import React from 'react';
+
+/**
+ * Paper card — hairline border, 10px radius, whispered shadow. `jade` adds the jade top rule
+ * reserved for the view's key card (e.g. the Focus card).
+ */
+export interface CardProps {
+  /** Caslon title */
+  title?: React.ReactNode;
+  /** Small uppercase label above the title */
+  overline?: string;
+  /** Right-aligned header actions (IconButtons) */
+  actions?: React.ReactNode;
+  /** Footer row below a hairline */
+  footer?: React.ReactNode;
+  /** Jade top rule — one per view @default false */
+  jade?: boolean;
+  /** Remove body padding (tables, charts) @default false */
+  flush?: boolean;
+  children?: React.ReactNode;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-card {
+  background: var(--surface-card);
+  border: 1px solid var(--border-hairline);
+  border-radius: var(--radius-3);
+  box-shadow: var(--shadow-1);
+}
+.ct-card--jade { box-shadow: var(--shadow-jade-line), var(--shadow-1); }
+.ct-card__header {
+  display: flex; align-items: baseline; justify-content: space-between; gap: 12px;
+  padding: 16px 20px 0;
+}
+.ct-card__title {
+  font: var(--text-title);
+  color: var(--ink-1);
+  margin: 0;
+}
+.ct-card__overline {
+  font: var(--text-overline);
+  letter-spacing: var(--letter-spacing-wide);
+  text-transform: uppercase;
+  color: var(--ink-3);
+  margin: 0 0 6px;
+}
+.ct-card__body { padding: 14px 20px 18px; }
+.ct-card__body--flush { padding: 0; }
+.ct-card__footer {
+  display: flex; align-items: center; gap: 8px;
+  padding: 12px 20px;
+  border-top: 1px solid var(--border-hairline);
+}
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-card-css')) {
+    const s = document.createElement('style'); s.id = 'ct-card-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Card({ title, overline, actions, footer, jade = false, flush = false, children, style, ...rest }: CardProps) {
+  return (
+    <section className={`ct-card${jade ? ' ct-card--jade' : ''}`} style={style} {...rest}>
+      {(title || overline || actions) ? (
+        <header className="ct-card__header">
+          <div>
+            {overline ? <p className="ct-card__overline">{overline}</p> : null}
+            {title ? <h2 className="ct-card__title">{title}</h2> : null}
+          </div>
+          {actions ? <div style={{ display: 'flex', gap: '4px', flexShrink: 0 }}>{actions}</div> : null}
+        </header>
+      ) : null}
+      <div className={`ct-card__body${flush ? ' ct-card__body--flush' : ''}`}>{children}</div>
+      {footer ? <footer className="ct-card__footer">{footer}</footer> : null}
+    </section>
+  );
+}

apps/desktop/src/renderer/src/components/ui/checkbox.tsx

@@ -0,0 +1,54 @@
+import React from 'react'
+import { Icon } from './icon.js'
+
+/**
+ * Checkbox with label; 16px box, spruce when checked.
+ */
+export interface CheckboxProps {
+  label?: React.ReactNode;
+  checked?: boolean;
+  onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+  disabled?: boolean;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-check { display: inline-flex; align-items: center; gap: 9px; cursor: pointer; font: var(--text-body); color: var(--ink-1); }
+.ct-check--disabled { opacity: 0.5; cursor: not-allowed; }
+.ct-check__input { position: absolute; opacity: 0; width: 0; height: 0; }
+.ct-check__box {
+  width: 16px; height: 16px; flex-shrink: 0;
+  display: inline-flex; align-items: center; justify-content: center;
+  background: var(--surface-card);
+  border: 1px solid var(--line-2);
+  border-radius: var(--radius-1);
+  color: transparent;
+  transition: background var(--duration-fast) var(--ease-out), border-color var(--duration-fast) var(--ease-out);
+}
+.ct-check:hover:not(.ct-check--disabled) .ct-check__box { border-color: var(--border-strong); }
+.ct-check__input:checked + .ct-check__box { background: var(--accent); border-color: var(--accent); color: var(--ink-inverse); }
+.ct-check__input:focus-visible + .ct-check__box { outline: 2px solid var(--focus-ring); outline-offset: 2px; }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-check-css')) {
+    const s = document.createElement('style'); s.id = 'ct-check-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Checkbox({ label, checked, onChange, disabled = false, style, ...rest }: CheckboxProps) {
+  return (
+    <label className={`ct-check${disabled ? ' ct-check--disabled' : ''}`} style={style}>
+      <input
+        type="checkbox"
+        className="ct-check__input"
+        checked={checked}
+        onChange={onChange}
+        disabled={disabled}
+        {...rest}
+      />
+      <span className="ct-check__box"><Icon name="check" size={12} strokeWidth={2.5} /></span>
+      {label ? <span>{label}</span> : null}
+    </label>
+  );
+}

apps/desktop/src/renderer/src/components/ui/dialog.tsx

@@ -0,0 +1,82 @@
+import React from 'react'
+import { IconButton } from './icon-button.js'
+
+/**
+ * Modal dialog — Caslon title over a double stationery rule; used for propose-approve
+ * moments and destructive confirms.
+ */
+export interface DialogProps {
+  open: boolean;
+  onClose?: () => void;
+  title: React.ReactNode;
+  /** Right-aligned action row (Buttons) */
+  footer?: React.ReactNode;
+  children?: React.ReactNode;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-dialog-scrim {
+  position: fixed; inset: 0;
+  background: rgba(32, 38, 29, 0.4);
+  display: flex; align-items: center; justify-content: center;
+  z-index: 100;
+  animation: ct-dialog-fade var(--duration-base) var(--ease-out);
+}
+.ct-dialog {
+  background: var(--surface-card);
+  border: 1px solid var(--border-hairline);
+  border-radius: var(--radius-3);
+  box-shadow: var(--shadow-3);
+  width: min(480px, calc(100vw - 48px));
+  max-height: calc(100vh - 96px);
+  display: flex; flex-direction: column;
+  animation: ct-dialog-rise var(--duration-base) var(--ease-out);
+}
+.ct-dialog__header {
+  display: flex; align-items: flex-start; justify-content: space-between; gap: 12px;
+  padding: 20px 20px 12px;
+  border-bottom: 3px double var(--border-strong);
+  margin: 0 20px; padding-left: 0; padding-right: 0;
+}
+.ct-dialog__title { font: var(--text-title); color: var(--ink-1); margin: 0; }
+.ct-dialog__body { padding: 16px 20px; overflow-y: auto; font: var(--text-body); color: var(--ink-1); }
+.ct-dialog__footer {
+  display: flex; justify-content: flex-end; gap: 8px;
+  padding: 12px 20px 20px;
+}
+@keyframes ct-dialog-fade { from { opacity: 0; } }
+@keyframes ct-dialog-rise { from { opacity: 0; transform: translateY(8px); } }
+@media (prefers-reduced-motion: reduce) {
+  .ct-dialog-scrim, .ct-dialog { animation: none; }
+}
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-dialog-css')) {
+    const s = document.createElement('style'); s.id = 'ct-dialog-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Dialog({ open, onClose, title, footer, children, style }: DialogProps) {
+  React.useEffect(() => {
+    if (!open) return;
+    const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape' && onClose) onClose(); };
+    document.addEventListener('keydown', onKey);
+    return () => document.removeEventListener('keydown', onKey);
+  }, [open, onClose]);
+
+  if (!open) return null;
+  return (
+    <div className="ct-dialog-scrim" onClick={(e: React.MouseEvent) => { if (e.target === e.currentTarget && onClose) onClose(); }}>
+      <div className="ct-dialog" role="dialog" aria-modal="true" style={style}>
+        <header className="ct-dialog__header">
+          <h2 className="ct-dialog__title">{title}</h2>
+          {onClose ? <IconButton icon="x" label="Close" size="sm" onClick={onClose} /> : null}
+        </header>
+        <div className="ct-dialog__body">{children}</div>
+        {footer ? <footer className="ct-dialog__footer">{footer}</footer> : null}
+      </div>
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/ui/icon-button.tsx

@@ -0,0 +1,68 @@
+import React from 'react';
+import { Icon } from './icon.js';
+
+/**
+ * Square icon-only button; label is mandatory (becomes aria-label + title).
+ */
+export interface IconButtonProps {
+  /** Lucide icon name */
+  icon: string;
+  /** Required accessible label (also the tooltip) */
+  label: string;
+  /** @default 'ghost' */
+  variant?: 'ghost' | 'outline';
+  /** @default 'md' */
+  size?: 'sm' | 'md';
+  disabled?: boolean;
+  onClick?: (e: React.MouseEvent) => void;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-iconbtn {
+  display: inline-flex; align-items: center; justify-content: center;
+  border-radius: var(--radius-2);
+  border: 1px solid transparent;
+  background: transparent;
+  color: var(--ink-2);
+  cursor: pointer;
+  transition: background var(--duration-fast) var(--ease-out), color var(--duration-fast) var(--ease-out);
+}
+.ct-iconbtn:hover:not(:disabled) { background: var(--paper-2); color: var(--ink-1); }
+.ct-iconbtn:active:not(:disabled) { background: var(--paper-3); }
+.ct-iconbtn:disabled { opacity: 0.45; cursor: not-allowed; }
+.ct-iconbtn--md { width: 34px; height: 34px; }
+.ct-iconbtn--sm { width: 28px; height: 28px; }
+.ct-iconbtn--outline { border-color: var(--line-2); background: var(--surface-card); }
+.ct-iconbtn--outline:hover:not(:disabled) { background: var(--paper-2); }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-iconbtn-css')) {
+    const s = document.createElement('style'); s.id = 'ct-iconbtn-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function IconButton({
+  icon,
+  label,
+  variant = 'ghost',
+  size = 'md',
+  disabled = false,
+  style,
+  ...rest
+}: IconButtonProps) {
+  return (
+    <button
+      type="button"
+      className={`ct-iconbtn ct-iconbtn--${size}${variant === 'outline' ? ' ct-iconbtn--outline' : ''}`}
+      aria-label={label}
+      title={label}
+      disabled={disabled}
+      style={style}
+      {...rest}
+    >
+      <Icon name={icon} size={size === 'sm' ? 15 : 17} />
+    </button>
+  );
+}

apps/desktop/src/renderer/src/components/ui/index.ts

@@ -0,0 +1,21 @@
+/**
+ * CommiTea design-system primitives, ported verbatim from the design handoff
+ * (docs/design/components/). Each keeps its injected token-referencing CSS; the
+ * contracts in the handoff's `.d.ts` files are reproduced here as the exported
+ * prop interfaces. Import from `#~/components/ui` — never reach into a file.
+ */
+export * from './icon.js'
+export * from './button.js'
+export * from './icon-button.js'
+export * from './badge.js'
+export * from './tag.js'
+export * from './card.js'
+export * from './tabs.js'
+export * from './input.js'
+export * from './checkbox.js'
+export * from './radio.js'
+export * from './switch.js'
+export * from './select.js'
+export * from './dialog.js'
+export * from './toast.js'
+export * from './tooltip.js'

apps/desktop/src/renderer/src/components/ui/input.tsx

@@ -0,0 +1,76 @@
+import React from 'react'
+import { Icon } from './icon.js'
+
+/**
+ * Single-line text input with optional label, hint/error and leading icon.
+ */
+export interface InputProps {
+  label?: string;
+  /** Small gray helper under the field */
+  hint?: string;
+  /** Replaces hint; turns the border madder red */
+  error?: string;
+  /** Lucide icon name, leading */
+  icon?: string;
+  /** Mono text for machine values (urls, tokens) @default false */
+  mono?: boolean;
+  placeholder?: string;
+  value?: string;
+  defaultValue?: string;
+  onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+  disabled?: boolean;
+  type?: string;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-field { display: flex; flex-direction: column; gap: 6px; }
+.ct-field__label { font: 600 13px/1.2 var(--font-sans); color: var(--ink-1); }
+.ct-field__wrap { position: relative; display: flex; align-items: center; }
+.ct-field__icon { position: absolute; left: 10px; color: var(--ink-3); pointer-events: none; display: flex; }
+.ct-input {
+  width: 100%; height: 34px;
+  font: var(--text-body);
+  color: var(--ink-1);
+  background: var(--surface-card);
+  border: 1px solid var(--line-2);
+  border-radius: var(--radius-2);
+  padding: 0 12px;
+  transition: border-color var(--duration-fast) var(--ease-out);
+}
+.ct-input::placeholder { color: var(--ink-3); }
+.ct-input:hover:not(:disabled):not(:focus) { border-color: var(--border-strong); background: var(--paper-1); }
+.ct-input:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 1px var(--accent); }
+.ct-input:disabled { opacity: 0.5; background: var(--paper-2); cursor: not-allowed; }
+.ct-input--icon { padding-left: 32px; }
+.ct-input--error { border-color: var(--danger); }
+.ct-input--error:focus { border-color: var(--danger); box-shadow: 0 0 0 1px var(--danger); }
+.ct-input--mono { font: var(--text-data); }
+.ct-field__hint { font: var(--text-caption); color: var(--ink-3); margin: 0; }
+.ct-field__error { font: var(--text-caption); color: var(--danger); margin: 0; }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-input-css')) {
+    const s = document.createElement('style'); s.id = 'ct-input-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Input({ label, hint, error, icon, mono = false, style, ...rest }: InputProps) {
+  const cls = [
+    'ct-input',
+    icon ? 'ct-input--icon' : '',
+    error ? 'ct-input--error' : '',
+    mono ? 'ct-input--mono' : '',
+  ].filter(Boolean).join(' ');
+  return (
+    <div className="ct-field" style={style}>
+      {label ? <label className="ct-field__label">{label}</label> : null}
+      <div className="ct-field__wrap">
+        {icon ? <span className="ct-field__icon"><Icon name={icon} size={15} /></span> : null}
+        <input className={cls} {...rest} />
+      </div>
+      {error ? <p className="ct-field__error">{error}</p> : hint ? <p className="ct-field__hint">{hint}</p> : null}
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/ui/radio.tsx

@@ -0,0 +1,63 @@
+import React from 'react';
+
+/**
+ * Radio button with label; group by `name`.
+ */
+export interface RadioProps {
+  label?: React.ReactNode;
+  checked?: boolean;
+  onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+  name?: string;
+  value?: string;
+  disabled?: boolean;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-radio { display: inline-flex; align-items: center; gap: 9px; cursor: pointer; font: var(--text-body); color: var(--ink-1); }
+.ct-radio--disabled { opacity: 0.5; cursor: not-allowed; }
+.ct-radio__input { position: absolute; opacity: 0; width: 0; height: 0; }
+.ct-radio__dot {
+  width: 16px; height: 16px; flex-shrink: 0;
+  border: 1px solid var(--line-2);
+  border-radius: 50%;
+  background: var(--surface-card);
+  display: inline-flex; align-items: center; justify-content: center;
+  transition: border-color var(--duration-fast) var(--ease-out);
+}
+.ct-radio__dot::after {
+  content: '';
+  width: 8px; height: 8px; border-radius: 50%;
+  background: transparent;
+  transition: background var(--duration-fast) var(--ease-out);
+}
+.ct-radio:hover:not(.ct-radio--disabled) .ct-radio__dot { border-color: var(--border-strong); }
+.ct-radio__input:checked + .ct-radio__dot { border-color: var(--accent); }
+.ct-radio__input:checked + .ct-radio__dot::after { background: var(--accent); }
+.ct-radio__input:focus-visible + .ct-radio__dot { outline: 2px solid var(--focus-ring); outline-offset: 2px; }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-radio-css')) {
+    const s = document.createElement('style'); s.id = 'ct-radio-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Radio({ label, checked, onChange, name, value, disabled = false, style, ...rest }: RadioProps) {
+  return (
+    <label className={`ct-radio${disabled ? ' ct-radio--disabled' : ''}`} style={style}>
+      <input
+        type="radio"
+        className="ct-radio__input"
+        checked={checked}
+        onChange={onChange}
+        name={name}
+        value={value}
+        disabled={disabled}
+        {...rest}
+      />
+      <span className="ct-radio__dot"></span>
+      {label ? <span>{label}</span> : null}
+    </label>
+  );
+}

apps/desktop/src/renderer/src/components/ui/select.tsx

@@ -0,0 +1,64 @@
+import React from 'react'
+
+import { Icon } from './icon.js'
+
+/**
+ * Styled native select with Lucide chevron.
+ */
+export interface SelectOption {
+  value: string;
+  label: string;
+}
+export interface SelectProps {
+  label?: string;
+  options: SelectOption[];
+  value?: string;
+  defaultValue?: string;
+  onChange?: (e: React.ChangeEvent<HTMLSelectElement>) => void;
+  disabled?: boolean;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-select-field { display: flex; flex-direction: column; gap: 6px; }
+.ct-select-field__label { font: 600 13px/1.2 var(--font-sans); color: var(--ink-1); }
+.ct-select__wrap { position: relative; display: flex; align-items: center; }
+.ct-select {
+  width: 100%; height: 34px;
+  font: var(--text-body);
+  color: var(--ink-1);
+  background: var(--surface-card);
+  border: 1px solid var(--line-2);
+  border-radius: var(--radius-2);
+  padding: 0 30px 0 12px;
+  appearance: none;
+  cursor: pointer;
+  transition: border-color var(--duration-fast) var(--ease-out);
+}
+.ct-select:hover:not(:disabled):not(:focus) { border-color: var(--border-strong); }
+.ct-select:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 1px var(--accent); }
+.ct-select:disabled { opacity: 0.5; cursor: not-allowed; }
+.ct-select__chevron { position: absolute; right: 10px; color: var(--ink-3); pointer-events: none; display: flex; }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-select-css')) {
+    const s = document.createElement('style'); s.id = 'ct-select-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Select({ label, options, style, ...rest }: SelectProps) {
+  return (
+    <div className="ct-select-field" style={style}>
+      {label ? <label className="ct-select-field__label">{label}</label> : null}
+      <div className="ct-select__wrap">
+        <select className="ct-select" {...rest}>
+          {options.map((o) => (
+            <option key={o.value} value={o.value}>{o.label}</option>
+          ))}
+        </select>
+        <span className="ct-select__chevron"><Icon name="chevron-down" size={15} /></span>
+      </div>
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/ui/switch.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+
+/**
+ * On/off switch; spruce when on. For live state, not form options.
+ */
+export interface SwitchProps {
+  label?: React.ReactNode;
+  checked?: boolean;
+  onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+  disabled?: boolean;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-switch { display: inline-flex; align-items: center; gap: 9px; cursor: pointer; font: var(--text-body); color: var(--ink-1); }
+.ct-switch--disabled { opacity: 0.5; cursor: not-allowed; }
+.ct-switch__input { position: absolute; opacity: 0; width: 0; height: 0; }
+.ct-switch__track {
+  width: 34px; height: 20px; flex-shrink: 0;
+  border-radius: var(--radius-round);
+  background: var(--paper-3);
+  border: 1px solid var(--line-2);
+  position: relative;
+  transition: background var(--duration-base) var(--ease-out), border-color var(--duration-base) var(--ease-out);
+}
+.ct-switch__track::after {
+  content: '';
+  position: absolute; top: 2px; left: 2px;
+  width: 14px; height: 14px; border-radius: 50%;
+  background: var(--surface-card);
+  box-shadow: var(--shadow-1);
+  transition: transform var(--duration-base) var(--ease-out);
+}
+.ct-switch__input:checked + .ct-switch__track { background: var(--accent); border-color: var(--accent); }
+.ct-switch__input:checked + .ct-switch__track::after { transform: translateX(14px); }
+.ct-switch__input:focus-visible + .ct-switch__track { outline: 2px solid var(--focus-ring); outline-offset: 2px; }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-switch-css')) {
+    const s = document.createElement('style'); s.id = 'ct-switch-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Switch({ label, checked, onChange, disabled = false, style, ...rest }: SwitchProps) {
+  return (
+    <label className={`ct-switch${disabled ? ' ct-switch--disabled' : ''}`} style={style}>
+      <input
+        type="checkbox"
+        role="switch"
+        className="ct-switch__input"
+        checked={checked}
+        onChange={onChange}
+        disabled={disabled}
+        {...rest}
+      />
+      <span className="ct-switch__track"></span>
+      {label ? <span>{label}</span> : null}
+    </label>
+  );
+}

apps/desktop/src/renderer/src/components/ui/tabs.tsx

@@ -0,0 +1,73 @@
+import React from 'react';
+import { Icon } from './icon.js';
+
+/**
+ * Underline tabs for view switching (Board / Gantt / Dependencies).
+ */
+export interface TabItem {
+  id: string;
+  label: string;
+  /** Lucide icon name */
+  icon?: string;
+  /** Mono count rendered after the label */
+  count?: number;
+}
+export interface TabsProps {
+  items: TabItem[];
+  /** id of the active tab */
+  active: string;
+  onChange?: (id: string) => void;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-tabs {
+  display: flex; gap: 2px;
+  border-bottom: 1px solid var(--border-hairline);
+}
+.ct-tab {
+  display: inline-flex; align-items: center; gap: 7px;
+  font: 500 13.5px/1 var(--font-sans);
+  color: var(--ink-2);
+  background: none; border: none;
+  padding: 10px 12px;
+  margin-bottom: -1px;
+  border-bottom: 2px solid transparent;
+  cursor: pointer;
+  transition: color var(--duration-fast) var(--ease-out);
+}
+.ct-tab:hover { color: var(--ink-1); }
+.ct-tab--active {
+  color: var(--ink-1);
+  font-weight: 600;
+  border-bottom-color: var(--accent);
+}
+.ct-tab__count { font: 400 11.5px/1 var(--font-mono); color: var(--ink-3); }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-tabs-css')) {
+    const s = document.createElement('style'); s.id = 'ct-tabs-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Tabs({ items, active, onChange, style, ...rest }: TabsProps) {
+  return (
+    <div className="ct-tabs" role="tablist" style={style} {...rest}>
+      {items.map((item) => (
+        <button
+          key={item.id}
+          type="button"
+          role="tab"
+          aria-selected={item.id === active}
+          className={`ct-tab${item.id === active ? ' ct-tab--active' : ''}`}
+          onClick={() => onChange && onChange(item.id)}
+        >
+          {item.icon ? <Icon name={item.icon} size={15} /> : null}
+          {item.label}
+          {item.count != null ? <span className="ct-tab__count">{item.count}</span> : null}
+        </button>
+      ))}
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/ui/tag.tsx

@@ -0,0 +1,66 @@
+import React from 'react'
+import { Icon } from './icon.js'
+
+/**
+ * Gitea label chip — renders label text verbatim in mono; tone derives from the label itself
+ * (est/[1d 2d 3d 5d 8d], p/1..4, deadline/hard).
+ */
+export interface TagProps {
+  /** Verbatim gitea label, e.g. "est/3d", "p/1", "deadline/hard" */
+  label: string;
+  /** Renders a small remove button when provided */
+  onRemove?: (e: React.MouseEvent) => void;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-tag {
+  display: inline-flex; align-items: center; gap: 5px;
+  font: 500 11.5px/1 var(--font-mono);
+  letter-spacing: var(--letter-spacing-label);
+  padding: 4px 9px;
+  border-radius: var(--radius-round);
+  white-space: nowrap;
+}
+.ct-tag--est { background: var(--label-est-bg); color: var(--label-est-text); }
+.ct-tag--p1 { background: var(--danger-tint); color: var(--label-p1); }
+.ct-tag--p2 { background: var(--warn-tint); color: var(--label-p2); }
+.ct-tag--p3 { background: var(--info-tint); color: var(--label-p3); }
+.ct-tag--p4 { background: var(--paper-2); color: var(--label-p4); }
+.ct-tag--hard { background: var(--label-hard); color: var(--ink-inverse); }
+.ct-tag--plain { background: var(--paper-2); color: var(--ink-2); }
+.ct-tag__x {
+  display: inline-flex; padding: 0; margin: 0 -3px 0 0;
+  background: none; border: none; color: inherit; cursor: pointer; opacity: 0.6;
+}
+.ct-tag__x:hover { opacity: 1; }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-tag-css')) {
+    const s = document.createElement('style'); s.id = 'ct-tag-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+function toneFor(label: string) {
+  if (label.startsWith('est/')) return 'est';
+  if (label === 'p/1') return 'p1';
+  if (label === 'p/2') return 'p2';
+  if (label === 'p/3') return 'p3';
+  if (label === 'p/4') return 'p4';
+  if (label === 'deadline/hard') return 'hard';
+  return 'plain';
+}
+
+export function Tag({ label, onRemove, style, ...rest }: TagProps) {
+  return (
+    <span className={`ct-tag ct-tag--${toneFor(label)}`} style={style} {...rest}>
+      {label}
+      {onRemove ? (
+        <button type="button" className="ct-tag__x" aria-label={`Remove ${label}`} onClick={onRemove}>
+          <Icon name="x" size={11} strokeWidth={2} />
+        </button>
+      ) : null}
+    </span>
+  );
+}

apps/desktop/src/renderer/src/components/ui/toast.tsx

@@ -0,0 +1,65 @@
+import React from 'react';
+import { Icon } from './icon.js';
+import { IconButton } from './icon-button.js';
+
+/**
+ * Transient notification card. Presentational — the consumer owns positioning/stacking.
+ */
+export interface ToastProps {
+  /** @default 'info' */
+  tone?: 'ok' | 'warn' | 'danger' | 'info';
+  title?: React.ReactNode;
+  onDismiss?: () => void;
+  children?: React.ReactNode;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-toast {
+  display: flex; align-items: flex-start; gap: 10px;
+  background: var(--surface-card);
+  border: 1px solid var(--border-hairline);
+  border-radius: var(--radius-2);
+  box-shadow: var(--shadow-2);
+  padding: 12px 14px;
+  max-width: 420px;
+  font: var(--text-body);
+  color: var(--ink-1);
+  animation: ct-toast-in var(--duration-slow) var(--ease-out);
+}
+.ct-toast__icon { display: flex; margin-top: 1px; }
+.ct-toast--ok .ct-toast__icon { color: var(--ok); }
+.ct-toast--warn .ct-toast__icon { color: var(--warn); }
+.ct-toast--danger .ct-toast__icon { color: var(--danger); }
+.ct-toast--info .ct-toast__icon { color: var(--info); }
+.ct-toast__content { flex: 1; min-width: 0; }
+.ct-toast__title { font: var(--text-body-strong); margin: 0 0 2px; }
+@keyframes ct-toast-in { from { opacity: 0; transform: translateY(6px); } }
+@media (prefers-reduced-motion: reduce) { .ct-toast { animation: none; } }
+`;
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-toast-css')) {
+    const s = document.createElement('style'); s.id = 'ct-toast-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+const TOAST_ICONS: Record<string, string> = {
+  ok: 'circle-check',
+  warn: 'triangle-alert',
+  danger: 'circle-alert',
+  info: 'info',
+};
+
+export function Toast({ tone = 'info', title, onDismiss, children, style, ...rest }: ToastProps) {
+  return (
+    <div className={`ct-toast ct-toast--${tone}`} role="status" style={style} {...rest}>
+      <span className="ct-toast__icon"><Icon name={TOAST_ICONS[tone]} size={16} /></span>
+      <div className="ct-toast__content">
+        {title ? <p className="ct-toast__title">{title}</p> : null}
+        {children}
+      </div>
+      {onDismiss ? <IconButton icon="x" label="Dismiss" size="sm" onClick={onDismiss} /> : null}
+    </div>
+  );
+}

apps/desktop/src/renderer/src/components/ui/tooltip.tsx

@@ -0,0 +1,55 @@
+import React from 'react';
+
+/**
+ * Hover/focus tooltip — ink capsule, plain facts only.
+ */
+export interface TooltipProps {
+  content: React.ReactNode;
+  /** @default 'top' */
+  side?: 'top' | 'bottom';
+  children?: React.ReactNode;
+  style?: React.CSSProperties;
+}
+
+const CSS = `
+.ct-tooltip-wrap { position: relative; display: inline-flex; }
+.ct-tooltip {
+  position: absolute; bottom: calc(100% + 7px); left: 50%;
+  transform: translateX(-50%) translateY(2px);
+  background: var(--ink-1);
+  color: var(--ink-inverse);
+  font: 500 12px/1.4 var(--font-sans);
+  padding: 5px 9px;
+  border-radius: var(--radius-1);
+  white-space: nowrap;
+  pointer-events: none;
+  opacity: 0;
+  transition: opacity var(--duration-fast) var(--ease-out), transform var(--duration-fast) var(--ease-out);
+  z-index: 50;
+}
+.ct-tooltip--bottom { bottom: auto; top: calc(100% + 7px); transform: translateX(-50%) translateY(-2px); }
+.ct-tooltip-wrap:hover .ct-tooltip,
+.ct-tooltip-wrap:focus-within .ct-tooltip {
+  opacity: 1;
+  transform: translateX(-50%) translateY(0);
+}
+.ct-tooltip code { font: 500 11px var(--font-mono); }
+`;
+
+(function inject() {
+  if (typeof document !== 'undefined' && !document.getElementById('ct-tooltip-css')) {
+    const s = document.createElement('style'); s.id = 'ct-tooltip-css'; s.textContent = CSS;
+    document.head.appendChild(s);
+  }
+})();
+
+export function Tooltip({ content, side = 'top', children, style }: TooltipProps) {
+  return (
+    <span className="ct-tooltip-wrap" style={style}>
+      {children}
+      <span className={`ct-tooltip${side === 'bottom' ? ' ct-tooltip--bottom' : ''}`} role="tooltip">
+        {content}
+      </span>
+    </span>
+  );
+}

apps/desktop/src/renderer/src/data/fixtures.ts

@@ -0,0 +1,533 @@
+/**
+ * Demo fixtures mirrored from the design handoff's `data.js`. Stand-ins until
+ * P1 fills the SQLite cache and P4 wires the real agent. Replace, don't extend
+ * into production code.
+ */
+
+export interface ChatMessage {
+  from: 'agent' | 'user'
+  text: string
+}
+
+export const CHAT: ChatMessage[] = [
+  { from: 'agent', text: 'Morning service. Two things drifted overnight; one needs your opinion.' },
+  {
+    from: 'agent',
+    text: '#84 grew a dependency on #92 — I’ve reordered. And #87 has been steeping for four days; it blocks two others. Worth a look.',
+  },
+  { from: 'user', text: 'Push the calibration work to next week, pilots come first' },
+  {
+    from: 'agent',
+    text: 'Done — #78 moves to next week. Milestone Beta is unmoved; the cone doesn’t care for calibration either. Logged as a directive.',
+  },
+]
+
+export const CANNED_REPLY =
+  'Noted and logged as a directive. The scheduler is re-running — I’ll show you the consequence diff in a moment.'
+
+export const TODAY = 'Tuesday 7 July 2026'
+
+export interface FocusIssue {
+  id: number
+  title: string
+  labels: string[]
+  steeping?: string
+  rationale: string
+}
+
+export interface FocusData {
+  now: FocusIssue
+  next: FocusIssue
+  later: FocusIssue
+}
+
+export const FOCUS: FocusData = {
+  now: {
+    id: 87,
+    title: 'Fix lifecycle inference on merge events',
+    labels: ['est/2d', 'p/1'],
+    steeping: '4d',
+    rationale: 'It blocks #91 and #92. I’d take it first — the critical path agrees with me.',
+  },
+  next: {
+    id: 91,
+    title: 'Webhook listener: reconcile on reconnect',
+    labels: ['est/3d', 'p/2'],
+    rationale: 'Ready the moment #87 lands. The estimate is yours; history says add a day.',
+  },
+  later: {
+    id: 78,
+    title: 'Calibration store cold-start distributions',
+    labels: ['est/5d', 'p/3'],
+    rationale: 'Nothing depends on it yet. It can steep.',
+  },
+}
+
+export interface DriftItem {
+  tone: 'ok' | 'warn' | 'danger'
+  text: string
+  delta: string
+}
+
+export interface PlanItem {
+  who: string
+  pick: string
+  title: string
+  why: string
+}
+
+export interface Nag {
+  id: number
+  days: string
+  blocks: string[]
+  text: string
+}
+
+export interface StandupData {
+  date: string
+  drift: DriftItem[]
+  plan: PlanItem[]
+  nag: Nag
+}
+
+export const STANDUP: StandupData = {
+  date: 'Tuesday 7 July 2026',
+  drift: [
+    { tone: 'warn', text: '#84 grew a dependency on #92 overnight.', delta: 'reordered · no date impact' },
+    { tone: 'warn', text: '#92 has sat in review for two days.', delta: 'Beta 80% +1d if idle past Thu' },
+    { tone: 'ok', text: 'Webhook outage 02:14–02:31; full reconcile ran.', delta: 'nothing lost' },
+  ],
+  plan: [
+    {
+      who: 'Stephen',
+      pick: '#87',
+      title: 'Fix lifecycle inference on merge events',
+      why: 'It blocks two others and the critical path runs straight through it.',
+    },
+    {
+      who: 'Ana K.',
+      pick: '#84',
+      title: 'Capacity model: focus factor per person',
+      why: 'Already steeping — finish it before anything new is poured.',
+    },
+  ],
+  nag: {
+    id: 87,
+    days: '4d',
+    blocks: ['#91', '#92'],
+    text: 'Four days is a long steep. It blocks #91 and #92 — worth a look before it stains.',
+  },
+}
+
+/** Lightweight issue reference handed to the shell's drill-in from any screen. */
+export interface IssueRef {
+  id: number
+  title?: string
+  labels?: string[]
+  days?: string
+  rationale?: string
+}
+
+// ---- Board (The pot) ----
+
+export interface BoardIssue {
+  id: number
+  title: string
+  labels: string[]
+  who: string
+  blocked?: boolean
+  days?: string
+  pr?: string
+}
+
+export interface BoardColumn {
+  id: string
+  label: string
+  issues: BoardIssue[]
+}
+
+export const COLUMNS: BoardColumn[] = [
+  {
+    id: 'diagnosis',
+    label: 'Diagnosis',
+    issues: [
+      { id: 102, title: 'Scheduler ignores standing allocation slices', labels: ['p/2'], who: 'SM' },
+      { id: 103, title: 'Dark theme: cone fill too faint', labels: ['p/4'], who: 'SM' },
+    ],
+  },
+  {
+    id: 'triage',
+    label: 'Triage',
+    issues: [
+      { id: 99, title: 'Directive log: conflict-free merge test', labels: ['est/1d', 'p/2'], who: 'SM' },
+      { id: 96, title: 'Label schema bootstrap for new repos', labels: ['est/2d', 'p/3'], who: 'AK' },
+      { id: 78, title: 'Calibration store cold-start distributions', labels: ['est/5d', 'p/3'], who: 'SM' },
+    ],
+  },
+  {
+    id: 'steeping',
+    label: 'Steeping',
+    issues: [
+      { id: 87, title: 'Fix lifecycle inference on merge events', labels: ['est/2d', 'p/1'], who: 'SM', blocked: false, days: '4d' },
+      { id: 84, title: 'Capacity model: focus factor per person', labels: ['est/3d', 'p/2'], who: 'AK', days: '1d' },
+    ],
+  },
+  {
+    id: 'review',
+    label: 'In review',
+    issues: [{ id: 92, title: 'Monte Carlo engine: percentile bands', labels: ['est/5d', 'p/1'], who: 'SM', pr: '#141' }],
+  },
+  {
+    id: 'done',
+    label: 'Done',
+    issues: [
+      { id: 71, title: 'Gitea client: token auth + retries', labels: ['est/2d', 'p/2'], who: 'SM' },
+      { id: 69, title: 'pm-state repo bootstrap', labels: ['est/1d', 'p/1'], who: 'SM' },
+      { id: 65, title: 'Electron shell + window state', labels: ['est/3d', 'p/2'], who: 'AK' },
+    ],
+  },
+]
+
+// ---- Gantt ----
+
+export interface GanttWeek {
+  at: number
+  label: string
+}
+
+export interface GanttRow {
+  id: number
+  title: string
+  who: string
+  state: 'done' | 'steeping' | 'review' | 'scheduled'
+  start: number
+  end: number
+  p80?: number
+  crit?: boolean
+}
+
+export interface GanttData {
+  days: number
+  weeks: GanttWeek[]
+  today: number
+  band: { from: number; to: number; label: string }
+  due: { at: number; label: string }
+  rows: GanttRow[]
+}
+
+export const GANTT: GanttData = {
+  days: 42,
+  weeks: [
+    { at: 0, label: 'Feb 2' },
+    { at: 7, label: 'Feb 9' },
+    { at: 14, label: 'Feb 16' },
+    { at: 21, label: 'Feb 23' },
+    { at: 28, label: 'Mar 2' },
+    { at: 35, label: 'Mar 9' },
+    { at: 41, label: 'Mar 15' },
+  ],
+  today: 8,
+  band: { from: 29, to: 38, label: '80% · Mar 3–12' },
+  due: { at: 41, label: 'Beta due' },
+  rows: [
+    { id: 71, title: 'Gitea client: token auth + retries', who: 'SM', state: 'done', start: 0, end: 4 },
+    { id: 69, title: 'pm-state repo bootstrap', who: 'SM', state: 'done', start: 0, end: 1 },
+    { id: 87, title: 'Fix lifecycle inference on merge events', who: 'SM', state: 'steeping', start: 4, end: 9, p80: 11, crit: true },
+    { id: 92, title: 'Monte Carlo engine: percentile bands', who: 'SM', state: 'review', start: 9, end: 18, p80: 21, crit: true },
+    { id: 91, title: 'Webhook listener: reconcile on reconnect', who: 'AK', state: 'scheduled', start: 9, end: 14, p80: 16 },
+    { id: 99, title: 'Directive log: conflict-free merge test', who: 'SM', state: 'scheduled', start: 10, end: 11 },
+    { id: 96, title: 'Label schema bootstrap for new repos', who: 'AK', state: 'scheduled', start: 14, end: 16 },
+    { id: 84, title: 'Capacity model: focus factor per person', who: 'AK', state: 'scheduled', start: 18, end: 23, p80: 26, crit: true },
+    { id: 102, title: 'Scheduler ignores standing allocation slices', who: 'SM', state: 'scheduled', start: 23, end: 25, p80: 28, crit: true },
+    { id: 78, title: 'Calibration store cold-start distributions', who: 'SM', state: 'scheduled', start: 25, end: 30 },
+  ],
+}
+
+// ---- Dependencies ----
+
+export interface DepNode {
+  id: number
+  title: string
+  tags: string[]
+  state: 'done' | 'steeping' | 'review' | 'triage' | 'diagnosis'
+  days?: string
+  col: number
+  row: number
+  rationale?: string
+}
+
+export interface DepEdge {
+  from: number
+  to: number | 'ms'
+  crit?: boolean
+}
+
+export interface DepsData {
+  nodes: DepNode[]
+  milestone: { name: string; due: string; col: number; row: number }
+  edges: DepEdge[]
+  critical: number[]
+  unattached: number[]
+}
+
+export const DEPS: DepsData = {
+  nodes: [
+    { id: 71, title: 'Gitea client: token auth + retries', tags: ['est/2d'], state: 'done', col: 0, row: 0.2 },
+    { id: 69, title: 'pm-state repo bootstrap', tags: ['est/1d'], state: 'done', col: 0, row: 1.9 },
+    {
+      id: 87,
+      title: 'Fix lifecycle inference on merge events',
+      tags: ['est/2d', 'p/1'],
+      state: 'steeping',
+      days: '4d',
+      col: 1,
+      row: 0.7,
+      rationale: 'It blocks #91 and #92. I’d take it first — the critical path agrees with me.',
+    },
+    { id: 99, title: 'Directive log: conflict-free merge test', tags: ['est/1d', 'p/2'], state: 'triage', col: 1, row: 1.9 },
+    { id: 91, title: 'Webhook listener: reconcile on reconnect', tags: ['est/3d', 'p/2'], state: 'triage', col: 2, row: 0 },
+    { id: 92, title: 'Monte Carlo engine: percentile bands', tags: ['est/5d', 'p/1'], state: 'review', col: 2, row: 1.4 },
+    { id: 84, title: 'Capacity model: focus factor per person', tags: ['est/3d', 'p/2'], state: 'steeping', days: '1d', col: 3, row: 1.4 },
+    { id: 102, title: 'Scheduler ignores standing allocation slices', tags: ['p/2'], state: 'diagnosis', col: 4, row: 1.4 },
+  ],
+  milestone: { name: 'Beta', due: 'Mar 15', col: 5, row: 1.4 },
+  edges: [
+    { from: 71, to: 87 },
+    { from: 69, to: 99 },
+    { from: 87, to: 91 },
+    { from: 87, to: 92, crit: true },
+    { from: 92, to: 84, crit: true },
+    { from: 84, to: 102, crit: true },
+    { from: 102, to: 'ms', crit: true },
+  ],
+  critical: [87, 92, 84, 102],
+  unattached: [78, 96, 103, 65],
+}
+
+// ---- Runway ----
+
+export interface RunwayMilestone {
+  name: string
+  due: string
+  hard: boolean
+  p80: string
+  pos: number
+  spread: number
+  tone: 'ok' | 'warn'
+  note: string
+  /** gitea milestone id, for the drill-in (absent on the demo fixture). */
+  id?: number
+}
+
+export const RUNWAY: RunwayMilestone[] = [
+  { name: 'Beta', due: 'Mar 15', hard: false, p80: 'Mar 3–12', pos: 0.62, spread: 0.18, tone: 'ok', note: 'ahead' },
+  { name: 'Pilot-ready', due: 'Apr 30', hard: true, p80: 'Apr 21 – May 9', pos: 0.94, spread: 0.26, tone: 'warn', note: 'drifting' },
+  { name: 'v1.0', due: 'Jun 12', hard: false, p80: 'May 30 – Jun 20', pos: 0.88, spread: 0.3, tone: 'ok', note: 'on watch' },
+]
+
+export interface CapacityMember {
+  who: string
+  hours: string
+  focus: number
+  slices: string
+}
+
+export const CAPACITY: CapacityMember[] = [
+  { who: 'Stephen', hours: '5.2h/day', focus: 0.65, slices: 'dev 70% · pilots 20% · compliance 10%' },
+  { who: 'Ana K.', hours: '3.8h/day', focus: 0.8, slices: 'dev 100%' },
+]
+
+// ---- Calibration ----
+
+export interface CalLabel {
+  label: string
+  n: number
+  median: string
+  bias: number | null
+}
+
+export interface CalPerson {
+  who: string
+  n: number
+  bias: number
+  note: string
+}
+
+export interface CalibrationData {
+  n: number
+  active: boolean
+  labels: CalLabel[]
+  people: CalPerson[]
+  scatter: number[][]
+  fit: number
+  effect: { raw: string; banded: string; p50: string }
+  /** Closed+estimated issues that can't calibrate (same-day / 0-day closes). */
+  excludedSameDay: number
+}
+
+export const CALIBRATION: CalibrationData = {
+  n: 27,
+  active: true,
+  excludedSameDay: 0,
+  labels: [
+    { label: 'est/1d', n: 8, median: '1.1d', bias: 8 },
+    { label: 'est/2d', n: 9, median: '2.4d', bias: 18 },
+    { label: 'est/3d', n: 6, median: '3.7d', bias: 22 },
+    { label: 'est/5d', n: 3, median: '6.5d', bias: 30 },
+    { label: 'est/8d', n: 1, median: '8.5d', bias: null },
+  ],
+  people: [
+    { who: 'Stephen', n: 19, bias: 21, note: 'optimism grows with ticket size' },
+    { who: 'Ana K.', n: 8, bias: 9, note: 'close to honest — suspicious' },
+  ],
+  scatter: [
+    [1, 1], [1, 1.2], [1, 0.9], [1, 1.5], [1, 1.1], [1, 0.8], [1, 1.3], [1, 1.2],
+    [2, 2], [2, 2.5], [2, 3.1], [2, 2.2], [2, 2.6], [2, 1.8], [2, 2.4], [2, 2.9], [2, 2.3],
+    [3, 3.5], [3, 4.1], [3, 3.1], [3, 4.6], [3, 3.6], [3, 3.9],
+    [5, 6.1], [5, 7.2], [5, 6.4],
+    [8, 8.5],
+  ],
+  fit: 1.18,
+  effect: { raw: '42d of estimates', banded: '80% band 46–53d', p50: '48d' },
+}
+
+// ---- Inbox ----
+
+export interface InboxIssueRef {
+  id: number
+  title: string
+  labels: string[]
+  days?: string
+}
+
+export interface InboxItem {
+  id: number
+  day: string
+  type: string
+  icon: string
+  tone: 'ok' | 'warn' | 'info' | 'neutral'
+  who?: string
+  text: string
+  detail: string
+  time: string
+  unread: boolean
+  to?: string
+  issue?: InboxIssueRef
+}
+
+export const INBOX: InboxItem[] = [
+  { id: 1, day: 'Today', type: 'drift', icon: 'chart-line', tone: 'warn', text: 'Beta’s 80% window moved', detail: 'Mar 3–12 → Mar 5–14 · directive #007', time: '09:14', unread: true, to: 'directives' },
+  { id: 2, day: 'Today', type: 'mention', icon: 'message-square', tone: 'info', who: 'Ana K.', text: 'mentioned you on #92', detail: '“percentile bands ready for a second pair of eyes”', time: '08:52', unread: true, issue: { id: 92, title: 'Monte Carlo engine: percentile bands', labels: ['est/5d', 'p/1'] } },
+  { id: 3, day: 'Today', type: 'nag', icon: 'clock', tone: 'warn', text: '#87 is steeping · 4d', detail: 'blocks #91 and #92 — worth a look before it stains', time: '07:00', unread: true, issue: { id: 87, title: 'Fix lifecycle inference on merge events', labels: ['est/2d', 'p/1'], days: '4d' } },
+  { id: 4, day: 'Yesterday', type: 'review', icon: 'git-pull-request', tone: 'info', text: 'PR #141 awaits review', detail: '#92 · idle two days', time: '16:20', unread: false, issue: { id: 92, title: 'Monte Carlo engine: percentile bands', labels: ['est/5d', 'p/1'] } },
+  { id: 5, day: 'Yesterday', type: 'assignment', icon: 'user', tone: 'neutral', who: 'Ana K.', text: 'took #96 from the pot', detail: 'Label schema bootstrap for new repos', time: '11:03', unread: false, issue: { id: 96, title: 'Label schema bootstrap for new repos', labels: ['est/2d', 'p/3'] } },
+  { id: 6, day: 'Yesterday', type: 'system', icon: 'refresh-cw', tone: 'ok', text: 'Webhook outage 02:14–02:31', detail: 'full reconcile ran · nothing lost', time: '02:31', unread: false },
+  { id: 7, day: 'Yesterday', type: 'milestone', icon: 'milestone', tone: 'ok', text: 'P2 — Scheduler closed two days early', detail: 'the calibration noticed. So did I.', time: '09:40', unread: false },
+]
+
+// ---- Issue detail ----
+
+export interface IssueComment {
+  who: string
+  when: string
+  text: string
+}
+
+export interface IssueLifecycleStage {
+  stage: string
+  event: string
+  when: string
+  icon: string
+  done: boolean
+}
+
+export interface IssueDetail {
+  state: string
+  assignee: string
+  milestone: string
+  body: string
+  comments: IssueComment[]
+  lifecycle: IssueLifecycleStage[]
+  forecast: { p80: string; note: string }
+  blocks: number[]
+  blockedBy: number[]
+  note: string
+}
+
+export const ISSUE_DETAIL: Record<number, IssueDetail> = {
+  87: {
+    state: 'steeping',
+    assignee: 'Stephen',
+    milestone: 'Beta',
+    body: 'Squash-merges emit events out of order when CI runs long: the PR-closed webhook lands before the merge event, so lifecycle inference marks deploy before work-end and the actuals go negative. Regular merges infer correctly.',
+    comments: [
+      { who: 'Ana K.', when: 'Feb 8 · 14:12', text: 'Repro: squash-merge only. Regular merges infer fine.' },
+      { who: 'Stephen', when: 'Feb 9 · 09:30', text: 'Confirmed — the event order flips whenever CI takes more than ~5 minutes.' },
+    ],
+    lifecycle: [
+      { stage: 'Diagnosis', event: 'issue opened', when: 'Feb 2 · 09:14', icon: 'circle-dot', done: true },
+      { stage: 'Triage', event: 'labeled est/2d · milestoned Beta', when: 'Feb 3 · 10:02', icon: 'tag', done: true },
+      { stage: 'Work start', event: 'first commit ref a41f09', when: 'Feb 6 · 11:47', icon: 'git-commit-horizontal', done: true },
+      { stage: 'Deploy', event: 'PR merged', when: 'pending', icon: 'git-merge', done: false },
+      { stage: 'Complete', event: 'issue closed', when: 'pending', icon: 'circle-check', done: false },
+    ],
+    forecast: { p80: 'done Feb 11–13', note: 'from your est/2d history · n=14' },
+    blocks: [91, 92],
+    blockedBy: [],
+    note: 'It blocks #91 and #92. I’d take it first — the critical path agrees with me.',
+  },
+}
+
+// ---- Directives ----
+
+export interface DirectiveDiffRow {
+  tone: 'ok' | 'warn' | 'info' | 'danger'
+  change: string
+  from: string
+  to: string
+}
+
+export interface DirectivePending {
+  seq: number
+  who: string
+  when: string
+  what: string
+  diff: DirectiveDiffRow[]
+}
+
+export interface DirectiveEntry {
+  seq: number
+  who: string
+  when: string
+  what: string
+  why: string
+  status: string
+  consequence: string
+}
+
+export interface DirectivesData {
+  pending: DirectivePending | null
+  entries: DirectiveEntry[]
+}
+
+export const DIRECTIVES: DirectivesData = {
+  pending: {
+    seq: 7,
+    who: 'Stephen',
+    when: 'today 09:12',
+    what: 'Pilots before calibration — push #78 to next week.',
+    diff: [
+      { tone: 'info', change: '#78 Calibration store', from: 'this week', to: 'wk of Feb 23' },
+      { tone: 'warn', change: 'Beta · 80% window', from: 'Mar 3–12', to: 'Mar 5–14' },
+      { tone: 'ok', change: "Today's plan", from: '#87', to: '#87 · unchanged' },
+    ],
+  },
+  entries: [
+    { seq: 6, who: 'Stephen', when: 'Feb 8 · 16:40', what: 'Ana takes nothing new until #84 lands.', why: 'context thrash', status: 'applied', consequence: 'WIP capped · v1.0 unmoved' },
+    { seq: 5, who: 'Stephen', when: 'Feb 6 · 09:03', what: 'Ship Beta a week early.', why: 'board meeting', status: 'withdrawn', consequence: '80% would need scope −9d — withdrawn after diff' },
+    { seq: 4, who: 'Stephen', when: 'Feb 3 · 11:21', what: 'deadline/hard on Pilot-ready.', why: 'contract date', status: 'applied', consequence: 'label applied · runway flag raised' },
+    { seq: 3, who: 'Stephen', when: 'Jan 28 · 08:47', what: 'Webhook work ahead of UI polish.', why: '', status: 'applied', consequence: '#91 +2 ranks · Beta unmoved' },
+    { seq: 2, who: 'Stephen', when: 'Jan 20 · 14:02', what: 'Estimates in days, never hours.', why: 'sanity', status: 'applied', consequence: 'label schema est/* confirmed' },
+    { seq: 1, who: 'Stephen', when: 'Jan 19 · 09:00', what: 'CommiTea manages its own backlog.', why: 'dogfood', status: 'applied', consequence: 'stephen/commitea under management' },
+  ],
+}

apps/desktop/src/renderer/src/global.d.ts

@@ -0,0 +1,132 @@
+import type {
+  AgentStep,
+  CapacityMember,
+  ChangeProposal,
+  ChatMessage,
+  CaptureProposal,
+  DependencyEdge,
+  DirectiveRecord,
+  GiteaIssue,
+  GiteaMilestone,
+  IssueChange,
+  LabelPlan,
+  LifecycleEvent,
+  ProposedIssue,
+} from '@commitea/core'
+
+/** The result of a write through the bridge. */
+export type ApplyChangeResult =
+  | { ok: false; reason: 'unconfigured' }
+  // `plan` is present for label swaps (est/p); absent for field writes (assign, milestone).
+  | { ok: true; plan?: LabelPlan; issue: GiteaIssue }
+
+/** The result of filing captured issues. */
+export type CreateIssuesResult =
+  | { ok: false; reason: 'unconfigured' }
+  | { ok: true; created: { number: number; title: string }[] }
+
+/** The result of a capture_work decomposition. */
+export type CaptureResult =
+  | { ok: false; reason: 'unconfigured' | 'error'; message?: string }
+  | ({ ok: true } & CaptureProposal)
+
+/** A reconciled snapshot as it crosses the bridge. */
+export interface SnapshotPayload {
+  configured: boolean
+  issues: GiteaIssue[]
+  milestones: GiteaMilestone[]
+  deps: DependencyEdge[]
+  /** Normalized lifecycle events keyed by issue number. */
+  timelines: Record<number, LifecycleEvent[]>
+  /** true when served from the persisted cache (offline / instant boot). */
+  stale?: boolean
+  /** ISO time the persisted snapshot was reconciled (present on cached reads). */
+  savedAt?: string
+}
+
+/** Boot payload — the persisted snapshot, or a marker that there's none yet. */
+export type BootPayload =
+  | { configured: false }
+  | { configured: true; cached: false }
+  | ({ configured: true; cached: true } & Omit<SnapshotPayload, 'configured'>)
+
+/** The saved connection config (never includes the token). */
+export interface PublicConfig {
+  baseUrl: string
+  owner: string
+  repo: string
+  pmStateRepo?: string
+  modelUrl?: string
+  hasToken: boolean
+}
+
+/** What the onboarding/settings form submits. */
+export interface ConfigInput {
+  baseUrl: string
+  owner: string
+  repo: string
+  token: string
+  pmStateRepo?: string
+  modelUrl?: string
+}
+
+/** The config bridge for team onboarding. */
+export interface ConfigBridge {
+  get(): Promise<PublicConfig | null>
+  test(cfg: ConfigInput): Promise<{ ok: boolean; error?: string }>
+  set(cfg: ConfigInput): Promise<{ ok: boolean }>
+  clear(): Promise<{ ok: boolean }>
+}
+
+/** The gitea bridge exposed by the preload over IPC (main-process backed). */
+export interface GiteaBridge {
+  status(): Promise<{ configured: boolean; repo: string | null; demo: boolean }>
+  boot(): Promise<BootPayload>
+  reconcile(): Promise<SnapshotPayload>
+  getIssue(index: number): Promise<GiteaIssue | null>
+  applyChange(change: IssueChange): Promise<ApplyChangeResult>
+  createIssues(issues: ProposedIssue[]): Promise<CreateIssuesResult>
+  collaborators(): Promise<{ login: string; name: string }[]>
+}
+
+/** One agent turn's result. */
+export type ChatResult =
+  | { ok: false; reason: 'unconfigured' | 'error'; message?: string }
+  | { ok: true; content: string; steps: AgentStep[]; proposals: ChangeProposal[] }
+
+/** The model bridge (Reginald) exposed by the preload over IPC. */
+export interface ModelBridge {
+  status(): Promise<{ configured: boolean; model: string | null }>
+  chat(messages: ChatMessage[]): Promise<ChatResult>
+  capture(braindump: string): Promise<CaptureResult>
+  /** Subscribe to streamed prose tokens; returns an unsubscribe fn. */
+  onToken(cb: (delta: string) => void): () => void
+}
+
+/** The result of reading the directive ledger. */
+export type DirectivesResult =
+  | { ok: false; reason: 'unconfigured' | 'error'; message?: string }
+  | { ok: true; directives: DirectiveRecord[] }
+
+/** The result of reading the capacity config. */
+export type CapacityResult =
+  | { ok: false; reason: 'unconfigured'; members: CapacityMember[] }
+  | { ok: true; members: CapacityMember[] }
+
+/** The pm-state bridge (machine-derived state) exposed by the preload over IPC. */
+export interface PmStateBridge {
+  directives(): Promise<DirectivesResult>
+  capacity(): Promise<CapacityResult>
+}
+
+declare global {
+  interface Window {
+    commitea: {
+      platform: string
+      gitea: GiteaBridge
+      model: ModelBridge
+      pmstate: PmStateBridge
+      config: ConfigBridge
+    }
+  }
+}

apps/desktop/src/renderer/src/lib/backlog.ts

@@ -0,0 +1,392 @@
+import {
+  type CalibrationCoverage,
+  type CalibrationModel,
+  type CalibrationSample,
+  calibrationCoverage,
+  calibrationSamples,
+  type CapacityMember,
+  capacityPerWorkday,
+  COLD_START_THRESHOLD,
+  type DependencyEdge,
+  fitCalibration,
+  forecast,
+  type Worker,
+  type GiteaIssue,
+  type GiteaMilestone,
+  inferLifecycle,
+  type LifecycleColumn,
+  type LifecycleEvent,
+  type LifecycleInference,
+  PRIOR_BUCKETS,
+  schedule,
+  type ScheduledItem,
+  selectFocus,
+  toDurationModel,
+  workingDaysBetween,
+} from '@commitea/core'
+
+import {
+  type BoardColumn,
+  type BoardIssue,
+  type CalibrationData,
+  type FocusIssue,
+  type RunwayMilestone,
+} from '../data/fixtures.js'
+import { addWorkingDays, type BurnUpData, buildBurnUpData, formatRange, formatShort } from './dates.js'
+
+type Timelines = Record<number, LifecycleEvent[]>
+
+/** Infer every issue's lifecycle once; callers index by issue number. */
+function inferAll(issues: GiteaIssue[], timelines: Timelines, asOf: Date): Map<number, LifecycleInference> {
+  return new Map(issues.map((i) => [i.number, inferLifecycle(i, timelines[i.number] ?? [], asOf)]))
+}
+
+const COLUMN_LABELS: Record<LifecycleColumn, string> = {
+  diagnosis: 'Diagnosis',
+  triage: 'Triage',
+  steeping: 'Steeping',
+  review: 'In review',
+  done: 'Done',
+}
+
+const COLUMN_ORDER: LifecycleColumn[] = ['diagnosis', 'triage', 'steeping', 'review', 'done']
+
+function initials(login: string): string {
+  return login.slice(0, 2).toUpperCase()
+}
+
+/**
+ * Shape real gitea issues into the Board's five columns via lifecycle inference
+ * (#5). Steeping / In-review are now populated from the event stream (first
+ * commit ref → steeping, first PR ref → review); the `days` badge is the
+ * steeping age in working days.
+ */
+export function issuesToBoardColumns(
+  issues: GiteaIssue[],
+  timelines: Timelines = {},
+  asOf: Date = new Date(),
+): BoardColumn[] {
+  const inf = inferAll(issues, timelines, asOf)
+  return COLUMN_ORDER.map((key) => ({
+    id: key,
+    label: COLUMN_LABELS[key],
+    issues: issues
+      .filter((i) => inf.get(i.number)!.column === key)
+      .map((i): BoardIssue => {
+        const li = inf.get(i.number)!
+        return {
+          id: i.number,
+          title: i.title,
+          labels: i.labels,
+          who: i.assignee ? initials(i.assignee) : '·',
+          days: li.steepingDays != null ? `${li.steepingDays}d` : undefined,
+        }
+      }),
+  }))
+}
+
+export interface FocusView {
+  now: FocusIssue | null
+  next: FocusIssue | null
+  later: FocusIssue | null
+}
+
+function toFocusIssue(item: ScheduledItem | null, inf?: Map<number, LifecycleInference>): FocusIssue | null {
+  if (!item) return null
+  const steepingDays = inf?.get(item.number)?.steepingDays ?? null
+  return {
+    id: item.number,
+    title: item.title,
+    labels: item.labels,
+    rationale: item.rationale,
+    steeping: steepingDays != null ? `${steepingDays}d` : undefined,
+  }
+}
+
+function toSchedulable(issues: GiteaIssue[]) {
+  return issues
+    .filter((i) => i.state === 'open')
+    .map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+      assignee: i.assignee,
+    }))
+}
+
+/** gitea CapacityMembers → scheduler lanes (person + throughput). */
+export function capacityWorkers(members: CapacityMember[]): Worker[] {
+  return members.map((m) => ({ person: m.person, speed: capacityPerWorkday(m) }))
+}
+
+export interface ForecastView {
+  scope: number
+  cone: BurnUpData
+  p80Label: string
+  rangeLabel: string
+  /** true while the forecast still runs on code priors (calibration not yet trusted). */
+  coldStart: boolean
+  /** Closed-with-estimate issues feeding calibration so far. */
+  calibratedN: number
+}
+
+/**
+ * Monte Carlo forecast over the open backlog, mapped onto a calendar-anchored
+ * burn-up cone. When a calibration model is supplied and past cold-start, its
+ * fitted params drive the sim. Returns null when there's nothing to forecast.
+ * `today` is injectable for tests.
+ */
+export function forecastBacklog(
+  issues: GiteaIssue[],
+  deps: DependencyEdge[],
+  today: Date = new Date(),
+  calibration?: CalibrationModel,
+  workers: Worker[] = [],
+): ForecastView | null {
+  const model = calibration ? toDurationModel(calibration) : undefined
+  const f = forecast(toSchedulable(issues), deps, { ...(model ? { model } : {}), workers })
+  const cone = buildBurnUpData(f, today)
+  if (!cone) return null
+  return {
+    scope: f.scope,
+    cone,
+    p80Label: cone.p80Label,
+    rangeLabel: cone.rangeLabel,
+    coldStart: f.coldStart,
+    calibratedN: calibration?.n ?? 0,
+  }
+}
+
+/** Fit the calibration model from the closed backlog's inferred actuals (#1). */
+export function calibrateBacklog(
+  issues: GiteaIssue[],
+  timelines: Timelines = {},
+  asOf: Date = new Date(),
+): CalibrationModel {
+  return fitCalibration(calibrationSamples(issues, timelines, asOf))
+}
+
+/** Calibration model + its screen view in one pass over the closed backlog. */
+export function backlogCalibration(
+  issues: GiteaIssue[],
+  timelines: Timelines = {},
+  asOf: Date = new Date(),
+): { model: CalibrationModel; data: CalibrationData; coverage: CalibrationCoverage } {
+  const samples = calibrationSamples(issues, timelines, asOf)
+  const model = fitCalibration(samples)
+  const coverage = calibrationCoverage(issues, timelines, asOf)
+  return { model, coverage, data: calibrationData(model, samples, issues, coverage.excludedSameDay) }
+}
+
+const pctFromMu = (mu: number) => Math.round((Math.exp(mu) - 1) * 100)
+
+/**
+ * Shape the calibration model + its samples into the screen's view. Buckets and
+ * people only earn a bias once their sample clears the fit floor; everything
+ * degrades honestly on a thin (cold-start) dataset.
+ */
+export function calibrationData(
+  model: CalibrationModel,
+  samples: CalibrationSample[],
+  openIssues: GiteaIssue[],
+  excludedSameDay = 0,
+): CalibrationData {
+  const labels = PRIOR_BUCKETS.map((b) => {
+    const inBucket = samples.filter((s) => s.bucket === b)
+    const fit = model.byBucket[b]
+    const mu = fit ? fit.mu : model.global.mu
+    return {
+      label: `est/${b}d`,
+      n: fit ? fit.n : inBucket.length,
+      median: inBucket.length ? `${(b * Math.exp(mu)).toFixed(1)}d` : '—',
+      bias: fit ? pctFromMu(fit.mu) : null,
+    }
+  })
+
+  const people = Object.entries(model.byPerson).map(([who, pb]) => ({
+    who,
+    n: pb.n,
+    bias: pctFromMu(model.global.mu + pb.biasMu),
+    note: '',
+  }))
+
+  const openEst = openIssues
+    .filter((i) => i.state === 'open')
+    .reduce((sum, i) => sum + (i.facts.estimateDays ?? 2), 0)
+  const effect = model.coldStart
+    ? { raw: `${model.n}/${COLD_START_THRESHOLD} estimated closes`, banded: 'cold-start priors', p50: '—' }
+    : {
+        raw: `${openEst}d estimated`,
+        banded: `×${Math.exp(model.global.mu).toFixed(2)} median drift`,
+        p50: `≈${Math.round(openEst * Math.exp(model.global.mu))}d`,
+      }
+
+  return {
+    n: model.n,
+    active: !model.coldStart,
+    labels,
+    people,
+    scatter: samples.map((s) => [s.estimateDays, s.actualWorkingDays]),
+    fit: Number(Math.exp(model.global.mu).toFixed(2)),
+    effect,
+    excludedSameDay,
+  }
+}
+
+/**
+ * Run the deterministic scheduler over the open backlog and take the top three
+ * as Now/Next/Later. Estimates + priority come from label facts; dependency
+ * edges come from gitea's native issue dependencies.
+ */
+export function scheduleFocus(
+  issues: GiteaIssue[],
+  deps: DependencyEdge[],
+  timelines: Timelines = {},
+  asOf: Date = new Date(),
+): FocusView {
+  const plan = schedule(toSchedulable(issues), deps)
+  const f = selectFocus(plan)
+  const inf = inferAll(issues, timelines, asOf)
+  return {
+    now: toFocusIssue(f.now, inf),
+    next: toFocusIssue(f.next, inf),
+    later: toFocusIssue(f.later, inf),
+  }
+}
+
+/**
+ * Per-milestone Monte Carlo forecast for the Runway screen — each open milestone's
+ * open scope gets its own cone, and the p80 landing is compared to the milestone's
+ * due date (ok/at-risk). Ranges, never point dates. Milestones with no open scope
+ * (already shipped) are omitted. Falls back to the demo when there's nothing real.
+ */
+export function runwayView(
+  issues: GiteaIssue[],
+  milestones: GiteaMilestone[],
+  deps: DependencyEdge[],
+  today: Date = new Date(),
+  workers: Worker[] = [],
+): RunwayMilestone[] {
+  const open = issues.filter((i) => i.state === 'open')
+  const rows = milestones
+    .filter((m) => m.state === 'open')
+    .map((m) => ({ m, scope: open.filter((i) => i.milestone?.id === m.id) }))
+    .filter((x) => x.scope.length > 0)
+    .map(({ m, scope }) => {
+      const f = forecast(
+        scope.map((i) => ({
+          number: i.number,
+          title: i.title,
+          labels: i.labels,
+          estimateDays: i.facts.estimateDays,
+          priority: i.facts.priority,
+          assignee: i.assignee,
+        })),
+        deps,
+        { workers },
+      )
+      const p90 = f.curve.length ? f.curve[f.curve.length - 1].p90Day : f.p95Day
+      const dueDay = m.dueOn ? workingDaysBetween(today, new Date(m.dueOn)) : null
+      return { m, p50: f.p50Day, p80: f.p80Day, p90, dueDay }
+    })
+
+  const horizon = Math.max(1, ...rows.map((r) => Math.max(r.p90, r.dueDay ?? 0)))
+
+  return rows.map(({ m, p50, p80, p90, dueDay }) => {
+    const onTrack = dueDay == null || p80 <= dueDay
+    return {
+      id: m.id,
+      name: m.title,
+      due: m.dueOn ? formatShort(new Date(m.dueOn)) : 'no date',
+      hard: false,
+      p80: formatRange(addWorkingDays(today, p50), addWorkingDays(today, p90)),
+      pos: p80 / horizon,
+      spread: Math.min(0.6, (p90 - p50) / horizon),
+      tone: onTrack ? ('ok' as const) : ('warn' as const),
+      note: dueDay == null ? `${Math.ceil(p80)}d of work` : onTrack ? 'on track' : 'at risk',
+    }
+  })
+}
+
+export interface MilestoneGroup {
+  label: string
+  issues: { id: number; title: string; labels: string[]; days?: string }[]
+}
+
+export interface MilestoneView {
+  name: string
+  due: string
+  soft: boolean
+  scopeCount: number
+  scopeEstDays: number
+  doneCount: number
+  donePct: number
+  /** p50..p90 landing range for the remaining open scope; null when nothing's open. */
+  forecastRange: string | null
+  cone: BurnUpData | null
+  groups: MilestoneGroup[]
+}
+
+/**
+ * The Milestone drill-in: real scope, done %, a Monte Carlo cone over the
+ * milestone's remaining open work, and its issues grouped by lifecycle column.
+ * Returns null for an unknown id — the screen then shows the demo fixture.
+ */
+export function milestoneView(
+  id: number,
+  issues: GiteaIssue[],
+  milestones: GiteaMilestone[],
+  deps: DependencyEdge[],
+  timelines: Timelines = {},
+  calibration?: CalibrationModel,
+  today: Date = new Date(),
+  workers: Worker[] = [],
+): MilestoneView | null {
+  const m = milestones.find((x) => x.id === id)
+  if (!m) return null
+  const all = issues.filter((i) => i.milestone?.id === id)
+  const open = all.filter((i) => i.state === 'open')
+  const done = all.filter((i) => i.state === 'closed')
+  const scopeEstDays = all.reduce((sum, i) => sum + (i.facts.estimateDays ?? 2), 0)
+
+  const model = calibration ? toDurationModel(calibration) : undefined
+  const f = forecast(
+    open.map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+      assignee: i.assignee,
+    })),
+    deps,
+    { ...(model ? { model } : {}), workers },
+  )
+  const cone = buildBurnUpData(f, today)
+
+  const inf = inferAll(all, timelines, today)
+  const groups: MilestoneGroup[] = COLUMN_ORDER.map((key) => ({
+    label: COLUMN_LABELS[key],
+    issues: all
+      .filter((i) => inf.get(i.number)!.column === key)
+      .map((i) => {
+        const days = inf.get(i.number)!.steepingDays
+        return { id: i.number, title: i.title, labels: i.labels, days: days != null ? `${days}d` : undefined }
+      }),
+  })).filter((g) => g.issues.length > 0)
+
+  return {
+    name: m.title,
+    due: m.dueOn ? formatShort(new Date(m.dueOn)) : 'no date',
+    soft: true,
+    scopeCount: all.length,
+    scopeEstDays,
+    doneCount: done.length,
+    donePct: all.length ? Math.round((done.length / all.length) * 100) : 0,
+    forecastRange: cone ? cone.rangeLabel : null,
+    cone,
+    groups,
+  }
+}

apps/desktop/src/renderer/src/lib/dates.ts

@@ -0,0 +1,70 @@
+import type { Forecast } from '@commitea/core'
+
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
+
+/** Advance `base` by whole working days (skipping Sat/Sun). Fractions round to nearest day. */
+export function addWorkingDays(base: Date, workingDays: number): Date {
+  const d = new Date(base.getFullYear(), base.getMonth(), base.getDate())
+  let remaining = Math.max(0, Math.round(workingDays))
+  while (remaining > 0) {
+    d.setDate(d.getDate() + 1)
+    const day = d.getDay()
+    if (day !== 0 && day !== 6) remaining -= 1
+  }
+  return d
+}
+
+/** "Mar 6" */
+export function formatShort(d: Date): string {
+  return `${MONTHS[d.getMonth()]} ${d.getDate()}`
+}
+
+/** "Feb 24 – Mar 6" (collapses the month when both ends share it → "Mar 3–12"). */
+export function formatRange(lo: Date, hi: Date): string {
+  if (lo.getMonth() === hi.getMonth()) return `${MONTHS[lo.getMonth()]} ${lo.getDate()}–${hi.getDate()}`
+  return `${formatShort(lo)} – ${formatShort(hi)}`
+}
+
+export interface BurnUpBandPoint {
+  fraction: number
+  loDay: number
+  midDay: number
+  hiDay: number
+}
+
+/** Chart-ready geometry + calendar labels derived from a Monte Carlo forecast. */
+export interface BurnUpData {
+  scope: number
+  horizonDays: number
+  band: BurnUpBandPoint[]
+  p80Day: number
+  p80Label: string
+  rangeLabel: string
+  startLabel: string
+  endLabel: string
+}
+
+/**
+ * Map a working-day forecast onto a calendar-anchored burn-up cone. `today`
+ * anchors day 0; the cone emanates from (today, 0) and widens to the right.
+ * The historical "actual" polyline behind today awaits lifecycle events (#5).
+ */
+export function buildBurnUpData(f: Forecast, today: Date): BurnUpData | null {
+  if (f.scope === 0 || f.curve.length === 0) return null
+  const last = f.curve[f.curve.length - 1]
+  const horizonDays = Math.max(1, Math.ceil(last.p90Day * 1.05))
+  const band: BurnUpBandPoint[] = [
+    { fraction: 0, loDay: 0, midDay: 0, hiDay: 0 },
+    ...f.curve.map((p) => ({ fraction: p.fraction, loDay: p.p10Day, midDay: p.p50Day, hiDay: p.p90Day })),
+  ]
+  return {
+    scope: f.scope,
+    horizonDays,
+    band,
+    p80Day: f.p80Day,
+    p80Label: formatShort(addWorkingDays(today, f.p80Day)),
+    rangeLabel: formatRange(addWorkingDays(today, f.p50Day), addWorkingDays(today, last.p90Day)),
+    startLabel: formatShort(today),
+    endLabel: formatShort(addWorkingDays(today, horizonDays)),
+  }
+}

apps/desktop/src/renderer/src/lib/use-backlog.ts

@@ -0,0 +1,91 @@
+import { useCallback, useEffect, useState } from 'react'
+
+import type { DependencyEdge, GiteaIssue, GiteaMilestone, LifecycleEvent } from '@commitea/core'
+
+export type BacklogState =
+  | { status: 'loading' }
+  | { status: 'unconfigured' }
+  | { status: 'error'; message: string }
+  | {
+      status: 'ready'
+      issues: GiteaIssue[]
+      milestones: GiteaMilestone[]
+      deps: DependencyEdge[]
+      timelines: Record<number, LifecycleEvent[]>
+      /** true while showing the persisted snapshot (instant boot / offline). */
+      stale: boolean
+      /** ISO time the shown snapshot was reconciled, when stale. */
+      savedAt?: string
+    }
+
+/**
+ * Reconcile the managed repo through the main-process bridge, stale-while-
+ * revalidate: on mount it shows the persisted snapshot instantly (marked stale),
+ * then a fresh reconcile supersedes it. If gitea is unreachable, the fresh
+ * reconcile falls back to the persisted snapshot (offline). `refetch` re-syncs
+ * after a write. `unconfigured` means no token — the UI uses demo fixtures.
+ */
+export function useBacklog(): [BacklogState, () => void] {
+  const [state, setState] = useState<BacklogState>({ status: 'loading' })
+  const [nonce, setNonce] = useState(0)
+  const refetch = useCallback(() => setNonce((n) => n + 1), [])
+
+  useEffect(() => {
+    let alive = true
+
+    // instant boot from the persisted snapshot (only on first mount, not refetch)
+    if (nonce === 0) {
+      window.commitea.gitea
+        .boot()
+        .then((b) => {
+          if (!alive || !('cached' in b) || !b.cached) return
+          setState((prev) =>
+            prev.status === 'ready' && !prev.stale
+              ? prev // a fresh reconcile already won the race
+              : {
+                  status: 'ready',
+                  issues: b.issues,
+                  milestones: b.milestones,
+                  deps: b.deps,
+                  timelines: b.timelines,
+                  stale: true,
+                  savedAt: b.savedAt,
+                },
+          )
+        })
+        .catch(() => {})
+    }
+
+    window.commitea.gitea
+      .reconcile()
+      .then((r) => {
+        if (!alive) return
+        setState(
+          r.configured
+            ? {
+                status: 'ready',
+                issues: r.issues,
+                milestones: r.milestones,
+                deps: r.deps,
+                timelines: r.timelines,
+                stale: r.stale ?? false,
+                savedAt: r.savedAt,
+              }
+            : { status: 'unconfigured' },
+        )
+      })
+      .catch((e: unknown) => {
+        if (alive) {
+          // keep a shown boot snapshot rather than clobbering it with an error
+          setState((prev) =>
+            prev.status === 'ready' ? prev : { status: 'error', message: e instanceof Error ? e.message : String(e) },
+          )
+        }
+      })
+    return () => {
+      alive = false
+    }
+  }, [nonce])
+
+  return [state, refetch]
+}

apps/desktop/src/renderer/src/lib/use-capacity.ts

@@ -0,0 +1,24 @@
+import { useEffect, useState } from 'react'
+
+import type { CapacityMember } from '@commitea/core'
+
+/**
+ * The team's capacity config from the pm-state repo. Empty when unconfigured —
+ * forecasts then fall back to a single serial worker. Read once on mount.
+ */
+export function useCapacity(): CapacityMember[] {
+  const [members, setMembers] = useState<CapacityMember[]>([])
+  useEffect(() => {
+    let alive = true
+    window.commitea.pmstate
+      .capacity()
+      .then((r) => {
+        if (alive) setMembers(r.members)
+      })
+      .catch(() => {})
+    return () => {
+      alive = false
+    }
+  }, [])
+  return members
+}

apps/desktop/src/renderer/src/lib/use-chat.ts

@@ -0,0 +1,157 @@
+import { useCallback, useEffect, useRef, useState } from 'react'
+
+import type { ChangeProposal, ChatMessage as WireMessage, IssueChange } from '@commitea/core'
+
+import { CHAT, type ChatMessage } from '../data/fixtures.js'
+
+const LIVE_GREETING: ChatMessage = {
+  from: 'agent',
+  text: 'Morning. Ask me anything about the project — I check the real board before I answer.',
+}
+
+const NO_MODEL: ChatMessage = {
+  from: 'agent',
+  text: "Reginald is off — I need a model. Add a Model URL in Settings and chat turns on.",
+}
+
+export interface ChatState {
+  msgs: ChatMessage[]
+  thinking: boolean
+  /** true once a model endpoint is confirmed; otherwise the panel echoes the demo reply. */
+  live: boolean
+  /** The loaded model's id when live (for the header). */
+  model: string | null
+  /** Tools Reginald consulted on the last turn (for a subtle activity line). */
+  steps: string[]
+  /** Changes Reginald has proposed and is awaiting approval on. */
+  proposals: ChangeProposal[]
+  /** The in-flight streamed prose (grows token-by-token) before the turn finalizes. */
+  streaming: string
+  send: (text: string) => void
+  approve: (p: ChangeProposal) => void
+  dismiss: (p: ChangeProposal) => void
+}
+
+/**
+ * Reginald's conversation. When a model is configured, `send` drives one agent
+ * turn through the main-process bridge (which runs the tool loop). Otherwise it
+ * echoes the scripted fixture reply, so the layout stays real with no model and
+ * fixture e2e is unaffected. The fixture greeting is display-only — only real
+ * turns (`convo`) are sent to the model as history. `onApplyChange` performs an
+ * approved write (the same handler the Issue screen uses — it refetches).
+ */
+export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: boolean }>): ChatState {
+  const [seed, setSeed] = useState<ChatMessage[]>(CHAT)
+  const [convo, setConvo] = useState<ChatMessage[]>([])
+  const [thinking, setThinking] = useState(false)
+  const [live, setLive] = useState(false)
+  const [model, setModel] = useState<string | null>(null)
+  const [steps, setSteps] = useState<string[]>([])
+  const [proposals, setProposals] = useState<ChangeProposal[]>([])
+  const [streaming, setStreaming] = useState('')
+  const convoRef = useRef(convo)
+  convoRef.current = convo
+
+  const proposalKey = (p: ChangeProposal) => `${p.change.issue}:${p.change.kind}`
+  const drop = (p: ChangeProposal) => setProposals((ps) => ps.filter((x) => proposalKey(x) !== proposalKey(p)))
+
+  useEffect(() => {
+    let alive = true
+    window.commitea.model
+      .status()
+      .then((s) => {
+        if (!alive) return
+        if (s.configured) {
+          setLive(true)
+          setModel(s.model)
+          setSeed([LIVE_GREETING])
+        } else {
+          // no model → clean "off" state, not a scripted fixture reply
+          setSeed([NO_MODEL])
+        }
+      })
+      .catch(() => {})
+    return () => {
+      alive = false
+    }
+  }, [])
+
+  const send = useCallback(
+    (raw: string) => {
+      const text = raw.trim()
+      if (!text) return
+      const nextConvo: ChatMessage[] = [...convoRef.current, { from: 'user', text }]
+      setConvo(nextConvo)
+      setThinking(true)
+      setSteps([])
+      setProposals([])
+
+      if (!live) {
+        // no model configured — nothing to send (composer is disabled anyway)
+        setThinking(false)
+        return
+      }
+
+      const wire: WireMessage[] = nextConvo.map((m) => ({
+        role: m.from === 'user' ? 'user' : 'assistant',
+        content: m.text,
+      }))
+      setStreaming('')
+      const unsubscribe = window.commitea.model.onToken((delta) => setStreaming((s) => s + delta))
+      const finish = () => {
+        unsubscribe()
+        setThinking(false)
+        setStreaming('')
+      }
+      window.commitea.model
+        .chat(wire)
+        .then((res) => {
+          finish()
+          if (res.ok) {
+            setSteps(res.steps.map((s) => s.tool))
+            setProposals(res.proposals)
+            setConvo((c) => [...c, { from: 'agent', text: res.content || '…' }])
+          } else {
+            setConvo((c) => [
+              ...c,
+              {
+                from: 'agent',
+                text: res.reason === 'error' ? `I hit a snag: ${res.message ?? 'unknown error'}` : 'No model is configured.',
+              },
+            ])
+          }
+        })
+        .catch(() => {
+          finish()
+          setConvo((c) => [...c, { from: 'agent', text: 'I could not reach the model.' }])
+        })
+    },
+    [live],
+  )
+
+  const approve = useCallback(
+    (p: ChangeProposal) => {
+      if (!onApplyChange) return
+      drop(p)
+      void onApplyChange(p.change).then((res) => {
+        setConvo((c) => [
+          ...c,
+          {
+            from: 'agent',
+            text: res.ok
+              ? `Done — #${p.change.issue}: ${p.summary}. The plan's been re-run.`
+              : `That didn't take — #${p.change.issue} is unchanged.`,
+          },
+        ])
+      })
+    },
+    [onApplyChange],
+  )
+
+  const dismiss = useCallback((p: ChangeProposal) => {
+    drop(p)
+    setConvo((c) => [...c, { from: 'agent', text: `Left #${p.change.issue} as it was.` }])
+  }, [])
+
+  return { msgs: [...seed, ...convo], thinking, live, model, steps, proposals, streaming, send, approve, dismiss }
+}

apps/desktop/src/renderer/src/lib/views/deps-graph.ts

@@ -0,0 +1,195 @@
+import { inferLifecycle, schedule } from '@commitea/core'
+
+import type { DepEdge, DepNode, DepsData } from '../../data/fixtures.js'
+import { formatShort } from '../dates.js'
+import type { ProjectData } from './project-data.js'
+
+/** Copy of backlog.ts's private toSchedulable — open issues → scheduler input. Not exported there. */
+function toSchedulable(issues: ProjectData['issues']) {
+  return issues
+    .filter((i) => i.state === 'open')
+    .map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+      assignee: i.assignee,
+    }))
+}
+
+function median(values: number[]): number {
+  if (values.length === 0) return 0
+  const sorted = [...values].sort((a, b) => a - b)
+  const mid = Math.floor(sorted.length / 2)
+  return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2
+}
+
+/**
+ * Real Deps-graph view: dependency topology of every issue that appears in a
+ * real gitea dependency edge, laid out into columns (longest dependency depth)
+ * and rows (index within its column, ordered by issue number). Critical path
+ * comes from the deterministic scheduler over the open backlog — closed issues
+ * never schedule, so they can't be critical, which is honest (they're done).
+ * The milestone node is the open milestone with the most open in-scope issues;
+ * when nothing links to a real milestone we fall back to the first open one,
+ * then to a bare '—' placeholder — never a fabricated name/date.
+ */
+export function depsGraphView(d: ProjectData): DepsData {
+  const byNumber = new Map(d.issues.map((i) => [i.number, i]))
+
+  // Participating set: anything that shows up as either end of a real edge,
+  // restricted to issues we actually have (dangling refs to unknown issues
+  // are dropped — nothing honest to draw for them).
+  const participating = new Set<number>()
+  for (const e of d.deps) {
+    if (byNumber.has(e.issue)) participating.add(e.issue)
+    if (byNumber.has(e.dependsOn)) participating.add(e.dependsOn)
+  }
+
+  if (participating.size === 0) {
+    const fallback = d.milestones.find((m) => m.state === 'open')
+    return {
+      nodes: [],
+      milestone: fallback
+        ? { name: fallback.title, due: fallback.dueOn ? formatShort(new Date(fallback.dueOn)) : 'no date', col: 0, row: 0 }
+        : { name: '—', due: 'no date', col: 0, row: 0 },
+      edges: [],
+      critical: [],
+      unattached: [],
+    }
+  }
+
+  // In-scope deps: both endpoints participating.
+  const depsMap = new Map<number, number[]>() // issue -> its dependencies
+  const dependentsMap = new Map<number, number[]>() // issue -> who depends on it
+  for (const id of participating) {
+    depsMap.set(id, [])
+    dependentsMap.set(id, [])
+  }
+  for (const e of d.deps) {
+    if (participating.has(e.issue) && participating.has(e.dependsOn)) {
+      depsMap.get(e.issue)!.push(e.dependsOn)
+      dependentsMap.get(e.dependsOn)!.push(e.issue)
+    }
+  }
+
+  // Column = longest dependency depth. Cycle-guarded (shouldn't happen — real
+  // gitea deps are DAG-shaped in practice — but recursion must not hang).
+  const colMemo = new Map<number, number>()
+  function colOf(id: number, visiting: Set<number>): number {
+    const cached = colMemo.get(id)
+    if (cached != null) return cached
+    if (visiting.has(id)) return 0 // cycle guard: treat as a root
+    visiting.add(id)
+    const deps = depsMap.get(id) ?? []
+    const col = deps.length === 0 ? 0 : 1 + Math.max(...deps.map((dep) => colOf(dep, visiting)))
+    visiting.delete(id)
+    colMemo.set(id, col)
+    return col
+  }
+  for (const id of participating) colOf(id, new Set())
+
+  // Row = index within column, ordered deterministically by issue number.
+  const byCol = new Map<number, number[]>()
+  for (const id of participating) {
+    const col = colMemo.get(id)!
+    if (!byCol.has(col)) byCol.set(col, [])
+    byCol.get(col)!.push(id)
+  }
+  const rowOf = new Map<number, number>()
+  for (const ids of byCol.values()) {
+    ids.sort((a, b) => a - b)
+    ids.forEach((id, i) => rowOf.set(id, i))
+  }
+
+  const maxCol = Math.max(...[...colMemo.values()])
+
+  // Critical path from the real scheduler over the open backlog.
+  const plan = schedule(toSchedulable(d.issues), d.deps)
+  const critical = new Set(plan.items.filter((i) => i.critical).map((i) => i.number))
+  const scheduledByNumber = new Map(plan.items.map((i) => [i.number, i]))
+
+  const nodes: DepNode[] = [...participating].sort((a, b) => a - b).map((id) => {
+    const issue = byNumber.get(id)!
+    const inf = inferLifecycle(issue, d.timelines[id] ?? [], d.today)
+    const scheduled = scheduledByNumber.get(id)
+    return {
+      id,
+      title: issue.title,
+      tags: issue.labels,
+      state: inf.column,
+      days: inf.steepingDays != null ? `${inf.steepingDays}d` : undefined,
+      col: colMemo.get(id)!,
+      row: rowOf.get(id)!,
+      // Reuse the scheduler's own rationale where one exists (open issues
+      // only) — never invented commentary for closed/unscheduled nodes.
+      rationale: scheduled?.rationale,
+    }
+  })
+
+  // Nearest open milestone with the most open in-scope issues.
+  const openMilestones = d.milestones.filter((m) => m.state === 'open')
+  let chosenMilestoneId: number | null = null
+  let milestone: DepsData['milestone']
+  const medianRow = median(nodes.map((n) => n.row))
+  if (openMilestones.length === 0) {
+    milestone = { name: '—', due: 'no date', col: maxCol + 1, row: medianRow }
+  } else {
+    let best: { id: number; title: string; dueOn: string | null | undefined; count: number } | null = null
+    for (const m of openMilestones) {
+      const count = [...participating].filter((id) => {
+        const issue = byNumber.get(id)!
+        return issue.milestone?.id === m.id && issue.state === 'open'
+      }).length
+      if (
+        best === null ||
+        count > best.count ||
+        (count === best.count && dueRank(m.dueOn) < dueRank(best.dueOn))
+      ) {
+        best = { id: m.id, title: m.title, dueOn: m.dueOn, count }
+      }
+    }
+    // best is non-null since openMilestones.length > 0
+    chosenMilestoneId = best!.count > 0 ? best!.id : null
+    milestone = {
+      name: best!.title,
+      due: best!.dueOn ? formatShort(new Date(best!.dueOn)) : 'no date',
+      col: maxCol + 1,
+      row: medianRow,
+    }
+  }
+
+  const edges: DepEdge[] = []
+  for (const e of d.deps) {
+    if (!participating.has(e.issue) || !participating.has(e.dependsOn)) continue
+    const crit = critical.has(e.dependsOn) && critical.has(e.issue)
+    edges.push(crit ? { from: e.dependsOn, to: e.issue, crit: true } : { from: e.dependsOn, to: e.issue })
+  }
+
+  // Terminal nodes (nothing in scope depends on them) that belong to the
+  // chosen milestone's scope get an edge into it.
+  if (chosenMilestoneId != null) {
+    for (const id of participating) {
+      const dependents = dependentsMap.get(id) ?? []
+      if (dependents.length > 0) continue
+      const issue = byNumber.get(id)!
+      if (issue.milestone?.id !== chosenMilestoneId) continue
+      edges.push(critical.has(id) ? { from: id, to: 'ms', crit: true } : { from: id, to: 'ms' })
+    }
+  }
+
+  const linked = new Set<number>()
+  for (const e of edges) {
+    linked.add(e.from)
+    if (e.to !== 'ms') linked.add(e.to)
+  }
+  const unattached = [...participating].filter((id) => !linked.has(id)).sort((a, b) => a - b)
+
+  return { nodes, milestone, edges, critical: [...critical], unattached }
+}
+
+/** Rank a due date for "nearest" comparisons; undated milestones sort last. */
+function dueRank(dueOn: string | null | undefined): number {
+  return dueOn ? new Date(dueOn).getTime() : Number.POSITIVE_INFINITY
+}

apps/desktop/src/renderer/src/lib/views/gantt-view.ts

@@ -0,0 +1,130 @@
+import { forecast, inferLifecycle, scheduleWithCapacity, workingDaysBetween } from '@commitea/core'
+
+import type { GanttData, GanttRow, GanttWeek } from '../../data/fixtures.js'
+import { addWorkingDays, formatShort } from '../dates.js'
+import type { ProjectData } from './project-data.js'
+
+/** Same 2-char scheme as backlog.ts's `initials()`; copied inline (not exported there). */
+function initials(login: string): string {
+  return login.slice(0, 2).toUpperCase()
+}
+
+/** Copy of backlog.ts's private `toSchedulable` — not exported, so mirrored here. */
+function toSchedulable(issues: ProjectData['issues']) {
+  return issues
+    .filter((i) => i.state === 'open')
+    .map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+      assignee: i.assignee,
+    }))
+}
+
+const roundUpToWeek = (n: number): number => Math.ceil(Math.max(n, 1) / 7) * 7
+
+/**
+ * Real Gantt: the capacity-aware scheduler's lane layout over the open backlog
+ * (startDay/endDay/critical/worker) — the SAME layout the Monte Carlo forecast
+ * runs each trial on, so the bars you see match what's forecast. Plus a handful
+ * of recently-closed issues shown as already-done bars. No per-issue Monte Carlo
+ * exists at this grain, so `p80` is a rough single-issue buffer (endDay padded by
+ * half its own duration) rather than a simulated percentile — flagged below.
+ */
+export function ganttView(d: ProjectData): GanttData {
+  const plan = scheduleWithCapacity(toSchedulable(d.issues), d.deps, d.workers)
+  const issueByNumber = new Map(d.issues.map((i) => [i.number, i]))
+
+  const scheduledRows: GanttRow[] = plan.items.map((item) => {
+    const issue = issueByNumber.get(item.number)
+    const inf = issue ? inferLifecycle(issue, d.timelines[item.number] ?? [], d.today) : null
+    const state: GanttRow['state'] =
+      inf?.column === 'done' ? 'done' : inf?.column === 'steeping' ? 'steeping' : inf?.column === 'review' ? 'review' : 'scheduled'
+    return {
+      id: item.number,
+      title: item.title,
+      // The lane it actually landed on (capacity-aware) — falls back to the
+      // assignee, then blank, so an unassigned issue shows the lane doing it.
+      who: initials(item.worker ?? issue?.assignee ?? ''),
+      start: item.startDay,
+      end: item.endDay,
+      crit: item.critical,
+      state,
+      // Rough single-issue buffer (no Monte Carlo at this grain): pad the end
+      // by half its own duration as a stand-in p80.
+      p80: Math.ceil(item.endDay + (item.endDay - item.startDay) * 0.5),
+    }
+  })
+
+  // Recently-closed issues (closed within ~14 calendar days) as already-done bars.
+  const doneRows: GanttRow[] = d.issues
+    .filter((i) => {
+      if (i.state !== 'closed' || !i.closedAt) return false
+      const ageDays = (d.today.getTime() - new Date(i.closedAt).getTime()) / (24 * 60 * 60 * 1000)
+      return ageDays >= 0 && ageDays <= 14
+    })
+    .map((i) => ({
+      id: i.number,
+      title: i.title,
+      who: initials(i.assignee ?? ''),
+      start: 0,
+      end: 1,
+      state: 'done' as const,
+    }))
+
+  const rows = [...doneRows, ...scheduledRows]
+
+  // Nearest open milestone with a due date, for the horizon + `due` marker.
+  const dueCandidates = d.milestones
+    .filter((m) => m.state === 'open' && m.dueOn)
+    .map((m) => ({ m, day: Math.max(0, workingDaysBetween(d.today, new Date(m.dueOn as string))) }))
+    .sort((a, b) => a.day - b.day)
+  const nearestDue = dueCandidates[0] ?? null
+
+  const days = roundUpToWeek(Math.max(7, ...rows.map((r) => r.end), nearestDue?.day ?? 0))
+
+  const weeks: GanttWeek[] = []
+  for (let at = 0; at <= days; at += 7) {
+    weeks.push({ at, label: formatShort(addWorkingDays(d.today, at)) })
+  }
+
+  const due = nearestDue
+    ? { at: nearestDue.day, label: `${nearestDue.m.title} due` }
+    : { at: days, label: 'horizon' }
+
+  // 80% window: forecast the nearest open milestone's open scope, if any has
+  // one; otherwise fall back to a generic band over the last third of the
+  // horizon (no milestone scope to anchor it to).
+  const open = d.issues.filter((i) => i.state === 'open')
+  const milestoneWithScope = d.milestones
+    .filter((m) => m.state === 'open')
+    .map((m) => ({ m, scope: open.filter((i) => i.milestone?.id === m.id) }))
+    .filter((x) => x.scope.length > 0)
+    .sort((a, b) => {
+      const da = a.m.dueOn ? workingDaysBetween(d.today, new Date(a.m.dueOn)) : Number.POSITIVE_INFINITY
+      const db = b.m.dueOn ? workingDaysBetween(d.today, new Date(b.m.dueOn)) : Number.POSITIVE_INFINITY
+      return da - db
+    })[0]
+
+  let band: GanttData['band']
+  if (milestoneWithScope) {
+    const f = forecast(toSchedulable(milestoneWithScope.scope), d.deps, { workers: d.workers })
+    const p90 = f.curve.length ? f.curve[f.curve.length - 1].p90Day : f.p95Day
+    band = { from: Math.round(f.p50Day), to: Math.round(p90), label: '80% window' }
+  } else {
+    // No milestone with open scope to anchor a real forecast to — degrade to
+    // a generic band over the last third of the horizon.
+    band = { from: Math.round((days * 2) / 3), to: days, label: '80% window' }
+  }
+
+  return {
+    days,
+    weeks,
+    today: 0,
+    band,
+    due,
+    rows,
+  }
+}

apps/desktop/src/renderer/src/lib/views/inbox-view.ts

@@ -0,0 +1,112 @@
+import { inferLifecycle } from '@commitea/core'
+
+import type { InboxItem } from '../../data/fixtures.js'
+import type { ProjectData } from './project-data.js'
+
+const CLOSED_CAP = 5
+const TOTAL_CAP = 12
+
+/** "HH:MM" from an ISO timestamp; '—' when absent (never fabricated). */
+function hhmm(iso: string | null | undefined): string {
+  if (!iso) return '—'
+  const d = new Date(iso)
+  const hh = String(d.getHours()).padStart(2, '0')
+  const mm = String(d.getMinutes()).padStart(2, '0')
+  return `${hh}:${mm}`
+}
+
+/**
+ * Real Inbox feed: steeping nags, review-waiting issues, recently-closed
+ * issues, and closed milestones — all derived straight from the reconciled
+ * backlog + inferred lifecycle. No mentions, no outages, no people-activity:
+ * ProjectData carries none of that, so those fixture item `type`s never
+ * appear here (an honest degrade, not an oversight).
+ */
+export function inboxView(d: ProjectData): InboxItem[] {
+  const items: InboxItem[] = []
+  let id = 1
+
+  const open = d.issues.filter((i) => i.state === 'open')
+
+  // 1. Steeping nags — open issues that have sat past first-commit for 2+ working days.
+  for (const issue of open) {
+    const inf = inferLifecycle(issue, d.timelines[issue.number] ?? [], d.today)
+    if (inf.steepingDays == null || inf.steepingDays < 2) continue
+    const blocks = d.deps.filter((e) => e.dependsOn === issue.number).map((e) => e.issue)
+    items.push({
+      id: id++,
+      day: 'Today',
+      type: 'nag',
+      icon: 'clock',
+      tone: 'warn',
+      text: `#${issue.number} is steeping · ${inf.steepingDays}d`,
+      detail: blocks.length ? `blocks ${blocks.map((b) => `#${b}`).join(' and ')}` : 'worth a look',
+      time: hhmm(inf.stages.steeping),
+      unread: true,
+      issue: { id: issue.number, title: issue.title, labels: issue.labels, days: `${inf.steepingDays}d` },
+    })
+  }
+
+  // 2. Review-waiting — open issues whose lifecycle has reached the review column.
+  for (const issue of open) {
+    const inf = inferLifecycle(issue, d.timelines[issue.number] ?? [], d.today)
+    if (inf.column !== 'review') continue
+    items.push({
+      id: id++,
+      day: 'Today',
+      type: 'review',
+      icon: 'git-pull-request',
+      tone: 'info',
+      text: `#${issue.number} awaits review`,
+      detail: issue.title,
+      time: hhmm(inf.stages.review),
+      unread: true,
+      issue: { id: issue.number, title: issue.title, labels: issue.labels },
+    })
+  }
+
+  // 3. Recently shipped — closed issues, newest close first, capped.
+  const closed = d.issues
+    .filter((i) => i.state === 'closed')
+    .slice()
+    .sort((a, b) => {
+      const at = a.closedAt ? new Date(a.closedAt).getTime() : -Infinity
+      const bt = b.closedAt ? new Date(b.closedAt).getTime() : -Infinity
+      return bt - at
+    })
+    .slice(0, CLOSED_CAP)
+  for (const issue of closed) {
+    items.push({
+      id: id++,
+      day: 'Yesterday',
+      type: 'milestone',
+      icon: 'circle-check',
+      tone: 'ok',
+      text: `#${issue.number} shipped`,
+      detail: issue.title,
+      time: hhmm(issue.closedAt),
+      unread: false,
+      issue: { id: issue.number, title: issue.title, labels: issue.labels },
+    })
+  }
+
+  // 4. Milestone completion — milestones gitea reports as closed.
+  for (const m of d.milestones) {
+    if (m.state !== 'closed') continue
+    items.push({
+      id: id++,
+      day: 'Earlier',
+      type: 'milestone',
+      icon: 'milestone',
+      tone: 'ok',
+      // No milestone-close timestamp is available on GiteaMilestone, so time is
+      // left at the honest placeholder rather than borrowed from an issue.
+      text: `${m.title} closed`,
+      detail: 'milestone complete',
+      time: '—',
+      unread: false,
+    })
+  }
+
+  return items.slice(0, TOTAL_CAP)
+}

apps/desktop/src/renderer/src/lib/views/issue-detail.ts

@@ -0,0 +1,72 @@
+import {
+  forecast,
+  inferLifecycle,
+  type LifecycleStages,
+  toDurationModel,
+} from '@commitea/core'
+
+import type { IssueDetail } from '../../data/fixtures.js'
+import { addWorkingDays, formatRange, formatShort } from '../dates.js'
+import type { ProjectData } from './project-data.js'
+
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
+
+/** "Feb 6 · 11:47" from an ISO timestamp; "pending" when absent. */
+function when(iso: string | undefined): string {
+  if (!iso) return 'pending'
+  const d = new Date(iso)
+  const hh = String(d.getHours()).padStart(2, '0')
+  const mm = String(d.getMinutes()).padStart(2, '0')
+  return `${MONTHS[d.getMonth()]} ${d.getDate()} · ${hh}:${mm}`
+}
+
+function lifecycle(stages: LifecycleStages): IssueDetail['lifecycle'] {
+  return [
+    { stage: 'Diagnosis', event: 'issue opened', when: when(stages.opened), icon: 'circle-dot', done: true },
+    { stage: 'Triage', event: 'labeled / milestoned', when: when(stages.triaged), icon: 'tag', done: !!stages.triaged },
+    { stage: 'Work start', event: 'first commit ref', when: when(stages.steeping), icon: 'git-commit-horizontal', done: !!stages.steeping },
+    { stage: 'In review', event: 'PR referenced', when: when(stages.review), icon: 'git-merge', done: !!stages.review },
+    { stage: 'Complete', event: 'issue closed', when: when(stages.done), icon: 'circle-check', done: !!stages.done },
+  ]
+}
+
+/**
+ * Real Issue-detail sidecar: lifecycle timeline (from event inference), a
+ * single-issue forecast range, and the real dependency edges. Returns null for
+ * an unknown id → the screen shows the demo fixture. Comments aren't reconciled,
+ * so they stay empty (the screen degrades gracefully).
+ */
+export function issueDetailView(id: number, d: ProjectData): IssueDetail | null {
+  const issue = d.issues.find((i) => i.number === id)
+  if (!issue) return null
+  const inf = inferLifecycle(issue, d.timelines[id] ?? [], d.today)
+  const blockedBy = d.deps.filter((e) => e.issue === id).map((e) => e.dependsOn)
+  const blocks = d.deps.filter((e) => e.dependsOn === id).map((e) => e.issue)
+
+  let forecastLine = { p80: 'closed', note: 'shipped' }
+  if (issue.state === 'open') {
+    const f = forecast(
+      [{ number: id, title: issue.title, labels: issue.labels, estimateDays: issue.facts.estimateDays, priority: issue.facts.priority, assignee: issue.assignee }],
+      [],
+      { ...(d.calibration ? { model: toDurationModel(d.calibration) } : {}), workers: d.workers },
+    )
+    const p90 = f.curve.length ? f.curve[f.curve.length - 1].p90Day : f.p95Day
+    forecastLine = {
+      p80: `done ${formatRange(addWorkingDays(d.today, f.p50Day), addWorkingDays(d.today, p90))}`,
+      note: d.calibration && !d.calibration.coldStart ? `from your history · n=${d.calibration.n}` : 'cold-start priors',
+    }
+  }
+
+  return {
+    state: inf.column === 'review' ? 'review' : inf.column,
+    assignee: issue.assignee ?? 'unassigned',
+    milestone: issue.milestone?.title ?? '—',
+    body: issue.body,
+    comments: [],
+    lifecycle: lifecycle(inf.stages),
+    forecast: forecastLine,
+    blocks,
+    blockedBy,
+    note: inf.steepingDays != null ? `Steeping ${inf.steepingDays}d.${blocks.length ? ` Blocks ${blocks.map((b) => `#${b}`).join(', ')}.` : ''}` : '',
+  }
+}

apps/desktop/src/renderer/src/lib/views/project-data.ts

@@ -0,0 +1,17 @@
+import type { CalibrationModel, DependencyEdge, GiteaIssue, GiteaMilestone, LifecycleEvent, Worker } from '@commitea/core'
+
+/**
+ * The reconciled backlog + derived config that every real-data view builder
+ * consumes. AppShell assembles it once from the backlog + capacity, so each
+ * screen's builder gets a uniform input. `calibration`/`workers` are optional —
+ * views degrade to cold-start / single-worker when absent.
+ */
+export interface ProjectData {
+  issues: GiteaIssue[]
+  milestones: GiteaMilestone[]
+  deps: DependencyEdge[]
+  timelines: Record<number, LifecycleEvent[]>
+  calibration?: CalibrationModel
+  workers: Worker[]
+  today: Date
+}

apps/desktop/src/renderer/src/lib/views/standup-view.ts

@@ -0,0 +1,157 @@
+import {
+  type DependencyEdge,
+  type GiteaIssue,
+  inferLifecycle,
+  schedule,
+  type ScheduledItem,
+} from '@commitea/core'
+
+import type { DriftItem, Nag, PlanItem, StandupData } from '../../data/fixtures.js'
+import type { ProjectData } from './project-data.js'
+
+/** Same shape as backlog.ts's private toSchedulable — not exported there, so copied inline. */
+function toSchedulable(issues: GiteaIssue[]) {
+  return issues
+    .filter((i) => i.state === 'open')
+    .map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+      assignee: i.assignee,
+    }))
+}
+
+function whyFor(item: ScheduledItem): string {
+  if (item.critical) return 'On the critical path.'
+  if (item.blocks.length) return `Blocks ${item.blocks.map((b) => `#${b}`).join(', ')}.`
+  return 'Next by dependency + priority order.'
+}
+
+/**
+ * Top scheduled pick per distinct assignee. Iterates the (already dependency-
+ * + priority-ordered) plan once, keeping the first item seen per assignee —
+ * that's their earliest-starting pick since the v0 scheduler lays out a single
+ * serial lane (order ascending ⇒ startDay ascending). Ordered by `d.workers`
+ * when present (assignees absent from the roster are appended after the named
+ * workers; unassigned work last), else by discovery order. Capped at 4 people.
+ */
+function buildPlan(d: ProjectData, open: GiteaIssue[], items: ScheduledItem[]): PlanItem[] {
+  const assigneeByNumber = new Map(open.map((i) => [i.number, i.assignee]))
+  const firstPickByPerson = new Map<string, ScheduledItem>()
+  for (const item of items) {
+    const key = assigneeByNumber.get(item.number) ?? 'Unassigned'
+    if (!firstPickByPerson.has(key)) firstPickByPerson.set(key, item)
+  }
+
+  let order: string[]
+  if (d.workers.length) {
+    const workerOrder = d.workers.map((w) => w.person)
+    const known = workerOrder.filter((p) => firstPickByPerson.has(p))
+    const extra = [...firstPickByPerson.keys()].filter((k) => k !== 'Unassigned' && !workerOrder.includes(k))
+    order = [...known, ...extra]
+    if (firstPickByPerson.has('Unassigned')) order.push('Unassigned')
+  } else {
+    order = [...firstPickByPerson.keys()]
+  }
+
+  return order.slice(0, 4).map((who) => {
+    const item = firstPickByPerson.get(who)!
+    return { who, pick: `#${item.number}`, title: item.title, why: whyFor(item) }
+  })
+}
+
+/**
+ * The single longest-steeping open issue (inferLifecycle's steepingDays, whole
+ * working days since first commit ref). `blocks` comes from the scheduler's
+ * in-scope dependents of that same issue. Falls back to a calm, honest nag
+ * when nothing is currently steeping.
+ */
+function buildNag(d: ProjectData, open: GiteaIssue[], items: ScheduledItem[]): Nag {
+  let worst: { issue: GiteaIssue; days: number } | null = null
+  for (const issue of open) {
+    const inf = inferLifecycle(issue, d.timelines[issue.number] ?? [], d.today)
+    if (inf.steepingDays != null && (worst == null || inf.steepingDays > worst.days)) {
+      worst = { issue, days: inf.steepingDays }
+    }
+  }
+  if (!worst) {
+    return { id: 0, days: '0d', blocks: [], text: 'Nothing is over-steeping. The pot is calm.' }
+  }
+
+  const scheduled = items.find((it) => it.number === worst!.issue.number)
+  const blocks = (scheduled?.blocks ?? []).map((n) => `#${n}`)
+  const days = `${worst.days}d`
+  return {
+    id: worst.issue.number,
+    days,
+    blocks,
+    text: `${days} steeping. ${blocks.length ? `Blocks ${blocks.join(', ')}.` : 'Worth a look.'}`,
+  }
+}
+
+/**
+ * Honest drift signals only — ProjectData carries no notification/webhook
+ * stream, so drift is limited to what lifecycle inference can actually see:
+ * open issues sitting in review (age isn't measurable from the data we have,
+ * so every review-column issue is flagged rather than fabricating a duration)
+ * and open issues steeping past their own estimate. Sorted most-severe first
+ * (steeping overage ranks by days over estimate; review-sitting is a flat,
+ * lower severity since it has no measured age) and capped at 4.
+ */
+function buildDrift(d: ProjectData, open: GiteaIssue[]): DriftItem[] {
+  const candidates: (DriftItem & { severity: number })[] = []
+  for (const issue of open) {
+    const inf = inferLifecycle(issue, d.timelines[issue.number] ?? [], d.today)
+    if (inf.column === 'review') {
+      candidates.push({
+        tone: 'warn',
+        text: `#${issue.number} ${issue.title} is sitting in review.`,
+        delta: 'idle in review',
+        severity: 1,
+      })
+    }
+    if (inf.steepingDays != null) {
+      const est = issue.facts.estimateDays ?? 2
+      if (inf.steepingDays > est) {
+        candidates.push({
+          tone: 'warn',
+          text: `#${issue.number} ${issue.title} has steeped past its estimate.`,
+          delta: `${inf.steepingDays}d vs ${est}d est`,
+          severity: inf.steepingDays - est + 1,
+        })
+      }
+    }
+  }
+  return candidates
+    .sort((a, b) => b.severity - a.severity)
+    .slice(0, 4)
+    .map(({ tone, text, delta }) => ({ tone, text, delta }))
+}
+
+/**
+ * Morning-standup sidecar: per-person top pick from the deterministic
+ * scheduler, the single longest-steeping issue as the day's nag, and drift
+ * limited to real lifecycle anomalies (review-sitting, steeping-past-estimate).
+ * Never throws — an empty/cold backlog degrades to an empty plan, empty drift,
+ * and a calm nag.
+ */
+export function standupView(d: ProjectData): StandupData {
+  const date = d.today.toLocaleDateString('en-GB', {
+    weekday: 'long',
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric',
+  })
+  const open = d.issues.filter((i) => i.state === 'open')
+  const deps: DependencyEdge[] = d.deps
+  const { items } = schedule(toSchedulable(open), deps)
+
+  return {
+    date,
+    plan: buildPlan(d, open, items),
+    nag: buildNag(d, open, items),
+    drift: buildDrift(d, open),
+  }
+}

apps/desktop/src/renderer/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

apps/desktop/vitest.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'vitest/config'
+
+/**
+ * Unit tests for the Electron main process. Node environment only — renderer
+ * (React) is covered by the Playwright e2e suite, not here. `electron` is a
+ * native module that can't be imported outside the Electron runtime, so tests
+ * that touch it mock it (see snapshot-store.test.ts).
+ */
+export default defineConfig({
+  test: {
+    environment: 'node',
+    include: ['src/main/**/*.test.ts'],
+  },
+})

docs/PLAN.md

@@ -87,7 +87,11 @@ directives. Electron app, one window, "tell me what to do" experience.
 Deliverables per phase; replace TBD with actuals at phase close.
 
 - **P0 — Scaffold** — repo, Electron shell, gitea API client + token auth,
-  `pm-state` repo bootstrap. Actual: TBD
+  `pm-state` repo bootstrap. Actual (2026-07-08): yarn4 workspaces + electron
+  shell + `@commitea/core` label schema + design system mirrored. **Dogfood
+  backlog filed** on `christian/commitea`: 10 labels (est/p/deadline, exclusive
+  scopes), 5 phase milestones, 34 tracer-bullet issues with 51 native
+  dependencies. `pm-state` repo bootstrap still pending (P1-6 / P5-1).
 - **P1 — Sync + data model** — read mirror into SQLite cache, webhook
   listener + reconcile-on-launch, lifecycle inference from event stream,
   label schema applied. Actual: TBD
@@ -113,12 +117,16 @@ vertical slices within phases where possible.)
 - Concurrent multi-PM directive writing
 - Cloud LLM as *requirement* (it's a config option, not a dependency)
 
-## Open items for design session
+## Open items for design session — RESOLVED 2026-07-08
 
-- Chat-as-only-write-path: strict or soft (UI edits allowed but agent
-  observes/objects)?
-- `pm-state` file formats (JSONL event log settled; capacity/calibration
-  schemas TBD)
-- Tool schema for the fat `query_project` tool
-- Webhook endpoint mechanics per instance (port allocation, cleanup on quit)
-- Cold-start estimate distributions (industry priors vs uniform pessimism)
+Settled in [decisions.md](./decisions.md), [pm-state.md](./pm-state.md),
+[agent-tools.md](./agent-tools.md):
+
+- Chat-as-only-write-path → **soft, split by semantics** (decisions.md D1)
+- `pm-state` file formats → directive/capacity/calibration schemas (pm-state.md)
+- Fat `query_project` tool schema → one read tool + three write tools
+  (agent-tools.md)
+- Webhook mechanics → **poll + reconcile only in v1** (NAT), behind a
+  `ChangeSource` interface (decisions.md D2)
+- Cold-start distributions → **lognormal per-bucket priors** in code
+  (decisions.md D3)

docs/agent-tools.md

@@ -0,0 +1,119 @@
+# Agent tools
+
+Reginald gets **few, fat tools** so a small local model (gemma-4b class) can
+survive with one thing to reach for. One read tool, three write tools. All I/O
+is compact JSON; ticket data is fetched through tools, never copied into hot
+memory ([PLAN.md](./PLAN.md) memory layers).
+
+Model routing (per PLAN.md): the read tool + prose/standup run on the small
+local model; `capture_work` decomposition and `record_directive` negotiation
+route to the big model.
+
+## `query_project` (read)
+
+The single read tool. A `view` enum selects the shape; `filters` narrows it. The
+scheduler's deterministic output backs every forecast field — the model never
+computes, it reports.
+
+```jsonc
+query_project({
+  view: "focus" | "issue" | "milestone" | "board" | "runway"
+      | "calibration" | "directives" | "standup" | "search",
+  filters?: {
+    issueId?: number,
+    milestoneId?: number,
+    state?: "diagnosis" | "triage" | "steeping" | "in_review" | "done",
+    assignee?: string,        // gitea username
+    label?: string,
+    query?: string,           // free text, for view:"search"
+    limit?: number            // default 20, max 100
+  }
+})
+```
+
+View payloads (compact; forecasts always ranges, never point dates):
+
+- **focus** — `{ now, next[], later[] }`, each `{ issue, title, rationale }`.
+- **issue** — intent (title, description, comments, assignee, labels) + derived
+  (lifecycle timeline, per-issue forecast range, dependency ids, provenance).
+- **milestone** — `{ due, hard, stats, cone: {p10,p50,p80 dates}, issues[] }`.
+- **board** — issues grouped by the five lifecycle columns.
+- **runway** — per-milestone `{ due, band: {p50,p80}, slack }` + capacity list.
+- **calibration** — `{ n, coldStart, globalMultiplier, byLabelBias[], byPersonBias[] }`.
+- **directives** — pending consequence diff + recent ledger entries.
+- **standup** — drift report, per-person plan, stale blockers.
+- **search** — issues matching `query`.
+
+## `capture_work` (write — big model)
+
+Braindump → interview → proposed issue set. Returns a **proposal**, never files
+directly; the Capture screen's review tray edits it before `apply_changes` files
+it. Decomposition + estimate negotiation is the one place the big model earns its
+keep.
+
+```jsonc
+capture_work({
+  braindump: string,
+  answers?: { question: string, answer: string }[]   // interview turns so far
+})
+// → { needsMoreInfo?: string[],   // follow-up questions; present as chips
+//     proposal?: { issues: [{ title, body, estimate: EstimateLabel,
+//                             priority?: PriorityLabel, deps?: number[],
+//                             milestone?: number }],
+//                  consequence: string } }           // one-line schedule impact
+```
+
+## `apply_changes` (write — unified mutation)
+
+Every mutation funnels here: filing captured issues, label/estimate/priority/
+milestone/dependency edits. Additive ops apply directly; **destructive ops
+require `approved: true`** (the caller obtains approval via the consequence
+diff / Dialog first — see [decisions.md](./decisions.md) D1). Batched so one call
+= one coherent change with one consequence.
+
+```jsonc
+apply_changes({
+  ops: [
+    { op: "create_issue", title, body, labels?, milestone?, deps? },
+    { op: "set_estimate", issue, estimate: EstimateLabel },
+    { op: "set_priority", issue, priority: PriorityLabel },
+    { op: "set_milestone", issue, milestone: number | null },
+    { op: "set_deadline_hard", milestone: number, hard: boolean },
+    { op: "add_dep", issue, dependsOn: number },
+    { op: "remove_dep", issue, dependsOn: number },   // destructive
+    { op: "close_issue", issue },                     // destructive
+    { op: "remove_label", issue, label }              // destructive
+  ],
+  approved?: boolean            // required iff any op is destructive
+})
+// → { applied: number, consequence: string, rejected?: {op, reason}[] }
+```
+
+Only touches labels in the CommiTea namespaces (`est/*`, `p/*`, `deadline/hard`)
+plus native issue fields — never invents labels, comments, or synthetic issues
+(zero-pollution goal).
+
+## `record_directive` (write — big model)
+
+Appends to the directive log ([pm-state.md](./pm-state.md)), triggers a scheduler
+re-run, and returns the consequence diff for propose-approve. Does **not** mutate
+gitea itself — a directive is intent; its effects land through `apply_changes`
+after approval.
+
+```jsonc
+record_directive({
+  kind: "reprioritize" | "reestimate" | "set-deadline" | "scope" | "capacity" | "note",
+  quote: string,                // verbatim PM words, stored in the ledger
+  target?: { issue?: number, milestone?: number, member?: string },
+  params?: object,              // structured effect, e.g. { priority: 1 }
+  rationale?: string
+})
+// → { directiveId, consequence: { before, after }[], summary: string }
+```
+
+## Not tools
+
+Reads that are pure UI state (theme, current view, back-stack) never go through
+tools. The scheduler, Monte Carlo, calibration fit, and lifecycle inference are
+**code**, invoked by the runtime around these tools — the model requests a view
+or proposes a change; deterministic code produces every number.

docs/decisions.md

@@ -0,0 +1,73 @@
+# Settled design decisions
+
+Resolves the "Open items for design session" in [PLAN.md](./PLAN.md). Dated
+2026-07-08. Companion docs: [pm-state.md](./pm-state.md) (sidecar formats),
+[agent-tools.md](./agent-tools.md) (tool schemas).
+
+## D1 — Write path is soft, split by semantics
+
+Chat (Reginald) is the write path for **PM-semantic** mutations; gitea-native
+content stays directly editable.
+
+- **Through the agent** — estimates (`est/*`), priority (`p/*`),
+  `deadline/hard`, milestone assignment, dependency edits, and directives.
+  Additive ops act directly; destructive ops go propose-approve (Dialog or the
+  consequence diff on the Directives screen).
+- **Direct, reconciled** — issue title/description, comments, assignees. Edit
+  them in the CommiTea UI ("composer writes to gitea, as you") or in the gitea
+  web UI; reconcile absorbs out-of-band edits because **gitea is the source of
+  truth** for intent. The agent observes changes on the next reconcile and may
+  object in standup, but never blocks them.
+
+Rejected: strict (every write through chat). Hostile to quick edits and fights
+the reconcile-from-gitea model — an edit made in gitea's own web UI would be
+un-representable.
+
+## D2 — Sync is poll + reconcile, no live webhooks in v1
+
+`gitea.stephenmann.io` is remote and the desktop app sits behind NAT, so the
+server cannot POST to a localhost webhook. v1:
+
+- **Reconcile on launch** — full read of the work repo(s) + `pm-state` repo into
+  the local SQLite cache.
+- **Light poll while running** — `since`/conditional-request poll of issues and
+  the issue timeline (target 30–60 s cadence; visible < 2 s is a webhook-era
+  goal, relaxed to the poll interval for v1).
+- The change-source is an **interface** (`ChangeSource`) with a polling
+  implementation; a webhook implementation can plug in later for a LAN /
+  self-hosted / tunnelled instance without touching the reconcile core.
+
+Rejected now: reachability-detection hybrid (moving parts, cleanup-on-quit),
+outbound tunnel (runtime dependency + public ingress). Both remain future
+options behind the same interface.
+
+## D3 — Cold-start forecasts use lognormal per-bucket priors
+
+Before the team has n ≥ 20 closed issues with estimates, Monte Carlo samples a
+**lognormal** actual-duration distribution per estimate bucket
+(`1d/2d/3d/5d/8d`), with a pessimism-skewed median (actuals run long). The
+priors live in code (`@commitea/core`), not in a data file. At n ≥ 20 the
+scheduler switches to the team's own empirical fit (see calibration model in
+[pm-state.md](./pm-state.md)); `byLabel` / `byPerson` bias terms layer on once
+their own sample sizes clear a floor.
+
+Rejected: uniform pessimism multiplier (`actual = est × U[1.3, 2.0]`) — cruder,
+dishonest tails, no path to per-bucket calibration.
+
+## D4 — Purity test applies to the SQLite cache, not the pm-state repo
+
+The plan's invariant — *delete the sidecar → resync → no truth lost* — is about
+the **local SQLite cache**, which is a rebuildable index over two durable
+sources:
+
+- **Work repo(s) in gitea** — human-authored intent (issues, milestones + due
+  dates, dependencies, assignees, labels, comments).
+- **`pm-state` repo in gitea** — the sidecar's own durable truth that is *not*
+  regenerable from the work repo: directive log, capacity config, charter, and
+  the (cached-but-committed) calibration model.
+
+Delete SQLite → rebuild from both repos → nothing lost. The `pm-state` repo is
+never the thing you delete; it is versioned and backed up in gitea like any
+other repo. Regenerable state (issue mirror, inferred lifecycle timestamps,
+Monte Carlo forecasts, focus snapshot) lives in SQLite only and is recomputed on
+rebuild. See [pm-state.md](./pm-state.md) for the file/table split.

docs/pm-state.md

@@ -0,0 +1,123 @@
+# pm-state: the sidecar store
+
+Machine-derived and PM-authored state that has no home in the work repo. Split
+across two tiers per [decisions.md](./decisions.md) D4:
+
+- **`pm-state` gitea repo** — durable, versioned truth. Committed files below.
+- **local SQLite** — rebuildable cache/index. Never the source of truth.
+
+## `pm-state` repo layout
+
+```
+charter.md                 durable   project charter + hot-memory seed (human + agent authored)
+directives/log.jsonl       durable   append-only directive ledger (conflict-free merge)
+capacity/members.yaml      durable   per-person capacity model (human-set)
+calibration/model.json     cached    fitted calibration; regenerable from actuals, committed for
+                                     reproducibility + offline forecasting
+```
+
+`forecasts/`, `focus/`, and inferred lifecycle timestamps are **not** committed
+— they are SQLite-only and recomputed on rebuild (regenerable from the work repo
++ calibration model).
+
+## Directive log — `directives/log.jsonl`
+
+Append-only, one JSON object per line. **Merge is concatenation**: order is
+derived from `ts` at read time, so two clients appending never produce a git
+conflict. `id` is the durable key; `seq` is a display ordinal computed on read,
+never stored (avoids the "who owns the next number" contention). v1 is
+single-writer (one PM); this format is already safe for the deferred
+multi-writer case.
+
+```jsonc
+{
+  "id": "d_01J8...",              // crypto.randomUUID at write; durable identity
+  "ts": "2026-07-08T14:03:00Z",   // ISO 8601 UTC; sole ordering key
+  "actor": "christian",           // gitea username of the directive-giver
+  "kind": "reprioritize",         // reprioritize | reestimate | set-deadline | scope | capacity | note
+  "target": { "issue": 87 },      // { issue } | { milestone } | { member } | null (project-wide)
+  "quote": "bump the auth bug above everything",   // verbatim, shown in the ledger
+  "params": { "priority": 1 },    // structured effect the scheduler applies
+  "rationale": "pilot customer blocked",           // why (optional but nagged for)
+  "status": "accepted"            // proposed | accepted | amended | withdrawn
+}
+```
+
+Lifecycle: a directive is recorded as `proposed`, the scheduler re-runs, the
+agent presents the consequence diff, and the PM's response flips it to
+`accepted` / `amended` / `withdrawn`. All four states stay in the ledger
+(append a status-change line; never mutate a prior line).
+
+## Capacity — `capacity/members.yaml`
+
+Estimate unit is **ideal person-days**. Capacity is expressed in ideal
+person-days available per calendar day.
+
+```yaml
+members:
+  - gitea: christian
+    focusFactor: 0.8         # productive fraction of a working day (0..1)
+    projectAllocation: 0.6   # share of focused time on THIS project (0..1)
+    workdays: [mon, tue, wed, thu, fri]
+    daysOff: []              # ISO dates, e.g. ["2026-07-14"]; PTO calendars deferred
+    # other standing slices (compliance 0.2, pilots 0.2) are documentation only —
+    # only projectAllocation feeds the scheduler.
+```
+
+Derived: `capacityPerWorkday = focusFactor * projectAllocation` (ideal
+person-days per working day). The scheduler spreads this across `workdays`,
+zeroing `daysOff`. Missing member ⇒ excluded from capacity, flagged by the agent.
+
+## Calibration — `calibration/model.json`
+
+Fitted from closed-issue actuals (estimate label vs inferred elapsed working
+time). Lognormal on `log(actual / estimate)`.
+
+```jsonc
+{
+  "version": 1,
+  "fittedAt": "2026-07-08T00:00:00Z",
+  "n": 42,                        // closed issues with an estimate feeding the fit
+  "coldStart": false,             // true while n < 20 → scheduler uses code priors instead
+  "global": { "mu": 0.166, "sigma": 0.45 },   // lognormal params on log-ratio; median ratio = e^mu ≈ 1.18
+  "byBucket": {                   // per estimate label; falls back to global when its n is thin
+    "1d": { "mu": 0.30, "sigma": 0.55, "n": 12 },
+    "2d": { "mu": 0.18, "sigma": 0.40, "n": 9 }
+    // 3d / 5d / 8d ...
+  },
+  "byLabel":  { "backend": { "biasMu": 0.12, "n": 7 } },   // additive to mu; applied when n ≥ floor
+  "byPerson": { "christian": { "biasMu": -0.05, "n": 20 } }
+}
+```
+
+Cold-start (`coldStart: true`, or a bucket with `n` below floor): the scheduler
+ignores the file's fitted params for that axis and samples the **code-resident
+lognormal priors** in `@commitea/core` (per D3). The file still records whatever
+partial `n` exists so the UI's calibration teaser can show progress toward 20.
+
+## SQLite cache (rebuildable — not committed)
+
+Mirror + derived tables, rebuilt from both gitea repos on reconcile:
+
+- `issues`, `labels`, `milestones`, `comments`, `issue_events` — verbatim work-repo mirror
+- `lifecycle` — inferred per-issue timestamps (see below), keyed by issue
+- `forecasts` — last Monte Carlo run per milestone/issue (regenerable)
+- `focus` — current Now/Next/Later snapshot (regenerable)
+- `directives` — indexed view of `log.jsonl` for fast querying
+
+## Lifecycle inference
+
+Timestamps derived from the gitea issue timeline; no manual time tracking. Maps
+onto the board's five columns:
+
+| Board column | Enter when                                             | Source event            |
+|--------------|--------------------------------------------------------|-------------------------|
+| Diagnosis    | issue opened                                           | `opened`                |
+| Triage       | first label or milestone applied                       | `label` / `milestone`   |
+| Steeping     | first branch or commit references the issue            | `commit_ref` / branch   |
+| In review    | a PR referencing the issue is opened                   | PR `opened`             |
+| Done         | issue closed (PR merged is the deploy signal within)   | `closed` / PR `merged`  |
+
+Elapsed **working** time between Steeping→Done (minus non-workdays/daysOff) is
+the "actual" that feeds calibration. Re-openings append new segments; the fit
+uses summed working time.

packages/core/src/agent/agent-live.test.ts

@@ -0,0 +1,103 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+
+import { extractLabelFacts } from '../labels/label-schema.js'
+import type { FetchLike, GiteaIssue } from '../gitea/types.js'
+import { runAgentTurn } from './agent-loop.js'
+import { REGINALD_SYSTEM, REGINALD_TOOLS } from './agent-tools.js'
+import { createChatClient } from './chat-client.js'
+import { buildProjectView, type ProjectSnapshot } from './query-project.js'
+
+/**
+ * Opt-in (COMMITEA_MODEL_LIVE=1). Drives the real chat client + agent loop
+ * against a local OpenAI-compatible server (LM Studio on :1234 by default),
+ * proving the model calls the tools and narrates the real result. The model is
+ * whatever is loaded (via LM Studio's native API), so it never JIT-swaps.
+ */
+const LIVE = !!process.env.COMMITEA_MODEL_LIVE
+const BASE = process.env.COMMITEA_MODEL_URL ?? 'http://localhost:1234/v1'
+let MODEL = process.env.COMMITEA_MODEL_SMALL ?? ''
+
+beforeAll(async () => {
+  if (!LIVE || MODEL) return
+  const root = BASE.replace(/\/v1\/?$/, '')
+  const loaded = await fetch(`${root}/api/v0/models`)
+    .then((r) => (r.ok ? (r.json() as Promise<{ data?: { id: string; state?: string; type?: string }[] }>) : null))
+    .then((d) => d?.data?.find((m) => m.state === 'loaded' && m.type !== 'embeddings')?.id)
+    .catch(() => undefined)
+  MODEL = loaded ?? 'google/gemma-4-e4b'
+})
+
+function issue(over: Partial<GiteaIssue>): GiteaIssue {
+  const labels = over.labels ?? []
+  return {
+    number: 1, title: '#1', body: '', state: 'open', labels, facts: extractLabelFacts(labels),
+    milestone: null, assignee: null, assignees: [], createdAt: '2026-01-05T09:00:00Z',
+    updatedAt: '2026-01-05T09:00:00Z', closedAt: null, url: '', ...over,
+  }
+}
+
+const SNAP: ProjectSnapshot = {
+  issues: [
+    issue({ number: 2, title: 'ChangeSource interface + polling source', labels: ['est/3d', 'p/1'] }),
+    issue({ number: 3, title: 'SQLite cache bootstrap', labels: ['est/2d', 'p/1'] }),
+  ],
+  timelines: {},
+  deps: [{ issue: 3, dependsOn: 2 }],
+}
+
+describe('agent loop (live model)', () => {
+  it.skipIf(!LIVE)(
+    'calls query_project and narrates the real focus',
+    async () => {
+      const client = createChatClient({ baseUrl: BASE, model: MODEL }, globalThis.fetch as unknown as FetchLike)
+      const turn = await runAgentTurn({
+        complete: (m, t) => client.complete(m, t),
+        messages: [
+          { role: 'system', content: REGINALD_SYSTEM },
+          { role: 'user', content: 'What should I work on right now?' },
+        ],
+        tools: REGINALD_TOOLS,
+        execute: async (name, args) =>
+          name === 'query_project'
+            ? buildProjectView((args as { view: any }).view, (args as any).filters, SNAP, new Date())
+            : { error: `unknown tool ${name}` },
+      })
+
+      // it consulted the project, then answered in prose about the real top item (#2)
+      expect(turn.steps.some((s) => s.tool === 'query_project')).toBe(true)
+      expect(turn.content.trim().length).toBeGreaterThan(0)
+      expect(turn.content).toMatch(/#?2\b|ChangeSource/i)
+    },
+    60_000,
+  )
+
+  it.skipIf(!LIVE)(
+    'records a standing instruction via record_directive',
+    async () => {
+      const client = createChatClient({ baseUrl: BASE, model: MODEL }, globalThis.fetch as unknown as FetchLike)
+      const recorded: unknown[] = []
+      const turn = await runAgentTurn({
+        complete: (m, t) => client.complete(m, t),
+        messages: [
+          { role: 'system', content: REGINALD_SYSTEM },
+          { role: 'user', content: 'Log this standing directive: pilots come first, everything else waits.' },
+        ],
+        tools: REGINALD_TOOLS,
+        execute: async (name, args) => {
+          if (name === 'record_directive') {
+            recorded.push(args)
+            return { recorded: { kind: (args as { kind?: string }).kind ?? 'note' } }
+          }
+          return name === 'query_project'
+            ? buildProjectView((args as { view: any }).view, (args as any).filters, SNAP, new Date())
+            : { error: `unknown tool ${name}` }
+        },
+      })
+
+      // the model logged the directive rather than trying to apply it
+      expect(turn.steps.some((s) => s.tool === 'record_directive')).toBe(true)
+      expect(recorded.length).toBeGreaterThan(0)
+    },
+    60_000,
+  )
+})

packages/core/src/agent/agent-loop.ts

@@ -0,0 +1,71 @@
+/**
+ * The agent turn loop. Given a model `complete` fn, the conversation, the tool
+ * declarations, and an `execute` that actually runs a tool, it drives the
+ * call→tool→result→call cycle until the model answers in prose (or a step
+ * budget is hit). Pure orchestration with injected I/O — the model and the tool
+ * executor are both stubbable, so the loop is fully unit-testable offline.
+ */
+
+import type { ChatMessage, CompletionResult, ToolDecl } from './chat-client.js'
+
+/** A tool the loop ran, with the raw args and its stringified result — for the UI's activity trail. */
+export interface AgentStep {
+  tool: string
+  arguments: string
+  result: string
+}
+
+export type ToolExecutor = (name: string, args: unknown) => Promise<unknown>
+
+export interface AgentTurn {
+  content: string
+  steps: AgentStep[]
+  /** The full conversation including this turn's assistant/tool messages. */
+  messages: ChatMessage[]
+}
+
+const DEFAULT_MAX_STEPS = 4
+
+function stringify(result: unknown): string {
+  return typeof result === 'string' ? result : JSON.stringify(result)
+}
+
+export async function runAgentTurn(opts: {
+  complete: (messages: ChatMessage[], tools?: ToolDecl[], onToken?: (delta: string) => void) => Promise<CompletionResult>
+  messages: ChatMessage[]
+  tools: ToolDecl[]
+  execute: ToolExecutor
+  maxSteps?: number
+  /** Streams content deltas as the model produces prose (final-answer streaming). */
+  onToken?: (delta: string) => void
+}): Promise<AgentTurn> {
+  const maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS
+  const convo: ChatMessage[] = [...opts.messages]
+  const steps: AgentStep[] = []
+
+  for (let step = 0; step < maxSteps; step++) {
+    const { content, toolCalls } = await opts.complete(convo, opts.tools, opts.onToken)
+    if (toolCalls.length === 0) {
+      convo.push({ role: 'assistant', content })
+      return { content, steps, messages: convo }
+    }
+    convo.push({ role: 'assistant', content, toolCalls })
+    for (const tc of toolCalls) {
+      let result: unknown
+      try {
+        const args = tc.arguments ? JSON.parse(tc.arguments) : {}
+        result = await opts.execute(tc.name, args)
+      } catch (e) {
+        result = { error: e instanceof Error ? e.message : String(e) }
+      }
+      const resultStr = stringify(result)
+      steps.push({ tool: tc.name, arguments: tc.arguments, result: resultStr })
+      convo.push({ role: 'tool', toolCallId: tc.id, name: tc.name, content: resultStr })
+    }
+  }
+
+  // Out of tool budget — force a final prose answer with tools withheld.
+  const final = await opts.complete(convo, [], opts.onToken)
+  convo.push({ role: 'assistant', content: final.content })
+  return { content: final.content, steps, messages: convo }
+}

packages/core/src/agent/agent-tools.ts

@@ -0,0 +1,96 @@
+/**
+ * Reginald's tool surface. v0 ships the one read tool (`query_project`); the
+ * three write tools (capture_work, apply_changes, record_directive) layer on
+ * later against the same loop. Few, fat tools so a small local model survives
+ * with one thing to reach for (docs/agent-tools.md).
+ */
+
+import type { ToolDecl } from './chat-client.js'
+
+export const QUERY_PROJECT_TOOL: ToolDecl = {
+  name: 'query_project',
+  description:
+    'Read the current project state. A `view` selects the shape; deterministic code (scheduler, ' +
+    'lifecycle inference, calibration) backs every number — you report it, you never compute it.',
+  parameters: {
+    type: 'object',
+    properties: {
+      view: {
+        type: 'string',
+        enum: ['focus', 'board', 'calibration', 'issue', 'search', 'standup'],
+        description:
+          'focus = Now/Next/Later; board = issues by lifecycle column; calibration = estimate-vs-actual; ' +
+          'issue = one issue (needs filters.issueId); search = issues matching filters.query; ' +
+          "standup = today's plan + overnight drift + the stalest blocker.",
+      },
+      filters: {
+        type: 'object',
+        properties: {
+          issueId: { type: 'number' },
+          query: { type: 'string' },
+          limit: { type: 'number' },
+        },
+      },
+    },
+    required: ['view'],
+  },
+}
+
+export const PROPOSE_CHANGE_TOOL: ToolDecl = {
+  name: 'propose_change',
+  description:
+    'Propose a change to an issue — estimate, priority, assignee, and/or milestone. This does NOT apply ' +
+    'anything; it shows the human a diff to approve. Use it whenever the user asks to re-estimate, reprioritize, ' +
+    'assign someone (or unassign), or move an issue to a milestone. Pass a login for `assignee` (null to ' +
+    'unassign) and a milestone id for `milestone` (null to remove). After calling it, tell the user you have ' +
+    '*proposed* the change for approval — never say it is done.',
+  parameters: {
+    type: 'object',
+    properties: {
+      issue: { type: 'number', description: 'the issue number to change' },
+      estimate: { type: 'string', enum: ['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d'] },
+      priority: { type: 'string', enum: ['p/1', 'p/2', 'p/3', 'p/4'] },
+      assignee: { type: 'string', description: 'gitea login to assign, or null to unassign' },
+      milestone: { type: 'number', description: 'milestone id to set, or null to remove from its milestone' },
+    },
+    required: ['issue'],
+  },
+}
+
+export const RECORD_DIRECTIVE_TOOL: ToolDecl = {
+  name: 'record_directive',
+  description:
+    'Log a standing instruction from the PM to the durable directive ledger — a reprioritization, ' +
+    'a re-estimate policy, a deadline, a scope or capacity call, or a plain note. Use it when the user ' +
+    'states intent that should persist ("pilots come first", "freeze scope for beta"). This records the ' +
+    'intent verbatim; the actual issue edits still go through propose_change.',
+  parameters: {
+    type: 'object',
+    properties: {
+      kind: { type: 'string', enum: ['reprioritize', 'reestimate', 'set-deadline', 'scope', 'capacity', 'note'] },
+      quote: { type: 'string', description: "the PM's own words, stored verbatim" },
+      target: {
+        type: 'object',
+        properties: {
+          issue: { type: 'number' },
+          milestone: { type: 'number' },
+          member: { type: 'string' },
+        },
+      },
+      rationale: { type: 'string', description: 'why (optional)' },
+    },
+    required: ['kind', 'quote'],
+  },
+}
+
+export const REGINALD_TOOLS: ToolDecl[] = [QUERY_PROJECT_TOOL, PROPOSE_CHANGE_TOOL, RECORD_DIRECTIVE_TOOL]
+
+export const REGINALD_SYSTEM = [
+  'You are Reginald, the calm, dry project manager inside CommiTea — a tool that runs projects on Gitea.',
+  'Call query_project to ground every answer in the real project; never invent issues, numbers, or dates.',
+  'The scheduler and forecasts are deterministic code — report their output, do not recompute it.',
+  'To change an estimate, priority, assignee, or milestone, call propose_change — it shows the human a diff to approve.',
+  'When the PM states standing intent ("pilots first", "freeze scope"), call record_directive to log it.',
+  'Never claim a change is applied; you propose, the human approves. Forecasts are ranges, never single dates.',
+  'Refer to issues as #<number>. Be brief and plain — a sentence or two. No preamble, no bullet dumps.',
+].join(' ')

packages/core/src/agent/agent.test.ts

@@ -0,0 +1,282 @@
+import { describe, expect, it } from 'vitest'
+
+import { extractLabelFacts } from '../labels/label-schema.js'
+import type { GiteaIssue } from '../gitea/types.js'
+import type { FetchLike } from '../gitea/types.js'
+import { type ChatMessage, type CompletionResult, createChatClient, type ToolDecl } from './chat-client.js'
+import { runAgentTurn } from './agent-loop.js'
+import { pickModel } from './model-router.js'
+import { buildProjectView, type ProjectSnapshot } from './query-project.js'
+
+// ---- chat client ----
+
+describe('createChatClient', () => {
+  function stub(body: unknown) {
+    const calls: { url: string; body: unknown }[] = []
+    const fetch: FetchLike = (url, init) => {
+      calls.push({ url, body: init?.body ? JSON.parse(init.body) : undefined })
+      return Promise.resolve({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(body),
+        text: () => Promise.resolve(''),
+      })
+    }
+    return { fetch, calls }
+  }
+
+  function sseStub(chunks: string[]) {
+    const calls: { url: string; body: unknown }[] = []
+    const fetch: FetchLike = (url, init) => {
+      calls.push({ url, body: init?.body ? JSON.parse(init.body) : undefined })
+      const enc = new TextEncoder()
+      const body = new ReadableStream<Uint8Array>({
+        start(c) {
+          for (const ch of chunks) c.enqueue(enc.encode(ch))
+          c.close()
+        },
+      })
+      return Promise.resolve({ ok: true, status: 200, body, json: () => Promise.resolve({}), text: () => Promise.resolve('') })
+    }
+    return { fetch, calls }
+  }
+
+  it('streams content deltas via onToken and returns the assembled result', async () => {
+    const { fetch, calls } = sseStub([
+      'data: {"choices":[{"delta":{"content":"Right "}}]}\n\n',
+      'data: {"choices":[{"delta":{"content":"now: #2."}}]}\n\n',
+      'data: [DONE]\n\n',
+    ])
+    const client = createChatClient({ baseUrl: 'http://x/v1', model: 'm' }, fetch)
+    const tokens: string[] = []
+    const res = await client.complete([{ role: 'user', content: 'now?' }], undefined, (d) => tokens.push(d))
+
+    expect(tokens).toEqual(['Right ', 'now: #2.'])
+    expect(res.content).toBe('Right now: #2.')
+    expect((calls[0].body as { stream?: boolean }).stream).toBe(true)
+  })
+
+  it('assembles a streamed tool call from argument deltas', async () => {
+    const { fetch } = sseStub([
+      'data: {"choices":[{"delta":{"tool_calls":[{"index":0,"id":"c1","function":{"name":"query_project","arguments":"{\\"view\\""}}]}}]}\n\n',
+      'data: {"choices":[{"delta":{"tool_calls":[{"index":0,"function":{"arguments":":\\"focus\\"}"}}]}}]}\n\n',
+      'data: [DONE]\n\n',
+    ])
+    const client = createChatClient({ baseUrl: 'http://x/v1', model: 'm' }, fetch)
+    const res = await client.complete([{ role: 'user', content: 'x' }], [{ name: 'query_project', description: '', parameters: {} }], () => {})
+    expect(res.toolCalls).toEqual([{ id: 'c1', name: 'query_project', arguments: '{"view":"focus"}' }])
+  })
+
+  it('POSTs to /chat/completions and parses content', async () => {
+    const { fetch, calls } = stub({ choices: [{ message: { content: 'the focus is #2' } }] })
+    const client = createChatClient({ baseUrl: 'http://localhost:1234/v1', model: 'gemma' }, fetch)
+    const res = await client.complete([{ role: 'user', content: 'what now?' }])
+
+    expect(res.content).toBe('the focus is #2')
+    expect(res.toolCalls).toEqual([])
+    expect(calls[0].url).toBe('http://localhost:1234/v1/chat/completions')
+    expect((calls[0].body as { model: string }).model).toBe('gemma')
+  })
+
+  it('parses tool calls from the wire shape', async () => {
+    const { fetch } = stub({
+      choices: [
+        {
+          message: {
+            content: null,
+            tool_calls: [{ id: 'c1', function: { name: 'query_project', arguments: '{"view":"focus"}' } }],
+          },
+        },
+      ],
+    })
+    const client = createChatClient({ baseUrl: 'http://x/v1', model: 'm' }, fetch)
+    const res = await client.complete([{ role: 'user', content: 'x' }], [{ name: 'query_project', description: '', parameters: {} }])
+    expect(res.toolCalls).toEqual([{ id: 'c1', name: 'query_project', arguments: '{"view":"focus"}' }])
+  })
+
+  it('serializes assistant tool_calls + tool results in the request', async () => {
+    const { fetch, calls } = stub({ choices: [{ message: { content: 'ok' } }] })
+    const client = createChatClient({ baseUrl: 'http://x/v1', model: 'm' }, fetch)
+    const convo: ChatMessage[] = [
+      { role: 'user', content: 'hi' },
+      { role: 'assistant', content: '', toolCalls: [{ id: 'c1', name: 'query_project', arguments: '{}' }] },
+      { role: 'tool', toolCallId: 'c1', name: 'query_project', content: '{"now":null}' },
+    ]
+    await client.complete(convo)
+    const sent = (calls[0].body as { messages: Record<string, unknown>[] }).messages
+    expect(sent[1].tool_calls).toBeDefined()
+    expect(sent[2]).toEqual({ role: 'tool', tool_call_id: 'c1', content: '{"now":null}' })
+  })
+})
+
+// ---- model router ----
+
+describe('pickModel', () => {
+  const router = { small: { baseUrl: 'u', model: 'small' }, big: { baseUrl: 'u', model: 'big' } }
+  it('routes plan → big, everything else → small', () => {
+    expect(pickModel(router, 'plan').model).toBe('big')
+    expect(pickModel(router, 'ritual').model).toBe('small')
+  })
+})
+
+// ---- agent loop ----
+
+describe('runAgentTurn', () => {
+  const tools: ToolDecl[] = [{ name: 'query_project', description: '', parameters: {} }]
+
+  it('runs a tool then returns the model prose, recording the step', async () => {
+    // first completion asks for a tool; second answers in prose
+    const scripted: CompletionResult[] = [
+      { content: '', toolCalls: [{ id: 'c1', name: 'query_project', arguments: '{"view":"focus"}' }] },
+      { content: 'Right now: #2.', toolCalls: [] },
+    ]
+    let i = 0
+    const executed: { name: string; args: unknown }[] = []
+    const turn = await runAgentTurn({
+      complete: async () => scripted[i++],
+      messages: [{ role: 'user', content: 'what now?' }],
+      tools,
+      execute: async (name, args) => {
+        executed.push({ name, args })
+        return { now: { issue: 2 } }
+      },
+    })
+
+    expect(turn.content).toBe('Right now: #2.')
+    expect(turn.steps).toEqual([
+      { tool: 'query_project', arguments: '{"view":"focus"}', result: '{"now":{"issue":2}}' },
+    ])
+    expect(executed).toEqual([{ name: 'query_project', args: { view: 'focus' } }])
+    // conversation carries user → assistant(tool) → tool → assistant(prose)
+    expect(turn.messages.map((m) => m.role)).toEqual(['user', 'assistant', 'tool', 'assistant'])
+  })
+
+  it('answers directly when the model needs no tool', async () => {
+    const turn = await runAgentTurn({
+      complete: async () => ({ content: 'Hello.', toolCalls: [] }),
+      messages: [{ role: 'user', content: 'hi' }],
+      tools,
+      execute: async () => ({}),
+    })
+    expect(turn.content).toBe('Hello.')
+    expect(turn.steps).toEqual([])
+  })
+
+  it('captures a tool executor error as the tool result instead of throwing', async () => {
+    const scripted: CompletionResult[] = [
+      { content: '', toolCalls: [{ id: 'c1', name: 'query_project', arguments: '{}' }] },
+      { content: 'Something went wrong reading that.', toolCalls: [] },
+    ]
+    let i = 0
+    const turn = await runAgentTurn({
+      complete: async () => scripted[i++],
+      messages: [{ role: 'user', content: 'x' }],
+      tools,
+      execute: async () => {
+        throw new Error('boom')
+      },
+    })
+    expect(turn.steps[0].result).toContain('boom')
+    expect(turn.content).toBe('Something went wrong reading that.')
+  })
+
+  it('forces a final prose answer when the step budget is exhausted', async () => {
+    // always asks for a tool; the loop must still terminate with prose
+    let toolRounds = 0
+    const turn = await runAgentTurn({
+      complete: async (_m, tls) => {
+        if (tls && tls.length) {
+          toolRounds++
+          return { content: '', toolCalls: [{ id: `c${toolRounds}`, name: 'query_project', arguments: '{}' }] }
+        }
+        return { content: 'final answer', toolCalls: [] } // called with tools withheld
+      },
+      messages: [{ role: 'user', content: 'x' }],
+      tools,
+      execute: async () => ({}),
+      maxSteps: 2,
+    })
+    expect(toolRounds).toBe(2)
+    expect(turn.content).toBe('final answer')
+  })
+})
+
+// ---- query_project view builder ----
+
+describe('buildProjectView', () => {
+  const asOf = new Date('2026-02-01T00:00:00Z')
+
+  function issue(over: Partial<GiteaIssue>): GiteaIssue {
+    const labels = over.labels ?? []
+    return {
+      number: 1,
+      title: '#1',
+      body: '',
+      state: 'open',
+      labels,
+      facts: extractLabelFacts(labels),
+      milestone: null,
+      assignee: null,
+      assignees: [],
+      createdAt: '2026-01-05T09:00:00Z',
+      updatedAt: '2026-01-05T09:00:00Z',
+      closedAt: null,
+      url: '',
+      ...over,
+    }
+  }
+
+  const snap: ProjectSnapshot = {
+    issues: [
+      issue({ number: 2, title: 'ChangeSource', labels: ['est/3d', 'p/1'] }),
+      issue({ number: 3, title: 'SQLite cache', labels: ['est/2d', 'p/1'] }),
+      issue({ number: 9, title: 'Done thing', state: 'closed', labels: ['est/2d'], closedAt: '2026-01-12T09:00:00Z' }),
+    ],
+    timelines: { 9: [{ type: 'commit', at: '2026-01-07T09:00:00Z' }, { type: 'close', at: '2026-01-12T09:00:00Z' }] },
+    deps: [{ issue: 3, dependsOn: 2 }],
+  }
+
+  it('focus returns Now/Next/Later grounded in the scheduler', () => {
+    const v = buildProjectView('focus', undefined, snap, asOf) as {
+      now: { issue: number } | null
+      openCount: number
+    }
+    expect(v.now?.issue).toBe(2) // #3 depends on #2, so #2 comes first
+    expect(v.openCount).toBe(2)
+  })
+
+  it('board groups issues by lifecycle column', () => {
+    const v = buildProjectView('board', undefined, snap, asOf) as {
+      columns: { column: string; count: number }[]
+    }
+    const done = v.columns.find((c) => c.column === 'done')
+    expect(done?.count).toBe(1) // #9
+    const triage = v.columns.find((c) => c.column === 'triage')
+    expect(triage?.count).toBe(2) // #2, #3 labelled, no commits yet
+  })
+
+  it('calibration reports n + cold-start honestly', () => {
+    const v = buildProjectView('calibration', undefined, snap, asOf) as { n: number; coldStart: boolean }
+    expect(v.n).toBe(1) // one closed, estimated, with an actual
+    expect(v.coldStart).toBe(true)
+  })
+
+  it('issue returns intent + derived for a specific id', () => {
+    const v = buildProjectView('issue', { issueId: 3 }, snap, asOf) as {
+      issue: number
+      blockedBy: number[]
+    }
+    expect(v.issue).toBe(3)
+    expect(v.blockedBy).toEqual([2])
+  })
+
+  it('search matches title/labels', () => {
+    const v = buildProjectView('search', { query: 'sqlite' }, snap, asOf) as { results: { issue: number }[] }
+    expect(v.results.map((r) => r.issue)).toEqual([3])
+  })
+
+  it('unbuilt views return a notImplemented marker, not fabricated data', () => {
+    expect(buildProjectView('milestone', undefined, snap, asOf)).toEqual({ notImplemented: 'milestone' })
+    expect(buildProjectView('runway', undefined, snap, asOf)).toEqual({ notImplemented: 'runway' })
+  })
+})

packages/core/src/agent/capture-work.test.ts

@@ -0,0 +1,65 @@
+import { describe, expect, it } from 'vitest'
+
+import type { CompletionResult } from './chat-client.js'
+import { captureWork, parseCaptureArgs } from './capture-work.js'
+
+describe('parseCaptureArgs', () => {
+  it('validates issues and keeps only real titles + valid labels', () => {
+    const p = parseCaptureArgs({
+      issues: [
+        { title: 'Fix token refresh', body: 'dies silently', estimate: 'est/2d', priority: 'p/1' },
+        { title: '  ', body: 'blank title dropped' },
+        { title: 'Docs', estimate: 'est/9d', priority: 'urgent' }, // invalid labels → dropped to undefined
+      ],
+      consequence: 'Beta slips a day',
+    })
+    expect(p.issues).toHaveLength(2)
+    expect(p.issues[0]).toEqual({ title: 'Fix token refresh', body: 'dies silently', estimate: 'est/2d', priority: 'p/1' })
+    expect(p.issues[1]).toEqual({ title: 'Docs', body: '', estimate: undefined, priority: undefined })
+    expect(p.consequence).toBe('Beta slips a day')
+  })
+
+  it('tolerates a missing/!array issues field', () => {
+    expect(parseCaptureArgs({}).issues).toEqual([])
+    expect(parseCaptureArgs({ issues: 'nope' }).issues).toEqual([])
+  })
+})
+
+describe('captureWork', () => {
+  it('forces propose_issues and returns the validated set', async () => {
+    const result: CompletionResult = {
+      content: '',
+      toolCalls: [
+        {
+          id: 'c1',
+          name: 'propose_issues',
+          arguments: JSON.stringify({
+            issues: [{ title: 'Retry token refresh with backoff', body: '', estimate: 'est/2d', priority: 'p/2' }],
+            consequence: 'no material shift',
+          }),
+        },
+      ],
+    }
+    let sawTool = ''
+    const proposal = await captureWork(async (_m, tools) => {
+      sawTool = tools?.[0]?.name ?? ''
+      return result
+    }, 'auth is flaky, token refresh dies')
+    expect(sawTool).toBe('propose_issues')
+    expect(proposal.issues[0].title).toBe('Retry token refresh with backoff')
+    expect(proposal.consequence).toBe('no material shift')
+  })
+
+  it('returns an empty set when the model answers without the tool', async () => {
+    const proposal = await captureWork(async () => ({ content: 'I need more detail.', toolCalls: [] }), 'vague')
+    expect(proposal.issues).toEqual([])
+  })
+
+  it('survives malformed tool arguments', async () => {
+    const proposal = await captureWork(
+      async () => ({ content: '', toolCalls: [{ id: 'c1', name: 'propose_issues', arguments: '{not json' }] }),
+      'x',
+    )
+    expect(proposal.issues).toEqual([])
+  })
+})

packages/core/src/agent/capture-work.ts

@@ -0,0 +1,109 @@
+/**
+ * capture_work — braindump → a small set of concrete issues. This is the one
+ * place the big model earns its keep (decomposition + estimate negotiation).
+ * It returns a *proposal*; nothing is filed until the human approves it in the
+ * Capture tray and it goes through the create-issue write path. Pure
+ * orchestration over an injected `complete` — stubbable, so it's testable offline.
+ */
+
+import {
+  type EstimateLabel,
+  ESTIMATE_LABELS,
+  type PriorityLabel,
+  PRIORITY_LABELS,
+} from '../labels/label-schema.js'
+import type { ChatMessage, CompletionResult, ToolDecl } from './chat-client.js'
+
+export interface ProposedIssue {
+  title: string
+  body: string
+  estimate?: EstimateLabel
+  priority?: PriorityLabel
+}
+
+export interface CaptureProposal {
+  issues: ProposedIssue[]
+  /** One-line schedule impact, if the model offered one. */
+  consequence?: string
+}
+
+export const PROPOSE_ISSUES_TOOL: ToolDecl = {
+  name: 'propose_issues',
+  description: 'Return the decomposed issue set for a braindump. Call this exactly once.',
+  parameters: {
+    type: 'object',
+    properties: {
+      issues: {
+        type: 'array',
+        items: {
+          type: 'object',
+          properties: {
+            title: { type: 'string', description: 'a clear imperative title' },
+            body: { type: 'string', description: 'one or two lines of detail' },
+            estimate: { type: 'string', enum: ['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d'] },
+            priority: { type: 'string', enum: ['p/1', 'p/2', 'p/3', 'p/4'] },
+          },
+          required: ['title'],
+        },
+      },
+      consequence: { type: 'string', description: 'one-line note on the schedule impact' },
+    },
+    required: ['issues'],
+  },
+}
+
+export const CAPTURE_SYSTEM = [
+  'You are Reginald, decomposing a rough braindump into a small set of concrete Gitea issues.',
+  'Call propose_issues exactly once. Split genuinely separate work; merge trivially-coupled work; invent no scope.',
+  'Each issue gets an imperative title, a one-line body, an estimate (est/1d…8d) and a priority (p/1…4).',
+  'Estimate honestly — a "quick" task is rarely one day. Keep the set tight; three good issues beat eight vague ones.',
+].join(' ')
+
+function isEstimate(v: unknown): v is EstimateLabel {
+  return typeof v === 'string' && (ESTIMATE_LABELS as readonly string[]).includes(v)
+}
+function isPriority(v: unknown): v is PriorityLabel {
+  return typeof v === 'string' && (PRIORITY_LABELS as readonly string[]).includes(v)
+}
+
+/** Coerce the model's raw propose_issues args into a validated proposal. */
+export function parseCaptureArgs(args: unknown): CaptureProposal {
+  const a = (args ?? {}) as { issues?: unknown[]; consequence?: unknown }
+  const issues: ProposedIssue[] = []
+  for (const raw of Array.isArray(a.issues) ? a.issues : []) {
+    const r = (raw ?? {}) as Record<string, unknown>
+    const title = typeof r.title === 'string' ? r.title.trim() : ''
+    if (!title) continue
+    issues.push({
+      title,
+      body: typeof r.body === 'string' ? r.body : '',
+      estimate: isEstimate(r.estimate) ? r.estimate : undefined,
+      priority: isPriority(r.priority) ? r.priority : undefined,
+    })
+  }
+  return { issues, consequence: typeof a.consequence === 'string' ? a.consequence : undefined }
+}
+
+/**
+ * Run one decomposition turn. Forces the model to answer via propose_issues and
+ * returns the validated set. An empty set means the model declined to structure it.
+ */
+export async function captureWork(
+  complete: (messages: ChatMessage[], tools?: ToolDecl[]) => Promise<CompletionResult>,
+  braindump: string,
+): Promise<CaptureProposal> {
+  const res = await complete(
+    [
+      { role: 'system', content: CAPTURE_SYSTEM },
+      { role: 'user', content: braindump },
+    ],
+    [PROPOSE_ISSUES_TOOL],
+  )
+  const call = res.toolCalls.find((t) => t.name === 'propose_issues')
+  if (!call) return { issues: [] }
+  try {
+    return parseCaptureArgs(JSON.parse(call.arguments || '{}'))
+  } catch {
+    return { issues: [] }
+  }
+}

packages/core/src/agent/chat-client.ts

@@ -0,0 +1,184 @@
+/**
+ * Reginald's model client — a thin OpenAI-wire chat-completions client over an
+ * injected fetch (the same seam the gitea client uses). `@commitea/core` stays
+ * pure: no network, no globals. The desktop main process passes the real
+ * `fetch`; tests pass a stub. Points at any OpenAI-compatible endpoint (LM
+ * Studio, Ollama, the OpenAI API) — the model router picks which.
+ */
+
+import type { FetchLike } from '../gitea/types.js'
+
+/** Where a model lives + which model to ask for. */
+export interface ModelConfig {
+  /** OpenAI-compatible base, including the version segment, e.g. `http://localhost:1234/v1`. */
+  baseUrl: string
+  model: string
+  /** Bearer key; omitted for local servers that don't check it. */
+  apiKey?: string
+}
+
+/** A model's request to run a tool. `arguments` is a raw JSON string (OpenAI shape). */
+export interface ToolCall {
+  id: string
+  name: string
+  arguments: string
+}
+
+/** One turn in the conversation, in our normalized shape. */
+export interface ChatMessage {
+  role: 'system' | 'user' | 'assistant' | 'tool'
+  content: string
+  /** assistant turns that requested tools. */
+  toolCalls?: ToolCall[]
+  /** tool turns: which call they answer. */
+  toolCallId?: string
+  /** tool turns: the function name. */
+  name?: string
+}
+
+/** A tool the model may call — name, description, and a JSON-Schema parameter spec. */
+export interface ToolDecl {
+  name: string
+  description: string
+  parameters: object
+}
+
+export interface CompletionResult {
+  content: string
+  toolCalls: ToolCall[]
+}
+
+/** Called with each streamed content delta (final-prose streaming). */
+export type OnToken = (delta: string) => void
+
+export interface ChatClient {
+  /** When `onToken` is given, the response streams (SSE) and each content delta is emitted. */
+  complete(messages: ChatMessage[], tools?: ToolDecl[], onToken?: OnToken): Promise<CompletionResult>
+}
+
+/** Map our message shape to the OpenAI wire shape. */
+function toWireMessage(m: ChatMessage): Record<string, unknown> {
+  if (m.role === 'assistant' && m.toolCalls?.length) {
+    return {
+      role: 'assistant',
+      content: m.content || null,
+      tool_calls: m.toolCalls.map((tc) => ({
+        id: tc.id,
+        type: 'function',
+        function: { name: tc.name, arguments: tc.arguments },
+      })),
+    }
+  }
+  if (m.role === 'tool') {
+    return { role: 'tool', tool_call_id: m.toolCallId, content: m.content }
+  }
+  return { role: m.role, content: m.content }
+}
+
+function toWireTool(t: ToolDecl): Record<string, unknown> {
+  return { type: 'function', function: { name: t.name, description: t.description, parameters: t.parameters } }
+}
+
+/** Shape of the one choice we read back. */
+interface RawChoiceMessage {
+  content: string | null
+  tool_calls?: { id: string; function: { name: string; arguments: string } }[]
+}
+
+export function createChatClient(config: ModelConfig, fetchImpl: FetchLike): ChatClient {
+  const url = `${config.baseUrl.replace(/\/+$/, '')}/chat/completions`
+
+  return {
+    async complete(messages, tools, onToken) {
+      const body: Record<string, unknown> = {
+        model: config.model,
+        messages: messages.map(toWireMessage),
+        temperature: 0,
+      }
+      if (tools?.length) {
+        body.tools = tools.map(toWireTool)
+        body.tool_choice = 'auto'
+      }
+      const stream = !!onToken
+      if (stream) body.stream = true
+      const res = await fetchImpl(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: stream ? 'text/event-stream' : 'application/json',
+          ...(config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}),
+        },
+        body: JSON.stringify(body),
+      })
+      if (!res.ok) {
+        const text = await res.text().catch(() => '')
+        throw new Error(`model completion failed (${res.status}): ${text.slice(0, 200)}`)
+      }
+      if (stream && res.body) return readStream(res.body, onToken!)
+
+      const json = (await res.json()) as { choices?: { message: RawChoiceMessage }[] }
+      const msg = json.choices?.[0]?.message
+      return {
+        content: msg?.content ?? '',
+        toolCalls: (msg?.tool_calls ?? []).map((tc) => ({
+          id: tc.id,
+          name: tc.function.name,
+          arguments: tc.function.arguments,
+        })),
+      }
+    },
+  }
+}
+
+/** Streamed tool-call delta: name arrives first, arguments accumulate across chunks. */
+interface RawToolDelta {
+  index: number
+  id?: string
+  function?: { name?: string; arguments?: string }
+}
+
+/** Parse an OpenAI SSE stream: emit content deltas via onToken, accumulate the final result. */
+async function readStream(body: ReadableStream<Uint8Array>, onToken: OnToken): Promise<CompletionResult> {
+  const reader = body.getReader()
+  const decoder = new TextDecoder()
+  let buffer = ''
+  let content = ''
+  const toolAcc: { id: string; name: string; arguments: string }[] = []
+
+  const handle = (data: string) => {
+    if (data === '[DONE]') return
+    let chunk: { choices?: { delta?: { content?: string; tool_calls?: RawToolDelta[] } }[] }
+    try {
+      chunk = JSON.parse(data)
+    } catch {
+      return
+    }
+    const delta = chunk.choices?.[0]?.delta
+    if (!delta) return
+    if (delta.content) {
+      content += delta.content
+      onToken(delta.content)
+    }
+    for (const tc of delta.tool_calls ?? []) {
+      const slot = (toolAcc[tc.index] ??= { id: '', name: '', arguments: '' })
+      if (tc.id) slot.id = tc.id
+      if (tc.function?.name) slot.name = tc.function.name
+      if (tc.function?.arguments) slot.arguments += tc.function.arguments
+    }
+  }
+
+  for (;;) {
+    const { done, value } = await reader.read()
+    if (done) break
+    buffer += decoder.decode(value, { stream: true })
+    const lines = buffer.split('\n')
+    buffer = lines.pop() ?? ''
+    for (const line of lines) {
+      const t = line.trim()
+      if (t.startsWith('data:')) handle(t.slice(5).trim())
+    }
+  }
+  if (buffer.trim().startsWith('data:')) handle(buffer.trim().slice(5).trim())
+
+  return { content, toolCalls: toolAcc.filter((t) => t.name).map((t) => ({ id: t.id, name: t.name, arguments: t.arguments })) }
+}

packages/core/src/agent/memory-v0.test.ts

@@ -0,0 +1,71 @@
+import { describe, expect, it } from 'vitest'
+
+import type { DirectiveEntry } from '../directives/record-directive-v0.js'
+import type { Focus, ScheduledItem } from '../scheduler/scheduler-v0.js'
+import {
+  activeDirectives,
+  assembleHotContext,
+  estimateTokens,
+  HOT_CONTEXT_BUDGET_TOKENS,
+} from './memory-v0.js'
+
+const item = (number: number, title: string): ScheduledItem =>
+  ({ number, title, labels: [], order: 0, startDay: 0, endDay: 1, durationDays: 1, blockedBy: [], blocks: [], critical: false, rationale: '' })
+
+const focus: Focus = { now: item(7, 'Fix lifecycle inference'), next: item(8, 'Webhook listener'), later: null }
+
+const directive = (over: Partial<DirectiveEntry>): DirectiveEntry => ({
+  id: 'd1',
+  ts: '2026-02-10T09:00:00Z',
+  status: 'accepted',
+  kind: 'note',
+  quote: 'pilots come first',
+  ...over,
+})
+
+describe('memory-v0 (#27)', () => {
+  it('estimateTokens is a slight over-estimate (~4 chars/token)', () => {
+    expect(estimateTokens('')).toBe(0)
+    expect(estimateTokens('abcd')).toBe(1)
+    expect(estimateTokens('a'.repeat(4001))).toBe(1001)
+  })
+
+  it('activeDirectives keeps accepted/amended, most-recent-first', () => {
+    const ds = [
+      directive({ id: 'a', ts: '2026-02-01T00:00:00Z', status: 'accepted', quote: 'old' }),
+      directive({ id: 'b', ts: '2026-02-11T00:00:00Z', status: 'amended', quote: 'new' }),
+      directive({ id: 'c', ts: '2026-02-12T00:00:00Z', status: 'withdrawn', quote: 'gone' }),
+      directive({ id: 'd', ts: '2026-02-09T00:00:00Z', status: 'proposed', quote: 'maybe' }),
+    ]
+    expect(activeDirectives(ds).map((d) => d.quote)).toEqual(['new', 'old'])
+  })
+
+  it('assembles hot context under the 2k budget even with a huge charter', () => {
+    const huge = 'Charter line that goes on and on. '.repeat(2000) // ~34k tokens
+    const ds = Array.from({ length: 50 }, (_, i) =>
+      directive({ id: `d${i}`, ts: `2026-02-${String((i % 27) + 1).padStart(2, '0')}T00:00:00Z`, quote: `directive number ${i}` }),
+    )
+    const out = assembleHotContext({ charter: huge, directives: ds, focus })
+
+    expect(estimateTokens(out)).toBeLessThanOrEqual(HOT_CONTEXT_BUDGET_TOKENS)
+    // focus (tiny) is always kept; the charter is the part that gets truncated
+    expect(out).toContain('## Focus')
+    expect(out).toContain('#7 Fix lifecycle inference')
+    expect(out).toContain('…') // charter was clamped
+    // at least some recent directives survived
+    expect(out).toContain('## Active directives')
+  })
+
+  it('never inlines ticket bodies — only numbers + titles appear for focus', () => {
+    // The assembler takes no issue bodies by construction; focus shows #number title only.
+    const out = assembleHotContext({ charter: 'Ship the beta.', directives: [directive({})], focus })
+    expect(out).toContain('Now: #7 Fix lifecycle inference')
+    expect(out).toContain('[note] pilots come first')
+    expect(out).not.toMatch(/body|description|comment/i)
+  })
+
+  it('degrades to just focus when there is no charter or directives', () => {
+    const out = assembleHotContext({ charter: '', directives: [], focus })
+    expect(out).toBe(['## Focus', 'Now: #7 Fix lifecycle inference', 'Next: #8 Webhook listener', 'Later: —'].join('\n'))
+  })
+})

packages/core/src/agent/memory-v0.ts

@@ -0,0 +1,102 @@
+/**
+ * Memory layers, v0 (#27). Reginald's context is tiered so the model always sees
+ * what matters without ever copying ticket data into the prompt:
+ *
+ * - HOT (this module) — charter + active directives + the focus snapshot, packed
+ *   under a hard token budget. Assembled fresh each turn; it's the system-prompt seed.
+ * - WARM — the append-only directive/event ledger + periodic digest, in pm-state.
+ *   Not inlined; summarized on demand.
+ * - COLD — gitea + the sidecar, reached through `query_project` tools. Ticket bodies,
+ *   comments, and per-issue detail live here and are NEVER copied into memory —
+ *   the model fetches them by number when it needs them.
+ *
+ * The invariant: HOT stays under budget, and nothing ticket-shaped is inlined.
+ */
+
+import type { DirectiveEntry } from '../directives/record-directive-v0.js'
+import type { Focus } from '../scheduler/scheduler-v0.js'
+
+/** The hot layer's hard ceiling (#27: hot context assembles under 2k tokens). */
+export const HOT_CONTEXT_BUDGET_TOKENS = 2000
+
+/**
+ * Tokenizer-free estimate (~4 chars/token). Deliberately a slight over-estimate so
+ * a real tokenizer never exceeds what this predicts — the budget stays safe.
+ */
+export function estimateTokens(text: string): number {
+  return Math.ceil(text.length / 4)
+}
+
+/** Directives that still bind: accepted or amended, most-recent-first. */
+export function activeDirectives(all: DirectiveEntry[]): DirectiveEntry[] {
+  return all
+    .filter((d) => d.status === 'accepted' || d.status === 'amended')
+    .slice()
+    .sort((a, b) => (a.ts < b.ts ? 1 : a.ts > b.ts ? -1 : 0))
+}
+
+export interface HotContextInputs {
+  /** The project charter markdown (hot-memory seed). */
+  charter: string
+  /** The directive ledger (any status — filtered to active here). */
+  directives: DirectiveEntry[]
+  /** The current Now/Next/Later focus, or null when nothing is scheduled. */
+  focus: Focus | null
+}
+
+function focusBlock(focus: Focus | null): string {
+  if (!focus) return ''
+  const slot = (label: string, item: Focus['now']) => (item ? `${label}: #${item.number} ${item.title}` : `${label}: —`)
+  return ['## Focus', slot('Now', focus.now), slot('Next', focus.next), slot('Later', focus.later)].join('\n')
+}
+
+function directivesBlock(directives: DirectiveEntry[]): string[] {
+  // one compact line each; the verbatim quote is the payload, kind is the tag
+  return directives.map((d) => `- [${d.kind}] ${d.quote}`)
+}
+
+/** Truncate to a token budget on a whitespace boundary, with an ellipsis marker. */
+function clampToTokens(text: string, budgetTokens: number): string {
+  if (estimateTokens(text) <= budgetTokens) return text
+  const maxChars = Math.max(0, budgetTokens * 4 - 1)
+  const cut = text.slice(0, maxChars)
+  const lastBreak = cut.lastIndexOf('\n')
+  return `${(lastBreak > maxChars * 0.6 ? cut.slice(0, lastBreak) : cut).trimEnd()}\n…`
+}
+
+/**
+ * Assemble the HOT context under `budget` tokens. Priority when space is tight:
+ * the focus snapshot (tiny, always kept) → the most recent active directives
+ * (each while they fit) → the charter fills whatever budget remains (truncated).
+ * Never inlines ticket bodies — only charter text, directive quotes, and focus
+ * titles, all authored/short. Returns a single prompt-ready block.
+ */
+export function assembleHotContext(inputs: HotContextInputs, budget = HOT_CONTEXT_BUDGET_TOKENS): string {
+  const focus = focusBlock(inputs.focus)
+  const focusTokens = focus ? estimateTokens(focus) : 0
+
+  // fit the most recent active directives into ~⅔ of what's left after focus
+  const active = activeDirectives(inputs.directives)
+  const directiveCap = Math.max(0, Math.floor((budget - focusTokens) * (2 / 3)))
+  const keptDirectives: string[] = []
+  let directiveTokens = 0
+  for (const line of directivesBlock(active)) {
+    const t = estimateTokens(line) + 1
+    if (directiveTokens + t > directiveCap) break
+    keptDirectives.push(line)
+    directiveTokens += t
+  }
+  const directives = keptDirectives.length ? ['## Active directives', ...keptDirectives].join('\n') : ''
+
+  // Measure the fixed tail (directives + focus, with their joiner) exactly, then
+  // give the charter the true remainder — reserving for the "## Charter" header,
+  // the block joiner, and the truncation ellipsis so the total never exceeds budget.
+  const tail = [directives, focus].filter(Boolean).join('\n\n')
+  const tailTokens = tail ? estimateTokens(tail) : 0
+  const reserve = estimateTokens(`## Charter\n${tail ? '\n\n' : ''}\n…`)
+  const charterBudget = Math.max(0, budget - tailTokens - reserve)
+  const charterBody = inputs.charter.trim() ? clampToTokens(inputs.charter.trim(), charterBudget) : ''
+  const charter = charterBody ? `## Charter\n${charterBody}` : ''
+
+  return [charter, tail].filter(Boolean).join('\n\n')
+}

packages/core/src/agent/model-router.ts

@@ -0,0 +1,22 @@
+/**
+ * Model router (per PLAN.md / decisions.md): prose + the read tool run on a
+ * small local model; decomposition/negotiation earns the big one. Reginald v0
+ * only exercises the small model (read + prose); the `big` slot is declared so
+ * `capture_work` / `record_directive` can route to it without a rewrite.
+ */
+
+import type { ModelConfig } from './chat-client.js'
+
+export type TaskKind = 'ritual' | 'plan'
+
+export interface ModelRouter {
+  /** Small local model — standups, focus prose, the read tool. */
+  small: ModelConfig
+  /** Big model — capture decomposition, directive negotiation. */
+  big: ModelConfig
+}
+
+/** `plan` → the big model; everything else → the small one. */
+export function pickModel(router: ModelRouter, kind: TaskKind): ModelConfig {
+  return kind === 'plan' ? router.big : router.small
+}

packages/core/src/agent/query-project.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, it } from 'vitest'
+
+import { extractLabelFacts } from '../labels/label-schema.js'
+import type { LifecycleEvent } from '../lifecycle/lifecycle-v0.js'
+import type { GiteaIssue } from '../gitea/types.js'
+import { buildProjectView, type ProjectSnapshot } from './query-project.js'
+
+const asOf = new Date('2026-02-12T00:00:00Z')
+
+function issue(over: Partial<GiteaIssue>): GiteaIssue {
+  const labels = over.labels ?? ['est/2d']
+  return {
+    number: 1,
+    title: '#1',
+    body: '',
+    state: 'open',
+    labels,
+    facts: extractLabelFacts(labels),
+    milestone: null,
+    assignee: null,
+    assignees: [],
+    createdAt: '2026-02-02T09:00:00Z',
+    updatedAt: '2026-02-02T09:00:00Z',
+    closedAt: null,
+    url: '',
+    ...over,
+  }
+}
+
+describe('buildProjectView: standup (#28)', () => {
+  it('surfaces schedule drift + a stale blocker, with a per-person plan', () => {
+    // #7 started work 6 working days ago (steeping) and blocks #8; est is 2d → past estimate.
+    const steeping = issue({ number: 7, labels: ['est/2d', 'p/1'], assignee: 'christian' })
+    const blocked = issue({ number: 8, labels: ['est/3d', 'p/2'], assignee: 'stephen' })
+    const timelines: Record<number, LifecycleEvent[]> = {
+      7: [{ type: 'commit', at: '2026-02-04T09:00:00Z' }],
+    }
+    const snap: ProjectSnapshot = { issues: [steeping, blocked], timelines, deps: [{ issue: 8, dependsOn: 7 }] }
+
+    const v = buildProjectView('standup', undefined, snap, asOf) as {
+      plan: { who: string; issue: number; why: string }[]
+      drift: { issue: number; note: string }[]
+      nag: { issue: number; steepingDays: number; blocks: number[] } | null
+    }
+
+    // a stale blocker is nagged, and it's the steeping one that blocks another
+    expect(v.nag).not.toBeNull()
+    expect(v.nag!.issue).toBe(7)
+    expect(v.nag!.steepingDays).toBeGreaterThan(0)
+    expect(v.nag!.blocks).toContain(8)
+
+    // drift caught the past-estimate steep
+    expect(v.drift.some((d) => d.issue === 7)).toBe(true)
+
+    // plan gives an earliest pick per person (both assignees represented)
+    expect(v.plan.map((p) => p.who)).toEqual(expect.arrayContaining(['christian', 'stephen']))
+    // #7 leads its person's plan on the critical path
+    expect(v.plan.find((p) => p.issue === 7)?.why).toContain('critical')
+  })
+
+  it('is calm when nothing is steeping (no nag, empty drift)', () => {
+    const snap: ProjectSnapshot = {
+      issues: [issue({ number: 1, labels: ['est/2d'] })],
+      timelines: {},
+      deps: [],
+    }
+    const v = buildProjectView('standup', undefined, snap, asOf) as {
+      drift: unknown[]
+      nag: unknown | null
+    }
+    expect(v.nag).toBeNull()
+    expect(v.drift).toEqual([])
+  })
+})

packages/core/src/agent/query-project.ts

@@ -0,0 +1,204 @@
+/**
+ * `query_project` — Reginald's single read tool. It selects a compact,
+ * model-friendly view over the reconciled backlog. Every number comes from
+ * deterministic code (scheduler, lifecycle inference, calibration); the model
+ * only requests a shape and narrates it — it never computes (decisions.md).
+ *
+ * Serves focus / board / calibration / issue / search / standup. The remaining
+ * views (milestone / runway) return a `notImplemented` marker so the model
+ * degrades honestly instead of inventing data.
+ */
+
+import { fitCalibration, calibrationSamples } from '../calibration/calibration-v0.js'
+import type { GiteaIssue } from '../gitea/types.js'
+import { inferLifecycle, type LifecycleColumn, type LifecycleEvent } from '../lifecycle/lifecycle-v0.js'
+import { type DependencyEdge, schedule, selectFocus } from '../scheduler/scheduler-v0.js'
+
+export type ProjectView =
+  | 'focus'
+  | 'board'
+  | 'calibration'
+  | 'issue'
+  | 'milestone'
+  | 'runway'
+  | 'standup'
+  | 'search'
+
+export interface QueryFilters {
+  issueId?: number
+  query?: string
+  limit?: number
+}
+
+/** The reconciled inputs a view is built from. */
+export interface ProjectSnapshot {
+  issues: GiteaIssue[]
+  timelines: Record<number, LifecycleEvent[]>
+  deps: DependencyEdge[]
+}
+
+const COLUMN_ORDER: LifecycleColumn[] = ['diagnosis', 'triage', 'steeping', 'review', 'done']
+
+function toSchedulable(issues: GiteaIssue[]) {
+  return issues
+    .filter((i) => i.state === 'open')
+    .map((i) => ({
+      number: i.number,
+      title: i.title,
+      labels: i.labels,
+      estimateDays: i.facts.estimateDays,
+      priority: i.facts.priority,
+    }))
+}
+
+function focusView(snap: ProjectSnapshot) {
+  const plan = schedule(toSchedulable(snap.issues), snap.deps)
+  const f = selectFocus(plan)
+  const slot = (item: (typeof plan.items)[number] | null) =>
+    item ? { issue: item.number, title: item.title, rationale: item.rationale } : null
+  return { now: slot(f.now), next: slot(f.next), later: slot(f.later), openCount: plan.items.length }
+}
+
+function boardView(snap: ProjectSnapshot, asOf: Date) {
+  const columns: Record<string, { issue: number; title: string; labels: string[] }[]> = {}
+  for (const key of COLUMN_ORDER) columns[key] = []
+  for (const issue of snap.issues) {
+    const inf = inferLifecycle(issue, snap.timelines[issue.number] ?? [], asOf)
+    columns[inf.column].push({ issue: issue.number, title: issue.title, labels: issue.labels })
+  }
+  return {
+    columns: COLUMN_ORDER.map((key) => ({ column: key, count: columns[key].length, issues: columns[key] })),
+  }
+}
+
+function calibrationView(snap: ProjectSnapshot, asOf: Date) {
+  const model = fitCalibration(calibrationSamples(snap.issues, snap.timelines, asOf))
+  return {
+    n: model.n,
+    coldStart: model.coldStart,
+    globalMultiplier: Number(Math.exp(model.global.mu).toFixed(2)),
+    byBucket: Object.entries(model.byBucket).map(([bucket, fit]) => ({
+      estimate: `est/${bucket}d`,
+      n: fit.n,
+      multiplier: Number(Math.exp(fit.mu).toFixed(2)),
+    })),
+  }
+}
+
+function issueView(snap: ProjectSnapshot, filters: QueryFilters, asOf: Date) {
+  const issue = snap.issues.find((i) => i.number === filters.issueId)
+  if (!issue) return { notFound: filters.issueId ?? null }
+  const inf = inferLifecycle(issue, snap.timelines[issue.number] ?? [], asOf)
+  const blockedBy = snap.deps.filter((d) => d.issue === issue.number).map((d) => d.dependsOn)
+  const blocks = snap.deps.filter((d) => d.dependsOn === issue.number).map((d) => d.issue)
+  return {
+    issue: issue.number,
+    title: issue.title,
+    state: issue.state,
+    column: inf.column,
+    labels: issue.labels,
+    assignee: issue.assignee,
+    milestone: issue.milestone?.title ?? null,
+    estimateDays: issue.facts.estimateDays,
+    priority: issue.facts.priority,
+    steepingDays: inf.steepingDays,
+    blockedBy,
+    blocks,
+  }
+}
+
+function searchView(snap: ProjectSnapshot, filters: QueryFilters) {
+  const q = (filters.query ?? '').toLowerCase().trim()
+  const limit = Math.min(filters.limit ?? 20, 100)
+  const hits = q
+    ? snap.issues.filter(
+        (i) => i.title.toLowerCase().includes(q) || i.labels.some((l) => l.toLowerCase().includes(q)),
+      )
+    : []
+  return {
+    query: filters.query ?? '',
+    results: hits.slice(0, limit).map((i) => ({ issue: i.number, title: i.title, state: i.state, labels: i.labels })),
+  }
+}
+
+/**
+ * Standup — the morning ritual as a compact, model-narratable payload: today's
+ * plan (the scheduler's earliest pick per person), overnight drift (real
+ * anomalies — issues sitting in review or steeping past their estimate), and the
+ * single stalest blocker to nag about. All from deterministic code; the model
+ * narrates it. Satisfies #28's "surfaces schedule drift + at least one stale blocker".
+ */
+function standupView(snap: ProjectSnapshot, asOf: Date) {
+  const plan = schedule(toSchedulable(snap.issues), snap.deps)
+  const open = snap.issues.filter((i) => i.state === 'open')
+  const infOf = (i: GiteaIssue) => inferLifecycle(i, snap.timelines[i.number] ?? [], asOf)
+
+  // plan: the earliest scheduled pick per assignee (dependency + priority order)
+  const seen = new Set<string>()
+  const planPicks: { who: string; issue: number; title: string; why: string }[] = []
+  for (const item of plan.items) {
+    const who = open.find((i) => i.number === item.number)?.assignee ?? 'unassigned'
+    if (seen.has(who)) continue
+    seen.add(who)
+    planPicks.push({
+      who,
+      issue: item.number,
+      title: item.title,
+      why: item.critical
+        ? 'on the critical path'
+        : item.blocks.length
+          ? `blocks ${item.blocks.map((b) => `#${b}`).join(', ')}`
+          : 'next by dependency + priority',
+    })
+  }
+
+  // drift: real overnight anomalies (review-sitting, steeping past estimate)
+  const drift: { issue: number; note: string }[] = []
+  for (const i of open) {
+    const inf = infOf(i)
+    if (inf.column === 'review') drift.push({ issue: i.number, note: `#${i.number} is sitting in review` })
+    else if (inf.steepingDays != null && inf.steepingDays > (i.facts.estimateDays ?? 2))
+      drift.push({
+        issue: i.number,
+        note: `#${i.number} has steeped ${inf.steepingDays}d past its ${i.facts.estimateDays ?? 2}d estimate`,
+      })
+  }
+
+  // nag: the single longest-steeping open issue + what it blocks
+  let nag: { issue: number; steepingDays: number; blocks: number[] } | null = null
+  for (const i of open) {
+    const inf = infOf(i)
+    if (inf.steepingDays == null) continue
+    if (!nag || inf.steepingDays > nag.steepingDays) {
+      nag = { issue: i.number, steepingDays: inf.steepingDays, blocks: plan.items.find((it) => it.number === i.number)?.blocks ?? [] }
+    }
+  }
+
+  return { date: asOf.toISOString().slice(0, 10), plan: planPicks.slice(0, 5), drift: drift.slice(0, 5), nag }
+}
+
+/** Build the compact payload for one view. Unknown/unbuilt views return a marker. */
+export function buildProjectView(
+  view: ProjectView,
+  filters: QueryFilters | undefined,
+  snap: ProjectSnapshot,
+  asOf: Date,
+): unknown {
+  const f = filters ?? {}
+  switch (view) {
+    case 'focus':
+      return focusView(snap)
+    case 'board':
+      return boardView(snap, asOf)
+    case 'calibration':
+      return calibrationView(snap, asOf)
+    case 'issue':
+      return issueView(snap, f, asOf)
+    case 'search':
+      return searchView(snap, f)
+    case 'standup':
+      return standupView(snap, asOf)
+    default:
+      return { notImplemented: view }
+  }
+}

packages/core/src/cache/cache-purity-v0.test.ts

@@ -0,0 +1,191 @@
+/**
+ * Purity / rebuild guarantee (#30, D4). The SQLite cache is a *rebuildable index*
+ * over the durable truth in gitea — never a source of truth. This test enforces
+ * that invariant the only way that matters: nuke the database file on disk and
+ * rebuild it from the same gitea snapshot, then assert nothing was lost.
+ *
+ * If a future change ever stores a fact that lives only in the cache (a
+ * user-authored note, a locally-computed field that isn't re-derived from the
+ * label set), the delete→resync round-trip would drop it and this test fails.
+ * That is the whole point: the cache must survive being deleted.
+ *
+ * Uses a real on-disk SQLite file via node:sqlite (present in the test runtime;
+ * main binds better-sqlite3 to the same CacheDriver seam), so "delete the SQLite
+ * file" is literal `rm`, not a metaphor.
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { mkdtempSync, existsSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+import { afterEach, describe, expect, it } from 'vitest'
+
+import type { GiteaIssue } from '../gitea/types.js'
+import { extractLabelFacts } from '../labels/label-schema.js'
+import { type CacheDriver, initCache, readIssue, upsertIssue } from './cache-v0.js'
+
+/** Adapt a file-backed node:sqlite handle to the CacheDriver seam, returning the path too. */
+function fileDriver(path: string): { driver: CacheDriver; close: () => void } {
+  const db = new DatabaseSync(path)
+  const driver: CacheDriver = {
+    exec: (sql) => db.exec(sql),
+    run: (sql, params = []) => {
+      db.prepare(sql).run(...(params as never[]))
+    },
+    get: (sql, params = []) => db.prepare(sql).get(...(params as never[])) as Record<string, unknown> | undefined,
+    all: (sql, params = []) => db.prepare(sql).all(...(params as never[])) as Record<string, unknown>[],
+  }
+  return { driver, close: () => db.close() }
+}
+
+function issue(over: Partial<GiteaIssue> = {}): GiteaIssue {
+  const labels = over.labels ?? ['est/5d', 'p/1']
+  return {
+    number: 1,
+    title: 'An issue',
+    body: 'body',
+    state: 'open',
+    labels,
+    facts: extractLabelFacts(labels),
+    milestone: null,
+    assignee: 'christian',
+    assignees: ['christian'],
+    createdAt: '2026-07-01T00:00:00Z',
+    updatedAt: '2026-07-02T00:00:00Z',
+    closedAt: null,
+    url: 'https://gitea/christian/commitea/issues/1',
+    ...over,
+  }
+}
+
+/** A representative reconciled backlog: open + closed, milestones, reassignment, no-milestone, empty labels. */
+const GITEA_TRUTH: GiteaIssue[] = [
+  issue({
+    number: 42,
+    title: 'Monte Carlo engine',
+    labels: ['est/8d', 'p/1', 'deadline/hard'],
+    milestone: { id: 7, title: 'P2 — Scheduler', dueOn: '2026-09-01T00:00:00Z' },
+    assignee: 'christian',
+    assignees: ['christian'],
+  }),
+  issue({
+    number: 43,
+    title: 'Calibration honesty',
+    labels: ['est/3d', 'p/2'],
+    state: 'closed',
+    closedAt: '2026-07-05T00:00:00Z',
+    milestone: { id: 7, title: 'P2 — Scheduler', dueOn: '2026-09-01T00:00:00Z' },
+    assignee: 'stephen',
+    assignees: ['stephen'],
+  }),
+  issue({ number: 44, title: 'No milestone, no labels', labels: [], milestone: null, assignee: null, assignees: [] }),
+]
+
+/** Rebuild a cache from scratch out of the gitea snapshot — exactly what a resync does. */
+function rebuildFrom(driver: CacheDriver, truth: GiteaIssue[]): void {
+  initCache(driver)
+  for (const i of truth) upsertIssue(driver, i)
+}
+
+/** The complete durable state we can read back — every issue, fully re-derived. */
+function readAll(driver: CacheDriver, truth: GiteaIssue[]): (GiteaIssue | null)[] {
+  return truth.map((i) => readIssue(driver, i.number))
+}
+
+describe('cache purity / rebuild (#30)', () => {
+  let dir: string | null = null
+  afterEach(() => {
+    if (dir) rmSync(dir, { recursive: true, force: true })
+    dir = null
+  })
+
+  it('delete the SQLite file → resync → no durable truth is lost', () => {
+    dir = mkdtempSync(join(tmpdir(), 'commitea-cache-'))
+    const dbPath = join(dir, 'cache.sqlite')
+
+    // 1. Build the cache from gitea and capture everything we can read back.
+    const first = fileDriver(dbPath)
+    rebuildFrom(first.driver, GITEA_TRUTH)
+    const before = readAll(first.driver, GITEA_TRUTH)
+    first.close()
+    expect(existsSync(dbPath)).toBe(true)
+    // sanity: the snapshot actually holds derived facts, not just rows
+    expect(before[0]!.facts).toEqual(extractLabelFacts(['est/8d', 'p/1', 'deadline/hard']))
+    expect(before[0]!.facts.estimateDays).toBe(8)
+
+    // 2. Delete the SQLite file. This is the durable cache, gone.
+    rmSync(dbPath)
+    // node:sqlite also drops a -journal/-wal sidecar in some modes; clear the dir of any residue.
+    expect(existsSync(dbPath)).toBe(false)
+
+    // 3. Resync: a brand-new empty DB rebuilt from the *same* gitea snapshot.
+    const second = fileDriver(dbPath)
+    rebuildFrom(second.driver, GITEA_TRUTH)
+    const after = readAll(second.driver, GITEA_TRUTH)
+    second.close()
+
+    // 4. Nothing was lost — the rebuilt cache is identical, field for field.
+    expect(after).toEqual(before)
+  })
+
+  it('a re-reconcile that changes gitea updates in place — the rebuild reflects truth, never stale rows', () => {
+    dir = mkdtempSync(join(tmpdir(), 'commitea-cache-'))
+    const dbPath = join(dir, 'cache.sqlite')
+
+    const first = fileDriver(dbPath)
+    rebuildFrom(first.driver, GITEA_TRUTH)
+    first.close()
+
+    // gitea moved on: #42 re-estimated + reassigned, #43 reopened.
+    const NEW_TRUTH: GiteaIssue[] = [
+      issue({ ...GITEA_TRUTH[0], labels: ['est/2d', 'p/3'], assignee: 'stephen', assignees: ['stephen'] }),
+      issue({ ...GITEA_TRUTH[1], state: 'open', closedAt: null }),
+      GITEA_TRUTH[2],
+    ]
+
+    // resync over the existing file (upsert-by-number), not a fresh DB
+    const second = fileDriver(dbPath)
+    initCache(second.driver)
+    for (const i of NEW_TRUTH) upsertIssue(second.driver, i)
+    const rowCount = second.driver.all('SELECT number FROM issues')
+    const back42 = readIssue(second.driver, 42)!
+    const back43 = readIssue(second.driver, 43)!
+    second.close()
+
+    expect(rowCount).toHaveLength(3) // upsert in place — no duplicate rows accreted across reconciles
+    expect(back42.facts).toEqual(extractLabelFacts(['est/2d', 'p/3']))
+    expect(back42.facts.estimateDays).toBe(2)
+    expect(back42.assignee).toBe('stephen')
+    expect(back43.state).toBe('open')
+    expect(back43.closedAt).toBeNull()
+  })
+
+  it('the cache stores no column that is not re-derivable from gitea (structural D4 guard)', () => {
+    dir = mkdtempSync(join(tmpdir(), 'commitea-cache-'))
+    const dbPath = join(dir, 'cache.sqlite')
+    const { driver, close } = fileDriver(dbPath)
+    initCache(driver)
+
+    // Every issues-table column must map to a field carried on the gitea issue
+    // (or be a re-derivable mirror of one). If someone adds a user-authored
+    // column, it won't be in this allow-list and this guard fails — forcing a
+    // deliberate decision about durability instead of silently breaking D4.
+    const cols = driver.all('PRAGMA table_info(issues)').map((r) => r.name as string)
+    const FROM_GITEA = new Set([
+      'number',
+      'title',
+      'body',
+      'state',
+      'labels', // facts are re-derived from this on read, never stored
+      'milestone_id',
+      'assignee',
+      'assignees',
+      'created_at',
+      'updated_at',
+      'closed_at',
+      'url',
+    ])
+    close()
+    expect(cols.filter((c) => !FROM_GITEA.has(c))).toEqual([])
+  })
+})

packages/core/src/cache/cache-v0.test.ts

@@ -0,0 +1,92 @@
+import { DatabaseSync } from 'node:sqlite'
+
+import { describe, expect, it } from 'vitest'
+
+import type { GiteaIssue } from '../gitea/types.js'
+import { extractLabelFacts } from '../labels/label-schema.js'
+import { type CacheDriver, initCache, readIssue, upsertIssue } from './cache-v0.js'
+
+/** Adapt node:sqlite's DatabaseSync to the CacheDriver seam (main uses better-sqlite3). */
+function memoryDriver(): CacheDriver {
+  const db = new DatabaseSync(':memory:')
+  return {
+    exec: (sql) => db.exec(sql),
+    run: (sql, params = []) => {
+      db.prepare(sql).run(...(params as never[]))
+    },
+    get: (sql, params = []) => db.prepare(sql).get(...(params as never[])) as Record<string, unknown> | undefined,
+    all: (sql, params = []) => db.prepare(sql).all(...(params as never[])) as Record<string, unknown>[],
+  }
+}
+
+function issue(over: Partial<GiteaIssue> = {}): GiteaIssue {
+  const labels = over.labels ?? ['est/5d', 'p/1', 'deadline/hard']
+  return {
+    number: 42,
+    title: 'Monte Carlo engine',
+    body: 'percentile bands',
+    state: 'open',
+    labels,
+    facts: extractLabelFacts(labels),
+    milestone: { id: 7, title: 'P2 — Scheduler', dueOn: '2026-09-01T00:00:00Z' },
+    assignee: 'christian',
+    assignees: ['christian'],
+    createdAt: '2026-07-08T00:00:00Z',
+    updatedAt: '2026-07-08T01:00:00Z',
+    closedAt: null,
+    url: 'https://gitea/christian/commitea/issues/42',
+    ...over,
+  }
+}
+
+describe('cache-v0', () => {
+  it('mirrors one issue and reads its facts back through extractLabelFacts (acceptance)', () => {
+    const d = memoryDriver()
+    initCache(d)
+    upsertIssue(d, issue({ labels: ['est/5d', 'p/1', 'deadline/hard'] }))
+
+    const back = readIssue(d, 42)!
+    expect(back.labels).toEqual(['est/5d', 'p/1', 'deadline/hard'])
+    // facts are re-derived on read, not stored
+    expect(back.facts.estimateDays).toBe(5)
+    expect(back.facts.priority).toBe(1)
+    expect(back.facts.hardDeadline).toBe(true)
+    // the rest of the domain shape round-trips
+    expect(back.milestone).toEqual({ id: 7, title: 'P2 — Scheduler', dueOn: '2026-09-01T00:00:00Z' })
+    expect(back.assignee).toBe('christian')
+    expect(back.state).toBe('open')
+  })
+
+  it('re-derives facts from the current labels after a re-reconcile (upsert in place, no dup)', () => {
+    const d = memoryDriver()
+    initCache(d)
+    upsertIssue(d, issue({ labels: ['est/2d', 'p/3'] }))
+    // reconcile again with changed labels + closed
+    upsertIssue(d, issue({ labels: ['est/8d', 'p/1'], state: 'closed', closedAt: '2026-07-09T00:00:00Z' }))
+
+    expect(d.all('SELECT number FROM issues')).toHaveLength(1) // upsert by number, not a second row
+    const back = readIssue(d, 42)!
+    expect(back.facts.estimateDays).toBe(8)
+    expect(back.facts.priority).toBe(1)
+    expect(back.facts.hardDeadline).toBe(false) // deadline/hard dropped
+    expect(back.state).toBe('closed')
+    expect(back.closedAt).toBe('2026-07-09T00:00:00Z')
+  })
+
+  it('reads an issue with no milestone / empty labels', () => {
+    const d = memoryDriver()
+    initCache(d)
+    upsertIssue(d, issue({ number: 9, labels: [], milestone: null, assignee: null, assignees: [] }))
+    const back = readIssue(d, 9)!
+    expect(back.milestone).toBeNull()
+    expect(back.labels).toEqual([])
+    expect(back.facts.estimateDays).toBeNull()
+    expect(back.assignee).toBeNull()
+  })
+
+  it('returns null for an uncached issue', () => {
+    const d = memoryDriver()
+    initCache(d)
+    expect(readIssue(d, 999)).toBeNull()
+  })
+})

packages/core/src/cache/cache-v0.ts

@@ -0,0 +1,159 @@
+/**
+ * SQLite cache, v0 (#3) — a rebuildable local mirror of the reconciled backlog.
+ * It is an index over the durable truth in gitea, never the source of truth (D4):
+ * delete it, resync, lose nothing. This module owns the schema + the pure
+ * row<->domain mappers; the actual SQLite handle is injected as a `CacheDriver`,
+ * so core stays free of any native driver (better-sqlite3 lives in main; tests
+ * use node:sqlite). Facts are never stored — they are re-derived from the label
+ * set on read via `extractLabelFacts`, so the mirror can't drift from the label
+ * semantics.
+ */
+
+import type { GiteaIssue, GiteaMilestoneRef } from '../gitea/types.js'
+import { extractLabelFacts } from '../labels/label-schema.js'
+
+/**
+ * The injected IO boundary: a thin synchronous SQL executor. Core writes the SQL;
+ * the host binds a real driver (better-sqlite3 in the desktop main process,
+ * node:sqlite in tests). Kept minimal on purpose — no ORM, no query builder.
+ */
+export interface CacheDriver {
+  /** Run one or more DDL/utility statements (no params, no result). */
+  exec(sql: string): void
+  /** Execute a single parameterized write. */
+  run(sql: string, params?: readonly unknown[]): void
+  /** First row of a parameterized query, or undefined. */
+  get(sql: string, params?: readonly unknown[]): Record<string, unknown> | undefined
+  /** All rows of a parameterized query. */
+  all(sql: string, params?: readonly unknown[]): Record<string, unknown>[]
+}
+
+/** The cache schema — five tables mirroring gitea's shape. Regenerable; drop and rebuild freely. */
+export const CACHE_SCHEMA = `
+CREATE TABLE IF NOT EXISTS milestones (
+  id       INTEGER PRIMARY KEY,
+  title    TEXT NOT NULL,
+  state    TEXT,
+  due_on   TEXT
+);
+CREATE TABLE IF NOT EXISTS issues (
+  number       INTEGER PRIMARY KEY,
+  title        TEXT NOT NULL,
+  body         TEXT NOT NULL DEFAULT '',
+  state        TEXT NOT NULL,
+  labels       TEXT NOT NULL DEFAULT '[]',  -- JSON array of label names; facts re-derived on read
+  milestone_id INTEGER,
+  assignee     TEXT,
+  assignees    TEXT NOT NULL DEFAULT '[]',  -- JSON array of logins
+  created_at   TEXT,
+  updated_at   TEXT,
+  closed_at    TEXT,
+  url          TEXT,
+  FOREIGN KEY (milestone_id) REFERENCES milestones(id)
+);
+CREATE TABLE IF NOT EXISTS labels (
+  id    INTEGER PRIMARY KEY,
+  name  TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS comments (
+  id            INTEGER PRIMARY KEY,
+  issue_number  INTEGER NOT NULL,
+  author        TEXT,
+  body          TEXT NOT NULL DEFAULT '',
+  created_at    TEXT
+);
+CREATE TABLE IF NOT EXISTS issue_events (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  issue_number  INTEGER NOT NULL,
+  type          TEXT NOT NULL,
+  at            TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_issue_events_number ON issue_events(issue_number);
+CREATE INDEX IF NOT EXISTS idx_comments_number ON comments(issue_number);
+`
+
+/** Create the schema if absent. Idempotent. */
+export function initCache(driver: CacheDriver): void {
+  driver.exec(CACHE_SCHEMA)
+}
+
+const UPSERT_ISSUE = `
+INSERT INTO issues (number, title, body, state, labels, milestone_id, assignee, assignees, created_at, updated_at, closed_at, url)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+ON CONFLICT(number) DO UPDATE SET
+  title = excluded.title, body = excluded.body, state = excluded.state, labels = excluded.labels,
+  milestone_id = excluded.milestone_id, assignee = excluded.assignee, assignees = excluded.assignees,
+  created_at = excluded.created_at, updated_at = excluded.updated_at, closed_at = excluded.closed_at, url = excluded.url
+`
+
+const UPSERT_MILESTONE = `
+INSERT INTO milestones (id, title, state, due_on) VALUES (?, ?, ?, ?)
+ON CONFLICT(id) DO UPDATE SET title = excluded.title, state = excluded.state, due_on = excluded.due_on
+`
+
+/**
+ * Mirror one reconciled issue into the cache (and its milestone, if any). Upsert
+ * by `number`, so re-reconciling the same issue updates in place — never duplicates.
+ */
+export function upsertIssue(driver: CacheDriver, issue: GiteaIssue): void {
+  if (issue.milestone) {
+    driver.run(UPSERT_MILESTONE, [issue.milestone.id, issue.milestone.title, null, issue.milestone.dueOn])
+  }
+  driver.run(UPSERT_ISSUE, [
+    issue.number,
+    issue.title,
+    issue.body,
+    issue.state,
+    JSON.stringify(issue.labels),
+    issue.milestone?.id ?? null,
+    issue.assignee,
+    JSON.stringify(issue.assignees),
+    issue.createdAt,
+    issue.updatedAt,
+    issue.closedAt,
+    issue.url,
+  ])
+}
+
+const READ_ISSUE = `
+SELECT i.*, m.title AS m_title, m.due_on AS m_due
+FROM issues i LEFT JOIN milestones m ON m.id = i.milestone_id
+WHERE i.number = ?
+`
+
+function str(v: unknown): string {
+  return typeof v === 'string' ? v : ''
+}
+
+/**
+ * Read one mirrored issue back as a domain object, re-deriving `facts` from the
+ * stored label set (so the mirror can't disagree with the label semantics).
+ * Returns null when the issue isn't cached.
+ */
+export function readIssue(driver: CacheDriver, number: number): GiteaIssue | null {
+  const row = driver.get(READ_ISSUE, [number])
+  if (!row) return null
+
+  const labels = (JSON.parse(str(row.labels) || '[]') as string[]) ?? []
+  const assignees = (JSON.parse(str(row.assignees) || '[]') as string[]) ?? []
+  const milestone: GiteaMilestoneRef | null =
+    row.milestone_id != null
+      ? { id: Number(row.milestone_id), title: str(row.m_title), dueOn: (row.m_due as string | null) ?? null }
+      : null
+
+  return {
+    number: Number(row.number),
+    title: str(row.title),
+    body: str(row.body),
+    state: row.state === 'closed' ? 'closed' : 'open',
+    labels,
+    facts: extractLabelFacts(labels),
+    milestone,
+    assignee: (row.assignee as string | null) ?? null,
+    assignees,
+    createdAt: str(row.created_at),
+    updatedAt: str(row.updated_at),
+    closedAt: (row.closed_at as string | null) ?? null,
+    url: str(row.url),
+  }
+}

packages/core/src/calibration/calibration-v0.test.ts

@@ -0,0 +1,144 @@
+import { describe, expect, it } from 'vitest'
+
+import { extractLabelFacts } from '../labels/label-schema.js'
+import type { LifecycleEvent } from '../lifecycle/lifecycle-v0.js'
+import type { GiteaIssue } from '../gitea/types.js'
+import {
+  CALIBRATION_BUCKET_FLOOR,
+  calibrationCoverage,
+  calibrationSamples,
+  type CalibrationSample,
+  COLD_START_THRESHOLD,
+  fitCalibration,
+  toDurationModel,
+} from './calibration-v0.js'
+
+function sample(over: Partial<CalibrationSample> = {}): CalibrationSample {
+  return { issue: 1, estimateDays: 2, actualWorkingDays: 2, bucket: 2, person: null, ...over }
+}
+
+describe('fitCalibration', () => {
+  it('is cold-start below the threshold and reports the honest n', () => {
+    const m = fitCalibration([sample(), sample({ actualWorkingDays: 4 })])
+    expect(m.n).toBe(2)
+    expect(m.coldStart).toBe(true)
+  })
+
+  it('flips off cold-start at the threshold', () => {
+    const many = Array.from({ length: COLD_START_THRESHOLD }, (_, i) =>
+      sample({ issue: i, estimateDays: 2, actualWorkingDays: 3, bucket: 2 }),
+    )
+    const m = fitCalibration(many)
+    expect(m.n).toBe(COLD_START_THRESHOLD)
+    expect(m.coldStart).toBe(false)
+  })
+
+  it('recovers the global median ratio (mu = mean log-ratio)', () => {
+    // every actual is exactly 2x its estimate → mu = ln 2
+    const m = fitCalibration(Array.from({ length: 25 }, (_, i) => sample({ issue: i, estimateDays: 2, actualWorkingDays: 4 })))
+    expect(m.global.mu).toBeCloseTo(Math.log(2), 6)
+  })
+
+  it('fits a bucket only once it clears the floor', () => {
+    const twos = Array.from({ length: CALIBRATION_BUCKET_FLOOR }, (_, i) =>
+      sample({ issue: i, estimateDays: 2, actualWorkingDays: 3, bucket: 2 }),
+    )
+    const oneThin = [sample({ issue: 99, estimateDays: 5, actualWorkingDays: 9, bucket: 5 })]
+    const m = fitCalibration([...twos, ...oneThin])
+    expect(m.byBucket[2]?.n).toBe(CALIBRATION_BUCKET_FLOOR)
+    expect(m.byBucket[5]).toBeUndefined() // only 1 sample, below floor
+  })
+
+  it('drops non-positive estimates/actuals', () => {
+    const m = fitCalibration([sample({ actualWorkingDays: 0 }), sample({ estimateDays: 0 }), sample()])
+    expect(m.n).toBe(1)
+  })
+
+  it('derives a per-person bias relative to global', () => {
+    // one person consistently runs longer than the mean
+    const base = Array.from({ length: 20 }, (_, i) => sample({ issue: i, actualWorkingDays: 2, person: 'ak' }))
+    const slow = Array.from({ length: 3 }, (_, i) => sample({ issue: 100 + i, actualWorkingDays: 6, person: 'sm' }))
+    const m = fitCalibration([...base, ...slow])
+    expect(m.byPerson['sm'].biasMu).toBeGreaterThan(0)
+    expect(m.byPerson['ak'].biasMu).toBeLessThan(0)
+  })
+})
+
+describe('toDurationModel', () => {
+  it('projects the fit down to the params forecast needs', () => {
+    const m = fitCalibration(
+      Array.from({ length: 25 }, (_, i) => sample({ issue: i, estimateDays: 2, actualWorkingDays: 3, bucket: 2 })),
+    )
+    const dm = toDurationModel(m)
+    expect(dm.coldStart).toBe(false)
+    expect(dm.byBucket[2].mu).toBeCloseTo(m.byBucket[2].mu, 6)
+    expect(dm.global.mu).toBeCloseTo(m.global.mu, 6)
+  })
+})
+
+describe('calibrationSamples', () => {
+  const asOf = new Date('2026-02-01T00:00:00Z')
+
+  function issue(over: Partial<GiteaIssue>): GiteaIssue {
+    const labels = over.labels ?? []
+    return {
+      number: 1,
+      title: '#1',
+      body: '',
+      state: 'closed',
+      labels,
+      facts: extractLabelFacts(labels),
+      milestone: null,
+      assignee: null,
+      assignees: [],
+      createdAt: '2026-01-05T09:00:00Z',
+      updatedAt: '2026-01-12T09:00:00Z',
+      closedAt: '2026-01-12T09:00:00Z',
+      url: '',
+      ...over,
+    }
+  }
+
+  const events = (i: number): Record<number, LifecycleEvent[]> => ({
+    [i]: [{ type: 'commit', at: '2026-01-07T09:00:00Z' }, { type: 'close', at: '2026-01-12T09:00:00Z' }],
+  })
+
+  it('samples closed, estimated issues with a resolvable actual', () => {
+    const i = issue({ number: 7, labels: ['est/2d'], assignee: 'sm', closedAt: '2026-01-12T09:00:00Z' })
+    const [s] = calibrationSamples([i], events(7), asOf)
+    expect(s.issue).toBe(7)
+    expect(s.estimateDays).toBe(2)
+    expect(s.bucket).toBe(2)
+    expect(s.person).toBe('sm')
+    // Wed 2026-01-07 → Mon 2026-01-12 = Wed,Thu,Fri = 3 working days
+    expect(s.actualWorkingDays).toBe(3)
+  })
+
+  it('skips open issues and closed ones without an estimate', () => {
+    const open = issue({ number: 8, state: 'open', labels: ['est/2d'], closedAt: null })
+    const noEst = issue({ number: 9, labels: [] })
+    expect(calibrationSamples([open, noEst], { ...events(8), ...events(9) }, asOf)).toEqual([])
+  })
+
+  it('coverage counts same-day closes as excluded candidates, not as "more closes needed"', () => {
+    // usable: commit Wed 01-07 → close Mon 01-12 = 3 working days
+    const usable = issue({ number: 7, labels: ['est/2d'] })
+    // same-day close: commit and close on the same day = 0 working days → excluded
+    const sameDay = issue({ number: 10, labels: ['est/2d'], createdAt: '2026-01-12T08:00:00Z' })
+    const sameDayEvents = {
+      10: [
+        { type: 'commit', at: '2026-01-12T09:00:00Z' } as LifecycleEvent,
+        { type: 'close', at: '2026-01-12T17:00:00Z' } as LifecycleEvent,
+      ],
+    }
+    const open = issue({ number: 8, state: 'open', labels: ['est/2d'], closedAt: null })
+    const noEst = issue({ number: 9, labels: [] })
+
+    const cov = calibrationCoverage([usable, sameDay, open, noEst], { ...events(7), ...sameDayEvents }, asOf)
+    expect(cov.candidates).toBe(2) // closed + estimated only (usable + sameDay)
+    expect(cov.usable).toBe(1)
+    expect(cov.excludedSameDay).toBe(1)
+    // the honest denominator: usable matches the model's n
+    expect(cov.usable).toBe(calibrationSamples([usable, sameDay, open, noEst], { ...events(7), ...sameDayEvents }, asOf).length)
+  })
+})

packages/core/src/calibration/calibration-v0.ts

@@ -0,0 +1,164 @@
+/**
+ * Calibration, v0 — fit the team's own estimate-vs-actual history so the
+ * forecast stops guessing (D3). The "actual" is the working time lifecycle
+ * inference derives from git events (#5), never manual tracking. Fit a
+ * lognormal on log(actual / estimate) globally and per estimate bucket; until
+ * the sample clears the cold-start threshold, the forecast keeps using the
+ * code-resident priors and this model just reports progress toward it.
+ */
+
+import { type DurationModel, type LognormalPrior, nearestBucket } from '../forecast/forecast-v0.js'
+import { inferLifecycle, type LifecycleEvent } from '../lifecycle/lifecycle-v0.js'
+import type { GiteaIssue } from '../gitea/types.js'
+
+/** Global sample size at which the fit takes over from the cold-start priors. */
+export const COLD_START_THRESHOLD = 20
+/** Minimum per-bucket sample before that bucket earns its own fit. */
+export const CALIBRATION_BUCKET_FLOOR = 3
+/** Fallback spread when a group is too small to estimate one. */
+const DEFAULT_SIGMA = 0.4
+
+/** One closed issue's estimate vs its inferred actual. */
+export interface CalibrationSample {
+  issue: number
+  estimateDays: number
+  actualWorkingDays: number
+  bucket: number
+  person: string | null
+}
+
+export interface BucketFit extends LognormalPrior {
+  n: number
+}
+
+export interface PersonBias {
+  /** Additive to global mu (log space). */
+  biasMu: number
+  n: number
+}
+
+export interface CalibrationModel {
+  /** Closed issues with an estimate + a resolvable actual. */
+  n: number
+  /** true while n < COLD_START_THRESHOLD — forecast keeps the code priors. */
+  coldStart: boolean
+  global: LognormalPrior
+  byBucket: Record<number, BucketFit>
+  byPerson: Record<string, PersonBias>
+}
+
+function mean(xs: number[]): number {
+  return xs.reduce((a, b) => a + b, 0) / xs.length
+}
+
+/** Sample standard deviation; falls back to DEFAULT_SIGMA below 2 points. */
+function stddev(xs: number[], mu: number): number {
+  if (xs.length < 2) return DEFAULT_SIGMA
+  const variance = xs.reduce((a, x) => a + (x - mu) ** 2, 0) / (xs.length - 1)
+  return Math.sqrt(variance) || DEFAULT_SIGMA
+}
+
+/** Fit a calibration model from estimate-vs-actual samples. Pure. */
+export function fitCalibration(samples: CalibrationSample[]): CalibrationModel {
+  const usable = samples.filter((s) => s.estimateDays > 0 && s.actualWorkingDays > 0)
+  const n = usable.length
+  const coldStart = n < COLD_START_THRESHOLD
+
+  const logRatios = usable.map((s) => Math.log(s.actualWorkingDays / s.estimateDays))
+  const globalMu = n ? mean(logRatios) : 0
+  const global: LognormalPrior = { mu: globalMu, sigma: n ? stddev(logRatios, globalMu) : DEFAULT_SIGMA }
+
+  const byBucket: Record<number, BucketFit> = {}
+  const byPerson: Record<string, PersonBias> = {}
+  const groups = new Map<number, number[]>()
+  const people = new Map<string, number[]>()
+  for (const s of usable) {
+    const lr = Math.log(s.actualWorkingDays / s.estimateDays)
+    ;(groups.get(s.bucket) ?? groups.set(s.bucket, []).get(s.bucket)!).push(lr)
+    if (s.person) (people.get(s.person) ?? people.set(s.person, []).get(s.person)!).push(lr)
+  }
+  for (const [bucket, lrs] of groups) {
+    if (lrs.length < CALIBRATION_BUCKET_FLOOR) continue
+    const mu = mean(lrs)
+    byBucket[bucket] = { mu, sigma: stddev(lrs, mu), n: lrs.length }
+  }
+  for (const [person, lrs] of people) {
+    if (lrs.length < CALIBRATION_BUCKET_FLOOR) continue
+    byPerson[person] = { biasMu: mean(lrs) - globalMu, n: lrs.length }
+  }
+
+  return { n, coldStart, global, byBucket, byPerson }
+}
+
+/** The subset of a model `forecast` consumes. */
+export function toDurationModel(model: CalibrationModel): DurationModel {
+  const byBucket: Record<number, LognormalPrior> = {}
+  for (const [bucket, fit] of Object.entries(model.byBucket)) {
+    byBucket[Number(bucket)] = { mu: fit.mu, sigma: fit.sigma }
+  }
+  return { coldStart: model.coldStart, global: model.global, byBucket }
+}
+
+/**
+ * Extract calibration samples from the closed backlog: each closed issue that
+ * carries an estimate and yields an inferred actual working duration.
+ */
+export function calibrationSamples(
+  issues: GiteaIssue[],
+  timelines: Record<number, LifecycleEvent[]>,
+  asOf: Date,
+): CalibrationSample[] {
+  const out: CalibrationSample[] = []
+  for (const issue of issues) {
+    if (issue.state !== 'closed') continue
+    const estimateDays = issue.facts.estimateDays
+    if (estimateDays == null) continue
+    const inf = inferLifecycle(issue, timelines[issue.number] ?? [], asOf)
+    if (inf.actualWorkingDays == null || inf.actualWorkingDays <= 0) continue
+    out.push({
+      issue: issue.number,
+      estimateDays,
+      actualWorkingDays: inf.actualWorkingDays,
+      bucket: nearestBucket(estimateDays),
+      person: issue.assignee,
+    })
+  }
+  return out
+}
+
+/** How the closed+estimated backlog splits into usable samples vs. what can't calibrate. */
+export interface CalibrationCoverage {
+  /** Closed issues carrying an estimate — the calibration candidates. */
+  candidates: number
+  /** Candidates that yielded a usable actual (> 0 working days) → become samples. */
+  usable: number
+  /**
+   * Candidates excluded because the issue closed with 0 working days (same-day
+   * close) or no resolvable actual — real closes that structurally can't
+   * calibrate. Counting them keeps `usable/threshold` honest: it's not "N more
+   * closes away" if some of your closes will never count.
+   */
+  excludedSameDay: number
+}
+
+/**
+ * Coverage of the calibration candidates — how many closed+estimated issues are
+ * usable vs. silently unusable (same-day / 0-day closes). {@link calibrationSamples}
+ * drops the latter; this counts them so the UI can say *why* the sample is thin.
+ */
+export function calibrationCoverage(
+  issues: GiteaIssue[],
+  timelines: Record<number, LifecycleEvent[]>,
+  asOf: Date,
+): CalibrationCoverage {
+  let candidates = 0
+  let usable = 0
+  for (const issue of issues) {
+    if (issue.state !== 'closed') continue
+    if (issue.facts.estimateDays == null) continue
+    candidates++
+    const inf = inferLifecycle(issue, timelines[issue.number] ?? [], asOf)
+    if (inf.actualWorkingDays != null && inf.actualWorkingDays > 0) usable++
+  }
+  return { candidates, usable, excludedSameDay: candidates - usable }
+}