Skip to content

Commit 1aeccc9

Browse files
dmealingclaude
andcommitted
docs: propagate the 1.0.1 / 8.0.1 coordinates before the tag
The site is BUILT from the release tag: the deploy clones `v<version>`, injects that tree's `site-payload.json` and copies `docs/llms/*` from it. So the version references have to be right in the tagged commit, not after it — `finish-release.mjs` refuses to tag until `docs/llms/llms.txt` names the release, which is what caught this. All four registries moved this time (each had a changed product file), so unlike an npm-only cut every coordinate advances: npm / PyPI / NuGet `1.0.1`, Maven Central `8.0.1`. AGENTS.md was edited by hand rather than swept, because its Status section carries HISTORY a substitution would have falsified — `1.0.0-rc.5` through `rc.8`, and the note that npm's `next` tag was repointed onto the 1.0.0 release. Those describe what happened at the 1.0 cut and must keep saying 1.0.0. Its "Next release move: the 1.0 cut" line was stale in the other direction — that release shipped yesterday — and now records 1.0.1 as the latest, with what it actually contained. (CLAUDE.md is a symlink to AGENTS.md, so it follows.) Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NTcEKXTQMYt84fAjuw5A2M
1 parent c59bb31 commit 1aeccc9

7 files changed

Lines changed: 39 additions & 37 deletions

File tree

AGENTS.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The first four ship per-language today across the five ports (TS / C# / Java / P
1818

1919
## Status
2020

21-
_Last refreshed 2026-09-09._
21+
_Last refreshed 2026-09-10._
2222

2323
**1.0 gating — the quiet period is RETIRED (2026-09-06).** `docs/1.0-readiness.md` §G3 no
2424
longer asks for "one coordinated release with no metamodel-breaking change." It measured a
@@ -35,13 +35,15 @@ because a conformance corpus gates the ports against each other and never agains
3535
in ADR-0035 **Amendment 3**. Do not reintroduce a waiting gate in any form.
3636

3737

38-
**Where the versions are.** `latest` on every registry is **`1.0.0`** (npm / PyPI / NuGet) ·
39-
**`8.0.0`** (Maven Central, aligned `minor.patch` on its historical major `7` — the Maven
40-
major is always **npm major + 7**, so 1.0.0 is 8.0.0). **1.0 is CUT**: the `1.0.0-rc.5`
41-
through `rc.8` candidates are superseded, and npm's `next` tag was REPOINTED onto `1.0.0`
42-
not deleted, because `dist-tag rm` 403s for every token we hold (`docs/RELEASING.md` §4).
43-
`metamodelVersion` reads **`1.0`**, frozen — C4 landed and G4 shipped it. Per-release detail
44-
lives in **`CHANGELOG.md`** — it is the log, and this file does not duplicate it.
38+
**Where the versions are.** `latest` on every registry is **`1.0.1`** (npm / PyPI / NuGet) ·
39+
**`8.0.1`** (Maven Central, aligned `minor.patch` on its historical major `7` — the Maven
40+
major is always **npm major + 7**, so 1.0.1 is 8.0.1). All four moved together at 1.0.1
41+
because all four had a changed product file. **1.0 is CUT**: the `1.0.0-rc.5` through `rc.8`
42+
candidates are superseded, and npm's `next` tag was REPOINTED onto the release — not deleted,
43+
because `dist-tag rm` 403s for every token we hold (`docs/RELEASING.md` §4).
44+
`metamodelVersion` reads **`1.0`**, frozen — C4 landed and G4 shipped it, and 1.0.1 did not
45+
move it. Per-release detail lives in **`CHANGELOG.md`** — it is the log, and this file does
46+
not duplicate it.
4547

4648
The npm surface is **14 `@metaobjectsdev/*` packages in full lockstep**; the two `angular`
4749
packages are on their own `0.6.x` line and are **not published — source-only by decision**
@@ -73,7 +75,7 @@ PyPI has had no product change since `0.25.0` — nothing is broken.
7375

7476
**Key cross-language features shipped:** FR5 family (a/b/c/d/e + WARN envelope-shape — actionable loader errors per ADR-0009); FR-003 (Java RDB runtime persistence + projections; schema migrations are TS-only — the Java migration engine was removed); FR-006 (template.output parser-on-receipt codegen per ADR-0010 in all 5 ports); FR-008 + FR-009 (cross-port REST API contract + the nine filter operators); FR-018 (M:N relationship codegen in all 5 ports — entity navigation + idiomatic ORM wiring [Drizzle m2m / EF Core `UsingEntity` / Spring repo+JPA / Exposed / Pydantic+route as the SQLAlchemy-secondary equivalent] + REST traversal `GET /<source-plural>/{id}/<relation>` + Tier-2 docs, gated by the shared api-contract m2m corpus in both lanes + persistence-conformance; the TanStack M:N client hook is a deferred client-ergonomics follow-up); SP-H (field-subtype end-to-end hardening: every concrete `field.*` subtype write+read round-trips cross-port via the persistence `op: roundtrip` gate; cut `field.byte`/`field.short`/`field.class` non-functional stubs; cross-port filter-op reconciliation for uuid/currency); source v2 paradigm (ADR-0007); metadata-ktx Kotlin facade; per-target output directories (TS codegen).
7577

76-
**Next release move: the 1.0 cut** — npm / PyPI / NuGet to `1.0.0`, Maven Central to `8.0.0`. `docs/1.0-readiness.md` holds the gates and which of them are open.
78+
**Latest release: 1.0.1** (2026-09-10) — npm / PyPI / NuGet `1.0.1`, Maven Central `8.0.1`. It completes 1.0 rather than extending it: `field.map` codegen finished on Java and C#, the nested-value-object validation hole that opened with it (#362) is closed on every write path, and `--prompts` converged the prompt-directory flag across the ports, closing the last open gate (D2) in `docs/1.0-readiness.md`.
7779

7880
See `spec/roadmap.md` for the active + planned work picture.
7981

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -93,11 +93,11 @@ first-week wedge plan — and `meta init` picks up from there.
9393

9494
| Language | Status | Quickstart | Source |
9595
|---|---|---|---|
96-
| TypeScript | **npm `1.0.0`** — the `@metaobjectsdev/*` packages | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) |
97-
| Java | **Maven Central `8.0.0`** (`com.metaobjects:*` — the JVM major is npm major + 7) — loader + OMDB + render + Maven plugin all shipped; full conformance green | [`docs/ports/java.md`](docs/ports/java.md) | [`server/java/`](server/java/) |
98-
| Kotlin | **Maven Central `8.0.0`** — codegen tier on top of Java: 14 generators (entity, Exposed table, relations, repository, payload, output-parser, output-prompt, render-helper, extractor, filter-allowlist, validator, Spring config, storedProc, Spring controller); 24 / 24 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/) |
99-
| C# | **NuGet `1.0.0`** — loader + conformance + EF Core codegen + render engine + `dotnet meta` CLI all shipped | [`docs/ports/csharp.md`](docs/ports/csharp.md) | [`server/csharp/`](server/csharp/) |
100-
| Python | **PyPI `1.0.0`** — loader + conformance + render + entity-model codegen + ObjectManager runtime shipped; schema migrations are TS-owned (ADR-0015) | [`docs/ports/python.md`](docs/ports/python.md) | [`server/python/`](server/python/) |
96+
| TypeScript | **npm `1.0.1`** — the `@metaobjectsdev/*` packages | [`docs/ports/typescript.md`](docs/ports/typescript.md) | [`server/typescript/`](server/typescript/) · [`client/web/`](client/web/) |
97+
| Java | **Maven Central `8.0.1`** (`com.metaobjects:*` — the JVM major is npm major + 7) — loader + OMDB + render + Maven plugin all shipped; full conformance green | [`docs/ports/java.md`](docs/ports/java.md) | [`server/java/`](server/java/) |
98+
| Kotlin | **Maven Central `8.0.1`** — codegen tier on top of Java: 14 generators (entity, Exposed table, relations, repository, payload, output-parser, output-prompt, render-helper, extractor, filter-allowlist, validator, Spring config, storedProc, Spring controller); 24 / 24 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/) |
99+
| C# | **NuGet `1.0.1`** — loader + conformance + EF Core codegen + render engine + `dotnet meta` CLI all shipped | [`docs/ports/csharp.md`](docs/ports/csharp.md) | [`server/csharp/`](server/csharp/) |
100+
| Python | **PyPI `1.0.1`** — loader + conformance + render + entity-model codegen + ObjectManager runtime shipped; schema migrations are TS-owned (ADR-0015) | [`docs/ports/python.md`](docs/ports/python.md) | [`server/python/`](server/python/) |
101101

102102
## Capability matrix
103103

docs/llms/llms-full.txt

Lines changed: 9 additions & 9 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, prompt construction, and capability requirements across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `1.0.0` on npm and `8.0.0` on Maven Central.
3+
> A cross-language metadata standard for declaring typed entity models that drive code generation, runtime metadata access, drift detection, prompt construction, and capability requirements across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `1.0.1` on npm and `8.0.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

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

3333
1. **Install the port's package:**
3434
- TypeScript / Node: `npm install -D @metaobjectsdev/cli @metaobjectsdev/codegen-ts`
35-
- 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 `8.0.0`.
35+
- 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 `8.0.1`.
3636
- Python: `pip install metaobjects`
3737
- C#: install the MetaObjects .NET tool (invoked as `dotnet meta`).
3838
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>`.)
@@ -106,11 +106,11 @@ What MetaObjects does not do is write the assertion. A generated stub is a place
106106

107107
| Language | Status | Notes |
108108
|---|---|---|
109-
| TypeScript | Reference implementation, npm `1.0.0` | All five pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
110-
| Java | Maven Central `8.0.0` | Spring REST + DTO + repository-interface codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
111-
| Kotlin | Maven Central `8.0.0` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
112-
| C# | NuGet `1.0.0` (.NET tool) | Loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. `dotnet meta` tool. |
113-
| Python | PyPI `1.0.0` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. |
109+
| TypeScript | Reference implementation, npm `1.0.1` | All five pillars. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. |
110+
| Java | Maven Central `8.0.1` | Spring REST + DTO + repository-interface codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
111+
| Kotlin | Maven Central `8.0.1` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
112+
| C# | NuGet `1.0.1` (.NET tool) | Loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. `dotnet meta` tool. |
113+
| Python | PyPI `1.0.1` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. |
114114

115115
Conformance fixtures live at [`fixtures/`](https://github.com/metaobjectsdev/metaobjects/tree/main/fixtures). Every port runs the shared corpus byte-identically: metamodel (`conformance/`, 313 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.
116116

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

164164
## Java / Kotlin Maven coordinates
165165

166-
All published to Maven Central under `com.metaobjects:*` at `8.0.0`:
166+
All published to Maven Central under `com.metaobjects:*` at `8.0.1`:
167167

168168
- `metaobjects-metadata`, `metaobjects-metadata-ktx`
169169
- `metaobjects-codegen-base`, `metaobjects-codegen-mustache`, `metaobjects-codegen-spring`, `metaobjects-codegen-kotlin`, `metaobjects-codegen-plantuml`
@@ -200,7 +200,7 @@ Project marker directory: `.metaobjects/`.
200200

201201
## Quickstart (Java / Kotlin)
202202

203-
Add the Maven coordinates above at `8.0.0`. 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).
203+
Add the Maven coordinates above at `8.0.1`. 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).
204204

205205
---
206206

0 commit comments

Comments
 (0)