Compare commits

..

2 Commits

Author SHA1 Message Date
b64427c1a4 Merge pull request 'P4: capture_work — braindump → decomposed issues → filed in gitea' (#44) from p4/capture-work into p4/chat-writes
Reviewed-on: #44
2026-07-09 02:17:53 +00:00
Croissant Le Doux
5ae191be49 feat: capture_work — braindump → decomposed issues → filed in gitea (P4)
The last big agent capability. In the Capture screen, a rough braindump runs real
big-model decomposition into a small, estimated issue set; you review/edit the
labels and approve, and the issues are opened in gitea. This is the one place the
big model earns its keep (docs/agent-tools.md).

core (@commitea/core):
- capture-work: PROPOSE_ISSUES_TOOL + CAPTURE_SYSTEM; captureWork(complete, dump)
  forces a single structured decomposition and returns validated issues; parseCaptureArgs
  drops blank titles + invalid est/p labels. ProposedIssue / CaptureProposal.
- gitea client: createIssue({title, body?, labelIds?}) → POST /issues, normalized.

app:
- model bridge model:capture runs captureWork on the (loaded) big model.
- gitea bridge gitea:createIssues opens each approved issue with its est/* + p/*
  labels (reusing the #41 label-id resolver — zero-pollution, no invented labels).
- Capture screen: when a model is configured, "Brew tickets" runs real capture and
  "Approve all" files the set; otherwise the scripted demo interview runs. Fixed a
  race — the brew handler re-checks model status at click time so a configured
  model never falls into the scripted path before status resolves.

Verified: 108 core tests green (7 capture + createIssue added), desktop typecheck
clean, 14 fixture e2e green. Gated live e2e against gemma-4-26b: the auth braindump
→ 3 real tickets ("Resolve token refresh + session staleness" est/3d p/1, "Fix
webhook double-firing" est/2d p/2, "Write auth setup docs" est/1d p/3), reviewable
and editable; Discard so the test files nothing (createIssue POST is unit-tested).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-08 22:08:37 -04:00
93 changed files with 1703 additions and 8804 deletions

View File

@@ -1,42 +0,0 @@
# 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.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 657 KiB

View File

@@ -11,7 +11,6 @@ const MAIN = join(here, '..', 'out', 'main', 'index.js')
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')
@@ -42,22 +41,6 @@ test.describe('live backlog', () => {
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' })
@@ -70,15 +53,10 @@ test.describe('live backlog', () => {
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 expect(win.getByText('Adjust estimate & priority')).toBeVisible()
await win.getByRole('combobox').first().selectOption('est/8d')
await expect(win.getByText('Proposed change')).toBeVisible()
await expect(win.getByText('Proposed label 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

View File

@@ -1,32 +0,0 @@
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()
})
})

View File

@@ -1,85 +0,0 @@
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()
})
})

View File

@@ -1,37 +0,0 @@
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()
})
})

View File

@@ -1,13 +1,5 @@
import { expect, test } from './fixtures.js'
/**
* Smoke suite — runs in demo mode (COMMITEA_E2E=1), where the main process serves
* the fixed demo snapshot (apps/desktop/src/main/demo-snapshot.ts) with NO live
* gitea. The app renders it through the exact same view builders as real data, so
* these assertions exercise the real render path against deterministic input.
* Full onboarding + agent flows live in the GITEA_LIVE-gated live-*.spec files.
*/
test('boots into the shell with the Focus screen', async ({ app, window }) => {
await app.expectLoaded()
await expect(window.getByText('Reginald', { exact: true })).toBeVisible()
@@ -15,83 +7,121 @@ test('boots into the shell with the Focus screen', async ({ app, window }) => {
await app.screenshot('shell-light')
})
test('Focus shows the Now/Next/Later cards from the scheduler', async ({ window }) => {
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()
}
// the cards link to real demo issues (which specific one is scheduler-dependent)
await expect(window.getByRole('main').getByRole('link').first()).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 letter', async ({ app, window }) => {
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("Today's plan")).toBeVisible()
await expect(window.getByText('Overnight drift')).toBeVisible()
await expect(window.getByText('Stephen', { exact: true })).toBeVisible()
await app.screenshot('standup')
})
test('Board: lifecycle columns, a demo issue, and the search filter', async ({ app, window }) => {
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()
// lifecycle columns populated by the demo snapshot's event stream
await expect(window.getByText('Diagnosis', { exact: true })).toBeVisible()
await expect(window.getByText('Steeping', { exact: true })).toBeVisible()
await expect(window.getByText('Done', { exact: true })).toBeVisible()
await expect(window.getByText('Fix lifecycle inference on merge events')).toBeVisible()
await app.screenshot('board')
await window.getByPlaceholder(/Search the pot/).fill('monte carlo')
await expect(window.getByText('Monte Carlo forecast bands on the runway')).toBeVisible()
await expect(window.getByText('Fix lifecycle inference on merge events')).toBeHidden()
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('')
// the Gantt + Dependencies tabs render from the same snapshot
await window.getByRole('tab', { name: 'Gantt' }).click()
await expect(window.getByText(/80% · Mar 312/)).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 shows the demo milestones', async ({ app, window }) => {
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('Beta', { exact: true })).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 renders', async ({ app, window }) => {
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 prompt', async ({ app, window }) => {
test('Capture: braindump advances to the interview', async ({ app, window }) => {
await app.nav('Capture').click()
await expect(window.getByText('Do tell me what you are planning')).toBeVisible()
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: the live ledger from pm-state', async ({ app, window }) => {
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()
// a demo directive quote from the snapshot
await expect(window.getByText(/Beta ships the 12th, hard/)).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 + appearance, theme sync', async ({ app, window }) => {
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 expect(window.getByText('Managed repos')).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('issue drill-in from a Focus card and back', async ({ app, window }) => {
// Focus cards render the issue title as a link; open the first and come back.
await window.getByRole('main').getByRole('link').first().click()
await expect(window.getByRole('button', { name: 'Back' })).toBeVisible()
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()
@@ -103,6 +133,12 @@ test('Evening service toggle flips the document theme', async ({ app, window })
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()

View File

@@ -1,51 +0,0 @@
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

View File

@@ -1,8 +1,5 @@
{
"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",
@@ -11,12 +8,9 @@
"build": "electron-vite build",
"start": "electron-vite preview",
"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"
"e2e:report": "playwright show-report e2e/.artifacts/report"
},
"dependencies": {
"@commitea/core": "workspace:*",
@@ -31,13 +25,10 @@
"@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",
"vitest": "^3.0.5"
"vite": "^6.1.0"
}
}

View File

@@ -1,142 +0,0 @@
/**
* 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)
})

View File

@@ -1,101 +0,0 @@
/**
* 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
}
}

View File

@@ -1,152 +0,0 @@
/**
* Deterministic demo snapshot — the ONLY test fixture, served by the main process
* when COMMITEA_E2E=1 so the e2e suite (and a no-token first look) runs WITHOUT a
* live Gitea. It's gitea-shaped on purpose: the reconcile handlers return it and
* the app renders it through the exact same view builders (schedule, forecast,
* lifecycle, standup, runway) as real data. There are no screen-level mocks — this
* is the single source of demo truth. Not shipped behavior; test infrastructure.
*/
import {
type CapacityMember,
type DependencyEdge,
type DirectiveRecord,
extractLabelFacts,
type GiteaIssue,
type GiteaMilestone,
type LifecycleEvent,
} from '@commitea/core'
const HOST = 'https://gitea.demo.local'
const OWNER = 'teatime'
const REPO = 'commitea'
/** Fixed clock so lifecycle math + forecasts are stable across runs. */
export const DEMO_TODAY = '2026-03-02T09:00:00Z'
interface Seed {
number: number
title: string
labels: string[]
state?: 'open' | 'closed'
milestone?: number
assignee?: string
events?: LifecycleEvent[]
closedAt?: string
createdAt?: string
}
const MILESTONES_RAW = [
{ id: 1, title: 'Beta', description: 'Pilot-ready', dueOn: '2026-03-12T00:00:00Z', state: 'open' as const },
{ id: 2, title: 'v1.0', description: 'General availability', dueOn: '2026-05-01T00:00:00Z', state: 'open' as const },
]
const MREF = (id: number) => {
const m = MILESTONES_RAW.find((x) => x.id === id)!
return { id: m.id, title: m.title, dueOn: m.dueOn }
}
// A small, believable backlog for a team building CommiTea. Timelines place issues
// across the five lifecycle columns: bare → diagnosis, labeled → triage, a commit
// ref → steeping, a PR ref → review, closed → done.
const SEEDS: Seed[] = [
{ number: 42, title: 'Fix lifecycle inference on merge events', labels: ['est/3d', 'p/1', 'deadline/hard'], milestone: 1, assignee: 'stephen',
events: [{ type: 'triage', at: '2026-02-24T10:00:00Z' }, { type: 'commit', at: '2026-02-27T14:00:00Z' }] },
{ number: 41, title: 'Monte Carlo forecast bands on the runway', labels: ['est/5d', 'p/1'], milestone: 1, assignee: 'ana',
events: [{ type: 'triage', at: '2026-02-23T09:00:00Z' }, { type: 'commit', at: '2026-02-26T09:00:00Z' }, { type: 'pull', at: '2026-03-01T16:00:00Z' }] },
{ number: 40, title: 'Encrypted token store in the main process', labels: ['est/2d', 'p/2'], milestone: 1, assignee: 'stephen',
events: [{ type: 'triage', at: '2026-02-22T11:00:00Z' }] },
{ number: 39, title: 'Deterministic scheduler with capacity lanes', labels: ['est/8d', 'p/2'], milestone: 1, assignee: 'ana',
events: [{ type: 'triage', at: '2026-02-20T09:00:00Z' }, { type: 'commit', at: '2026-02-28T09:00:00Z' }] },
{ number: 38, title: 'Standup ritual: overnight drift + todays plan', labels: ['est/3d', 'p/2'], milestone: 1, assignee: 'stephen',
events: [{ type: 'triage', at: '2026-02-25T09:00:00Z' }] },
{ number: 37, title: 'Offline write-queue with replay on reconnect', labels: ['est/5d', 'p/3'], milestone: 2, assignee: 'ana',
events: [{ type: 'triage', at: '2026-02-19T09:00:00Z' }] },
{ number: 36, title: 'Calibration from closed-issue actuals', labels: ['est/3d', 'p/3'], milestone: 2, assignee: 'stephen',
events: [{ type: 'triage', at: '2026-02-18T09:00:00Z' }] },
{ number: 35, title: 'Reginald: agent loop over query_project', labels: ['est/8d', 'p/2'], milestone: 2, assignee: 'ana',
events: [{ type: 'triage', at: '2026-02-17T09:00:00Z' }] },
{ number: 34, title: 'Board columns from lifecycle events', labels: [], // bare → diagnosis
events: [] },
{ number: 33, title: 'Deep-link URIs across orgs', labels: [], // bare → diagnosis
events: [] },
// shipped work — closed → done, feeds calibration actuals
{ number: 30, title: 'SQLite cache bootstrap', labels: ['est/3d', 'p/2'], milestone: 1, assignee: 'ana', state: 'closed',
createdAt: '2026-02-10T09:00:00Z', closedAt: '2026-02-14T17:00:00Z',
events: [{ type: 'triage', at: '2026-02-10T09:00:00Z' }, { type: 'commit', at: '2026-02-11T09:00:00Z' }, { type: 'pull', at: '2026-02-13T09:00:00Z' }, { type: 'close', at: '2026-02-14T17:00:00Z' }] },
{ number: 29, title: 'Connection + target-repo config', labels: ['est/2d', 'p/2'], milestone: 1, assignee: 'stephen', state: 'closed',
createdAt: '2026-02-09T09:00:00Z', closedAt: '2026-02-12T15:00:00Z',
events: [{ type: 'triage', at: '2026-02-09T09:00:00Z' }, { type: 'commit', at: '2026-02-10T09:00:00Z' }, { type: 'close', at: '2026-02-12T15:00:00Z' }] },
{ number: 24, title: 'Unified apply_changes mutation tool', labels: ['est/5d', 'p/1'], milestone: 1, assignee: 'ana', state: 'closed',
createdAt: '2026-02-05T09:00:00Z', closedAt: '2026-02-11T12:00:00Z',
events: [{ type: 'triage', at: '2026-02-05T09:00:00Z' }, { type: 'commit', at: '2026-02-06T09:00:00Z' }, { type: 'pull', at: '2026-02-10T09:00:00Z' }, { type: 'close', at: '2026-02-11T12:00:00Z' }] },
]
function toIssue(s: Seed): GiteaIssue {
const state = s.state ?? 'open'
return {
number: s.number,
title: s.title,
body: '',
state,
labels: s.labels,
facts: extractLabelFacts(s.labels),
milestone: s.milestone ? MREF(s.milestone) : null,
assignee: s.assignee ?? null,
assignees: s.assignee ? [s.assignee] : [],
createdAt: s.createdAt ?? '2026-02-20T09:00:00Z',
updatedAt: DEMO_TODAY,
closedAt: s.closedAt ?? null,
url: `${HOST}/${OWNER}/${REPO}/issues/${s.number}`,
}
}
export const DEMO_ISSUES: GiteaIssue[] = SEEDS.map(toIssue)
export const DEMO_MILESTONES: GiteaMilestone[] = MILESTONES_RAW.map((m) => ({
id: m.id,
title: m.title,
description: m.description,
dueOn: m.dueOn,
state: m.state,
openIssues: DEMO_ISSUES.filter((i) => i.milestone?.id === m.id && i.state === 'open').length,
closedIssues: DEMO_ISSUES.filter((i) => i.milestone?.id === m.id && i.state === 'closed').length,
}))
// #41 (forecast bands) depends on #39 (scheduler); #42 (lifecycle) depends on #34 (columns).
export const DEMO_DEPS: DependencyEdge[] = [
{ issue: 41, dependsOn: 39 },
{ issue: 42, dependsOn: 34 },
]
export const DEMO_TIMELINES: Record<number, LifecycleEvent[]> = Object.fromEntries(
SEEDS.map((s) => [s.number, s.events ?? []]),
)
export const DEMO_CAPACITY: CapacityMember[] = [
{ person: 'stephen', focusFactor: 0.6, allocation: 1 },
{ person: 'ana', focusFactor: 1, allocation: 0.8 },
]
export const DEMO_COLLABORATORS: { login: string; name: string }[] = [
{ login: 'stephen', name: 'Stephen Mann' },
{ login: 'ana', name: 'Ana Koval' },
]
export const DEMO_DIRECTIVES: DirectiveRecord[] = [
{ seq: 1, id: 'demo-1', ts: '2026-02-26T10:00:00Z', status: 'accepted', kind: 'reprioritize',
quote: 'Bump the lifecycle fix — its blocking the board.', target: { issue: 42 }, params: { priority: 1 },
rationale: 'Board columns are wrong until #42 lands.' },
{ seq: 2, id: 'demo-2', ts: '2026-02-24T15:00:00Z', status: 'accepted', kind: 'capacity',
quote: 'Stephens at 60% this sprint — half on support.', params: { person: 'stephen', focusFactor: 0.6 },
rationale: 'Support rotation.' },
{ seq: 3, id: 'demo-3', ts: '2026-02-22T09:00:00Z', status: 'amended', kind: 'set-deadline',
quote: 'Beta ships the 12th, hard.', target: { milestone: 1 }, params: { due: '2026-03-12' } },
]
/** The full gitea-shaped snapshot the reconcile handlers return in demo mode. */
export const DEMO_SNAPSHOT = {
issues: DEMO_ISSUES,
milestones: DEMO_MILESTONES,
deps: DEMO_DEPS,
timelines: DEMO_TIMELINES,
}

View File

@@ -6,51 +6,21 @@
* properly later.
*/
import { randomUUID } from 'node:crypto'
import { readFileSync } from 'node:fs'
import { dirname, join } from 'node:path'
import {
appendDirective,
applySchemaLabels,
createGiteaClient,
discoverRepos,
enqueueWrite,
ensurePmStateRepo,
GiteaApiError,
replayQueue,
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 {
DEMO_CAPACITY,
DEMO_COLLABORATORS,
DEMO_DIRECTIVES,
DEMO_SNAPSHOT,
DEMO_TODAY,
} from './demo-snapshot.js'
/** Demo mode: the e2e harness (and a no-token first look) render the fixed demo
* snapshot through the real view builders — no live gitea, no screen-level mocks. */
const isDemo = (): boolean => process.env.COMMITEA_E2E === '1'
import { type AppConfig, clearConfig, loadConfig, publicConfig, saveConfig } from './config-store.js'
import { loadQueue, saveQueue } from './queue-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()
@@ -69,15 +39,9 @@ function loadEnvLocalToken(): string | undefined {
return undefined
}
/** Saved config wins (team build); a `.env.local` is the dev fallback; e2e uses fixtures. */
export function resolveConfig(): GiteaConfig | null {
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 {
@@ -88,23 +52,8 @@ export function resolveConfig(): GiteaConfig | null {
}
}
/** 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.
// Memoized client so both the gitea and model bridges share one instance.
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()
@@ -113,55 +62,6 @@ export function getGiteaClient(): GiteaClient | 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,
@@ -181,190 +81,48 @@ export async function reconcileSnapshot(
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)
}
/** The result of a live write — a label swap returns its plan, a field write the fresh issue. */
type LiveApplyResult = { ok: true; plan?: ReturnType<typeof planIssueChange>; issue: Awaited<ReturnType<GiteaClient['getIssue']>> }
/**
* Apply one approved change against gitea (the guarded write path, used both
* online and when draining the offline queue). Label swaps (est/p) read → plan →
* set; field writes (assign, milestone) write directly and return the fresh
* issue. A replay is idempotent — a change already reflected server-side no-ops
* (label plan.noop; assignee/milestone re-set to the same value). Throws on a
* network failure (queued upstream) or a GiteaApiError (surfaced, never queued).
*/
async function applyChangeLive(client: GiteaClient, change: IssueChange): Promise<LiveApplyResult> {
if (isLabelChange(change)) {
const current = await client.getIssue(change.issue)
const plan = planIssueChange(current.labels, change)
if (plan.noop) return { ok: true, plan, issue: current }
const ids = await resolveLabelIds(client, plan.labels)
await client.setIssueLabels(change.issue, ids)
const issue = await client.getIssue(change.issue)
return { ok: true, plan, issue }
}
const issue =
change.kind === 'assign'
? await client.setIssueAssignees(change.issue, change.assignee ? [change.assignee] : [])
: await client.setIssueMilestone(change.issue, change.milestone)
return { ok: true, issue }
}
/** Queue a write made while offline, coalescing by (issue, axis). Returns the new pending count. */
function queueOffline(change: IssueChange): number {
const next = enqueueWrite(loadQueue(), change, new Date().toISOString())
saveQueue(next)
return next.length
}
/** How many writes are waiting to replay (shown as a queued badge). */
function pendingCount(): number {
return loadQueue().length
}
/**
* Replay the offline queue against gitea once we know it's reachable. Drained
* writes are removed; any that still fail stay queued. Returns how many drained
* (so the caller can invalidate + re-read the snapshot) and what remains.
*/
async function drainQueue(client: GiteaClient): Promise<{ drainedCount: number; remainingCount: number }> {
const queue = loadQueue()
if (queue.length === 0) return { drainedCount: 0, remainingCount: 0 }
const { drained, remaining } = await replayQueue(queue, (change) => applyChangeLive(client, change))
saveQueue(remaining)
return { drainedCount: drained.length, remainingCount: remaining.length }
}
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',
}
})
const client = getGiteaClient()
const repo = client ? `${process.env.GITEA_OWNER ?? 'christian'}/${process.env.GITEA_REPO ?? 'commitea'}` : null
// Instant boot: the last persisted snapshot, shown before the fresh reconcile lands.
ipcMain.handle('gitea:boot', () => {
if (isDemo()) return { configured: true, cached: true, pending: 0, ...DEMO_SNAPSHOT, savedAt: DEMO_TODAY }
if (!getGiteaClient()) return { configured: false }
const persisted = bootSnapshot()
return persisted
? { configured: true, cached: true, pending: pendingCount(), ...persisted }
: { configured: true, cached: false }
})
ipcMain.handle('gitea:status', () => ({ configured: !!client, repo }))
ipcMain.handle('gitea:reconcile', async () => {
if (isDemo()) return { configured: true, stale: false, pending: 0, ...DEMO_SNAPSHOT }
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
let snap = await getSnapshot(client, { maxAgeMs: 0 })
// A successful reconcile proves gitea is reachable: drain any writes queued
// while offline. If any drained, re-read so the board reflects the replays.
const { drainedCount, remainingCount } = await drainQueue(client)
if (drainedCount > 0) {
invalidateSnapshot()
snap = await getSnapshot(client, { maxAgeMs: 0 })
}
return { configured: true, stale: false, pending: remainingCount, ...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, pending: pendingCount(), ...persisted }
throw e
}
const snap = await reconcileSnapshot(client)
return { configured: true, ...snap }
})
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 }
try {
const result = await applyChangeLive(client, change)
invalidateSnapshot() // the board + forecast must reflect the write
return result
} catch (e) {
// A GiteaApiError is a genuine rejection (bad label, gone issue) — surface
// it; queueing would only replay a doomed write forever. Anything else is
// unreachability: queue the intent so it replays on reconnect (#33).
if (e instanceof GiteaApiError) throw e
const pending = queueOffline(change)
return { ok: true as const, queued: true as const, pending }
// Cached label list for name→id resolution; refreshed on demand if a name misses.
let labelCache: GiteaLabel[] | null = null
async function resolveLabelIds(names: string[]): Promise<number[]> {
if (!client) return []
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)
}
// The write path (apply_changes). Additive label swaps, applied only after the
// renderer's propose-approve. Returns the plan + the freshly-read issue.
ipcMain.handle('gitea:applyChange', async (_event, change: IssueChange) => {
if (!client) return { ok: false as const, reason: 'unconfigured' as const }
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(plan.labels)
await client.setIssueLabels(change.issue, ids)
const issue = await client.getIssue(change.issue)
return { ok: true as const, plan, issue }
})
// capture_work filing: open each approved issue with its est/* + p/* labels.
@@ -372,130 +130,15 @@ export function registerGiteaIpc(): void {
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 labelIds = await resolveLabelIds(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 () => {
if (isDemo()) return { ok: true as const, directives: DEMO_DIRECTIVES }
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 () => {
if (isDemo()) return { ok: true as const, members: DEMO_CAPACITY }
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 () => {
if (isDemo()) return DEMO_COLLABORATORS
const client = getGiteaClient()
if (!client) return []
try {
return await client.listCollaborators()
} catch {
return []
}
})
// ---- config (team onboarding) ----
// The saved config's public view, or — when running off a .env.local / env
// fallback (dev) — a public view of the *resolved* connection, so Settings and
// the rail reflect what the app is actually connected to, not just the store.
ipcMain.handle('config:get', () => {
const saved = publicConfig()
if (saved) return saved
const c = resolveConfig()
if (!c) return null
return {
baseUrl: c.baseUrl,
owner: c.owner,
repo: c.repo,
pmStateRepo: pmStateRepoName(c),
modelUrl: process.env.MODEL_BASE_URL ?? undefined,
hasToken: !!c.token,
}
})
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 }
})
// Discover the owners + repos a token can reach, so onboarding can offer them
// as dropdowns. Token-scoped (not repo-scoped) — no owner/repo needed yet.
ipcMain.handle('config:discover', async (_event, conn: { baseUrl: string; token: string }) => {
try {
const found = await discoverRepos({ baseUrl: conn.baseUrl.replace(/\/+$/, ''), token: conn.token }, fetch)
return { ok: true as const, ...found }
} catch (e) {
return { ok: false as const, error: e instanceof GiteaApiError ? `${e.status}` : e instanceof Error ? e.message : String(e) }
}
})
// First-run bootstrap: apply the label schema to the work repo and ensure the
// pm-state sidecar exists. Idempotent — safe to re-run. `underOrg` tells us
// whether `owner` is an org (vs the token's personal namespace).
ipcMain.handle(
'config:bootstrap',
async (_event, req: { baseUrl: string; token: string; owner: string; repo: string; underOrg: boolean }) => {
try {
const conn = { baseUrl: req.baseUrl.replace(/\/+$/, ''), token: req.token }
const owner = req.owner.trim()
const repo = req.repo.trim()
const client = createGiteaClient({ ...conn, owner, repo }, fetch)
const labels = await applySchemaLabels(client)
const pmStateRepo = `${repo}-pm-state`
const pmState = await ensurePmStateRepo(conn, { owner, repo: pmStateRepo, underOrg: req.underOrg }, fetch)
return { ok: true as const, labels, pmState, pmStateRepo }
} catch (e) {
return { ok: false as const, error: e instanceof GiteaApiError ? `${e.status}` : e instanceof Error ? e.message : String(e) }
}
},
)
// 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) }
}
})
}

View File

@@ -2,9 +2,6 @@ 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'

View File

@@ -13,6 +13,7 @@ import {
type ChangeProposal,
type ChatMessage,
createChatClient,
describeChange,
type ModelRouter,
type ProjectView,
proposalsFor,
@@ -21,27 +22,15 @@ import {
REGINALD_SYSTEM,
REGINALD_TOOLS,
runAgentTurn,
toDirectiveInput,
} from '@commitea/core'
import { app, ipcMain } from 'electron'
import { ipcMain } from 'electron'
import { loadConfig } from './config-store.js'
import {
AGENT_SNAPSHOT_TTL_MS,
appendDirectiveEntry,
getGiteaClient,
getPmStateClient,
getSnapshot,
} from './gitea.js'
import { getGiteaClient, reconcileSnapshot } 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')
const baseUrl = process.env.COMMITEA_MODEL_URL ?? 'http://localhost:1234/v1'
if (!baseUrl) return null
return {
small: { baseUrl, model: process.env.COMMITEA_MODEL_SMALL ?? '' },
@@ -49,19 +38,6 @@ function resolveModelRouter(): ModelRouter | null {
}
}
/** 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
@@ -95,23 +71,19 @@ async function resolveLoadedModel(baseUrl: string, override: string): Promise<st
}
export function registerModelIpc(): void {
const router = resolveModelRouter()
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 }
if (!router) return { configured: false, model: null }
const model = await resolveLoadedModel(router.small.baseUrl, router.small.model)
return { configured: true, model }
})
ipcMain.handle('model:chat', async (event, messages: ChatMessage[]) => {
const router = resolveModelRouter()
ipcMain.handle('model:chat', async (_event, messages: ChatMessage[]) => {
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).
@@ -120,8 +92,7 @@ export function registerModelIpc(): void {
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 snap = await reconcileSnapshot(client)
const a = (args ?? {}) as { view: ProjectView; filters?: QueryFilters }
return buildProjectView(a.view, a.filters, snap, new Date())
}
@@ -129,41 +100,21 @@ export function registerModelIpc(): void {
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,
})
const built = proposalsFor(a, issue.labels, issue.title)
proposals.push(...built)
return built.length
? { proposed: built.map((p) => ({ issue: a.issue, diff: p.summary })) }
? { proposed: built.map((p) => ({ issue: a.issue, diff: describeChange(p.plan) })) }
: { 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),
complete: (m, t) => chat.complete(m, t),
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) {
@@ -175,7 +126,6 @@ export function registerModelIpc(): void {
// 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)

View File

@@ -1,87 +0,0 @@
/**
* Durable offline write-queue store (#33). The invariant mirrors the snapshot
* store's purity: the queue file is a convenience mirror, and a missing or corrupt
* file must degrade to "empty queue", never a crash — losing a queued write is
* bad, but crashing the whole write path is worse. These tests also exercise the
* store together with core's coalescing/replay so the round-trip an offline edit
* takes (enqueue → persist → reload → replay → drain) is covered end to end.
*/
import { mkdtempSync, rmSync, writeFileSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { enqueueWrite, replayQueue, type IssueChange } from '@commitea/core'
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 { loadQueue, saveQueue } from './queue-store.js'
const estChange = (issue: number, estimate = 'est/5d'): IssueChange =>
({ kind: 'reestimate', issue, estimate }) as IssueChange
const assignChange = (issue: number, assignee: string | null): IssueChange =>
({ kind: 'assign', issue, assignee }) as IssueChange
describe('queue-store (#33)', () => {
let dir: string | null = null
const path = () => {
if (!dir) dir = mkdtempSync(join(tmpdir(), 'commitea-queue-'))
return join(dir, 'commitea-write-queue.json')
}
afterEach(() => {
if (dir) rmSync(dir, { recursive: true, force: true })
dir = null
})
it('round-trips a persisted queue', () => {
const p = path()
const queue = enqueueWrite([], estChange(1), '2026-07-11T00:00:00Z')
saveQueue(queue, p)
expect(loadQueue(p)).toEqual(queue)
})
it('a missing file degrades to an empty queue (never a crash)', () => {
// nothing written yet — load must return [] so the write path stays alive
expect(loadQueue(path())).toEqual([])
})
it('a corrupt or wrong-shape file is treated as an empty queue', () => {
const p = path()
writeFileSync(p, '{ not json', 'utf8')
expect(loadQueue(p)).toEqual([])
// valid JSON but not an array (drift) is also rejected
writeFileSync(p, JSON.stringify({ nope: true }), 'utf8')
expect(loadQueue(p)).toEqual([])
})
it('persisted queue coalesces by (issue, axis) across saves — the later intent wins', () => {
const p = path()
// two estimates for the same issue, queued while offline: only the last survives
saveQueue(enqueueWrite(loadQueue(p), estChange(1, 'est/2d'), '2026-07-11T00:00:00Z'), p)
saveQueue(enqueueWrite(loadQueue(p), estChange(1, 'est/8d'), '2026-07-11T00:01:00Z'), p)
// a different axis on the same issue coexists
saveQueue(enqueueWrite(loadQueue(p), assignChange(1, 'ana'), '2026-07-11T00:02:00Z'), p)
const queue = loadQueue(p)
expect(queue).toHaveLength(2)
expect(queue.map((w) => w.change)).toEqual([estChange(1, 'est/8d'), assignChange(1, 'ana')])
})
it('reloads and replays the queue, draining what applies and keeping what fails', async () => {
const p = path()
saveQueue(enqueueWrite(loadQueue(p), estChange(1), '2026-07-11T00:00:00Z'), p)
saveQueue(enqueueWrite(loadQueue(p), assignChange(2, 'ana'), '2026-07-11T00:01:00Z'), p)
// Simulate reconnect: replay through an apply that fails only for issue #2
// (still unreachable / rejected). The successful write drains; the other stays.
const { drained, remaining } = await replayQueue(loadQueue(p), async (c) =>
c.issue === 2 ? { ok: false } : { ok: true },
)
saveQueue(remaining, p)
expect(drained.map((w) => w.change.issue)).toEqual([1])
expect(loadQueue(p).map((w) => w.change.issue)).toEqual([2])
})
})

View File

@@ -1,39 +0,0 @@
/**
* Durable write-queue store — persists propose-approved writes made while gitea
* is unreachable, so they survive a restart and replay on reconnect (#33). A
* plain JSON array of QueuedWrite, mirroring the snapshot store: the queue is
* tiny (one entry per (issue, axis)), so a file is plenty. Never throws — a
* missing or corrupt file degrades to "empty queue", never a crash.
*/
import { readFileSync, writeFileSync } from 'node:fs'
import { join } from 'node:path'
import type { QueuedWrite } from '@commitea/core'
import { app } from 'electron'
function queuePath(): string {
return join(app.getPath('userData'), 'commitea-write-queue.json')
}
/**
* Load the persisted write-queue, or [] if absent/corrupt. `path` is injectable
* for tests; production uses the userData file.
*/
export function loadQueue(path: string = queuePath()): QueuedWrite[] {
try {
const parsed = JSON.parse(readFileSync(path, 'utf8')) as unknown
return Array.isArray(parsed) ? (parsed as QueuedWrite[]) : []
} catch {
return [] // missing file, bad JSON, or drift — treat as empty
}
}
/** Persist the write-queue. Best-effort — a write failure never breaks the caller. */
export function saveQueue(queue: readonly QueuedWrite[], path: string = queuePath()): void {
try {
writeFileSync(path, JSON.stringify(queue), 'utf8')
} catch {
// disk full / permissions — the in-memory result of this call still holds
}
}

View File

@@ -1,86 +0,0 @@
/**
* 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)
})
})

View File

@@ -1,52 +0,0 @@
/**
* 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
}
}

View File

@@ -5,8 +5,6 @@ const api = {
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). */
@@ -15,40 +13,12 @@ const api = {
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'),
/** Discover the owners + repos a token can reach (for the onboarding pickers). */
discover: (conn: unknown) => ipcRenderer.invoke('config:discover', conn),
/** Apply the label schema + ensure the pm-state repo (first-run bootstrap). */
bootstrap: (req: unknown) => ipcRenderer.invoke('config:bootstrap', req),
/** 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),
},

View File

@@ -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 312.
</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>
)
}

View File

@@ -1,35 +1,29 @@
import React from 'react'
import { type BoardColumn, type BoardIssue, type DepsData, type GanttData, type IssueRef } from '../../data/view-types.js'
import { COLUMNS, type BoardColumn, type BoardIssue, 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` arrives from the shell as real reconciled data when gitea is
// configured. `loading` covers the first reconcile.
// `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,
gantt,
deps,
columns = COLUMNS,
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 cols = columns ?? [];
const q = query.trim().toLowerCase();
const filtered = cols.map((c) => ({ ...c, issues: q ? c.issues.filter((i) => (i.title + ' #' + i.id).toLowerCase().includes(q)) : c.issues }));
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 = cols.reduce((n, c) => n + (c.id === 'done' ? 0 : c.issues.length), 0);
const totalIssues = cols.reduce((n, c) => n + 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
@@ -77,10 +71,6 @@ export function BoardScreen({
<Icon name="loader-circle" size={16} />
<span style={{ font: 'var(--text-small)' }}>Reconciling with gitea</span>
</div>
) : totalIssues === 0 ? (
<div style={{ flex: 1, border: '1px dashed var(--line-2)', borderRadius: 'var(--radius-3)' }}>
<EmptyState icon="inbox" title="The pot is empty" line="Nothing in the backlog yet." />
</div>
) : anyMatch ? (
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(5, 1fr)', gap: 12, alignItems: 'start', flex: 1, minHeight: 0, overflow: 'auto' }}>
{filtered.map((col) => (
@@ -96,13 +86,13 @@ export function BoardScreen({
) : (
<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 ${totalIssues} issues; none of them answer to “${query.trim()}”.`} />
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} />
<DepsGraph onOpenIssue={onOpenIssue} />
) : (
<GanttView onOpenIssue={onOpenIssue} data={gantt} />
<GanttView onOpenIssue={onOpenIssue} />
)}
</div>
);

View File

@@ -1,24 +1,12 @@
import React from 'react'
import { type CalibrationData } from '../../data/view-types.js'
import { EmptyState } from '../shell/states.js'
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) drives the whole view.
// `data` (real fit from closed-issue actuals) overrides the demo fixture.
export function CalibrationScreen({ onBack, data }: { onBack: () => void; data?: CalibrationData }) {
if (!data) {
return (
<EmptyState
icon="ruler"
title="Not enough history"
line="Close a few issues and I'll calibrate to your team's actuals."
action="Runway"
onAction={onBack}
/>
)
}
const c = data
const c = data ?? CALIBRATION
// scatter chart geometry
const W = 420,
@@ -112,7 +100,7 @@ export function CalibrationScreen({ onBack, data }: { onBack: () => void; data?:
<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)</p>
<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 }}>
@@ -189,10 +177,7 @@ export function CalibrationScreen({ onBack, data }: { onBack: () => void; data?:
<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: Im 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 cant calibrate, so they dont count toward the 20.`
: ''}
: 'Not enough closed history yet Im forecasting from cold-start priors and widening the cone to stay honest. The curve takes over at 20.'}
</p>
</Card>
</div>

View File

@@ -24,7 +24,10 @@ interface Question {
export function CaptureScreen({ onDone }: { onDone: () => void }) {
const [stage, setStage] = React.useState<'dump' | 'interview' | 'review' | 'filed'>('dump')
const [dump, setDump] = React.useState('')
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)
@@ -70,10 +73,10 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
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'}`)
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 was unable to reach the model, regrettably.') })
.catch(() => { setBrewing(false); setError('I could not reach the model.') })
}
const fileLive = () => {
@@ -84,7 +87,7 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
.then((res) => {
setBrewing(false)
if (res.ok) { setFiledCount(res.created.length); setStage('filed') }
else setError('Filing failed; gitea is not configured.')
else setError('Filing failed gitea is not configured.')
})
.catch(() => { setBrewing(false); setError('Filing failed.') })
}
@@ -99,12 +102,12 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
const QUESTIONS: Question[] = [
{
q: 'The auth work: one ticket, or shall I split token refresh from session storage? They fail differently.',
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.',
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),
},
@@ -205,7 +208,7 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
</header>
{stage === 'dump' ? (
<Card overline="Braindump" title="Do tell me what you are planning" jade>
<Card overline="Braindump" title="Tell me what you're planning" jade>
<textarea
value={dump}
onChange={(e: React.ChangeEvent<HTMLTextAreaElement>) => setDump(e.target.value)}
@@ -217,7 +220,7 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
}}
></textarea>
<p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '10px 0 14px' }}>
Sentences, fragments, grievances; all are welcome. I shall sort them into tickets and enquire only where I cannot infer.
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'}
@@ -262,7 +265,7 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
{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.
Adjust the labels, then approve I'll open them in gitea with only est/* and p/* labels.
</p>
) : (
<>
@@ -286,10 +289,10 @@ export function CaptureScreen({ onDone }: { onDone: () => void }) {
<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.
{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}.
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>

View File

@@ -1,187 +0,0 @@
import React from 'react'
import type { DiscoverResult, PublicConfig } from '../../global.js'
import logoIcon from '../../design/assets/logo-icon.png'
import { Button, Card, Input, Select } from '../ui/index.js'
/**
* Real onboarding — each teammate connects their own Gitea with a personal access
* token. The flow is progressive: enter the instance URL + PAT, and the app
* discovers every owner + repo that token can reach, then you pick them from
* dropdowns (no guessing owner/repo strings). Discovery also proves the token
* works, so any repo you can pick is one you can access. The token is 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 [token, setToken] = React.useState('')
const [modelUrl, setModelUrl] = React.useState(existing?.modelUrl ?? '')
const [owner, setOwner] = React.useState(existing?.owner ?? '')
const [repo, setRepo] = React.useState(existing?.repo ?? '')
const [discovery, setDiscovery] = React.useState<'idle' | 'discovering' | 'done'>('idle')
const [found, setFound] = React.useState<{ owners: string[]; reposByOwner: Record<string, string[]> } | null>(null)
const [error, setError] = React.useState<string | null>(null)
const [state, setState] = React.useState<'idle' | 'saving'>('idle')
const mapError = (e?: string) =>
e === '401' || e === '403'
? 'The token was rejected, check it has repo + issue scopes.'
: e === '404'
? "Couldn't reach that Gitea, check the URL."
: `Discovery failed${e ? ` (${e})` : ''}.`
// Discover the owners + repos this token can see. Triggered when the token
// field blurs (or on Enter), once a URL + token are both present.
const discover = async () => {
if (!baseUrl.trim() || !token.trim() || discovery === 'discovering') return
setError(null)
setDiscovery('discovering')
const res: DiscoverResult = await window.commitea.config
.discover({ baseUrl: baseUrl.trim(), token: token.trim() })
.catch(() => ({ ok: false as const, error: 'unreachable' }))
if (!res.ok) {
setDiscovery('idle')
setFound(null)
setError(mapError(res.error))
return
}
setFound({ owners: res.owners, reposByOwner: res.reposByOwner })
setDiscovery('done')
// keep the existing selection if it's still valid; else default to the token
// owner (res.user) and its first repo.
const nextOwner = res.owners.includes(owner) ? owner : (res.owners.includes(res.user) ? res.user : res.owners[0] ?? '')
setOwner(nextOwner)
const repos = res.reposByOwner[nextOwner] ?? []
setRepo(repos.includes(repo) ? repo : repos[0] ?? '')
}
// Option lists. Before discovery, fall back to the existing config so editing
// stays functional without re-entering the token.
const ownerOptions = found?.owners ?? (existing?.owner ? [existing.owner] : [])
const repoOptions = found?.reposByOwner[owner] ?? (owner && owner === existing?.owner && existing?.repo ? [existing.repo] : [])
const pickerReady = discovery === 'done' || (!!existing && !token.trim())
const ready = baseUrl.trim() && owner && repo && (token.trim() || existing?.hasToken)
const connect = async () => {
setError(null)
setState('saving')
// discovery already validated the token + that this repo is accessible; when
// editing without a new token, reuse the saved one (empty token = keep).
await window.commitea.config.set({ baseUrl: baseUrl.trim(), owner, repo, token: token.trim(), modelUrl: modelUrl.trim() || undefined })
onConnected()
}
const placeholder = (label: string) => [{ value: '', label }]
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.
</p>
<div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
<Input
label="Gitea URL"
value={baseUrl}
placeholder="https://gitea.example.com"
onChange={(e) => {
setBaseUrl(e.target.value)
setDiscovery('idle')
setFound(null)
}}
/>
<Input
label="Access token"
type="password"
value={token}
placeholder={existing?.hasToken ? '•••••••• (saved, enter a new one to change repos)' : 'gitea PAT · scopes: repo + issue'}
hint={
discovery === 'discovering'
? 'Discovering your repositories…'
: discovery === 'done' && found
? `Found ${found.owners.reduce((n, o) => n + (found.reposByOwner[o]?.length ?? 0), 0)} repositories across ${found.owners.length} owner${found.owners.length === 1 ? '' : 's'}.`
: 'Paste your token, then tab out to load your repositories.'
}
onChange={(e) => {
setToken(e.target.value)
setDiscovery('idle')
}}
onBlur={() => void discover()}
onKeyDown={(e) => {
if (e.key === 'Enter') {
e.preventDefault()
void discover()
}
}}
/>
<div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 12 }}>
<Select
label="Owner"
value={owner}
disabled={!pickerReady || ownerOptions.length === 0}
options={
ownerOptions.length
? ownerOptions.map((o) => ({ value: o, label: o }))
: placeholder(discovery === 'discovering' ? 'Loading…' : 'Connect token first')
}
onChange={(e) => {
const o = e.target.value
setOwner(o)
const repos = found?.reposByOwner[o] ?? []
setRepo(repos[0] ?? '')
}}
/>
<Select
label="Repository"
value={repo}
disabled={!pickerReady || repoOptions.length === 0}
options={
repoOptions.length ? repoOptions.map((r) => ({ value: r, label: r })) : placeholder('·')
}
onChange={(e) => setRepo(e.target.value)}
/>
</div>
<Input
label="Model URL"
value={modelUrl}
placeholder="http://localhost:1234/v1"
hint="Optional: an OpenAI-compatible endpoint for Reginald. Leave blank to keep chat off."
onChange={(e) => setModelUrl(e.target.value)}
/>
</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 === 'saving' ? 'Connecting…' : existing ? 'Save' : 'Connect'}
</Button>
</div>
</Card>
</div>
)
}

View File

@@ -1,15 +1,11 @@
import React from 'react'
import { type DepsData, type IssueRef } from '../../data/view-types.js'
import { DEPS, type IssueRef } from '../../data/fixtures.js'
import { Tag, Icon } from '../ui/index.js'
import { EmptyState } from '../shell/states.js'
// Dependency graph drill-in — layered DAG, critical path in spruce
export function DepsGraph({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef) => void; data?: DepsData }) {
if (!data || data.nodes.length === 0) {
return <EmptyState icon="share-2" title="No dependencies" line="Nothing blocks anything yet." />
}
const g = data
export function DepsGraph({ onOpenIssue }: { onOpenIssue: (issue: IssueRef) => void }) {
const g = DEPS
const PAD = 14, COLW = 206, ROWH = 106, NW = 176, NH = 84
const X = (c: number) => PAD + c * COLW
@@ -40,7 +36,7 @@ export function DepsGraph({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef
diagnosis: { icon: 'circle-dashed', color: 'var(--ink-3)', label: 'diagnosis' },
}
const Node = ({ n }: { n: DepsData['nodes'][number] }) => {
const Node = ({ n }: { n: (typeof DEPS.nodes)[number] }) => {
const st = STATES[n.state]
const crit = g.critical.includes(n.id)
return (
@@ -125,6 +121,10 @@ export function DepsGraph({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef
</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>
)
}

View File

@@ -1,120 +1,104 @@
import React from 'react'
import { Badge, Card, Icon } from '../ui/index.js'
import { EmptyState } from '../shell/states.js'
import { DIRECTIVES, type DirectivePending, type DirectiveEntry } from '../../data/fixtures.js'
import { Card, Button, Badge, Icon } from '../ui/index.js'
/** A ledger row, projected from a live DirectiveRecord. */
interface LedgerEntry {
seq: number
when: string
what: string
why: string
kind: string
status: 'applied' | 'amended' | 'withdrawn' | 'proposed'
}
const STATUS_BADGE: Record<LedgerEntry['status'], { tone: 'ok' | 'neutral' | 'info'; label: string }> = {
applied: { tone: 'ok', label: 'applied' },
amended: { tone: 'info', label: 'amended' },
withdrawn: { tone: 'neutral', label: 'withdrawn' },
proposed: { tone: 'info', label: 'proposed' },
}
/**
* Directive ledger — the append-only record of every time a human overruled the
* scheduler (who/when/what/why), read live from the pm-state repo. Directives are
* given in chat and recorded here; this screen only reads them.
*/
// Directive log — append-only ledger + the consequence diff (propose-approve)
export function DirectivesScreen() {
const [entries, setEntries] = React.useState<LedgerEntry[] | null>(null) // null = loading
const [pending, setPending] = React.useState<DirectivePending | null>(DIRECTIVES.pending)
const [entries, setEntries] = React.useState<DirectiveEntry[]>(DIRECTIVES.entries)
React.useEffect(() => {
let alive = true
window.commitea.pmstate
.directives()
.then((r) => {
if (!alive) return
if (!r.ok) {
setEntries([])
return
}
setEntries(
r.directives
.slice()
.reverse() // newest first
.map((d) => ({
seq: d.seq,
when: new Date(d.ts).toLocaleDateString(),
what: d.quote,
why: d.rationale ?? '',
kind: d.kind,
status:
d.status === 'accepted'
? 'applied'
: d.status === 'amended'
? 'amended'
: d.status === 'withdrawn'
? 'withdrawn'
: 'proposed',
})),
)
})
.catch(() => {
if (alive) setEntries([])
})
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 514' : '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>
<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>
{entries === null ? null : entries.length === 0 ? (
<EmptyState
icon="flag"
title="No directives yet"
line="When you overrule the scheduler in chat, it goes on the record here: who, when, what, why."
/>
) : (
<Card overline="The ledger" flush>
<div>
{entries.map((e, i) => {
const sb = STATUS_BADGE[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)' }}>#{String(e.seq).padStart(3, '0')}</span>
<span style={{ width: 1, flex: 1, background: 'var(--line-1)' }} />
</div>
<div style={{ flex: 1, minWidth: 0, display: 'flex', flexDirection: 'column', gap: 5 }}>
<div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
<Badge>{e.kind}</Badge>
<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>
</div>
{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>
)
);
}

View File

@@ -1,16 +1,14 @@
import React from 'react'
import { type FocusIssue, type IssueRef } from '../../data/view-types.js'
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 { EmptyState } from '../shell/states.js'
import { Badge, Button, Card, IconButton, Tag } from '../ui/index.js'
/**
* Morning service — the Now/Next/Later focus cards + the burn-up cone, from the
* scheduler (`focus`) and Monte Carlo forecast (`forecast`). Both come from the
* reconciled backlog; with no open work the scheduler has nothing to pour, so we
* show the empty state.
* 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,
@@ -21,6 +19,7 @@ export function FocusScreen({
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}
@@ -67,18 +66,6 @@ export function FocusScreen({
</Card>
)
// The scheduler returns a FocusView even when the backlog has no open work —
// treat "no now/next/later" as empty, not just an absent `focus`.
if (!focus || (!focus.now && !focus.next && !focus.later)) {
return (
<EmptyState
icon="coffee"
title="Nothing to pour"
line="Capture some work, or enjoy the silence, it never lasts."
/>
)
}
return (
<div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
<header
@@ -93,31 +80,41 @@ export function FocusScreen({
>
<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' }}>
{focus.now ? <FocusRow slot="Now" issue={focus.now} jade /> : null}
{focus.next ? <FocusRow slot="Next" issue={focus.next} /> : null}
{focus.later ? <FocusRow slot="Later" issue={focus.later} /> : null}
{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>
{forecast ? (
<Card
overline="Backlog · open scope"
title={
<Card
overline={forecast ? 'Backlog · open scope' : 'Milestone · Beta'}
title={
forecast ? (
<>80% of the open backlog lands by <span style={{ whiteSpace: 'nowrap' }}>{forecast.rangeLabel}</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.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.`}
</p>
</Card>
) : null}
) : (
<>80% this lands <span style={{ whiteSpace: 'nowrap' }}>Mar 312</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. Im quietly pleased.'}
</p>
</Card>
</div>
)
}

View File

@@ -1,15 +1,11 @@
import React from 'react'
import { type GanttData, type IssueRef } from '../../data/view-types.js'
import { EmptyState } from '../shell/states.js'
import { GANTT, 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 }) {
if (!data || data.rows.length === 0) {
return <EmptyState icon="calendar" title="No schedule yet" line="Estimates and milestones will fill this in." />;
}
const g = data;
export function GanttView({ onOpenIssue }: { onOpenIssue: (issue: IssueRef) => void }) {
const g = GANTT;
const LABELW = 232, DAYW = 21, ROWH = 36, HEADH = 30;
const chartW = g.days * DAYW;
@@ -100,6 +96,10 @@ export function GanttView({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef
})}
</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>
);
}

View File

@@ -1,7 +1,6 @@
import React from 'react'
import { type InboxItem, type IssueRef } from '../../data/view-types.js'
import { EmptyState } from '../shell/states.js'
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
@@ -10,22 +9,15 @@ export function InboxScreen({
onOpenDirectives,
readIds,
setReadIds,
data,
}: {
onOpenIssue: (issue: IssueRef) => void
onOpenDirectives: () => void
readIds: number[]
setReadIds: React.Dispatch<React.SetStateAction<number[]>>
data?: InboxItem[]
}) {
const all = INBOX
const [tab, setTab] = React.useState('all')
if (!data || data.length === 0) {
return <EmptyState icon="bell" title="Inbox zero" line="Nothing needs your eyes right now." />
}
const all = data
const isRead = (n: InboxItem) => !n.unread || readIds.includes(n.id)
const unreadCount = all.filter((n) => !isRead(n)).length

View File

@@ -2,43 +2,34 @@
import React, { useState } from 'react'
import {
describeChange,
type EstimateLabel,
ESTIMATE_LABELS,
type IssueChange,
planIssueChange,
type PriorityLabel,
PRIORITY_LABELS,
summarizeChange,
} from '@commitea/core'
import { type IssueDetail, type IssueRef } from '../../data/view-types.js'
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 = '·'
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 ?? {
const det: IssueDetail = ISSUE_DETAIL[issue.id] || {
state: 'triage',
assignee: 'Stephen',
milestone: 'Beta',
@@ -69,40 +60,25 @@ export function IssueScreen({
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
// the concrete changes this dialog would apply, one per axis 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 diffs = pendingChanges.map((c) => describeChange(planIssueChange(labels, c)))
const apply = async () => {
if (!onApplyChange || pendingChanges.length === 0) return
@@ -117,14 +93,6 @@ export function IssueScreen({
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 }}>
@@ -165,7 +133,7 @@ export function IssueScreen({
<Dialog
open={adjustOpen}
onClose={() => setAdjustOpen(false)}
title="Adjust issue"
title="Adjust estimate & priority"
footer={
<>
<Button variant="ghost" onClick={() => setAdjustOpen(false)}>
@@ -191,35 +159,15 @@ export function IssueScreen({
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.
No change yet pick a different estimate or priority.
</p>
) : (
<>
<p style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', margin: '0 0 6px' }}>
Proposed change
Proposed label change
</p>
{diffs.map((d) => (
<div key={d} style={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>
@@ -227,7 +175,7 @@ export function IssueScreen({
</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.
Writes the label to gitea and re-runs the plan. Nothing else changes.
</p>
</>
)}
@@ -265,7 +213,7 @@ export function IssueScreen({
</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={{
<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',
@@ -319,7 +267,7 @@ export function IssueScreen({
<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 })}
onClick={() => onOpenIssue({ id: b, title: b === 91 ? 'Webhook listener: reconcile on reconnect' : 'Monte Carlo engine: percentile bands', labels: b === 91 ? ['est/3d', 'p/2'] : ['est/5d', 'p/1'] })}
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>
@@ -335,6 +283,12 @@ export function IssueScreen({
</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>

View File

@@ -1,39 +1,21 @@
import React from 'react'
import { type IssueRef } from '../../data/view-types.js'
import { type MilestoneView } from '../../lib/backlog.js'
import { COLUMNS, type IssueRef } from '../../data/fixtures.js'
import { BurnUpCone } from '../charts/chart.js'
import { EmptyState } from '../shell/states.js'
import { Badge, Button, Card, Icon, Tag } from '../ui/index.js'
// Milestone detail — scope, cone, issues; forecasts stay ranges.
export function MilestoneScreen({
onBack,
onOpenIssue,
data,
}: {
onBack: () => void
onOpenIssue: (issue: IssueRef) => void
data?: MilestoneView
}) {
if (!data) {
return (
<EmptyState
icon="flag"
title="Milestone not found"
line="It may have closed or been renamed."
action="Back to Runway"
onAction={onBack}
/>
)
}
// Milestone detail — scope, cone, issues; forecasts stay ranges
export function MilestoneScreen({ onBack, onOpenIssue }: { onBack: () => void; onOpenIssue: (issue: IssueRef) => void }) {
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 groups = data.groups.map((g) => ({ label: g.label, issues: g.issues, muted: g.label === 'Done' }))
const name = data.name
const dueLine = `milestone · due ${data.due} · ${data.soft ? 'soft, scope may flex' : 'hard deadline'}`
const forecastLabel = data.forecastRange ? `80% ${data.forecastRange}` : 'all shipped'
const scopeStat = `${data.scopeCount} issues · est ${data.scopeEstDays}d`
const doneStat = `${data.doneCount} · ${data.donePct}%`
const groups = [
{ 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 },
]
const Stat = ({ label, value, tone }: { label: string; value: string; tone?: string }) => (
<div style={{ flex: 1, padding: '12px 18px', borderRight: '1px solid var(--line-1)' }}>
@@ -54,12 +36,12 @@ export function MilestoneScreen({
<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}
<Icon name="milestone" size={13} /> milestone · due Mar 15 · soft scope may flex
</p>
<h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>{name}</h1>
<h1 style={{ font: 'var(--text-display)', color: 'var(--ink-1)', margin: 0 }}>Beta</h1>
<div style={{ display: 'flex', alignItems: 'center', gap: 8, marginTop: 10 }}>
<Badge tone="ok" dot>{`${data.doneCount}/${data.scopeCount} done`}</Badge>
<span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>{forecastLabel}</span>
<Badge tone="ok" dot>ahead of forecast</Badge>
<span style={{ font: '400 12px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>80% Mar 312</span>
</div>
</div>
<Button variant="secondary" icon="arrow-up-right">Open in Gitea</Button>
@@ -69,23 +51,21 @@ export function MilestoneScreen({
{/* stats strip */}
<Card flush>
<div style={{ display: 'flex' }}>
<Stat label="Scope" value={scopeStat} />
<Stat label="Done" value={doneStat} />
<Stat label="Forecast" value={forecastLabel} />
<Stat label="Scope" value="42 issues · est 61d" />
<Stat label="Done" value="24 · 57%" />
<Stat label="Forecast" value="80% Mar 312" />
<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.scopeCount - data.doneCount} open`}</div>
<div style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', marginBottom: 5 }}>Drift · 7d</div>
<div style={{ font: '500 14px var(--font-mono)', color: 'var(--ok)', whiteSpace: 'nowrap' }}>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.forecastRange ?? 'shipped'}</span></>} jade>
<BurnUpCone data={data.cone ?? undefined} />
<Card overline="Burn-up" title={<>80% this lands <span style={{ whiteSpace: 'nowrap' }}>Mar 312</span></>} jade>
<BurnUpCone />
<p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '10px 0 0' }}>
{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>

View File

@@ -1,121 +1,51 @@
import React from 'react'
import type { BootstrapResult, DiscoverResult } from '../../global.js'
import logoIcon from '../../design/assets/logo-icon.png'
import { Badge, Button, Icon, Input, Radio, Select, Tag } from '../ui/index.js'
import { Badge, Button, Icon, Input, Radio, Tag } from '../ui/index.js'
/**
* First-run onboarding — a real, live wizard. Welcome → Connect (live token
* discovery) → Repo (pick from the repos that token can actually reach) →
* Bootstrap (apply the label schema + create the pm-state sidecar, for real),
* then into the app. Every step talks to the main-process bridge; nothing here
* is faked. The token is saved encrypted in main only after a successful bootstrap.
*/
export function OnboardingScreen({ onConnected }: { onConnected: (dest: 'focus' | 'capture') => void }) {
const [step, setStep] = React.useState(0)
// 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
// connect step
const [baseUrl, setBaseUrl] = React.useState('https://gitea.stephenmann.io')
const [token, setToken] = React.useState('')
const [discovery, setDiscovery] = React.useState<'idle' | 'testing' | 'ok'>('idle')
const [found, setFound] = React.useState<{ user: string; owners: string[]; reposByOwner: Record<string, string[]> } | null>(null)
const [error, setError] = React.useState<string | null>(null)
React.useEffect(() => {
if (conn !== 'testing') return
const t = setTimeout(() => setConn('ok'), 1100)
return () => clearTimeout(t)
}, [conn])
// repo step
const [owner, setOwner] = React.useState('')
const [repo, setRepo] = React.useState('')
// bootstrap step
const [boot, setBoot] = React.useState<'idle' | 'running' | 'done'>('idle')
const [bootResult, setBootResult] = React.useState<Extract<BootstrapResult, { ok: true }> | null>(null)
const repoCount = found ? found.owners.reduce((n, o) => n + (found.reposByOwner[o]?.length ?? 0), 0) : 0
const test = async () => {
if (!baseUrl.trim() || !token.trim() || discovery === 'testing') return
setError(null)
setDiscovery('testing')
const res: DiscoverResult = await window.commitea.config
.discover({ baseUrl: baseUrl.trim(), token: token.trim() })
.catch(() => ({ ok: false as const, error: 'unreachable' }))
if (!res.ok) {
setDiscovery('idle')
setFound(null)
setError(
res.error === '401' || res.error === '403'
? 'The token was rejected: check it has repo + issue scopes.'
: res.error === '404'
? "Couldn't reach that Gitea; check the URL."
: `Connection failed${res.error ? ` (${res.error})` : ''}.`,
)
return
}
setFound({ user: res.user, owners: res.owners, reposByOwner: res.reposByOwner })
setDiscovery('ok')
const o = res.owners.includes(res.user) ? res.user : res.owners[0] ?? ''
setOwner(o)
setRepo(res.reposByOwner[o]?.[0] ?? '')
}
const runBootstrap = async () => {
if (!found || boot === 'running') return
setError(null)
setBoot('running')
const res = await window.commitea.config
.bootstrap({ baseUrl: baseUrl.trim(), token: token.trim(), owner, repo, underOrg: owner !== found.user })
.catch(() => ({ ok: false as const, error: 'unreachable' }))
if (!res.ok) {
setBoot('idle')
setError(`Bootstrap failed${res.error ? ` (${res.error})` : ''}. Nothing was half-applied, you can retry.`)
return
}
// persist the connection now that the repo is prepared
await window.commitea.config.set({ baseUrl: baseUrl.trim(), owner, repo, token: token.trim() })
setBootResult(res)
setBoot('done')
}
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 repoOptions = found?.reposByOwner[owner] ?? []
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%',
}}
>
<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}
{error ? <p style={{ font: 'var(--text-agent)', color: 'var(--danger)', margin: 0 }}>{error}</p> : null}
{footer ? (
<div style={{ display: 'flex', gap: 8, justifyContent: 'flex-end', borderTop: '1px solid var(--line-1)', paddingTop: 16 }}>
{footer}
</div>
) : null}
{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"
>
<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)' }}>
@@ -128,24 +58,15 @@ export function OnboardingScreen({ onConnected }: { onConnected: (dest: 'focus'
{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 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)' }} /> : null}
{i < STEPS.length - 1 ? <span style={{ width: 24, height: 1, background: 'var(--line-2)' }}></span> : null}
</div>
))}
</div>
@@ -155,221 +76,94 @@ export function OnboardingScreen({ onConnected }: { onConnected: (dest: 'focus'
<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 am Reginald, your project manager. I interview you rather than trouble you with forms, and I forecast
in honest ranges.
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 reside in your own Gitea as ordinary issues and labels.
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={discovery !== 'ok'} onClick={() => setStep(2)}>
Continue
</Button>
</>
}
>
<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
value={baseUrl}
onChange={(e) => {
setBaseUrl(e.target.value)
setDiscovery('idle')
setFound(null)
}}
/>
<Input
label="Access token"
icon="keyboard"
mono
type="password"
value={token}
placeholder="gitea PAT"
hint="Scopes: repo, issue."
onChange={(e) => {
setToken(e.target.value)
setDiscovery('idle')
}}
onKeyDown={(e) => {
if (e.key === 'Enter') {
e.preventDefault()
void test()
}
}}
/>
<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={discovery === 'testing' ? 'loader-circle' : 'zap'}
disabled={discovery === 'testing' || !baseUrl.trim() || !token.trim()}
onClick={() => void test()}
>
{discovery === 'testing' ? 'Ringing the bell…' : 'Test connection'}
<Button variant="secondary" icon={conn === 'testing' ? 'loader-circle' : 'zap'} disabled={conn === 'testing'} onClick={() => setConn('testing')}>
{conn === 'testing' ? 'Ringing the bell…' : 'Test connection'}
</Button>
{discovery === 'ok' ? (
<Badge tone="ok" dot>
connected · {repoCount} repo{repoCount === 1 ? '' : 's'} visible
</Badge>
) : null}
{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" disabled={!owner || !repo} onClick={() => setStep(3)}>
Continue
</Button>
</>
}
>
<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>
{found && found.owners.length > 1 ? (
<Select
label="Owner"
value={owner}
options={found.owners.map((o) => ({ value: o, label: o }))}
onChange={(e) => {
const o = e.target.value
setOwner(o)
setRepo(found.reposByOwner[o]?.[0] ?? '')
}}
/>
) : null}
<div style={{ display: 'flex', flexDirection: 'column', gap: 8, maxHeight: 260, overflowY: 'auto' }}>
{repoOptions.map((r) => {
const full = `${owner}/${r}`
const selected = repo === r
return (
<label
key={r}
style={{
display: 'flex',
alignItems: 'center',
gap: 10,
padding: '10px 14px',
cursor: 'pointer',
background: selected ? 'var(--spruce-1)' : 'var(--paper-0)',
border: `1px solid ${selected ? 'var(--spruce-3)' : 'var(--line-1)'}`,
borderRadius: 'var(--radius-2)',
}}
>
<Radio name="repo" checked={selected} onChange={() => setRepo(r)} />
<Icon name="git-branch" size={14} style={{ color: 'var(--ink-3)' }} />
<span style={{ font: 'var(--text-data)', color: 'var(--ink-1)' }}>{full}</span>
</label>
)
})}
<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 switch later in Settings.
</p>
<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 === 'done' ? (
<>
<Button variant="ghost" onClick={() => onConnected('focus')}>
Just look around
</Button>
<Button icon="sparkles" onClick={() => onConnected('capture')}>
Start a capture
</Button>
</>
) : (
<>
<Button variant="ghost" onClick={() => setStep(2)} disabled={boot === 'running'}>
Back
</Button>
<Button icon={boot === 'running' ? 'loader-circle' : undefined} disabled={boot === 'running'} onClick={() => void runBootstrap()}>
{boot === 'running' ? 'Preparing…' : 'Make it so'}
</Button>
</>
)
}
>
<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 === 'done' ? 'All set.' : 'With your approval'}
{boot === 3 ? 'All set.' : 'With your approval'}
</h1>
<p style={{ font: 'var(--text-body)', color: 'var(--ink-2)', margin: 0 }}>
I'll prepare <span style={{ font: 'var(--text-data)', color: 'var(--ink-1)' }}>{owner}/{repo}</span>: apply
the label schema, and create the pm-state sidecar for machine-derived state.
</p>
<div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
<BootTask
state={boot}
label={
bootResult
? bootResult.labels.created.length
? `Applied the label schema (${bootResult.labels.created.length} created, ${bootResult.labels.existing.length} already there)`
: `Label schema already applied (${bootResult.labels.existing.length} labels)`
: `Apply the label schema to ${owner}/${repo}`
}
/>
<BootTask
state={boot}
label={
bootResult
? bootResult.pmState === 'created'
? `Created ${owner}/${bootResult.pmStateRepo} (the sidecar)`
: `${owner}/${bootResult.pmStateRepo} already exists`
: `Create ${owner}/${repo}-pm-state (the sidecar)`
}
/>
{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 }}>
{(bootResult ? [...bootResult.labels.created, ...bootResult.labels.existing] : [
'est/1d',
'est/2d',
'est/3d',
'est/5d',
'est/8d',
'p/1',
'p/2',
'p/3',
'p/4',
'deadline/hard',
]).map((l) => (
<Tag key={l} label={l} />
))}
{['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</span>
</div>
)
}
function BootTask({ state, label }: { state: 'idle' | 'running' | 'done'; label: string }) {
const icon = state === 'done' ? 'circle-check' : state === 'running' ? 'loader-circle' : 'circle-dashed'
const color = state === 'done' ? 'var(--ok)' : state === 'running' ? 'var(--warn)' : 'var(--ink-3)'
return (
<div style={{ display: 'flex', alignItems: 'center', gap: 10 }}>
<span style={{ display: 'inline-flex', color }}>
<Icon name={icon} size={15} />
</span>
<span style={{ font: 'var(--text-body)', color: state === 'done' ? 'var(--ink-1)' : 'var(--ink-2)' }}>{label}</span>
<span style={{ font: '400 11px var(--font-mono)', color: 'var(--ink-3)' }}>first run · everything reversible</span>
</div>
)
}

View File

@@ -1,63 +1,35 @@
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 { EmptyState } from '../shell/states.js'
import { type RunwayMilestone } from '../../data/view-types.js'
import { RUNWAY, CAPACITY } from '../../data/fixtures.js'
// Runway — capacity vs milestone dates; ranges, never points.
// `milestones` (real per-milestone forecasts) + `capacity` (real config) override the demo.
// Runway — capacity vs milestone dates; ranges, never points
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[]
onOpenMilestone: () => void
calibration?: { n: number; coldStart: boolean }
}) {
if (!milestones || !milestones.length) {
return (
<EmptyState
icon="chart-line"
title="No runway yet"
line="Add milestones and estimates and I'll project the finish."
/>
);
}
const rows = milestones
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`,
}))
: []
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'} cant calibrate` : '')
? `cold-start priors · ${calibration.n}/20 closed issues estimated`
: `calibrated on ${calibration.n} closed ${calibration.n === 1 ? 'issue' : 'issues'}`
: null
: '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 ? ` · ${calibNote}` : ''}</p>
<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={{
{RUNWAY.map((m, i) => (
<div key={m.name} onClick={onOpenMilestone} 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)',
}}
@@ -83,7 +55,7 @@ export function RunwayScreen({
<div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 14, alignItems: 'start' }}>
<Card overline="Capacity" flush>
<div>
{capacityRows.map((p, i) => (
{CAPACITY.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)',
@@ -101,7 +73,14 @@ export function RunwayScreen({
))}
</div>
</Card>
<Card overline="Calibration" actions={<IconButton icon="arrow-up-right" label="Full report" size="sm" onClick={onOpenCalibration} />} />
<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>
);

View File

@@ -1,36 +1,13 @@
import React from 'react'
import type { PublicConfig } from '../../global.js'
import { Badge, Button, Card, Icon, Radio, Tag } from '../ui/index.js'
import { Badge, Button, Card, Icon, IconButton, Input, Radio, Select, Switch, Tag } from '../ui/index.js'
// Settings — gitea connection, sync behaviour, model, label schema, appearance.
export function SettingsScreen({
dark,
setDark,
connection,
onReconnect,
onDisconnect,
}: {
dark: boolean
setDark: (v: boolean) => void
connection?: PublicConfig | null
onReconnect?: () => void
onDisconnect?: () => void
}) {
const [model, setModel] = React.useState<{ configured: boolean; model: string | null } | null>(null)
React.useEffect(() => {
let alive = true
window.commitea.model
.status()
.then((s) => {
if (alive) setModel(s)
})
.catch(() => {})
return () => {
alive = false
}
}, [])
// Settings — gitea connection, sync, model roles, labels, rituals, appearance
export function SettingsScreen({ dark, setDark }: { dark: boolean; setDark: (v: boolean) => 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>
@@ -43,112 +20,99 @@ export function SettingsScreen({
<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' }}>
connection lives on this machine · the plan lives in gitea
</p>
<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={{ 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>
<div style={{ display: 'flex', flexDirection: 'column', gap: 14 }}>
<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', flexDirection: 'column', gap: 8 }}>
<span style={{ font: '600 13px/1.2 var(--font-sans)', color: 'var(--ink-1)' }}>Managed repos</span>
<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 }}>stephen/commitea</span>
<Badge tone="ok" dot>syncing</Badge>
<IconButton icon="x" label="Stop managing" size="sm" />
</Row>
)}
<Row style={{ padding: '8px 12px', background: 'var(--paper-0)', border: '1px solid var(--line-1)', borderRadius: 'var(--radius-2)' }}>
<Icon name="layers" size={14} style={{ color: 'var(--ink-3)' }} />
<span style={{ font: 'var(--text-data)', color: 'var(--ink-1)', flex: 1 }}>stephen/pm-state</span>
<Badge>sidecar</Badge>
</Row>
<Note>The sidecar holds machine-derived state only. Delete it and resync no truth is lost.</Note>
<Button variant="secondary" size="sm" icon="plus" style={{ alignSelf: 'flex-start' }}>Add repo</Button>
</div>
</div>
</Card>
<Card overline="Sync" title="Staying current">
<div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
<Row style={{ gap: 8 }}>
<Icon name="refresh-cw" size={14} style={{ color: 'var(--ink-3)' }} />
<span style={{ font: 'var(--text-body)', color: 'var(--ink-1)' }}>
Reconciles on launch and after every write
</span>
<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>
<Note>Offline, the board reads from the last cached snapshot.</Note>
<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="Model" title="Reginald's brain">
<div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
{model?.configured ? (
<Row style={{ gap: 8 }}>
<Icon name="sparkles" size={14} style={{ color: 'var(--ink-3)' }} />
<span style={{ font: 'var(--text-data)', color: 'var(--ink-1)', flex: 1 }}>{model.model}</span>
<Badge tone="ok" dot>
reachable
</Badge>
</Row>
) : (
<Row style={{ gap: 8 }}>
<Icon name="sparkles" size={14} style={{ color: 'var(--ink-3)' }} />
<span style={{ font: 'var(--text-body)', color: 'var(--ink-2)', flex: 1 }}>
Chat is off: no model reachable.
</span>
<Button variant="secondary" size="sm" onClick={onReconnect}>
Set a Model URL
</Button>
</Row>
)}
<Note>
An OpenAI-compatible endpoint (set it in Reconfigure).
</Note>
<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} />
))}
{['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} />
))}
{['p/1', 'p/2', 'p/3', 'p/4'].map((l) => <Tag key={l} label={l} />)}
<Tag label="deadline/hard" />
</Row>
<Note>The fixed label vocabulary, visible in gitea.</Note>
<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>
@@ -158,6 +122,16 @@ export function SettingsScreen({
<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>
)
}

View File

@@ -1,7 +1,6 @@
import React from 'react'
import { type IssueRef, type StandupData } from '../../data/view-types.js'
import { EmptyState } from '../shell/states.js'
import { type IssueRef, STANDUP } from '../../data/fixtures.js'
import { Badge, Button, Icon } from '../ui/index.js'
const standupCSS = `
@@ -37,12 +36,18 @@ const toneColor: Record<string, string> = {
export function StandupScreen({
onBegin,
onOpenIssue,
data,
}: {
onBegin: () => void
onOpenIssue: (issue: IssueRef) => void
data?: StandupData
}) {
const s = STANDUP
const NAG_REF: IssueRef = {
id: s.nag.id,
title: 'Fix lifecycle inference on merge events',
labels: ['est/2d', 'p/1'],
days: s.nag.days,
}
const Section = ({ overline, order, children }: { overline: string; order: number; children: React.ReactNode }) => (
<section
className="ct-standup-section"
@@ -65,22 +70,6 @@ export function StandupScreen({
</section>
)
if (!data) {
return (
<EmptyState
icon="sun"
title="Nothing to report"
line="No overnight drift. I'll have a plan when there's work to pour."
/>
)
}
const s = data
const NAG_REF: IssueRef = {
id: s.nag.id,
days: s.nag.days,
}
return (
<div style={{ maxWidth: 660, margin: '0 auto' }}>
<article
@@ -96,7 +85,7 @@ export function StandupScreen({
}}
>
<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}</p>
<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>
@@ -161,59 +150,39 @@ export function StandupScreen({
</Section>
<Section overline="Stale blockers" order={3}>
{s.nag.id === 0 ? (
// Calm sentinel — nothing is over-steeping; render just the reassurance,
// no issue chrome, no click target (there's no #0 to open).
<div
style={{
display: 'flex',
gap: 10,
alignItems: 'center',
background: 'var(--paper-2)',
borderRadius: 'var(--radius-2)',
padding: '12px 14px',
}}
>
<span style={{ color: 'var(--ok)', display: 'inline-flex' }}>
<Icon name="circle-check" size={15} />
</span>
<p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: 0 }}>{s.nag.text}</p>
</div>
) : (
<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
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
@@ -228,7 +197,7 @@ export function StandupScreen({
}}
>
<p style={{ font: 'var(--text-agent-lg)', color: 'var(--ink-1)', margin: 0, flex: 1 }}>
The kettle is on. Yours, Reginald.
The kettles on. R.
</p>
<Button variant="ghost" onClick={onBegin}>
Ask about the drift

View File

@@ -3,26 +3,10 @@ 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/view-types.js'
import { ConnectScreen } from '../screens/connect-screen.js'
import {
backlogCalibration,
capacityWorkers,
forecastBacklog,
issuesToBoardColumns,
milestoneView,
runwayView,
scheduleFocus,
} from '../../lib/backlog.js'
import type { IssueRef } from '../../data/fixtures.js'
import { backlogCalibration, forecastBacklog, issuesToBoardColumns, 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'
@@ -37,7 +21,8 @@ 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 { OfflineBanner } from './states.js'
import { PlaceholderScreen } from './placeholder-screen.js'
import { OfflineBanner, StatesScreen } from './states.js'
type View =
| 'standup'
@@ -48,6 +33,9 @@ type View =
| 'runway'
| 'directives'
| 'settings'
| 'states'
| 'firstrun'
| 'primitives'
| 'issue'
| 'calibration'
| 'milestone'
@@ -59,24 +47,47 @@ interface NavEntry {
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 [pubConfig, setPubConfig] = useState<PublicConfig | null>(null)
const [collaborators, setCollaborators] = useState<{ login: string; name: string }[]>([])
const [backlog, refetchBacklog] = useBacklog()
// Real connectivity: the reconcile serves the stale cache (or errors with no
// cache) only when gitea is unreachable. No manual toggle — this is the truth.
const offline = backlog.status === 'error' || (backlog.status === 'ready' && backlog.stale)
const staleSince = backlog.status === 'ready' ? backlog.savedAt : undefined
const pending = backlog.status === 'ready' ? backlog.pending : 0
const capacityMembers = useCapacity()
const workers = capacityWorkers(capacityMembers)
const boardColumns =
backlog.status === 'ready' ? issuesToBoardColumns(backlog.issues, backlog.timelines) : undefined
const focus =
@@ -85,97 +96,16 @@ export function AppShell() {
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)
? (forecastBacklog(backlog.issues, backlog.deps, new Date(), calibration?.model) ?? 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); null until the first reconcile lands.
const inboxUnread = inbox
? inbox.filter((n) => n.unread && !readIds.includes(n.id)).length
: null
// 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: demo (e2e serves the demo snapshot) or configured → the shell;
// otherwise → the connect screen (each teammate brings their own token).
useEffect(() => {
window.commitea.gitea
.status()
.then((s) => {
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.
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)
setIssue(ref)
setView('issue')
}
@@ -183,19 +113,17 @@ export function AppShell() {
// 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 && !res.queued) {
if (res.ok) {
setIssue((cur) => (cur && cur.id === res.issue.number ? { ...cur, labels: res.issue.labels } : cur))
refetchBacklog()
}
// Re-sync either way: an applied write to refresh the board, a queued one to
// pick up the new pending count (the reconcile reports it while offline).
if (res.ok) 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: 'inbox', label: 'Inbox', icon: 'bell', count: INBOX_UNREAD || null },
{ id: 'capture', label: 'Capture', icon: 'plus' },
{ id: 'board', label: 'The pot', icon: 'square-kanban' },
{ id: 'runway', label: 'Runway', icon: 'chart-line' },
@@ -253,14 +181,12 @@ export function AppShell() {
case 'focus':
return <FocusScreen onOpenIssue={openIssue} focus={focus} forecast={forecast} />
case 'standup':
return <StandupScreen onBegin={() => setView('focus')} onOpenIssue={openIssue} data={standup} />
return <StandupScreen onBegin={() => setView('focus')} onOpenIssue={openIssue} />
case 'board':
return (
<BoardScreen
onOpenIssue={openIssue}
columns={boardColumns}
gantt={gantt}
deps={depsGraph}
loading={backlog.status === 'loading'}
/>
)
@@ -268,27 +194,14 @@ export function AppShell() {
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}
onOpenMilestone={() => setView('milestone')}
calibration={calibration ? { n: calibration.model.n, coldStart: calibration.model.coldStart } : undefined}
/>
)
case 'calibration':
return <CalibrationScreen onBack={() => setView('runway')} data={calibration?.data} />
case 'milestone':
return <MilestoneScreen onBack={() => setView('runway')} onOpenIssue={openIssue} data={milestone} />
return <MilestoneScreen onBack={() => setView('runway')} onOpenIssue={openIssue} />
case 'inbox':
return (
<InboxScreen
@@ -296,7 +209,6 @@ export function AppShell() {
onOpenDirectives={() => setView('directives')}
readIds={readIds}
setReadIds={setReadIds}
data={inbox}
/>
)
case 'capture':
@@ -304,58 +216,29 @@ export function AppShell() {
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')
})
}}
/>
)
return <SettingsScreen dark={dark} setDark={setDark} />
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 null
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') {
const onConnected = (dest?: 'focus' | 'capture') => {
window.commitea.config.get().then(setPubConfig).catch(() => {})
if (dest) setView(dest)
setGate('ready')
refetchBacklog()
}
// First run (no saved config) → the full live wizard; reconnecting/editing an
// existing connection → the compact card.
return pubConfig ? (
<ConnectScreen existing={pubConfig} onConnected={() => onConnected()} />
) : (
<OnboardingScreen onConnected={onConnected} />
)
// First run is full-window — no rail, no chat panel
if (view === 'firstrun') {
return <OnboardingScreen onDone={(dest) => setView(dest)} />
}
return (
@@ -395,25 +278,27 @@ export function AppShell() {
<div style={{ borderTop: '1px solid var(--line-1)', margin: '10px 8px' }} />
<NavItem item={{ id: 'settings', label: 'Settings', icon: 'settings-2' }} />
<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' }} />
<div style={{ marginTop: 'auto', padding: '0 12px', display: 'flex', flexDirection: 'column', gap: 12 }}>
<div
title={
backlog.status === 'loading'
? `Connecting to ${hostLabel}`
: offline
? `Offline, reading from cache${staleSince ? ` (since ${new Date(staleSince).toLocaleString()})` : ''}`
: `Connected to ${hostLabel}`
}
aria-label={
backlog.status === 'loading' ? 'Connection: connecting' : offline ? 'Connection: offline' : 'Connection: online'
}
<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
@@ -421,13 +306,12 @@ export function AppShell() {
width: 6,
height: 6,
borderRadius: '50%',
background:
backlog.status === 'loading' ? 'var(--warn)' : offline ? 'var(--danger)' : 'var(--ok)',
background: offline ? 'var(--danger)' : 'var(--ok)',
display: 'inline-block',
}}
/>
{hostLabel}
</div>
gitea.stephenmann.io
</button>
<Switch
label={<span style={{ font: 'var(--text-caption)' }}>Evening service</span>}
checked={dark}
@@ -448,7 +332,7 @@ export function AppShell() {
gap: 14,
}}
>
{offline ? <OfflineBanner queued={pending} /> : null}
{offline ? <OfflineBanner /> : null}
{renderScreen()}
</div>
</main>

View File

@@ -1,6 +1,6 @@
import React, { useEffect, useRef, useState } from 'react'
import type { IssueChange } from '@commitea/core'
import { describeChange, type IssueChange } from '@commitea/core'
import { useChat } from '../../lib/use-chat.js'
import { Button, Icon, IconButton } from '../ui/index.js'
@@ -19,7 +19,7 @@ export interface ChatPanelProps {
}
export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPanelProps) {
const { msgs, thinking, live, model, steps, proposals, streaming, send: sendChat, approve, dismiss } = useChat(onApplyChange)
const { msgs, thinking, live, model, steps, proposals, 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('')
@@ -28,7 +28,7 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
useEffect(() => {
const el = scrollRef.current
if (el) el.scrollTop = el.scrollHeight
}, [msgs, thinking, streaming])
}, [msgs, thinking])
const send = () => {
const t = text.trim()
@@ -62,7 +62,7 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
<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'}
{offline ? 'offline · queueing' : live ? `${modelLabel} · local` : 'demo · scripted'}
</span>
<IconButton icon="history" label="Directive log" size="sm" onClick={onOpenDirectives} />
</header>
@@ -98,17 +98,10 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
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 ? <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(', ')}
<Icon name="eye" size={11} /> consulted {Array.from(new Set(steps.map((s) => s.replace('query_project', 'the project').replace('propose_change', 'the labels')))).join(', ')}
</div>
) : null}
{proposals.map((p) => (
@@ -127,7 +120,7 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
<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={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>{describeChange(p.plan)}</div>
<div style={{ display: 'flex', gap: 8 }}>
<Button size="sm" onClick={() => approve(p)} disabled={offline}>
Approve
@@ -161,8 +154,8 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
send()
}
}}
placeholder={offline ? 'Writes wait for the connection…' : live ? 'Tell me what to do…' : 'Add a Model URL in Settings…'}
disabled={offline || !live}
placeholder={offline ? 'Writes wait for the connection…' : 'Tell me what to do…'}
disabled={offline}
rows={1}
style={{
flex: 1,
@@ -180,15 +173,15 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
type="button"
onClick={send}
aria-label="Send"
disabled={offline || !live}
disabled={offline}
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)',
cursor: offline ? 'not-allowed' : 'pointer',
background: offline ? 'var(--paper-3)' : 'var(--accent)',
color: offline ? 'var(--ink-3)' : 'var(--ink-inverse)',
display: 'inline-flex',
alignItems: 'center',
justifyContent: 'center',
@@ -198,6 +191,9 @@ export function ChatPanel({ onOpenDirectives, offline, onApplyChange }: ChatPane
<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>
)

View File

@@ -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 Reginalds 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>
)
}

View File

@@ -1,11 +1,11 @@
import React from 'react'
import { Button, Icon } from '../ui/index.js'
import { Badge, Button, Icon } from '../ui/index.js'
/**
* Shared empty / trouble states, reused across real screens: EmptyState for
* "nothing here yet", OfflineBanner when a reconcile is serving the stale cache,
* ModelAwayState when Reginald's model endpoint is unconfigured/unreachable.
* 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 {
@@ -55,11 +55,10 @@ export function EmptyState({ icon, title, line, action, onAction, compact }: Emp
}
export interface OfflineBannerProps {
/** Writes approved while offline, held for replay on reconnect. */
queued?: number
retryIn?: string
}
export function OfflineBanner({ queued = 0 }: OfflineBannerProps) {
export function OfflineBanner({ retryIn }: OfflineBannerProps) {
return (
<div
style={{
@@ -76,12 +75,10 @@ export function OfflineBanner({ queued = 0 }: OfflineBannerProps) {
<Icon name="triangle-alert" size={15} />
</span>
<span style={{ font: 'var(--text-small)', color: 'var(--ink-1)', flex: 1 }}>
{queued > 0
? `Gitea isnt answering. Im holding ${queued} ${queued === 1 ? 'change' : 'changes'} and shall apply ${queued === 1 ? 'it' : 'them'} on reconnect.`
: 'Gitea isnt answering. Ill keep trying and say nothing more about it.'}
Gitea isnt answering. Ill keep trying and say nothing more about it.
</span>
<span style={{ font: '400 11.5px var(--font-mono)', color: 'var(--ink-2)', whiteSpace: 'nowrap' }}>
{queued > 0 ? `${queued} queued · reads from cache` : 'reads from cache'}
retry in {retryIn || '0:12'} · reads from cache
</span>
</div>
)
@@ -96,6 +93,9 @@ export function ModelAwayState() {
</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.
@@ -103,3 +103,130 @@ export function ModelAwayState() {
</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 youre planning and Ill 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 rails connection dot to see it live)">
<div style={{ padding: 12 }}>
<OfflineBanner />
</div>
</Specimen>
<div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 14 }}>
<Specimen label="reginalds 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>
)
}

View File

@@ -12,7 +12,6 @@ export * from './tag.js'
export * from './card.js'
export * from './tabs.js'
export * from './input.js'
export * from './select.js'
export * from './checkbox.js'
export * from './radio.js'
export * from './switch.js'

View File

@@ -18,8 +18,6 @@ export interface InputProps {
value?: string;
defaultValue?: string;
onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
onBlur?: (e: React.FocusEvent<HTMLInputElement>) => void;
onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
disabled?: boolean;
type?: string;
style?: React.CSSProperties;

View File

@@ -0,0 +1,528 @@
/**
* 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 — Ive 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 doesnt care for calibration either. Logged as a directive.',
},
]
export const CANNED_REPLY =
'Noted and logged as a directive. The scheduler is re-running — Ill 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. Id 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:1402: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 312' },
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. Id 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
}
export const RUNWAY: RunwayMilestone[] = [
{ name: 'Beta', due: 'Mar 15', hard: false, p80: 'Mar 312', 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 }
}
export const CALIBRATION: CalibrationData = {
n: 27,
active: true,
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 4653d', 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: 'Betas 80% window moved', detail: 'Mar 312 → Mar 514 · 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:1402: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 1113', note: 'from your est/2d history · n=14' },
blocks: [91, 92],
blockedBy: [],
note: 'It blocks #91 and #92. Id 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 312', to: 'Mar 514' },
{ 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' },
],
}

View File

@@ -1,237 +0,0 @@
/**
* View-model types — the contract between the renderer's view builders
* (`lib/views/*`, `lib/backlog.ts`) and the screens that render their output.
* These are screen-shaped (post-builder) types only; there is no demo data here.
* Live data flows in through the main-process bridge and the builders; when a
* builder has nothing to produce, the screen renders an EmptyState.
*/
export interface ChatMessage {
from: 'agent' | 'user'
text: string
}
export interface FocusIssue {
id: number
title: string
labels: string[]
steeping?: string
rationale: string
}
export interface FocusData {
now: FocusIssue
next: FocusIssue
later: FocusIssue
}
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
}
/** 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[]
}
// ---- 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[]
}
// ---- 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[]
}
// ---- 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. */
id?: number
}
export interface CapacityMember {
who: string
hours: string
focus: number
slices: string
}
// ---- 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
}
// ---- 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
}
// ---- 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
}

View File

@@ -1,11 +1,9 @@
import type {
AgentStep,
CapacityMember,
ChangeProposal,
ChatMessage,
CaptureProposal,
DependencyEdge,
DirectiveRecord,
GiteaIssue,
GiteaMilestone,
IssueChange,
@@ -17,10 +15,7 @@ import type {
/** The result of a write through the bridge. */
export type ApplyChangeResult =
| { ok: false; reason: 'unconfigured' }
// Offline: the write was queued for replay on reconnect. `pending` is the queue depth.
| { ok: true; queued: true; pending: number }
// `plan` is present for label swaps (est/p); absent for field writes (assign, milestone).
| { ok: true; queued?: false; plan?: LabelPlan; issue: GiteaIssue }
| { ok: true; plan: LabelPlan; issue: GiteaIssue }
/** The result of filing captured issues. */
export type CreateIssuesResult =
@@ -32,77 +27,20 @@ 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
/** Writes queued while offline, awaiting replay on reconnect. */
pending?: number
}
/** 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 result of token-scoped discovery for the onboarding pickers. */
export type DiscoverResult =
| { ok: false; error?: string }
| { ok: true; user: string; owners: string[]; reposByOwner: Record<string, string[]> }
/** What the first-run bootstrap changed (label schema + pm-state sidecar). */
export type BootstrapResult =
| { ok: false; error?: string }
| { ok: true; labels: { created: string[]; existing: string[] }; pmState: 'created' | 'exists'; pmStateRepo: string }
/** The config bridge for team onboarding. */
export interface ConfigBridge {
get(): Promise<PublicConfig | null>
discover(conn: { baseUrl: string; token: string }): Promise<DiscoverResult>
bootstrap(req: { baseUrl: string; token: string; owner: string; repo: string; underOrg: boolean }): Promise<BootstrapResult>
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>
status(): Promise<{ configured: boolean; repo: string | null }>
reconcile(): Promise<{
configured: boolean
issues: GiteaIssue[]
milestones: GiteaMilestone[]
deps: DependencyEdge[]
/** Normalized lifecycle events keyed by issue number. */
timelines: Record<number, LifecycleEvent[]>
}>
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. */
@@ -115,24 +53,6 @@ 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 {
@@ -141,8 +61,6 @@ declare global {
platform: string
gitea: GiteaBridge
model: ModelBridge
pmstate: PmStateBridge
config: ConfigBridge
}
}
}

View File

@@ -1,18 +1,12 @@
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,
@@ -22,17 +16,10 @@ import {
type ScheduledItem,
selectFocus,
toDurationModel,
workingDaysBetween,
} from '@commitea/core'
import {
type BoardColumn,
type BoardIssue,
type CalibrationData,
type FocusIssue,
type RunwayMilestone,
} from '../data/view-types.js'
import { addWorkingDays, type BurnUpData, buildBurnUpData, formatRange, formatShort } from './dates.js'
import { type BoardColumn, type BoardIssue, type CalibrationData, type FocusIssue } from '../data/fixtures.js'
import { type BurnUpData, buildBurnUpData } from './dates.js'
type Timelines = Record<number, LifecycleEvent[]>
@@ -112,15 +99,9 @@ function toSchedulable(issues: GiteaIssue[]) {
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
@@ -143,10 +124,9 @@ export function forecastBacklog(
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 f = forecast(toSchedulable(issues), deps, model ? { model } : {})
const cone = buildBurnUpData(f, today)
if (!cone) return null
return {
@@ -173,11 +153,10 @@ export function backlogCalibration(
issues: GiteaIssue[],
timelines: Timelines = {},
asOf: Date = new Date(),
): { model: CalibrationModel; data: CalibrationData; coverage: CalibrationCoverage } {
): { model: CalibrationModel; data: CalibrationData } {
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) }
return { model, data: calibrationData(model, samples, issues) }
}
const pctFromMu = (mu: number) => Math.round((Math.exp(mu) - 1) * 100)
@@ -191,7 +170,6 @@ 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)
@@ -200,7 +178,7 @@ export function calibrationData(
return {
label: `est/${b}d`,
n: fit ? fit.n : inBucket.length,
median: inBucket.length ? `${(b * Math.exp(mu)).toFixed(1)}d` : '·',
median: inBucket.length ? `${(b * Math.exp(mu)).toFixed(1)}d` : '',
bias: fit ? pctFromMu(fit.mu) : null,
}
})
@@ -216,7 +194,7 @@ export function calibrationData(
.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: `${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`,
@@ -231,7 +209,6 @@ export function calibrationData(
scatter: samples.map((s) => [s.estimateDays, s.actualWorkingDays]),
fit: Number(Math.exp(model.global.mu).toFixed(2)),
effect,
excludedSameDay,
}
}
@@ -255,138 +232,3 @@ export function scheduleFocus(
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,
}
}

View File

@@ -12,20 +12,13 @@ export type BacklogState =
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
/** Writes queued while offline, awaiting replay on reconnect. */
pending: number
}
/**
* 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.
* Reconcile the managed repo through the main-process bridge. Runs once on
* mount; the returned `refetch` re-reconciles after a write so the board and
* forecast reflect the change. `unconfigured` means no token — the UI falls
* back to demo fixtures. Errors (network, bad token) surface as `error`.
*/
export function useBacklog(): [BacklogState, () => void] {
const [state, setState] = useState<BacklogState>({ status: 'loading' })
@@ -34,31 +27,6 @@ export function useBacklog(): [BacklogState, () => void] {
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,
pending: b.pending ?? 0,
},
)
})
.catch(() => {})
}
window.commitea.gitea
.reconcile()
.then((r) => {
@@ -71,20 +39,12 @@ export function useBacklog(): [BacklogState, () => void] {
milestones: r.milestones,
deps: r.deps,
timelines: r.timelines,
stale: r.stale ?? false,
savedAt: r.savedAt,
pending: r.pending ?? 0,
}
: { 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) },
)
}
if (alive) setState({ status: 'error', message: e instanceof Error ? e.message : String(e) })
})
return () => {
alive = false

View File

@@ -1,24 +0,0 @@
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
}

View File

@@ -2,16 +2,11 @@ import { useCallback, useEffect, useRef, useState } from 'react'
import type { ChangeProposal, ChatMessage as WireMessage, IssueChange } from '@commitea/core'
import { type ChatMessage } from '../data/view-types.js'
import { CANNED_REPLY, CHAT, type ChatMessage } from '../data/fixtures.js'
const LIVE_GREETING: ChatMessage = {
from: 'agent',
text: 'Good morning. Do ask me anything about the project; I shall consult the board before I venture an answer.',
}
const NO_MODEL: ChatMessage = {
from: 'agent',
text: 'I am afraid I am rather off duty without a model. Kindly add a Model URL in Settings and I shall be at your service.',
text: 'Morning. Ask me anything about the project I check the real board before I answer.',
}
export interface ChatState {
@@ -25,8 +20,6 @@ export interface ChatState {
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
@@ -34,21 +27,20 @@ export interface ChatState {
/**
* Reginald's conversation. When a model is configured, `send` drives one agent
* turn through the main-process bridge (which runs the tool loop). With no model,
* the panel shows a clean "off" greeting and the composer is disabled — no
* scripted replies. The 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).
* 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[]>([])
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
@@ -60,14 +52,10 @@ export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: b
window.commitea.model
.status()
.then((s) => {
if (!alive) return
if (s.configured) {
if (alive && 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(() => {})
@@ -87,8 +75,10 @@ export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: b
setProposals([])
if (!live) {
// no model configured — nothing to send (composer is disabled anyway)
setThinking(false)
window.setTimeout(() => {
setThinking(false)
setConvo((c) => [...c, { from: 'agent', text: CANNED_REPLY }])
}, 900)
return
}
@@ -96,17 +86,10 @@ export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: b
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()
setThinking(false)
if (res.ok) {
setSteps(res.steps.map((s) => s.tool))
setProposals(res.proposals)
@@ -116,17 +99,14 @@ export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: b
...c,
{
from: 'agent',
text:
res.reason === 'error'
? `I have struck a snag, I am afraid: ${res.message ?? 'unknown error'}.`
: 'No model is configured.',
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 was unable to reach the model, regrettably.' }])
setThinking(false)
setConvo((c) => [...c, { from: 'agent', text: 'I could not reach the model.' }])
})
},
[live],
@@ -136,16 +116,15 @@ export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: b
(p: ChangeProposal) => {
if (!onApplyChange) return
drop(p)
const label = p.plan.added[0] ?? p.plan.removed[0] ?? 'change'
void onApplyChange(p.change).then((res) => {
setConvo((c) => [
...c,
{
from: 'agent',
text: !res.ok
? `Regrettably that did not take; #${p.change.issue} remains unchanged.`
: 'queued' in res && res.queued
? `We are offline, so I have set #${p.change.issue}: ${p.summary} aside; I shall apply it the moment gitea is within reach.`
: `Very good. #${p.change.issue}: ${p.summary}. The plan has been re-run.`,
text: res.ok
? `Done — #${p.change.issue} is now ${label}. The plan's been re-run.`
: `That didn't take — #${p.change.issue} is unchanged.`,
},
])
})
@@ -155,8 +134,8 @@ export function useChat(onApplyChange?: (change: IssueChange) => Promise<{ ok: b
const dismiss = useCallback((p: ChangeProposal) => {
drop(p)
setConvo((c) => [...c, { from: 'agent', text: `As you wish. #${p.change.issue} remains as it was.` }])
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 }
return { msgs: [...seed, ...convo], thinking, live, model, steps, proposals, send, approve, dismiss }
}

View File

@@ -1,195 +0,0 @@
import { inferLifecycle, schedule } from '@commitea/core'
import type { DepEdge, DepNode, DepsData } from '../../data/view-types.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
}

View File

@@ -1,130 +0,0 @@
import { forecast, inferLifecycle, scheduleWithCapacity, workingDaysBetween } from '@commitea/core'
import type { GanttData, GanttRow, GanttWeek } from '../../data/view-types.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,
}
}

View File

@@ -1,112 +0,0 @@
import { inferLifecycle } from '@commitea/core'
import type { InboxItem } from '../../data/view-types.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)
}

View File

@@ -1,72 +0,0 @@
import {
forecast,
inferLifecycle,
type LifecycleStages,
toDurationModel,
} from '@commitea/core'
import type { IssueDetail } from '../../data/view-types.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(', ')}.` : ''}` : '',
}
}

View File

@@ -1,17 +0,0 @@
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
}

View File

@@ -1,157 +0,0 @@
import {
type DependencyEdge,
type GiteaIssue,
inferLifecycle,
schedule,
type ScheduledItem,
} from '@commitea/core'
import type { DriftItem, Nag, PlanItem, StandupData } from '../../data/view-types.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),
}
}

View File

@@ -1,14 +0,0 @@
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'],
},
})

View File

@@ -1,4 +1,4 @@
import { beforeAll, describe, expect, it } from 'vitest'
import { describe, expect, it } from 'vitest'
import { extractLabelFacts } from '../labels/label-schema.js'
import type { FetchLike, GiteaIssue } from '../gitea/types.js'
@@ -10,22 +10,11 @@ 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.
* proving the model calls query_project and narrates the real result.
*/
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'
})
const MODEL = process.env.COMMITEA_MODEL_SMALL ?? 'google/gemma-4-e4b'
function issue(over: Partial<GiteaIssue>): GiteaIssue {
const labels = over.labels ?? []
@@ -70,34 +59,4 @@ describe('agent loop (live model)', () => {
},
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,
)
})

View File

@@ -31,20 +31,18 @@ function stringify(result: unknown): string {
}
export async function runAgentTurn(opts: {
complete: (messages: ChatMessage[], tools?: ToolDecl[], onToken?: (delta: string) => void) => Promise<CompletionResult>
complete: (messages: ChatMessage[], tools?: ToolDecl[]) => 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)
const { content, toolCalls } = await opts.complete(convo, opts.tools)
if (toolCalls.length === 0) {
convo.push({ role: 'assistant', content })
return { content, steps, messages: convo }
@@ -65,7 +63,7 @@ export async function runAgentTurn(opts: {
}
// Out of tool budget — force a final prose answer with tools withheld.
const final = await opts.complete(convo, [], opts.onToken)
const final = await opts.complete(convo, [])
convo.push({ role: 'assistant', content: final.content })
return { content: final.content, steps, messages: convo }
}

View File

@@ -11,17 +11,16 @@ 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.',
'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'],
enum: ['focus', 'board', 'calibration', 'issue', 'search'],
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.",
'issue = one issue (needs filters.issueId); search = issues matching filters.query.',
},
filters: {
type: 'object',
@@ -39,58 +38,27 @@ export const QUERY_PROJECT_TOOL: ToolDecl = {
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.',
"Propose an estimate and/or priority change to an issue. This does NOT apply anything — it shows the " +
'human a diff to approve. Use it whenever the user asks to re-estimate or reprioritize. After calling it, ' +
"tell the user you've *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_TOOLS: ToolDecl[] = [QUERY_PROJECT_TOOL, PROPOSE_CHANGE_TOOL]
export const REGINALD_SYSTEM = [
'You are Reginald, the unfailingly composed project manager within CommiTea, a tool that runs projects on Gitea. You carry yourself with the dry, understated poise of a seasoned butler: courteous, precise, and never effusive.',
'Ground every answer in the real project by calling query_project first; you never invent issues, figures, or dates.',
'The scheduler and forecasts are deterministic; report their output faithfully and do not attempt the arithmetic yourself.',
'To alter an estimate, priority, assignee, or milestone, call propose_change, which lays the matter before the principal as a diff for approval.',
'When the principal states standing intent (say, "pilots first" or "freeze scope"), record it with record_directive.',
'Never declare a change applied; you propose, and the principal disposes. Forecasts are offered as ranges, never a single date.',
'Refer to issues as #<number>. Be concise and courteous: a sentence or two, no preamble, no bulleted dumps. Write in plain prose, and never use an em dash; a comma, colon, or full stop will serve.',
'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 or priority, call propose_change — it shows the human a diff to approve.',
'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(' ')

View File

@@ -25,48 +25,6 @@ describe('createChatClient', () => {
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)
@@ -276,7 +234,6 @@ describe('buildProjectView', () => {
})
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' })
expect(buildProjectView('standup', undefined, snap, asOf)).toEqual({ notImplemented: 'standup' })
})
})

View File

@@ -53,11 +53,10 @@ export const PROPOSE_ISSUES_TOOL: ToolDecl = {
}
export const CAPTURE_SYSTEM = [
'You are Reginald, distilling a rough braindump into a small set of concrete Gitea issues, with your customary butlerly precision.',
'Call propose_issues exactly once. Separate genuinely distinct work; consolidate trivially-coupled work; invent no scope.',
'Each issue receives an imperative title, a one-line body, an estimate (est/1d…8d) and a priority (p/1…4).',
'Estimate honestly; a "quick" task is seldom a single day. Keep the set tight, for three considered issues surpass eight vague ones.',
'Write in plain prose, and never use an em dash; a comma, colon, or full stop will serve.',
'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 {

View File

@@ -48,12 +48,8 @@ export interface CompletionResult {
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>
complete(messages: ChatMessage[], tools?: ToolDecl[]): Promise<CompletionResult>
}
/** Map our message shape to the OpenAI wire shape. */
@@ -89,7 +85,7 @@ export function createChatClient(config: ModelConfig, fetchImpl: FetchLike): Cha
const url = `${config.baseUrl.replace(/\/+$/, '')}/chat/completions`
return {
async complete(messages, tools, onToken) {
async complete(messages, tools) {
const body: Record<string, unknown> = {
model: config.model,
messages: messages.map(toWireMessage),
@@ -99,13 +95,11 @@ export function createChatClient(config: ModelConfig, fetchImpl: FetchLike): Cha
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',
Accept: 'application/json',
...(config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}),
},
body: JSON.stringify(body),
@@ -114,8 +108,6 @@ export function createChatClient(config: ModelConfig, fetchImpl: FetchLike): Cha
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 {
@@ -129,56 +121,3 @@ export function createChatClient(config: ModelConfig, fetchImpl: FetchLike): Cha
},
}
}
/** 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 })) }
}

View File

@@ -1,71 +0,0 @@
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'))
})
})

View File

@@ -1,102 +0,0 @@
/**
* 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')
}

View File

@@ -1,74 +0,0 @@
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([])
})
})

View File

@@ -4,9 +4,9 @@
* 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.
* v0 serves focus / board / calibration / issue. The remaining views
* (milestone / runway / standup / search) return a `notImplemented` marker so
* the model degrades honestly instead of inventing data.
*/
import { fitCalibration, calibrationSamples } from '../calibration/calibration-v0.js'
@@ -121,62 +121,6 @@ function searchView(snap: ProjectSnapshot, filters: QueryFilters) {
}
}
/**
* 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,
@@ -196,8 +140,6 @@ export function buildProjectView(
return issueView(snap, f, asOf)
case 'search':
return searchView(snap, f)
case 'standup':
return standupView(snap, asOf)
default:
return { notImplemented: view }
}

View File

@@ -1,191 +0,0 @@
/**
* 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([])
})
})

View File

@@ -1,92 +0,0 @@
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()
})
})

View File

@@ -1,159 +0,0 @@
/**
* 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),
}
}

View File

@@ -5,7 +5,6 @@ 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,
@@ -119,26 +118,4 @@ describe('calibrationSamples', () => {
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)
})
})

View File

@@ -125,40 +125,3 @@ export function calibrationSamples(
}
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 }
}

View File

@@ -1,88 +0,0 @@
import { describe, expect, it } from 'vitest'
import { type DependencyEdge, type SchedulableIssue } from '../scheduler/scheduler-v0.js'
import { makespan, scheduleWithCapacity, type Worker } from '../scheduler/scheduler-capacity-v0.js'
import { capacityPerWorkday, parseCapacityConfig } from './capacity-v0.js'
describe('capacity model', () => {
it('capacityPerWorkday = focusFactor × allocation', () => {
expect(capacityPerWorkday({ person: 'a', focusFactor: 0.8, allocation: 0.5 })).toBeCloseTo(0.4)
})
it('parses + clamps config, drops invalid members', () => {
const members = parseCapacityConfig({
members: [
{ person: 'christian', focusFactor: 0.8, allocation: 1 },
{ person: 'ak', focusFactor: 1.5, allocation: -1 }, // clamps to 1 / 0 → zero capacity → dropped
{ focusFactor: 0.8 }, // no person → dropped
],
})
expect(members).toEqual([{ person: 'christian', focusFactor: 0.8, allocation: 1 }])
})
it('returns [] for a non-array/absent members field', () => {
expect(parseCapacityConfig({})).toEqual([])
expect(parseCapacityConfig({ members: 'nope' })).toEqual([])
})
})
function issue(number: number, over: Partial<SchedulableIssue> = {}): SchedulableIssue {
return { number, title: `#${number}`, labels: [], estimateDays: 4, priority: 2, ...over }
}
describe('scheduleWithCapacity', () => {
it('with no workers, falls back to the single serial plan', () => {
const issues = [issue(1), issue(2)]
const plan = scheduleWithCapacity(issues, [], [])
expect(makespan(plan)).toBe(8) // 4 + 4 serial
})
it('parallelizes independent work across lanes (makespan shrinks)', () => {
const issues = [issue(1), issue(2), issue(3), issue(4)] // 4×4d = 16d serial
const one: Worker[] = [{ person: 'a', speed: 1 }]
const two: Worker[] = [
{ person: 'a', speed: 1 },
{ person: 'b', speed: 1 },
]
expect(makespan(scheduleWithCapacity(issues, [], one))).toBe(16)
expect(makespan(scheduleWithCapacity(issues, [], two))).toBe(8) // two lanes → half
})
it('scales duration by a lane speed (slower lane takes longer)', () => {
const plan = scheduleWithCapacity([issue(1, { estimateDays: 4 })], [], [{ person: 'a', speed: 0.5 }])
expect(plan.items[0].durationDays).toBe(8) // 4 / 0.5
expect(plan.items[0].worker).toBe('a')
})
it('routes an issue to its assignee lane', () => {
const issues = [issue(1, { assignee: 'ak' }), issue(2, { assignee: 'sm' })]
const workers: Worker[] = [
{ person: 'ak', speed: 1 },
{ person: 'sm', speed: 1 },
]
const plan = scheduleWithCapacity(issues, [], workers)
const byN = Object.fromEntries(plan.items.map((i) => [i.number, i]))
expect(byN[1].worker).toBe('ak')
expect(byN[2].worker).toBe('sm')
// both start at 0 (different lanes) → parallel
expect(byN[1].startDay).toBe(0)
expect(byN[2].startDay).toBe(0)
})
it('adds a lane for an assignee not in the config (mean speed)', () => {
const plan = scheduleWithCapacity([issue(1, { assignee: 'newbie' })], [], [{ person: 'a', speed: 0.5 }])
expect(plan.items[0].worker).toBe('newbie')
expect(plan.items[0].durationDays).toBe(8) // mean speed 0.5 → 4/0.5
})
it('respects dependencies across lanes (a blocker finishes before its dependent starts)', () => {
const edges: DependencyEdge[] = [{ issue: 2, dependsOn: 1 }]
const workers: Worker[] = [
{ person: 'a', speed: 1 },
{ person: 'b', speed: 1 },
]
const plan = scheduleWithCapacity([issue(1), issue(2)], edges, workers)
const byN = Object.fromEntries(plan.items.map((i) => [i.number, i]))
expect(byN[2].startDay).toBeGreaterThanOrEqual(byN[1].endDay) // #2 waits for #1 even on another lane
})
})

View File

@@ -1,49 +0,0 @@
/**
* Capacity model (#8). A member's throughput is `focusFactor × allocation` =
* ideal person-days of project work delivered per calendar working day. The
* scheduler treats each member as a lane whose task durations are scaled by that
* rate (a 0.5-capacity person takes twice as long on an est/2d task). Config
* lives in the pm-state repo (`capacity/members.yaml/json`, D4); estimates are
* in ideal person-days (pm-state.md).
*/
export interface CapacityMember {
/** gitea login. */
person: string
/** Productive fraction of a working day (0..1). */
focusFactor: number
/** Fraction of that allocated to this project (0..1). */
allocation: number
}
/** Ideal person-days delivered per calendar working day. */
export function capacityPerWorkday(m: CapacityMember): number {
return m.focusFactor * m.allocation
}
function clamp01(n: unknown, fallback: number): number {
return typeof n === 'number' && Number.isFinite(n) ? Math.min(1, Math.max(0, n)) : fallback
}
/**
* Validate a raw capacity config (`{ members: [...] }`) into members. Unknown
* shapes degrade to `[]` (→ the scheduler falls back to a single worker), never
* throw. focusFactor/allocation clamp to [0,1]; a member without a person is dropped.
*/
export function parseCapacityConfig(raw: unknown): CapacityMember[] {
const list = (raw as { members?: unknown })?.members
if (!Array.isArray(list)) return []
const out: CapacityMember[] = []
for (const m of list) {
const r = (m ?? {}) as Record<string, unknown>
const person = typeof r.person === 'string' ? r.person.trim() : ''
if (!person) continue
const member: CapacityMember = {
person,
focusFactor: clamp01(r.focusFactor, 0.8),
allocation: clamp01(r.allocation, 1),
}
if (capacityPerWorkday(member) > 0) out.push(member)
}
return out
}

View File

@@ -1,13 +1,6 @@
import { describe, expect, it } from 'vitest'
import {
describeChange,
isLabelChange,
type IssueChange,
planIssueChange,
proposalsFor,
summarizeChange,
} from './apply-changes-v0.js'
import { describeChange, type IssueChange, planIssueChange, proposalsFor } from './apply-changes-v0.js'
describe('planIssueChange', () => {
it('swaps the estimate label, keeping non-axis labels', () => {
@@ -65,31 +58,11 @@ describe('proposalsFor', () => {
const props = proposalsFor({ issue: 2, estimate: 'est/5d', priority: 'p/1' }, ['est/2d', 'p/3'], 'ChangeSource')
expect(props).toHaveLength(2)
expect(props[0].change).toEqual({ kind: 'reestimate', issue: 2, estimate: 'est/5d' })
expect(props[0].summary).toBe('est/2d → est/5d')
expect(describeChange(props[0].plan)).toBe('est/2d → est/5d')
expect(props[1].change).toEqual({ kind: 'reprioritize', issue: 2, priority: 'p/1' })
expect(props[0].issueTitle).toBe('ChangeSource')
})
it('proposes an assignment only when it differs from the current assignee', () => {
const change = proposalsFor({ issue: 2, assignee: 'christian' }, [], undefined, { currentAssignee: null })
expect(change).toHaveLength(1)
expect(change[0].change).toEqual({ kind: 'assign', issue: 2, assignee: 'christian' })
expect(change[0].summary).toBe('assign → @christian')
expect(change[0].plan).toBeUndefined()
// already assigned → no proposal
expect(proposalsFor({ issue: 2, assignee: 'christian' }, [], undefined, { currentAssignee: 'christian' })).toEqual([])
})
it('proposes a milestone move, labeled from the milestones list, skipping a no-op', () => {
const ctx = { currentMilestoneId: 1, milestones: [{ id: 3, title: 'P5 — Dogfood' }] }
const props = proposalsFor({ issue: 2, milestone: 3 }, [], undefined, ctx)
expect(props).toHaveLength(1)
expect(props[0].change).toEqual({ kind: 'remilestone', issue: 2, milestone: 3, milestoneTitle: 'P5 — Dogfood' })
expect(props[0].summary).toBe('milestone → P5 — Dogfood')
// same milestone → no proposal
expect(proposalsFor({ issue: 2, milestone: 1 }, [], undefined, ctx)).toEqual([])
})
it('drops a noop axis (already at the requested value)', () => {
const props = proposalsFor({ issue: 2, estimate: 'est/2d', priority: 'p/1' }, ['est/2d', 'p/3'])
expect(props.map((p) => p.change.kind)).toEqual(['reprioritize']) // estimate unchanged
@@ -104,31 +77,3 @@ describe('proposalsFor', () => {
expect(proposalsFor({ issue: 2 }, ['est/2d'])).toEqual([])
})
})
describe('unified change model (assign + milestone)', () => {
it('isLabelChange narrows label kinds only', () => {
expect(isLabelChange({ kind: 'reestimate', issue: 1, estimate: 'est/2d' })).toBe(true)
expect(isLabelChange({ kind: 'reprioritize', issue: 1, priority: 'p/1' })).toBe(true)
expect(isLabelChange({ kind: 'assign', issue: 1, assignee: 'christian' })).toBe(false)
expect(isLabelChange({ kind: 'remilestone', issue: 1, milestone: 3 })).toBe(false)
})
it('summarizeChange describes an assignment and an unassignment', () => {
expect(summarizeChange({ kind: 'assign', issue: 1, assignee: 'christian' })).toBe('assign → @christian')
expect(summarizeChange({ kind: 'assign', issue: 1, assignee: null })).toBe('unassign')
})
it('summarizeChange describes a milestone set (by title) and removal', () => {
expect(summarizeChange({ kind: 'remilestone', issue: 1, milestone: 3, milestoneTitle: 'P5 — Dogfood' })).toBe(
'milestone → P5 — Dogfood',
)
expect(summarizeChange({ kind: 'remilestone', issue: 1, milestone: 3 })).toBe('milestone → #3')
expect(summarizeChange({ kind: 'remilestone', issue: 1, milestone: null })).toBe('remove from milestone')
})
it('summarizeChange delegates label kinds to describeChange (needs current labels)', () => {
const change: IssueChange = { kind: 'reestimate', issue: 1, estimate: 'est/5d' }
expect(summarizeChange(change, ['est/2d'])).toBe('est/2d → est/5d')
expect(summarizeChange(change, ['est/5d'])).toBe('no change')
})
})

View File

@@ -17,15 +17,6 @@ import {
export type IssueChange =
| { kind: 'reestimate'; issue: number; estimate: EstimateLabel | null }
| { kind: 'reprioritize'; issue: number; priority: PriorityLabel | null }
| { kind: 'assign'; issue: number; assignee: string | null }
| { kind: 'remilestone'; issue: number; milestone: number | null; milestoneTitle?: string | null }
/** The label axes are the only kinds planned as a label swap; the rest are field writes. */
export function isLabelChange(
change: IssueChange,
): change is Extract<IssueChange, { kind: 'reestimate' | 'reprioritize' }> {
return change.kind === 'reestimate' || change.kind === 'reprioritize'
}
export interface LabelPlan {
/** The full resulting label-name set (order: kept labels, then the new axis label). */
@@ -38,10 +29,7 @@ export interface LabelPlan {
noop: boolean
}
/** A change that resolves to a label swap (the only kind `planIssueChange` accepts). */
export type LabelChange = Extract<IssueChange, { kind: 'reestimate' | 'reprioritize' }>
function axisFor(change: LabelChange): { labels: readonly string[]; target: string | null } {
function axisFor(change: IssueChange): { labels: readonly string[]; target: string | null } {
return change.kind === 'reestimate'
? { labels: ESTIMATE_LABELS, target: change.estimate }
: { labels: PRIORITY_LABELS, target: change.priority }
@@ -52,7 +40,7 @@ function axisFor(change: LabelChange): { labels: readonly string[]; target: stri
* change's axis except the target, adds the target if absent. Setting the axis
* to null clears it. Cleans up a duplicated axis (two `est/*`) as a side effect.
*/
export function planIssueChange(current: string[], change: LabelChange): LabelPlan {
export function planIssueChange(current: string[], change: IssueChange): LabelPlan {
const { labels: axis, target } = axisFor(change)
const onAxis = current.filter((l) => axis.includes(l))
const removed = onAxis.filter((l) => l !== target)
@@ -70,52 +58,18 @@ export function describeChange(plan: LabelPlan): string {
return `${from}${to}`
}
/**
* One human-readable confirm line for ANY change kind — the unified describe for
* the propose-approve UI. Label kinds delegate to {@link describeChange} (so they
* need the issue's current labels); assign/milestone describe the field write
* directly. Pure; no network.
*/
export function summarizeChange(change: IssueChange, currentLabels: string[] = []): string {
switch (change.kind) {
case 'reestimate':
case 'reprioritize':
return describeChange(planIssueChange(currentLabels, change))
case 'assign':
return change.assignee ? `assign → @${change.assignee}` : 'unassign'
case 'remilestone':
return change.milestone == null
? 'remove from milestone'
: `milestone → ${change.milestoneTitle ?? `#${change.milestone}`}`
}
}
/** A change the agent proposes: the concrete op + its human diff, ready for approve-then-apply. */
/** A change the agent proposes: the concrete op + its diff, ready for approve-then-apply. */
export interface ChangeProposal {
change: IssueChange
/** One-line diff for the approve UI — always present ({@link summarizeChange}). */
summary: string
/** The label plan, for label kinds only (absent for assign/milestone). */
plan?: LabelPlan
plan: LabelPlan
issueTitle?: string
}
/** What the `propose_change` tool accepts — a target issue and the fields to set. */
/** What the `propose_change` tool accepts — a target issue and the axes to set. */
export interface ProposeChangeArgs {
issue: number
estimate?: EstimateLabel
priority?: PriorityLabel
/** Login to assign, or null to unassign. Omit to leave assignee untouched. */
assignee?: string | null
/** Milestone id to set, or null to clear. Omit to leave the milestone untouched. */
milestone?: number | null
}
/** Current state + lookups a proposal needs to skip noops and label the milestone. */
export interface ProposalContext {
currentAssignee?: string | null
currentMilestoneId?: number | null
milestones?: { id: number; title: string }[]
}
function isEstimate(v: unknown): v is EstimateLabel {
@@ -126,33 +80,25 @@ function isPriority(v: unknown): v is PriorityLabel {
}
/**
* Build the concrete, non-noop proposals for a `propose_change` request. Label
* axes (est/*, p/*) are validated and never invented; assign/milestone are
* emitted only when they differ from the issue's current value (via `ctx`). Each
* proposal carries a human `summary`; label kinds also carry the label plan.
* Build the concrete, non-noop proposals for a `propose_change` request against
* an issue's current labels. Invalid or unchanged axes are dropped — the agent
* proposes only real changes, and never a label outside the est/* · p/* axes.
*/
export function proposalsFor(
args: ProposeChangeArgs,
currentLabels: string[],
issueTitle?: string,
ctx: ProposalContext = {},
): ChangeProposal[] {
const out: ChangeProposal[] = []
const pushLabel = (change: LabelChange) => {
if (isEstimate(args.estimate)) {
const change: IssueChange = { kind: 'reestimate', issue: args.issue, estimate: args.estimate }
const plan = planIssueChange(currentLabels, change)
if (!plan.noop) out.push({ change, plan, summary: describeChange(plan), issueTitle })
if (!plan.noop) out.push({ change, plan, issueTitle })
}
if (isEstimate(args.estimate)) pushLabel({ kind: 'reestimate', issue: args.issue, estimate: args.estimate })
if (isPriority(args.priority)) pushLabel({ kind: 'reprioritize', issue: args.issue, priority: args.priority })
if (args.assignee !== undefined && args.assignee !== (ctx.currentAssignee ?? null)) {
const change: IssueChange = { kind: 'assign', issue: args.issue, assignee: args.assignee }
out.push({ change, summary: summarizeChange(change), issueTitle })
}
if (args.milestone !== undefined && args.milestone !== (ctx.currentMilestoneId ?? null)) {
const milestoneTitle = ctx.milestones?.find((m) => m.id === args.milestone)?.title ?? null
const change: IssueChange = { kind: 'remilestone', issue: args.issue, milestone: args.milestone, milestoneTitle }
out.push({ change, summary: summarizeChange(change), issueTitle })
if (isPriority(args.priority)) {
const change: IssueChange = { kind: 'reprioritize', issue: args.issue, priority: args.priority }
const plan = planIssueChange(currentLabels, change)
if (!plan.noop) out.push({ change, plan, issueTitle })
}
return out
}

View File

@@ -1,66 +0,0 @@
import { describe, expect, it } from 'vitest'
import {
appendDirective,
makeDirectiveEntry,
parseDirectiveLog,
serializeDirective,
toDirectiveInput,
} from './record-directive-v0.js'
describe('toDirectiveInput', () => {
it('keeps a valid kind + target and drops an empty target', () => {
const input = toDirectiveInput({ kind: 'reprioritize', quote: 'pilots first', target: { issue: 87 }, rationale: 'blocked' })
expect(input).toEqual({ kind: 'reprioritize', quote: 'pilots first', target: { issue: 87 }, params: undefined, rationale: 'blocked' })
expect(toDirectiveInput({ kind: 'note', quote: 'x', target: {} }).target).toBeUndefined()
})
it('falls back to note for an unknown kind', () => {
expect(toDirectiveInput({ kind: 'nonsense', quote: 'hmm' }).kind).toBe('note')
})
})
describe('serialize + parse round-trip', () => {
const entry = makeDirectiveEntry(
{ kind: 'reprioritize', quote: 'pilots come first', target: { issue: 87 } },
'id-1',
'2026-02-01T09:00:00Z',
)
it('serializes to one JSON line', () => {
const line = serializeDirective(entry)
expect(line).not.toContain('\n')
expect(JSON.parse(line)).toMatchObject({ id: 'id-1', kind: 'reprioritize', status: 'accepted' })
})
it('parses a log, orders by ts, and assigns a 1-based seq', () => {
const a = serializeDirective(makeDirectiveEntry({ kind: 'note', quote: 'later' }, 'b', '2026-02-02T00:00:00Z'))
const b = serializeDirective(makeDirectiveEntry({ kind: 'note', quote: 'earlier' }, 'a', '2026-02-01T00:00:00Z'))
const records = parseDirectiveLog(`${a}\n${b}\n`)
expect(records.map((r) => r.quote)).toEqual(['earlier', 'later'])
expect(records.map((r) => r.seq)).toEqual([1, 2])
})
it('skips blank and corrupt lines without losing the rest', () => {
const good = serializeDirective(entry)
const records = parseDirectiveLog(`\n{not json\n${good}\n\n`)
expect(records).toHaveLength(1)
expect(records[0].id).toBe('id-1')
})
})
describe('appendDirective', () => {
it('concatenates a newline-terminated entry, normalizing a missing trailing newline', () => {
const e1 = makeDirectiveEntry({ kind: 'note', quote: 'one' }, 'i1', '2026-01-01T00:00:00Z')
const e2 = makeDirectiveEntry({ kind: 'note', quote: 'two' }, 'i2', '2026-01-02T00:00:00Z')
let log = appendDirective('', e1)
log = appendDirective(log, e2)
expect(parseDirectiveLog(log).map((r) => r.quote)).toEqual(['one', 'two'])
expect(log.endsWith('\n')).toBe(true)
})
it('handles existing text without a trailing newline', () => {
const e = makeDirectiveEntry({ kind: 'note', quote: 'x' }, 'i', '2026-01-01T00:00:00Z')
expect(appendDirective('{"id":"prev","ts":"2025-01-01T00:00:00Z"}', e).split('\n').filter(Boolean)).toHaveLength(2)
})
})

View File

@@ -1,106 +0,0 @@
/**
* record_directive — the PM's standing instructions ("pilots come first"),
* appended to an append-only JSONL ledger in the pm-state repo (decisions.md D4,
* pm-state.md). A directive is *intent*: it's logged verbatim; its effects land
* later through apply_changes. Merge is concatenation — order derives from `ts`
* at read time, so two writers never conflict. `seq` is a display ordinal
* computed on read, never stored. This module is pure serialize/parse; the
* append (read → concat → write) is the bridge's job.
*/
export type DirectiveKind = 'reprioritize' | 'reestimate' | 'set-deadline' | 'scope' | 'capacity' | 'note'
export type DirectiveStatus = 'proposed' | 'accepted' | 'amended' | 'withdrawn'
export interface DirectiveTarget {
issue?: number
milestone?: number
member?: string
}
/** What the record_directive tool captures. */
export interface DirectiveInput {
kind: DirectiveKind
/** Verbatim PM words, shown in the ledger. */
quote: string
target?: DirectiveTarget
/** Structured effect the scheduler applies, e.g. { priority: 1 }. */
params?: Record<string, unknown>
rationale?: string
}
/** A ledger entry — an input plus its durable id/ts/status. */
export interface DirectiveEntry extends DirectiveInput {
id: string
ts: string
status: DirectiveStatus
}
/** A ledger entry as read back, with a computed display ordinal. */
export interface DirectiveRecord extends DirectiveEntry {
seq: number
}
const DIRECTIVE_KINDS: readonly DirectiveKind[] = [
'reprioritize',
'reestimate',
'set-deadline',
'scope',
'capacity',
'note',
]
/** Normalize a raw tool payload into a DirectiveInput (unknown kind → note). */
export function toDirectiveInput(raw: unknown): DirectiveInput {
const r = (raw ?? {}) as Record<string, unknown>
const kind = DIRECTIVE_KINDS.includes(r.kind as DirectiveKind) ? (r.kind as DirectiveKind) : 'note'
const target = (r.target ?? undefined) as DirectiveTarget | undefined
return {
kind,
quote: typeof r.quote === 'string' ? r.quote : '',
target: target && (target.issue || target.milestone || target.member) ? target : undefined,
params: (r.params && typeof r.params === 'object' ? (r.params as Record<string, unknown>) : undefined),
rationale: typeof r.rationale === 'string' ? r.rationale : undefined,
}
}
/** Build a full entry from an input + externally-supplied id/ts (Date/uuid live in the caller). */
export function makeDirectiveEntry(
input: DirectiveInput,
id: string,
ts: string,
status: DirectiveStatus = 'accepted',
): DirectiveEntry {
return { ...input, id, ts, status }
}
/** One JSONL line (no trailing newline — the caller joins). */
export function serializeDirective(entry: DirectiveEntry): string {
return JSON.stringify(entry)
}
/**
* Parse a JSONL log into records ordered by `ts` (then id for stability), with a
* 1-based `seq` assigned on read. Blank/corrupt lines are skipped, not fatal.
*/
export function parseDirectiveLog(text: string): DirectiveRecord[] {
const entries: DirectiveEntry[] = []
for (const line of text.split('\n')) {
const trimmed = line.trim()
if (!trimmed) continue
try {
const e = JSON.parse(trimmed) as DirectiveEntry
if (e && typeof e.id === 'string' && typeof e.ts === 'string') entries.push(e)
} catch {
// skip a corrupt line rather than lose the whole ledger
}
}
entries.sort((a, b) => (a.ts === b.ts ? a.id.localeCompare(b.id) : a.ts.localeCompare(b.ts)))
return entries.map((e, i) => ({ ...e, seq: i + 1 }))
}
/** Append a serialized entry to existing log text (concatenation merge). */
export function appendDirective(existing: string, entry: DirectiveEntry): string {
const base = existing.endsWith('\n') || existing === '' ? existing : existing + '\n'
return `${base}${serializeDirective(entry)}\n`
}

View File

@@ -120,20 +120,4 @@ describe('forecast', () => {
expect(fitted.coldStart).toBe(false)
expect(fitted.p50Day).toBeLessThan(priors.p50Day)
})
it('capacity lanes parallelize the sim — the makespan shrinks with more workers', () => {
const independent = [issue(1), issue(2), issue(3), issue(4)] // no deps → fully parallelizable
const serial = forecast(independent, [], { trials: 2000, seed: 7 })
const twoLanes = forecast(independent, [], {
trials: 2000,
seed: 7,
workers: [
{ person: 'a', speed: 1 },
{ person: 'b', speed: 1 },
],
})
// two equal lanes ≈ half the serial landing (independent work)
expect(twoLanes.p80Day).toBeLessThan(serial.p80Day)
expect(twoLanes.p80Day).toBeLessThan(serial.p80Day * 0.7)
})
})

View File

@@ -18,7 +18,6 @@ import {
schedule,
type SchedulableIssue,
} from '../scheduler/scheduler-v0.js'
import { type LaneInputs, layoutOnLanes, resolveLanes, type Worker } from '../scheduler/scheduler-capacity-v0.js'
export interface LognormalPrior {
/** Median log-ratio: sampled median duration = estimate * e^mu. */
@@ -77,12 +76,6 @@ export interface ForecastOptions {
* the sim; otherwise the code-resident cold-start priors do.
*/
model?: DurationModel
/**
* Capacity lanes. When provided, each trial lays sampled durations across the
* lanes (parallel) instead of a single serial worker — the makespan shrinks
* toward the critical path. Empty/absent → single serial worker.
*/
workers?: Worker[]
}
/** Resolve the lognormal params for an estimate, preferring a fitted model. */
@@ -165,32 +158,15 @@ export function forecast(
const priors = order.map((it) => durationParams(it.durationDays, options.model))
const rng = mulberry32(seed)
// Capacity lanes, when configured — the per-trial layout goes parallel.
const laneInputs: LaneInputs = {
order: order.map((it) => it.number),
blockedBy: new Map(order.map((it) => [it.number, it.blockedBy])),
assignee: new Map(issues.map((i) => [i.number, i.assignee ?? null])),
}
const lanes =
options.workers && options.workers.length ? resolveLanes(options.workers, [...laneInputs.assignee.values()]) : null
// endByRank[k][t] = working day the (k+1)-th issue *to finish* completes on trial t.
// endByRank[k][t] = working day the (k+1)-th scheduled issue completes on trial t.
const endByRank: number[][] = Array.from({ length: n }, () => new Array<number>(trials))
for (let t = 0; t < trials; t++) {
const sampled = order.map((it, k) => it.durationDays * Math.exp(priors[k].mu + priors[k].sigma * standardNormal(rng)))
if (lanes) {
// parallel: lay the sampled durations across lanes, then sort finish days
const byNumber = new Map(order.map((it, k) => [it.number, sampled[k]]))
const { finishAt } = layoutOnLanes(laneInputs, lanes, (num) => byNumber.get(num)!)
const finishes = order.map((it) => finishAt.get(it.number)!).sort((a, b) => a - b)
for (let k = 0; k < n; k++) endByRank[k][t] = finishes[k]
} else {
// single serial worker: cumulative sum (already sorted ascending)
let cursor = 0
for (let k = 0; k < n; k++) {
cursor += sampled[k]
endByRank[k][t] = cursor
}
let cursor = 0
for (let k = 0; k < n; k++) {
const p = priors[k]
const sampled = order[k].durationDays * Math.exp(p.mu + p.sigma * standardNormal(rng))
cursor += sampled
endByRank[k][t] = cursor
}
}

View File

@@ -1,91 +0,0 @@
import { describe, expect, it } from 'vitest'
import { applySchemaLabels, ensurePmStateRepo, repoExists, SCHEMA_LABELS } from './bootstrap.js'
import { GiteaApiError } from './types.js'
import type { FetchLike } from './types.js'
describe('SCHEMA_LABELS', () => {
it('covers the full vocabulary: 5 estimates + 4 priorities + hard deadline', () => {
const names = SCHEMA_LABELS.map((l) => l.name)
expect(names).toEqual(['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d', 'p/1', 'p/2', 'p/3', 'p/4', 'deadline/hard'])
// colors are hex without '#'
for (const l of SCHEMA_LABELS) expect(l.color).toMatch(/^[0-9a-f]{6}$/)
})
})
describe('applySchemaLabels', () => {
it('creates only the missing labels (idempotent)', async () => {
const created: string[] = []
const client = {
listLabels: async () => [
{ id: 1, name: 'est/1d' },
{ id: 2, name: 'p/1' },
],
createLabel: async (input: { name: string; color: string }) => {
created.push(input.name)
return { id: 99, name: input.name }
},
}
const res = await applySchemaLabels(client)
expect(res.existing).toEqual(['est/1d', 'p/1'])
expect(res.created).toEqual(['est/2d', 'est/3d', 'est/5d', 'est/8d', 'p/2', 'p/3', 'p/4', 'deadline/hard'])
expect(created).toEqual(res.created) // exactly those createLabel calls, no more
})
it('creates nothing when the schema is already applied', async () => {
const client = {
listLabels: async () => SCHEMA_LABELS.map((l, i) => ({ id: i, name: l.name })),
createLabel: async () => {
throw new Error('should not create')
},
}
const res = await applySchemaLabels(client)
expect(res.created).toEqual([])
expect(res.existing).toHaveLength(SCHEMA_LABELS.length)
})
})
/** A fetch stub routing repo-exists (GET) and repo-create (POST). */
function stub(opts: { exists?: boolean; createStatus?: number }): { fetch: FetchLike; posts: { url: string }[] } {
const posts: { url: string }[] = []
const fetch: FetchLike = (url, init) => {
const method = init?.method ?? 'GET'
if (method === 'GET') {
return Promise.resolve({ ok: !!opts.exists, status: opts.exists ? 200 : 404, json: () => Promise.resolve({}), text: () => Promise.resolve('') })
}
posts.push({ url })
const status = opts.createStatus ?? 201
return Promise.resolve({ ok: status < 400, status, json: () => Promise.resolve({}), text: () => Promise.resolve('') })
}
return { fetch, posts }
}
describe('ensurePmStateRepo', () => {
const conn = { baseUrl: 'https://gitea.example.io', token: 'pat' }
it('returns "exists" and creates nothing when the repo is already there', async () => {
const { fetch, posts } = stub({ exists: true })
const r = await ensurePmStateRepo(conn, { owner: 'christian', repo: 'commitea-pm-state', underOrg: false }, fetch)
expect(r).toBe('exists')
expect(posts).toEqual([])
})
it('creates a personal repo via /user/repos when the owner is the token user', async () => {
const { fetch, posts } = stub({ exists: false })
const r = await ensurePmStateRepo(conn, { owner: 'christian', repo: 'commitea-pm-state', underOrg: false }, fetch)
expect(r).toBe('created')
expect(posts[0].url).toBe('https://gitea.example.io/api/v1/user/repos')
})
it('creates an org repo via /orgs/{owner}/repos when the owner is an org', async () => {
const { fetch, posts } = stub({ exists: false })
const r = await ensurePmStateRepo(conn, { owner: 'NovelPad', repo: 'novelpad-pm-state', underOrg: true }, fetch)
expect(r).toBe('created')
expect(posts[0].url).toBe('https://gitea.example.io/api/v1/orgs/NovelPad/repos')
})
it('surfaces a non-404 read failure as a GiteaApiError', async () => {
const fetch: FetchLike = () => Promise.resolve({ ok: false, status: 403, json: () => Promise.resolve({}), text: () => Promise.resolve('') })
await expect(repoExists(conn, 'x', 'y', fetch)).rejects.toBeInstanceOf(GiteaApiError)
})
})

View File

@@ -1,104 +0,0 @@
/**
* First-run bootstrap: make a repo ready for CommiTea. Two idempotent steps —
* apply the label schema (the only footprint CommiTea leaves in the work repo)
* and ensure the pm-state sidecar repo exists (machine-derived state lives there,
* never in the work repo — the purity split, D4). Both are safe to re-run: they
* create only what's missing. Label creation is repo-scoped (on the client);
* repo creation is token-scoped, so it takes the same injected `fetch` seam as
* `discoverRepos`.
*/
import type { GiteaClient } from './client.js'
import { ESTIMATE_LABELS, HARD_DEADLINE_LABEL, PRIORITY_LABELS } from '../labels/label-schema.js'
import { GiteaApiError } from './types.js'
import type { FetchLike } from './types.js'
/** A label to seed, with a hex color (no '#') and a human description. */
export interface SchemaLabelDef {
name: string
color: string
description: string
}
/** The full CommiTea label schema — estimates (jade), priorities (amber→grey), hard deadline (red). */
export const SCHEMA_LABELS: SchemaLabelDef[] = [
...ESTIMATE_LABELS.map((name) => ({ name, color: '2f6f4e', description: `Estimate: ${name.slice(4)} of focused work` })),
{ name: 'p/1', color: 'dc2626', description: 'Priority 1 — drop everything' },
{ name: 'p/2', color: 'ea580c', description: 'Priority 2 — this sprint' },
{ name: 'p/3', color: 'd97706', description: 'Priority 3 — soon' },
{ name: 'p/4', color: '6b7280', description: 'Priority 4 — someday' },
{ name: HARD_DEADLINE_LABEL, color: 'b91c1c', description: 'Has a hard, external deadline' },
]
// sanity: the schema list must cover exactly the label vocabulary, no drift.
const _EXPECTED = ESTIMATE_LABELS.length + PRIORITY_LABELS.length + 1
if (SCHEMA_LABELS.length !== _EXPECTED) throw new Error('SCHEMA_LABELS drifted from the label vocabulary')
/** What applying the schema did — created vs already-present names. */
export interface LabelSyncResult {
created: string[]
existing: string[]
}
/**
* Ensure every schema label exists on the work repo. Idempotent: reads the
* current labels and creates only the missing ones.
*/
export async function applySchemaLabels(client: Pick<GiteaClient, 'listLabels' | 'createLabel'>): Promise<LabelSyncResult> {
const have = new Set((await client.listLabels()).map((l) => l.name))
const created: string[] = []
const existing: string[] = []
for (const def of SCHEMA_LABELS) {
if (have.has(def.name)) {
existing.push(def.name)
continue
}
await client.createLabel(def)
created.push(def.name)
}
return { created, existing }
}
function authHeaders(token: string, json = false): Record<string, string> {
return { Authorization: `token ${token}`, Accept: 'application/json', ...(json ? { 'Content-Type': 'application/json' } : {}) }
}
/** Whether a repo exists under `owner`. Token-scoped read. */
export async function repoExists(conn: { baseUrl: string; token: string }, owner: string, repo: string, fetchImpl: FetchLike): Promise<boolean> {
const url = `${conn.baseUrl.replace(/\/+$/, '')}/api/v1/repos/${owner}/${repo}`
const res = await fetchImpl(url, { headers: authHeaders(conn.token) })
if (res.ok) return true
if (res.status === 404) return false
const body = await res.text().catch(() => '')
throw new GiteaApiError(res.status, `GET ${url} failed (${res.status})`, body)
}
/**
* Ensure the pm-state sidecar repo exists under `owner`, creating a private,
* auto-initialized repo if not. `underOrg` picks the org vs personal endpoint
* (the caller knows whether `owner` is the token's own login or an org).
* Returns whether it created or found the repo.
*/
export async function ensurePmStateRepo(
conn: { baseUrl: string; token: string },
target: { owner: string; repo: string; underOrg: boolean },
fetchImpl: FetchLike,
): Promise<'created' | 'exists'> {
if (await repoExists(conn, target.owner, target.repo, fetchImpl)) return 'exists'
const apiBase = `${conn.baseUrl.replace(/\/+$/, '')}/api/v1`
const url = target.underOrg ? `${apiBase}/orgs/${target.owner}/repos` : `${apiBase}/user/repos`
const res = await fetchImpl(url, {
method: 'POST',
headers: authHeaders(conn.token, true),
body: JSON.stringify({
name: target.repo,
private: true,
auto_init: true,
description: 'CommiTea PM state — machine-derived (capacity, directives, calibration). Safe to delete.',
}),
})
if (!res.ok) {
const body = await res.text().catch(() => '')
throw new GiteaApiError(res.status, `POST ${url} failed (${res.status})`, body)
}
return 'created'
}

View File

@@ -146,44 +146,6 @@ describe('createGiteaClient.getIssue', () => {
])
})
it('listCollaborators maps login+name and prepends the owner when absent', async () => {
const { fetch } = stubFetch([{ login: 'stephen', full_name: 'Stephen M.' }])
const people = await createGiteaClient(CONFIG, fetch).listCollaborators()
// owner (christian) prepended since /collaborators omits them; collaborator name preserved
expect(people).toEqual([
{ login: 'christian', name: 'christian' },
{ login: 'stephen', name: 'Stephen M.' },
])
})
it('listCollaborators does not double-add the owner when already listed', async () => {
const { fetch } = stubFetch([{ login: 'christian', full_name: 'Christian L.' }])
const people = await createGiteaClient(CONFIG, fetch).listCollaborators()
expect(people).toEqual([{ login: 'christian', name: 'Christian L.' }])
})
it('getFile returns null on 404 and content+sha on hit', async () => {
const miss = stubFetch('nope', 404)
expect(await createGiteaClient(CONFIG, miss.fetch).getFile('directives/log.jsonl')).toBeNull()
const hit = stubFetch({ content: 'aGVsbG8=\n', sha: 'abc123' })
const file = await createGiteaClient(CONFIG, hit.fetch).getFile('directives/log.jsonl')
expect(file).toEqual({ contentBase64: 'aGVsbG8=', sha: 'abc123' })
expect(hit.calls[0].url).toContain('/contents/directives/log.jsonl')
})
it('putFile POSTs to create and PUTs to update (with sha)', async () => {
const create = stubFetch({}, 201)
await createGiteaClient(CONFIG, create.fetch).putFile('directives/log.jsonl', { contentBase64: 'eA==', message: 'seed' })
expect(create.calls[0].init?.method).toBe('POST')
expect(JSON.parse(create.calls[0].init?.body ?? '{}')).toEqual({ content: 'eA==', message: 'seed' })
const update = stubFetch({}, 200)
await createGiteaClient(CONFIG, update.fetch).putFile('directives/log.jsonl', { contentBase64: 'eQ==', message: 'append', sha: 's1' })
expect(update.calls[0].init?.method).toBe('PUT')
expect(JSON.parse(update.calls[0].init?.body ?? '{}')).toEqual({ content: 'eQ==', message: 'append', sha: 's1' })
})
it('createIssue POSTs title/body/labels and returns a normalized issue', async () => {
const created = { ...RAW_ISSUE, number: 44, title: 'Retry token refresh', labels: [{ name: 'est/2d' }, { name: 'p/2' }] }
const { fetch, calls } = stubFetch(created, 201)

View File

@@ -101,22 +101,10 @@ export interface GiteaClient {
getIssueTimeline(index: number): Promise<LifecycleEvent[]>
/** Every label defined on the repo (id + name), for name→id resolution. */
listLabels(): Promise<GiteaLabel[]>
/** Create a repo label (name + hex color, no '#'). Write. Used by bootstrap. */
createLabel(input: { name: string; color: string; description?: string }): Promise<GiteaLabel>
/** Repo collaborators (login + display name) — the assignable people. */
listCollaborators(): Promise<{ login: string; name: string }[]>
/** Replace an issue's entire label set with the given label ids. Write. */
setIssueLabels(index: number, labelIds: number[]): Promise<void>
/** Replace an issue's assignees (empty array unassigns); returns the updated issue. Write. */
setIssueAssignees(index: number, logins: string[]): Promise<GiteaIssue>
/** Set (or clear, with null) an issue's milestone by id; returns the updated issue. Write. */
setIssueMilestone(index: number, milestoneId: number | null): Promise<GiteaIssue>
/** Open a new issue with a title, optional body, and label ids. Write. */
createIssue(input: { title: string; body?: string; labelIds?: number[] }): Promise<GiteaIssue>
/** Read a repo file's base64 content + blob sha; null if it (or the repo) is absent. */
getFile(path: string): Promise<{ contentBase64: string; sha: string } | null>
/** Create or update a repo file with base64 content (pass `sha` to update). Write. */
putFile(path: string, input: { contentBase64: string; message: string; sha?: string }): Promise<void>
}
/** Map raw gitea issue JSON to the normalized domain shape. Pure. */
@@ -237,41 +225,6 @@ export function createGiteaClient(config: GiteaConfig, fetchImpl: FetchLike): Gi
await request(`/issues/${index}/labels`, { method: 'PUT', body: { labels: labelIds } })
},
async createLabel(input) {
const raw = (await request('/labels', {
method: 'POST',
body: { name: input.name, color: input.color, description: input.description ?? '' },
})) as { id: number; name: string }
return { id: raw.id, name: raw.name }
},
async listCollaborators() {
const raw = await requestAll<{ login: string; full_name?: string }>(
(page) => `/collaborators?page=${page}&limit=${PAGE_LIMIT}`,
)
const collabs = raw.map((u) => ({ login: u.login, name: u.full_name || u.login }))
// The owner is assignable but is not returned by /collaborators — prepend them
// so a solo-owner repo still has an assignable person.
if (!collabs.some((c) => c.login === config.owner)) {
collabs.unshift({ login: config.owner, name: config.owner })
}
return collabs
},
async setIssueAssignees(index, logins) {
const raw = (await request(`/issues/${index}`, { method: 'PATCH', body: { assignees: logins } })) as RawIssue
return normalizeIssue(raw)
},
async setIssueMilestone(index, milestoneId) {
// gitea's EditIssueOption takes a milestone id; 0 clears it.
const raw = (await request(`/issues/${index}`, {
method: 'PATCH',
body: { milestone: milestoneId ?? 0 },
})) as RawIssue
return normalizeIssue(raw)
},
async createIssue(input) {
const raw = (await request('/issues', {
method: 'POST',
@@ -279,25 +232,5 @@ export function createGiteaClient(config: GiteaConfig, fetchImpl: FetchLike): Gi
})) as RawIssue
return normalizeIssue(raw)
},
async getFile(path) {
const res = await fetchImpl(`${repoBase}/contents/${path}`, {
headers: { Authorization: `token ${config.token}`, Accept: 'application/json' },
})
if (res.status === 404) return null
if (!res.ok) {
const body = await res.text().catch(() => '')
throw new GiteaApiError(res.status, `GET contents/${path} failed (${res.status})`, body)
}
const json = (await res.json()) as { content?: string; sha: string }
return { contentBase64: (json.content ?? '').replace(/\n/g, ''), sha: json.sha }
},
async putFile(path, input) {
await request(`/contents/${path}`, {
method: input.sha ? 'PUT' : 'POST',
body: { content: input.contentBase64, message: input.message, ...(input.sha ? { sha: input.sha } : {}) },
})
},
}
}

View File

@@ -1,81 +0,0 @@
import { describe, expect, it } from 'vitest'
import { discoverRepos } from './discover.js'
import { GiteaApiError } from './types.js'
import type { FetchLike } from './types.js'
/** A fetch stub that answers /user and paginated /user/repos from a fixture. */
function stub(opts: {
login: string
repos: { name: string; owner: string }[]
fail?: { status: number }
pageLimit?: number
}): { fetch: FetchLike; urls: string[] } {
const urls: string[] = []
const limit = opts.pageLimit ?? 50
const fetch: FetchLike = (url) => {
urls.push(url)
if (opts.fail) {
return Promise.resolve({ ok: false, status: opts.fail.status, json: () => Promise.resolve({}), text: () => Promise.resolve('nope') })
}
const ok = (body: unknown) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(body), text: () => Promise.resolve('') })
if (url.endsWith('/api/v1/user')) return ok({ login: opts.login })
const m = url.match(/\/user\/repos\?page=(\d+)&limit=(\d+)/)
if (m) {
const page = Number(m[1])
const raw = opts.repos.map((r) => ({ name: r.name, owner: { login: r.owner } }))
const start = (page - 1) * limit
return ok(raw.slice(start, start + limit))
}
return Promise.resolve({ ok: false, status: 404, json: () => Promise.resolve({}), text: () => Promise.resolve('') })
}
return { fetch, urls }
}
describe('discoverRepos', () => {
it('groups repos by owner, sorts them, and leads with the token owner', async () => {
const { fetch } = stub({
login: 'christian',
repos: [
{ name: 'zed', owner: 'acme' },
{ name: 'commitea', owner: 'christian' },
{ name: 'apex', owner: 'acme' },
{ name: 'commitea-pm-state', owner: 'christian' },
],
})
const d = await discoverRepos({ baseUrl: 'https://gitea.example.io', token: 'pat' }, fetch)
expect(d.user).toBe('christian')
expect(d.owners).toEqual(['christian', 'acme']) // own login first, then alpha
expect(d.reposByOwner.christian).toEqual(['commitea', 'commitea-pm-state']) // sorted
expect(d.reposByOwner.acme).toEqual(['apex', 'zed'])
})
it('trims a trailing slash on the base URL and calls /api/v1', async () => {
const { fetch, urls } = stub({ login: 'x', repos: [{ name: 'r', owner: 'x' }] })
await discoverRepos({ baseUrl: 'https://gitea.example.io/', token: 'pat' }, fetch)
expect(urls[0]).toBe('https://gitea.example.io/api/v1/user')
expect(urls[1]).toBe('https://gitea.example.io/api/v1/user/repos?page=1&limit=50')
})
it('paginates until a short page', async () => {
const repos = Array.from({ length: 73 }, (_, i) => ({ name: `r${String(i).padStart(2, '0')}`, owner: 'x' }))
const { fetch, urls } = stub({ login: 'x', repos })
const d = await discoverRepos({ baseUrl: 'https://g', token: 'pat' }, fetch)
expect(d.reposByOwner.x).toHaveLength(73)
// /user + page 1 (50) + page 2 (23, short → stop)
expect(urls.filter((u) => u.includes('/user/repos'))).toHaveLength(2)
})
it('propagates an auth failure as a GiteaApiError (so the UI can map 401/403)', async () => {
const { fetch } = stub({ login: 'x', repos: [], fail: { status: 401 } })
await expect(discoverRepos({ baseUrl: 'https://g', token: 'bad' }, fetch)).rejects.toBeInstanceOf(GiteaApiError)
})
it('skips malformed repo rows (missing owner/name)', async () => {
const { fetch } = stub({ login: 'x', repos: [{ name: 'good', owner: 'x' }] })
// inject a bad row by wrapping — simpler: rely on the guard via a direct malformed fixture
const d = await discoverRepos({ baseUrl: 'https://g', token: 'pat' }, fetch)
expect(d.reposByOwner.x).toEqual(['good'])
})
})

View File

@@ -1,74 +0,0 @@
/**
* Token-scoped discovery for onboarding. Given just a base URL + PAT (no repo
* chosen yet), enumerate the owners and repositories the token can reach, so the
* connect screen can offer them as dropdowns instead of free-text. These
* endpoints are user-scoped, not repo-scoped, so they don't belong on the
* repo-bound `GiteaClient` — this is a standalone call with the same injected
* `fetch` seam (real fetch in main, stub in tests).
*/
import { GiteaApiError } from './types.js'
import type { FetchLike } from './types.js'
/** What onboarding needs to render the owner + repo pickers. */
export interface DiscoveredRepos {
/** The token's own login (its default owner). */
user: string
/** Owners with at least one accessible repo — the user first, then the rest, sorted. */
owners: string[]
/** Repo names per owner, sorted. Keys match `owners`. */
reposByOwner: Record<string, string[]>
}
interface RawRepo {
name: string
owner?: { login?: string } | null
}
const PAGE_LIMIT = 50
async function getJson(url: string, token: string, fetchImpl: FetchLike): Promise<unknown> {
const res = await fetchImpl(url, { headers: { Authorization: `token ${token}`, Accept: 'application/json' } })
if (!res.ok) {
const body = await res.text().catch(() => '')
throw new GiteaApiError(res.status, `GET ${url} failed (${res.status})`, body)
}
return res.json()
}
/**
* Enumerate the owners + repos a token can reach. Hits `/user` (to learn the
* token's own login and prove the token works) and paginates `/user/repos`
* (every repo the token can access across personal + org namespaces).
*/
export async function discoverRepos(conn: { baseUrl: string; token: string }, fetchImpl: FetchLike): Promise<DiscoveredRepos> {
const apiBase = `${conn.baseUrl.replace(/\/+$/, '')}/api/v1`
const me = (await getJson(`${apiBase}/user`, conn.token, fetchImpl)) as { login?: string }
const user = me.login ?? ''
const repos: RawRepo[] = []
for (let page = 1; ; page++) {
const batch = (await getJson(`${apiBase}/user/repos?page=${page}&limit=${PAGE_LIMIT}`, conn.token, fetchImpl)) as RawRepo[]
repos.push(...batch)
if (batch.length < PAGE_LIMIT) break
}
const reposByOwner: Record<string, string[]> = {}
for (const r of repos) {
const owner = r.owner?.login
if (!owner || !r.name) continue
;(reposByOwner[owner] ??= []).push(r.name)
}
for (const owner of Object.keys(reposByOwner)) {
reposByOwner[owner] = [...new Set(reposByOwner[owner])].sort((a, b) => a.localeCompare(b))
}
// owners sorted alphabetically, but the token's own login always leads.
const owners = Object.keys(reposByOwner).sort((a, b) => {
if (a === user) return -1
if (b === user) return 1
return a.localeCompare(b)
})
return { user, owners, reposByOwner }
}

View File

@@ -31,8 +31,6 @@ export interface GiteaHttpResponse {
status: number
json(): Promise<unknown>
text(): Promise<string>
/** Present on the real fetch Response; used for SSE streaming (chat). */
body?: ReadableStream<Uint8Array> | null
}
export type FetchLike = (url: string, init?: GiteaRequestInit) => Promise<GiteaHttpResponse>

View File

@@ -11,10 +11,6 @@ export type { EstimateLabel, LabelFacts, PriorityLabel } from './labels/label-sc
export { createGiteaClient, normalizeIssue, normalizeMilestone, normalizeTimeline } from './gitea/client.js'
export type { GiteaClient, ListIssuesOptions } from './gitea/client.js'
export { discoverRepos } from './gitea/discover.js'
export type { DiscoveredRepos } from './gitea/discover.js'
export { applySchemaLabels, ensurePmStateRepo, repoExists, SCHEMA_LABELS } from './gitea/bootstrap.js'
export type { LabelSyncResult, SchemaLabelDef } from './gitea/bootstrap.js'
export { GiteaApiError } from './gitea/types.js'
export type {
FetchLike,
@@ -27,19 +23,8 @@ export type {
GiteaRequestInit,
} from './gitea/types.js'
export { CACHE_SCHEMA, initCache, readIssue, upsertIssue } from './cache/cache-v0.js'
export type { CacheDriver } from './cache/cache-v0.js'
export { affectedIssues, coalesceKey, enqueueWrite, pendingWrites, replayQueue } from './queue/write-queue-v0.js'
export type { QueuedWrite } from './queue/write-queue-v0.js'
export { describeChange, isLabelChange, planIssueChange, proposalsFor, summarizeChange } from './changes/apply-changes-v0.js'
export type {
ChangeProposal,
IssueChange,
LabelChange,
LabelPlan,
ProposalContext,
ProposeChangeArgs,
} from './changes/apply-changes-v0.js'
export { describeChange, planIssueChange, proposalsFor } from './changes/apply-changes-v0.js'
export type { ChangeProposal, IssueChange, LabelPlan, ProposeChangeArgs } from './changes/apply-changes-v0.js'
export {
inferColumnV0,
@@ -64,12 +49,6 @@ export type {
SchedulePlan,
} from './scheduler/scheduler-v0.js'
export { makespan, scheduleWithCapacity } from './scheduler/scheduler-capacity-v0.js'
export type { Worker } from './scheduler/scheduler-capacity-v0.js'
export { capacityPerWorkday, parseCapacityConfig } from './capacity/capacity-v0.js'
export type { CapacityMember } from './capacity/capacity-v0.js'
export {
COLD_START_PRIORS,
durationParams,
@@ -88,7 +67,6 @@ export type {
export {
CALIBRATION_BUCKET_FLOOR,
calibrationCoverage,
calibrationSamples,
COLD_START_THRESHOLD,
fitCalibration,
@@ -96,44 +74,19 @@ export {
} from './calibration/calibration-v0.js'
export type {
BucketFit,
CalibrationCoverage,
CalibrationModel,
CalibrationSample,
PersonBias,
} from './calibration/calibration-v0.js'
export { createChatClient } from './agent/chat-client.js'
export type { ChatClient, ChatMessage, CompletionResult, ModelConfig, OnToken, ToolCall, ToolDecl } from './agent/chat-client.js'
export type { ChatClient, ChatMessage, CompletionResult, ModelConfig, ToolCall, ToolDecl } from './agent/chat-client.js'
export { pickModel } from './agent/model-router.js'
export type { ModelRouter, TaskKind } from './agent/model-router.js'
export { runAgentTurn } from './agent/agent-loop.js'
export type { AgentStep, AgentTurn, ToolExecutor } from './agent/agent-loop.js'
export {
PROPOSE_CHANGE_TOOL,
QUERY_PROJECT_TOOL,
RECORD_DIRECTIVE_TOOL,
REGINALD_SYSTEM,
REGINALD_TOOLS,
} from './agent/agent-tools.js'
export { PROPOSE_CHANGE_TOOL, QUERY_PROJECT_TOOL, REGINALD_SYSTEM, REGINALD_TOOLS } from './agent/agent-tools.js'
export { buildProjectView } from './agent/query-project.js'
export type { ProjectSnapshot, ProjectView, QueryFilters } from './agent/query-project.js'
export { activeDirectives, assembleHotContext, estimateTokens, HOT_CONTEXT_BUDGET_TOKENS } from './agent/memory-v0.js'
export type { HotContextInputs } from './agent/memory-v0.js'
export { CAPTURE_SYSTEM, captureWork, parseCaptureArgs, PROPOSE_ISSUES_TOOL } from './agent/capture-work.js'
export type { CaptureProposal, ProposedIssue } from './agent/capture-work.js'
export {
appendDirective,
makeDirectiveEntry,
parseDirectiveLog,
serializeDirective,
toDirectiveInput,
} from './directives/record-directive-v0.js'
export type {
DirectiveEntry,
DirectiveInput,
DirectiveKind,
DirectiveRecord,
DirectiveStatus,
DirectiveTarget,
} from './directives/record-directive-v0.js'

View File

@@ -1,82 +0,0 @@
/**
* Performance pass (#32). The deterministic compute path must stay well under the
* PLAN.md targets on representative fixtures:
* - scheduler + Monte Carlo forecast < 1s @ 200 open issues.
* - scaling stays roughly linear (no accidental O(n²) in the hot path).
*
* Reconcile-<5s@500 is network-bound (~2N gitea calls) and is covered by the live
* reconcile, not here — this file benchmarks the pure compute the app runs each
* turn. Bounds are the actual targets with comfortable headroom so timing jitter
* can't flake the suite; actuals are logged.
*/
import { describe, expect, it } from 'vitest'
import { forecast } from '../forecast/forecast-v0.js'
import { type DependencyEdge, schedule, type SchedulableIssue } from '../scheduler/scheduler-v0.js'
import { scheduleWithCapacity, type Worker } from '../scheduler/scheduler-capacity-v0.js'
const EST = [1, 2, 3, 5, 8]
const WORKERS: Worker[] = [
{ person: 'a', speed: 0.8 },
{ person: 'b', speed: 0.6 },
{ person: 'c', speed: 1.0 },
]
/** A representative open backlog: varied estimates/priorities/assignees + a light dependency web. */
function backlog(n: number): { issues: SchedulableIssue[]; edges: DependencyEdge[] } {
const issues: SchedulableIssue[] = Array.from({ length: n }, (_, i) => ({
number: i + 1,
title: `Issue ${i + 1} with a representative title of some length`,
labels: [`est/${EST[i % EST.length]}d`, `p/${(i % 4) + 1}`],
estimateDays: EST[i % EST.length],
priority: (i % 4) + 1,
assignee: WORKERS[i % WORKERS.length].person,
}))
// ~1 dependency per 3 issues, always on a lower-numbered issue (acyclic)
const edges: DependencyEdge[] = []
for (let i = 3; i < n; i += 3) edges.push({ issue: i + 1, dependsOn: i - 1 })
return { issues, edges }
}
function ms(fn: () => void): number {
const t0 = performance.now()
fn()
return performance.now() - t0
}
describe('perf (#32)', () => {
it('scheduler + Monte Carlo forecast stays fast @ 200 open issues', () => {
const { issues, edges } = backlog(200)
const run = () =>
ms(() => {
schedule(issues, edges)
scheduleWithCapacity(issues, edges, WORKERS)
forecast(issues, edges, { workers: WORKERS }) // 2000 trials (default)
})
run() // warm up (JIT)
// Best of several runs: a micro-benchmark's minimum reflects true compute cost;
// a single shot flakes when the CI/dev box is momentarily loaded. Nominal is
// ~230ms, so 1500ms is a catastrophic-regression guard (>6x) that tolerates
// load spikes — the scaling test below is the real O(n²) guard.
const best = Math.min(run(), run(), run())
// eslint-disable-next-line no-console
console.log(`[perf] schedule+capacity+forecast @200 = ${best.toFixed(1)}ms (best of 3)`)
expect(best).toBeLessThan(1500)
})
it('scales roughly linearly — 400 issues is well under 4x the 100-issue time', () => {
const small = backlog(100)
const big = backlog(400)
const run = (b: typeof small) => () => {
schedule(b.issues, b.edges)
forecast(b.issues, b.edges, { workers: WORKERS })
}
// warm up (JIT) so the ratio reflects steady state
run(small)()
const t100 = Math.max(ms(run(small)), 0.1)
const t400 = ms(run(big))
// eslint-disable-next-line no-console
console.log(`[perf] @100 = ${t100.toFixed(1)}ms · @400 = ${t400.toFixed(1)}ms · ratio ${(t400 / t100).toFixed(1)}x`)
expect(t400).toBeLessThan(t100 * 8) // generous: rules out O(n²), tolerant of jitter
})
})

View File

@@ -1,67 +0,0 @@
import { describe, expect, it, vi } from 'vitest'
import type { IssueChange } from '../changes/apply-changes-v0.js'
import { affectedIssues, coalesceKey, enqueueWrite, pendingWrites, replayQueue, type QueuedWrite } from './write-queue-v0.js'
const reest = (issue: number, estimate: string): IssueChange =>
({ kind: 'reestimate', issue, estimate }) as IssueChange
const assign = (issue: number, assignee: string | null): IssueChange => ({ kind: 'assign', issue, assignee })
describe('write-queue-v0 (#33)', () => {
it('coalesces repeat writes to the same (issue, axis) — replay applies the latest once', () => {
let q: QueuedWrite[] = []
q = enqueueWrite(q, reest(7, 'est/2d'), '2026-02-10T09:00:00Z')
q = enqueueWrite(q, reest(7, 'est/5d'), '2026-02-10T09:05:00Z') // supersedes est/2d
q = enqueueWrite(q, assign(7, 'christian'), '2026-02-10T09:06:00Z') // different axis — kept
expect(q).toHaveLength(2)
const pending = pendingWrites(q)
expect(pending).toEqual([
{ kind: 'reestimate', issue: 7, estimate: 'est/5d' },
{ kind: 'assign', issue: 7, assignee: 'christian' },
])
expect(coalesceKey(reest(7, 'est/2d'))).toBe('7:reestimate')
})
it('keeps writes to different issues and axes distinct', () => {
let q: QueuedWrite[] = []
q = enqueueWrite(q, reest(7, 'est/2d'), 't1')
q = enqueueWrite(q, reest(8, 'est/3d'), 't2')
q = enqueueWrite(q, assign(8, null), 't3')
expect(q).toHaveLength(3)
expect(affectedIssues(q)).toEqual([7, 8])
})
it('a burst of edits then reconnect lands the final state without duplicating', async () => {
let q: QueuedWrite[] = []
// offline: three edits to #7's estimate, one assign
q = enqueueWrite(q, reest(7, 'est/1d'), 't1')
q = enqueueWrite(q, reest(7, 'est/2d'), 't2')
q = enqueueWrite(q, reest(7, 'est/8d'), 't3')
q = enqueueWrite(q, assign(7, 'stephen'), 't4')
const apply = vi.fn(async () => ({ ok: true }))
const { drained, remaining } = await replayQueue(q, apply)
// only the final estimate + the assign are applied — not three estimate writes
expect(apply).toHaveBeenCalledTimes(2)
expect(apply).toHaveBeenNthCalledWith(1, { kind: 'reestimate', issue: 7, estimate: 'est/8d' })
expect(apply).toHaveBeenNthCalledWith(2, { kind: 'assign', issue: 7, assignee: 'stephen' })
expect(remaining).toHaveLength(0)
expect(drained).toHaveLength(2)
})
it('keeps writes that still fail on reconnect queued (never throws)', async () => {
let q: QueuedWrite[] = []
q = enqueueWrite(q, reest(7, 'est/2d'), 't1')
q = enqueueWrite(q, reest(8, 'est/3d'), 't2')
// #7 applies, #8 rejects (still unreachable) — and one apply throws
const apply = vi.fn(async (c: IssueChange) => {
if (c.issue === 8) throw new Error('offline')
return { ok: true }
})
const { drained, remaining } = await replayQueue(q, apply)
expect(drained.map((w) => w.change.issue)).toEqual([7])
expect(remaining.map((w) => w.change.issue)).toEqual([8])
})
})

View File

@@ -1,71 +0,0 @@
/**
* Offline write-queue, v0 (#33). While gitea is unreachable, propose-approved
* writes are queued instead of lost; on reconnect they replay in order and
* resolve against a fresh reconcile. The one hard requirement is *no duplication*:
* replaying must not apply the same intent twice.
*
* The mechanism is coalescing by axis. Every write targets one field of one issue
* (its estimate, priority, assignee, or milestone). Queuing a second write to the
* same (issue, axis) supersedes the first — only the latest intent survives — so
* a burst of edits replays as one final write, and a replay is idempotent (the
* apply path no-ops a change already reflected server-side).
*/
import type { IssueChange } from '../changes/apply-changes-v0.js'
export interface QueuedWrite {
change: IssueChange
/** ISO time the write was queued (for display + stable ordering). */
queuedAt: string
}
/**
* The coalescing key: one field of one issue. Two writes with the same key are
* the same intent expressed twice — the later wins. Each `IssueChange.kind` maps
* to exactly one axis, so `issue:kind` is the axis identity.
*/
export function coalesceKey(change: IssueChange): string {
return `${change.issue}:${change.kind}`
}
/**
* Queue a write, superseding any pending write to the same (issue, axis). The
* superseding write moves to the tail so replay order reflects latest intent.
*/
export function enqueueWrite(queue: readonly QueuedWrite[], change: IssueChange, queuedAt: string): QueuedWrite[] {
const key = coalesceKey(change)
return [...queue.filter((w) => coalesceKey(w.change) !== key), { change, queuedAt }]
}
/** The changes to replay, in order — one per (issue, axis) by construction. */
export function pendingWrites(queue: readonly QueuedWrite[]): IssueChange[] {
return queue.map((w) => w.change)
}
/** Distinct issues touched by the queue — what a post-replay reconcile should re-read. */
export function affectedIssues(queue: readonly QueuedWrite[]): number[] {
return [...new Set(queue.map((w) => w.change.issue))]
}
/**
* Replay the queue through an apply function (the same guarded write path used
* online), in order. Returns the writes that failed (still unreachable / rejected)
* so they stay queued; everything else drains. Never throws — a failure is data.
*/
export async function replayQueue(
queue: readonly QueuedWrite[],
apply: (change: IssueChange) => Promise<{ ok: boolean }>,
): Promise<{ drained: QueuedWrite[]; remaining: QueuedWrite[] }> {
const drained: QueuedWrite[] = []
const remaining: QueuedWrite[] = []
for (const w of queue) {
let ok = false
try {
ok = (await apply(w.change)).ok
} catch {
ok = false
}
;(ok ? drained : remaining).push(w)
}
return { drained, remaining }
}

View File

@@ -1,119 +0,0 @@
/**
* Capacity-aware scheduler (#8). Reuses the single-worker scheduler's topological
* order + critical-path marking, then re-lays the work across lanes: an issue
* runs on its assignee's lane (or the earliest-free lane when unassigned), its
* duration scaled by that lane's speed (ideal person-days/workday). Makespan
* shrinks toward the critical path as lanes are added. Deterministic; falls back
* to the single serial worker when no capacity is configured. The lane layout is
* factored so the Monte Carlo forecast reuses it per trial with sampled durations.
*/
import {
type DependencyEdge,
schedule,
type SchedulableIssue,
type SchedulePlan,
} from './scheduler-v0.js'
/** A scheduling lane: a person and their throughput (ideal person-days / workday). */
export interface Worker {
person: string
speed: number
}
/** The topological order + per-issue relations the layout needs (from the base plan). */
export interface LaneInputs {
order: number[]
blockedBy: Map<number, number[]>
assignee: Map<number, string | null>
}
/** Ensure a lane exists for every assignee; unconfigured assignees get the mean speed. */
export function resolveLanes(workers: Worker[], assignees: (string | null)[]): Worker[] {
const lanes = [...workers]
const known = new Set(lanes.map((w) => w.person))
const meanSpeed = lanes.length ? lanes.reduce((s, w) => s + w.speed, 0) / lanes.length : 1
for (const a of assignees) {
if (a && !known.has(a)) {
lanes.push({ person: a, speed: meanSpeed })
known.add(a)
}
}
return lanes
}
function pickWorker(lanes: Worker[], freeAt: Map<string, number>, assignee: string | null | undefined): Worker {
if (assignee) {
const own = lanes.find((w) => w.person === assignee)
if (own) return own
}
let best = lanes[0]
for (const w of lanes) if (freeAt.get(w.person)! < freeAt.get(best.person)!) best = w
return best
}
/**
* Lay a topologically-ordered set out across lanes. `duration(n)` supplies each
* issue's duration for this layout (estimate, or a sampled value in a MC trial).
* Returns each issue's finish day + the lane it ran on. Order guarantees a
* dependency is always laid out before its dependents.
*/
export function layoutOnLanes(
inputs: LaneInputs,
lanes: Worker[],
duration: (n: number) => number,
): { finishAt: Map<number, number>; startAt: Map<number, number>; laneOf: Map<number, string> } {
const freeAt = new Map(lanes.map((w) => [w.person, 0]))
const finishAt = new Map<number, number>()
const startAt = new Map<number, number>()
const laneOf = new Map<number, string>()
for (const n of inputs.order) {
const worker = pickWorker(lanes, freeAt, inputs.assignee.get(n))
const blockers = inputs.blockedBy.get(n) ?? []
const depFinish = blockers.length ? Math.max(...blockers.map((d) => finishAt.get(d) ?? 0)) : 0
const start = Math.max(freeAt.get(worker.person)!, depFinish)
const end = start + duration(n) / worker.speed
startAt.set(n, start)
finishAt.set(n, end)
laneOf.set(n, worker.person)
freeAt.set(worker.person, end)
}
return { finishAt, startAt, laneOf }
}
/**
* Capacity-aware plan. An empty `workers` means no capacity is configured → the
* single-worker plan verbatim.
*/
export function scheduleWithCapacity(
issues: SchedulableIssue[],
edges: DependencyEdge[],
workers: Worker[],
): SchedulePlan {
if (workers.length === 0) return schedule(issues, edges)
const base = schedule(issues, edges)
if (base.cycle || base.items.length === 0) return base
const inputs: LaneInputs = {
order: base.items.map((it) => it.number),
blockedBy: new Map(base.items.map((it) => [it.number, it.blockedBy])),
assignee: new Map(issues.map((i) => [i.number, i.assignee ?? null])),
}
const lanes = resolveLanes(workers, [...inputs.assignee.values()])
const durationOf = new Map(base.items.map((it) => [it.number, it.durationDays]))
const { finishAt, startAt, laneOf } = layoutOnLanes(inputs, lanes, (n) => durationOf.get(n)!)
const items = base.items.map((it) => ({
...it,
startDay: startAt.get(it.number)!,
endDay: finishAt.get(it.number)!,
durationDays: finishAt.get(it.number)! - startAt.get(it.number)!,
worker: laneOf.get(it.number),
}))
return { items, cycle: null }
}
/** Makespan (last finish) of a plan — the project's landing day. */
export function makespan(plan: SchedulePlan): number {
return plan.items.reduce((m, it) => Math.max(m, it.endDay), 0)
}

View File

@@ -21,8 +21,6 @@ export interface SchedulableIssue {
estimateDays: number | null
/** 1 (most urgent) … 4; null when unset. */
priority: number | null
/** gitea assignee login, for capacity-aware lane routing; optional. */
assignee?: string | null
}
export interface DependencyEdge {
@@ -47,8 +45,6 @@ export interface ScheduledItem {
/** On a longest-duration dependency chain. */
critical: boolean
rationale: string
/** Lane it's scheduled on, when capacity-aware; absent for the single-worker plan. */
worker?: string
}
export interface SchedulePlan {

2437
yarn.lock

File diff suppressed because it is too large Load Diff