agentbundle 0.18.0__tar.gz → 0.20.0__tar.gz

{agentbundle-0.18.0 → agentbundle-0.20.0}/PKG-INFO

@@ -1,12 +1,14 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.18.0
+Version: 0.20.0
 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
 Project-URL: Homepage, https://github.com/eugenelim/agent-ready-repo
 Project-URL: Source, https://github.com/eugenelim/agent-ready-repo
-Project-URL: Documentation, https://github.com/eugenelim/agent-ready-repo/blob/main/docs/guides/_shared/how-to/install-agentbundle-from-clone.md
+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

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/_data/pack.schema.json

@@ -199,6 +199,30 @@
             "pattern": "^[^/].*"
           }
         },
+        "runtime-dependencies": {
+          "type": "array",
+          "description": "External runtime dependencies required by this pack's skills.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["ecosystem", "package"],
+            "properties": {
+              "ecosystem": {
+                "type": "string",
+                "enum": ["pypi", "npm", "cargo", "go", "homebrew", "apt", "system"]
+              },
+              "package": {"type": "string"},
+              "version": {"type": "string"},
+              "optional": {"type": "boolean", "default": false},
+              "skills": {
+                "type": "array",
+                "items": {"type": "string"}
+              },
+              "install": {"type": "string"},
+              "note": {"type": "string"}
+            }
+          }
+        },
         "layout": {
           "type": "object",
           "additionalProperties": false,

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/__init__.py

@@ -44,7 +44,6 @@ def _cmd_validate(args: argparse.Namespace) -> int:
 
     schema_path = (
         Path(__file__).resolve().parent.parent.parent.parent.parent
-        / "docs"
         / "contracts"
         / "adapter.schema.json"
     )

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/contract.py

@@ -1,6 +1,6 @@
 """Contract loader.
 
-Reads `docs/contracts/adapter.toml` via `tomllib` and
+Reads `contracts/adapter.toml` via `tomllib` and
 returns a dict. No validation logic — `validate.py` does that, and
 the CLI's `validate` subcommand wires the two together.
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/lint_packs.py

@@ -18,7 +18,7 @@ Three checks, applied to every pack under a `--packs-dir`:
      exceed the strictest `description-max-length`. Multi-line YAML
      descriptions (`>`, `|`, continuation lines) are refused outright
      rather than mis-parsed. Constraints come from
-     `docs/contracts/target-vocab.toml` — see
+     `contracts/target-vocab.toml` — see
      `docs/specs/lint-packs-target-vocab/spec.md`.
 
 The lint is Python-only so it runs on every CI platform without
@@ -48,7 +48,7 @@ _PACK_SUBTREES = ("seeds", ".apm")
 # Path to the sibling vocab file, relative to a repo root. The loader
 # walks up from a caller-supplied start until an ancestor contains
 # this relative path.
-_VOCAB_RELPATH = Path("docs/contracts/target-vocab.toml")
+_VOCAB_RELPATH = Path("contracts/target-vocab.toml")
 
 # Sentinel returned by `_extract_frontmatter_fields` when a key's
 # value position is `>`, `|`, or empty (signaling a folded / nested
@@ -58,7 +58,7 @@ _MULTILINE = object()
 
 
 class Constraints(NamedTuple):
-    """Strictest-cap snapshot of `docs/contracts/target-vocab.toml`.
+    """Strictest-cap snapshot of `contracts/target-vocab.toml`.
 
     `binding_targets` keys (`"description_max"`, `"name_max"`,
     `"name_pattern"`) carry the ASCII-sorted list of targets enforcing
@@ -84,7 +84,7 @@ def _walk_up_for_vocab(start: Path) -> Path | None:
 
 
 def _load_target_vocab(start: Path) -> tuple[dict | None, str | None]:
-    """Walk up from `start` looking for `docs/contracts/target-vocab.toml`;
+    """Walk up from `start` looking for `contracts/target-vocab.toml`;
     fall back to walking up from this module's own ancestor chain when
     the explicit walk fails. This keeps the gate working when an
     adopter points `--packs-dir` at a tmp tree outside the repo while

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/main.py

@@ -53,7 +53,7 @@ _GITHUB_URL_RE = re.compile(
 
 def _bundled_or_repo(name: str) -> Path:
     """Locate a data file shipped under both `agentbundle/_data/` and
-    `<repo>/docs/contracts/`.
+    `<repo>/contracts/`.
 
     Prefer the bundled copy when present on disk (works in a `pip install`
     and a dev checkout); fall back to the repo path for dev checkouts
@@ -64,7 +64,7 @@ def _bundled_or_repo(name: str) -> Path:
     bundled = PACKAGE_ROOT.parent / "_data" / name
     if bundled.exists():
         return bundled
-    return REPO_ROOT / "docs" / "contracts" / name
+    return REPO_ROOT / "contracts" / name
 
 
 def _read_bundled(name: str) -> str:
@@ -73,7 +73,7 @@ def _read_bundled(name: str) -> str:
     Resolution order:
       1. `<package>/_data/<name>` via `importlib.resources` — works for
          filesystem installs AND inside a `zipapp` archive.
-      2. `<repo>/docs/contracts/<name>` — dev fallback for source trees
+      2. `<repo>/contracts/<name>` — dev fallback for source trees
          whose `_data/` hasn't been populated.
     """
     try:
@@ -84,7 +84,7 @@ def _read_bundled(name: str) -> str:
             return resource.read_text(encoding="utf-8")
     except (FileNotFoundError, ModuleNotFoundError):
         pass
-    return (REPO_ROOT / "docs" / "contracts" / name).read_text(encoding="utf-8")
+    return (REPO_ROOT / "contracts" / name).read_text(encoding="utf-8")
 
 
 CONTRACT_PATH = _bundled_or_repo("adapter.toml")

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/self_host.py

@@ -357,11 +357,11 @@ EXCLUDED_PATTERNS: tuple[str, ...] = (
     "docs/specs/*/plan.md",
     "docs/specs/*/state.json",
     "docs/specs/*/notes/**",
-    "docs/contracts/**",
+    "contracts/**",
     "docs/architecture/*.md",
     "docs/product/*.md",
     "docs/knowledge/*.md",
-    "docs/guides/**/*.md",
+    "guides/**/*.md",
     # Seeded-once / adopter-curated files (RFC-0002 Manual semantics).
     "workspace.toml",  # RFC-0069: seeded once; adopter-curated thereafter
     # Manual seed-projected paths (RFC-0002 amendment 2026-05-25). The
@@ -445,7 +445,7 @@ _EXCLUDED_REGEXES: tuple[re.Pattern[str], ...] = tuple(
 # → Manual; this allow-list shrank to one entry (`docs/CONVENTIONS.md`)
 # accordingly. The reclassified paths now fall through to
 # EXCLUDED_PATTERNS coverage (`docs/architecture/*.md`,
-# `docs/product/*.md`, `docs/knowledge/*.md`, `docs/guides/**/*.md`,
+# `docs/product/*.md`, `docs/knowledge/*.md`, `guides/**/*.md`,
 # and the 8 explicit additions listed above). See RFC-0002 §
 # Amendments § 2026-05-25.
 PROJECTED_README_OVERRIDES: tuple[str, ...] = (
@@ -538,8 +538,8 @@ def _project_seeds(packs_dir: Path, output_root: Path) -> dict[Path, Path]:
         # by-quadrant guide tree here: the seed stays by-quadrant for
         # adopters, but writing it during self-host litters a repo that
         # owns its guides (e.g. organized by pack) with untracked
-        # `docs/guides/<quadrant>/README.md` on every build-self run.
-        if relative.as_posix().startswith("docs/guides/"):
+        # `guides/<quadrant>/README.md` on every build-self run.
+        if relative.as_posix().startswith("guides/"):
             continue
         if _is_excluded(relative) and (output_root / relative).exists():
             # Manual file on disk — leave it alone. The seed is

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_claude_code.py

@@ -11,7 +11,7 @@ from agentbundle.build.adapters.claude_code import project, project_packs
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_pack(root: Path) -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_codex.py

@@ -19,7 +19,7 @@ from agentbundle.build.adapters.codex import (
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_pack(root: Path, name: str = "pack", skill_prefix: str = "") -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_copilot.py

@@ -10,7 +10,7 @@ from agentbundle.build.adapters.copilot import project
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_pack(root: Path) -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_cursor.py

@@ -21,7 +21,7 @@ from agentbundle.build.contract import load as load_contract
 from agentbundle.scope import contract_version_at_least
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_agent(pack: Path, name: str, *, tools: str | None, model: str | None = None) -> None:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_gemini.py

@@ -25,7 +25,7 @@ from agentbundle.build.projections.gemini_command_toml import (
 )
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 _COMMAND_RULE = {"target-path": ".gemini/commands/"}
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_kiro.py

@@ -13,7 +13,7 @@ from agentbundle.build.adapters.kiro import project, project_packs
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_pack(root: Path) -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_kiro_alias.py

@@ -17,7 +17,7 @@ from agentbundle.build.adapters import ADAPTERS, kiro_ide
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_pack(root: Path) -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_kiro_cli.py

@@ -17,7 +17,7 @@ from agentbundle.build.adapters.kiro_cli import project
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_agent_pack(root: Path, tools: str = "Read, Grep, Glob, Bash") -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_adapter_kiro_ide.py

@@ -16,7 +16,7 @@ from agentbundle.build.adapters.kiro_ide import project
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_agent_pack(root: Path, tools: str = "Read, Grep", model: str | None = None) -> Path:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_architect_design_reviewer_projection.py

@@ -23,7 +23,7 @@ from agentbundle.build.adapters import ADAPTERS
 from agentbundle.build.contract import load as load_contract
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 ARCHITECT_PACK = REPO_ROOT / "packs" / "architect"
 AGENT_NAME = "design-reviewer"
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_contract.py

@@ -27,8 +27,8 @@ import unittest
 from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
-SCHEMA_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.schema.json"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
+SCHEMA_PATH = REPO_ROOT / "contracts" / "adapter.schema.json"
 
 # All seven RFC-0001 projection modes.
 SEVEN_RFC_MODES = {
@@ -584,7 +584,7 @@ class TestCodexSkillDirectDirectory(unittest.TestCase):
     AC1: Codex `skill` is `direct-directory` projecting to
          `.agents/skills/` with `on-conflict = "prompt-then-preserve"`;
          no managed-block delimiter keys remain on the entry.
-    AC2: `docs/contracts/adapter.toml` and the bundled `_data/adapter.toml`
+    AC2: `contracts/adapter.toml` and the bundled `_data/adapter.toml`
          are byte-identical.
     AC15: The seed AGENTS.md no longer carries the legacy delimiter pair.
     """

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_contract_scope.py

@@ -20,8 +20,8 @@ import unittest
 from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
-SCHEMA_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.schema.json"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
+SCHEMA_PATH = REPO_ROOT / "contracts" / "adapter.schema.json"
 
 
 def _load_schema() -> dict:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_contract_v07.py

@@ -5,7 +5,7 @@ Verifies the T1 edits landed:
 
   - ``[contract] version == "0.7"`` in both the runtime data file
     (`_data/adapter.toml`) and the docs mirror
-    (`docs/contracts/adapter.toml`). The two files must stay byte-
+    (`contracts/adapter.toml`). The two files must stay byte-
     aligned per the v0.3-schema sync test; this module pins the
     version on both as belt-and-braces (AC1 for both RFCs).
   - **RFC-0012 surface:**
@@ -39,7 +39,7 @@ REPO_ROOT = Path(__file__).resolve().parents[5]
 DATA_CONTRACT_PATH = (
     REPO_ROOT / "packages" / "agentbundle" / "agentbundle" / "_data" / "adapter.toml"
 )
-DOCS_CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+DOCS_CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 DATA_SCHEMA_PATH = (
     REPO_ROOT
     / "packages"

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_contract_v08.py

@@ -35,7 +35,7 @@ REPO_ROOT = Path(__file__).resolve().parents[5]
 DATA_CONTRACT_PATH = (
     REPO_ROOT / "packages" / "agentbundle" / "agentbundle" / "_data" / "adapter.toml"
 )
-DOCS_CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+DOCS_CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 DATA_SCHEMA_PATH = (
     REPO_ROOT
     / "packages"

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_end_to_end_build.py

@@ -139,7 +139,7 @@ class CheckCommandTests(unittest.TestCase):
             from agentbundle.build.self_host import run_self_host
 
             contract = load_contract(
-                REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+                REPO_ROOT / "contracts" / "adapter.toml"
             )
             # Pre-seed using the self-host runner so the working
             # tree exactly matches what `make build-check` will render

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_lint_agents_md_diataxis_block.py

@@ -1,8 +1,8 @@
 """`tools/lint-agents-md.py` check #8 — the Diátaxis-structure block.
 
 After the per-pack guide migration (ADR-0020) the four Diátaxis quadrant
-directories may live either at the top level (`docs/guides/<quadrant>/`, the
-by-quadrant scaffold an adopter installs) or under `docs/guides/_shared/`
+directories may live either at the top level (`guides/<quadrant>/`, the
+by-quadrant scaffold an adopter installs) or under `guides/_shared/`
 (the per-pack layout this catalogue uses). The check passes in *either*
 layout and fails only when a quadrant name resolves to neither.
 
@@ -36,8 +36,7 @@ _MISSING_SUBSTR = "is missing Diátaxis subdirectories"
 def _seed_common(root: Path) -> None:
     (root / "AGENTS.md").write_text("# AGENTS.md\n", encoding="utf-8")
     (root / "CLAUDE.md").symlink_to("AGENTS.md")
-    (root / "docs").mkdir(parents=True, exist_ok=True)
-    (root / "docs" / "guides").mkdir(parents=True, exist_ok=True)
+    (root / "guides").mkdir(parents=True, exist_ok=True)
 
 
 def _make_quadrants(base: Path) -> None:
@@ -63,7 +62,7 @@ class DiataxisBlockTests(unittest.TestCase):
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
             _seed_common(root)
-            _make_quadrants(root / "docs" / "guides")
+            _make_quadrants(root / "guides")
             result = _run_linter(root)
             self.assertIn(_OK_SUBSTR, result.stdout)
             self.assertNotIn(_MISSING_SUBSTR, result.stderr)
@@ -72,9 +71,9 @@ class DiataxisBlockTests(unittest.TestCase):
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
             _seed_common(root)
-            _make_quadrants(root / "docs" / "guides" / "_shared")
+            _make_quadrants(root / "guides" / "_shared")
             # A representative pack home, no top-level quadrant dirs.
-            (root / "docs" / "guides" / "core" / "how-to").mkdir(parents=True)
+            (root / "guides" / "core" / "how-to").mkdir(parents=True)
             result = _run_linter(root)
             self.assertIn(_OK_SUBSTR, result.stdout)
             self.assertNotIn(_MISSING_SUBSTR, result.stderr)
@@ -83,7 +82,7 @@ class DiataxisBlockTests(unittest.TestCase):
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
             _seed_common(root)
-            # docs/guides/ exists but carries no quadrant dirs in either spot.
+            # guides/ exists but carries no quadrant dirs in either spot.
             result = _run_linter(root)
             self.assertIn(_MISSING_SUBSTR, result.stderr)
             for q in QUADRANTS:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_lint_agents_md_legacy_block.py

@@ -7,7 +7,7 @@ The check fires through the linter's existing `warn(...)` closure
 
 Test shape: CLI subprocess invocation in a `tmp_path` scratch tree
 that mirrors the repo's layout (root `AGENTS.md`, `CLAUDE.md` symlink,
-synthetic `docs/contracts/adapter.toml`). The linter is run with
+synthetic `contracts/adapter.toml`). The linter is run with
 `cwd=tmp_path`; the test asserts the return code and stderr.
 """
 
@@ -54,7 +54,7 @@ def _seed_tree(
     contract_body: str,
     agents_md_body: str,
 ) -> None:
-    contracts = root / "docs" / "contracts"
+    contracts = root / "contracts"
     contracts.mkdir(parents=True)
     (contracts / "adapter.toml").write_text(contract_body, encoding="utf-8")
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_lint_packs.py

@@ -3,7 +3,7 @@ names in pack content before they reach a release artefact.
 
 Also covers the per-target metadata gate landed under
 docs/specs/lint-packs-target-vocab/: skill/agent name pattern, name
-length, and description length per docs/contracts/target-vocab.toml.
+length, and description length per contracts/target-vocab.toml.
 """
 
 from __future__ import annotations
@@ -495,7 +495,7 @@ class LintPackVocabTests(unittest.TestCase):
         both walks fail deterministically."""
         from unittest.mock import patch
         from agentbundle.build import lint_packs as lp_module
-        sentinel = Path("docs/contracts/__nonexistent_target_vocab__.toml")
+        sentinel = Path("contracts/__nonexistent_target_vocab__.toml")
         with tempfile.TemporaryDirectory() as tmp:
             packs_dir = Path(tmp) / "isolated" / "packs"
             packs_dir.mkdir(parents=True)
@@ -596,7 +596,7 @@ class LintPackVocabTests(unittest.TestCase):
             packs_dir = root / "packs"
             packs_dir.mkdir(parents=True)
             _write_minimal_pack(packs_dir / "p", name="p")
-            vocab_dir = root / "docs" / "contracts"
+            vocab_dir = root / "contracts"
             vocab_dir.mkdir(parents=True)
             (vocab_dir / "target-vocab.toml").write_text(body, encoding="utf-8")
             args = argparse.Namespace(packs_dir=str(packs_dir))
@@ -682,7 +682,7 @@ class LintPackVocabTests(unittest.TestCase):
             packs_dir = root / "packs"
             packs_dir.mkdir(parents=True)
             _write_minimal_pack(packs_dir / "p", name="p")
-            vocab_dir = root / "docs" / "contracts"
+            vocab_dir = root / "contracts"
             vocab_dir.mkdir(parents=True)
             (vocab_dir / "target-vocab.toml").write_text(
                 '[target.alpha]\nname-pattern = "^[a-z][a-z0-9-]*$"\n'

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_pack_schema.py

@@ -21,7 +21,7 @@ from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
 PACK_SCHEMA_PATH = (
-    REPO_ROOT / "docs" / "contracts" / "pack.schema.json"
+    REPO_ROOT / "contracts" / "pack.schema.json"
 )
 
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_pack_schema_install.py

@@ -32,7 +32,7 @@ import unittest
 from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-PACK_SCHEMA_PATH = REPO_ROOT / "docs" / "contracts" / "pack.schema.json"
+PACK_SCHEMA_PATH = REPO_ROOT / "contracts" / "pack.schema.json"
 
 
 def _load_schema() -> dict:

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_pipeline.py

@@ -23,7 +23,7 @@ from agentbundle.build.main import (
 )
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 FIXTURES = Path(__file__).resolve().parent / "fixtures"
 
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_plugin_manifest_schema.py

@@ -20,10 +20,10 @@ from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
 PLUGIN_MANIFEST_SCHEMA_PATH = (
-    REPO_ROOT / "docs" / "contracts" / "plugin-manifest.schema.json"
+    REPO_ROOT / "contracts" / "plugin-manifest.schema.json"
 )
 PLUGIN_MANIFEST_DERIVED_SCHEMA_PATH = (
-    REPO_ROOT / "docs" / "contracts" / "plugin-manifest.derived.schema.json"
+    REPO_ROOT / "contracts" / "plugin-manifest.derived.schema.json"
 )
 
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_projectable_subset.py

@@ -20,7 +20,7 @@ from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
 DERIVED_SCHEMA_PATH = (
-    REPO_ROOT / "docs" / "contracts" / "plugin-manifest.derived.schema.json"
+    REPO_ROOT / "contracts" / "plugin-manifest.derived.schema.json"
 )
 
 ENRICHED_TOML = """

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_security.py

@@ -21,7 +21,7 @@ from agentbundle.build.main import (
 )
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 class PathTraversalGuardTests(unittest.TestCase):

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_self_host_check.py

@@ -37,7 +37,7 @@ from agentbundle.build.self_host import (
 )
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-CONTRACT_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.toml"
+CONTRACT_PATH = REPO_ROOT / "contracts" / "adapter.toml"
 
 
 def _seed_pack(root: Path, name: str = "core") -> Path:
@@ -767,7 +767,7 @@ class ExcludedGlobTests(unittest.TestCase):
         self.assertFalse(_is_excluded(Path("docs/CONVENTIONS.md")))
 
         # All 19 reclassified paths are now Excluded (either via
-        # existing `docs/<area>/*.md` patterns, the `docs/guides/**/*.md`
+        # existing `docs/<area>/*.md` patterns, the `guides/**/*.md`
         # pattern, or one of the 8 explicit additions made by the
         # amendment).
         for path in (
@@ -780,12 +780,12 @@ class ExcludedGlobTests(unittest.TestCase):
             "docs/product/README.md",
             "docs/product/roadmap.md",
             "docs/product/changelog.md",
-            # Covered by `docs/guides/**/*.md`:
-            "docs/guides/README.md",
-            "docs/guides/_shared/tutorials/README.md",
-            "docs/guides/_shared/how-to/README.md",
-            "docs/guides/_shared/reference/README.md",
-            "docs/guides/_shared/explanation/README.md",
+            # Covered by `guides/**/*.md`:
+            "guides/README.md",
+            "guides/_shared/tutorials/README.md",
+            "guides/_shared/how-to/README.md",
+            "guides/_shared/reference/README.md",
+            "guides/_shared/explanation/README.md",
             # Explicit literal additions:
             "workspace.toml",  # RFC-0069: seeded once; adopter-curated thereafter
             "docs/CHARTER.md",
@@ -964,10 +964,10 @@ class SeedProjectionTests(unittest.TestCase):
         at install, not via self-host projection. `_project_seeds`
         (self-host only) must NOT scaffold the by-quadrant guide tree:
         doing so litters a repo that owns its guides (e.g. organized by
-        pack) with untracked `docs/guides/<quadrant>/README.md` on every
+        pack) with untracked `guides/<quadrant>/README.md` on every
         build-self run. Regression for the per-pack-migration drift —
         the seed scaffold stays by-quadrant for adopters, but self-host
-        must leave the repo's own `docs/guides/` alone.
+        must leave the repo's own `guides/` alone.
         """
         from agentbundle.build.self_host import _project_seeds
 
@@ -976,8 +976,8 @@ class SeedProjectionTests(unittest.TestCase):
             packs_dir = tmp_path / "packs"
             packs_dir.mkdir()
             pack = packs_dir / "user-guide-diataxis"
-            (pack / "seeds" / "docs" / "guides" / "tutorials").mkdir(parents=True)
-            (pack / "seeds" / "docs" / "guides" / "tutorials" / "README.md").write_text(
+            (pack / "seeds" / "guides" / "tutorials").mkdir(parents=True)
+            (pack / "seeds" / "guides" / "tutorials" / "README.md").write_text(
                 "# Tutorials\n", encoding="utf-8"
             )
             (pack / "pack.toml").write_text(
@@ -985,12 +985,12 @@ class SeedProjectionTests(unittest.TestCase):
                 encoding="utf-8",
             )
             output = tmp_path / "out"
-            output.mkdir()  # No pre-existing docs/guides tree
+            output.mkdir()  # No pre-existing guides tree
 
             _project_seeds(packs_dir, output)
 
             self.assertFalse(
-                (output / "docs" / "guides" / "tutorials" / "README.md").exists(),
+                (output / "guides" / "tutorials" / "README.md").exists(),
                 "self-host projection must not scaffold by-quadrant guides",
             )
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_shared_prefix_contract.py

@@ -19,7 +19,7 @@ _DATA_COPY = (
     _REPO_ROOT
     / "packages/agentbundle/agentbundle/_data/adapter.toml"
 )
-_DOCS_COPY = _REPO_ROOT / "docs/contracts/adapter.toml"
+_DOCS_COPY = _REPO_ROOT / "contracts/adapter.toml"
 
 
 def _contract() -> dict:
@@ -103,7 +103,7 @@ class ContractMirrorTests(unittest.TestCase):
         self.assertEqual(
             _DATA_COPY.read_bytes(),
             _DOCS_COPY.read_bytes(),
-            "the _data/ and docs/contracts/ adapter.toml copies must be identical",
+            "the _data/ and contracts/ adapter.toml copies must be identical",
         )
 
 

{agentbundle-0.18.0 → agentbundle-0.20.0}/agentbundle/build/tests/test_validate.py

@@ -11,7 +11,7 @@ from pathlib import Path
 from agentbundle.build.validate import validate
 
 REPO_ROOT = Path(__file__).resolve().parents[5]
-SCHEMA_PATH = REPO_ROOT / "docs" / "contracts" / "adapter.schema.json"
+SCHEMA_PATH = REPO_ROOT / "contracts" / "adapter.schema.json"
 
 
 class TypeKeywordTests(unittest.TestCase):