Chronicle Visualizer
Chronicle Visualizer is a privacy-first visual work-history project. It started with a real local Chronicle browser that indexed recent screen frames and persisted Chronicle summaries, then split into a public-facing Next.js scaffold and a private archive/redaction operating lane. The project is not just a screenshot gallery. Its product shape is a governed visual evidence system: raw frames stay private, written context is archived with images, public derivatives require redaction and review, and project/work-state labels remain inferred until corroborated by durable sources.
Narrative
Privacy-first visual work history
Chronicle Visualizer is a visual work-history project that treats screenshots as sensitive source evidence rather than as automatically public media. The project decision is to split the system into private raw capture/archive, a local-only viewer for forensic browsing, and a public scaffold that only uses synthetic or redacted derivatives. That constraint matters because the useful product experience is exactly what makes the data sensitive: dense screen-frame browsing, inferred project labels, local source paths, OCR hints, and related Chronicle summaries can reveal private work context even when a single frame looks harmless.
From local MVP to governed public scaffold
The first real MVP lived under the Codex Skills local tooling tree and proved the interaction model: date-grouped thumbnails, search, inferred project filters, selected-frame detail, nearby frames, and related summary matching. The Chronicle Visualizer repo then turned that proof into a public-project scaffold with repo-native docs, project tracking, and an app-first timeline surface that uses synthetic/redacted placeholders. The public scaffold is intentionally limited until a redaction and review workflow can generate approved public images, manifests, and labels.
Durable private archive before publication
The project now has a completed v1 private archive lane: raw screen recordings and written Codex/Chronicle context are bundled, client-encrypted, uploaded to a private S3 bucket with account guardrails, verified through receipts, and preserved by a scheduled LaunchAgent. This storage workflow is evidence that the project chose durable private retention before public display. The remaining public limit is not storage, but publication safety: redaction manifests, review boards, and human approval must exist before real Chronicle-derived visuals become public.
System surfaces
Public visual timeline scaffold
Next.js app-first surface with synthetic/redacted frame cards, date groups, project filters, search, redaction status, date rail, and selected-frame inspector.
Private local Chronicle viewer
Local-only Node viewer that indexes recent Chronicle frames, memory summaries, OCR sidecars, inferred project labels, thumbnails, nearby frames, and frame-detail context.
Encrypted raw archive
Node archive scripts plus LaunchAgent preserve rolling screen data and written context through encrypted S3 snapshots, deltas, receipts, restore dry-runs, and local prune controls.
Redaction and review board pipeline
Governance docs define raw-private, candidate-redacted, approved-public, and quarantined states, with pixel-burned redaction and human review required before publication.
Implementation stack
Public app
- • Next.js 15
- • React 19
- • app router
- • CSS app shell
- • synthetic/redacted timeline placeholders
Private viewer
- • Node HTTP server
- • local filesystem index
- • Chronicle screen frames
- • Chronicle memory summaries
- • OCR sidecar search metadata
- • thumbnail cache
Archive and storage
- • Node archive scripts
- • macOS LaunchAgent
- • AWS S3
- • GPG AES256 client encryption
- • manifest and receipt JSON
- • restore dry-run
Governance
- • DOCS project lifecycle
- • checkpoint logs
- • review-board operating pattern
- • redaction publication states
- • privacy denylist planning
Evidence
26 artifacts grouped by type so each kind of proof can be scanned on its own.
Data models
2 artifactsWorkflows
2 artifactsImages
9 artifacts
imageChronicle Visualizer Detail View
imageChronicle Visualizer Timeline Overview - Bottom
imageChronicle Visualizer Timeline Overview - Lower Middle
imageChronicle Visualizer Timeline Overview - Top
imageChronicle Visualizer Timeline Overview - Upper Middle
imageDesktop source-app screenshot of the synthetic/redacted timeline scaffold with project filters, search, date rail, and selected-frame inspector.
imageMobile source-app screenshot of the public timeline scaffold, confirming the synthetic/redacted surface is responsive.
imageSource-app docs route summarizing the Context Layer, privacy/redaction, and archive/storage docs.
imageSource-app projects route showing public-facing lifecycle tracks for setup, archive/storage, privacy/redaction, and viewer roadmap.
Chats
4 artifactsNotes
9 artifactsChronicle Visualizer Intake Dossier
README
project-master
0002_capture-archive-storage-design
0003_privacy-redaction-publication-pipeline
0004_visual-timeline-viewer-roadmap
archive-runbook
page
server
Connected references
Key dates
The Building Chronicle MVP chat and linked screenshots show the local viewer browsing real Chronicle frames with search, filters, detail overlay, nearby frames, and related summaries.
The source repo was scaffolded with an app-first public visual timeline that uses synthetic/redacted placeholders and keeps docs/project tracking as secondary routes.
Project 0002 completed encrypted S3 raw storage, scheduled incremental uploads, remote verification, restore dry-run, and local prune controls.
The original local Chronicle viewer source was imported into `local-tools/chronicle-visualizer/`, with generated thumbnail cache and raw Chronicle data excluded from git.