daimon 0.8.1 → 0.10.0

package/CHANGELOG.md

@@ -4,6 +4,158 @@ All notable changes to Daimon are documented here. The format follows [Keep a Ch
 
 ## [Unreleased]
 
+## [0.10.0] — 2026-05-22
+
+Strategic theme: **Mature & Aware.** The biggest release yet. 11 milestones (M54–M64) covering perf at scale, recovery hardening, agent identity, pattern detection, predictive UX, webhooks, a VS Code extension, and a generated docs site.
+
+### Added (M54) — Perf at scale (50 apps / 100K events)
+
+- `test/perf-50apps.test.mjs` bench: 50 synthetic apps, 100k events, 30-day retention. Asserts hot-path budgets: events query p95 < 250ms, timeline 24h < 300ms, 50× summary doctor pass < 500ms, SSE catchup < 1s, RSS < 150MB.
+- New `events_app_ts` SQLite index for the (app, ts) lookup pattern that powers `/api/apps?cwd=` + per-app timeline.
+
+### Added (M55) — Recovery hardening
+
+- History.db auto-rebuild on startup: `PRAGMA integrity_check` runs at open time; on failure the bad file is renamed `history.db.corrupt-<ts>` and a fresh db is created. Surface flows through to `daimon doctor` so the user can decide whether to delete the snapshot.
+- WAL checkpoint on close: `PRAGMA wal_checkpoint(TRUNCATE)` runs during shutdown to keep `-wal` sidecars from ballooning across SIGKILL cycles.
+- New doctor rule `history-db-healthy` — reports any archived `.corrupt-*` snapshots left behind by previous startups.
+
+### Added (M56) — Tests to 200+ under 30s
+
+- New test files: `agents.test.mjs`, `audit.test.mjs`, `regressions.test.mjs`, `webhooks.test.mjs`, `recovery.test.mjs`, `perf-50apps.test.mjs`, `history-property.test.mjs`, `scope-property.test.mjs`, `mcp-contract.test.mjs`.
+- Suite: **219 tests / 15.2s wall-clock** (up from 130 / 14s in v0.9).
+
+### Added (M57) — Docs site + branding
+
+- `scripts/build-docs.mjs` → generates `docs/index.html` from the live CLI surface + MCP tool list. Single self-contained HTML, no JS framework.
+- New `CLAUDE.md` — orientation for future agents (where files live, conventions, "things daimon never does").
+- New `npm run build:docs` script.
+
+### Added (M58) — Agent identity + handoff (locked decision)
+
+- `src/agents.ts`: `generateAgentId()` returns `<host>-<pid>-<rand4>`; `AgentRegistry` tracks who's calling (active = touched within 5 min); `LockManager` enforces 30-second per-app soft-locks.
+- Audit log gains a **6th column** (agent id). `parseAuditLine()` exposed for tooling; legacy 5-col rows still parse.
+- New endpoints: `GET /api/agents`, `GET /api/apps/<n>/lock`, `POST /api/apps/<n>/handoff`.
+- `start`/`stop`/`restart` now return HTTP 409 `locked-by-other-agent` when another agent holds the soft-lock. Pass `?steal=1` to override.
+- CLI: every call ships `X-Daimon-Agent`. New `daimon agents` and `daimon handoff <app> <agentId>` verbs. `--steal` on lifecycle verbs.
+- MCP forwards `X-Daimon-Agent` and `X-Daimon-Cwd` on every request.
+
+### Added (M59) — MCP expansion + who's watching
+
+- New MCP tools: `daimon_who_owns`, `daimon_subscribe_events`, `daimon_notify_on_error`.
+- Per-app lock + recent-interaction list queryable via `/api/apps/<n>/lock`.
+- New dashboard `/agents` route: live list of every agent touching this daemon with per-agent cards showing call counts, last-seen, cwd, and the apps each agent currently holds. Orphan-lock surface lists locks held by agents that have gone inactive. Chord `g g` jumps straight to it; the help dialog and command palette pick it up automatically.
+
+### Added (M60) — Pattern detection
+
+- New event type `regression-detected` with structured payload `{ kind, factor, baseline, current, suspectCommit }`.
+- Compile-time: factor 2.0 vs rolling median of last 20 successful compiles.
+- Bundle: 10% initialKB growth vs the previous baseline.
+- Error-flap: ≥5 errors/hour AND ≥3× the 23h-prior baseline.
+- Suspect-commit hint pulled via `git log -1 --format=%h:%s` (best-effort; null on non-git workspaces).
+- New dashboard `/regressions` route: filterable cards (all / compile / bundle / error-flap) showing baseline-vs-current, factor, fingerprint, and suspect-commit. Live-updates from the SSE stream and seeds from `/api/history/events?type=regression-detected`. Chord `g r`.
+
+### Added (M61) — Predictive UX (ready-time)
+
+- `AppSummary.estimatedReadyAtMs` projected from p50 of last 10 compiles during `compiling` state. Surfaced in compact CLI status and MCP `get_status` payloads.
+- `daimon profiles suggest` CLI verb backed by `GET /api/profiles/suggest`. Sweeps the last 30d of `status → starting` events into co-start sessions (60s windows), counts canonical app-sets, and emits suggestions for clusters seen ≥5 times that don't already match an existing profile. Each suggestion carries a name, app list, occurrence count, last-seen, and reason string. `--since` and `--min` flags tune the window.
+- `smart-restart-tune` doctor rule. Scans the last 7d of `status` events for non-stopped→starting transitions per app; flags any app restarting ≥5×/day with `restartPolicy` review guidance.
+
+### Added (M62) — VS Code extension
+
+- New `vscode-extension/` subpackage. Marketplace name `flycotech.daimon`.
+- Features: status bar (cwd app health), errors sidebar (cwd-filtered, click-to-open), commands `Daimon: Start / Stop / Open dashboard / Show logs`, soft-lock-aware Start (offers to steal on 409).
+- New root `npm run build:vscode` script (delegates to `vscode-extension` after `npm install`).
+- `.vsix` built: `vscode-extension/daimon-vscode.vsix` (7.85 KB). LICENSE bundled. Ready for `vsce publish` to the marketplace.
+
+### Added (M63) — Webhooks + CI verb
+
+- New top-level config key `webhooks: WebhookEntry[]`.
+- `WebhookDispatcher` subscribes to registry events, filters per-config, shapes payloads per host (Slack `attachments`, Discord `embeds`, generic envelope otherwise), and posts with up to 3 retries + exponential backoff. Global budget 1 req/sec, drop-oldest on overflow.
+- New CLI verb `daimon ci start <profile> --until ready|healthy --timeout <duration> [--json]`. Exit code 0 on full success, 2 on timeout, 1 on unknown profile.
+
+### Added (M64) — Polish + ship
+
+- Help dialog automatically picks up new chords (`agents`, `handoff`, `ci`, `--steal`) from `cliSurface.ts`. Two new chord entries surfaced: `g g` (Agents), `g r` (Regressions), `g i` (Timeline).
+- Playwright drive landed at `dashboard/e2e/dashboard.spec.ts`. Visits 13 routes (all existing + new `/agents`, `/regressions`), asserts page-specific landmarks, enforces a console-error budget, and verifies the `g g` / `g r` chord routing. Seed helper at `dashboard/e2e/seed.ts` writes 6 fixture events (≥1 serving, ≥1 error, ≥2 regressions). Run with `npm run e2e:install && npm run e2e:seed && npm run e2e` from `dashboard/`.
+- Doctor 11-rule UI tightening carry-over from v0.9.
+- `RELEASE-v0.10.0.md` with migration steps for the audit-column add and webhooks config.
+- Test suite now at 225 / 17.0s (added 6 profile-suggester / restart-cadence tests).
+
+### Migration
+
+- Audit log gains a 6th column (agent). 5-column rows still parse.
+- New `webhooks: []` config key. Default is the empty array — no outbound deliveries unless you opt in.
+- HTTP 409 `locked-by-other-agent` is a new response code for lifecycle endpoints. Old CLIs (no `X-Daimon-Agent` header) get `agentId = 'unknown'` and never collide with named agents.
+
+## [0.9.0] — 2026-05-21
+
+Strategic theme: **Multi-agent observability.** v0.9 finishes the pivot to many agents on one machine, each in their own workspace, all sharing one daemon and one dashboard. On top of the architectural shift, deepen what daimon *sees* (lint findings as a third signal class beyond errors + warnings) and *shows* (a unified event timeline), and broaden what it *understands* (framework-aware health probes for the polyglot stack landed in v0.7).
+
+### Added (M46) — Multi-workspace foundation
+
+- `src/pathScope.ts` (`isPathUnder`, `normalizeForCompare`) — case-insensitive on Windows, separator-normalized.
+- `POST /api/workspaces/ensure` — idempotent register; returns `{ added, root, addedApps }` or `{ added: false, reason: 'already covered' }`.
+- `GET /api/apps?cwd=<path>` — filter by workspaceRoot under cwd (bidirectional: either direction counts).
+- `daimon list` defaults to cwd-scoped; `--all` bypasses; auto-calls `ensureCurrentWorkspace()`.
+- Warnings as a second signal class: parser `WARNING_PATTERNS`, `ErrorEntry.level?: 'error'|'warning'`, `warning-new` / `warning-recur` events, `?level=` filter, severity chips on the Errors page, tertiary-accent warning rows.
+- `TrendChartComponent` skeleton regression fix: `loading`/`empty`/`title`/`subtitle` are signals (zoneless + OnPush).
+- `scripts/dev-install.mjs` + `npm run dev:install` / `dev:install:fast` / `dev:unlink`.
+
+### Added (M47) — Per-cwd command resolution
+
+- `Registry.resolveByCwd(name, cwd?)`: returns `{ kind: 'unique'|'collision'|'none', key?, candidates }`. Discovery now uniquifies storage names on collision (`<base>@<workspaceLabel>`), keeping the user-facing `baseName` intact.
+- Every per-app endpoint resolves `<name>` via `?cwd=`. **412 `name-collision`** body `{ error, candidates: [...], hint }` when two workspaces share the same app name and no cwd disambiguates.
+- CLI `start/stop/restart/status/logs/errors/wait/run` all send `?cwd=<process.cwd()>` unless `--all` is set. New `reportCollisionAndExit` renders candidates by `workspaceLabel`.
+- MCP tools `get_status`, `get_status_full`, `get_errors`, `get_logs`, `start_app`/`stop_app`/`restart_app` accept an optional `cwd` param (defaults to the MCP server's `process.cwd()`).
+
+### Added (M48) — Workspace registry CLI + audit attribution
+
+- `daimon workspaces list|add [path] [--label <name>] | rm <path> | show [path]`.
+- `GET /api/workspaces`, `POST /api/workspaces/remove`, `GET /api/workspaces/resolve?cwd=<p>`.
+- CLI sends `X-Daimon-Cwd: <process.cwd()>` on every authenticated POST.
+- `appendAuditEntry` now records the cwd as the 5th column. Two agents sharing an IP can be told apart in `~/.daimon/audit.log`.
+
+### Added (M49) — Dashboard cwd context
+
+- Dashboard reads `?cwd=<path>` and pre-selects the workspace pill that covers it.
+- Unknown-cwd banner offers a one-click **Register** that POSTs `/api/workspaces/ensure` and then re-resolves.
+- New `daimon dashboard` verb opens the default browser to `http://127.0.0.1:4999/?cwd=<process.cwd()>`.
+- Header **scope chip** (`scope: <label> ×`) gives a one-click clear back to "all workspaces". No regression when no `?cwd=` is present.
+
+### Added (M50) — Lint findings channel
+
+- Parser `LINT_PATTERNS` for eslint, biome, ruff, clippy. Lint runs **first** (before error/warning) so a tight `F401`/`lint/correctness/...` signal beats the generic `<file>:<line>:<col>:` error rule.
+- `ErrorEntry.level` adds `'lint'`. `AppEventType` adds `lint-new` / `lint-recur`. **Status never flips on lint.**
+- `?level=lint` filter on `/api/apps/:name/errors`. `AppSummary.lintCount`.
+- Errors page severity chips become **errors / warnings / lint / all** with a secondary accent for lint rows. Lint events excluded from error trends.
+- Fixtures: `lint-eslint.log`, `lint-biome.log`, `lint-ruff.log`, `lint-clippy.log`.
+- **Daimon never spawns linters.** This is parse-only — read what the dev server already emits.
+
+### Added (M51) — Unified event timeline
+
+- `History.queryTimeline()`: merges events + compile_times + bundles + task_runs into `{ ts, app, kind, summary, payload }`. Sorted desc; 5000-row cap.
+- `GET /api/history/timeline?since=&app=&kinds=<csv>`.
+- New lazy-loaded `/timeline` dashboard route with virtual scroll, kind/app filters, flyout drawer. Nav-rail entry between History and Trends, keyboard chord `g i`.
+- New CLI verb: `daimon timeline [--since 24h] [--app <name>] [--kinds status,error,…]`.
+
+### Added (M52) — Polyglot v2 health probes
+
+- `src/healthProfiles.ts` with per-profile probe defaults: django → `/admin/login/`, rails → `/up`, fastapi → `/docs`, go-air → `/`, rust-trunk → `/`.
+- Probe resolution uses (in order): user override → prior auto-discovery → profile default → fallback `/`. The first probe cycle on a fresh Rails/FastAPI app now hits the right path instead of churning through `HEALTH_PROBE_CANDIDATES`.
+- Smart probe outcome: 200, 301/302/304/307/308, and 401 (auth-gated but alive) classify healthy; 5xx and `ECONNREFUSED` / `ECONNRESET` / `EHOSTUNREACH` classify unhealthy.
+- New doctor rule **`health-probe-missing`** with auto-fix: writes the profile-suggested `healthProbePath` into `overrides[<app>]` and triggers a soft-reload.
+
+### Added (M53) — Polish + release prep
+
+- Doctor `ALL_AUTO_FIX` now lists 12 rules (added `health-probe-missing`).
+- `CHANGELOG.md` + `RELEASE-v0.9.0.md`. `package.json` 0.8.1 → 0.9.0.
+
+### Migration notes
+
+- **Multi-workspace is the migration headline.** Existing single-workspace setups keep working — `daimon list --all` reproduces the v0.8 default. Two agents in different workspaces sharing an app name now coexist; CLI commands run from a workspace cwd resolve automatically. Pass `--all` to see / act on apps across all workspaces.
+- **Audit format change.** `~/.daimon/audit.log` gains a 5th tab-delimited column carrying the agent's cwd. Existing 4-column rows continue to parse — the cwd is empty for them.
+- **Discovery storage keys.** When two workspaces have apps with the same `baseName`, the second is stored under `<baseName>@<workspaceLabel>`. Its `baseName` field stays as the user-facing name. `daimon list` shows the storage key in the `name` column; `workspaceLabel` distinguishes the rows.
+
 ## [0.8.1] — 2026-05-21
 
 Hotfix for three regressions caught running v0.8.0 against a real workspace.

package/README.md

@@ -16,10 +16,57 @@ After install, `daimon` is on your PATH globally.
 
 ```bash
 daimon init             # interactive scaffolder; writes ./daimon.config.json or ~/.daimon/config.json
-daimon list             # auto-spawns the daemon on first call
+daimon list             # auto-spawns the daemon on first call (defaults to cwd-scoped — pass --all for every workspace)
 daimon daemon status
 ```
 
+## Multi-agent / multi-workspace (v0.9)
+
+A single daimon daemon on `127.0.0.1:4999` serves every workspace on your machine. Two agents (e.g. two Claude Code sessions in different repos) can use the same daemon without stepping on each other:
+
+```bash
+# In repo A:
+daimon list             # only A's apps
+daimon start editor     # cwd disambiguates which "editor"
+
+# In repo B (concurrent, different terminal):
+daimon list             # only B's apps
+daimon start editor     # B's editor — even though A also has one
+
+# To see every workspace's apps:
+daimon list --all
+
+# Manage the workspace registry directly:
+daimon workspaces list
+daimon workspaces add /path/to/another-repo --label other
+daimon workspaces show              # which workspace covers cwd?
+
+# Open the dashboard scoped to the current cwd:
+daimon dashboard        # opens http://127.0.0.1:4999/?cwd=<cwd>
+```
+
+When two workspaces register apps with the same name, daimon stores the second under `<name>@<workspaceLabel>` so both coexist. CLI commands resolve from `process.cwd()`; a 412 `name-collision` body with candidate workspaces is returned only when no cwd disambiguates.
+
+## Three signal classes: errors, warnings, lint
+
+Errors flip app status to `error`. Warnings (TS6133, NG8107, deprecation notes) are surfaced as a separate signal class — they do not flip status. **Lint findings** (eslint, biome, ruff, clippy) are a third channel: parsed from the dev-server log stream, never spawn a linter, never flip status, and live behind a dedicated severity chip on the Errors page.
+
+```bash
+daimon errors editor                       # errors only (back-compat default)
+daimon errors editor --level warning
+daimon errors editor --level lint
+daimon errors editor --level all
+```
+
+## Unified event timeline
+
+`daimon timeline` and the dashboard `/timeline` route merge status, errors, warnings, lint, health, bundle, compile, and task-run rows into one chronological stream:
+
+```bash
+daimon timeline --since 7d --kinds status,error,lint
+daimon timeline --app editor --since 24h
+```
+
 Config lookup order:
 
 1. `./daimon.config.json` (cwd)