metaobjects 0.19.4__tar.gz → 0.19.6__tar.gz

{metaobjects-0.19.4 → metaobjects-0.19.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metaobjects
-Version: 0.19.4
+Version: 0.19.6
 Summary: Cross-language metadata standard: declare typed entities once, generate idiomatic drift-checked code across languages — Python port.
 Project-URL: Homepage, https://metaobjects.dev
 Project-URL: Repository, https://github.com/metaobjectsdev/metaobjects
@@ -45,11 +45,13 @@ other language port.
 
 ## Install
 
+Requires **Python 3.11+**.
+
 ```bash
 pip install metaobjects
 ```
 
-Requires Python 3.11+. The only runtime dependency is PyYAML.
+The only runtime dependency is PyYAML.
 
 ## Quick start
 
@@ -77,7 +79,9 @@ The primary public API is the **loader** (`load_directory` / `load_uris` /
 `load_string`, `MetaDataLoader`, `LoadResult`, `ErrorCode`, `MetaError`). The
 distribution also ships the Python implementations of the other pillars used by the CLI
 and tooling: `codegen` (Pydantic + FastAPI emit), `render` (Mustache + payload-VO +
-verify), `runtime` (SQLAlchemy-Core object manager), and `migrate`.
+verify), and `runtime` (a DB-API 2 `ObjectManager` — pg8000 / psycopg — no SQLAlchemy).
+Schema migrations are owned by the TypeScript `meta` CLI (ADR-0015); there is
+**no `migrate` module** in this distribution.
 
 ## Authoring formats
 

{metaobjects-0.19.4 → metaobjects-0.19.6}/README.md

@@ -10,11 +10,13 @@ other language port.
 
 ## Install
 
+Requires **Python 3.11+**.
+
 ```bash
 pip install metaobjects
 ```
 
-Requires Python 3.11+. The only runtime dependency is PyYAML.
+The only runtime dependency is PyYAML.
 
 ## Quick start
 
@@ -42,7 +44,9 @@ The primary public API is the **loader** (`load_directory` / `load_uris` /
 `load_string`, `MetaDataLoader`, `LoadResult`, `ErrorCode`, `MetaError`). The
 distribution also ships the Python implementations of the other pillars used by the CLI
 and tooling: `codegen` (Pydantic + FastAPI emit), `render` (Mustache + payload-VO +
-verify), `runtime` (SQLAlchemy-Core object manager), and `migrate`.
+verify), and `runtime` (a DB-API 2 `ObjectManager` — pg8000 / psycopg — no SQLAlchemy).
+Schema migrations are owned by the TypeScript `meta` CLI (ADR-0015); there is
+**no `migrate` module** in this distribution.
 
 ## Authoring formats
 

{metaobjects-0.19.4 → metaobjects-0.19.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "metaobjects"
-version = "0.19.4"
+version = "0.19.6"
 description = "Cross-language metadata standard: declare typed entities once, generate idiomatic drift-checked code across languages — Python port."
 readme = "README.md"
 requires-python = ">=3.11"

{metaobjects-0.19.4 → metaobjects-0.19.6}/src/metaobjects/loader/validation_passes.py

@@ -110,6 +110,7 @@ from ..meta.core.relationship.relationship_constants import (
 from ..meta.core.identity.identity_constants import (
     IDENTITY_SUBTYPE_REFERENCE,
     IDENTITY_REFERENCE_ATTR_REFERENCES,
+    IDENTITY_REFERENCE_ATTR_ENFORCE,
 )
 from ..shared.separators import PACKAGE_SEP
 from ..meta.core.object.object_constants import (
@@ -2290,6 +2291,20 @@ def _validate_relationships(root: MetaData, errors: list[MetaError]) -> None:
                     ),
                 ))
                 continue
+            # A junction is a physical join table — it MUST be an object.entity.
+            # ADR-0046 lets a value carry navigation-only references, so value-purity
+            # no longer implicitly guarantees a two-reference junction is an entity;
+            # assert it here. (A value/projection has no table to join through.)
+            if junction.sub_type != OBJECT_SUBTYPE_ENTITY:
+                errors.append(MetaError(
+                    f'relationship "{obj.name}.{rel.name}" '
+                    f'@{RELATIONSHIP_ATTR_THROUGH} "{through}" resolves to '
+                    f"{junction.type}.{junction.sub_type}, not an entity — a junction is a "
+                    f"persisted join table and must be object.entity.",
+                    ErrorCode.ERR_INVALID_RELATIONSHIP,
+                    envelope=rel.source,
+                ))
+                continue
             ref_count = _count_junction_references(junction)
             if ref_count != 2:
                 errors.append(MetaError(
@@ -2619,12 +2634,31 @@ def _validate_max_occurs(
                 )
 
 
-# FR-024 value purity (ADR-0028): a value object is a pure data shape — it
-# carries NO identity of any subtype and NO source. Mirrors TS subtype-rules.ts
-# validateValuePurity (effective children; envelope = the offending child).
+# FR-024 value purity (ADR-0028): a value object owns NO identity and NO source.
+# ADR-0046 admits ONE exception: a navigation-only identity.reference with explicit
+# @enforce: false — an outbound pointer to an entity (a DTO/message referencing X by
+# id) is not persistence. Its target still resolves (dangling → ERR_INVALID_REFERENCE
+# via the registry-derived pass) and codegen emits no FK/DDL. The value's OWN identity
+# (primary/secondary) and any enforced reference (a physical FK it has no table to
+# hold) stay banned. Mirrors TS subtype-rules.ts validateValuePurity.
 def _validate_value_purity(node: MetaObject, errors: list[MetaError]) -> None:
     for child in node.children():
         if child.type == TYPE_IDENTITY:
+            if child.sub_type == IDENTITY_SUBTYPE_REFERENCE:
+                # ADR-0046: navigation-only reference is the sanctioned exception.
+                if child.get_meta_attr(IDENTITY_REFERENCE_ATTR_ENFORCE) is False:
+                    continue
+                errors.append(
+                    MetaError(
+                        f"value object '{node.fqn()}' has an enforced reference "
+                        f"({TYPE_IDENTITY}.{child.sub_type} '{child.name}') — a value is not "
+                        f"persisted and has no table to hold a physical FK; declare a "
+                        f"navigation-only reference with @enforce: false (FR-024, ADR-0028, ADR-0046)",
+                        ErrorCode.ERR_SUBTYPE_RULE_VIOLATION,
+                        envelope=child.source,
+                    )
+                )
+                continue
             errors.append(
                 MetaError(
                     f"value object '{node.fqn()}' must not have an identity "

{metaobjects-0.19.4 → metaobjects-0.19.6}/uv.lock

@@ -250,7 +250,7 @@ wheels = [
 
 [[package]]
 name = "metaobjects"
-version = "0.19.1"
+version = "0.19.6"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },