Skip to content

Commit 59f78bc

Browse files
committed
no-mistakes(document): Fixed stale template-header overwrite claims in three docs and one stale audit-axis reference; ADRs, CHANGELOG and JVM docs already matched the change.
1 parent 826a65d commit 59f78bc

4 files changed

Lines changed: 11 additions & 12 deletions

File tree

‎agent-context/skills/metaobjects-audit/references/surface-review-axes.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,8 +141,7 @@ The full hunt for each axis of Phase 1b (Partial / Deep path). Each axis runs in
141141
taxonomy impurity (entity over read-only primary source; read model that should be
142142
`object.projection`; `value` carrying identity/source, ADR-0028); copy-pasted base-field
143143
blocks — or the same-named field re-declared across objects (drift signature 10) — instead of
144-
abstract + `extends`; `@`-prefixed YAML keys (ADR-0006); relative refs
145-
in committed canonical JSON (ADR-0032); DB-type-as-logical-subtype (ADR-0013); per-port
144+
abstract + `extends`; `@`-prefixed YAML keys (ADR-0006); DB-type-as-logical-subtype (ADR-0013); per-port
146145
migration engine where schema is Node-`meta`-owned (ADR-0015).
147146

148147
- [ ] **H2. Wrong native type — `field.<x>` + `@dbColumnType` that hides the real type

‎docs/features/codegen-concepts.md‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -282,11 +282,10 @@ Python, `TemplateRoot` in C#; default `prompts/` when it exists, else `templates
282282
`perEntity`/`perPackage`/`perModel` and `format` (when present) one of the
283283
registered escaper formats; a `target` field is **rejected** (the CLI ports have no
284284
output-target concept). The same neutral data dict, output-pattern grammar, and
285-
conformance corpus apply, so a spec renders byte-identically across ports. (Because
286-
a template's output flows through the standard write path — which refuses to
287-
overwrite a file lacking the `@generated` marker — a regenerable template must emit
288-
that header in its own body. The JVM's `TemplateScopeGenerator` writes directly and
289-
carries no such obligation.)
285+
conformance corpus apply, so a spec renders byte-identically across ports. The standard
286+
write path decides from the hash manifest, not the header (section 7), so a template need
287+
not emit the `@generated` marker. The JVM's `TemplateScopeGenerator` writes directly and
288+
keeps no manifest record.)
290289

291290
**The spec is declared, never discovered.** Through 1.0 both CLI ports also read a
292291
`--template-spec` flag or a project-root `template-spec.json` on their own. Since 1.1.0 a spec

‎docs/ports/csharp.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -586,8 +586,9 @@ Each spec entry derives the neutral template data dict for its scope
586586
`--out`, or under its own `OutDir` when it sets one, and are gated byte-identical against the
587587
shared `fixtures/template-codegen-conformance/` corpus. A `target` field is rejected (C# has no
588588
output-target concept); a missing spec file, a bad template ref or a wrong `TemplateRoot`
589-
surfaces as a clean error, not a stack trace. For output to be regenerable, the **template**
590-
must emit the `@generated` header itself (the write path refuses to overwrite files lacking it).
589+
surfaces as a clean error, not a stack trace. The write path decides from the committed hash
590+
manifest, not the `@generated` header, so the template need not emit one (see
591+
[codegen-concepts](../features/codegen-concepts.md#7-safety-never-clobbering-hand-edits)).
591592

592593
## Angular 18 frontend
593594

‎docs/ports/python.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -523,9 +523,9 @@ The named generators run after the target's `generators`, into the same `outDir`
523523
are gated byte-identical against the shared `fixtures/template-codegen-conformance/`
524524
corpus. Output is format-agnostic (text/markdown/csv/json/xml/html), so the template-spec
525525
pass emits no `__init__.py` into its tree. A `target` field inside the spec is rejected (the
526-
spec's target is the one that declares it); for output to be regenerable, the **template**
527-
must emit the `@generated` header itself (the write path refuses to overwrite files lacking
528-
it).
526+
spec's target is the one that declares it). The write path decides from the committed hash
527+
manifest, not the `@generated` header, so the template need not emit one (see
528+
[codegen-concepts](../features/codegen-concepts.md#7-safety-never-clobbering-hand-edits)).
529529

530530
### Universal browser-client hookup (React / Angular 18)
531531

0 commit comments

Comments
 (0)