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