-
Notifications
You must be signed in to change notification settings - Fork 0
Branch main Core README
| Field | Value |
|---|---|
| Branch | main |
| Source | README.md |
| Commit | 5b2aac39fcf8 |
| Synced (UTC) | 2026-06-02T05:59:20Z |
This page is part of the base-design evidence set and should be read in authority-stack order.
flowchart TB
ASH["ASH authority"] --> Aeostara["Aeostara base design"]
Aeostara --> Evidence["Contracts, algorithms, fixtures, CI"]
Evidence --> Handoff["Downstream implementation handoff"]
| Question | Where to look |
|---|---|
| What role does this page play? | Read the summary and source content. |
| What does it constrain? | Trace named contracts, algorithms, fixtures, or handoff docs. |
| How is it checked? | Use the linked CI and conformance artifacts. |
Aeostara is a platform-agnostic base-design specification package for a self-healing JSON configuration engine. It conforms to the ASH Pattern System and instructs downstream Windows, Mac, and iOS implementation repositories.
Aeostara is platform-agnostic. ASH is the fixed upstream semantic authority. Platform repos consume Aeostara; Aeostara does not depend on platform repositories or native platform source code to be base-design complete.
ASH Pattern System
↓
Aeostara platform-agnostic base design
↓
Windows implementation repo
Mac implementation repo
iOS implementation repo
Conflict rule: ASH wins, Aeostara changes. This repository must not modify ASH, propose ASH changes, or add native Windows, Mac, or iOS implementation source.
See BASE_DESIGN_COMPLETION.md, ASH_BASELINE_REFERENCE.md, and Repository Role Contract.
| Category | Location | Purpose |
|---|---|---|
| ASH baseline bindings | specs/ash_baseline/ |
Aeostara bindings to the fixed ASH source areas and invariant categories |
| Contracts | specs/contracts/ |
Platform-neutral JSON schemas for every lifecycle boundary object |
| Algorithms | specs/algorithms/ |
Diagnosis-first, JSON Pointer based, ASH-aligned pseudocode |
| Interfaces | specs/interfaces/ |
Platform-neutral adapter and orchestration boundaries |
| Architecture | specs/architecture/ |
Authority hierarchy, base/platform boundary, and versioning rules |
| Acceptance | specs/acceptance/ |
Base-design completion gates, ASH traceability, and downstream handoff acceptance |
| Conformance | conformance/ |
Module mapping, invariant coverage, diagnostics, materialization boundary, deviations, and judgment artifacts |
| Fixtures |
fixtures/conformance/ and fixtures/schema_examples/
|
Expected-output vectors and valid schema instances |
| CI | ci/ |
Schema, fixture, traceability, JSON semantics, diagnostic-chain, recovery, and handoff validators |
| Downstream handoff |
implementation_handoff/ and templates/platform_repo/
|
Requirements and templates for Windows, Mac, and iOS repos |
Aeostara defines this mandatory platform-neutral lifecycle:
observe -> normalize -> project JSON/configuration state -> bind to ASH -> diagnose -> classify -> determine recoverability -> generate recovery plan -> evaluate policy gate -> prepare backup -> execute approved plan -> verify -> rollback/fallback/containment/safe-halt -> emit diagnostic and audit chain
Surface differences are evidence only. Generic JSON diffing is not semantic truth. Recovery is derived from diagnosis, classification, and recoverability, not from CRUD repair operations.
Aeostara base design is complete only when a Windows, Mac, or iOS implementation team can implement Aeostara faithfully from this repository without inventing base semantics, recovery logic, JSON semantics, diagnostics, audit requirements, or conformance expectations.
Base-design completion does not require platform-native source files. Platform-specific implementation work belongs in downstream repositories.
Run the full base-design gate locally:
python3 ci/conformance_runner.py .
Key component gates are also runnable individually:
python3 ci/validate_schemas.py .
python3 ci/fixture_validator.py .
python3 ci/traceability_checker.py .
python3 ci/ash_invariant_checker.py .
python3 ci/json_semantics_checker.py .
python3 ci/diagnostic_chain_checker.py .
python3 ci/recovery_consistency_checker.py .
python3 ci/downstream_handoff_checker.py .
python3 ci/base_design_completion_checker.py .
Copyright (c) 2026 James Daley. All Rights Reserved. Proprietary. See LICENSE.md.