Skip to content
github-actions[bot] edited this page Jun 19, 2026 · 109 revisions

Aeostara Knowledge Base

Visual operating map for the Aeostara platform-agnostic base design.

System Map

flowchart TB
  ASH["ASH Pattern System"] --> Base["Aeostara base design"]
  Base --> Json["JSON semantics"]
  Base --> AshBind["ASH bindings"]
  Base --> Lifecycle["Healing lifecycle"]
  Base --> Contracts["Contracts"]
  Base --> CI["Conformance CI"]
  Base --> Handoff["Downstream handoff"]
  Handoff --> Win["Windows repo"]
  Handoff --> Mac["Mac repo"]
  Handoff --> Ios["iOS repo"]
Loading

Core Logic

flowchart LR
  Observe["Observe"] --> Normalize["Normalize"] --> Project["Project"] --> Diagnose["Diagnose"]
  Diagnose --> Classify["Classify"] --> Plan["Plan recovery"] --> Gate["Policy gate"]
  Gate --> Backup["Backup"] --> Execute["Execute"] --> Verify["Verify"]
  Verify --> Safety["Rollback / fallback / containment / safe halt"] --> Audit["Audit chain"]
Loading

Quick Start

  1. Open Branch main Overview for the full visual map.
  2. Use Repository Overview for the authority model and artifact taxonomy.
  3. Use Runtime Logic and Workflows for the observe-to-safe-halt operating logic.
  4. Use ASH Conformance to trace ASH bindings, invariants, and fixture evidence.
  5. Use Acceptance and CI to understand validation gates and command outputs.
  6. Use Artifact Index to jump directly to contracts, algorithms, interfaces, and acceptance pages.

Documentation Lanes

Lane Purpose Primary pages
Authority Shows dependency direction and ownership boundaries Repository Overview, Branch main Overview
ASH binding Maps ASH source authority into Aeostara obligations ASH Conformance, Branch main Specs Index
Runtime logic Explains observe-to-safe-halt lifecycle Runtime Logic and Workflows, Diagnostic Recovery Safety Logic
JSON and projection Shows JSON Pointer, canonicalization, missing/null, and ASH coordinate projection JSON Semantics and Projection
Contracts Groups lifecycle schemas by responsibility Contract and Schema Atlas, contract pages
Evidence Shows fixture, schema, and CI proof points Acceptance and CI, conformance pages
Handoff Explains downstream Windows/Mac/iOS implementation obligations Downstream Handoff Guide, platform handoff templates

Branch Dashboards

Branch Overview Last Sync (UTC) Commit
main Open 2026-06-19T06:05:06Z 5b2aac39fcf8

Maintenance

Wiki content is refreshed by repository workflows and the branch overview generator. Generated pages include visual context, checklist tables, source references, and direct artifact links.

Clone this wiki locally