|
1 | 1 | # MetaObjects -- Full Reference Corpus |
2 | 2 |
|
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. |
4 | 4 |
|
5 | 5 | **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. |
6 | 6 |
|
@@ -32,7 +32,7 @@ If you are an AI assistant helping someone adopt MetaObjects, do this **first** |
32 | 32 |
|
33 | 33 | 1. **Install the port's package:** |
34 | 34 | - 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`. |
36 | 36 | - Python: `pip install metaobjects` |
37 | 37 | - C#: install the MetaObjects .NET tool (invoked as `dotnet meta`). |
38 | 38 | 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 |
106 | 106 |
|
107 | 107 | | Language | Status | Notes | |
108 | 108 | |---|---|---| |
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. | |
114 | 114 |
|
115 | 115 | 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. |
116 | 116 |
|
@@ -163,7 +163,7 @@ Universal web client (`client/web/packages/`): `@metaobjectsdev/runtime-web`, `@ |
163 | 163 |
|
164 | 164 | ## Java / Kotlin Maven coordinates |
165 | 165 |
|
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`: |
167 | 167 |
|
168 | 168 | - `metaobjects-metadata`, `metaobjects-metadata-ktx` |
169 | 169 | - `metaobjects-codegen-base`, `metaobjects-codegen-mustache`, `metaobjects-codegen-spring`, `metaobjects-codegen-kotlin`, `metaobjects-codegen-plantuml` |
@@ -200,7 +200,7 @@ Project marker directory: `.metaobjects/`. |
200 | 200 |
|
201 | 201 | ## Quickstart (Java / Kotlin) |
202 | 202 |
|
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). |
204 | 204 |
|
205 | 205 | --- |
206 | 206 |
|
|
0 commit comments