Atomic × JournalKit × Continuum

· Zi Wang · 2 min read

Canonical Architecture Alignment Brief

Purpose: eliminate naming drift and coordinate the next phase across the Atomic iOS and JournalKit backend coding sessions.


1. Canonical Naming

Atomic

The native iOS application.

Owns:

  • microphone capture
  • on-device transcription
  • transcript review and correction
  • user-facing route selection
  • progress, recovery, and artifact presentation

JournalKit

The umbrella backend and web product.

JournalKit includes several domains:

Continuum

The canonical source-of-truth subsystem inside JournalKit.

Owns:

  • Capture
  • immutable original ASR TranscriptRevision
  • append-only user corrections
  • Trace
  • TraceRelation
  • stable capture identity
  • canonical source provenance

Continuum is implemented in the wangzi/journalkit repository and the same JournalKit Supabase project. It is not a separate backend, repository, product, or authentication domain.

Reasoning Engine

The next JournalKit subsystem.

Will own:

  • route registry
  • route suggestions
  • ReasoningRun
  • ReasoningArtifact
  • workflow execution
  • durable status and recovery
  • research, debate, reflection, and idea-expansion workflows
  • provenance back to a Continuum TranscriptRevision

This subsystem is not implemented yet.

Studio

The JournalKit web application.

Owns the web UI for:

  • Continuum captures and revisions
  • future reasoning runs and artifacts
  • author review and management

Studio is a client and management surface over JournalKit domains. It is not Continuum itself.

Ghost Core

Atomic's separate commitment/action system.

Owns:

  • Intent
  • Commitment
  • ActionEvent
  • explicit promotion from reasoning into action

Ghost Core must not silently turn every capture or reasoning artifact into a commitment.


2. Unified Architecture

Atomic iOS
  capture
  transcribe
  review/correct
  choose reasoning route
        │
        ▼
JournalKit
  ├── Continuum
  │     canonical Capture + TranscriptRevision + Trace
  │
  ├── Reasoning Engine
  │     RouteSuggestion + ReasoningRun + ReasoningArtifact
  │
  └── Studio
        web view and management of source, runs, and artifacts
        │
        ▼
Ghost Core
  optional explicit promotion into commitments/actions