Released21 changes

Version 0.3.0

Docs system stands up, pattern library expands from STUB skeletons to reference-quality entries, and the /root brand mark gets a gradient treatment across the site. Site becomes a real docs+content surface — no longer just a hero page.

Site infrastructure

  • •
    Docs system — custom Astro components: DocLayout, Sidebar, Search (⌘K modal), Breadcrumbs, PrevNext. Enchanté-style dark theme with gradient accents. Replaces raw-markdown reading as the operator's daily source of truth.
  • •
    Dynamic docs routing — src/pages/[...slug].astro renders every content-collection entry through DocLayout.
  • •
    Search index endpoint — src/pages/search-index.json.ts produces a static JSON index consumed by the ⌘K modal.
  • •
    Navigation — Header updates: Studio nav pill (purple accent), Projects dropdown (Enchanté-style), Releases link.
  • •
    Releases page — CHANGELOG-driven hero + latest-release detail + timeline (src/pages/releases/).
  • •
    Studio landing page — Year 5 capstone product placeholder (src/pages/studio/index.astro).
  • •
    Projects landing — dynamic src/pages/projects/[project].astro plus index.

Content — Tier A landing surfaces

  • •
    Master Plan rewritten — to source-of-truth quality: em-dash discipline, tightened prose, defensible claims.
  • •
    Pattern library indexes — top-level pattern-library index + all 10 category indexes expanded to reference-quality landing pages.
  • •
    Capstone, Story, Glossary, Reading List — expanded and consistency-passed.
  • •
    26 files total in the Tier A pass.

Content — Tier B pattern entries

  • •
    75 STUB pattern entries expanded — from ~30 lines to ~130-145 lines each, while preserving STUB depth-honesty (status stays STUB — no operational evidence yet).
  • •
    Each expansion adds: "What this pattern is" (2-3 paragraphs), "Concrete instances in the wild" (~10 real-world examples), "Why this pattern matters" (4-6 paragraphs), "Preview: what OUTLINE will answer" (PROBLEM / PRINCIPLES / TRADE-OFFS / TOOLS), and "Canonical references."
  • •
    Coverage across all 10 categories: foundations (5), architecture (4), storage-and-data (6), security-and-policy (5), observability-and-ops (6), networking (6), infrastructure-and-platform (8), distributed-systems (10), data-engineering (3), ml-systems (22).

/root brand mark

  • •
    RootBrand component — (src/components/RootBrand.astro) — splits text on /root and wraps matches in <span class="root-brand">.
  • •
    .root-brand CSS class — in src/styles/base.css — purple → pink → orange gradient (matches .text-gradient), font-weight: 600.
  • •
    rehypeRootBrand plugin — in astro.config.mjs — auto-wraps /root in markdown body prose. Skips <code>, <pre>, <a>, <script>, <style>; regex rejects /root followed by word char, hyphen, or slash so URL paths (/root/foo), identifiers (/root-abc), and pluralizations (/roots) stay untouched.
  • •
    Layout integration — DocLayout renders h1 + description through RootBrand; landing, releases, docs, and projects pages updated inline. Navbar and browser <title> tag deliberately untouched.

Fixed

  • •
    Public-safety violation in patterns/data-engineering/lakehouse.md — bullet naming "Apple Iceberg deployments" replaced with generic "Frontier-lab Iceberg deployments" framing per INTERNAL-PARALLELS.md guidance. Confirmed via full grep sweep: no bare "Apple" mentions remain anywhere in src/content/docs/patterns/.

Notes

  • •
    Depth ladder preserved. — Every expanded pattern entry stays status: STUB because there is no operational evidence yet. STUB → OUTLINE promotions happen when the relevant Y2-Y5 phase deploys the pattern on basecamp; DEEP promotions require 6+ months of operational history.
  • •
    Public-safety audit re-run 2026-07-02. — All src/content/docs/ content scanned against the internal-terms catalog; one violation caught and fixed (above).
View in CHANGELOG.md on GitHub
← All releases