Legacy template docs sit outside the ores.* physical-space graph

Table of Contents

This page is a capture in the inbox bucket of the product backlog — a pre-sprint idea, not yet pulled into a sprint as a story.

1. What

Eleven pages in projects/ores.codegen/library/templates/ are titled Archetype: ... but are typed #+type: knowledge and carry no #+facet: keyword. They are also named for the template they hold (doc_facet_org.org) instead of by MASD address. The pages are doc_facet_org, doc_facet_group_org, doc_technical_space_org, doc_archetype_org, doc_profile_org, doc_feature_org, and five sql_* pages.

The inventory generator at projects/ores.codegen/scripts/regenerate_physical_space_inventories.py globs ores.*.org only, so it never sees them. Every facet they belong to therefore reports zero archetypes in its generated table, even though the facet's own prose names the templates.

Migrate each page to the ores.<facet>.<archetype>.org filename, set #+type: archetype and #+facet: <facet>, and keep the :ID: and the #+begin_src mustache :tangle ... block unchanged so the tangle target still resolves. Then regenerate the inventories.

2. Why

The gap is invisible from the graph side: a facet page with no archetypes looks like a facet with no templates. It became visible on 2026-09-16 when the inventory regeneration replaced a hand-maintained four-row table on ores.doc.template with an empty generated one, and dropped two rows from ores.doc.modeling for doc_profile_org and doc_feature_org. Both pages recovered the rows into a section the generator does not own, but that is a patch, not a fix.

The same mis-typing may reach further than these eleven pages, and the ores.qt facet showed a related symptom: its old table claimed 12 archetypes while 9 pages exist.

3. References

  • projects/ores.codegen/scripts/regenerate_physical_space_inventories.py — the generator that globs ores.*.org.
  • doc/agile/versions/v0/sprint_25/shell-command-codegen/story.org — the wave whose inventory regeneration surfaced this.

4. See also

Emacs 29.3 (Org mode 9.6.15)