96c2b8b1c2
Launches the built app (out/main/index.js) via Playwright's _electron API — no browser project, no chromium download. Adds a launch fixture (electronApp/window/app), an AppPage page object with a screenshot helper for autonomous visual review, and a boot smoke suite (shell renders, @commitea/core label-parse runs in the renderer, preload API exposed). Scripts: e2e (build+run), e2e:only, e2e:report. Artifacts gitignored. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
# CommiTea
|
|
|
|
AI project manager built on Gitea. A deterministic scheduler does the math
|
|
(Monte Carlo forecasts over your own estimate-vs-actual history); the agent —
|
|
Reginald — captures work via interview, negotiates priorities, and explains the
|
|
consequences. Gitea holds human-authored intent; a `pm-state` repo holds
|
|
machine-derived state. The LLM never does math.
|
|
|
|
## Structure
|
|
|
|
- `apps/desktop` — Electron app (electron-vite, React, Tailwind)
|
|
- `packages/core` — pure TypeScript: label schema, scheduler, gitea client (no
|
|
Electron imports)
|
|
- `docs/PLAN.md` — product plan (goals, phases, not-doing list)
|
|
- `docs/design/` — design handoff: tokens, component contracts, interactive
|
|
prototype (`docs/design/ui_kits/app/index.html` via a static server), brand
|
|
voice rules in `design_system_readme.md`
|
|
|
|
## Development
|
|
|
|
```sh
|
|
yarn # install
|
|
yarn dev # electron app, logs tee to apps/desktop/desktop.log
|
|
yarn test # unit tests (vitest)
|
|
yarn typecheck
|
|
```
|
|
|
|
### End-to-end (Electron + Playwright)
|
|
|
|
```sh
|
|
yarn workspace @commitea/desktop e2e # build, then drive the built app
|
|
yarn workspace @commitea/desktop e2e:only # reuse existing out/ build (tight loop)
|
|
yarn workspace @commitea/desktop e2e:report # open the last HTML report
|
|
```
|
|
|
|
Tests launch the built app (`out/main/index.js`) through Playwright's
|
|
`_electron` API — no browser project, no chromium download. Fixtures and page
|
|
objects live in `apps/desktop/e2e/`; screenshots land in
|
|
`e2e/.artifacts/screens/` for visual review. Page objects use user-facing
|
|
locators (`getByRole`/`getByText`), never CSS/DOM structure.
|
|
|
|
## Conventions
|
|
|
|
- Yarn 4 workspaces; ESM everywhere; `.js` extensions on relative imports
|
|
- `@commitea/core` stays pure — unit-testable without Electron or network
|
|
- Design tokens are the source of truth (`apps/desktop/src/renderer/src/design/`,
|
|
mirrored from `docs/design/`); Tailwind maps onto the CSS custom properties,
|
|
never redefines them
|
|
- Reginald's voice rules live in `docs/design/design_system_readme.md` — no
|
|
emoji, no point-date forecasts, wit in sentences never in buttons
|