inputlayer-client-dev 0.1.0.dev915__py3-none-any.whl → 0.1.0.dev921__py3-none-any.whl

inputlayer/__init__.py

@@ -68,8 +68,6 @@ from inputlayer.knowledge_graph import (
     WhyResult,
 )
 
-# Migrations
-from inputlayer.migrations import Migration
 
 # Notifications
 from inputlayer.notifications import NotificationEvent
@@ -116,8 +114,6 @@ __all__ = [
     "KnowledgeGraph",
     "KnowledgeGraphExistsError",
     "KnowledgeGraphNotFoundError",
-    # Migrations
-    "Migration",
     # Notifications
     "NotificationEvent",
     "PermissionError",

inputlayer/compiler.py

@@ -666,6 +666,17 @@ def compile_rule(
         else:
             head_parts.append(column_to_variable(col))
 
+    # Compile filter conditions BEFORE building body atoms, so every column
+    # the condition references is registered in the env and gets bound to a
+    # variable in its atom. Compiling them after produced atoms with `_` for
+    # condition-only columns while the condition referenced an unbound
+    # variable - which the engine accepts and silently satisfies, deriving
+    # wrong results (e.g. a tier == "gold" filter matching every row).
+    cond_parts: list[str] = []
+    if condition:
+        cond_parts = compile_bool_expr(condition, env)
+        cond_parts = [p for p in cond_parts if p]
+
     # Build body atoms
     body_atoms: list[str] = []
     for rn, cls, alias in body_relations:
@@ -680,12 +691,6 @@ def compile_rule(
                 atom_parts.append("_")
         body_atoms.append(f"{rn}({', '.join(atom_parts)})")
 
-    # Compile filter conditions
-    cond_parts: list[str] = []
-    if condition:
-        cond_parts = compile_bool_expr(condition, env)
-        cond_parts = [p for p in cond_parts if p]
-
     all_body = body_atoms + cond_parts
     prefix = "+" if persistent else ""
     head_str = f"{prefix}{head_name}({', '.join(head_parts)})"

inputlayer/migrations/__init__.py

@@ -2,8 +2,6 @@
 
 from __future__ import annotations
 
-from typing import Any
-
 from inputlayer.migrations.operations import (
     CreateIndex,
     CreateRelation,
@@ -19,22 +17,6 @@ from inputlayer.migrations.operations import (
 from inputlayer.migrations.state import ModelState
 
 
-class Migration:
-    """Base class for migration files.
-
-    Subclass as ``M`` in each migration file::
-
-        class M(Migration):
-            dependencies = ["0001_initial"]
-            operations = [ops.CreateRelation(...)]
-            state = {"relations": {...}, "rules": {...}, "indexes": {}}
-    """
-
-    dependencies: list[str] = []  # noqa: RUF012
-    operations: list[Operation] = []  # noqa: RUF012
-    state: dict[str, Any] = {}  # noqa: RUF012
-
-
 __all__ = [
     "CreateIndex",
     "CreateRelation",
@@ -42,7 +24,6 @@ __all__ = [
     "DropIndex",
     "DropRelation",
     "DropRule",
-    "Migration",
     "ModelState",
     "Operation",
     "ReplaceRule",

inputlayer/migrations/cli.py

@@ -205,6 +205,20 @@ def _add_connection_args(parser: argparse.ArgumentParser) -> None:
     )
 
 
+def _add_migrations_dir(sub: argparse.ArgumentParser) -> None:
+    """Accept --migrations-dir after the subcommand as well as before it.
+
+    Delegating callers (the `il` CLI) always place flags after the
+    subcommand. SUPPRESS keeps the subparser from clobbering the value the
+    global flag already parsed.
+    """
+    sub.add_argument(
+        "--migrations-dir",
+        default=argparse.SUPPRESS,
+        help="Directory for migration files (default: ./migrations)",
+    )
+
+
 def build_parser() -> argparse.ArgumentParser:
     """Build the CLI argument parser."""
     parser = argparse.ArgumentParser(
@@ -226,22 +240,26 @@ def build_parser() -> argparse.ArgumentParser:
         help="Python module path containing models (e.g. myapp.models)",
     )
     make.add_argument("--name", default=None, help="Custom migration name suffix")
+    _add_migrations_dir(make)
     make.set_defaults(func=_cmd_makemigrations)
 
     # migrate
     mig = subparsers.add_parser("migrate", help="Apply pending migrations")
     _add_connection_args(mig)
+    _add_migrations_dir(mig)
     mig.set_defaults(func=_cmd_migrate)
 
     # revert
     rev = subparsers.add_parser("revert", help="Revert migrations to a target")
     _add_connection_args(rev)
+    _add_migrations_dir(rev)
     rev.add_argument("target", help="Migration name to revert to (e.g. 0001_initial)")
     rev.set_defaults(func=_cmd_revert)
 
     # showmigrations
     show = subparsers.add_parser("showmigrations", help="Show migration status")
     _add_connection_args(show)
+    _add_migrations_dir(show)
     show.set_defaults(func=_cmd_showmigrations)
 
     return parser
@@ -249,6 +267,9 @@ def build_parser() -> argparse.ArgumentParser:
 
 def main(argv: list[str] | None = None) -> int:
     """CLI entry point."""
+    from inputlayer.exceptions import InputLayerError
+    from inputlayer.migrations.errors import MigrationError
+
     parser = build_parser()
     args = parser.parse_args(argv)
 
@@ -256,7 +277,11 @@ def main(argv: list[str] | None = None) -> int:
         parser.print_help()
         return 1
 
-    return args.func(args)
+    try:
+        return args.func(args)
+    except (MigrationError, InputLayerError) as exc:
+        print(f"error: {exc}")
+        return 1
 
 
 if __name__ == "__main__":

inputlayer/migrations/errors.py

@@ -0,0 +1,27 @@
+"""Migration errors and the engine-result check.
+
+The WebSocket protocol reports engine failures as a result-set with a
+single "error" column rather than an exception, so anything that must
+know whether a statement actually executed has to check for that shape
+explicitly. The migration stack must: silently swallowed errors are how
+the recorder shipped broken (write-only applied-state) in the first
+place.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class MigrationError(Exception):
+    """Raised when a migration fails to load, apply, or revert."""
+
+
+def check_engine_result(result: Any, context: str) -> Any:
+    """Raise MigrationError if an execute() result is an engine error frame."""
+    columns = list(getattr(result, "columns", None) or [])
+    if columns == ["error"]:
+        rows = getattr(result, "rows", None) or []
+        detail = str(rows[0][0]) if rows and rows[0] else "unknown engine error"
+        raise MigrationError(f"engine error while {context}: {detail}")
+    return result

inputlayer/migrations/executor.py

@@ -2,26 +2,35 @@
 
 from __future__ import annotations
 
+from inputlayer.migrations.errors import MigrationError, check_engine_result
 from inputlayer.migrations.loader import MigrationInfo
 from inputlayer.migrations.recorder import KGExecutor, MigrationRecorder
 
-
-class MigrationError(Exception):
-    """Raised when a migration fails to apply or revert."""
+__all__ = ["MigrationError", "apply_migration", "migrate", "revert_migration", "revert_to"]
 
 
 def apply_migration(kg: KGExecutor, migration: MigrationInfo) -> None:
-    """Apply a single migration's forward operations."""
+    """Apply a single migration's forward operations.
+
+    Raises MigrationError on the first failing operation. Operations are
+    not transactional: earlier operations of this migration stay applied,
+    but the migration is NOT recorded as applied, so the failure is
+    visible and a re-run picks up where the schema actually is.
+    """
     for op in migration.operations:
         for cmd in op.forward_commands():
-            kg.execute(cmd)
+            check_engine_result(
+                kg.execute(cmd), f"applying {migration.name} ({op.describe()})"
+            )
 
 
 def revert_migration(kg: KGExecutor, migration: MigrationInfo) -> None:
     """Revert a single migration's operations in reverse order."""
     for op in reversed(migration.operations):
         for cmd in op.backward_commands():
-            kg.execute(cmd)
+            check_engine_result(
+                kg.execute(cmd), f"reverting {migration.name} ({op.describe()})"
+            )
 
 
 def migrate(

inputlayer/migrations/loader.py

@@ -1,14 +1,13 @@
-"""Migration loader - discover and import migration files from a directory."""
+"""Migration loader - discover and load JSON migration files from a directory."""
 
 from __future__ import annotations
 
-import importlib.util
 import re
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
 
-from inputlayer.migrations import Migration
+from inputlayer.migrations.errors import MigrationError
 
 
 @dataclass
@@ -27,13 +26,56 @@ class MigrationInfo:
         return self.name
 
 
-_MIGRATION_RE = re.compile(r"^(\d{4})_.+\.py$")
+_MIGRATION_RE = re.compile(r"^(\d{4})_.+\.json$")
+
+
+def _load_json_migration(entry: Path, name: str, number: int) -> MigrationInfo:
+    """Load a language-neutral JSON migration (the current format)."""
+    import json
+
+    from inputlayer.migrations.operations import operation_from_dict
+    from inputlayer.migrations.writer import MIGRATION_FORMAT
+
+    try:
+        document = json.loads(entry.read_text(encoding="utf-8"))
+    except json.JSONDecodeError as exc:
+        raise MigrationError(f"{entry.name}: invalid JSON: {exc}") from exc
+    if not isinstance(document, dict):
+        raise MigrationError(f"{entry.name}: migration document must be a JSON object")
+    fmt = document.get("format")
+    if not isinstance(fmt, int) or fmt > MIGRATION_FORMAT:
+        raise MigrationError(
+            f"{entry.name}: unsupported migration format {fmt!r} "
+            f"(this SDK reads up to {MIGRATION_FORMAT} - upgrade the SDK)"
+        )
+    state = dict(document.get("state", {}))
+    # JSON has no tuples; restore (col, type) pairs so state comparisons in
+    # the autodetector see no phantom changes against in-memory model state.
+    if "relations" in state:
+        state["relations"] = {
+            rel: [tuple(col) for col in cols] for rel, cols in state["relations"].items()
+        }
+    try:
+        operations = [operation_from_dict(d) for d in document.get("operations", [])]
+    except (KeyError, TypeError, ValueError) as exc:
+        raise MigrationError(f"{entry.name}: invalid operation: {exc}") from exc
+    return MigrationInfo(
+        name=name,
+        number=number,
+        filename=entry.name,
+        dependencies=list(document.get("dependencies", [])),
+        operations=operations,
+        state=state,
+    )
 
 
 def load_migrations(directory: str | Path) -> list[MigrationInfo]:
     """Discover and load all migration files from a directory.
 
-    Returns migrations sorted by number.
+    Migrations are language-neutral JSON documents; that is the only
+    format (pre-1.0, no legacy loading). Non-matching files - including
+    stray .py files from older SDKs - are ignored. Returns migrations
+    sorted by number.
     """
     directory = Path(directory)
     if not directory.is_dir():
@@ -50,28 +92,31 @@ def load_migrations(directory: str | Path) -> list[MigrationInfo]:
         number = int(match.group(1))
         name = entry.stem  # e.g. "0001_initial"
 
-        # Import the module dynamically
-        spec = importlib.util.spec_from_file_location(f"migrations.{name}", entry)
-        if spec is None or spec.loader is None:
-            continue
-        module = importlib.util.module_from_spec(spec)
-        spec.loader.exec_module(module)
-
-        # Extract the M class
-        m_cls = getattr(module, "M", None)
-        if m_cls is None or not (isinstance(m_cls, type) and issubclass(m_cls, Migration)):
-            continue
-
-        migrations.append(MigrationInfo(
-            name=name,
-            number=number,
-            filename=entry.name,
-            dependencies=list(getattr(m_cls, "dependencies", [])),
-            operations=list(getattr(m_cls, "operations", [])),
-            state=dict(getattr(m_cls, "state", {})),
-        ))
-
-    return sorted(migrations, key=lambda m: m.number)
+        migrations.append(_load_json_migration(entry, name, number))
+
+    migrations.sort(key=lambda m: m.number)
+
+    # Duplicate names or numbers are always a mistake (a stale legacy .py
+    # twin of a regenerated .json, or a merge collision) and previously
+    # caused the same migration to be applied twice - destructively for
+    # Drop/Replace operations. Refuse loudly.
+    by_name: dict[str, str] = {}
+    by_number: dict[int, str] = {}
+    for m in migrations:
+        if m.name in by_name:
+            raise MigrationError(
+                f"duplicate migration name '{m.name}': {by_name[m.name]} and "
+                f"{m.filename} - delete the stale one"
+            )
+        if m.number in by_number:
+            raise MigrationError(
+                f"duplicate migration number {m.number:04d}: "
+                f"{by_number[m.number]} and {m.filename} - renumber one of them"
+            )
+        by_name[m.name] = m.filename
+        by_number[m.number] = m.filename
+
+    return migrations
 
 
 def get_latest_state(directory: str | Path) -> dict[str, Any]:

inputlayer/migrations/recorder.py

@@ -3,7 +3,9 @@
 from __future__ import annotations
 
 from datetime import datetime, timezone
-from typing import Protocol
+from typing import Any, Protocol
+
+from inputlayer.migrations.errors import check_engine_result
 
 
 class KGExecutor(Protocol):
@@ -12,7 +14,11 @@ class KGExecutor(Protocol):
     def execute(self, iql: str) -> object: ...
 
 
-MIGRATION_RELATION = "__inputlayer_migrations__"
+# NOTE: must be a valid relation name (lowercase letter first). The previous
+# dunder name was rejected by schema declarations but silently auto-created
+# by inserts, leaving recorded state in a relation that queries could not
+# read - migration status/revert never worked against a real engine.
+MIGRATION_RELATION = "inputlayer_migrations"
 
 
 class MigrationRecorder:
@@ -21,24 +27,57 @@ class MigrationRecorder:
     def __init__(self, kg: KGExecutor) -> None:
         self._kg = kg
 
+    def _execute(self, iql: str, context: str) -> Any:
+        return check_engine_result(self._kg.execute(iql), context)
+
     def ensure_schema(self) -> None:
         """Create the migration tracking relation if it doesn't exist."""
-        self._kg.execute(f"+{MIGRATION_RELATION}(name: string, applied_at: string)")
+        # The engine reports "already registered" as an error frame; that is
+        # the one expected, harmless outcome, so only genuinely new failures
+        # surface. Anything else (bad name, auth, parse) must not be
+        # swallowed - that is how the recorder shipped write-only once.
+        result = self._kg.execute(
+            f"+{MIGRATION_RELATION}(name: string, applied_at: string)"
+        )
+        columns = list(getattr(result, "columns", None) or [])
+        if columns == ["error"]:
+            rows = getattr(result, "rows", None) or []
+            detail = str(rows[0][0]) if rows and rows[0] else ""
+            if "exist" not in detail and "registered" not in detail:
+                check_engine_result(result, "creating the migration tracking relation")
 
     def get_applied(self) -> list[str]:
-        """Return sorted list of applied migration names."""
-        result = self._kg.execute(f"?Name, At <- {MIGRATION_RELATION}(Name, At)")
+        """Return sorted list of applied migration names.
+
+        Plain query form: the engine rejects `?X <- rel(...)` projections
+        ("Query cannot contain a rule definition"), which previously made
+        this return [] forever and broke status/revert/idempotent apply.
+        """
+        result = self._execute(
+            f"?{MIGRATION_RELATION}(Name, At)", "reading applied migrations"
+        )
         rows = getattr(result, "rows", []) or []
-        return sorted(str(row[0]) for row in rows)
+        return sorted({str(row[0]) for row in rows})
 
     def record_applied(self, name: str) -> None:
         """Record that a migration has been applied."""
         now = datetime.now(timezone.utc).isoformat()
-        self._kg.execute(f'+{MIGRATION_RELATION}("{name}", "{now}")')
+        safe = _escape(name)
+        self._execute(
+            f'+{MIGRATION_RELATION}[("{safe}", "{now}")]',
+            f"recording {name} as applied",
+        )
 
     def record_reverted(self, name: str) -> None:
         """Remove the record for a reverted migration."""
-        self._kg.execute(
+        safe = _escape(name)
+        self._execute(
             f'-{MIGRATION_RELATION}(Name, At) <- '
-            f'{MIGRATION_RELATION}(Name, At), Name = "{name}"'
+            f'{MIGRATION_RELATION}(Name, At), Name = "{safe}"',
+            f"recording {name} as reverted",
         )
+
+
+def _escape(value: str) -> str:
+    """Escape a string for interpolation into an IQL string literal."""
+    return value.replace("\\", "\\\\").replace('"', '\\"')

inputlayer/migrations/writer.py

@@ -1,154 +1,21 @@
-"""Migration file writer - generates Python source for migration files."""
+"""Migration file writer - generates language-neutral JSON migration files.
+
+A migration is data, not code: typed operations (each with enough
+structure to derive both apply and revert IQL) plus a state snapshot.
+Any SDK language - and the il CLI natively - can read and apply them.
+JSON is the only migration format.
+"""
 
 from __future__ import annotations
 
+import json
+import re
 from typing import Any
 
-from inputlayer.migrations.operations import (
-    CreateIndex,
-    CreateRelation,
-    CreateRule,
-    DropIndex,
-    DropRelation,
-    DropRule,
-    Operation,
-    ReplaceRule,
-    RunIQL,
-)
-
-
-def _repr_str_list(items: list[str], indent: str = "            ") -> str:
-    """Render a list of strings as a formatted Python list."""
-    if not items:
-        return "[]"
-    if len(items) == 1:
-        return f"[{items[0]!r}]"
-    lines = [f"{indent}{item!r}," for item in items]
-    return "[\n" + "\n".join(lines) + f"\n{indent[:-4]}]"
-
+from inputlayer.migrations.errors import MigrationError
+from inputlayer.migrations.operations import Operation
 
-def _repr_columns(cols: list[tuple[str, str]], indent: str = "            ") -> str:
-    """Render column list as Python source."""
-    if not cols:
-        return "[]"
-    lines = [f'{indent}("{c}", "{t}"),' for c, t in cols]
-    return "[\n" + "\n".join(lines) + f"\n{indent[:-4]}]"
-
-
-def _render_operation(op: Operation) -> str:
-    """Render a single operation as a Python constructor call."""
-    if isinstance(op, CreateRelation):
-        cols = _repr_columns(op.columns)
-        return (
-            f'ops.CreateRelation(\n'
-            f'            name="{op.name}",\n'
-            f'            columns={cols},\n'
-            f'        )'
-        )
-    if isinstance(op, DropRelation):
-        cols = _repr_columns(op.columns)
-        return (
-            f'ops.DropRelation(\n'
-            f'            name="{op.name}",\n'
-            f'            columns={cols},\n'
-            f'        )'
-        )
-    if isinstance(op, CreateRule):
-        clauses = _repr_str_list(op.clauses)
-        return (
-            f'ops.CreateRule(\n'
-            f'            name="{op.name}",\n'
-            f'            clauses={clauses},\n'
-            f'        )'
-        )
-    if isinstance(op, DropRule):
-        clauses = _repr_str_list(op.clauses)
-        return (
-            f'ops.DropRule(\n'
-            f'            name="{op.name}",\n'
-            f'            clauses={clauses},\n'
-            f'        )'
-        )
-    if isinstance(op, ReplaceRule):
-        old = _repr_str_list(op.old_clauses)
-        new = _repr_str_list(op.new_clauses)
-        return (
-            f'ops.ReplaceRule(\n'
-            f'            name="{op.name}",\n'
-            f'            old_clauses={old},\n'
-            f'            new_clauses={new},\n'
-            f'        )'
-        )
-    if isinstance(op, CreateIndex):
-        return (
-            f'ops.CreateIndex(\n'
-            f'            name="{op.name}",\n'
-            f'            relation="{op.relation}",\n'
-            f'            column="{op.column}",\n'
-            f'            metric="{op.metric}",\n'
-            f'            m={op.m},\n'
-            f'            ef_construction={op.ef_construction},\n'
-            f'            ef_search={op.ef_search},\n'
-            f'        )'
-        )
-    if isinstance(op, DropIndex):
-        return (
-            f'ops.DropIndex(\n'
-            f'            name="{op.name}",\n'
-            f'            relation="{op.relation}",\n'
-            f'            column="{op.column}",\n'
-            f'            metric="{op.metric}",\n'
-            f'            m={op.m},\n'
-            f'            ef_construction={op.ef_construction},\n'
-            f'            ef_search={op.ef_search},\n'
-            f'        )'
-        )
-    if isinstance(op, RunIQL):
-        fwd = _repr_str_list(op.forward)
-        bwd = _repr_str_list(op.backward)
-        return (
-            f'ops.RunIQL(\n'
-            f'            forward={fwd},\n'
-            f'            backward={bwd},\n'
-            f'        )'
-        )
-    raise TypeError(f"Unknown operation type: {type(op).__name__}")
-
-
-def _render_state(state: dict[str, Any]) -> str:
-    """Render state dict as formatted Python source."""
-    lines = ["    state = {"]
-
-    # Relations
-    lines.append('        "relations": {')
-    for name, cols in sorted(state.get("relations", {}).items()):
-        col_strs = [f'("{c}", "{t}")' for c, t in cols]
-        lines.append(f'            "{name}": [{", ".join(col_strs)}],')
-    lines.append("        },")
-
-    # Rules
-    lines.append('        "rules": {')
-    for name, clauses in sorted(state.get("rules", {}).items()):
-        if len(clauses) == 1:
-            lines.append(f'            "{name}": [{clauses[0]!r}],')
-        else:
-            lines.append(f'            "{name}": [')
-            for c in clauses:
-                lines.append(f"                {c!r},")
-            lines.append("            ],")
-    lines.append("        },")
-
-    # Indexes
-    lines.append('        "indexes": {')
-    for name, info in sorted(state.get("indexes", {}).items()):
-        lines.append(f'            "{name}": {{')
-        for k, v in info.items():
-            lines.append(f'                "{k}": {v!r},')
-        lines.append("            },")
-    lines.append("        },")
-
-    lines.append("    }")
-    return "\n".join(lines)
+MIGRATION_FORMAT = 1
 
 
 def generate_migration(
@@ -163,46 +30,22 @@ def generate_migration(
 
     Returns (filename, content).
     """
+    if name_suffix is not None and not re.fullmatch(r"[a-z0-9_]+", name_suffix):
+        raise MigrationError(
+            f"invalid migration name {name_suffix!r}: use lowercase letters, "
+            "digits, and underscores only"
+        )
     if number == 1 and name_suffix is None:
         name_suffix = "initial"
     elif name_suffix is None:
         name_suffix = "auto"
 
-    filename = f"{number:04d}_{name_suffix}.py"
-
-    # Build content
-    lines = [
-        f"# Migration: {filename}",
-        "# Auto-generated by inputlayer-migrate",
-        "",
-        "from inputlayer.migrations import Migration",
-        "from inputlayer.migrations import operations as ops",
-        "",
-        "",
-        "class M(Migration):",
-    ]
-
-    # Dependencies
-    if dependencies:
-        deps_str = ", ".join(f'"{d}"' for d in dependencies)
-        lines.append(f"    dependencies = [{deps_str}]")
-    else:
-        lines.append("    dependencies = []")
-    lines.append("")
-
-    # Operations
-    if operations:
-        lines.append("    operations = [")
-        for op in operations:
-            rendered = _render_operation(op)
-            lines.append(f"        {rendered},")
-        lines.append("    ]")
-    else:
-        lines.append("    operations = []")
-    lines.append("")
-
-    # State
-    lines.append(_render_state(state))
-    lines.append("")
+    filename = f"{number:04d}_{name_suffix}.json"
 
-    return filename, "\n".join(lines)
+    document = {
+        "format": MIGRATION_FORMAT,
+        "dependencies": dependencies,
+        "operations": [op.to_dict() for op in operations],
+        "state": state,
+    }
+    return filename, json.dumps(document, indent=2, sort_keys=False) + "\n"

{inputlayer_client_dev-0.1.0.dev915.dist-info → inputlayer_client_dev-0.1.0.dev921.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inputlayer-client-dev
-Version: 0.1.0.dev915
+Version: 0.1.0.dev921
 Summary: Python Object-Logic Mapper for InputLayer knowledge graph engine
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -51,7 +51,7 @@ pip install inputlayer-client-dev[all]         # everything
 
 Requirements: Python 3.10+ and a running InputLayer server.
 
-This also installs the `il` CLI for managing schema migrations.
+This also installs the `inputlayer-migrate` tool for schema migrations; with the InputLayer product CLI installed, use it as `il migration <verb>`.
 
 ## Quick Start
 
@@ -425,16 +425,16 @@ The SDK includes a Django-style migration system for production schema managemen
 
 ```bash
 # Generate a migration from your models
-il makemigrations --models myapp.models
+il migration generate --models myapp.models
 
 # Apply pending migrations
-il migrate --url ws://localhost:8080/ws --kg production
+il migration apply --url ws://localhost:8080/ws --kg production
 
 # Check status
-il showmigrations --url ws://localhost:8080/ws --kg production
+il migration status --url ws://localhost:8080/ws --kg production
 
 # Rollback
-il revert --url ws://localhost:8080/ws --kg production 0001_initial
+il migration revert --url ws://localhost:8080/ws --kg production 0001_initial
 ```
 
 The autodetector diffs your current Python models against the last migration's state and generates the minimal set of operations (create/drop relations, create/drop/replace rules, create/drop indexes). Each migration file is self-contained with a full state snapshot.
@@ -519,10 +519,10 @@ The autodetector diffs your current Python models against the last migration's s
 
 | Command | Description |
 |---------|-------------|
-| `il makemigrations --models <module>` | Generate migration from model diff |
-| `il migrate --url <ws> --kg <name>` | Apply pending migrations |
-| `il revert --url <ws> --kg <name> <target>` | Revert to a target migration |
-| `il showmigrations --url <ws> --kg <name>` | Show applied/pending status |
+| `il migration generate --models <module>` | Generate migration from model diff |
+| `il migration apply --url <ws> --kg <name>` | Apply pending migrations |
+| `il migration revert --url <ws> --kg <name> <target>` | Revert to a target migration |
+| `il migration status --url <ws> --kg <name>` | Show applied/pending status |
 
 ### Aggregation Functions
 

{inputlayer_client_dev-0.1.0.dev915.dist-info → inputlayer_client_dev-0.1.0.dev921.dist-info}/RECORD

@@ -1,4 +1,4 @@
-inputlayer/__init__.py,sha256=Pj9Ix9f2pSDObrcI0jDVb6Xy66PBp8pTiTW25drYNyw,3175
+inputlayer/__init__.py,sha256=BkzTEu2UVsC1Rl2d0uZd5HVIdGGLICZz30RLdUhppqY,3084
 inputlayer/_ast.py,sha256=NjO0JaNbgWAPzpFRRkfbvRGfTcyFZiqi93Y5Oni-H7M,4257
 inputlayer/_naming.py,sha256=TXZj6AfiNRQQIKqHtCOm05_5OUR8mFQDu4eNqEeaBek,1212
 inputlayer/_protocol.py,sha256=-P0MgP2Vhv5OT9UdA8iDuEJPlU-whJO5x_H7qsWlV2M,6743
@@ -8,7 +8,7 @@ inputlayer/aggregations.py,sha256=qQm9PUxTZGCIfCThexrD3wa71327pshI9wJCLkFJI74,29
 inputlayer/auth.py,sha256=Vp3Jkx9cQUTjPX31cpMIIkPDoBWmjalg1kcyxeYl8pA,3249
 inputlayer/client.py,sha256=U8zBp0srmTFmzFY626IbrXtlaXbxlWj5Cj_R1vtD17I,7584
 inputlayer/client_sync.py,sha256=Dz38mRQT3Mc7wwmOYgVQP9dBCVgMFIESATmy7fBYAjc,8346
-inputlayer/compiler.py,sha256=3ELVDd0dRNCSLjvQcUQ7paFdqFra5sznWGrrTfvhCwg,24378
+inputlayer/compiler.py,sha256=5YMFZO6sl6lZ63fUH2bCb-PEl1QK_sbB1ntdHRjmi-k,24792
 inputlayer/connection.py,sha256=tYbRH5Q1OzR1KfguSEhfZ1LXTeX708OIdp-yatbMeoA,13772
 inputlayer/derived.py,sha256=ngjuYmKY88ZSnmb4RiTB2bDEr9buzoM15J6NdKqhSNo,4793
 inputlayer/exceptions.py,sha256=6b2WEkpfLnf02MLyXzXA8ohUqIwXFdo4RDWw46FINH8,2712
@@ -38,17 +38,18 @@ inputlayer/integrations/langgraph/memory.py,sha256=FSNm6d2MDMiJPeKWqXCH02J6_aWXT
 inputlayer/integrations/langgraph/nodes.py,sha256=BlozF5M8JwfReIhUlELSRUCJ0GNEmryBQAE3r_k_VXM,7193
 inputlayer/integrations/langgraph/router.py,sha256=yBufX0E92MpMhG2UPYyDAyUA2ynQGyknHrMTDzae3MM,5831
 inputlayer/integrations/langgraph/state.py,sha256=fApBzS7MwfROww487NNQuOj4pxj5CaEWO1pwielwtro,1149
-inputlayer/migrations/__init__.py,sha256=iSOQi_p51td4kHimHdGdVtfvLV6i7hYiZhAMrFx8IlQ,1098
+inputlayer/migrations/__init__.py,sha256=tQmzYSv5C0ijse2sbacgskqMMH9bhBSlPyS6Pw0MLXw,597
 inputlayer/migrations/autodetector.py,sha256=PdJucKS25WCzzlQB-rS6OCEE-rWAixsGr8IzCFIkUo4,4207
-inputlayer/migrations/cli.py,sha256=5MZG3yhplSJiClDeannfR1GTqgg6Y52MFLq5h6ghehI,7901
-inputlayer/migrations/executor.py,sha256=wCkXkVGDBOLHIHOAhMaXR1ZFDdzKcdBZIxmc4yMZx7A,2535
-inputlayer/migrations/loader.py,sha256=fqma6D58N04podRndx1zcHsMlA6UVsIiWbvn6Rw7PQk,2659
+inputlayer/migrations/cli.py,sha256=7ui7Vuboq_jpEfeM7Tf1s4hBTaE2Kam5eq22ivKKIvs,8731
+inputlayer/migrations/errors.py,sha256=_gmlVatOAlYzjRvb3rN2PDYMyRPBar9eEqt8TOiLftQ,1025
+inputlayer/migrations/executor.py,sha256=vj10XkAHsz0iNGQsbrIqaqKC3BXlpHn2NAblj8k5E2E,3094
+inputlayer/migrations/loader.py,sha256=fMqhIcDeYauJpEwxVp_IPxVc08-LsAW791M-rJQzbLM,4704
 inputlayer/migrations/operations.py,sha256=_qiguq0GFcXVZgIJa4vHu7eeKSa5BUh2maDcex9X61M,8420
-inputlayer/migrations/recorder.py,sha256=2LZyhifIyultiNLLKmUnqmi9voKtDfmOYVDmjC5hNxs,1499
+inputlayer/migrations/recorder.py,sha256=qARvQKL_s84vWTEEuHFAmVPvAZiTYCW4X-HtLIdpnbA,3282
 inputlayer/migrations/state.py,sha256=BH5_ly9I9bVPn1lvhqS_UWS7NvYg2iCLJrbG50-mwlQ,3695
-inputlayer/migrations/writer.py,sha256=XbQN5t5H538AASStAQ9jkrveYZwf2aFEFiXZsifUWI0,6465
-inputlayer_client_dev-0.1.0.dev915.dist-info/METADATA,sha256=yT9_etRi-yTz84DceEAv8rrP-GOjyjoQITR1qG4OTBE,19810
-inputlayer_client_dev-0.1.0.dev915.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-inputlayer_client_dev-0.1.0.dev915.dist-info/entry_points.txt,sha256=Y90cH3HHrT10BztOigvvD1WdNIt_RYR6k6IsVbs_A8U,54
-inputlayer_client_dev-0.1.0.dev915.dist-info/licenses/LICENSE,sha256=zed5l9sdToIBMxqe_4I7nX1NTIlqxzT_PBO3rj7-ax4,11281
-inputlayer_client_dev-0.1.0.dev915.dist-info/RECORD,,
+inputlayer/migrations/writer.py,sha256=4EZjKTu10pry-3vVchg36I9aNHs-zavLzJeDbZd2rko,1497
+inputlayer_client_dev-0.1.0.dev921.dist-info/METADATA,sha256=j6xsBI7GizHy4JBZes1QFLTzWnwz6VYlAcuuR_mhfDc,19942
+inputlayer_client_dev-0.1.0.dev921.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+inputlayer_client_dev-0.1.0.dev921.dist-info/entry_points.txt,sha256=xEo6y283VSdmZ4G_KSh1-Cpl3ZPmgM6x9OLT8VJcrqs,70
+inputlayer_client_dev-0.1.0.dev921.dist-info/licenses/LICENSE,sha256=zed5l9sdToIBMxqe_4I7nX1NTIlqxzT_PBO3rj7-ax4,11281
+inputlayer_client_dev-0.1.0.dev921.dist-info/RECORD,,

inputlayer_client_dev-0.1.0.dev921.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+inputlayer-migrate = inputlayer.migrations.cli:main

inputlayer_client_dev-0.1.0.dev915.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-il = inputlayer.migrations.cli:main