# Docs + L5 Touchpoints Report

Updated: 2026-02-26  
Scope window: `bddb38067` (L5 planning) -> `f15c1c3ce` (latest docs pass)

## Executive Summary

- L5 runtime + docs + subdomain surface shipped and iterated in production code paths.
- `/docs` is now split into explicit lanes (`MJS`, `L5`, `KidLisp`) plus added `Prompts` and `Pieces` lanes.
- Function-level docs now have structured pages with embedded iframe preview/run/reset controls.
- API docs coverage is near complete; prompt and piece docs are partially complete and now easier to browse.

## Touchpoints Matrix

### 1) L5 runtime and execution bridge

- `system/public/aesthetic.computer/lib/l5.mjs`
- `system/public/aesthetic.computer/boot.mjs`
- `system/public/aesthetic.computer/lib/disk.mjs`
- `system/public/aesthetic.computer/disks/l5-hello.lua`
- `system/public/aesthetic.computer/dep/wasmoon/*`

Key commits:
- `da230c6ab` feat(l5): add docs checklist, try page, and l5 routing
- `577cf8930` fix(l5): ship lua runtime assets and yellow/black/white l5 page
- `f544d02ee` fix: ... L5/boot updates

Status:
- L5 runtime path is wired and shippable.
- Lua assets are vendored and loaded from AC public runtime.

### 2) L5 web surface (`/l5` and subdomain)

- `system/public/l5.aesthetic.computer/index.html`
- `system/public/l5.aesthetic.computer/l5-logo-blob.png`
- `system/public/l5.aesthetic.computer/studies/l5lua-style-study.md`
- `studies/l5lua-org-style-study.md`

Key commits:
- `da230c6ab`, `577cf8930`, `36f8925ce`, `3ed77f5d9`

Status:
- Yellow/black/white visual direction implemented.
- Absolute `https://aesthetic.computer` URL strategy applied for subdomain reliability.

### 3) Routing/deploy touchpoints

- `system/netlify.toml`

Key commits:
- `da230c6ab` (L5 routing additions)
- `f544d02ee` (follow-up updates)

Status:
- L5 route handling added/updated in deploy config.

### 4) Docs backend and docs UX overhaul

- `system/netlify/functions/docs.js`
- `plans/docs-js-lua-overhaul-hitlist.md`

Key commits:
- `198111374` (hitlist baseline)
- `38a63ae37` (lane split + structured pages)
- `5d3357fde`, `889b17196`, `f70de5b98` (major API coverage passes)
- `66188a069` (lane visual separation polish)
- `ce318aa3b` (shared description source for prompts/pieces)
- `dc22a7816` (direct preview routes for prompt/piece docs)
- `220d2c085` (prompt/piece lanes + browse index routes)
- `f15c1c3ce` (top prompt command docs completion pass)
- `53ec884ab` (hitlist refresh with current metrics)

Status:
- Docs now support structured function pages + live preview embedding.
- API lanes are complete except for 3 in-progress L5 status pages.

### 5) Prompt command integration touchpoints

- `system/public/aesthetic.computer/disks/prompt.mjs`
- `system/netlify/functions/docs.js` (prompt docs registry usage)

Key commits:
- `da230c6ab`
- `3919eb26f`
- `ce318aa3b`
- `f15c1c3ce`

Status:
- Prompt docs now consume shared descriptions and have better command-level coverage.

### 6) External/manual infra touchpoints (not git-tracked)

- Cloudflare DNS/domain entries for `l5.aesthetic.computer`
- `prompt.ac` zone redirect change
- Netlify dashboard domain wiring

Status:
- Manual operations by operator; not represented directly in git diff.
- Recommend dashboard-level verification as part of release checklist.

## Current Coverage Snapshot (`/docs.json`)

Captured: 2026-02-26

- API total: `310` (`307 done`, `3 in-progress`, `0 planned`)
- MJS lane total: `264` (`264 done`, `0 in-progress`, `0 planned`)
- L5 lane total: `50` (`47 done`, `3 in-progress`, `0 planned`)
- KidLisp lane total: `2` (`2 done`)
- Prompts total: `129` (`58 done`, `71 planned`)
- Pieces total: `186` (`23 done`, `163 planned`)

## Recent Commit Timeline (selected, in order)

1. `da230c6ab` feat(l5): add docs checklist, try page, and l5 routing
2. `577cf8930` fix(l5): ship lua runtime assets and yellow/black/white l5 page
3. `f544d02ee` fix: ... L5/boot updates
4. `3ed77f5d9` docs(l5): add l5lua style study
5. `36f8925ce` fix(l5): use absolute aesthetic.computer urls on l5 page
6. `198111374` plans(docs): add unified mjs+l5+kidlisp overhaul hitlist
7. `38a63ae37` feat(docs): split docs lanes and add structured API pages
8. `5d3357fde` docs: expand mjs api coverage and add preview run/reset
9. `889b17196` docs: complete number/help api coverage and refresh hitlist
10. `f70de5b98` docs: complete structure/sound docs and expand l5 function api
11. `66188a069` docs: color-code api lanes for mjs, l5, and kidlisp
12. `ce318aa3b` docs: auto-fill prompt and piece descriptions from shared registry
13. `dc22a7816` docs: use direct piece and prompt preview routes in doc iframes
14. `53ec884ab` plans: refresh docs overhaul hitlist with current coverage and shipped work
15. `220d2c085` docs: add prompt/piece lanes and browse index routes
16. `f15c1c3ce` docs: complete top prompt command docs with examples and status

## Remaining Open Touchpoints

- L5 in-progress docs status pages still to finalize:
  - `l5:lifecycle`
  - `l5:graphics`
  - `l5:input`
- Prompt docs backlog: `38` visible commands still planned.
- Piece docs backlog: `163` entries still planned.
- Unified cross-site source adapter work (AC docs + learn.kidlisp.com) still pending.

## Verification Commands Used For This Report

- `git log --oneline -n 20`
- `git log --name-only --pretty=... --since=2026-02-25`
- `node` checks against `/docs.json` via `system/netlify/functions/docs.js` handler