Repository Overview

Repository Overview

Home | Branch main Overview | Artifact Index

Aeostara is the platform-agnostic base-design package for a self-healing JSON configuration engine. ASH is the fixed upstream semantic authority; Aeostara binds ASH into JSON configuration semantics, lifecycle contracts, conformance fixtures, and downstream platform handoff requirements.

Authority Stack

flowchart TB
  ASH["ASH Pattern System<br/>fixed semantic authority"] --> Aeostara["Aeostara<br/>platform-agnostic base design"]
  Aeostara --> Win["Windows implementation repo"]
  Aeostara --> Mac["Mac implementation repo"]
  Aeostara --> Ios["iOS implementation repo"]

Loading

Repository Atlas

Area	Location	Role	Primary proof
Base definition	BASE_DESIGN_COMPLETION.md	Defines completion and non-completion conditions	Branch main Core README
ASH baseline	ASH_BASELINE_REFERENCE.md, specs/ash_baseline/	Pins upstream ASH and maps each binding	ASH Conformance
Architecture	specs/architecture/	Defines authority, boundaries, versioning, and handoff direction	Branch main Overview
Contracts	specs/contracts/	Defines every lifecycle boundary object	Contract and Schema Atlas
Algorithms	specs/algorithms/	Defines deterministic platform-neutral behavior	Runtime Logic and Workflows
Interfaces	specs/interfaces/	Defines platform adapter boundaries	Branch main Overview
Fixtures	fixtures/conformance/	Encodes input and expected semantic output	Acceptance and CI
Schema examples	fixtures/schema_examples/	Valid instances for every schema	Acceptance and CI
Handoff	implementation_handoff/, templates/platform_repo/	Tells platform repos exactly what to implement	Downstream Handoff Guide
CI	ci/	Enforces base-design gates	Acceptance and CI

Ownership Boundary

flowchart LR
  Base["Aeostara owns base semantics"] --> JSON["JSON addressing and canonicalization"]
  Base --> Projection["Semantic projection"]
  Base --> Recovery["Recovery and safety lifecycle"]
  Base --> Contracts["Contracts and fixtures"]
  Platform["Platform repos own native mechanics"] --> Storage["Storage / filesystem"]
  Platform --> Security["Policy integration"]
  Platform --> Mutation["Native mutation adapter"]
  Platform --> Verification["Native verification checks"]
  Contracts --> Platform

Loading

Completion Meaning

Aeostara is complete when an implementation team can build a faithful Windows, Mac, or iOS repo from the base design without inventing missing semantics. Completion is proved by schemas, examples, fixtures, traceability, diagnostic-chain integrity, recovery consistency, JSON semantics, handoff sufficiency, and the self-audit report.

Current Evidence

Evidence	Location
Final judgment	Branch main Core REMEDIATION STATUS and SELF_AUDIT_REPORT.md
Full conformance command	python3 ci/conformance_runner.py .
External static audit	Recorded in SELF_AUDIT_REPORT.md
Native platform source added to base repo	No