agentbundle 0.29.8__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.29.8 → agentbundle-0.31.1}/PKG-INFO

@@ -1,17 +1,15 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.29.8
+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
@@ -269,7 +267,10 @@ ignore them there; the separation is structural, not incidental.
 `keywords` once; the build projects the cleanly-mappable subset — plus the
 pack's `README.md` — into each distribution route's manifest (the `plugin.json`
 / `marketplace.json` entry), so the catalogue describes each pack richly rather
-than with a single sentence. A marketplace entry's `source` is a `git-subdir`
+than with a single sentence. The Claude-plugin route carries only packs whose
+`[pack.install] allowed-scopes` admits `user`: a plugin's code lands in the
+adopter's global cache, so a repo-only pack gets no `marketplace.json` entry
+and is reached with `agentbundle install` instead. A marketplace entry's `source` is a `git-subdir`
 object (`url`, `path`, and one of `ref`/`sha`) pointing at the pack's directory
 on the published distribution branch, and every entry is schema-validated at
 build time against `marketplace-entry.schema.json`. Extra fields stay in `pack.toml`; the projection
@@ -305,13 +306,30 @@ pip install 'agentbundle[lint]'
 agentbundle catalogue lint --root . --deep
 ```
 
-**Check self-host projection drift** — verifies that adapter-projected files (skills, agents, hooks) match their `.apm/` sources without writing anything:
+**Verify a catalogue before you ship it** — runs the full read-only contract and
+self-host checks in one command:
+
+```bash
+agentbundle catalogue verify --root .
+```
+
+For a self-host-enabled catalogue with `.adapt-discovery.toml`, that includes the
+self-host classifier. It treats generated targets as projected and known
+repository-owned paths as excluded from projection. A genuinely unknown Git-visible
+path remains an informational `unclassified` notice; it does not fail an otherwise
+clean catalogue. Missing, modified, or orphaned projections do fail verification,
+including generated executables under `.agentbundle/bin/` and vendored user libraries
+under `.agentbundle/lib/`. Git filenames are read losslessly, and a failed Git listing
+is reported as a warning rather than mistaken for a fully classified inventory.
+
+To check only self-host projection drift, or to regenerate projected files locally:
 
 ```bash
 agentbundle catalogue self-host --check --root .
+agentbundle catalogue self-host --write --root .
 ```
 
-Exits non-zero if any projected file is out of date. Safe to run in CI as a required check; use `--write` locally to regenerate.
+Both check commands are safe to run in CI. The write command changes projected files.
 
 By default projects for `claude-code` and `codex`. Downstream repos that use a single adapter (e.g. `kiro-ide`) can declare it in `catalogue.toml` — only that adapter is then projected, and its output files participate in the drift check:
 

{agentbundle-0.29.8 → agentbundle-0.31.1}/README-pypi.md

@@ -247,7 +247,10 @@ ignore them there; the separation is structural, not incidental.
 `keywords` once; the build projects the cleanly-mappable subset — plus the
 pack's `README.md` — into each distribution route's manifest (the `plugin.json`
 / `marketplace.json` entry), so the catalogue describes each pack richly rather
-than with a single sentence. A marketplace entry's `source` is a `git-subdir`
+than with a single sentence. The Claude-plugin route carries only packs whose
+`[pack.install] allowed-scopes` admits `user`: a plugin's code lands in the
+adopter's global cache, so a repo-only pack gets no `marketplace.json` entry
+and is reached with `agentbundle install` instead. A marketplace entry's `source` is a `git-subdir`
 object (`url`, `path`, and one of `ref`/`sha`) pointing at the pack's directory
 on the published distribution branch, and every entry is schema-validated at
 build time against `marketplace-entry.schema.json`. Extra fields stay in `pack.toml`; the projection
@@ -283,13 +286,30 @@ pip install 'agentbundle[lint]'
 agentbundle catalogue lint --root . --deep
 ```
 
-**Check self-host projection drift** — verifies that adapter-projected files (skills, agents, hooks) match their `.apm/` sources without writing anything:
+**Verify a catalogue before you ship it** — runs the full read-only contract and
+self-host checks in one command:
+
+```bash
+agentbundle catalogue verify --root .
+```
+
+For a self-host-enabled catalogue with `.adapt-discovery.toml`, that includes the
+self-host classifier. It treats generated targets as projected and known
+repository-owned paths as excluded from projection. A genuinely unknown Git-visible
+path remains an informational `unclassified` notice; it does not fail an otherwise
+clean catalogue. Missing, modified, or orphaned projections do fail verification,
+including generated executables under `.agentbundle/bin/` and vendored user libraries
+under `.agentbundle/lib/`. Git filenames are read losslessly, and a failed Git listing
+is reported as a warning rather than mistaken for a fully classified inventory.
+
+To check only self-host projection drift, or to regenerate projected files locally:
 
 ```bash
 agentbundle catalogue self-host --check --root .
+agentbundle catalogue self-host --write --root .
 ```
 
-Exits non-zero if any projected file is out of date. Safe to run in CI as a required check; use `--write` locally to regenerate.
+Both check commands are safe to run in CI. The write command changes projected files.
 
 By default projects for `claude-code` and `codex`. Downstream repos that use a single adapter (e.g. `kiro-ide`) can declare it in `catalogue.toml` — only that adapter is then projected, and its output files participate in the drift check:
 

{agentbundle-0.29.8 → agentbundle-0.31.1}/agentbundle/_data/catalogue-scaffold/guides/_shared/reference/catalogue-authoring-standards.md

@@ -46,12 +46,31 @@ model reads to decide whether to **activate** the primitive. Length is load-bear
 there and shortening it degrades activation; per-target caps in
 `contracts/target-vocab.toml` govern it. Do not carry habits from one to the other.
 
-**Shape.** First sentence names the job the adopter accomplishes — verb-first, and
-readable on its own. An optional second sentence carries a compressed capability list
-or the one thing that distinguishes this pack. Then stop.
+**Shape.** Open on the job the adopter accomplishes, in their words. Say what they
+get. Then stop.
 
-> Supervised coding from brief to merged PR. A plan, execute, verify, review loop with
-> spec-driven development, adversarial and security reviewers, and pre-commit gates.
+Beyond that, let the pack decide the shape. Some need one sentence:
+
+> Write the OpenAPI or AsyncAPI contract before anyone writes a handler.
+
+Others earn three:
+
+> Ship it the way production will see it. Deploy to a throwaway environment, run
+> the tests, read the telemetry, and go round again until it holds. Then it stops
+> and asks, because the next step is the one you cannot undo.
+
+**Do not run every description through one mould.** An earlier pass here applied a
+single shape — verb-first sentence, then a comma-list of capabilities — to all
+22 packs. The result measured as 20 of 22 at exactly two sentences, 14 with a
+comma-list second sentence, four opening on the identical "Turn X into Y" frame.
+Every fact was right and the set still read as machine-written, because uniform
+rhythm and symmetrical construction are themselves the tell. Vary sentence count
+and length to match what each pack actually is.
+
+Reach for the concrete. A real thing the user says (`"convert this PDF to
+Markdown"`), a real artifact (`a Google-style design doc`), or a real check
+(`the empty state and the focus ring you forgot`) all beat an abstract capability
+noun.
 
 **Anti-patterns**, each of which has shipped here before:
 

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

@@ -1,18 +1,21 @@
 {
   "files": {
-    "guides/_shared/reference/catalogue-authoring-standards.md": "f5e41498139ca335b8a679644eb02d2a35abb2234a77b5b14e7ff90da02722b9",
+    "guides/_shared/reference/catalogue-authoring-standards.md": "ff4bdc203affda0a2f41641c1155b3f4e90aade022e122999a82e7093e94d2ee",
     "guides/_shared/reference/catalogue-ci-contract.md": "fae793ab47989b6dd3c731afcb0b4cda21c7d08bbe7fa40fca6d3abb3d158141",
     "packs/AGENTS.md": "9bfeda4069826e518a4f4fdae45bd40f4393c1c5aaf146149d3eb4aece30be83",
     "packs/README.md": "d2de5f9556f4c8e521103474bde74636e02cc805f9bf5312a3a61a1f3eb45d8f",
     "packs/_example/.apm/skills/example-skill/SKILL.md": "33be8cbf4b2c014a5a63e788b7d0b350ad8061c6c4b2579369a3e984135bf9f1",
     "packs/_example/.apm/skills/example-skill/evals/eval_queries.json": "f41ecda0834a22f3b4823c81ab02e58b0e4beba610e3b40c185579abff9cfeee",
-    "packs/_example/.claude-plugin/plugin.json": "d38c8456640d5e2f9296361f7e3e675e368ddd3eb22a6245267560f460155f41",
+    "packs/_example/.claude-plugin/plugin.json": "7f94084a56260eed225ec47ac82042fe9029c594557cca760a459885d03ccc26",
     "packs/_example/README.md": "ef130c9c1f97a75a07cc59fc55fc5b3bf71846dd2f06c3cddf5a1154023b6ef6",
-    "packs/_example/pack.toml": "94e2c7fd25d4d115858728c7ecb8f739adfd0f594b29596c106daba0791a4b94",
+    "packs/_example/pack.toml": "f19a0be9fca99a6a0e3ce2d5cd188bf98000f0a4f186954fb42a0c99c6859701",
     "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/packs/_example/pack.toml

@@ -0,0 +1,20 @@
+[pack]
+name            = "example-pack"
+version         = "0.1.0"
+description     = "The skeleton to copy when you start a new pack."
+display_name    = "Example Pack"
+categories      = ["productivity"]
+keywords        = ["example", "template"]
+
+[pack.adapter-contract]
+version = "0.8"
+
+[pack.install]
+default-scope    = "repo"
+allowed-scopes   = ["repo", "user"]
+
+[pack.evals]
+skills = ["example-skill"]
+
+[pack.links]
+documentation = "https://example.com/docs"

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.29.8 → agentbundle-0.31.1}/agentbundle/_data/install-marker.py

@@ -1,9 +1,13 @@
 """Canonical stdlib-only install-marker writer for the Claude-plugins and APM install routes.
 
 This script is invoked by a ``SessionStart`` hook derived by ``agentbundle build``
-into every pack's projected output:
-  - ``dist/claude-plugins/<pack>/.claude-plugin/plugin.json``  — claude-plugins route
-  - ``dist/apm/<pack>/.apm/hooks/install-marker.json``         — APM route
+into each pack's projected output:
+  - ``dist/claude-plugins/<pack>/.claude-plugin/plugin.json``  — claude-plugins
+    route, for user-capable packs only (a plugin's code lands in the adopter's
+    global cache, so a pack whose ``allowed-scopes`` omits ``user`` is not
+    projected onto this route at all)
+  - ``dist/apm/<pack>/.apm/hooks/install-marker.json``         — APM route,
+    every pack
 
 It detects first-install-or-update and writes a ``[[packs-installed]]`` entry
 to the scope-correct ``.adapt-install-marker.toml`` file so the existing core

{agentbundle-0.29.8 → 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