15 Commits

Author SHA1 Message Date
Croissant Le Doux
6fdbc302d2 SQLite cache bootstrap + single-issue mirror upsert (#3)
A rebuildable local mirror of the reconciled backlog — an index over gitea's
durable truth, never the source of truth (D4). This lands the core seam:

- `cache/cache-v0.ts`: the 5-table schema (issues/labels/milestones/comments/
  issue_events), a `CacheDriver` injected-IO interface (exec/run/get/all), and
  pure row<->domain mappers. `upsertIssue` mirrors one issue (+ its milestone),
  upsert-by-number so a re-reconcile updates in place; `readIssue` re-derives
  `facts` from the stored label set via extractLabelFacts, so the mirror can't
  drift from the label semantics. Facts are never stored.
- Resolves #3's open scope: pure mappers + SQL in core (driver-agnostic), native
  driver in main. Tests bind node:sqlite (present in the Node 24 test runtime) to
  the same CacheDriver seam better-sqlite3 will fill in main.

Acceptance met: upsert one reconciled issue, read back, assert
estimateDays/priority/hardDeadline (+ upsert-in-place, no-milestone, and miss
cases). Core suite green; typecheck clean.

Follow-up (noted in the plan): the main-process better-sqlite3 adapter +
snapshot-store migration — packaging-sensitive (native module), kept out of this
slice so the shippable .dmg stays verified.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 15:30:22 -04:00
2a6413821a Merge pull request 'calibration: count same-day closes honestly (#34)' (#54) from feat/calibration-honesty into main
Reviewed-on: #54
2026-07-09 19:23:59 +00:00
008435f1c2 Merge branch 'main' into feat/calibration-honesty 2026-07-09 19:23:55 +00:00
354ba9227e Merge pull request 'apply_changes: unified mutation tool — estimate/priority/assign/milestone, in-app + agent (#24)' (#53) from feat/apply-changes-assign-milestone into main
Reviewed-on: #53
2026-07-09 19:23:49 +00:00
2de3212210 Merge branch 'main' into feat/apply-changes-assign-milestone 2026-07-09 19:23:43 +00:00
86e9a49c08 Merge pull request 'Productionize: real data everywhere (Phase B) + shareable unsigned macOS .dmg (Phase C)' (#52) from feat/kill-fixtures into main
Reviewed-on: #52
2026-07-09 19:23:39 +00:00
Croissant Le Doux
89c873b368 calibration: count same-day closes honestly (#34)
The cold-start surface showed "N/20 closed issues estimated", implying you're
just (20−N) closes away. But calibrationSamples silently drops closed+estimated
issues that closed in 0 working days (same-day closes) — real closes that
structurally can't calibrate. On this repo that's 10 of 24 closes hidden: the
note read 14/20 as if 6 away, when a third of the history will never count.

- core: `calibrationCoverage(issues, timelines, asOf)` → { candidates, usable,
  excludedSameDay }, counting the silently-excluded same-day closes. Pure, tested.
- surface it: CalibrationData gains `excludedSameDay`; backlogCalibration returns
  the coverage; the Runway note and the Calibration screen now say "… · N same-day
  closes can't calibrate" so the thin sample is explained, not just reported.

Verified on christian/commitea: closed=24, usable=14, excludedSameDay=10.
131 core green (incl. new coverage test); core + desktop typecheck; 14 fixture e2e.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 15:18:16 -04:00
Croissant Le Doux
4fc5b902c4 apply_changes UI: assign + milestone in the dialog and Reginald's tool (#24)
Surfaces the assign/milestone mutations end-to-end so they're usable in-app and
by the agent — the rest of #24.

Agent path:
- propose_change tool + system prompt now accept `assignee` (login/null) and
  `milestone` (id/null). ProposeChangeArgs + proposalsFor extended: a new
  ProposalContext (current assignee/milestone + milestones list) lets a proposal
  skip no-ops and label the milestone. ChangeProposal gains an always-present
  `summary` (plan is now label-only) — chat-panel, use-chat, and the model
  executor render `summary`, so non-label proposals display correctly.

Dialog path:
- Client `listCollaborators()` (prepends the repo owner — /collaborators omits
  them, so a solo-owner repo still has an assignable person). New
  `gitea:collaborators` bridge. The Adjust dialog gains Assignee + Milestone
  pickers (current values from the reconciled backlog); pending assign/remilestone
  changes flow through the existing apply path.

Tests: +4 core (assign/milestone proposals with no-op skip; collaborators
owner-prepend + no-double-add). 138 core green; core + desktop typecheck clean;
14 fixture e2e green; live-backlog now drives the pickers on real data.
Fixed stale P2 refs in live-backlog (P2 is shipped → correctly off the runway).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 11:54:03 -04:00
Croissant Le Doux
72dcd396f8 apply_changes: unify the mutation tool with assign + milestone (#24)
The write path handled only the est/* and p/* label axes. Extend it to the two
mutations dogfooding proved were missing — assignee and milestone — behind one
unified change model:

- IssueChange gains `assign` and `remilestone` kinds. `planIssueChange` is now
  typed to LabelChange (the label kinds only); `isLabelChange` narrows, and a new
  pure `summarizeChange(change, currentLabels?)` gives one confirm line for ANY
  kind (label kinds delegate to describeChange; field writes describe directly).
- GiteaClient gains `setIssueAssignees` / `setIssueMilestone` (PATCH /issues/{n},
  returning the updated issue; milestone 0 clears).
- The main `gitea:applyChange` handler branches: label swaps resolve ids +
  setIssueLabels as before; field writes call the new client methods. Snapshot
  invalidated either way so board + forecast catch up. ApplyChangeResult.plan is
  now optional (absent for field writes).
- issue-screen uses summarizeChange for its diff preview.

Tests: +5 covering isLabelChange, and summarizeChange for assign/unassign,
milestone set-by-title / by-id / removal, and label delegation. Full core suite
132 green; core + desktop typecheck clean.

Follow-up (rest of #24): surface assignee/milestone pickers in the Adjust dialog
and extend the agent's propose_change tool so Reginald can propose them too.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 11:31:26 -04:00
Croissant Le Doux
3873e652f2 Gantt bars use the capacity-aware lane layout (match the forecast)
ganttView ran schedule() — the single-serial-worker layout — while the Monte
Carlo forecast ran scheduleWithCapacity() over the real lanes. So the bars you
saw didn't match what was forecast (serial 1.0/day vs the team's actual lanes).

Switch ganttView to scheduleWithCapacity(open, deps, workers): startDay/endDay
now come from the same lane layout each forecast trial uses, and `who` shows the
lane an issue actually landed on (falling back to assignee, then blank). The
dogfood harness had the same split — updated it to match and to print the lane
per row.

Verified: typecheck clean, 14 fixture e2e green, live-onboarding e2e renders the
real capacity-aware Gantt with no uncaught errors.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 11:23:01 -04:00
Croissant Le Doux
63f0ea1735 Dogfood harness: run CommiTea's engine on its own backlog (#31)
scripts/dogfood-report.ts drives the real @commitea/core engine (schedule +
capacity-aware Monte Carlo forecast + per-milestone runway) against the live
christian/commitea backlog and prints the project report each screen derives.
Read-only; `yarn tsx scripts/dogfood-report.ts`. Adds tsx as a devDependency.

First run surfaced two real gaps the fixtures hid: every open issue was
unassigned (so capacity load-balanced work onto the slow half-time lane and the
standup plan-per-person was empty) and no milestone had a due date (so Runway
couldn't judge on-track/at-risk). Both were fixed as PM actions on the repo via
the write path — all open issues assigned, milestone due dates synthesized from
the forecast — so the app's own numbers are now honest.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 10:53:28 -04:00
87a0ba4ba1 Merge branch 'main' into feat/kill-fixtures 2026-07-09 14:41:26 +00:00
62a521e7eb Merge pull request 'feat: config & onboarding — each teammate connects their own Gitea (productionize Phase A)' (#51) from feat/config-onboarding into main
Reviewed-on: #51
2026-07-09 14:41:20 +00:00
Croissant Le Doux
19897f7e53 Phase C: package as an unsigned macOS .dmg (electron-builder)
Adds shareable desktop packaging so the app can be handed to teammates.

- electron-builder@25 + electron-builder.yml: appId io.stephenmann.commitea,
  productName CommiTea, icon from the logo (build/icon.png, 1024²), macOS dmg
  targets for arm64 + x64. Ships only out/** (electron-vite already bundles
  renderer/preload/main with core + react inlined), npmRebuild off,
  electronVersion pinned to 34.5.8 (workspace hoisting defeats auto-detect).
- Unsigned by decision: mac.identity null, hardenedRuntime off. electron-builder
  ad-hoc signs so arm64 runs; not notarized — teammates right-click → Open once.
- Scripts: `yarn pack` (--dir sanity build), `yarn dist` (both dmgs). package.json
  gains version/author/description (required by electron-builder).
- README.md: dev/build/package commands + the Gatekeeper install step.

Verified: packaged arm64 app boots from a fresh profile (lands on onboarding);
`yarn dist` produced CommiTea-0.1.0-arm64.dmg (98M) and CommiTea-0.1.0.dmg (x64,
102M), each mounting with a drag-to-Applications layout.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 02:46:37 -04:00
Croissant Le Doux
c120f34a4a Phase B: real data for the last fixture screens
Every remaining fixture-only surface now renders reconciled gitea data,
with the fixture kept only as the no-config demo fallback.

- lib/views/project-data.ts: ProjectData — the uniform input (reconciled
  backlog + deps + timelines + calibration + workers + today) that AppShell
  assembles once and every view builder consumes.
- lib/views/{issue-detail,gantt-view,deps-graph,standup-view,inbox-view}.ts:
  pure builders, ProjectData → the fixture-shaped object each screen already
  renders. Real signals only; honest degradation where a signal isn't derivable
  (buffered p80 vs per-issue Monte Carlo; flat "idle in review"; no fabricated
  inbox mentions/outages).
- Screens take an optional `data?` and fall back to the fixture; AppShell wires
  the real view whenever the backlog is reconciled. Issue "blocks" chips and the
  rail inbox badge now resolve from real data too.
- Dev-only rail surfaces (First run / States / Primitives) gated on
  import.meta.env.DEV || demo — shown in dev + e2e, hidden in a packaged app.
  Rail host label reflects the connected instance.
- Extended the live onboarding e2e to click Board → Gantt → Deps → Issue
  sidecar → Standup → Inbox on real gitea data with a pageerror guard; 14
  fixture e2e stay green, typecheck + prod build clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 02:38:52 -04:00
41 changed files with 4146 additions and 103 deletions

42
apps/desktop/README.md Normal file
View File

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

BIN
apps/desktop/build/icon.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 657 KiB

View File

@@ -11,6 +11,7 @@ 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,16 +43,17 @@ test.describe('live backlog', () => {
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 (which lists Beta / Pilot-ready / v1.0).
await expect(win.getByText(/P2 — Scheduler/)).toBeVisible()
// 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 milestone opens its real detail
await win.getByText(/P2Scheduler/).click()
await expect(win.getByRole('heading', { name: 'P2Scheduler + Monte Carlo' })).toBeVisible()
// Milestone drill-in — clicking a real (active) milestone opens its real detail
await win.getByText(/P5Dogfood/).click()
await expect(win.getByRole('heading', { name: 'P5Dogfood + 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()
@@ -68,10 +70,15 @@ 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 estimate & priority')).toBeVisible()
await expect(win.getByText('Adjust issue')).toBeVisible()
await win.getByRole('combobox').first().selectOption('est/8d')
await expect(win.getByText('Proposed label change')).toBeVisible()
await expect(win.getByText('Proposed change')).toBeVisible()
await expect(win.getByText(/est\/8d/).last()).toBeVisible()
// the unified tool also drives assignee + milestone — the pickers render and diff
await expect(win.getByText('Assignee', { exact: true })).toBeVisible()
await expect(win.getByText('Milestone', { exact: true })).toBeVisible()
await win.getByRole('combobox').nth(2).selectOption('') // Assignee → Unassigned
await expect(win.getByText('unassign', { exact: true })).toBeVisible()
await win.screenshot({ path: join(here, '.artifacts', 'screens', 'live-apply-change.png'), fullPage: true, animations: 'disabled' })
await win.getByRole('button', { name: 'Cancel' }).click() // no mutation

View File

@@ -38,6 +38,11 @@ test.describe('live onboarding', () => {
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')
@@ -45,11 +50,35 @@ test.describe('live onboarding', () => {
await win.getByPlaceholder(/gitea PAT/).fill(token!)
await win.getByRole('button', { name: 'Connect' }).click()
// it validated + saved + reconciled into the real board — real issue titles prove it
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(/Model router|SQLite cache bootstrap|Purity\/rebuild/).first()).toBeVisible({ timeout: 30000 })
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

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

View File

@@ -1,5 +1,8 @@
{
"name": "@commitea/desktop",
"version": "0.1.0",
"description": "CommiTea — an AI project manager for Gitea",
"author": "CommiTea",
"private": true,
"type": "module",
"main": "./out/main/index.js",
@@ -10,7 +13,9 @@
"typecheck": "tsc --noEmit",
"e2e": "electron-vite build && playwright test",
"e2e:only": "playwright test",
"e2e:report": "playwright show-report e2e/.artifacts/report"
"e2e:report": "playwright show-report e2e/.artifacts/report",
"pack": "electron-vite build && electron-builder --dir",
"dist": "electron-vite build && electron-builder --mac"
},
"dependencies": {
"@commitea/core": "workspace:*",
@@ -25,9 +30,11 @@
"@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"
}

View File

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

View File

@@ -19,6 +19,7 @@ import {
type GiteaConfig,
type GiteaLabel,
type IssueChange,
isLabelChange,
type LifecycleEvent,
makeDirectiveEntry,
parseCapacityConfig,
@@ -263,19 +264,32 @@ export function registerGiteaIpc(): void {
return client.getIssue(index)
})
// The write path (apply_changes). Additive label swaps, applied only after the
// renderer's propose-approve. Returns the plan + the freshly-read issue.
// The write path (apply_changes), applied only after the renderer's propose-
// approve. Label swaps (est/p) return the plan; field writes (assign, milestone)
// return the freshly-read issue directly. Either way the snapshot is invalidated
// so the board + forecast reflect the change.
ipcMain.handle('gitea:applyChange', async (_event, change: IssueChange) => {
const client = getGiteaClient()
if (!client) return { ok: false as const, reason: 'unconfigured' as const }
if (isLabelChange(change)) {
const current = await client.getIssue(change.issue)
const plan = planIssueChange(current.labels, change)
if (plan.noop) return { ok: true as const, plan, issue: current }
const ids = await resolveLabelIds(client, plan.labels)
await client.setIssueLabels(change.issue, ids)
const issue = await client.getIssue(change.issue)
invalidateSnapshot() // the board + forecast must reflect the label change
invalidateSnapshot()
return { ok: true as const, plan, issue }
}
// Field writes — the client returns the updated issue.
const issue =
change.kind === 'assign'
? await client.setIssueAssignees(change.issue, change.assignee ? [change.assignee] : [])
: await client.setIssueMilestone(change.issue, change.milestone)
invalidateSnapshot()
return { ok: true as const, issue }
})
// capture_work filing: open each approved issue with its est/* + p/* labels.
@@ -319,6 +333,17 @@ export function registerGiteaIpc(): void {
}
})
// Assignable people (repo collaborators) for the Adjust dialog's assignee picker.
ipcMain.handle('gitea:collaborators', async () => {
const client = getGiteaClient()
if (!client) return []
try {
return await client.listCollaborators()
} catch {
return []
}
})
// ---- config (team onboarding) ----
ipcMain.handle('config:get', () => publicConfig())

View File

@@ -13,7 +13,6 @@ import {
type ChangeProposal,
type ChatMessage,
createChatClient,
describeChange,
type ModelRouter,
type ProjectView,
proposalsFor,
@@ -130,10 +129,19 @@ 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` }
const built = proposalsFor(a, issue.labels, issue.title)
// Milestone titles + current assignee/milestone let a proposal label the
// milestone and skip a no-op assign/move.
const milestones = (a.milestone !== undefined ? await client.listMilestones().catch(() => []) : []).map(
(m) => ({ id: m.id, title: m.title }),
)
const built = proposalsFor(a, issue.labels, issue.title, {
currentAssignee: issue.assignee,
currentMilestoneId: issue.milestone?.id ?? null,
milestones,
})
proposals.push(...built)
return built.length
? { proposed: built.map((p) => ({ issue: a.issue, diff: describeChange(p.plan) })) }
? { proposed: built.map((p) => ({ issue: a.issue, diff: p.summary })) }
: { proposed: [], note: 'no change — already at that value' }
}
if (name === 'record_directive') {

View File

@@ -15,6 +15,8 @@ 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. */

View File

@@ -1,6 +1,6 @@
import React from 'react'
import { COLUMNS, type BoardColumn, type BoardIssue, type IssueRef } from '../../data/fixtures.js'
import { COLUMNS, type BoardColumn, type BoardIssue, type DepsData, type GanttData, type IssueRef } from '../../data/fixtures.js'
import { Card, Tag, Badge, Tabs, IconButton, Input, Icon } from '../ui/index.js'
import { EmptyState } from '../shell/states.js'
import { GanttView } from './gantt-view.js'
@@ -12,10 +12,14 @@ import { DepsGraph } from './deps-graph.js'
export function BoardScreen({
onOpenIssue,
columns = COLUMNS,
gantt,
deps,
loading = false,
}: {
onOpenIssue: (issue: IssueRef) => void
columns?: BoardColumn[]
gantt?: GanttData
deps?: DepsData
loading?: boolean
}) {
const [tab, setTab] = React.useState('board');
@@ -90,9 +94,9 @@ export function BoardScreen({
</div>
)
) : tab === 'deps' ? (
<DepsGraph onOpenIssue={onOpenIssue} />
<DepsGraph onOpenIssue={onOpenIssue} data={deps} />
) : (
<GanttView onOpenIssue={onOpenIssue} />
<GanttView onOpenIssue={onOpenIssue} data={gantt} />
)}
</div>
);

View File

@@ -178,6 +178,9 @@ export function CalibrationScreen({ onBack, data }: { onBack: () => void; data?:
{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.`
: ''}
</p>
</Card>
</div>

View File

@@ -1,11 +1,11 @@
import React from 'react'
import { DEPS, type IssueRef } from '../../data/fixtures.js'
import { DEPS, type DepsData, type IssueRef } from '../../data/fixtures.js'
import { Tag, Icon } from '../ui/index.js'
// Dependency graph drill-in — layered DAG, critical path in spruce
export function DepsGraph({ onOpenIssue }: { onOpenIssue: (issue: IssueRef) => void }) {
const g = DEPS
export function DepsGraph({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef) => void; data?: DepsData }) {
const g = data ?? DEPS
const PAD = 14, COLW = 206, ROWH = 106, NW = 176, NH = 84
const X = (c: number) => PAD + c * COLW

View File

@@ -1,11 +1,11 @@
import React from 'react'
import { GANTT, type IssueRef } from '../../data/fixtures.js'
import { GANTT, type GanttData, type IssueRef } from '../../data/fixtures.js'
import { Icon } from '../ui/index.js'
// Gantt drill-in — scheduler-derived bars, critical chain, 80% forecast tails
export function GanttView({ onOpenIssue }: { onOpenIssue: (issue: IssueRef) => void }) {
const g = GANTT;
export function GanttView({ onOpenIssue, data }: { onOpenIssue: (issue: IssueRef) => void; data?: GanttData }) {
const g = data ?? GANTT;
const LABELW = 232, DAYW = 21, ROWH = 36, HEADH = 30;
const chartW = g.days * DAYW;

View File

@@ -9,13 +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 all = data ?? INBOX
const [tab, setTab] = React.useState('all')
const isRead = (n: InboxItem) => !n.unread || readIds.includes(n.id)

View File

@@ -2,13 +2,12 @@
import React, { useState } from 'react'
import {
describeChange,
type EstimateLabel,
ESTIMATE_LABELS,
type IssueChange,
planIssueChange,
type PriorityLabel,
PRIORITY_LABELS,
summarizeChange,
} from '@commitea/core'
import { ISSUE_DETAIL, type IssueDetail, type IssueRef } from '../../data/fixtures.js'
@@ -18,18 +17,28 @@ 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 = ISSUE_DETAIL[issue.id] || {
const det: IssueDetail = detail ?? ISSUE_DETAIL[issue.id] ?? {
state: 'triage',
assignee: 'Stephen',
milestone: 'Beta',
@@ -60,25 +69,40 @@ 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 axis that differs
// the concrete changes this dialog would apply, one per field that differs
const pendingChanges: IssueChange[] = []
if (estimate !== curEstimate)
pendingChanges.push({ kind: 'reestimate', issue: issue.id, estimate: (estimate || null) as EstimateLabel | null })
if (priority !== curPriority)
pendingChanges.push({ kind: 'reprioritize', issue: issue.id, priority: (priority || null) as PriorityLabel | null })
if (assignee !== curAssignee)
pendingChanges.push({ kind: 'assign', issue: issue.id, assignee: assignee || null })
if (milestone !== curMilestone)
pendingChanges.push({
kind: 'remilestone',
issue: issue.id,
milestone: milestone ? Number(milestone) : null,
milestoneTitle: milestones.find((m) => String(m.id) === milestone)?.title ?? null,
})
const diffs = pendingChanges.map((c) => describeChange(planIssueChange(labels, c)))
const diffs = pendingChanges.map((c) => summarizeChange(c, labels))
const apply = async () => {
if (!onApplyChange || pendingChanges.length === 0) return
@@ -93,6 +117,14 @@ 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 }}>
@@ -133,7 +165,7 @@ export function IssueScreen({
<Dialog
open={adjustOpen}
onClose={() => setAdjustOpen(false)}
title="Adjust estimate & priority"
title="Adjust issue"
footer={
<>
<Button variant="ghost" onClick={() => setAdjustOpen(false)}>
@@ -159,15 +191,35 @@ 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 or priority.
No change yet pick a different estimate, priority, assignee, or milestone.
</p>
) : (
<>
<p style={{ font: 'var(--text-overline)', letterSpacing: 'var(--letter-spacing-wide)', textTransform: 'uppercase', color: 'var(--ink-3)', margin: '0 0 6px' }}>
Proposed label change
Proposed change
</p>
{diffs.map((d) => (
<div key={d} style={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>
@@ -175,7 +227,7 @@ export function IssueScreen({
</div>
))}
<p style={{ font: 'var(--text-agent)', color: 'var(--ink-2)', margin: '8px 0 0' }}>
Writes the label to gitea and re-runs the plan. Nothing else changes.
Writes to gitea and re-runs the plan. Nothing else changes.
</p>
</>
)}
@@ -267,7 +319,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, title: b === 91 ? 'Webhook listener: reconcile on reconnect' : 'Monte Carlo engine: percentile bands', labels: b === 91 ? ['est/3d', 'p/2'] : ['est/5d', 'p/1'] })}
onClick={() => onOpenIssue({ id: b })}
style={{ font: '500 11px var(--font-mono)', color: 'var(--accent-text)', background: 'var(--spruce-1)', border: '1px solid var(--spruce-2)', borderRadius: 'var(--radius-1)', padding: '2px 7px', cursor: 'pointer' }}>
#{b}
</button>

View File

@@ -17,7 +17,7 @@ export function RunwayScreen({
}: {
onOpenCalibration: () => void
onOpenMilestone: (id?: number) => void
calibration?: { n: number; coldStart: boolean }
calibration?: { n: number; coldStart: boolean; excludedSameDay?: number }
milestones?: RunwayMilestone[]
capacity?: CapacityMember[]
}) {
@@ -30,9 +30,11 @@ export function RunwayScreen({
hours: `${capacityPerWorkday(m).toFixed(2)} pd/day`,
}))
: CAPACITY
const excluded = calibration?.excludedSameDay ?? 0
const calibNote = calibration
? calibration.coldStart
? `cold-start priors · ${calibration.n}/20 closed issues estimated`
? `cold-start priors · ${calibration.n}/20 closed issues estimated` +
(excluded > 0 ? ` · ${excluded} same-day close${excluded === 1 ? '' : 's'} cant calibrate` : '')
: `calibrated on ${calibration.n} closed ${calibration.n === 1 ? 'issue' : 'issues'}`
: 'calibrated on 27 closed issues'
return (

View File

@@ -1,6 +1,6 @@
import React from 'react'
import { type IssueRef, STANDUP } from '../../data/fixtures.js'
import { type IssueRef, STANDUP, type StandupData } from '../../data/fixtures.js'
import { Badge, Button, Icon } from '../ui/index.js'
const standupCSS = `
@@ -36,15 +36,15 @@ const toneColor: Record<string, string> = {
export function StandupScreen({
onBegin,
onOpenIssue,
data,
}: {
onBegin: () => void
onOpenIssue: (issue: IssueRef) => void
data?: StandupData
}) {
const s = STANDUP
const s = data ?? 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,
}

View File

@@ -17,6 +17,12 @@ import {
} 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'
@@ -100,7 +106,9 @@ export function AppShell() {
const [readIds, setReadIds] = useState<number[]>([])
const [milestoneId, setMilestoneId] = useState<number | null>(null)
const [gate, setGate] = useState<'checking' | 'connect' | 'ready'>('checking')
const [demo, setDemo] = useState(false)
const [pubConfig, setPubConfig] = useState<PublicConfig | null>(null)
const [collaborators, setCollaborators] = useState<{ login: string; name: string }[]>([])
const [backlog, refetchBacklog] = useBacklog()
const capacityMembers = useCapacity()
const workers = capacityWorkers(capacityMembers)
@@ -132,6 +140,41 @@ export function AppShell() {
) ?? undefined)
: undefined
// The uniform input every real-data view builder consumes. Assembled once from
// the reconciled backlog + capacity; undefined until the first reconcile lands.
const projectData: ProjectData | undefined =
backlog.status === 'ready'
? {
issues: backlog.issues,
milestones: backlog.milestones,
deps: backlog.deps,
timelines: backlog.timelines,
calibration: calibration?.model,
workers,
today: new Date(),
}
: undefined
const issueDetail =
projectData && issue ? (issueDetailView(issue.id, projectData) ?? undefined) : undefined
const standup = projectData ? standupView(projectData) : undefined
const inbox = projectData ? inboxView(projectData) : undefined
const gantt = projectData ? ganttView(projectData) : undefined
const depsGraph = projectData ? depsGraphView(projectData) : undefined
// The rail's unread badge tracks the real inbox once reconciled (still-unread
// minus what's been opened); demo shows the fixture count.
const inboxUnread = inbox
? inbox.filter((n) => n.unread && !readIds.includes(n.id)).length
: INBOX_UNREAD
// The real connected host (from the saved config), for the rail's status line.
const hostLabel = (() => {
try {
return pubConfig?.baseUrl ? new URL(pubConfig.baseUrl).host : 'gitea'
} catch {
return pubConfig?.baseUrl ?? 'gitea'
}
})()
useEffect(() => {
document.documentElement.setAttribute('data-theme', dark ? 'dark' : 'light')
}, [dark])
@@ -141,14 +184,34 @@ export function AppShell() {
useEffect(() => {
window.commitea.gitea
.status()
.then((s) => setGate(s.demo || s.configured ? 'ready' : 'connect'))
.then((s) => {
setDemo(s.demo)
setGate(s.demo || s.configured ? 'ready' : 'connect')
})
.catch(() => setGate('connect'))
window.commitea.config.get().then(setPubConfig).catch(() => {})
// Assignable people for the Adjust dialog's assignee picker (empty when demo/unconfigured).
window.commitea.gitea.collaborators().then(setCollaborators).catch(() => {})
}, [])
// The open issue's current assignee + milestone (from the reconciled backlog),
// so the Adjust dialog can preselect and diff them. Milestones list feeds its picker.
const currentIssue =
backlog.status === 'ready' && issue ? backlog.issues.find((i) => i.number === issue.id) : undefined
const milestoneOptions =
backlog.status === 'ready' ? backlog.milestones.map((m) => ({ id: m.id, title: m.title })) : []
const openIssue = (ref: IssueRef) => {
if (view !== 'issue') setPrevView(view)
setIssue(ref)
// Callers into the sidecar (e.g. a "blocks #N" chip) may know only the id.
// Backfill the real title + labels from the reconciled backlog so the header
// isn't blank; fall back to whatever the caller passed (demo fixtures).
let full = ref
if (backlog.status === 'ready' && (!ref.title || !ref.labels)) {
const found = backlog.issues.find((i) => i.number === ref.id)
if (found) full = { ...ref, id: found.number, title: found.title, labels: found.labels }
}
setIssue(full)
setView('issue')
}
@@ -166,7 +229,7 @@ export function AppShell() {
const NAV: NavEntry[] = [
{ id: 'standup', label: 'Standup', icon: 'sun' },
{ id: 'focus', label: 'Morning service', icon: 'coffee' },
{ id: 'inbox', label: 'Inbox', icon: 'bell', count: INBOX_UNREAD || null },
{ id: 'inbox', label: 'Inbox', icon: 'bell', count: inboxUnread || null },
{ id: 'capture', label: 'Capture', icon: 'plus' },
{ id: 'board', label: 'The pot', icon: 'square-kanban' },
{ id: 'runway', label: 'Runway', icon: 'chart-line' },
@@ -224,12 +287,14 @@ export function AppShell() {
case 'focus':
return <FocusScreen onOpenIssue={openIssue} focus={focus} forecast={forecast} />
case 'standup':
return <StandupScreen onBegin={() => setView('focus')} onOpenIssue={openIssue} />
return <StandupScreen onBegin={() => setView('focus')} onOpenIssue={openIssue} data={standup} />
case 'board':
return (
<BoardScreen
onOpenIssue={openIssue}
columns={boardColumns}
gantt={gantt}
deps={depsGraph}
loading={backlog.status === 'loading'}
/>
)
@@ -241,7 +306,15 @@ export function AppShell() {
setMilestoneId(id ?? null)
setView('milestone')
}}
calibration={calibration ? { n: calibration.model.n, coldStart: calibration.model.coldStart } : undefined}
calibration={
calibration
? {
n: calibration.model.n,
coldStart: calibration.model.coldStart,
excludedSameDay: calibration.coverage.excludedSameDay,
}
: undefined
}
milestones={runwayMilestones}
capacity={capacityMembers}
/>
@@ -257,6 +330,7 @@ export function AppShell() {
onOpenDirectives={() => setView('directives')}
readIds={readIds}
setReadIds={setReadIds}
data={inbox}
/>
)
case 'capture':
@@ -282,10 +356,15 @@ export function AppShell() {
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':
@@ -356,9 +435,15 @@ export function AppShell() {
<div style={{ borderTop: '1px solid var(--line-1)', margin: '10px 8px' }} />
<NavItem item={{ id: 'settings', label: 'Settings', icon: 'settings-2' }} />
{/* Dev-only surfaces (fixture galleries / onboarding preview) — shown in dev
and in demo/e2e mode; hidden in a real configured, packaged app. */}
{import.meta.env.DEV || demo ? (
<>
<NavItem item={{ id: 'firstrun', label: 'First run', icon: 'play' }} />
<NavItem item={{ id: 'states', label: 'States', icon: 'circle-dashed' }} />
<NavItem item={{ id: 'primitives', label: 'Primitives', icon: 'layers' }} />
</>
) : null}
<div style={{ marginTop: 'auto', padding: '0 12px', display: 'flex', flexDirection: 'column', gap: 12 }}>
<button
@@ -388,7 +473,7 @@ export function AppShell() {
display: 'inline-block',
}}
/>
gitea.stephenmann.io
{hostLabel}
</button>
<Switch
label={<span style={{ font: 'var(--text-caption)' }}>Evening service</span>}

View File

@@ -1,6 +1,6 @@
import React, { useEffect, useRef, useState } from 'react'
import { describeChange, type IssueChange } from '@commitea/core'
import type { IssueChange } from '@commitea/core'
import { useChat } from '../../lib/use-chat.js'
import { Button, Icon, IconButton } from '../ui/index.js'
@@ -127,7 +127,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)' }}>{describeChange(p.plan)}</div>
<div style={{ font: '500 13px var(--font-mono)', color: 'var(--ink-1)' }}>{p.summary}</div>
<div style={{ display: 'flex', gap: 8 }}>
<Button size="sm" onClick={() => approve(p)} disabled={offline}>
Approve

View File

@@ -361,11 +361,14 @@ export interface CalibrationData {
scatter: number[][]
fit: number
effect: { raw: string; banded: string; p50: string }
/** Closed+estimated issues that can't calibrate (same-day / 0-day closes). */
excludedSameDay: number
}
export const CALIBRATION: CalibrationData = {
n: 27,
active: true,
excludedSameDay: 0,
labels: [
{ label: 'est/1d', n: 8, median: '1.1d', bias: 8 },
{ label: 'est/2d', n: 9, median: '2.4d', bias: 18 },

View File

@@ -17,7 +17,8 @@ import type {
/** The result of a write through the bridge. */
export type ApplyChangeResult =
| { ok: false; reason: 'unconfigured' }
| { ok: true; plan: LabelPlan; issue: GiteaIssue }
// `plan` is present for label swaps (est/p); absent for field writes (assign, milestone).
| { ok: true; plan?: LabelPlan; issue: GiteaIssue }
/** The result of filing captured issues. */
export type CreateIssuesResult =
@@ -85,6 +86,7 @@ export interface GiteaBridge {
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. */

View File

@@ -1,6 +1,8 @@
import {
type CalibrationCoverage,
type CalibrationModel,
type CalibrationSample,
calibrationCoverage,
calibrationSamples,
type CapacityMember,
capacityPerWorkday,
@@ -171,10 +173,11 @@ export function backlogCalibration(
issues: GiteaIssue[],
timelines: Timelines = {},
asOf: Date = new Date(),
): { model: CalibrationModel; data: CalibrationData } {
): { model: CalibrationModel; data: CalibrationData; coverage: CalibrationCoverage } {
const samples = calibrationSamples(issues, timelines, asOf)
const model = fitCalibration(samples)
return { model, data: calibrationData(model, samples, issues) }
const coverage = calibrationCoverage(issues, timelines, asOf)
return { model, coverage, data: calibrationData(model, samples, issues, coverage.excludedSameDay) }
}
const pctFromMu = (mu: number) => Math.round((Math.exp(mu) - 1) * 100)
@@ -188,6 +191,7 @@ 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)
@@ -227,6 +231,7 @@ export function calibrationData(
scatter: samples.map((s) => [s.estimateDays, s.actualWorkingDays]),
fit: Number(Math.exp(model.global.mu).toFixed(2)),
effect,
excludedSameDay,
}
}

View File

@@ -133,14 +133,13 @@ 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
? `Done — #${p.change.issue} is now ${label}. The plan's been re-run.`
? `Done — #${p.change.issue}: ${p.summary}. The plan's been re-run.`
: `That didn't take — #${p.change.issue} is unchanged.`,
},
])

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@@ -38,15 +38,19 @@ export const QUERY_PROJECT_TOOL: ToolDecl = {
export const PROPOSE_CHANGE_TOOL: ToolDecl = {
name: 'propose_change',
description:
"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.",
'Propose a change to an issue — estimate, priority, assignee, and/or milestone. This does NOT apply ' +
'anything; it shows the human a diff to approve. Use it whenever the user asks to re-estimate, reprioritize, ' +
'assign someone (or unassign), or move an issue to a milestone. Pass a login for `assignee` (null to ' +
'unassign) and a milestone id for `milestone` (null to remove). After calling it, tell the user you have ' +
'*proposed* the change for approval — never say it is done.',
parameters: {
type: 'object',
properties: {
issue: { type: 'number', description: 'the issue number to change' },
estimate: { type: 'string', enum: ['est/1d', 'est/2d', 'est/3d', 'est/5d', 'est/8d'] },
priority: { type: 'string', enum: ['p/1', 'p/2', 'p/3', 'p/4'] },
assignee: { type: 'string', description: 'gitea login to assign, or null to unassign' },
milestone: { type: 'number', description: 'milestone id to set, or null to remove from its milestone' },
},
required: ['issue'],
},
@@ -84,7 +88,7 @@ export const REGINALD_SYSTEM = [
'You are Reginald, the calm, dry project manager inside CommiTea — a tool that runs projects on Gitea.',
'Call query_project to ground every answer in the real project; never invent issues, numbers, or dates.',
'The scheduler and forecasts are deterministic code — report their output, do not recompute it.',
'To change an estimate or priority, call propose_change — it shows the human a diff to approve.',
'To change an estimate, priority, assignee, or milestone, call propose_change — it shows the human a diff to approve.',
'When the PM states standing intent ("pilots first", "freeze scope"), call record_directive to log it.',
'Never claim a change is applied; you propose, the human approves. Forecasts are ranges, never single dates.',
'Refer to issues as #<number>. Be brief and plain — a sentence or two. No preamble, no bullet dumps.',

View File

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

159
packages/core/src/cache/cache-v0.ts vendored Normal file
View File

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

View File

@@ -5,6 +5,7 @@ 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,
@@ -118,4 +119,26 @@ 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,3 +125,40 @@ 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,6 +1,13 @@
import { describe, expect, it } from 'vitest'
import { describeChange, type IssueChange, planIssueChange, proposalsFor } from './apply-changes-v0.js'
import {
describeChange,
isLabelChange,
type IssueChange,
planIssueChange,
proposalsFor,
summarizeChange,
} from './apply-changes-v0.js'
describe('planIssueChange', () => {
it('swaps the estimate label, keeping non-axis labels', () => {
@@ -58,11 +65,31 @@ 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(describeChange(props[0].plan)).toBe('est/2d → est/5d')
expect(props[0].summary).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
@@ -77,3 +104,31 @@ 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,6 +17,15 @@ 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). */
@@ -29,7 +38,10 @@ export interface LabelPlan {
noop: boolean
}
function axisFor(change: IssueChange): { labels: readonly string[]; target: string | null } {
/** 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 } {
return change.kind === 'reestimate'
? { labels: ESTIMATE_LABELS, target: change.estimate }
: { labels: PRIORITY_LABELS, target: change.priority }
@@ -40,7 +52,7 @@ function axisFor(change: IssueChange): { 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: IssueChange): LabelPlan {
export function planIssueChange(current: string[], change: LabelChange): LabelPlan {
const { labels: axis, target } = axisFor(change)
const onAxis = current.filter((l) => axis.includes(l))
const removed = onAxis.filter((l) => l !== target)
@@ -58,18 +70,52 @@ export function describeChange(plan: LabelPlan): string {
return `${from}${to}`
}
/** A change the agent proposes: the concrete op + its diff, ready for approve-then-apply. */
/**
* 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. */
export interface ChangeProposal {
change: IssueChange
plan: LabelPlan
/** 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
issueTitle?: string
}
/** What the `propose_change` tool accepts — a target issue and the axes to set. */
/** What the `propose_change` tool accepts — a target issue and the fields 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 {
@@ -80,25 +126,33 @@ function isPriority(v: unknown): v is PriorityLabel {
}
/**
* 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.
* 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.
*/
export function proposalsFor(
args: ProposeChangeArgs,
currentLabels: string[],
issueTitle?: string,
ctx: ProposalContext = {},
): ChangeProposal[] {
const out: ChangeProposal[] = []
if (isEstimate(args.estimate)) {
const change: IssueChange = { kind: 'reestimate', issue: args.issue, estimate: args.estimate }
const pushLabel = (change: LabelChange) => {
const plan = planIssueChange(currentLabels, change)
if (!plan.noop) out.push({ change, plan, issueTitle })
if (!plan.noop) out.push({ change, plan, summary: describeChange(plan), 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 })
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 })
}
return out
}

View File

@@ -146,6 +146,22 @@ 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()

View File

@@ -101,8 +101,14 @@ export interface GiteaClient {
getIssueTimeline(index: number): Promise<LifecycleEvent[]>
/** Every label defined on the repo (id + name), for name→id resolution. */
listLabels(): 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. */
@@ -229,6 +235,33 @@ export function createGiteaClient(config: GiteaConfig, fetchImpl: FetchLike): Gi
await request(`/issues/${index}/labels`, { method: 'PUT', body: { labels: labelIds } })
},
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',

View File

@@ -23,8 +23,17 @@ export type {
GiteaRequestInit,
} from './gitea/types.js'
export { describeChange, planIssueChange, proposalsFor } from './changes/apply-changes-v0.js'
export type { ChangeProposal, IssueChange, LabelPlan, ProposeChangeArgs } from './changes/apply-changes-v0.js'
export { CACHE_SCHEMA, initCache, readIssue, upsertIssue } from './cache/cache-v0.js'
export type { CacheDriver } from './cache/cache-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 {
inferColumnV0,
@@ -73,6 +82,7 @@ export type {
export {
CALIBRATION_BUCKET_FLOOR,
calibrationCoverage,
calibrationSamples,
COLD_START_THRESHOLD,
fitCalibration,
@@ -80,6 +90,7 @@ export {
} from './calibration/calibration-v0.js'
export type {
BucketFit,
CalibrationCoverage,
CalibrationModel,
CalibrationSample,
PersonBias,

2436
yarn.lock

File diff suppressed because it is too large Load Diff