zeekay
ad95ed6ca2
A version written into a manifest is written into every manifest that wants the package, and the copies drift. The catalog moves the number out of the manifest: a manifest names the package, the workspace names the version. Only names that already resolve to exactly one version move, so nothing installs differently -- 1424 resolutions are unchanged. Three kinds stay where they are: a name used at two specifiers, because the catalog would pick a winner; a name an override already decides, because pnpm records the overridden specifier; and a name whose one specifier resolved to two versions, because one entry would unify them.
Replay Vision
A sub-product of Session Replay. Users configure named scanners that Insights applies to completed session recordings; results land as queryable $recording_observed events that feed insights, dashboards, and Insights Signals.
Concepts
Scanner — a configured probe scoped to a team. Carries a prompt, a scanner type (monitor / classifier / scorer / summarizer), a RecordingsQuery that selects matching sessions, and a sampling rate. Each enabled scanner has a Temporal schedule that fires every 5 minutes and sweeps for newly settled recordings past the scanner's watermark (last_swept_at); disabling a scanner removes its schedule, and re-enabling restarts the sweep from now rather than backfilling the gap. Summarizers always emit per-facet embeddings for downstream free-text search.
Inline scan — a prompt pointed at named sessions with nothing saved, for a one-off question (POST /vision/scanners/inline_scan/, and the path agents take instead of creating a throwaway scanner). An observation belongs to a scanner, so a scan mints one keyed by a fingerprint of its config: the same question reuses the observations it already has, a different question gets its own. Those rows carry origin=inline, are never listed or swept, and are reaped once they have nothing to show. See backend/inline_scan.py for why they exist and backend/scanner_access.py for how results are read back.
Observation — one application of a scanner to a session, unique per (scanner, session). Created in pending when triggered (by the scanner's schedule or the /observe/ action), transitions to running while ApplyScannerWorkflow executes (rasterize the recording to video → upload to Gemini → multi-turn scan), and lands in succeeded (result persisted, then a $recording_observed event plus embeddings/tags emitted fail-soft), failed (with a kind:message error_reason), or ineligible (the session doesn't qualify — too short, too idle, no recording). Each observation snapshots the full scanner state (scanner_snapshot) that produced it, so subsequent edits to the scanner don't retro-mutate history. Rows stranded in pending/running by a dead workflow are failed as orphaned by a reaper on the reconciler tick.
Quota — succeeded observations write an immutable usage receipt; usage (receipts + in-flight rows) is counted against a monthly per-organization quota, with per-scanner volume estimates summed into a projected-usage prognosis shown at configuration time.
Layout
backend/models/—ReplayScanner,ReplayObservation, usage receipts, quota grants.backend/api/— DRF viewsets and serializers (scanners, observations, stats, live progress over SSE).backend/queries/— Datastore candidate selection (watermark + settle window + eligibility + sampling) and volume estimates.backend/temporal/— the apply workflow and its activities, per-scanner sweep, schedule reconciler (+ observation reaper), estimate refresher, and the Gemini file cleanup sweep.backend/quota.py— monthly quota accounting.backend/embeddings.py— the embedding identity shared by the write and search sides.backend/max_tools.py— Max AI tools (draft a scanner prompt, digest summaries, semantic search over observations).backend/feature_flag.py—replay-visionflag check + permission.backend/admin.py— Django admin registrations.backend/temporal/vision_actions/+backend/api/vision_actions.py— scheduled follow-up actions over observations (under active development).frontend/— kea-first scenes and logics for the scanner management UI.