agentbundle 0.53.2__tar.gz → 0.57.0__tar.gz

{agentbundle-0.53.2/agentbundle.egg-info → agentbundle-0.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.53.2
+Version: 0.57.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-Expression: Apache-2.0 OR MIT
@@ -35,6 +35,37 @@ python -m pip install agentbundle
 
 Requires Python 3.11+. Runs on macOS, Linux, and Windows.
 
+## What's new in 0.57.0
+
+`install` and `upgrade` now print the steps to move to a renamed pack when the
+catalogue renamed the one you asked for. The governance pack is now
+`repo-governance`. CLIs older than 0.57.0 print plain "not found", so the steps
+are also in the `repo-governance` pack README and the changelog.
+
+## What's new in 0.56.0
+
+`agentbundle --version` and `catalogue contracts list` now report the catalogue
+specification version. **Breaking:** `catalogue contracts list --format json`
+now prints an object, `{"catalogue_specification": "<version>", "contracts":
+[...]}`, instead of a bare array. Read the `contracts` key for the rows.
+
+## What's new in 0.55.0
+
+A new bundled contract, `catalogue-manifest.schema.json`, describes the shape
+of the release archive manifest, and `catalogue contracts list`, `show`, and
+`export` expose it. It checks shape only and is not evidence of integrity or
+origin. `catalogue verify` now rejects a boolean `schema` value in
+`catalogue-manifest.json` with `CAT-V-ARC-011`. The archive guide states what
+proves where an archive came from.
+
+## What's new in 0.54.0
+
+Every contract now loads from the copy bundled with `agentbundle`. A
+`contracts/` folder in or above a catalogue no longer overrides
+`target-vocab.toml` or `adapter.toml`, and a missing or unparsable bundled
+contract fails closed. `catalogue lint` now reports a missing pack schema as a
+`CAT-L006` error instead of a warning that skipped validation.
+
 ## What's new in 0.53.2
 
 Error messages from `install` and from `.adapt-discovery.toml` loading state

{agentbundle-0.53.2 → agentbundle-0.57.0}/README-pypi.md

@@ -14,6 +14,37 @@ python -m pip install agentbundle
 
 Requires Python 3.11+. Runs on macOS, Linux, and Windows.
 
+## What's new in 0.57.0
+
+`install` and `upgrade` now print the steps to move to a renamed pack when the
+catalogue renamed the one you asked for. The governance pack is now
+`repo-governance`. CLIs older than 0.57.0 print plain "not found", so the steps
+are also in the `repo-governance` pack README and the changelog.
+
+## What's new in 0.56.0
+
+`agentbundle --version` and `catalogue contracts list` now report the catalogue
+specification version. **Breaking:** `catalogue contracts list --format json`
+now prints an object, `{"catalogue_specification": "<version>", "contracts":
+[...]}`, instead of a bare array. Read the `contracts` key for the rows.
+
+## What's new in 0.55.0
+
+A new bundled contract, `catalogue-manifest.schema.json`, describes the shape
+of the release archive manifest, and `catalogue contracts list`, `show`, and
+`export` expose it. It checks shape only and is not evidence of integrity or
+origin. `catalogue verify` now rejects a boolean `schema` value in
+`catalogue-manifest.json` with `CAT-V-ARC-011`. The archive guide states what
+proves where an archive came from.
+
+## What's new in 0.54.0
+
+Every contract now loads from the copy bundled with `agentbundle`. A
+`contracts/` folder in or above a catalogue no longer overrides
+`target-vocab.toml` or `adapter.toml`, and a missing or unparsable bundled
+contract fails closed. `catalogue lint` now reports a missing pack schema as a
+`CAT-L006` error instead of a warning that skipped validation.
+
 ## What's new in 0.53.2
 
 Error messages from `install` and from `.adapt-discovery.toml` loading state

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/adapter.schema.json

@@ -1,4 +1,6 @@
 {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/adapter.schema.json",
   "x-spec": "docs/specs/distribution-route-contract",
   "type": "object",
   "required": ["contract", "primitive", "adapter"],

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/catalogue-index.schema.json

@@ -1,7 +1,7 @@
 {
   "x-spec": "docs/specs/catalogue-wave4-semantic-contracts-index",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "catalogue-index.schema.json",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/catalogue-index.schema.json",
   "title": "Neutral catalogue index",
   "type": "object",
   "additionalProperties": false,

agentbundle-0.57.0/agentbundle/_data/catalogue-manifest.schema.json

@@ -0,0 +1,62 @@
+{
+  "x-spec": "docs/specs/catalogue-manifest-schema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/catalogue-manifest.schema.json",
+  "title": "Catalogue archive manifest",
+  "description": "Shape of the catalogue-manifest.json that `agentbundle catalogue package` writes into a catalogue archive. This schema describes shape only. A manifest that is valid against it is neither archive verification (the archive's bytes, digests and members are checked by `agentbundle catalogue verify`) nor evidence of who published the archive. Origin is established only by `catalogue verify --sha256-file` with a sidecar, or by a signature, obtained through a separately authenticated channel. Objects stay open: extra keys are allowed. The writer also emits keys this schema does not type because the verifier does not check them: source_revision, minimum_agentbundle_version, catalogue_name, catalogue_display_name and marketplace_digest (each may be null or a string), adapter_contract_version and pack_schema_version.",
+  "type": "object",
+  "required": ["schema", "bundle", "release", "generated_at", "files", "packs"],
+  "properties": {
+    "schema": {
+      "description": "Manifest schema version, 1 or 2. The package's validator rejects an integer-valued number such as 1.0 that standard JSON Schema validators and `catalogue verify` accept.",
+      "type": "integer",
+      "enum": [1, 2]
+    },
+    "bundle": {"type": "string"},
+    "release": {"type": "string"},
+    "generated_at": {"type": "string"},
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "sha256"],
+        "properties": {
+          "path": {"type": "string"},
+          "sha256": {"type": "string"}
+        }
+      }
+    },
+    "packs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "version"],
+        "properties": {
+          "name": {"type": "string"},
+          "version": {"type": "string"},
+          "path": {"type": "string"},
+          "digest": {"type": "string"}
+        },
+        "if": {"required": ["digest"]},
+        "then": {"required": ["path"]}
+      }
+    },
+    "profiles": {
+      "type": "array",
+      "items": {
+        "if": {"type": "string"},
+        "else": {
+          "type": "object",
+          "required": ["name"],
+          "properties": {
+            "name": {"type": "string"},
+            "path": {"type": "string"},
+            "digest": {"type": "string"}
+          },
+          "if": {"required": ["digest"]},
+          "then": {"required": ["path"]}
+        }
+      }
+    }
+  }
+}

agentbundle-0.57.0/agentbundle/_data/catalogue-members.txt

@@ -0,0 +1,8 @@
+adapter.schema.json
+catalogue-index.schema.json
+catalogue-manifest.schema.json
+catalogue.schema.json
+pack.schema.json
+profile.schema.json
+skill-manifest.schema.json
+skill.schema.json

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/catalogue.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "catalogue.schema.json",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/catalogue.schema.json",
   "title": "CatalogueConfig",
   "description": "JSON Schema for catalogue.toml — ini-005 Bucket 3 configuration layer.",
   "type": "object",

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/pack.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "pack.schema.json",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/pack.schema.json",
   "title": "PackConfig",
   "description": "JSON Schema for pack.toml — pack metadata and adapter-contract configuration.",
   "type": "object",

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/profile.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "profile.schema.json",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/profile.schema.json",
   "title": "ProfileConfig",
   "description": "JSON Schema for profiles/*.toml — pack-profile install bundles.",
   "type": "object",

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/public-contracts.txt

@@ -3,6 +3,7 @@ adapter.toml
 agent-plugin-extension-namespaces.schema.json
 agent-plugin-extension-namespaces.toml
 catalogue-index.schema.json
+catalogue-manifest.schema.json
 catalogue.schema.json
 distribution-routes.schema.json
 distribution-routes.toml

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/skill-manifest.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "skill-manifest.schema.json",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/skill-manifest.schema.json",
   "type": "object",
   "required": ["id", "name", "version", "description"],
   "additionalProperties": false,

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/_data/skill.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "skill.schema.json",
+  "$id": "https://eugenelim.github.io/agent-ready-repo/docs/spec/catalogue/0.1/skill.schema.json",
   "title": "SkillFrontmatter",
   "description": "JSON Schema for SKILL.md frontmatter — the closed key set enforced by agentbundle catalogue lint --deep.",
   "type": "object",

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/build/__init__.py

@@ -19,14 +19,13 @@ Subcommands landing in later tasks (T6–T8):
 from __future__ import annotations
 
 import argparse
-import json
 import shutil
 import sys
 from pathlib import Path
 
 from agentbundle.build.contract import load as load_contract
 from agentbundle.build.lint_packs import cmd_lint_packs
-from agentbundle.build.main import _read_bundled, cmd_build
+from agentbundle.build.main import cmd_build
 from agentbundle.build.self_host import cmd_check, cmd_self
 from agentbundle.build.validate import validate as validate_instance
 
@@ -42,12 +41,15 @@ def _cmd_validate(args: argparse.Namespace) -> int:
         )
         return 1
 
+    # Imported at call time so a patch of `agentbundle.build.main._read_bundled`
+    # reaches this call.
+    from agentbundle.build.main import _load_bundled_json
+
     try:
-        schema_text = _read_bundled("adapter.schema.json")
-    except (FileNotFoundError, ModuleNotFoundError):
+        schema = _load_bundled_json("adapter.schema.json")
+    except (OSError, ValueError, ModuleNotFoundError) as exc:
         print(
-            "validate: adapter.schema.json not found in package data or "
-            "repository contracts",
+            f"validate: cannot read bundled _data/adapter.schema.json: {exc}",
             file=sys.stderr,
         )
         return 1
@@ -58,7 +60,6 @@ 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_text)
     errors = validate_instance(contract, schema)
     if errors:
         print(

{agentbundle-0.53.2 → agentbundle-0.57.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
-     `contracts/target-vocab.toml` — see
+     the bundled `_data/target-vocab.toml`.
 
 The lint is Python-only so it runs on every CI platform without
 shelling out, and it is wired into `make build` / `make build-self` /
@@ -44,11 +44,6 @@ from agentbundle.safety import PathJailError, assert_portable_name
 # their content.
 _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("contracts/target-vocab.toml")
-
 # Sentinel returned by `_extract_frontmatter_fields` when a key's
 # value position is `>`, `|`, or empty (signaling a folded / nested
 # block). The metadata checks translate this into a finding
@@ -57,7 +52,7 @@ _MULTILINE = object()
 
 
 class Constraints(NamedTuple):
-    """Strictest-cap snapshot of `contracts/target-vocab.toml`.
+    """Strictest-cap snapshot of the bundled `_data/target-vocab.toml`.
 
     `binding_targets` keys (`"description_max"`, `"name_max"`,
     `"name_pattern"`) carry the ASCII-sorted list of targets enforcing
@@ -71,53 +66,31 @@ class Constraints(NamedTuple):
     binding_targets: dict[str, list[str]]
 
 
-def _walk_up_for_vocab(start: Path) -> Path | None:
-    cursor = start.resolve()
-    while True:
-        possible = cursor / _VOCAB_RELPATH
-        if possible.is_file():
-            return possible
-        if cursor.parent == cursor:
-            return None
-        cursor = cursor.parent
-
-
-def _load_target_vocab(start: Path) -> tuple[dict | None, str | None]:
-    """Walk up from `start` looking for `contracts/target-vocab.toml`;
-    then fall back to the bundled engine copy. This keeps the gate working when
-    an adopter points `--packs-dir` at a tree outside the repo and when the
-    engine runs from an installed artifact. Returns `(vocab_dict, None)` on
-    success, `(None, err)` when both sources fail or the file is malformed."""
-    candidate = _walk_up_for_vocab(start)
-    source = str(candidate) if candidate is not None else None
-    text = candidate.read_text(encoding="utf-8") if candidate is not None else None
-    if text is None:
-        try:
-            from importlib.resources import files
+def _load_target_vocab() -> tuple[dict | None, str | None]:
+    """Load the bundled `_data/target-vocab.toml`; no other source is tried.
 
-            resource = files("agentbundle").joinpath(
-                f"_data/{_VOCAB_RELPATH.name}"
-            )
-            if resource.is_file():
-                source = str(resource)
-                text = resource.read_text(encoding="utf-8")
-        except (FileNotFoundError, ModuleNotFoundError):
-            pass
-    if text is None:
+    Returns `(vocab_dict, None)` on success, `(None, err)` when the bundled
+    copy is missing, unreadable or malformed. `err` names the file."""
+    # Imported here so a patch of `agentbundle.build.main._read_bundled`
+    # reaches this call; `agentbundle.build.main` as an attribute of the
+    # package is rebound to the CLI function.
+    from agentbundle.build.main import _read_bundled
+
+    try:
+        text = _read_bundled("target-vocab.toml")
+    except (OSError, UnicodeDecodeError) as exc:
         return None, (
-            "lint-packs: target-vocab.toml not found (walked up from "
-            f"{start} and checked bundled package data; expected "
-            f"{_VOCAB_RELPATH.as_posix()} or _data/{_VOCAB_RELPATH.name})"
+            f"lint-packs: cannot read bundled _data/target-vocab.toml: {exc}"
         )
     try:
         raw = tomllib.loads(text)
     except tomllib.TOMLDecodeError as exc:
-        return None, f"lint-packs: failed to parse {source}: {exc}"
+        return None, f"lint-packs: failed to parse _data/target-vocab.toml: {exc}"
     targets = raw.get("target")
     if not isinstance(targets, dict) or not targets:
         return None, (
-            f"lint-packs: {source} has no [target.<name>] tables — "
-            f"the metadata gate has no constraints to apply"
+            "lint-packs: _data/target-vocab.toml has no [target.<name>] tables — "
+            "the metadata gate has no constraints to apply"
         )
     return raw, None
 
@@ -499,14 +472,14 @@ def lint_pack(
         from agentbundle.build import route_lookup
         from agentbundle.build.hook_wiring_rules import claude_projection_paths
         from agentbundle.build.main import (
+            _load_bundled_toml,
             _load_distribution_route_contract,
-            _read_bundled,
         )
         from agentbundle.build.projections.plugin_hooks import compile_plugin_hooks
 
         contract_data = contract
         if contract_data is None:
-            contract_data = tomllib.loads(_read_bundled("adapter.toml"))
+            contract_data = _load_bundled_toml("adapter.toml")
         try:
             route_data = _load_distribution_route_contract()
             route_declarations = route_lookup.read_route_declarations(route_data)
@@ -597,7 +570,7 @@ def cmd_lint_packs(args: argparse.Namespace) -> int:
     if not packs_dir.exists():
         print(f"lint-packs: packs-dir not found: {packs_dir}", file=sys.stderr)
         return 1
-    vocab, err = _load_target_vocab(packs_dir)
+    vocab, err = _load_target_vocab()
     if err is not None:
         print(err, file=sys.stderr)
         print(

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/build/main.py

@@ -134,47 +134,60 @@ _AGENT_PLUGIN_SCHEMA_ANNOTATION_KEYWORDS = {
 }
 
 
-def _bundled_or_repo(name: str) -> Path:
-    """Locate a data file shipped under both `agentbundle/_data/` and
-    `<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
-    whose `_data/` hasn't been synced. Inside a `zipapp` neither path is
-    a real filesystem location — callers should use `_read_bundled` to
-    get the text content instead of trying to open the returned Path.
+def _bundled_path(name: str) -> Path:
+    """Return the path of a data file shipped under `agentbundle/_data/`.
+
+    Inside a `zipapp` the returned path is not a real filesystem location;
+    use `_read_bundled` to get the text instead of opening it.
     """
-    bundled = PACKAGE_ROOT.parent / "_data" / name
-    if bundled.exists():
-        return bundled
-    return REPO_ROOT / "contracts" / name
+    return PACKAGE_ROOT.parent / "_data" / name
 
 
 def _read_bundled(name: str) -> str:
     """Read a packaged data file, transparently handling the zipapp case.
 
-    Resolution order:
-      1. `<package>/_data/<name>` via `importlib.resources` — works for
-         filesystem installs AND inside a `zipapp` archive.
-      2. `<repo>/contracts/<name>` — dev fallback for source trees
-         whose `_data/` hasn't been populated.
+    Reads `agentbundle/_data/<name>` through `importlib.resources`, which
+    works for filesystem installs and inside a `zipapp`. A missing file
+    raises `FileNotFoundError` naming `_data/<name>`; no other source is
+    tried.
+    """
+    from importlib.resources import files
+
+    resource = files("agentbundle").joinpath(f"_data/{name}")
+    if not resource.is_file():
+        raise FileNotFoundError(f"bundled contract missing: _data/{name}")
+    return resource.read_text(encoding="utf-8")
+
+
+def _load_bundled_toml(name: str) -> dict:
+    """Parse a packaged TOML file; no other source is tried.
+
+    A missing, undecodable or unparsable copy raises `ValueError` (or
+    `FileNotFoundError` when absent) whose message names `_data/<name>`.
     """
     try:
-        from importlib.resources import files
+        return tomllib.loads(_read_bundled(name))
+    except (UnicodeDecodeError, tomllib.TOMLDecodeError) as exc:
+        raise ValueError(f"bundled contract unreadable: _data/{name}: {exc}") from exc
 
-        resource = files("agentbundle").joinpath(f"_data/{name}")
-        if resource.is_file():
-            return resource.read_text(encoding="utf-8")
-    except (FileNotFoundError, ModuleNotFoundError):
-        pass
-    return (REPO_ROOT / "contracts" / name).read_text(encoding="utf-8")
+
+def _load_bundled_json(name: str) -> Any:
+    """Parse a packaged JSON file; no other source is tried.
+
+    A missing, undecodable or unparsable copy raises `ValueError` (or
+    `FileNotFoundError` when absent) whose message names `_data/<name>`.
+    """
+    try:
+        return json.loads(_read_bundled(name))
+    except (UnicodeDecodeError, json.JSONDecodeError) as exc:
+        raise ValueError(f"bundled contract unreadable: _data/{name}: {exc}") from exc
 
 
-CONTRACT_PATH = _bundled_or_repo("adapter.toml")
-ROUTE_CONTRACT_PATH = _bundled_or_repo("distribution-routes.toml")
-ROUTE_SCHEMA_PATH = _bundled_or_repo("distribution-routes.schema.json")
-PACK_SCHEMA_PATH = _bundled_or_repo("pack.schema.json")
-PLUGIN_MANIFEST_SCHEMA_PATH = _bundled_or_repo("plugin-manifest.schema.json")
+CONTRACT_PATH = _bundled_path("adapter.toml")
+ROUTE_CONTRACT_PATH = _bundled_path("distribution-routes.toml")
+ROUTE_SCHEMA_PATH = _bundled_path("distribution-routes.schema.json")
+PACK_SCHEMA_PATH = _bundled_path("pack.schema.json")
+PLUGIN_MANIFEST_SCHEMA_PATH = _bundled_path("plugin-manifest.schema.json")
 PRIMITIVE_DIRS = ("skills", "agents", "hooks", "hook-wiring", "commands")
 
 # The canonical SessionStart hook command synthesised into each derived
@@ -274,7 +287,7 @@ def validate_derived_plugin_manifest_dict(manifest: dict, label: str = "<derived
     Call this BEFORE writing to disk so a synthesis bug does not land a
     malformed plugin.json in dist/ (Blocker-3: pre-write validation).
     """
-    schema = json.loads(_read_bundled("plugin-manifest.derived.schema.json"))
+    schema = _load_bundled_json("plugin-manifest.derived.schema.json")
     errors = validate_instance(manifest, schema)
     if errors:
         raise ValueError(
@@ -848,10 +861,8 @@ def _validate_agent_plugin_extension_schema(schema: object) -> None:
 
 def _load_agent_plugin_extension_registry() -> dict:
     """Load the bundled, closed extension allocation contract."""
-    registry = tomllib.loads(_read_bundled("agent-plugin-extension-namespaces.toml"))
-    schema = json.loads(
-        _read_bundled("agent-plugin-extension-namespaces.schema.json")
-    )
+    registry = _load_bundled_toml("agent-plugin-extension-namespaces.toml")
+    schema = _load_bundled_json("agent-plugin-extension-namespaces.schema.json")
     if validate_instance(registry, schema):
         raise ValueError("agent-plugin: extension-registry error invalid-contract")
     _validate_agent_plugin_extension_registry(registry)
@@ -863,12 +874,13 @@ def _load_agent_plugin_extension_registry() -> dict:
 
 
 def _load_agent_plugin_extension_schema(schema_path: str) -> dict:
-    """Load one active schema with stable, path-free refusal diagnostics."""
+    """Load one active schema; a refusal names only its package-relative path."""
     try:
-        schema = json.loads(_read_bundled(schema_path))
-    except (OSError, TypeError, UnicodeError, json.JSONDecodeError) as exc:
+        schema = _load_bundled_json(schema_path)
+    except (OSError, TypeError, ValueError) as exc:
         raise ValueError(
-            "agent-plugin: extension-registry error invalid-schema"
+            "agent-plugin: extension-registry error invalid-schema: "
+            f"_data/{schema_path}"
         ) from exc
     _validate_agent_plugin_extension_schema(schema)
     return schema
@@ -1039,9 +1051,7 @@ def derive_agent_plugin_manifest(
     if extensions:
         manifest["extensions"] = extensions
 
-    schema = json.loads(
-        _read_bundled("vendor/agent-plugins/1.0.0/plugin.schema.json")
-    )
+    schema = _load_bundled_json("vendor/agent-plugins/1.0.0/plugin.schema.json")
     errors = validate_instance(manifest, schema)
     if errors:
         raise _agent_plugin_error(pack_name, "manifest", "schema-invalid")
@@ -1349,9 +1359,7 @@ def _run_per_pack_agent_plugin(
             raise ValueError("agent-plugin: output error unsafe-output") from exc
 
         produced: dict[str, str] = {}
-        schema = json.loads(
-            _read_bundled("vendor/agent-plugins/1.0.0/plugin.schema.json")
-        )
+        schema = _load_bundled_json("vendor/agent-plugins/1.0.0/plugin.schema.json")
         for item in prepared:
             pack_root = route_root / item.pack_name
             _assert_under(pack_root, route_root)
@@ -1476,7 +1484,7 @@ def _resolve_distribution_route(
         try:
             behaviors = route_lookup.resolve_route_behaviors(route_contract)
         except ValueError:
-            schema = json.loads(_read_bundled("distribution-routes.schema.json"))
+            schema = _load_bundled_json("distribution-routes.schema.json")
             errors = validate_instance(route_contract, schema)
             if errors:
                 raise ValueError(
@@ -1526,7 +1534,7 @@ def _resolve_distribution_route(
                 f"adapter-projector {expected_adapter!r}"
             )
 
-    schema = json.loads(_read_bundled("distribution-routes.schema.json"))
+    schema = _load_bundled_json("distribution-routes.schema.json")
     errors = validate_instance(route_contract, schema)
     if errors:
         raise ValueError(
@@ -1581,8 +1589,8 @@ def _resolve_distribution_route(
 
 def _load_distribution_route_contract() -> dict:
     """Decode and validate the bundled distribution-route contract."""
-    route_contract = tomllib.loads(_read_bundled("distribution-routes.toml"))
-    schema = json.loads(_read_bundled("distribution-routes.schema.json"))
+    route_contract = _load_bundled_toml("distribution-routes.toml")
+    schema = _load_bundled_json("distribution-routes.schema.json")
     errors = validate_instance(route_contract, schema)
     if errors:
         raise ValueError(
@@ -1821,7 +1829,7 @@ def validate_pack_metadata(
             raise ValueError("pack metadata is unsafe") from exc
     else:
         metadata = tomllib.loads(pack_toml_path.read_text(encoding="utf-8"))
-    schema = json.loads(_read_bundled("pack.schema.json"))
+    schema = _load_bundled_json("pack.schema.json")
     errors = validate_instance(metadata, schema)
     if errors:
         raise ValueError(
@@ -1833,7 +1841,7 @@ def validate_pack_metadata(
 def validate_plugin_manifest(plugin_json_path: Path) -> None:
     """Validate a per-pack .claude-plugin/plugin.json against schema."""
     manifest = json.loads(plugin_json_path.read_text(encoding="utf-8"))
-    schema = json.loads(_read_bundled("plugin-manifest.schema.json"))
+    schema = _load_bundled_json("plugin-manifest.schema.json")
     errors = validate_instance(manifest, schema)
     if errors:
         raise ValueError(
@@ -2622,7 +2630,7 @@ def run_default_build(
 ) -> list[dict]:
     """Run the bundled route-bearing recipes used by plain `make build`."""
     if contract is None:
-        contract = tomllib.loads(_read_bundled("adapter.toml"))
+        contract = _load_bundled_toml("adapter.toml")
     route_contract = _load_distribution_route_contract()
     behaviors = route_lookup.resolve_route_behaviors(route_contract)
     recipes = [load_recipe(recipe_name) for recipe_name in default_recipes()]
@@ -2660,7 +2668,7 @@ def cmd_build(args) -> int:
     output_dir = Path(args.output_dir).resolve()
     packs_dir = Path(args.packs_dir).resolve()
     try:
-        contract = tomllib.loads(_read_bundled("adapter.toml"))
+        contract = _load_bundled_toml("adapter.toml")
         route_contract = _load_distribution_route_contract()
     except Exception as exc:
         print(f"build: failed to load contract: {exc}", file=sys.stderr)

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/build/recipes/self-host.toml

@@ -23,7 +23,7 @@ targets = ["claude-code", "codex"]
 # advertised via `marketplace.json` but their primitives don't belong in this
 # repo's `.claude/skills/` tree; `monorepo-extras` is repo-only by metadata but
 # the bundle is not a canonical `new-package` consumer, so it's left out too.
-include = ["core", "governance-extras", "product-documentation", "catalogue-curation"]
+include = ["core", "repo-governance", "product-documentation", "catalogue-curation"]
 
 [recipe.iterate]
 over = "packs/*/"

{agentbundle-0.53.2 → agentbundle-0.57.0}/agentbundle/build/self_host.py

@@ -315,7 +315,7 @@ TARGET_PATHS = (
 _DEFAULT_SELF_HOST_ADAPTERS: tuple[str, ...] = ("claude-code", "codex")
 _DEFAULT_SELF_HOST_PACKS: tuple[str, ...] = (
     "core",
-    "governance-extras",
+    "repo-governance",
     "product-documentation",
     "user-guide-diataxis",
 )