chore(release): 0.7.0-rc.12

Twelve TS packages bumped 0.7.0-rc.11 → 0.7.0-rc.12.

Highlights (per CHANGELOG):

Changed
- Three-way merge overwrite policy replacing the rc.11 marker-based clobber-or-
  refuse. Hand-edits in generated files now survive regen via git-merge-file
  against `.metaobjects/.gen-state/` snapshots; conflicts surface as standard
  git-conflict markers. Per spike 002 strategy (b).

Added
- templateGenerator() stock generator — walks MetaRoot, renders shared
  Mustache templates via the existing render engine, emits any format.
- docsFile() refactored to use it (~85 LOC + Mustache template; conformance
  fixture byte-identical).
- EntityDocData public-API contract + docs/features/codegen-data-shapes.md.

Removed
- The marker-based decideAndWrite() path. @generated HTML-comment retained
  as human-readable annotation; no longer load-bearing.

Per the design at metaforge/docs/private/strategy/2026-05-28-template-driven-
codegen-design.md (option 1 chosen — combined policy fix + factory refactor).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dmealing

CHANGELOG.md

@@ -7,6 +7,56 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.7.0-rc.12] — 2026-05-28
+
+### Changed
+- **Three-way merge overwrite policy.** `decideAndWrite()` switched from
+  marker-based (clobber if `@generated` is present, refuse otherwise — the
+  rc.11-era strategy that silently lost hand-edits) to three-way merge
+  against a canonical snapshot stored under `.metaobjects/.gen-state/`.
+  Hand-edits in generated files now survive regen automatically (the spike
+  002 "HARD" case); same-line edits surface as standard git-conflict
+  markers (the "CONFLICT" case). The `@generated` marker becomes
+  informational, no longer load-bearing.
+
+  Restated in adopter terms:
+  - **Easy case** (you add a comment): clean merge integrates it
+  - **Hard case** (you tweak a generated value): your edit survives
+  - **Conflict case** (both sides edit the same line): standard
+    `<<<<<<<` / `|||||||` / `=======` / `>>>>>>>` markers — resolve like
+    any git conflict; rerun `meta gen` to advance the snapshot
+  - **First-time-on-existing-file**: write-if-different baseline (no merge,
+    no clobber). `meta gen --baseline=fresh` opts into "overwrite from
+    fresh and re-baseline"
+
+  Add `.metaobjects/.gen-state/` to your `.gitignore`. `meta init`
+  scaffolding handles this automatically. Integrity is sha-256 hashed at
+  `.gen-state/.hashes.json`; tampered snapshots fall back to first-time
+  semantics with a warning.
+
+### Added
+- **`templateGenerator()` stock generator** — a factory that walks
+  `MetaRoot` → renders shared Mustache templates via the existing
+  `@metaobjectsdev/render` engine → emits files in any format (Markdown /
+  HTML / JSON / YAML / text). Establishes the framework line: **code →
+  hand-coded generators (ts-poet, idiomatic per-port); documents →
+  templateGenerator (shared Mustache templates, port-agnostic)**.
+- **`docsFile()` refactored to use `templateGenerator()`.** Markdown
+  structure now lives in
+  `codegen-ts/templates/docs/entity-page.md.mustache`; adopters can
+  override by placing same-named templates in their project's
+  `templates/` directory. Net: ~85 LOC + a template file replaces ~250
+  LOC of hand-coded string emit. Conformance fixture
+  `docs-file-basic/expected/Author.md` stays byte-identical.
+- **`EntityDocData` exported as a public-API contract.** Template authors
+  consuming the data dict get TypeScript type-checking. Versioning policy
+  spelled out in the new `docs/features/codegen-data-shapes.md`.
+
+### Removed
+- The marker-based `decideAndWrite()` path. The `<!-- @generated -->`
+  HTML-comment marker that rc.11 added to docsFile output is retained as
+  human-readable annotation, but the policy no longer checks for it.
+
 ## [0.7.0-rc.11] — 2026-05-28
 
 ### Fixed

bun.lock

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/react",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "React runtime for metaobjects: useEntityForm hook and CurrencyInput component.",
   "type": "module",
   "main": "./dist/index.js",

client/web/packages/react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/runtime-web",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "Pure framework-agnostic browser core for metaobjects: currency, filter URL serialization, fetcher contract types.",
   "type": "module",
   "main": "./dist/index.js",

client/web/packages/runtime-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/tanstack",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "TanStack runtime for metaobjects: EntityFetcherProvider, EntityGrid, default cell renderers.",
   "type": "module",
   "main": "./dist/index.js",

client/web/packages/tanstack/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/cli",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "CLI for MetaObjects: scaffold, codegen, migrate, and drift-detection commands.",
   "type": "module",
   "main": "./dist/src/index.js",

server/typescript/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/codegen-ts-react",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "React codegen for metaobjects — emits <Entity>.form.tsx files using react-hook-form and @metaobjectsdev/react helpers.",
   "type": "module",
   "main": "./dist/index.js",

server/typescript/packages/codegen-ts-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/codegen-ts-tanstack",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "TanStack codegen for metaobjects — emits hooks and column definitions for TanStack Query and Table.",
   "type": "module",
   "main": "./dist/index.js",

server/typescript/packages/codegen-ts-tanstack/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/codegen-ts",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "TypeScript codegen engine for MetaObjects — emits Drizzle, Zod, and Fastify artifacts.",
   "type": "module",
   "main": "./dist/index.js",

server/typescript/packages/codegen-ts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/metadata",
-  "version": "0.7.0-rc.11",
+  "version": "0.7.0-rc.12",
   "description": "Metamodel loader, types, and constants for the MetaObjects standard.",
   "type": "module",
   "main": "./dist/index.js",