AAlmanac
Website
Website
GitHub
  • Introduction
  • AGENTS
  • CLAUDE
  • CONTRIBUTING
  • LICENSE
  • MANUAL
  • RELEASE
  • Implementation Tickets
  • Notes
  • CHANGELOG
  • .agents
        • SKILL
        • SKILL
  • .claude
      • Review
        • SKILL
  • Almanac
    • Introduction
    • Getting Started
      • Introduction
      • Composition Root
      • Request Models
      • Service Boundaries
      • Telemetry
        • Automation And Update
        • Instruction Installation
        • Introduction
        • Harness Contract
        • Provider Adapters
        • Adapter Boundary
        • Terminal Output
        • Introduction
        • Mutation Safety
        • Operation Runner
        • Run Queue And Sync
        • Workflows
        • Sqlite Store Boundaries
        • Local State
        • Selection And Root
        • Prompts And Manuals
        • Source Resolution And Runtime
        • Local Viewer
        • Introduction
        • Health And Validation
        • Index Refresh And Search
        • Page Identity
        • Path Normalization And File Refs
        • Topics Dag
      • Introduction
      • Lifecycle Operation
      • Local Repo Wiki
      • Page Graph
      • Run Ledger
      • Source Material
      • Introduction
      • Auto Commit Is Prompt Policy
      • Controlled Model Catalog
      • Local Only Python Product
      • Markdown Links And Sources
      • No Page Kind Field
      • No Propose Apply Or Dry Run
      • Only Almanac Root
      • Repository Affiliation Belongs In Repository Service
      • Telemetry Permission Is Final Setup Step
      • Introduction
      • Add A CLI Command
      • Add A Harness Provider Adapter
      • Add A Source Runtime Adapter
      • Debug A Failed Lifecycle Run
      • Demo Codealmanac In Launch Video
      • Maintain Topics
      • Refactoring Boundaries
      • Release Package
      • Setup Local Automation
      • Verify A Wiki Change
      • Introduction
      • Config Keys
      • Cosmic Python Translation
      • Harness Event Shape
      • Local State Layout
      • Topics YAML
        • Error And Exit Code Contract
        • JSON Output Contract
        • Public Command Surface
        • Frontmatter And Sources
        • Links And Routes
        • Run States And Events
        • Source Addresses
  • Archive
          • Introduction
            • Introduction
              • Checkout Flow
              • Payment Provider Timeouts
        • Mini
        • Reference
          • Claude Code
          • Codex
          • Generic
          • Notability
          • Purpose
          • Syntax
          • Absorb
          • Build
          • Garden
  • Docs
    • Concepts
    • Python Port Live Agreement
    • Requirements Log
      • Introduction
      • Completion Audit
      • Refactor Roadmap
      • Research Notes
      • Smells
      • Source Map
      • Subagent Briefs
      • Target Architecture
      • Worklog
        • Facade Boundary Entrypoints
        • Lifecycle Command Boundaries
        • Prior Art Patterns
        • Provider Harness Boundaries
        • Wiki Storage Query Boundaries
      • Codealmanac Install Audit
      • Codealmanac Known Bugs
      • Codebase Wiki
      • Ingest Design
      • Introduction
      • Delivery Model
      • Product Boundary Notes
      • Introduction
      • Cloud First Product Agreement 2026 07 01
      • Cloud Local Difference Map 2026 07 01
      • Firecrawl Comparison 2026 06 30
      • Mem0 Architecture And Codealmanac Implications 2026 07 01
      • Mem0 Comparison 2026 06 30
      • Mem0 Two Product Rationale 2026 07 01
      • Session 019f19ac Notes
      • Good Codebase Wikis
      • 2026 04 30 CLI Command Groups Refactor
      • 2026 04 30 CLI Refactor
      • 2026 04 30 Doctor Refactor
      • 2026 04 30 Indexer Refactor
      • 2026 04 30 Remaining Cleanup Refactor
      • 2026 04 30 Topics Refactor
      • 2026 05 06 Topics Command Refactor
      • 2026 05 07 Agent First CLI Surface
      • 2026 05 07 Command Deprecations
      • 2026 05 07 Manual Ingest Command
      • 2026 05 07 Setup Model Picker
      • 2026 05 07 Structured Output Protocol
      • 2026 05 07 Toml Project Config
      • 2026 05 08 Wiki Agent Operations And CLI Design
      • 2026 05 10 Codex App Server Provider
      • 2026 05 10 Harness Process Architecture
      • 2026 05 10 Jobs UI Redesign
      • 2026 05 10 Local Viewer
      • 2026 05 10 Search Result Summaries
      • 2026 05 10 V1 Decision Log
      • 2026 05 10 V1 Harness Refactor Implementation
      • 2026 05 10 V1 Implementation Log
      • 2026 05 10 Viewer Jobs Dashboard
      • 2026 05 11 Agent Thread Aware Run Logging
      • 2026 05 11 Almanac Naming Migration
      • 2026 05 11 Global Viewer Directory
      • 2026 05 11 Jobs Stream UI Garden
      • 2026 05 11 Scheduled Quiet Session Capture
      • 2026 05 13 Permission Gated Auto Commit
      • 2026 05 13 Provider Codex CLI Refactor
      • 2026 05 14 Auto Update
      • 2026 05 14 Long Term Architecture Cleanup
      • 2026 05 14 Long Term Architecture Decision Log
      • 2026 05 14 Long Term Architecture Implementation Log
      • 2026 05 14 Provider Automation Boundary Decision Log
      • 2026 05 14 Provider Automation Boundary Implementation Log
      • 2026 05 14 Provider Automation Boundary Refactor
      • 2026 05 28 Review Escalations
      • 2026 05 28 Source Provenance
      • 2026 05 29 Managed Provider Process
      • 2026 05 29 Per Wiki Operation Queue
      • 2026 05 30 Local Github Source Ingest Implementation Log
      • 2026 05 30 Local Github Source Ingest
      • 2026 05 31 Composio Connectors Log
      • 2026 05 31 Composio Connectors
      • 2026 05 31 Ingest Boundary Refactor
      • 2026 06 02 Hosted Github App Architecture
      • 2026 06 07 Final Output Contract
      • 2026 06 08 Architecture Cleanup Log
      • 2026 06 08 Architecture Cleanup
      • 2026 06 08 Codex SDK Spike
      • 2026 06 08 Deep Refactor Remaining Plan
      • 2026 06 08 Jobs Lifecycle Refactor
      • 2026 06 08 Standardization Pass
      • 2026 06 13 Docs Almanac Layout
      • 2026 06 26 CLI Onboarding Agent Targets Contract
      • 2026 06 26 CLI Onboarding Rebias Contract
      • 2026 07 05 CLI Pretty Rendering
      • 2026 07 06 App Composition Refactor
      • 2026 07 06 Branded Onboarding Polish
      • 2026 07 06 Branded Onboarding
      • 2026 07 06 Codex Event Dispatch Refactor
      • 2026 07 06 Full Uninstall
      • 2026 07 06 Generous Lifecycle Mutation
      • 2026 07 06 Markdown Page Links
      • 2026 07 06 Openalmanac Figlet Onboarding
      • 2026 07 06 Operation Trigger Queue Decisions
      • 2026 07 06 Prompt Commit Policy
      • 2026 07 06 Prompt Manual Refresh
      • 2026 07 06 Raw Input Types Refactor
      • 2026 07 06 Runtime State Home
      • 2026 07 06 Scheduled Auto Update
      • 2026 07 06 Setup Render Refactor
      • 2026 07 06 Sources Canonical
      • 2026 07 06 Sync Execution Refactor
      • 2026 07 06 Three Operation Architecture
      • 2026 07 06 Validate Command
      • 2026 07 07 Controlled Model Config
      • 2026 07 07 Deployed Codealmanac Smoke Plan
      • 2026 07 07 Gorgeous CLI Syntax Errors
      • 2026 07 07 Hide Provider Text Deltas
      • 2026 07 07 Job Queue Harness Stream Architecture
      • 2026 07 07 Test Migration
      • 2026 07 10 Agent Instructions Guide
      • 2026 07 10 Launchd Identity And Status
      • 2026 07 10 User Toml Automation Preferences
      • 2026 07 11 Jobs Attach Interrupt
      • 2026 07 11 Restore Repository Manuals
      • 2026 07 14 Section Search Design
      • 2026 07 15 Ca CLI Alias
      • 2026 07 15 CLI Telemetry Live Agreement
      • 2026 07 15 CLI Telemetry
      • 2026 07 16 Agent Guide Inline Citations
      • 2026 07 16 CLI Telemetry Follow Up Review Fixes
      • 2026 07 16 CLI Telemetry Review Fixes
      • 2026 07 16 CLI Telemetry Third Review Fixes
      • 2026 07 16 Serve Opens Viewer
      • 2026 07 16 Viewer First Job Receipt
      • Fixes Slice 1 Review
      • Fixes Slice 139 Review
      • Fixes Slice 141 Review
      • Fixes Slice 2 Review
      • Fixes Slice 3 Review
      • Fixes User Toml Automation Review
      • Slice 139 Real Job Cancellation
      • Slice 140 Yoke Runtime Integration
      • Slice 141 Native Yoke Agent Runtime
      • Slice 141 Section Search
      • Slice 142 Atomic Worker Idle Handoff
      • Slice 3 Topics Tag Health
      • Slice 4 Bootstrap
      • Slice 5 Capture
      • Introduction
      • Completion Audit
      • Fixes Slice 85 Review
      • Fixes Slice 9 Review
      • Idea Evolution
      • Next Agent Brief
      • Ownership Map
      • Product Debt
      • Public Beta Gate Audit
      • Public Release Readiness
      • Slice 10 Runs Ledger
      • Slice 100 Codex Event Boundaries
      • Slice 101 Codex App Server Client Boundaries
      • Slice 102 Index Store Boundaries
      • Slice 103 Sync Policy Boundaries
      • Slice 104 Github Source Runtime Boundaries
      • Slice 105 Transcript Source Runtime Boundaries
      • Slice 106 Source Address Resolution Boundaries
      • Slice 107 CLI Render Facade
      • Slice 108 Filesystem Listing Boundaries
      • Slice 109 Sync Execution Boundaries
      • Slice 11 Source Input Contracts
      • Slice 110 Viewer Service Boundaries
      • Slice 111 Web Source Runtime Boundaries
      • Slice 112 Workspace Service Boundaries
      • Slice 113 Harness Contract Boundaries
      • Slice 114 Diagnostics Boundaries
      • Slice 115 Topic Service Boundaries
      • Slice 116 Source Address Family Boundaries
      • Slice 117 Automation Service Boundaries
      • Slice 118 Server Route Boundaries
      • Slice 119 Wiki Topic YAML Boundaries
      • Slice 12 Harness Contracts
      • Slice 120 Run Store Factory Query Boundaries
      • Slice 121 CLI Wiki Dispatch Boundaries
      • Slice 122 CLI Wiki Render Boundaries
      • Slice 123 CLI Admin Render Boundaries
      • Slice 124 CLI Admin Dispatch Boundaries
      • Slice 125 CLI Lifecycle Dispatch Boundaries
      • Slice 126 CLI Admin Parser Boundaries
      • Slice 127 Remove Page Archive Lineage
      • Slice 128 Workspace Root Resolution
      • Slice 129 Index Health View Boundaries
      • Slice 13 Ingest Workflow
      • Slice 130 Setup Instruction Boundaries
      • Slice 131 Setup Service Boundaries
      • Slice 132 Sync Evaluation Boundaries
      • Slice 133 Topic Mutation Boundaries
      • Slice 134 Lifecycle Helper Boundaries
      • Slice 135 Streaming Jobs Attach
      • Slice 136 Real Codex App Server Dogfood
      • Slice 137 Real Claude SDK Dogfood
      • Slice 138 Current Head Release Smoke
      • Slice 14 Claude CLI Adapter
      • Slice 15 Ingest Mutation Safety
      • Slice 16 Public Ingest CLI
      • Slice 17 Codex CLI Adapter
      • Slice 18 Garden Workflow
      • Slice 19 Sync Status
      • Slice 2 Read Model
      • Slice 20 Harness Transcript Feedback
      • Slice 21 Sync Internal Exclusion
      • Slice 22 Foreground Sync
      • Slice 23 Automation
      • Slice 24 Git Source Runtime
      • Slice 25 Github Source Runtime
      • Slice 26 Transcript Source Runtime
      • Slice 27 Web Source Runtime
      • Slice 28 Filesystem Source Runtime
      • Slice 29 Update Command
      • Slice 3 Topics Health
      • Slice 30 Viewer File Route
      • Slice 31 Filesystem Git Listing
      • Slice 32 Filesystem Directory Selection
      • Slice 33 Public Contract Guards
      • Slice 34 Manual Surface
      • Slice 35 Sync Pending Claims
      • Slice 36 Run Lifecycle State
      • Slice 37 Sync Pending Run Linkage
      • Slice 38 Database Boundary
      • Slice 39 Config Boundary
      • Slice 4 Tag Untag
      • Slice 40 CLI Edge Split
      • Slice 41 Configurable Root
      • Slice 42 Source Runtime Context
      • Slice 43 Scheduled Sync Retry Policy
      • Slice 44 Clean Directory Diversity
      • Slice 45 Viewer Wikilink Token Safety
      • Slice 46 Serve Visual Port
      • Slice 47 Viewer Frontend Modules
      • Slice 48 Update Install Dogfood
      • Slice 49 CLI Admin Edge Split
      • Slice 5 Topic Metadata
      • Slice 50 Index Read Views
      • Slice 51 Serve Shell Polish
      • Slice 52 Manual Drift Diagnostics
      • Slice 53 Registry List Management
      • Slice 54 Harness Failure Logs
      • Slice 55 Normalized Harness Events
      • Slice 56 Public Release Readme
      • Slice 57 Real Codex Ingest Dogfood
      • Slice 58 Real Claude Ingest Dogfood
      • Slice 59 Real Sync Dogfood
      • Slice 6 Topic Rewrite
      • Slice 60 Serve Browser Proof
      • Slice 61 Final Package Rehearsal
      • Slice 62 Python Release Guide
      • Slice 63 Missing Root Hygiene
      • Slice 64 Readme Scaffold Accuracy
      • Slice 65 Readme Quickstart Dogfood
      • Slice 66 Readme Lifecycle Source Examples
      • Slice 67 Next Agent Brief Freshness
      • Slice 68 Public Beta Gate Audit
      • Slice 69 Current Head Package Rehearsal
      • Slice 7 Build Reindex
      • Slice 70 Real Source Shape Dogfood
      • Slice 71 Current Head Package Smoke
      • Slice 72 CLI Domain Dispatch
      • Slice 73 Page Run Workflow
      • Slice 74 Jobs Control
      • Slice 75 Run Queue Core
      • Slice 76 Background Worker Spawn
      • Slice 77 Sync Background Enqueue
      • Slice 78 Structured Page Sources
      • Slice 79 Setup Uninstall Instructions
      • Slice 8 Doctor
      • Slice 80 Setup Terminal Renderer
      • Slice 81 Multi Wiki Serve
      • Slice 82 Rich Harness Events
      • Slice 83 Codex App Server Harness
      • Slice 84 Claude SDK Harness
      • Slice 85 Claude Event Boundaries
      • Slice 86 Codex Default Setup Plan
      • Slice 87 Setup Automation Options
      • Slice 88 Setup Automation Docs
      • Slice 89 Serve Jobs View
      • Slice 9 Serve
      • Slice 90 Harness Event Rendering
      • Slice 91 Serve Job Polling
      • Slice 92 Run Id Validation
      • Slice 93 Github Python Automation
      • Slice 94 Github Contract Proof
      • Slice 95 Sync Policy Extraction
      • Slice 96 Filesystem Runtime Boundaries
      • Slice 97 Run Ledger Persistence Boundaries
      • Slice 98 Index Read View Boundaries
      • Slice 99 Source Target Fallback
      • Verification Matrix
      • Worklog
      • Introduction
      • Feature Questions
      • Hand Rolled Inventory
      • Refactor Roadmap
      • Research Notes
      • Smells
      • Source Map
      • Subagent Briefs
      • Target Architecture
      • Worklog
        • Boundary Critic
        • Feature Skeptic
        • Hand Rolled Critic
        • Target Architect
      • Introduction
      • Comparison
      • Target Mechanism
      • Worklog
      • Introduction
      • Final Audit
      • Product Slop
      • Refactor Roadmap
      • Smells
      • Source Map
      • Target Architecture
      • Worklog
      • 2026 05 07 Agent Provider CLI Implementation
      • 2026 05 07 Agent Provider Structure Writeup
      • 2026 05 07 CLI Config Best Practices
      • 2026 05 07 CLI Surface Design
      • 2026 05 07 Market Pain Research
      • 2026 05 08 Agentic Wiki Compilation
      • 2026 05 08 Auto Generating Wikis Deep Research
      • 2026 05 08 Auto Updating Wiki Algorithms
      • 2026 05 08 Initial Codebase Wiki Construction
      • 2026 05 09 Claude Harness Capabilities
      • 2026 05 09 Codex Harness Capabilities
      • 2026 05 28 Open Source Codebase Wiki And Review Tools
      • 2026 05 29 Github Context Connectors
      • Agent SDK
      • Coderabbit Github App Flow
      • Farzapedia
      • Karpathy LLM Wiki
      • 2026 05 28 Remote Codealmanac Product Concept
      • 2026 05 29 Open Source Almanac Concept
      • Codealmanac Vs Deepwiki Supermemory
      • Agent Packages
      • Verification Matrix
      • Worklog
        • Introduction
        • CODEALMANAC
        • LICENSE
        • Additional Resources
        • API Layer
        • Application Overview
        • Components And Styling
        • Deployment
        • Error Handling
        • Performance
        • Project Standards
        • Project Structure
        • Security
        • State Management
        • Testing
        • Introduction
        • CODEALMANAC
        • LICENSE
        • Appendix Csvs
        • Appendix Django
        • Appendix Ds1 Table
        • Appendix Project Structure
        • Appendix Validation
        • Book
        • Chapter 01 Domain Model
        • Chapter 02 Repository
        • Chapter 03 Abstractions
        • Chapter 04 Service Layer
        • Chapter 05 High Gear Low Gear
        • Chapter 06 Uow
        • Chapter 07 Aggregate
        • Chapter 08 Events And Message Bus
        • Chapter 09 All Messagebus
        • Chapter 10 Commands
        • Chapter 11 External Events
        • Chapter 12 Cqrs
        • Chapter 13 Dependency Injection
        • Epilogue 1 How To Get There From Here
        • Part1
        • Part2
        • Preface
  • Src
          • Instructions
          • Instructions
          • Instructions
        • Introduction
        • Architecture
        • Concepts
        • Decisions
        • Evidence
        • Garden
        • How To Guides
        • How To Write
        • Ingest
        • Links
        • Sources
        • Topics
        • Reference
          • Agent Guide
Powered by Docsbook
Docs/Reference/Cosmic Python/Book

Architecture Patterns with Python

This file is the Markdown table of contents for the local reference copy.

Front Matter#

  • Preface
  • Introduction: Why Do Our Designs Go Wrong?

Part 1#

  • Part 1 Intro
  • Chapter 1: Domain Model
  • Chapter 2: Repository
  • Chapter 3: Interlude: Abstractions
  • Chapter 4: Service Layer
  • Chapter 5: TDD in High Gear and Low Gear
  • Chapter 6: Unit of Work
  • Chapter 7: Aggregates

Part 2#

  • Part 2 Intro
  • Chapter 8: Domain Events and a Simple Message Bus
  • Chapter 9: Going to Town on the MessageBus
  • Chapter 10: Commands
  • Chapter 11: External Events for Integration
  • Chapter 12: CQRS
  • Chapter 13: Dependency Injection

End Matter#

  • Epilogue: How Do I Get There from Here?
  • Appendix A: Recap Table
  • Appendix B: Project Structure
  • Appendix C: A Major Infrastructure Change, Made Easy
  • Appendix D: Django
  • Appendix F: Validation
Appendix ValidationPreviousChapter 01 Domain ModelNext

On this page

  • Front Matter
  • Part 1
  • Part 2
  • End Matter

Edit this page on GitHub

Was this page helpful?

On this page

  • Front Matter
  • Part 1
  • Part 2
  • End Matter

Edit this page on GitHub

Was this page helpful?