docs(release): 0.12.3 changelog (+ backfill 0.12.1/0.12.2) + npm version propagation

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LuZWKnWzYGVnESijL7uuky

Author: dmealing

CHANGELOG.md

@@ -7,13 +7,41 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.12.3] — 2026-06-26
+
+_npm `0.12.3` (full lockstep across all 13 `@metaobjectsdev/*` publish candidates)._
+
+### Added
+- **Agent-context: granular codegen control + projection consumption + the runtime→Fastify
+  mount API.** The `metaobjects-codegen` skill now teaches that codegen is à la carte (omit
+  `routesFile()` to generate the data layer + hand-write the routes, mix generated and
+  hand-written, declare an `object.projection` *and consume its generated query*, copy/extend
+  generators); the `metaobjects-runtime-ui` (TypeScript) reference documents the real
+  `@metaobjectsdev/runtime-ts/drizzle-fastify` mount helpers (`mountCrudRoutes({ expose })`,
+  `mount<Verb>Route`, `mountReadOnlyCrudRoutes`) so agents stop reverse-engineering
+  `node_modules` (#78).
+
+## [0.12.2] — 2026-06-25
+
+_npm `0.12.2` (full lockstep across all 13 `@metaobjectsdev/*` publish candidates)._
+
 ### Fixed
 - **Drizzle codegen annotates every FK `.references()` callback with `(): Any{Pg,SQLite}Column`.**
-  Previously only self-referential FKs carried the explicit return type; cross-module
-  circular references (table A → B while B → A) went through the un-annotated branch and
-  failed `tsc --strict` with TS7022 (`implicitly has type 'any' … referenced in its own
-  initializer`). The annotation is Drizzle's documented fix for circular inference and a
-  harmless explicit supertype for acyclic FKs, so `codegen-ts` now emits it unconditionally.
+  Cross-module circular references (table A → B while B → A) went through the un-annotated
+  branch and failed `tsc --strict` with TS7022; `codegen-ts` now emits the explicit return
+  type unconditionally (Drizzle's documented fix for circular inference) (#76).
+
+## [0.12.1] — 2026-06-25
+
+_npm `0.12.1` (full lockstep across all 13 `@metaobjectsdev/*` publish candidates)._
+
+### Added
+- **`meta types` vocabulary search + `whenToUse` decisional guidance.** A new
+  `meta types [query]` command — apropos + `kubectl explain` over the live registry
+  (`--desc`/`--all` description search, `--kind`/`--type` filters, terse/`--detail`/`--json`
+  output) — plus the canonical `whenToUse` "reach for this when…" guidance on the data-modeling
+  constructs in `spec/metamodel/*.json` (flows to all five ports), so an agent finds and uses
+  the right metadata construct instead of hand-writing data logic (#74).
 
 ## [0.12.0] — 2026-06-25
 

CLAUDE.md

@@ -19,7 +19,7 @@ Equal weight — all four ship per-language today across the five ports (TS / C#
 
 _Last refreshed 2026-06-22._
 
-**TypeScript reference implementation** is **published to npm at `0.12.0`** (all 13 `@metaobjectsdev/*` publish candidates on the `latest` tag, full lockstep). C# / Python at `0.11.1` (NuGet / PyPI); Java / Kotlin at `7.4.1` (Maven Central). 2500+ tests passing across the workspace.
+**TypeScript reference implementation** is **published to npm at `0.12.3`** (all 13 `@metaobjectsdev/*` publish candidates on the `latest` tag, full lockstep). C# / Python at `0.11.1` (NuGet / PyPI); Java / Kotlin at `7.4.1` (Maven Central). 2500+ tests passing across the workspace.
 
 **All five ports ship loader + canonical serializer + conformance + codegen + render + payload-VO + `verify`:**
 

README.md

@@ -37,7 +37,7 @@ working code.
 
 | Language | Status | Quickstart | Source |
 |---|---|---|---|
-| TypeScript | Published to npm at `0.12.0` (the `@metaobjectsdev/*` packages) | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) |
+| TypeScript | Published to npm at `0.12.3` (the `@metaobjectsdev/*` packages) | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) |
 | Java | Loader + OMDB + render + Maven plugin all shipped; full conformance green | [`docs/ports/java.md`](docs/ports/java.md) | [`server/java/`](server/java/) |
 | Kotlin | Codegen tier on top of Java — 7 generators (entity, Exposed table, relations, payload, validator, Spring config, storedProc); 12 / 12 persistence-conformance | [`docs/ports/kotlin.md`](docs/ports/kotlin.md) | [`server/java/codegen-kotlin/`](server/java/codegen-kotlin/) · [`server/java/metadata-ktx/`](server/java/metadata-ktx/) |
 | C# | Loader + conformance + EF Core codegen + render engine + `dotnet meta` CLI all shipped | [`docs/ports/csharp.md`](docs/ports/csharp.md) | [`server/csharp/`](server/csharp/) |

docs/llms/llms-full.txt

@@ -1,6 +1,6 @@
 # MetaObjects -- Full Reference Corpus
 
-> A cross-language metadata standard for declaring typed entity models that drive code generation, runtime metadata access, drift detection, and prompt construction across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `0.12.0` on npm and `7.4.1` on Maven Central.
+> A cross-language metadata standard for declaring typed entity models that drive code generation, runtime metadata access, drift detection, and prompt construction across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `0.12.3` on npm and `7.4.1` on Maven Central.
 
 **Note for AI assistants:** This file is the concatenated reference material for MetaObjects, intended to be loaded as LLM context. For the short index, see [llms.txt](https://metaobjects.dev/llms.txt). For the canonical spec and source, see the [GitHub repo](https://github.com/metaobjectsdev/metaobjects). When this file is out of date relative to the GitHub source, the GitHub source wins.
 
@@ -89,7 +89,7 @@ Because the render is conformance-gated, the determinism guarantee holds in ever
 
 | Language | Status | Notes |
 |---|---|---|
-| TypeScript | Reference implementation, npm `0.12.0` | All four pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
+| TypeScript | Reference implementation, npm `0.12.3` | All four pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
 | Java | Maven Central `7.4.1` | Spring REST + JPA codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
 | Kotlin | Maven Central `7.4.1` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
 | C# | npm-line `0.11.1` (NuGet / .NET tool) | Loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. `dotnet meta` tool. |

docs/llms/llms.txt

@@ -1,6 +1,6 @@
 # MetaObjects
 
-> A cross-language metadata standard for declaring typed entity models that drive code generation, runtime metadata access, drift detection, and prompt construction across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `0.12.0` on npm and `7.4.1` on Maven Central.
+> A cross-language metadata standard for declaring typed entity models that drive code generation, runtime metadata access, drift detection, and prompt construction across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `0.12.3` on npm and `7.4.1` on Maven Central.
 
 The metamodel is the durable spine; generated code is the disposable artifact. Substrate is local-first: typed metadata lives in your repo, generated code is idiomatic per-language output that runs without any MetaObjects dependency at runtime. If `@metaobjectsdev/*` (npm) or `com.metaobjects:*` (Maven) disappears tomorrow, you keep working code in every language.
 
@@ -39,9 +39,9 @@ MetaObjects pillars are capabilities of equal weight per implementation, not sep
 - **Drift detection** — catch divergence between generated code and metadata before it ships. `verify` is one verb with explicit subverbs (ADR-0021): `verify --codegen` (regen-and-diff against committed output), `verify --templates` (prompt `{{field}}` ↔ payload-VO drift), and `verify --db` (live-DB schema drift, Node `meta` only). Surfaces drift as build-time breakage rather than a production incident.
 - **Prompt construction** — treat LLM prompts as governed metadata instead of strings scattered across services. A typed payload declared as a projection (so payload bloat and token cost are a diff, not a mystery), external provider-resolved prompt text, and a logic-less Mustache engine that renders deterministically: snapshot-testable in CI, byte-stable so an exact-prefix prompt-cache hit doesn't break on a stray whitespace, and drift-checked at build time so a renamed field can't silently degrade a prompt. Conformance-gated, so the guarantee holds in every language port. Render + payload-VO codegen + `verify` + `template.output` parser-on-receipt (FR-006) + the output-format prompt fragment & tolerant `extract` parser (FR-010/FR-011) ship in all five ports today.
 
-## Implementations (npm `0.12.0` / Maven Central `7.4.1`)
+## Implementations (npm `0.12.3` / Maven Central `7.4.1`)
 
-- [TypeScript](https://github.com/metaobjectsdev/metaobjects/tree/main/server/typescript): the reference implementation. Published to npm at `0.12.0` across 13 `@metaobjectsdev/*` packages on the `latest` tag. 2500+ tests passing across the workspace. Bun-first dev workflow. Owns the canonical schema-migration toolchain used by every port (ADR-0015).
+- [TypeScript](https://github.com/metaobjectsdev/metaobjects/tree/main/server/typescript): the reference implementation. Published to npm at `0.12.3` across 13 `@metaobjectsdev/*` packages on the `latest` tag. 2500+ tests passing across the workspace. Bun-first dev workflow. Owns the canonical schema-migration toolchain used by every port (ADR-0015).
 - [Java](https://github.com/metaobjectsdev/metaobjects/tree/main/server/java): 13 publishable Maven modules under `com.metaobjects:*` at `7.4.1` on Maven Central. Spring REST + JPA codegen, OMDB runtime persistence (pure data-access) with Spring-tx, full FR-003 + FR-006 + FR-010/011 + FR-018 + FR5 family. Fully green across all conformance corpora.
 - [Kotlin](https://github.com/metaobjectsdev/metaobjects/tree/main/server/java/codegen-kotlin): a Kotlin codegen pipeline on KotlinPoet plus `metadata-ktx` — a Kotlin facade over the Java MetaObjects core. Ships via the Java reactor (`metaobjects-metadata-ktx`, `metaobjects-codegen-kotlin`). Persistence-conformance runs against Testcontainers Postgres through Exposed.
 - [C#](https://github.com/metaobjectsdev/metaobjects/tree/main/server/csharp): loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. The `dotnet meta` tool ships `gen` and the codegen-side `verify` subverbs (`--codegen`, `--templates`); schema migration is Node `meta` only (ADR-0015).

docs/ports/typescript.md

@@ -1,6 +1,6 @@
 # TypeScript port
 
-The reference implementation. Published to npm at `0.12.0` as 13
+The reference implementation. Published to npm at `0.12.3` as 13
 `@metaobjectsdev/*` packages on the `latest` tag. Targets Node-compatible
 runtimes; Bun-first dev workflow.