You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: 0.22.0 / 7.22.0 across the site, and the requirement.* capability
Mirrors metaobjects docs/llms/*. All four registries move together at the shared
minor.patch: npm / PyPI / NuGet 0.22.0, Maven Central 7.22.0.
Adds the capability-requirements entry (requirement.functional /
requirement.architectural) to the LLM-facing files -- registered vocabulary in
all five ports, with the meta verify gate on the Node CLI.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: www/llms-full.txt
+12-9Lines changed: 12 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
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, and prompt construction across TypeScript, Java, Kotlin, C#, and Python. Apache 2.0. Shipping at `0.21.6` on npm and `7.21.6` 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.22.0` on npm and `7.22.0` 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
@@ -31,7 +31,7 @@ If you are an AI assistant helping someone adopt MetaObjects, do this **first**
- 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.21.6`.
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.22.0`.
35
35
- Python: `pip install metaobjects`
36
36
- C#: install the MetaObjects .NET tool (invoked as `dotnet meta`).
37
37
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,11 +93,11 @@ Because the render is conformance-gated, the determinism guarantee holds in ever
93
93
94
94
| Language | Status | Notes |
95
95
|---|---|---|
96
-
| TypeScript | Reference implementation, npm `0.21.6` | 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.21.6` | Spring REST + DTO + repository-interface codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
98
-
| Kotlin | Maven Central `7.21.6` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
| Python | PyPI `0.21.6` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. |
96
+
| TypeScript | Reference implementation, npm `0.22.0` | 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.22.0` | Spring REST + DTO + repository-interface codegen, OMDB runtime persistence (pure data-access) with Spring-tx. Fully green across all conformance corpora. |
98
+
| Kotlin | Maven Central `7.22.0` | KotlinPoet codegen + Exposed runtime + `metadata-ktx` facade. Ships via the Java reactor. |
| Python | PyPI `0.22.0` | Loader + serializer + render + verify + codegen + `ObjectManager` runtime. Fully green across all corpora. |
101
101
102
102
Conformance fixtures live at [`fixtures/`](https://github.com/metaobjectsdev/metaobjects/tree/main/fixtures). Every port runs the shared corpus byte-identically: metamodel (`conformance/`, 270 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.
103
103
@@ -150,7 +150,7 @@ Universal web client (`client/web/packages/`): `@metaobjectsdev/runtime-web`, `@
150
150
151
151
## Java / Kotlin Maven coordinates
152
152
153
-
All published to Maven Central under `com.metaobjects:*` at `7.21.6`:
153
+
All published to Maven Central under `com.metaobjects:*` at `7.22.0`:
Add the Maven coordinates above at `7.21.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).
190
+
Add the Maven coordinates above at `7.22.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).
191
191
192
192
---
193
193
@@ -271,6 +271,7 @@ $ meta gen Subscriber Order --dry-run
271
271
$ meta verify --codegen # regen-and-diff vs committed output
272
272
$ meta verify --templates # prompt {{field}} ↔ payload-VO drift
273
273
$ meta verify --db postgres://... # live-DB schema drift (Node meta only)
274
+
# Any requirement.* nodes are checked on EVERY meta verify -- no subverb.
274
275
275
276
# Emit migration SQL files (Node meta only, used by every port). --dialect selects the
276
277
# diff pipeline, not just the SQL flavor: required offline, auto-detected from --db.
Capability requirements (`requirement.functional` / `requirement.architectural`) are registered vocabulary in all five ports: what the system is supposed to do, declared in `metaobjects/` beside the entities it describes and loaded by the same loader -- no side file, no bespoke parser. `functional` fails when NOTHING implements it (existence); `architectural` fails when something VIOLATES it (universality). Hierarchy is nesting, `@status` is a loader-enforced closed enum (`live | partial | abandoned | superseded`), and a dangling `@implementedBy` is an ERROR on `live`/`partial` but CORRECT on `abandoned`/`superseded` -- those nodes are supposed to be gone, which is the point of recording them. `@verifiedBy` checks each named test exists and is not skipped; it never runs them. Object coverage is a WARNING, never a failure. Entirely opt-in -- a model with no `requirement.*` nodes produces no diagnostics, and no codegen, migrate or runtime path reads the type. The `meta verify` gate is the Node CLI; the other ports load and validate. See docs/features/requirements.md.
287
+
285
288
Non-TS ports run codegen + codegen-verify in their own build tool: `mvn metaobjects:generate` / `mvn metaobjects:verify` (Java/Kotlin), `dotnet meta gen` / `dotnet meta verify` (C#), `metaobjects gen` / `metaobjects verify` (Python). Schema migration is always the Node `meta` CLI.
0 commit comments