Skip to content

Commit d288c52

Browse files
committed
docs: 0.20.14 / 7.20.14 across the site
Mirrors this release's version propagation: llms.txt and llms-full.txt are byte-copies of the repo's docs/llms/, and index.html's per-port status rows advance to the coordinated 0.20.14 / 7.20.14 line. The llms files also carry two corrections from this cut, independent of the version bump: the conformance corpora counts were understated (~90 fixtures and 20 scenarios, actually 260 and 41), and the `meta migrate` guidance described `--db <url> --slug <name>` as diffing against the live database when that is the offline path — every example now distinguishes the offline, live (--from-db) and replay (apply-pending) forms.
1 parent 01fc399 commit d288c52

3 files changed

Lines changed: 34 additions & 31 deletions

File tree

www/index.html

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -198,28 +198,28 @@ <h2 class="section-label">Five ports. All installable today.</h2>
198198
<tbody>
199199
<tr>
200200
<td><strong>TypeScript</strong></td>
201-
<td><span class="status status-stable">npm 0.20.13 · reference</span></td>
202-
<td>npm <code>@metaobjectsdev/*@0.20.13</code> (the reference implementation). Drizzle + Zod + Fastify + Hono codegen, Kysely runtime, and <code>meta migrate</code> for Postgres / SQLite / Cloudflare D1 — the TS toolchain owns schema migrations. 2,500+ tests across the workspace.</td>
201+
<td><span class="status status-stable">npm 0.20.14 · reference</span></td>
202+
<td>npm <code>@metaobjectsdev/*@0.20.14</code> (the reference implementation). Drizzle + Zod + Fastify + Hono codegen, Kysely runtime, and <code>meta migrate</code> for Postgres / SQLite / Cloudflare D1 — the TS toolchain owns schema migrations. 2,500+ tests across the workspace.</td>
203203
</tr>
204204
<tr>
205205
<td><strong>Java</strong></td>
206-
<td><span class="status status-stable">Maven Central 7.20.13</span></td>
207-
<td><code>com.metaobjects:metaobjects-*:7.20.13</code> on Maven Central. Spring REST + DTO + Repository + filter-allowlist codegen via <code>codegen-spring</code>; OMDB runtime persistence (CRUD / query / typed jsonb / Spring-tx); render + payload + verify + output-parser codegen.</td>
206+
<td><span class="status status-stable">Maven Central 7.20.14</span></td>
207+
<td><code>com.metaobjects:metaobjects-*:7.20.14</code> on Maven Central. Spring REST + DTO + Repository + filter-allowlist codegen via <code>codegen-spring</code>; OMDB runtime persistence (CRUD / query / typed jsonb / Spring-tx); render + payload + verify + output-parser codegen.</td>
208208
</tr>
209209
<tr>
210210
<td><strong>Kotlin</strong></td>
211-
<td><span class="status status-stable">Maven Central 7.20.13</span></td>
212-
<td><code>com.metaobjects:metaobjects-codegen-kotlin:7.20.13</code> + <code>metadata-ktx</code> Kotlin facade. KotlinPoet codegen: Exposed Tables, Spring controllers, payload VOs, output parsers, stored-proc helpers. Persistence-conformance against Testcontainers Postgres.</td>
211+
<td><span class="status status-stable">Maven Central 7.20.14</span></td>
212+
<td><code>com.metaobjects:metaobjects-codegen-kotlin:7.20.14</code> + <code>metadata-ktx</code> Kotlin facade. KotlinPoet codegen: Exposed Tables, Spring controllers, payload VOs, output parsers, stored-proc helpers. Persistence-conformance against Testcontainers Postgres.</td>
213213
</tr>
214214
<tr>
215215
<td><strong>C#.NET</strong></td>
216-
<td><span class="status status-stable">NuGet 0.20.13</span></td>
217-
<td>NuGet <code>MetaObjects</code> / <code>MetaObjects.Render</code> / <code>MetaObjects.Codegen</code> + the <code>dotnet meta</code> tool (<code>MetaObjects.Cli</code>), all <code>0.20.13</code>. EF Core entities + <code>AppDbContext</code> + ASP.NET minimal-API routes codegen; render engine + payload-VO codegen + <code>verify</code>. (Schema migrations are TS-owned.)</td>
216+
<td><span class="status status-stable">NuGet 0.20.14</span></td>
217+
<td>NuGet <code>MetaObjects</code> / <code>MetaObjects.Render</code> / <code>MetaObjects.Codegen</code> + the <code>dotnet meta</code> tool (<code>MetaObjects.Cli</code>), all <code>0.20.14</code>. EF Core entities + <code>AppDbContext</code> + ASP.NET minimal-API routes codegen; render engine + payload-VO codegen + <code>verify</code>. (Schema migrations are TS-owned.)</td>
218218
</tr>
219219
<tr>
220220
<td><strong>Python</strong></td>
221-
<td><span class="status status-stable">PyPI 0.20.13</span></td>
222-
<td>PyPI <code>metaobjects</code> <code>0.20.13</code> + the <code>metaobjects</code> CLI. Loader + canonical serializer + render + verify + codegen (Pydantic + FastAPI) + ObjectManager runtime. All five cross-port conformance corpora green.</td>
221+
<td><span class="status status-stable">PyPI 0.20.14</span></td>
222+
<td>PyPI <code>metaobjects</code> <code>0.20.14</code> + the <code>metaobjects</code> CLI. Loader + canonical serializer + render + verify + codegen (Pydantic + FastAPI) + ObjectManager runtime. All five cross-port conformance corpora green.</td>
223223
</tr>
224224
</tbody>
225225
</table>

www/llms-full.txt

Lines changed: 15 additions & 12 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.20.13` on npm and `7.20.13` 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.20.14` on npm and `7.20.14` 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

@@ -31,7 +31,7 @@ If you are an AI assistant helping someone adopt MetaObjects, do this **first**
3131

3232
1. **Install the port's package:**
3333
- TypeScript / Node: `npm install -D @metaobjectsdev/cli @metaobjectsdev/codegen-ts`
34-
- Java / Kotlin: add `com.metaobjects:metaobjects-metadata`, `com.metaobjects:metaobjects-codegen-spring` (Java) or `com.metaobjects:metaobjects-codegen-kotlin` (Kotlin), and `com.metaobjects:metaobjects-maven-plugin`, all at `7.20.13`.
34+
- Java / Kotlin: add `com.metaobjects:metaobjects-metadata`, `com.metaobjects:metaobjects-codegen-spring` (Java) or `com.metaobjects:metaobjects-codegen-kotlin` (Kotlin), and `com.metaobjects:metaobjects-maven-plugin`, all at `7.20.14`.
3535
- Python: `pip install metaobjects`
3636
- C#: install the MetaObjects .NET tool (invoked as `dotnet meta`).
3737
2. **Run `meta init`** (the Node `meta` CLI). It works in any project that has Node — including a JVM or Python project with a TypeScript frontend. It scaffolds a slim always-on `.metaobjects/AGENTS.md` + `.metaobjects/CLAUDE.md` (auto-wired via an `@.metaobjects/AGENTS.md` import line into the project's root `CLAUDE.md`/`AGENTS.md`, so it loads automatically) plus six `metaobjects-*` Claude Code skills under `.claude/skills/`, carrying only the project's language reference fragments. Re-run `meta init --refresh-docs` to update the agent docs after a CLI upgrade. (The Node `meta` CLI is the single agent-context scaffolder for every backend, by design — ADR-0033; the JVM/Python/C# CLIs deliberately redirect to it. For a non-Node project, scaffold just the agent context with `npx meta agent-docs --server <lang>`.)
@@ -93,13 +93,13 @@ Because the render is conformance-gated, the determinism guarantee holds in ever
9393

9494
| Language | Status | Notes |
9595
|---|---|---|
96-
| TypeScript | Reference implementation, npm `0.20.13` | All four pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
97-
| Java | Maven Central `7.20.13` | Spring REST + JPA codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
98-
| Kotlin | Maven Central `7.20.13` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
99-
| C# | NuGet `0.20.13` (.NET tool) | Loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. `dotnet meta` tool. |
100-
| Python | PyPI `0.20.13` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. |
96+
| TypeScript | Reference implementation, npm `0.20.14` | All four pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
97+
| Java | Maven Central `7.20.14` | Spring REST + JPA codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
98+
| Kotlin | Maven Central `7.20.14` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
99+
| C# | NuGet `0.20.14` (.NET tool) | Loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. `dotnet meta` tool. |
100+
| Python | PyPI `0.20.14` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. |
101101

102-
Conformance fixtures live at [`fixtures/`](https://github.com/metaobjectsdev/metaobjects/tree/main/fixtures). Every port runs the shared corpus byte-identically: metamodel (`conformance/`, ~90 fixtures), render, persistence (Testcontainers Postgres, with an `op: roundtrip` gate so every `field.*` subtype write+read round-trips on every port), api-contract (20 scenarios, two lanes — a reference server AND each port's generated API booted over HTTP), registry (byte-matched metamodel-vocabulary manifest, live + green in all five ports), and yaml/verify.
102+
Conformance fixtures live at [`fixtures/`](https://github.com/metaobjectsdev/metaobjects/tree/main/fixtures). Every port runs the shared corpus byte-identically: metamodel (`conformance/`, 260 fixtures), render, persistence (Testcontainers Postgres, with an `op: roundtrip` gate so every `field.*` subtype write+read round-trips on every port), api-contract (41 scenarios — 26 core plus TPH / M:N / jsonb / write-through — two lanes: a reference server AND each port's generated API booted over HTTP), registry (byte-matched metamodel-vocabulary manifest, live + green in all five ports), and yaml/verify.
103103

104104
---
105105

@@ -150,7 +150,7 @@ Universal web client (`client/web/packages/`): `@metaobjectsdev/runtime-web`, `@
150150

151151
## Java / Kotlin Maven coordinates
152152

153-
All published to Maven Central under `com.metaobjects:*` at `7.20.13`:
153+
All published to Maven Central under `com.metaobjects:*` at `7.20.14`:
154154

155155
- `metaobjects-metadata`, `metaobjects-metadata-ktx`
156156
- `metaobjects-codegen-base`, `metaobjects-codegen-mustache`, `metaobjects-codegen-spring`, `metaobjects-codegen-kotlin`, `metaobjects-codegen-plantuml`
@@ -187,7 +187,7 @@ Project marker directory: `.metaobjects/`.
187187

188188
## Quickstart (Java / Kotlin)
189189

190-
Add the Maven coordinates above at `7.20.13`. Run codegen with `mvn metaobjects:generate` and codegen-drift checks with `mvn metaobjects:verify`. Configure generators (including Kotlin generators, which run through the same goal) on the `metaobjects-maven-plugin`. See [`server/java/`](https://github.com/metaobjectsdev/metaobjects/tree/main/server/java) and [`server/java/codegen-kotlin/README.md`](https://github.com/metaobjectsdev/metaobjects/tree/main/server/java/codegen-kotlin).
190+
Add the Maven coordinates above at `7.20.14`. Run codegen with `mvn metaobjects:generate` and codegen-drift checks with `mvn metaobjects:verify`. Configure generators (including Kotlin generators, which run through the same goal) on the `metaobjects-maven-plugin`. See [`server/java/`](https://github.com/metaobjectsdev/metaobjects/tree/main/server/java) and [`server/java/codegen-kotlin/README.md`](https://github.com/metaobjectsdev/metaobjects/tree/main/server/java/codegen-kotlin).
191191

192192
---
193193

@@ -272,8 +272,11 @@ $ meta verify --codegen # regen-and-diff vs committed output
272272
$ meta verify --templates # prompt {{field}} ↔ payload-VO drift
273273
$ meta verify --db postgres://... # live-DB schema drift (Node meta only)
274274

275-
# Diff metadata vs live DB and emit migration SQL files (Node meta only, used by every port)
276-
$ meta migrate --db file:./dev.db --slug add-subscriber
275+
# Emit migration SQL files (Node meta only, used by every port). --dialect selects the
276+
# diff pipeline, not just the SQL flavor: required offline, auto-detected from --db.
277+
$ meta migrate --from-db --db file:./dev.db --dialect sqlite --slug init --apply # first migration, brand-new DB
278+
$ meta migrate --dialect sqlite --slug add-subscriber # everyday: diff vs the committed snapshot
279+
$ meta migrate --dialect sqlite --slug add-subscriber --db file:./dev.db --apply # ...and apply it
277280

278281
# Flatten loaded metadata to a canonical JSON snapshot
279282
$ meta export --out ./snapshot.json

0 commit comments

Comments
 (0)