Monorepo for Aesthetic.Computer
aesthetic.computer
1# Docs + L5 Touchpoints Report
2
3Updated: 2026-02-26
4Scope window: `bddb38067` (L5 planning) -> `f15c1c3ce` (latest docs pass)
5
6## Executive Summary
7
8- L5 runtime + docs + subdomain surface shipped and iterated in production code paths.
9- `/docs` is now split into explicit lanes (`MJS`, `L5`, `KidLisp`) plus added `Prompts` and `Pieces` lanes.
10- Function-level docs now have structured pages with embedded iframe preview/run/reset controls.
11- API docs coverage is near complete; prompt and piece docs are partially complete and now easier to browse.
12
13## Touchpoints Matrix
14
15### 1) L5 runtime and execution bridge
16
17- `system/public/aesthetic.computer/lib/l5.mjs`
18- `system/public/aesthetic.computer/boot.mjs`
19- `system/public/aesthetic.computer/lib/disk.mjs`
20- `system/public/aesthetic.computer/disks/l5-hello.lua`
21- `system/public/aesthetic.computer/dep/wasmoon/*`
22
23Key commits:
24- `da230c6ab` feat(l5): add docs checklist, try page, and l5 routing
25- `577cf8930` fix(l5): ship lua runtime assets and yellow/black/white l5 page
26- `f544d02ee` fix: ... L5/boot updates
27
28Status:
29- L5 runtime path is wired and shippable.
30- Lua assets are vendored and loaded from AC public runtime.
31
32### 2) L5 web surface (`/l5` and subdomain)
33
34- `system/public/l5.aesthetic.computer/index.html`
35- `system/public/l5.aesthetic.computer/l5-logo-blob.png`
36- `system/public/l5.aesthetic.computer/studies/l5lua-style-study.md`
37- `studies/l5lua-org-style-study.md`
38
39Key commits:
40- `da230c6ab`, `577cf8930`, `36f8925ce`, `3ed77f5d9`
41
42Status:
43- Yellow/black/white visual direction implemented.
44- Absolute `https://aesthetic.computer` URL strategy applied for subdomain reliability.
45
46### 3) Routing/deploy touchpoints
47
48- `system/netlify.toml`
49
50Key commits:
51- `da230c6ab` (L5 routing additions)
52- `f544d02ee` (follow-up updates)
53
54Status:
55- L5 route handling added/updated in deploy config.
56
57### 4) Docs backend and docs UX overhaul
58
59- `system/netlify/functions/docs.js`
60- `plans/docs-js-lua-overhaul-hitlist.md`
61
62Key commits:
63- `198111374` (hitlist baseline)
64- `38a63ae37` (lane split + structured pages)
65- `5d3357fde`, `889b17196`, `f70de5b98` (major API coverage passes)
66- `66188a069` (lane visual separation polish)
67- `ce318aa3b` (shared description source for prompts/pieces)
68- `dc22a7816` (direct preview routes for prompt/piece docs)
69- `220d2c085` (prompt/piece lanes + browse index routes)
70- `f15c1c3ce` (top prompt command docs completion pass)
71- `53ec884ab` (hitlist refresh with current metrics)
72
73Status:
74- Docs now support structured function pages + live preview embedding.
75- API lanes are complete except for 3 in-progress L5 status pages.
76
77### 5) Prompt command integration touchpoints
78
79- `system/public/aesthetic.computer/disks/prompt.mjs`
80- `system/netlify/functions/docs.js` (prompt docs registry usage)
81
82Key commits:
83- `da230c6ab`
84- `3919eb26f`
85- `ce318aa3b`
86- `f15c1c3ce`
87
88Status:
89- Prompt docs now consume shared descriptions and have better command-level coverage.
90
91### 6) External/manual infra touchpoints (not git-tracked)
92
93- Cloudflare DNS/domain entries for `l5.aesthetic.computer`
94- `prompt.ac` zone redirect change
95- Netlify dashboard domain wiring
96
97Status:
98- Manual operations by operator; not represented directly in git diff.
99- Recommend dashboard-level verification as part of release checklist.
100
101## Current Coverage Snapshot (`/docs.json`)
102
103Captured: 2026-02-26
104
105- API total: `310` (`307 done`, `3 in-progress`, `0 planned`)
106- MJS lane total: `264` (`264 done`, `0 in-progress`, `0 planned`)
107- L5 lane total: `50` (`47 done`, `3 in-progress`, `0 planned`)
108- KidLisp lane total: `2` (`2 done`)
109- Prompts total: `129` (`58 done`, `71 planned`)
110- Pieces total: `186` (`23 done`, `163 planned`)
111
112## Recent Commit Timeline (selected, in order)
113
1141. `da230c6ab` feat(l5): add docs checklist, try page, and l5 routing
1152. `577cf8930` fix(l5): ship lua runtime assets and yellow/black/white l5 page
1163. `f544d02ee` fix: ... L5/boot updates
1174. `3ed77f5d9` docs(l5): add l5lua style study
1185. `36f8925ce` fix(l5): use absolute aesthetic.computer urls on l5 page
1196. `198111374` plans(docs): add unified mjs+l5+kidlisp overhaul hitlist
1207. `38a63ae37` feat(docs): split docs lanes and add structured API pages
1218. `5d3357fde` docs: expand mjs api coverage and add preview run/reset
1229. `889b17196` docs: complete number/help api coverage and refresh hitlist
12310. `f70de5b98` docs: complete structure/sound docs and expand l5 function api
12411. `66188a069` docs: color-code api lanes for mjs, l5, and kidlisp
12512. `ce318aa3b` docs: auto-fill prompt and piece descriptions from shared registry
12613. `dc22a7816` docs: use direct piece and prompt preview routes in doc iframes
12714. `53ec884ab` plans: refresh docs overhaul hitlist with current coverage and shipped work
12815. `220d2c085` docs: add prompt/piece lanes and browse index routes
12916. `f15c1c3ce` docs: complete top prompt command docs with examples and status
130
131## Remaining Open Touchpoints
132
133- L5 in-progress docs status pages still to finalize:
134 - `l5:lifecycle`
135 - `l5:graphics`
136 - `l5:input`
137- Prompt docs backlog: `38` visible commands still planned.
138- Piece docs backlog: `163` entries still planned.
139- Unified cross-site source adapter work (AC docs + learn.kidlisp.com) still pending.
140
141## Verification Commands Used For This Report
142
143- `git log --oneline -n 20`
144- `git log --name-only --pretty=... --since=2026-02-25`
145- `node` checks against `/docs.json` via `system/netlify/functions/docs.js` handler