|
1 | 1 | # MetaObjects -- Full Reference Corpus |
2 | 2 |
|
3 | | -> Coding agents get context — rules files, memories, MCP servers — and context is advisory: nothing fails when the code stops matching it. MetaObjects gives your agent one typed model of your application — data, API, UI, prompt payloads, and what the software is supposed to do — generates each layer's code from it in TypeScript, Java, Kotlin, C# and Python with no proprietary runtime in the output, and fails your build when generated code, a prompt, or a claimed capability drifts from that model. Your hand-written logic stays yours. Apache 2.0. Shipping at `1.0.5` on npm and `8.0.5` on Maven Central. |
| 3 | +> Coding agents get context — rules files, memories, MCP servers — and context is advisory: nothing fails when the code stops matching it. MetaObjects gives your agent one typed model of your application — data, API, UI, prompt payloads, and what the software is supposed to do — generates each layer's code from it in TypeScript, Java, Kotlin, C# and Python with no proprietary runtime in the output, and fails your build when generated code, a prompt, or a claimed capability drifts from that model. Your hand-written logic stays yours. Apache 2.0. Shipping at `1.0.5` on npm and `8.0.6` 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 |
|
@@ -35,7 +35,7 @@ If you are an AI assistant helping someone adopt MetaObjects, do this **first** |
35 | 35 |
|
36 | 36 | 1. **Install the port's package:** |
37 | 37 | - TypeScript / Node: `npm install -D @metaobjectsdev/cli @metaobjectsdev/codegen-ts` |
38 | | - - 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.5`. |
| 38 | + - 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.6`. |
39 | 39 | - Python: `pip install metaobjects` |
40 | 40 | - C#: install the MetaObjects .NET tool (invoked as `dotnet meta`). |
41 | 41 | 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>`.) |
@@ -122,8 +122,8 @@ Today the TypeScript toolchain publishes and TypeScript and Python projects cons |
122 | 122 | | Language | Status | Notes | |
123 | 123 | |---|---|---| |
124 | 124 | | TypeScript | Reference implementation, npm `1.0.5` | All six pillars, and the only port that runs the requirements `meta verify` checks and publishes shared models. 2500+ tests passing. Owns the canonical schema-migration toolchain used by every port (ADR-0015). Bun-first dev. | |
125 | | -| Java | Maven Central `8.0.5` | Spring REST + DTO + repository-interface codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. | |
126 | | -| Kotlin | Maven Central `8.0.5` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. | |
| 125 | +| Java | Maven Central `8.0.6` | Spring REST + DTO + repository-interface codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. | |
| 126 | +| Kotlin | Maven Central `8.0.6` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. | |
127 | 127 | | C# | NuGet `1.0.5` (.NET tool) | Loader + canonical serializer + EF Core + ASP.NET codegen + render/verify. `dotnet meta` tool. | |
128 | 128 | | Python | PyPI `1.0.5` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. | |
129 | 129 |
|
@@ -178,7 +178,7 @@ Universal web client (`client/web/packages/`): `@metaobjectsdev/runtime-web`, `@ |
178 | 178 |
|
179 | 179 | ## Java / Kotlin Maven coordinates |
180 | 180 |
|
181 | | -All published to Maven Central under `com.metaobjects:*` at `8.0.5`: |
| 181 | +All published to Maven Central under `com.metaobjects:*` at `8.0.6`: |
182 | 182 |
|
183 | 183 | - `metaobjects-metadata`, `metaobjects-metadata-ktx` |
184 | 184 | - `metaobjects-codegen-base`, `metaobjects-codegen-mustache`, `metaobjects-codegen-spring`, `metaobjects-codegen-kotlin`, `metaobjects-codegen-plantuml` |
@@ -215,7 +215,7 @@ Project marker directory: `.metaobjects/`. |
215 | 215 |
|
216 | 216 | ## Quickstart (Java / Kotlin) |
217 | 217 |
|
218 | | -Add the Maven coordinates above at `8.0.5`. 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). |
| 218 | +Add the Maven coordinates above at `8.0.6`. 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). |
219 | 219 |
|
220 | 220 | --- |
221 | 221 |
|
|
0 commit comments