Branch main Arch wiki automation

Wiki Automation

Back to Branch Overview

Field	Value
Branch	main
Source	specs/architecture/wiki_automation.md
Commit	774b981ef226
Synced (UTC)	2026-07-14T05:14:42Z

Visual Context

Architecture pages define ownership, authority, and dependency direction for the base design.

flowchart TB
  ASH["ASH fixed authority"] --> Aeostara["Aeostara base design"]
  Aeostara --> Contracts["Contracts and algorithms"]
  Aeostara --> Handoff["Downstream handoff"]
  Handoff --> Platforms["Windows / Mac / iOS repos"]

Loading

Reading Checklist

Question	Where to look
Who owns the semantic decision?	Check the authority and boundary language.
What is platform-neutral?	Find Aeostara-owned obligations.
What moves downstream?	Find adapter, implementation, and deviation rules.

---

Source Content

Wiki Automation

Purpose

Define how Aeostara wiki content is generated, maintained, and refreshed across branches.

Wiki Refresh

Primary maintenance path:

• Workflow: .github/workflows/wiki-sync.yml
• Trigger: push to any branch + manual dispatch
• Generator: .github/scripts/generate_wiki_pages.py

Responsibilities:

1. Build branch-scoped overview dashboards.
2. Wrap source docs/contracts/interfaces into consistent wiki page layouts.
3. Maintain branch index and wiki Home.md.
4. Keep links and metadata deterministic.

Maintenance Sweep

Periodic refresh path:

• Workflow: .github/workflows/wiki-maintenance-sweep.yml
• Trigger: daily schedule + manual dispatch
• Scope: main base-design documentation. Platform implementation repositories maintain their own downstream wiki/API references.

Responsibilities:

1. Regenerate base-design wiki pages on schedule.
2. Keep dashboards synchronized to the latest base-design branch head.
3. Prevent stale pages in the wiki knowledge base.

Visual Structure Requirements

Generated branch overview pages must include:

• Snapshot metadata table (branch, commit, sync time)
• Branch map diagram
• Coverage table (docs/contracts/algorithms/interfaces/acceptance)
• Category navigation sections
• Back-links from leaf pages to branch overview

Determinism Requirement

Given identical source tree and commit, the generator must produce identical wiki output.