docs(corpus): fix dead generate:contracts-docs claim; census the pending fossils

testing-and-tooling.md listed `generate:contracts-docs` as live codegen "from
the morfos" — it is not. The script imports `src/uix/terra/utils/contracts.ts`
(the removed terra layer), so it no longer runs, and its output DATA_ATTRS.md is
a terra-era fossil. Corrected: the data-* contract is the morfo itself, validated
by morfo:check; the legacy script + DATA_ATTRS.md survive but are dead.

Also recorded the pending-.md census in the CONTINUE hand-off: DATA_ATTRS.md
(root, retire to process), the two dated audits (audit-opus / THEMING_AUDIT —
the latter cited in ~7 places), and what to leave (fix-stext.md is cited
provenance; MOTION_SERVICE_RFC / chronos are concurrent; words/palabras excluded).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
active-uix
dev 4 months ago
parent 9272c54278
commit 001682c254

@ -65,7 +65,12 @@ permanente/efímero, drift, dos idiomas.
- **Poda física** de las copias de vocabulario (Fase 2): hoy tienen puntero de autoridad pero conservan la lista; reemplazar por el puntero. Opcional.
- **Commitear el libro v2.3** (hoy untracked → el enlace de `CANON.md` no resuelve en remoto). Decisión del usuario.
- **Migración de idioma** coordinada (docs de capa es→en).
- **`DATA_ATTRS.md`** (fósil Terra, 2158 L, hoy LEGACY): mover a process o regenerar desde los morfos.
- **Fósiles `.md` pendientes (censo 2026-06-14, respuesta a "los .md que quedan")**:
- **`DATA_ATTRS.md`** (RAÍZ del repo, no src; 2158 L; cabecera ya LEGACY/DEPRECATED) — output de `scripts/generate-contracts-docs.ts`, que está **MUERTO** (importa `src/uix/terra/utils/contracts.ts`, capa borrada → el import falla). NO se regenera. El morfo + `morfo:check` son la fuente real. Acción: **retirar a `docs/process/`** (su propio header dice "slated to move under docs/process/"). "Regenerar desde morfos" = reescribir el generador (tarea aparte). El script muerto es también fósil (borrar = orden explícita).
- **`src/audit-opus-4-6-26.md`** (arch audit 2026-06-04) — process/efímero en ubicación de referencia, **sin citas externas** → mover a `docs/process/` limpio.
- **`src/uix/eidos/THEMING_AUDIT_2026-06-01.md`** — process/efímero, pero **citado en ~7 sitios** (CLAUDE.md ×3, THEMING.md ×3, COLOR_ENGINE_RFC) → mover requiere sweep de citas; encaja con el adelgazado de CLAUDE.md.
- **NO mover** (provenance citada, como los RFCs): `src/uix/eidos/lib/canvas-text/fix-stext.md` (citado en ~8 sitios del código canvas-text + TYPOGRAPHY_RFC). Se queda; opcional indexar en decisions.md.
- **Foráneos/concurrentes** (no tocar): `eidos/MOTION_SERVICE_RFC.md`, `eidos/components/chronos/SPEC-CHRONOS-INICIAL.md`. **Excluidos**: words/palabras.
- **Adelgazar `CLAUDE.md`**: mover sus ~10 "Session hand-off" embebidos a process/ — su propio paso, archivo sensible. (El índice E0 ya existe: `docs/README.md`, cableado desde CLAUDE.md.)
## Referencias

@ -68,7 +68,10 @@ edit the output; edit the source and regenerate.
| Command | Generates from |
| --- | --- |
| `npm run generate:eidos-css` | the eidos foundation/recipe CSS, from `EidosConfig.recipes`. (`generated/base.css` is output — regenerate, don't hand-edit.) |
| `npm run generate:contracts-docs` | the contract documentation, from the morfos. |
The `data-*` contract is **not** a generated doc — it is the morfo itself, validated
live by `npm run morfo:check`. (A legacy `generate:contracts-docs` script + its
output `DATA_ATTRS.md` survive from the removed `terra` layer and no longer run.)
The **morfo compiler** itself is the central codegen primitive: `compileMorfo(morfo)`
turns a declaration into a `CompiledMorfo` (resolved attr / keyboard / action

Loading…
Cancel
Save

Powered by TurnKey Linux.