quadkit-cli 0.0.42__tar.gz → 0.0.43__tar.gz

quadkit_cli-0.0.43/.gitignore

@@ -0,0 +1,24 @@
+# Generated public-repository ignore rules.
+# Private monorepo paths are intentionally not referenced here.
+
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+.venv/
+venv/
+.env
+.env.*
+!.env.example
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+coverage.xml
+htmlcov/
+build/
+dist/
+*.log
+.DS_Store
+.idea/
+.vscode/

{quadkit_cli-0.0.42 → quadkit_cli-0.0.43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: quadkit-cli
-Version: 0.0.42
+Version: 0.0.43
 Summary: Command-line interface for Quadkit Framework - Project scaffolding, code generation, and development tools
 Project-URL: Homepage, https://dbtinoy-.github.io/quadkit/
 Project-URL: Repository, https://github.com/dbtinoy-/quadkit
@@ -167,10 +167,10 @@ review release notes on upgrade. Report vulnerabilities privately per
 
 ## Stability
 
-Version `0.0.42` in the `0.x` series, released in lockstep with the
+Version `0.0.43` in the `0.x` series, released in lockstep with the
 other four distributions; APIs may change between minor versions until
-1.0 — pin an exact version (`quadkit-cli==0.0.42`) or a tight range
-(`>=0.0.42,<0.1.0`). Full policy:
+1.0 — pin an exact version (`quadkit-cli==0.0.43`) or a tight range
+(`>=0.0.43,<0.1.0`). Full policy:
 [stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
 
 ## Links

{quadkit_cli-0.0.42 → quadkit_cli-0.0.43}/README.md

@@ -111,10 +111,10 @@ review release notes on upgrade. Report vulnerabilities privately per
 
 ## Stability
 
-Version `0.0.42` in the `0.x` series, released in lockstep with the
+Version `0.0.43` in the `0.x` series, released in lockstep with the
 other four distributions; APIs may change between minor versions until
-1.0 — pin an exact version (`quadkit-cli==0.0.42`) or a tight range
-(`>=0.0.42,<0.1.0`). Full policy:
+1.0 — pin an exact version (`quadkit-cli==0.0.43`) or a tight range
+(`>=0.0.43,<0.1.0`). Full policy:
 [stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
 
 ## Links

{quadkit_cli-0.0.42 → quadkit_cli-0.0.43}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quadkit-cli"
-version = "0.0.42"
+version = "0.0.43"
 description = "Command-line interface for Quadkit Framework - Project scaffolding, code generation, and development tools"
 readme = "README.md"
 requires-python = ">=3.11"

{quadkit_cli-0.0.42 → quadkit_cli-0.0.43}/src/quadkit/cli/commands/db_commands_data.py

@@ -23,30 +23,58 @@ from quadkit.contracts.cli.contributions import (
 from quadkit.contracts.data.sql.database import DatabaseProviderProtocol
 
 
-def _seeder_source() -> tuple[Path, str | None]:
-    """Where this project's seeders are, and how to import them.
+def _seeder_sources() -> list[tuple[Path, str | None]]:
+    """Every directory this project keeps seeders in, and how to import each.
 
     Resolution order:
 
-    1. the canonical ``seeders`` component — ``src/<app>/shared/seeders``,
-       where ``quadkit gen seeder`` writes and where a generated application
-       keeps the seeders its persistence provider boots;
-    2. the project-root ``seeds/`` directory — what a project generated before
-       the ``seeders`` row landed has, and what a hand-written collection of
-       seeders looks like. Those files sit outside any package, so they stay
-       path-loaded, exactly as this command always loaded them.
+    1. the canonical ``seeders`` component — where ``quadkit gen seeder``
+       writes and where a generated application keeps the seeders its
+       persistence provider boots;
+    2. **one per bounded context** — ``src/<app>/modules/<slug>/seeders``.
+       A seeder seeds one entity, so it follows that entity into its module
+       (OQ-L1). Before that, every seeder in a modular project shared one
+       ``shared/seeders`` directory and a single lookup found them all;
+       scanning the modules is what keeps ``db seed`` complete now that they
+       are spread out. Missing this is how the command would silently seed
+       nothing in exactly the projects that need it most;
+    3. the project-root ``seeds/`` directory — what a project generated
+       before the ``seeders`` row landed has, and what a hand-written
+       collection looks like. Those files sit outside any package, so they
+       stay path-loaded, exactly as this command always loaded them.
 
     Returns:
-        ``(directory, module_prefix)``: the directory to read, and the dotted
-        package its modules belong to (``my_app.shared.seeders``) when the
-        directory lives inside ``src/`` — ``None`` when it does not, which is
-        the signal to load files by path instead.
+        ``(directory, module_prefix)`` pairs: the directory to read, and the
+        dotted package its modules belong to when it lives inside ``src/`` —
+        ``None`` when it does not, which is the signal to load by path.
     """
     layout = read_project_layout()
+    found: list[tuple[Path, str | None]] = []
+
     canonical = Path(resolve_output_dir("src/seeders", app_package=layout.app_package))
     if canonical.is_dir():
-        return canonical, _module_prefix(canonical)
-    return Path("seeds"), None
+        found.append((canonical, _module_prefix(canonical)))
+
+    # The app package's `modules/` tree, if this project has bounded contexts.
+    app_root = canonical.parent if canonical.name == "seeders" else None
+    modules_root = (app_root / "modules") if app_root else None
+    if modules_root and modules_root.is_dir():
+        for module_dir in sorted(modules_root.iterdir()):
+            seeders = module_dir / "seeders"
+            if seeders.is_dir():
+                found.append((seeders, _module_prefix(seeders)))
+
+    if found:
+        return found
+    # The legacy root directory is returned whether or not it exists: the
+    # callers report "no seeds directory found" from it, so handing back an
+    # absent path is how that message still gets made.
+    return [(Path("seeds"), None)]
+
+
+def _seeder_source() -> tuple[Path, str | None]:
+    """The first seeder directory, for callers that only report existence."""
+    return _seeder_sources()[0]
 
 
 def _module_prefix(directory: Path) -> str | None:
@@ -135,8 +163,9 @@ def seed(
         manager = await db_bootstrap.get_migration_manager()
         await manager.provider.boot()
         try:
-            seeds_dir, module_prefix = _seeder_source()
-            if not seeds_dir.exists() and not file:
+            sources = _seeder_sources()
+            seeds_dir = sources[0][0]
+            if not any(d.exists() for d, _ in sources) and not file:
                 out.warning("No seeds directory found.")
                 return
 
@@ -150,7 +179,9 @@ def seed(
                 files_to_run.append((Path(file), None))
             else:
                 files_to_run = [
-                    (seed_file, module_prefix) for seed_file in _seed_files(seeds_dir)
+                    (seed_file, prefix)
+                    for directory, prefix in _seeder_sources()
+                    for seed_file in _seed_files(directory)
                 ]
 
             for seed_file, prefix in files_to_run:
@@ -216,12 +247,11 @@ def reset(
                 out.info("No pending migrations.")
 
             if seed:
-                seeds_dir, module_prefix = _seeder_source()
-                if seeds_dir.exists():
-                    for seed_file in _seed_files(seeds_dir):
-                        await _run_seeder(
-                            out, manager.provider, seed_file, module_prefix
-                        )
+                sources = _seeder_sources()
+                if any(d.exists() for d, _ in sources):
+                    for directory, prefix in sources:
+                        for seed_file in _seed_files(directory):
+                            await _run_seeder(out, manager.provider, seed_file, prefix)
                 else:
                     out.warning("No seeds directory found, skipping seed step.")
 

{quadkit_cli-0.0.42 → quadkit_cli-0.0.43}/src/quadkit/cli/layout.py

@@ -64,7 +64,11 @@ class ComponentDir:
 COMPONENTS: tuple[ComponentDir, ...] = (
     ComponentDir("admin/actions", "admin/actions", False, ("admin_action",)),
     ComponentDir("admin/resources", "admin/resources", False, ("admin_resource",)),
-    ComponentDir("audit", "audit", True, ("audited",)),
+    # Per-entity attachment: an audit log is written for one entity's table,
+    # so it belongs wherever that entity does (the rule `validators` states
+    # below). Cross-cutting `shared/` put it where every context could see a
+    # file only one of them owns.
+    ComponentDir("audit", "audit", False, ("audited",)),
     # ``auth``, ``contracts`` and ``validators`` carry no generators on
     # purpose: no registered generator writes there yet (the CLI ships
     # ``provider`` and ``test``; subsystems contribute the rest), and a
@@ -125,14 +129,18 @@ COMPONENTS: tuple[ComponentDir, ...] = (
     ComponentDir("sagas", "sagas", False, ("saga", "saga_step")),
     ComponentDir("schema", "schema", True, ("graphql",)),
     ComponentDir("schema/dataloaders", "schema/dataloaders", True, ("dataloader",)),
-    ComponentDir("search", "search", True, ("search_index",)),
+    # Per-entity attachment: a search index indexes one entity's fields.
+    ComponentDir("search", "search", False, ("search_index",)),
     # Generated seeders live inside the application package so they are
     # importable: a project boots them from its persistence provider, and
     # `quadkit db seed` imports the same modules. ``seeds`` (project root)
     # stays resolvable in ROOT_DIRS below, because that is where every
     # project generated before 2026-09-23 kept them and where the command
     # still looks second.
-    ComponentDir("seeders", "seeders", True, ("seeder",)),
+    # Per-entity attachment: a seeder seeds exactly one entity, so it follows
+    # that entity into its module. `quadkit db seed` discovers seeders through
+    # the layout rather than a fixed path, so it finds them either way.
+    ComponentDir("seeders", "seeders", False, ("seeder",)),
     ComponentDir("services", "services", False, ("service",)),
     ComponentDir("storage/backends", "storage/backends", True, ("storage_driver",)),
     ComponentDir("tasks", "tasks", False, ("task",)),

{quadkit_cli-0.0.42 → quadkit_cli-0.0.43}/tests/unit/test_db.py

@@ -176,7 +176,7 @@ def test_db_seed_finds_package_seeders_and_imports_them(
 ) -> None:
     """Seeders inside the application package are imported, not path-loaded.
 
-    A generated project keeps its seeders under ``src/<app>/shared/seeders/``
+    A generated project keeps its seeders under ``src/<app>/seeders/``
     (the canonical ``seeders`` component) so that its persistence provider can
     import them at boot. ``quadkit db seed`` has to run the same modules --
     the path-loading it did before cannot import a seeder that itself imports
@@ -190,7 +190,7 @@ def test_db_seed_finds_package_seeders_and_imports_them(
     (tmp_path / "pyproject.toml").write_text(
         '[tool.quadkit]\nmodule = "shop_api.app:app"\n'
     )
-    seeders = tmp_path / "src" / "shop_api" / "shared" / "seeders"
+    seeders = tmp_path / "src" / "shop_api" / "seeders"
     seeders.mkdir(parents=True)
     (seeders / "__init__.py").write_text("")
     (seeders / "users.py").write_text(
@@ -198,7 +198,7 @@ def test_db_seed_finds_package_seeders_and_imports_them(
         "\n"
         "\n"
         "async def run(provider) -> None:\n"
-        "    import shop_api.shared.seeders as package\n"
+        "    import shop_api.seeders as package\n"
         "\n"
         '    package.RUNS.append("users")\n'
     )
@@ -207,11 +207,55 @@ def test_db_seed_finds_package_seeders_and_imports_them(
     result = CliRunner().invoke(app, ["seed"])
 
     assert result.exit_code == 0, result.output
-    assert "Running seeder: src/shop_api/shared/seeders/users.py" in result.output
+    assert "Running seeder: src/shop_api/seeders/users.py" in result.output
 
     # The same module object the command imported: proof the body ran, which a
     # text-only assertion on the output cannot give (the import could have
     # failed silently and left the file unexecuted).
-    from shop_api.shared.seeders import RUNS
+    from shop_api.seeders import RUNS
 
     assert RUNS == ["users"]
+@patch(
+    "quadkit.cli.commands.db_bootstrap.get_migration_manager",
+    new_callable=AsyncMock,
+)
+def test_db_seed_finds_seeders_inside_every_module(
+    mock_get_manager, monkeypatch, tmp_path
+) -> None:
+    """A modular project keeps one seeder directory per bounded context.
+
+    OQ-L1 moved a seeder next to the entity it seeds, so a modular project no
+    longer has a single `shared/seeders` for the command to read -- it has
+    `modules/<slug>/seeders`, one per context. A lookup that resolved only the
+    canonical directory would find nothing here and report success, seeding an
+    empty database in exactly the projects most likely to need it.
+    """
+    mock_manager = AsyncMock()
+    mock_manager.provider = AsyncMock()
+    mock_get_manager.return_value = mock_manager
+
+    monkeypatch.chdir(tmp_path)
+    (tmp_path / "pyproject.toml").write_text(
+        '[tool.quadkit]\nmodule = "shop_api.app:app"\n'
+    )
+    app_root = tmp_path / "src" / "shop_api"
+    for slug, entity in (("billing", "invoices"), ("catalog", "items")):
+        seeders = app_root / "modules" / slug / "seeders"
+        seeders.mkdir(parents=True)
+        (seeders / "__init__.py").write_text("")
+        (seeders / f"{entity}.py").write_text(
+            "from __future__ import annotations\n"
+            "\n"
+            "\n"
+            "async def run(provider) -> None:\n"
+            "    return None\n"
+        )
+
+    result = CliRunner().invoke(app, ["seed"])
+
+    assert result.exit_code == 0, result.output
+    # Both contexts, not just the first one found.
+    assert "src/shop_api/modules/billing/seeders/invoices.py" in result.output
+    assert "src/shop_api/modules/catalog/seeders/items.py" in result.output
+
+

quadkit_cli-0.0.42/.gitignore

@@ -1,214 +0,0 @@
-*
-!tests/
-!tests/**
-!README.md
-!AGENTS.md
-!DEVELOPMENT.md
-!QUICKGUIDE.md
-!MILESTONE*.md
-!TESTS*.md
-!CHANGELOG.md
-!AUDIT*.md
-!REF*.md
-!AUDIT*.json
-!LICENSE
-!LICENSE-MIT.txt
-!NOTICE
-!TRADEMARK.md
-!conftest.py
-!CONTRIBUTING.md
-!CODE_OF_CONDUCT.md
-!SECURITY.md
-!GOVERNANCE.md
-!pyproject.toml
-!uv.lock
-!docker-compose.yml
-!.env.example
-!.env.full.example
-!.importlinter
-!.superpowers/
-!.superpowers/**
-!.gitattributes
-!.editorconfig
-!Makefile
-!docker-compose.test.yml
-!quadkit.yaml.example
-!.github/
-!.github/workflows/
-!.github/workflows/**
-!.github/dependabot.yml
-!.devcontainer/
-!.devcontainer/**
-!tools/
-!tools/**
-!*example.yaml
-
-# Quadkit Packages
-!quadkit*/
-!quadkit*/pyproject.toml
-!quadkit*/CHANGELOG.md
-!quadkit*/README.md
-!quadkit*/alembic.ini
-!quadkit*/mypy.ini
-!quadkit*/*.yaml.example
-!quadkit*/src/
-!quadkit*/src/**
-!quadkit*/docs/
-!quadkit*/docs/**
-!quadkit*/tests/
-!quadkit*/tests/**
-
-# Keep quadkit docs
-!/docs/
-!docs/**
-
-# Session / cutover plans at the repo root
-!plans/
-!plans/**
-
-# Keep example files for README examples
-!/examples/
-!/examples/**
-
-# Re-ignore these AFTER negations (last match wins)
-*.tape
-examples/*/runs/
-__pycache__/
-*.pyc
-*.pyo
-*.egg-info/
-dist/
-build/
-.eggs/
-*.egg
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-htmlcov/
-.coverage
-coverage.xml
-test.db
-!quadkit*/tests/fixtures/test.db
-*.log
-*.tmp
-
-# Company-specific files (keep private, do not commit)
-.company/
-COMPANY_*.md
-company-config/
-internal-docs/
-# Editor swap files
-*.swp
-
-!core/
-!packages/
-!core/quadkit*/
-!packages/quadkit*/
-!core/quadkit*/pyproject.toml
-!packages/quadkit*/pyproject.toml
-!core/quadkit*/CHANGELOG.md
-!packages/quadkit*/CHANGELOG.md
-!core/quadkit*/README.md
-!packages/quadkit*/README.md
-!core/quadkit*/alembic.ini
-!packages/quadkit*/alembic.ini
-!core/quadkit*/mypy.ini
-!packages/quadkit*/mypy.ini
-!core/quadkit*/*.yaml.example
-!packages/quadkit*/*.yaml.example
-!core/quadkit*/src/
-!core/quadkit*/src/**
-!packages/quadkit*/src/
-!packages/quadkit*/src/**
-!core/quadkit*/tests/
-!core/quadkit*/tests/**
-!packages/quadkit*/tests/
-!packages/quadkit*/tests/**
-!core/quadkit*/docs/
-!core/quadkit*/docs/**
-!packages/quadkit*/docs/
-!packages/quadkit*/docs/**
-
-# dev/
-!dev/
-!dev/**
-
-# Admin dev playground (committed dev asset; local SQLite files stay ignored)
-!packages/quadkit-admin/playground/
-!packages/quadkit-admin/playground/serve.py
-
-# gatewai apps
-!apps/
-!apps/**
-!apps/gatewai/
-!apps/gatewai/**
-apps/**/node_modules/
-apps/**/dist/
-apps/**/__pycache__/
-apps/**/*.pyc
-apps/**/*.db
-apps/**/*.db-wal
-apps/**/*.db-shm
-apps/**/.env
-apps/**/.env.*
-!apps/**/.env.example
-!apps/**/.env.full.example
-
-# Piccolina — nested app tracked in this monorepo (standalone .git removed).
-# Keep marketing packages and deployment secrets out of the tree.
-apps/piccolina/piccolina-marketing/
-apps/piccolina/piccolina-marketing-plans/
-apps/piccolina/secrets/
-apps/piccolina/**/secrets/
-apps/piccolina/**/*.pem
-apps/piccolina/**/*.key
-apps/piccolina/**/.venv/
-apps/piccolina/**/node_modules/
-apps/piccolina/**/__pycache__/
-apps/piccolina/**/*.pyc
-apps/piccolina/**/*.pbf
-apps/piccolina/**/.open-next/
-apps/piccolina/**/storage/
-apps/piccolina/**/.deploy-host
-
-# Re-exclude private content under the tiered paths.
-# MUST come after the !...docs/** negations above — last match wins.
-core/quadkit*/docs/plans/
-packages/quadkit*/docs/plans/
-core/quadkit*/docs/**/
-packages/quadkit*/docs/**/
-
-# Re-exclude tooling artifacts under the tiered paths
-__pycache__/
-*.pyc
-*.pyo
-*.egg-info/
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-htmlcov/
-.coverage
-coverage.xml
-test.db
-*.tmp
-*.log
-!core/quadkit*/tests/fixtures/test.db
-!packages/quadkit*/tests/fixtures/test.db
-
-# Allow the generated example gifs to be tracked (README hero images).
-!core/quadkit*/docs/gifs/
-!core/quadkit*/docs/gifs/**
-!packages/*/quadkit*/docs/gifs/
-!packages/*/quadkit*/docs/gifs/**
-examples/*/screenshot.png
-!banner*
-apps/quadkit-playground/**/node_modules/
-apps/quadkit-playground/**/dist/
-apps/quadkit-playground/**/__pycache__/
-apps/quadkit-playground/**/*.pyc
-apps/quadkit-playground/**/*.db
-apps/quadkit-playground/**/*.db-wal
-apps/quadkit-playground/**/*.db-shm
-apps/quadkit-playground/projects/
-apps/quadkit-playground/quadkit/
-docs/superpowers/