SPB Git

Repository Public

INTEGRATION-TODO.md 3.4 KB 51 lines markdown

1# Integration notes — what is still open23State at commit `45f0d03`, 2026-11-18 (late evening). This file used to be the integration checkpoint; everything4that was resolved has been folded into the reference documents (`ARCHITECTURE.md`, `SECURITY.md`, `OPERATIONS.md`,5`API.md`, `ACCEPTANCE.md`). Only what is really still open remains here. Delete the file when it is empty.67Closed since the checkpoint (verified in the code): nested labeled values read by the API and the alert engine;8agent overhead keys; `pki.ca` fingerprint key; UTC timestamps; relay upstream taken from `MCC_INGEST_SIGNED_LISTEN`;9ops plane, web and deployment merged; Linux agent, install scripts and the signed transport under launchd exercised10by the production rollout.1112## Code13141. ~~`TestJobRunsToSuccess` fails~~ **fixed** — (`services/internal/jobs/runner_test.go:215`): it still expects a `target`15   object in the `job.run` wire parameters, removed by commit `365d278`. `make ci` fails at `test` until the16   assertion is updated.172. **SSE payloads differ from the contract**: `node.state` (`{node_id, ts, values, availability}`),18   `action.output` (batch of `lines[]`), `audit.appended` (`{seq}`), `node.updated` from ingest (`reason` instead of19   `change`), `service.changed` with `state: "gone"`, `resync` (`{}`), plus the undeclared `hello` frame and the20   never-emitted `model.changed`. The web client reads the contract shapes for `node.state` and `action.output`.21   Details: `API.md` §5.3 and §8.223. **Error codes differ from the contract** (`session_expired`, `webauthn_failed`, `refresh_reuse_detected`, `gone`23   are never emitted); the web tests for `webauthn_failed`. `API.md` §8, row 7.244. **Settings without effect**: `retention.raw_days`, `retention.1m_days`, `retention.1h_days` (ingest reads25   `MCC_RETAIN_*` at start-up) and `alerts.default_*` (rule creation uses hard-coded defaults).26   `retention.action_events_days` is read by housekeeping but cannot be set through the API.275. **Rate limits differ from the contract** (one shared public bucket per IP instead of per-operation limits).286. **Version stamping**: `make build` stamps `internal/api` only; `telemetry-ingest` and `action-orchestrator` report29   `0.1.0-dev` / `dev`.307. **`model.server.start` / `model.server.stop`** are catalogued as available but no agent implements them.318. **`go test -race`** has not been run on the `ingest` and `agent` packages.329. No automated test of `control-api` during a database outage; nothing tests an interrupted deployment.3334## Not yet verified on real targets3536- Any authenticated flow in production: **no owner account exists yet** (the owner must open the one-time bootstrap37  link with his own passkey).38- Real platform authenticators; real Safari and Firefox; real passkeys in the native apps.39- `service.start` / `stop` / `restart`, `cache.purge`, `agent.restart`, job templates on a real pm2 / launchd40  (every agent runs the default read-only policy).41- APNs (no key exists).42- Restore on another node; key rotation; rollback of a release; moving the control plane.43- Certificate renewal in production (first certificates issued on 2026-11-18, 30 days).4445## Documentation follow-ups4647- Regenerate `METRICS-CATALOG.md` with the Linux column now that BHS64 reports.48- `DESIGN-BRIEF.md` §1 still lists the development ports and a LAN-facing ingest listener; production uses49  8800–8805 with ingest on loopback (`ARCHITECTURE.md` §2).50- `docs/APPLE-APPS.md` is written separately.51
Files main
Menu

Theme