Skip to content

Commit 62ed9cf

Browse files
dmealingclaude
andcommitted
docs(release): propagate npm 0.12.0 + changelog
Bump npm version references 0.11.6 -> 0.12.0 across README, CLAUDE.md status, docs/llms/*, and docs/ports/typescript.md (npm-only; NuGet/PyPI 0.11.1 and Maven 7.4.1 are separate release lines, untouched). Add the 0.12.0 CHANGELOG entry. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LuZWKnWzYGVnESijL7uuky
1 parent 267fc61 commit 62ed9cf

6 files changed

Lines changed: 28 additions & 8 deletions

File tree

CHANGELOG.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,26 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
77

88
## [Unreleased]
99

10+
## [0.12.0] — 2026-06-25
11+
12+
_npm `0.12.0` (full lockstep across all 13 `@metaobjectsdev/*` publish candidates)._
13+
14+
### Added
15+
- **Agent-friendly `meta` CLI.** A `--format` flag with TOON output (a compact,
16+
machine-readable format that becomes the default when stdout is piped to an
17+
agent/CI), structured errors and next-step hints emitted on stdout, package-manager
18+
detection, and deploy-all agent-context reference fragments (#71).
19+
20+
### Fixed
21+
- **`meta init` agent-context scaffold no longer guesses the migration binding.**
22+
The injected `AGENTS.md`/`CLAUDE.md` now name the database schema **and migrations**
23+
as metadata-derived in the "never hand-write" principle ("change the metadata and
24+
regenerate, never hand-write SQL"), and the stack line dropped the guessed
25+
"migrations are TS" clause. This prevents an AI agent from hand-writing a raw
26+
`ALTER TABLE` against a generated schema and silently reintroducing the drift
27+
`meta verify` exists to catch. The verify skill's JVM startup-validator note was
28+
also hedged to an opt-in (#1, #73).
29+
1030
## [0.11.6] — 2026-06-24
1131

1232
_npm `0.11.6` (full lockstep across all 13 `@metaobjectsdev/*` publish candidates)._

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Equal weight — all four ship per-language today across the five ports (TS / C#
1919

2020
_Last refreshed 2026-06-22._
2121

22-
**TypeScript reference implementation** is **published to npm at `0.11.6`** (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.
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.
2323

2424
**All five ports ship loader + canonical serializer + conformance + codegen + render + payload-VO + `verify`:**
2525

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ working code.
3737

3838
| Language | Status | Quickstart | Source |
3939
|---|---|---|---|
40-
| TypeScript | Published to npm at `0.11.6` (the `@metaobjectsdev/*` packages) | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) |
40+
| 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/) |
4141
| Java | Loader + OMDB + render + Maven plugin all shipped; full conformance green | [`docs/ports/java.md`](docs/ports/java.md) | [`server/java/`](server/java/) |
4242
| 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/) |
4343
| 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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# MetaObjects -- Full Reference Corpus
22

3-
> 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.11.6` on npm and `7.4.1` on Maven Central.
3+
> 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.
44

55
**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.
66

@@ -89,7 +89,7 @@ Because the render is conformance-gated, the determinism guarantee holds in ever
8989

9090
| Language | Status | Notes |
9191
|---|---|---|
92-
| TypeScript | Reference implementation, npm `0.11.6` | All four pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
92+
| 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. |
9393
| 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. |
9494
| Kotlin | Maven Central `7.4.1` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
9595
| 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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# MetaObjects
22

3-
> 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.11.6` on npm and `7.4.1` on Maven Central.
3+
> 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.
44

55
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.
66

@@ -39,9 +39,9 @@ MetaObjects pillars are capabilities of equal weight per implementation, not sep
3939
- **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.
4040
- **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.
4141

42-
## Implementations (npm `0.11.6` / Maven Central `7.4.1`)
42+
## Implementations (npm `0.12.0` / Maven Central `7.4.1`)
4343

44-
- [TypeScript](https://github.com/metaobjectsdev/metaobjects/tree/main/server/typescript): the reference implementation. Published to npm at `0.11.6` 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).
44+
- [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).
4545
- [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.
4646
- [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.
4747
- [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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# TypeScript port
22

3-
The reference implementation. Published to npm at `0.11.6` as 13
3+
The reference implementation. Published to npm at `0.12.0` as 13
44
`@metaobjectsdev/*` packages on the `latest` tag. Targets Node-compatible
55
runtimes; Bun-first dev workflow.
66

0 commit comments

Comments
 (0)