agentbundle 0.31.0__tar.gz → 0.31.1__tar.gz

agentbundle-0.31.1/MANIFEST.in

@@ -0,0 +1,16 @@
+graft tests
+include conftest.py
+graft templates
+recursive-include agentbundle/_data/catalogue-scaffold/packs/_example/.apm *
+recursive-include agentbundle/_data/catalogue-scaffold/packs/_example/.claude-plugin *
+prune tests/live-catalogue
+prune tests/.pytest_cache
+prune tests/.mypy_cache
+prune tests/.ruff_cache
+prune tests/.hypothesis
+prune tests/htmlcov
+global-exclude *.py[cod]
+global-exclude .DS_Store
+global-exclude .coverage
+global-exclude .coverage.*
+global-exclude coverage.xml

{agentbundle-0.31.0 → agentbundle-0.31.1}/PKG-INFO

@@ -1,17 +1,15 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.31.0
+Version: 0.31.1
 Summary: npm for your coding agent. Install packs of skills, subagents, and hooks into any repo, for every major agent.
 Author-email: eugenelim <eugenelim@users.noreply.github.com>
-License: Apache-2.0 OR MIT
+License-Expression: Apache-2.0 OR MIT
 Project-URL: Homepage, https://github.com/eugenelim/agent-ready-repo
 Project-URL: Source, https://github.com/eugenelim/agent-ready-repo
 Project-URL: Documentation, https://eugenelim.github.io/agent-ready-repo/docs/
 Project-URL: Catalogue Format, https://eugenelim.github.io/agent-ready-repo/docs/reference/catalogue-format
 Project-URL: Changelog, https://eugenelim.github.io/agent-ready-repo/docs/changelog
 Classifier: Development Status :: 4 - Beta
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/_data/catalogue-scaffold/manifest.json

@@ -12,7 +12,10 @@
     "profiles/AGENTS.md": "8950438d9e0f57c13613104c88c90b598b53196c91bfdced6d63e4e01b5e9254",
     "profiles/README.md": "a0b0268edc57fc575f7fea08f3363ba7da9f6e67dc4a0a6f8bd38c9668c97922",
     "profiles/_example/README.md": "164494df049ddce3e57cb44ed604cb3d39be0a6ec2072e609ea3fa4bbfc74c72",
-    "profiles/_example/profile.toml": "68af18cf50fa0327a9776b029c92bb1cf82710c649691b3ac889eb8537b8eac7"
+    "profiles/_example/profile.toml": "68af18cf50fa0327a9776b029c92bb1cf82710c649691b3ac889eb8537b8eac7",
+    "tests/conformance/test_gemini_admissibility.py": "8b337da9272823aed2cb22041b3f9fd27549f075f28b9817efd5be8f8c5bb948",
+    "tests/conformance/test_pack_metadata.py": "8ea175b88cc6e10ba10cda87676fc225ee2b968d710c8e6ab05fb20e31ec978a",
+    "tests/conformance/test_shared_library_boundaries.py": "5e07783459336e657a355f43aa5a9cf6c138603624daec258ecc0fa3d74239c3"
   },
   "version": 1
 }

agentbundle-0.31.1/agentbundle/_data/catalogue-scaffold/packs/_example/.apm/skills/example-skill/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: example-skill
+description: "Demonstrate the standard skill layout. Triggers on: run example, show example skill output. Near-miss: requesting a demo or test of any skill (route those to the specific skill)."
+---
+
+# Example Skill
+
+This skill is a minimal demonstration of the standard SKILL.md layout. Replace this content
+with your skill's actual instructions.
+
+## What it does
+
+Produces a short greeting and lists any files the user has mentioned.
+
+## When to use this skill
+
+The agent invokes this skill when the user asks to "run example" or "show example skill output".
+
+## Steps
+
+1. Greet the user.
+2. List any files mentioned in the conversation.
+3. Summarize what the example-skill would do in a real pack.
+
+## Output
+
+A short greeting and a bullet list.

agentbundle-0.31.1/agentbundle/_data/catalogue-scaffold/packs/_example/.apm/skills/example-skill/evals/eval_queries.json

@@ -0,0 +1,42 @@
+[
+  {
+    "query": "run example",
+    "skill": "example-skill",
+    "should_trigger": true
+  },
+  {
+    "query": "show example skill output",
+    "skill": "example-skill",
+    "should_trigger": true
+  },
+  {
+    "query": "what does example-skill do",
+    "skill": "example-skill",
+    "should_trigger": true
+  },
+  {
+    "query": "demonstrate the example",
+    "skill": "example-skill",
+    "should_trigger": true
+  },
+  {
+    "query": "run the example skill now",
+    "skill": "example-skill",
+    "should_trigger": true
+  },
+  {
+    "query": "give me a demo",
+    "skill": "example-skill",
+    "should_trigger": false
+  },
+  {
+    "query": "show me a test run of architect-design",
+    "skill": "example-skill",
+    "should_trigger": false
+  },
+  {
+    "query": "how do I install a pack",
+    "skill": "example-skill",
+    "should_trigger": false
+  }
+]

agentbundle-0.31.1/agentbundle/_data/catalogue-scaffold/packs/_example/.claude-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "example-pack",
+  "version": "0.1.0",
+  "description": "The skeleton to copy when you start a new pack.",
+  "displayName": "Example Pack",
+  "category": "productivity",
+  "keywords": [
+    "example",
+    "template"
+  ],
+  "skills": [
+    "example-skill"
+  ]
+}

agentbundle-0.31.1/agentbundle/_data/catalogue-scaffold/tests/conformance/test_gemini_admissibility.py

@@ -0,0 +1,67 @@
+"""Portable Gemini adapter rules over every pack in a catalogue."""
+
+from __future__ import annotations
+
+import tomllib
+from importlib.resources import files
+from pathlib import Path
+
+CATALOGUE_ROOT = Path(__file__).resolve().parents[2]
+PACKS_DIR = CATALOGUE_ROOT / "packs"
+
+
+def _adapter_contract() -> dict:
+    """Load the runtime adapter contract from the installed engine data."""
+    resource = files("agentbundle").joinpath("_data", "adapter.toml")
+    return tomllib.loads(resource.read_text(encoding="utf-8"))
+
+
+def _pack_dirs() -> list[Path]:
+    return sorted(
+        path
+        for path in PACKS_DIR.iterdir()
+        if path.is_dir()
+        and not path.name.startswith("_")
+        and (path / "pack.toml").is_file()
+    )
+
+
+def test_every_declared_agent_tool_is_mapped() -> None:
+    declared: set[str] = set()
+    for agent_path in PACKS_DIR.glob("*/.apm/agents/*.md"):
+        for line in agent_path.read_text(encoding="utf-8").splitlines():
+            if line.startswith("tools:"):
+                declared.update(
+                    item.strip()
+                    for item in line.split(":", 1)[1].split(",")
+                    if item.strip()
+                )
+    if not declared:
+        return
+    contract = _adapter_contract()
+    values = contract["frontmatter-mapping"]["gemini-agent-frontmatter"]["tools"][
+        "values"
+    ]
+    assert declared <= set(values), f"unmapped agent tools: {declared - set(values)}"
+
+
+def test_every_compatible_pack_admits_gemini_in_both_scopes() -> None:
+    from agentbundle.commands.install import _resolve_target_adapter
+
+    for pack_dir in _pack_dirs():
+        data = tomllib.loads((pack_dir / "pack.toml").read_text(encoding="utf-8"))
+        pack = data["pack"]
+        allowed = pack.get("install", {}).get("allowed-adapters")
+        if allowed is not None and "gemini" not in allowed:
+            continue
+        contract_version = pack.get("adapter-contract", {}).get("version", "0.13")
+        for scope in ("repo", "user"):
+            resolved = _resolve_target_adapter(
+                pack_dir,
+                scope=scope,
+                adapter="gemini",
+                allowed_adapters=allowed,
+                contract_version=contract_version,
+                command_name="install",
+            )
+            assert resolved == "gemini", f"{pack_dir.name} @ {scope}"

agentbundle-0.31.1/agentbundle/_data/catalogue-scaffold/tests/conformance/test_pack_metadata.py

@@ -0,0 +1,116 @@
+"""Portable catalogue manifest and marketplace rules."""
+
+from __future__ import annotations
+
+import json
+import tomllib
+from importlib.resources import files
+from pathlib import Path
+
+import pytest
+
+CATALOGUE_ROOT = Path(__file__).resolve().parents[2]
+PACKS_DIR = CATALOGUE_ROOT / "packs"
+MARKETPLACE_PATH = CATALOGUE_ROOT / ".claude-plugin" / "marketplace.json"
+
+
+def _bundled_schema(name: str) -> dict:
+    """Load a runtime schema without requiring a source-checkout contract tree."""
+    resource = files("agentbundle").joinpath("_data", name)
+    return json.loads(resource.read_text(encoding="utf-8"))
+
+
+def _pack_dirs() -> list[Path]:
+    return sorted(
+        path
+        for path in PACKS_DIR.iterdir()
+        if path.is_dir()
+        and not path.name.startswith("_")
+        and (path / "pack.toml").is_file()
+    )
+
+
+def _pack_data(pack_dir: Path) -> dict:
+    return tomllib.loads((pack_dir / "pack.toml").read_text(encoding="utf-8"))[
+        "pack"
+    ]
+
+
+@pytest.mark.parametrize("pack_dir", _pack_dirs(), ids=lambda path: path.name)
+def test_pack_declares_enriched_metadata(pack_dir: Path) -> None:
+    pack = _pack_data(pack_dir)
+    assert pack.get("readme") == "README.md", f"{pack_dir.name}: readme"
+    assert (pack_dir / "README.md").is_file(), f"{pack_dir.name}: README.md"
+    assert isinstance(pack.get("license"), str) and pack["license"]
+    links = pack.get("links")
+    assert isinstance(links, dict)
+    assert isinstance(links.get("repository"), str) and links["repository"]
+    for field in ("categories", "keywords"):
+        values = pack.get(field)
+        assert isinstance(values, list) and values, f"{pack_dir.name}: {field}"
+        assert len(values) <= 5, f"{pack_dir.name}: {field} capped at 5"
+    maintainers = pack.get("maintainers")
+    assert isinstance(maintainers, list) and maintainers
+    assert isinstance(maintainers[0].get("name"), str) and maintainers[0]["name"]
+
+
+@pytest.mark.parametrize("pack_dir", _pack_dirs(), ids=lambda path: path.name)
+def test_pack_and_plugin_versions_match(pack_dir: Path) -> None:
+    plugin_path = pack_dir / ".claude-plugin" / "plugin.json"
+    if not plugin_path.exists():
+        return
+    plugin = json.loads(plugin_path.read_text(encoding="utf-8"))
+    assert plugin.get("version") == _pack_data(pack_dir)["version"]
+
+
+def test_source_plugin_manifests_obey_schema() -> None:
+    from agentbundle.build.validate import validate
+
+    manifests = sorted(
+        path
+        for pack_dir in _pack_dirs()
+        if (path := pack_dir / ".claude-plugin" / "plugin.json").is_file()
+    )
+    if not manifests:
+        return
+    schema = _bundled_schema("plugin-manifest.schema.json")
+    for path in manifests:
+        content = json.loads(path.read_text(encoding="utf-8"))
+        assert "hooks" not in content, f"{path.relative_to(CATALOGUE_ROOT)}: hooks"
+        errors = validate(content, schema)
+        assert not errors, f"{path.relative_to(CATALOGUE_ROOT)}: {errors}"
+
+
+def test_root_marketplace_entries_obey_schema() -> None:
+    from agentbundle.build.validate import validate
+
+    if not MARKETPLACE_PATH.is_file():
+        return
+    marketplace = json.loads(MARKETPLACE_PATH.read_text(encoding="utf-8"))
+    entries = marketplace.get("plugins", [])
+    if not entries:
+        return
+    schema = _bundled_schema("marketplace-entry.schema.json")
+    for entry in entries:
+        assert not validate(entry, schema), entry.get("name", "<unnamed>")
+
+
+def test_root_marketplace_has_portable_metadata_shapes() -> None:
+    if not MARKETPLACE_PATH.is_file():
+        return
+    marketplace = json.loads(MARKETPLACE_PATH.read_text(encoding="utf-8"))
+    assert "name" in marketplace
+    assert isinstance(marketplace.get("owner"), dict)
+    for plugin in marketplace.get("plugins", []):
+        assert isinstance(plugin.get("author"), dict), plugin.get("name")
+        source = plugin.get("source")
+        if source is None:
+            continue
+        assert isinstance(source, dict), plugin.get("name")
+        assert source.get("source") == "git-subdir", plugin.get("name")
+        assert isinstance(source.get("url"), str) and source["url"].startswith(
+            "https://github.com/"
+        )
+        assert source.get("path")
+        assert source.get("ref") or source.get("sha")
+        assert "branch" not in source and "directory" not in source

agentbundle-0.31.1/agentbundle/_data/catalogue-scaffold/tests/conformance/test_shared_library_boundaries.py

@@ -0,0 +1,40 @@
+"""Portable rules for retired credential-shim copies in pack scripts."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+CATALOGUE_ROOT = Path(__file__).resolve().parents[2]
+PACKS_DIR = CATALOGUE_ROOT / "packs"
+SHIM_BASENAMES = (
+    "credentials_shim.py",
+    "_keychain_macos.py",
+    "_credman_windows.py",
+)
+SHIM_IMPORT_RE = re.compile(
+    r"(?:from\s+\.{0,2}(?:[\w.]+\.)?credentials_shim\s+import"
+    r"|import\s+(?:[\w.]+\.)?credentials_shim\b)"
+)
+
+
+def test_no_pack_skill_carries_a_retired_shim_copy() -> None:
+    offenders = [
+        str(path.relative_to(CATALOGUE_ROOT))
+        for scripts_dir in PACKS_DIR.glob("*/.apm/skills/*/scripts")
+        for basename in SHIM_BASENAMES
+        if (path := scripts_dir / basename).exists()
+    ]
+    assert not offenders, offenders
+
+
+def test_no_pack_skill_imports_the_retired_shim() -> None:
+    offenders: list[str] = []
+    for path in PACKS_DIR.glob("*/.apm/skills/*/scripts/*.py"):
+        try:
+            source = path.read_text(encoding="utf-8")
+        except OSError:
+            continue
+        if SHIM_IMPORT_RE.search(source):
+            offenders.append(str(path.relative_to(CATALOGUE_ROOT)))
+    assert not offenders, offenders

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/build/__init__.py

@@ -25,12 +25,12 @@ import sys
 from pathlib import Path
 
 from agentbundle.build.contract import load as load_contract
-from agentbundle.build.validate import validate as validate_instance
 from agentbundle.build.lint_packs import cmd_lint_packs
-from agentbundle.build.main import cmd_build
+from agentbundle.build.main import _read_bundled, cmd_build
 from agentbundle.build.self_host import cmd_check, cmd_self
+from agentbundle.build.validate import validate as validate_instance
 
-__all__ = ["main"]
+__all__ = ["main", "cmd_lint_packs"]
 
 
 def _cmd_validate(args: argparse.Namespace) -> int:
@@ -42,14 +42,12 @@ def _cmd_validate(args: argparse.Namespace) -> int:
         )
         return 1
 
-    schema_path = (
-        Path(__file__).resolve().parent.parent.parent.parent.parent
-        / "contracts"
-        / "adapter.schema.json"
-    )
-    if not schema_path.exists():
+    try:
+        schema_text = _read_bundled("adapter.schema.json")
+    except (FileNotFoundError, ModuleNotFoundError):
         print(
-            f"validate: adapter.schema.json not found at {schema_path}",
+            "validate: adapter.schema.json not found in package data or "
+            "repository contracts",
             file=sys.stderr,
         )
         return 1
@@ -60,7 +58,7 @@ def _cmd_validate(args: argparse.Namespace) -> int:
         print(f"validate: failed to load {contract_path}: {exc}", file=sys.stderr)
         return 1
 
-    schema = json.loads(schema_path.read_text(encoding="utf-8"))
+    schema = json.loads(schema_text)
     errors = validate_instance(contract, schema)
     if errors:
         print(
@@ -172,7 +170,8 @@ def _build_parser() -> argparse.ArgumentParser:
 
 def _cmd_build_shim(args) -> int:
     print(
-        "agentbundle.build build is deprecated; use 'agentbundle catalogue build --root .' instead",
+        "agentbundle.build build is deprecated; "
+        "use 'agentbundle catalogue build --root .' instead",
         file=sys.stderr,
     )
     return int(cmd_build(args))
@@ -180,7 +179,8 @@ def _cmd_build_shim(args) -> int:
 
 def _cmd_self_shim(args) -> int:
     print(
-        "agentbundle.build self is deprecated; use 'agentbundle catalogue self-host --write --root .' instead",
+        "agentbundle.build self is deprecated; "
+        "use 'agentbundle catalogue self-host --write --root .' instead",
         file=sys.stderr,
     )
     return int(cmd_self(args))
@@ -188,7 +188,8 @@ def _cmd_self_shim(args) -> int:
 
 def _cmd_check_shim(args) -> int:
     print(
-        "agentbundle.build check is deprecated; use 'agentbundle catalogue self-host --check --root .' instead",
+        "agentbundle.build check is deprecated; "
+        "use 'agentbundle catalogue self-host --check --root .' instead",
         file=sys.stderr,
     )
     return int(cmd_check(args))
@@ -196,7 +197,8 @@ def _cmd_check_shim(args) -> int:
 
 def _cmd_lint_packs_shim(args) -> int:
     print(
-        "agentbundle.build lint-packs is deprecated; use 'agentbundle catalogue lint --root .' instead",
+        "agentbundle.build lint-packs is deprecated; "
+        "use 'agentbundle catalogue lint --root .' instead",
         file=sys.stderr,
     )
     from agentbundle.catalogue_tooling.lint import lint_catalogue, render_table

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/build/adapters/__init__.py

@@ -5,9 +5,18 @@ from __future__ import annotations
 import warnings
 from pathlib import Path
 from types import ModuleType
-from typing import Callable, Dict, Mapping
+from typing import Callable, Mapping
 
-from agentbundle.build.adapters import claude_code, codex, copilot, cursor, gemini, kiro, kiro_cli, kiro_ide
+from agentbundle.build.adapters import (
+    claude_code,
+    codex,
+    copilot,
+    cursor,
+    gemini,
+    kiro,
+    kiro_cli,
+    kiro_ide,
+)
 
 
 def _kiro_alias_project(pack_path: Path, contract: dict, output_root: Path) -> None:
@@ -22,7 +31,7 @@ def _kiro_alias_project(pack_path: Path, contract: dict, output_root: Path) -> N
 
 # Original callable registry (hyphenated contract names) — preserved for
 # F-build's recipe runner which keys recipes by contract names.
-ADAPTERS: Dict[str, Callable] = {
+ADAPTERS: dict[str, Callable] = {
     "claude-code": claude_code.project,
     "kiro-ide": kiro_ide.project,
     "kiro-cli": kiro_cli.project,

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/build/adapters/claude_code.py

@@ -14,12 +14,10 @@ deep-merging the incoming TOML payload.
 
 from __future__ import annotations
 
-import os
 import shutil
 from pathlib import Path
 from typing import Iterator
 
-
 # Phase order from the build-pipeline ordering invariant.
 # Uniform across all reference adapters even though Claude Code's
 # wiring lands in a settings file (not in agents) — the uniformity
@@ -139,7 +137,10 @@ def _sweep_skill_orphans(pack_paths: list[Path], contract: dict, output_root: Pa
 
 def _project_single(pack_path: Path, contract: dict, output_root: Path) -> None:
     adapter_block = contract["adapter"]["claude-code"]
-    rules_by_primitive = {entry["primitive"]: entry for entry in adapter_block.get("projection", [])}
+    rules_by_primitive = {
+        entry["primitive"]: entry
+        for entry in adapter_block.get("projection", [])
+    }
 
     for primitive_name in _iter_primitives(contract):
         rule = rules_by_primitive[primitive_name]
@@ -175,7 +176,7 @@ def _ignore_absolute_symlinks(directory: str, names: list[str]) -> set[str]:
     return {
         name for name in names
         if name == "__pycache__"
-        or ((base / name).is_symlink() and os.path.isabs(os.readlink(base / name)))
+        or ((base / name).is_symlink() and (base / name).readlink().is_absolute())
     }
 
 
@@ -213,5 +214,3 @@ def _project_direct_file(source_dir: Path, output_root: Path, target_prefix: str
         if entry.is_file():
             destination = target_dir / entry.name
             shutil.copy2(entry, destination, follow_symlinks=False)
-
-

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/build/adapters/codex.py

@@ -19,15 +19,13 @@ import tempfile
 from pathlib import Path
 from typing import Iterator
 
-
 # Build-pipeline ordering invariant — uniform across adapters.
 from agentbundle.build.phase_order import PHASE_ORDER as _PHASE_ORDER
-from agentbundle.build.projections.direct_directory import sweep_orphans
-from agentbundle.build.projections.merge_json import project_merge_json
 from agentbundle.build.projections.codex_agent_toml import (
     project_codex_agent_toml,
 )
-
+from agentbundle.build.projections.direct_directory import sweep_orphans
+from agentbundle.build.projections.merge_json import project_merge_json
 
 
 def _iter_primitives(contract: dict) -> Iterator[str]:
@@ -104,13 +102,16 @@ def project_packs(pack_paths: list[Path], contract: dict, output_root: Path) ->
             try:
                 with os.fdopen(fd, "w", encoding="utf-8", newline="\n") as handle:
                     handle.write(stripped)
-                os.replace(tmp_path, agents_md)
+                Path(tmp_path).replace(agents_md)
             except BaseException:
                 Path(tmp_path).unlink(missing_ok=True)
                 raise
 
     adapter_block = contract["adapter"]["codex"]
-    rules_by_primitive = {entry["primitive"]: entry for entry in adapter_block.get("projection", [])}
+    rules_by_primitive = {
+        entry["primitive"]: entry
+        for entry in adapter_block.get("projection", [])
+    }
 
     for primitive_name in _iter_primitives(contract):
         rule = rules_by_primitive[primitive_name]
@@ -201,7 +202,7 @@ def _ignore_absolute_symlinks(directory: str, names: list[str]) -> set[str]:
     return {
         name for name in names
         if name == "__pycache__"
-        or ((base / name).is_symlink() and os.path.isabs(os.readlink(base / name)))
+        or ((base / name).is_symlink() and (base / name).readlink().is_absolute())
     }
 
 

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/build/adapters/copilot.py

@@ -22,16 +22,15 @@ import shutil
 from pathlib import Path
 from typing import Iterator
 
-
 # Build-pipeline ordering invariant — uniform across adapters.
 from agentbundle.build.phase_order import PHASE_ORDER as _PHASE_ORDER
-from agentbundle.build.projections.direct_directory import sweep_orphans
 from agentbundle.build.projections.copilot_agent_md import (
     project_copilot_agent_md,
 )
 from agentbundle.build.projections.copilot_hooks_json import (
     project_copilot_hooks_json,
 )
+from agentbundle.build.projections.direct_directory import sweep_orphans
 
 
 def _ignore_symlinks(directory: str, names: list[str]) -> set[str]:
@@ -58,7 +57,10 @@ def _iter_primitives(contract: dict) -> Iterator[str]:
 
 def project(pack_path: Path, contract: dict, output_root: Path) -> None:
     adapter_block = contract["adapter"]["copilot"]
-    rules_by_primitive = {entry["primitive"]: entry for entry in adapter_block.get("projection", [])}
+    rules_by_primitive = {
+        entry["primitive"]: entry
+        for entry in adapter_block.get("projection", [])
+    }
 
     for primitive_name in _iter_primitives(contract):
         rule = rules_by_primitive[primitive_name]

{agentbundle-0.31.0 → agentbundle-0.31.1}/agentbundle/build/adapters/kiro.py

@@ -31,14 +31,6 @@ import tomllib
 from pathlib import Path
 from typing import Any, Iterator
 
-from agentbundle.build.projections.merge_into_agent_json import (
-    project as merge_into_agent_json_project,
-)
-from agentbundle.build.projections.kiro_ide_hook import (
-    project as kiro_ide_hook_project,
-)
-
-
 # Phase order from the build-pipeline ordering invariant.
 # `agent` precedes `hook-wiring` so `merge-into-agent-json` finds the
 # agent JSON in place. `command` and `skill` land last; their position
@@ -47,6 +39,12 @@ from agentbundle.build.projections.kiro_ide_hook import (
 # uniform across adapters.
 from agentbundle.build.phase_order import PHASE_ORDER as _PHASE_ORDER
 from agentbundle.build.projections.direct_directory import sweep_orphans
+from agentbundle.build.projections.kiro_ide_hook import (
+    project as kiro_ide_hook_project,
+)
+from agentbundle.build.projections.merge_into_agent_json import (
+    project as merge_into_agent_json_project,
+)
 
 
 def _iter_primitives(contract: dict) -> Iterator[str]:
@@ -63,7 +61,11 @@ def _iter_primitives(contract: dict) -> Iterator[str]:
     """
     adapter_block = contract["adapter"]["kiro"]
     array_form = {entry["primitive"]: entry for entry in adapter_block.get("projection", [])}
-    table_form = adapter_block.get("projections", {}) if isinstance(adapter_block.get("projections"), dict) else {}
+    table_form = (
+        adapter_block.get("projections", {})
+        if isinstance(adapter_block.get("projections"), dict)
+        else {}
+    )
 
     for primitive_name in _PHASE_ORDER:
         if primitive_name in array_form:
@@ -172,7 +174,11 @@ def _project_single(pack_path: Path, contract: dict, output_root: Path) -> None:
     """
     adapter_block = contract["adapter"]["kiro"]
     array_form = {entry["primitive"]: entry for entry in adapter_block.get("projection", [])}
-    table_form = adapter_block.get("projections", {}) if isinstance(adapter_block.get("projections"), dict) else {}
+    table_form = (
+        adapter_block.get("projections", {})
+        if isinstance(adapter_block.get("projections"), dict)
+        else {}
+    )
 
     for primitive_name in _iter_primitives(contract):
         primitive = contract["primitive"][primitive_name]
@@ -231,10 +237,7 @@ def _dispatch_table_form(
         # writes the repo-scope shape; user-scope projection is T8b's
         # install-time concern.
         target = rule.get("target")
-        if isinstance(target, dict):
-            target_template = target.get("repo")
-        else:
-            target_template = target
+        target_template = target.get("repo") if isinstance(target, dict) else target
         if target_template:
             _project_direct_file_template(source_dir, output_root, target_template)
     elif primitive_name == "kiro-ide-hook" and effective_mode == "direct-file":
@@ -613,10 +616,7 @@ def _project_kiro_ide_hook(
     # Target template from the rule (.kiro/hooks/<pack>/<name>.kiro.hook
     # at v0.4 per the RFC's lean).
     target = rule.get("target")
-    if isinstance(target, dict):
-        target_template = target.get("repo")
-    else:
-        target_template = target
+    target_template = target.get("repo") if isinstance(target, dict) else target
     if not target_template:
         return