agentbundle 0.53.1__tar.gz → 0.53.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.53.1
+Version: 0.53.2
 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,12 @@ python -m pip install agentbundle
 
 Requires Python 3.11+. Runs on macOS, Linux, and Windows.
 
+## What's new in 0.53.2
+
+Error messages from `install` and from `.adapt-discovery.toml` loading state
+their rule directly instead of citing internal design records. The legacy
+layout notices now say `legacy dist-tree`. Exit codes are unchanged.
+
 ## What's new in 0.53.1
 
 `agentbundle catalogue init` now writes a root `AGENTS.md` and a `CLAUDE.md`, so

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

@@ -14,6 +14,12 @@ python -m pip install agentbundle
 
 Requires Python 3.11+. Runs on macOS, Linux, and Windows.
 
+## What's new in 0.53.2
+
+Error messages from `install` and from `.adapt-discovery.toml` loading state
+their rule directly instead of citing internal design records. The legacy
+layout notices now say `legacy dist-tree`. Exit codes are unchanged.
+
 ## What's new in 0.53.1
 
 `agentbundle catalogue init` now writes a root `AGENTS.md` and a `CLAUDE.md`, so

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/_data/catalogue-scaffold/manifest.json

@@ -16,7 +16,7 @@
     "profiles/_example/README.md": "164494df049ddce3e57cb44ed604cb3d39be0a6ec2072e609ea3fa4bbfc74c72",
     "profiles/_example/profile.toml": "68af18cf50fa0327a9776b029c92bb1cf82710c649691b3ac889eb8537b8eac7",
     "tests/conformance/test_gemini_admissibility.py": "8b337da9272823aed2cb22041b3f9fd27549f075f28b9817efd5be8f8c5bb948",
-    "tests/conformance/test_pack_layout_declared_section.py": "1e03e04b995bd3f3cd2e6362c07d05514d3fe995c0fbe59045e3cc11a1e787a0",
+    "tests/conformance/test_pack_layout_declared_section.py": "48f644778a08d9460458aadb92eb1157042f9094c59f859c8d44df0a271c1256",
     "tests/conformance/test_pack_metadata.py": "8ea175b88cc6e10ba10cda87676fc225ee2b968d710c8e6ab05fb20e31ec978a",
     "tests/conformance/test_shared_library_boundaries.py": "5e07783459336e657a355f43aa5a9cf6c138603624daec258ecc0fa3d74239c3"
   },

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/_data/catalogue-scaffold/tests/conformance/test_pack_layout_declared_section.py

@@ -1,4 +1,4 @@
-"""A pack's declared layout section must be one it documents (spec AC6).
+"""A pack's declared layout section must be one it documents.
 
 `agentbundle install` appends `[<section>] output_dir = <output_dir>` to an
 adopter's `agentbundle-layout.toml`, taking both values from the pack manifest.
@@ -209,7 +209,7 @@ def test_no_pack_documents_a_crossing_of_its_own_pairs() -> None:
 
 
 def test_every_reference_doc_agrees_with_its_pack_on_the_base() -> None:
-    """AC6 admits a pair documented in *one* doc; this requires all of them.
+    """A pair documented in *one* doc is admitted; this requires all of them.
 
     A pack with several reference pages can otherwise regress one of them to a
     base the installer does not write, and stay green — the adopter reading

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/_data/install-marker.py

@@ -13,10 +13,6 @@ 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
 session-start nudge and ``/adapt-to-project`` skill can consume it.
 
-Specs:
-  docs/specs/claude-plugins-install-route/spec.md  (route = "claude-plugins")
-  docs/specs/apm-install-route-parity/spec.md      (route = "apm"; --install-route flag)
-
 CLI:
   ``--install-route {claude-plugins,apm}`` is *required*. The build pipeline bakes
   the value into the projected hook ``command`` at projection time for both routes;
@@ -604,8 +600,8 @@ def _serialise_marker(entries: list[dict]) -> str:
         lines.append(f"install-route = {_emit_basic_string(install_route)}")
         # Pass-through unresolved-markers and new-companions if present on the
         # entry. CLI-seeded entries carry both; writer-created entries omit them
-        # (the writer has no visibility into the projected primitive tree —
-        # per spec). Re-emit verbatim using _emit_basic_string so CLI-seeded
+        # (the writer has no visibility into the projected primitive tree).
+        # Re-emit verbatim using _emit_basic_string so CLI-seeded
         # queue/companion lists survive a Claude-plugins writer pass.
         if "unresolved-markers" in entry:
             markers_repr = ", ".join(
@@ -692,9 +688,10 @@ def _write_hash(plugin_data: pathlib.Path, current_hash: str) -> None:
     """Write the hash file at ``${CLAUDE_PLUGIN_DATA}/pack-manifest-hash``.
 
     Only called from ``main`` AFTER ``_write_marker`` returns successfully
-    (the write-after-success ordering is the spec's robustness rail — see
-    Boundaries §Never do). Hash-write failure is non-fatal (main allows it
-    to proceed with exit 0 + warning); the next session retries detection.
+    (write-after-success ordering, so a failed marker write is retried
+    next session instead of being masked by a fresh hash). Hash-write
+    failure is non-fatal (main allows it to proceed with exit 0 + warning);
+    the next session retries detection.
 
     Uses tempfile + os.replace for atomicity, matching the marker write rail.
     """

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/bounded_metadata.py

@@ -127,7 +127,7 @@ def _parse_frontmatter(
     except UnicodeDecodeError as exc:
         raise BoundedMetadataError(f"{label}: invalid UTF-8") from exc
     # Line endings are normalised for the PARSE ONLY. `data` is the byte string
-    # AC15 says is written to the normalized tree and fed to the digest, and it
+    # is written to the normalized tree and fed to the digest, and it
     # is untouched here — this rebinds `text`, never `data`.
     #
     # Without this, a `SKILL.md` saved with CRLF — the default of most Windows
@@ -153,8 +153,8 @@ def _parse_frontmatter(
     # after the parse — which is what this did — refuses the whole source when
     # an unrecognised key holds a value the bounded subset cannot represent:
     # `version: 1.0` refused while `version: 2` was dropped, and `version` is
-    # the second most common publisher key in the surveyed corpus. RFC-0098 E18
-    # says an unrecognised key is ignored regardless of its value type.
+    # the second most common publisher key in the surveyed corpus. The
+    # rule is that an unrecognised key is ignored regardless of its value type.
     parsed = _parse_subset(
         _strip_unrecognised_keys(raw, allowed_top_level_keys), label, limits
     )

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapter_root_bins.py

@@ -227,7 +227,7 @@ def collect_pack_root_bins(pack_dir: Path) -> dict[str, Path]:
     target into each pair. ``agentbundle install`` operates on a single
     resolved catalogue ``pack_dir`` and owns its own per-scope path-jail, so
     it needs basenames + sources for one pack, not absolute targets under a
-    build tree (credbroker-user-scope plan T4 — the install-side seam). The
+    build tree (the install-side seam). The
     install caller composes ``.agentbundle/bin/<basename>`` relpaths from
     :data:`TARGET_SUBDIR` and writes via ``safety.write_jailed`` with POSIX
     :data:`EXECUTABLE_MODE`.

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/claude_code.py

@@ -84,8 +84,8 @@ def project_packs(
 
 
 # Mirror of kiro.py:_skill_direct_directory_target — keep in sync.
-# A shared helper is barred by the spec's `Never do` boundary (no
-# expansion of projections/direct_directory.py beyond `sweep_orphans`).
+# A shared helper is deliberately avoided, so projections/direct_directory.py
+# stays limited to `sweep_orphans`.
 def _resolve_target(output_root: Path, target_path: str) -> Path:
     """Join a contract ``target-path`` onto ``output_root``, confined.
 
@@ -119,7 +119,7 @@ def _installed_skill_names(output_root: Path, target_dir: Path) -> set[str]:
     """Return skill dir names recorded in the repo state file under target_dir.
 
     Delegates to the one shared implementation so this adapter cannot
-    drift from the other six; see `_sweep_guard` for the AC28 refusal.
+    drift from the other six; see `_sweep_guard` for the unreadable-state refusal.
     """
     from agentbundle.build.adapters._sweep_guard import installed_skill_names
 
@@ -193,7 +193,7 @@ def _project_direct_directory(source_dir: Path, target_dir: Path) -> None:
             continue
         if entry.is_dir():
             destination = target_dir / entry.name
-            # Spec § Never do — `shutil.rmtree` is barred against
+            # `shutil.rmtree` is barred against
             # any entry whose `is_symlink()` is true. If a previous
             # run left a symlink at the destination path, unlink it
             # (removes the link, not the target).

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/codex.py

@@ -45,7 +45,7 @@ def _installed_skill_names(output_root: Path, target_dir: Path) -> set[str]:
     """Return skill dir names recorded in the repo state file under target_dir.
 
     Delegates to the one shared implementation so this adapter cannot
-    drift from the other six; see `_sweep_guard` for the AC28 refusal.
+    drift from the other six; see `_sweep_guard` for the unreadable-state refusal.
     """
     from agentbundle.build.adapters._sweep_guard import installed_skill_names
 
@@ -157,7 +157,7 @@ def project_packs(
                     if entry.is_dir():
                         expected_names.add(entry.name)
                         destination = target_dir / entry.name
-                        # Spec § Never do — `shutil.rmtree` is barred
+                        # `shutil.rmtree` is barred
                         # against any entry whose `is_symlink()` is
                         # true. If a previous projection left a
                         # symlink at the destination path, unlink it
@@ -173,7 +173,7 @@ def project_packs(
                             symlinks=True,
                             ignore=ignore_absolute_symlinks,
                         )
-            # Bound to `skill` only per spec § Never do. Other
+            # Orphan sweeping is bound to `skill` only. Other
             # direct-directory primitives opt in explicitly.
             if primitive_name == "skill":
                 expected_names |= _installed_skill_names(output_root, target_dir)

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/copilot.py

@@ -219,7 +219,7 @@ def _installed_skill_names(output_root: Path, target_dir: Path) -> set[str]:
     """Return skill dir names recorded in the repo state file under target_dir.
 
     Delegates to the one shared implementation so this adapter cannot
-    drift from the other six; see `_sweep_guard` for the AC28 refusal.
+    drift from the other six; see `_sweep_guard` for the unreadable-state refusal.
     """
     from agentbundle.build.adapters._sweep_guard import installed_skill_names
 

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/cursor.py

@@ -234,7 +234,7 @@ def _sweep_skill_orphans(pack_paths: list[Path], contract: dict, output_root: Pa
         for entry in source_dir.iterdir():
             if entry.is_dir():
                 expected_names.add(entry.name)
-    # AC28: this adapter previously built `expected_names` from pack
+    # This adapter previously built `expected_names` from pack
     # sources alone and had no protected set at all, so a sweep removed
     # every skill installed by `agentbundle install` into the same
     # directory. The installed set is unioned in, and an unreadable

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/gemini.py

@@ -229,7 +229,7 @@ def _sweep_skill_orphans(pack_paths: list[Path], contract: dict, output_root: Pa
         for entry in source_dir.iterdir():
             if entry.is_dir():
                 expected_names.add(entry.name)
-    # AC28: this adapter previously built `expected_names` from pack
+    # This adapter previously built `expected_names` from pack
     # sources alone and had no protected set at all, so a sweep removed
     # every skill installed by `agentbundle install` into the same
     # directory. The installed set is unioned in, and an unreadable

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/kiro.py

@@ -131,8 +131,8 @@ def project_packs(
 
 
 # Mirror of claude_code.py:_skill_direct_directory_target — keep in sync.
-# A shared helper is barred by the spec's `Never do` boundary (no
-# expansion of projections/direct_directory.py beyond `sweep_orphans`).
+# A shared helper is deliberately avoided, so projections/direct_directory.py
+# stays limited to `sweep_orphans`.
 def _skill_direct_directory_target(contract: dict, output_root: Path) -> Path | None:
     adapter_block = contract["adapter"]["kiro"]
     for entry in adapter_block.get("projection", []):
@@ -145,7 +145,7 @@ def _installed_skill_names(output_root: Path, target_dir: Path) -> set[str]:
     """Return skill dir names recorded in the repo state file under target_dir.
 
     Delegates to the one shared implementation so this adapter cannot
-    drift from the other six; see `_sweep_guard` for the AC28 refusal.
+    drift from the other six; see `_sweep_guard` for the unreadable-state refusal.
     """
     from agentbundle.build.adapters._sweep_guard import installed_skill_names
 
@@ -461,7 +461,7 @@ def _project_direct_directory(source_dir: Path, target_dir: Path) -> None:
             continue
         if entry.is_dir():
             destination = target_dir / entry.name
-            # Spec § Never do — `shutil.rmtree` is barred against
+            # `shutil.rmtree` is barred against
             # any entry whose `is_symlink()` is true. If a previous
             # run left a symlink at the destination path, unlink it.
             if destination.is_symlink():

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/adapters/kiro_ide.py

@@ -96,7 +96,7 @@ def _sweep_skill_orphans(pack_paths: list[Path], contract: dict, output_root: Pa
         for entry in source_dir.iterdir():
             if entry.is_dir():
                 expected_names.add(entry.name)
-    # AC28: this adapter previously built `expected_names` from pack
+    # This adapter previously built `expected_names` from pack
     # sources alone and had no protected set at all, so a sweep removed
     # every skill installed by `agentbundle install` into the same
     # directory. The installed set is unioned in, and an unreadable

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

@@ -254,7 +254,7 @@ def _read_install_marker_template() -> bytes:
 def _project_pack_readme(pack_path: Path, per_pack_output: Path) -> None:
     """Copy a pack's ``README.md`` into its per-pack dist route, if present.
 
-    enriched-pack-manifest T5: the README is the sole portable per-pack doc,
+    The README is the sole portable per-pack doc,
     and the manifest's ``readme = "README.md"`` pointer resolves relative to
     the route directory. A pack without a README projects none and does not
     error (the ``readme`` field is then simply absent / unresolved — never a
@@ -326,7 +326,7 @@ def derive_projectable_subset(pack_toml: dict) -> dict:
     the output only when its source field is present and non-empty, so a
     legacy ``pack.toml`` declaring none of the enriched fields yields ``{}``
     and the projected manifest is byte-identical to the pre-enrichment output
-    (legacy-invariance AC). This is a pure function — no I/O, no schema read.
+    (legacy invariance). This is a pure function — no I/O, no schema read.
     """
     pack = pack_toml.get("pack", {})
     if not isinstance(pack, dict):
@@ -1683,20 +1683,20 @@ def _discover_packs_confined(packs_dir: Path) -> list[Pack]:
 
 
 # ---------------------------------------------------------------------------
-# Claude-plugin route membership (docs/specs/claude-plugin-route-scope)
+# Claude-plugin route membership
 #
 # The route is a user-scope distribution channel: a plugin's code always lives
 # in the adopter's global cache, and `claude plugin install` defaults to
 # `--scope user`. A pack declaring `allowed-scopes = ["repo"]` therefore forbids
 # the only install this route offers, and publishing it contradicts the refusal
-# contract ADR-0002 defines. One predicate decides membership; every writer that
+# contract for scope-restricted packs. One predicate decides membership; every writer that
 # can publish calls it.
 # ---------------------------------------------------------------------------
 
 def is_publishable(pack_meta: dict, *, slug: str) -> bool:
     """Does this pack belong on the Claude-plugin route?
 
-    Three conditions, all required (spec § The derived set):
+    Three conditions, all required:
 
     1. the slug is not underscore-prefixed (reserved authoring asset);
     2. — checked by the caller, which knows whether `.claude-plugin/plugin.json`
@@ -1846,7 +1846,7 @@ def validate_pack_uniqueness(pack: Pack) -> None:
     """Raise if a pack has two primitives with the same local name.
 
     The local name is the stem for most primitives, except `hooks` where
-    `.sh` and `.py` are both legal (the spec § Hook extensions makes both
+    `.sh` and `.py` are both legal (both are
     valid in `packs/<pack>/.apm/hooks/`) — so for hooks we key by the
     full filename so `baz.sh` and `baz.py` coexist.
     """
@@ -1912,7 +1912,7 @@ def run_recipe(
 
     `aggregate_scope` is required and has no default: it decides whether a
     pack skipped on the claude-plugins route is announced. A catalogue build
-    names every exclusion (AC1); a single-pack render stays silent, because
+    names every exclusion; a single-pack render stays silent, because
     that is the flagship *successful* repo-scope path — `agentbundle install
     --pack core` — and a route refusal there reads as an error on a command
     that worked. A default would let `render_packs_to_dir` and `cmd_build
@@ -2071,7 +2071,7 @@ def _run_per_pack_adapter(context: _PerPackRouteContext) -> dict[str, Any]:
         if not pack_is_publishable(pack.path):
             # Route membership, not an error: a repo-only pack forbids the only
             # install this route offers. Named on stderr so an exclusion is
-            # never silent (spec § AC1, AC3).
+            # never silent.
             if aggregate_scope == "catalogue":
                 # Catalogue builds name every exclusion. A single-pack render —
                 # which is what `agentbundle install --pack core` and every
@@ -2274,7 +2274,7 @@ def _run_per_pack_single(
     if pack_toml_src.exists():
         shutil.copy2(pack_toml_src, per_pack_output / "pack.toml", follow_symlinks=False)
 
-    # enriched-pack-manifest T5: project the pack's README.md into the route so
+    # Project the pack's README.md into the route so
     # the manifest's `readme = "README.md"` pointer resolves. The README is the
     # sole portable per-pack doc. follow_symlinks=False mirrors the pack.toml
     # copy's posture (a symlinked README is not dereferenced into dist/).
@@ -2352,7 +2352,7 @@ def _run_per_pack_apm(
                 follow_symlinks=False,
             )
 
-        # enriched-pack-manifest T5: project the pack's README into the APM
+        # Project the pack's README into the APM
         # route too (the sole portable per-pack doc; same posture as above).
         _project_pack_readme(pack.path, per_pack_output)
 
@@ -2451,7 +2451,7 @@ def _run_aggregate(
     Membership is resolved from the **source** tree (`packs/<slug>/pack.toml`),
     never from the projected copy under `dist/`: `make build` has no dependency
     on `clean`, so a stale dist directory carries the *old* declaration and
-    would republish contrary to the pack's current intent (spec § AC4).
+    would republish contrary to the pack's current intent.
     """
     input_subdir = (
         resolved_route.output_subdir
@@ -2528,7 +2528,7 @@ def _run_aggregate(
     # Every surviving entry must agree. Taking the FIRST match let a filtered
     # set silently re-key the marketplace to whichever pack happened to sort
     # first — identity derived from pack-supplied metadata, decided by an
-    # unrelated membership change. Refuse on disagreement instead (spec AC7).
+    # unrelated membership change. Refuse on disagreement instead.
     identities: set[tuple[str, str]] = set()
     for entry in entries:
         src = entry.get("source")
@@ -2590,7 +2590,7 @@ def _run_aggregate(
     # single-pack render of a repo-only pack is a *successful* `agentbundle
     # install --pack core`, and announcing an empty marketplace there reads as
     # an error on a command that worked. Round thirteen added this warning
-    # ungated and regressed AC12's single-pack silence.
+    # ungated and regressed the single-pack silence.
     if aggregate_scope == "catalogue" and source_by_name and not entries:
         print(_empty_marketplace_warning(excluded + stale), file=sys.stderr)
     output_path.write_text(

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/projections/direct_directory.py

@@ -24,8 +24,7 @@ def ignore_absolute_symlinks(directory: str, names: list[str]) -> set[str]:
     dropping every symlink, two dropping only absolute targets — which is what
     six copies of one rule does.
 
-    The surviving policy is pass-through, because
-    `docs/specs/codex-native-skills/spec.md` states it as the invariant:
+    The surviving policy is pass-through, because the invariant is:
     "the symlink-pass-through is the path-traversal-safety invariant; never
     resolve a symlink to its target at projection time". Resolving is what
     materialises a target's bytes into the output; preserving the link does not,

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/projections/kiro_ide_hook.py

@@ -248,8 +248,8 @@ def _expand_placeholders(
 
     Refuses (defense-in-depth) on malformed or unresolvable
     placeholders even though the validate rail covered these
-    upstream. Resolved text is NOT re-scanned (RFC § Substitution
-    rules clause 3) — single pass via ``re.sub``.
+    upstream. Resolved text is NOT re-scanned, so a substituted value
+    cannot itself expand — single pass via ``re.sub``.
     """
     # Defense-in-depth check 1 — malformed placeholder.
     for match in _ANY_PLACEHOLDER_RE.finditer(command):

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/projections/merge_into_agent_json.py

@@ -128,8 +128,7 @@ def unproject(target_path: Path, owned: list[tuple[str, str]]) -> None:
 
     Empty ``hooks.<event>`` arrays are removed. The agent file itself
     is **never** removed by this function — that's the agent
-    primitive's ``direct-file`` uninstall's responsibility (the
-    § Conflict, idempotency, uninstall).
+    primitive's ``direct-file`` uninstall's responsibility.
 
     If the target file is absent, ``unproject`` is a no-op — same
     rationale as T5's ``user_merge_json.unproject``: a state row
@@ -219,8 +218,8 @@ def _shape_check_event_array(target_path: Path, event: str, value: object) -> No
 def _merge_one_entry(event_array: list, tagged_entry: dict) -> None:
     """Append or replace-in-place by id.
 
-    No adopter-collision branch: the agent JSON is pack-owned (the
-    § What this section does NOT add — no ``--force-merge`` for Kiro).
+    No adopter-collision branch: the agent JSON is pack-owned, so there is
+    no ``--force-merge`` for Kiro.
     Adopter hand-edits to the agent file are squatting on a managed
     surface; the next upgrade replaces the file via the agent
     primitive's ``direct-file`` projection.

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/projections/user_merge_json.py

@@ -17,8 +17,8 @@ three boundaries documented in the merge semantics:
 The module exposes two callables: ``project`` (install / reinstall)
 and ``unproject`` (uninstall). Both write atomically via tmp + rename.
 
-This module is stdlib-only — ``json`` + ``pathlib`` per the spec's
-*Never do — No new top-level dependency* boundary.
+This module is stdlib-only — ``json`` + ``pathlib`` — because the build
+pipeline takes no new top-level dependency.
 """
 
 from __future__ import annotations

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/scope_rails.py

@@ -64,7 +64,7 @@ _MARKER_REGEX = re.compile(rb"<adapt:(?:[A-Z_][A-Z0-9_]*|[a-z][a-z0-9-]*)>")
 # `.apm/hook-wiring/` are already user-scope-refused by Rail B, so a
 # marker check on them is unreachable. `seeds/` is already
 # user-scope-refused by Rail A, so the marker rail's input never
-# includes `seeds/`. Spec § *Install-scope dimension* pins the list.
+# includes `seeds/`. This list is fixed, not derived.
 _MARKER_RAIL_DIRS = (".apm/skills", ".apm/agents", ".apm/commands")
 
 # Cap per-file inspection size to keep Rail C bounded. A primitive file
@@ -511,8 +511,8 @@ def check_kiro_wiring(
 # ---------------------------------------------------------------------------
 # T-C2: kiro-ide-hook validate rail.
 #
-# Five refusal paths covering the validate rail
-# under § *Kiro IDE event hooks — new `kiro-ide-hook` primitive*:
+# Five refusal paths covering the validate rail for the `kiro-ide-hook`
+# primitive:
 #
 #   1. Missing required field (`name`, `version`, `when.type`,
 #      `then.type`).

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

@@ -16,9 +16,9 @@ intact under dry-run too.
 
 Marker resolution (`<adapt:NAME>` → discovery value) is the ONE place
 install-time substitution happens — every other build mode copies
-markers through unchanged (spec § Boundaries — Never do). The
+markers through unchanged. The
 `.adapt-discovery.toml` *materialisation* lives in the
-`adapt-to-project` skill, out of scope here. T7 ships only the
+`adapt-to-project` skill, out of scope here. This module ships only the
 consumer.
 
 Self-host scope:
@@ -306,10 +306,10 @@ TARGET_PATHS = (
 # so `make build-self` only projects the in-house packs;
 # `_aggregate_marketplace` applies the Claude-plugin route's publishability
 # predicate. It previously ignored the pack filter on the rationale that "the
-# catalogue advertises every pack"; docs/specs/claude-plugin-route-scope
-# overturns that. The route installs at user scope, so advertising a pack whose
-# `allowed-scopes` forbids user scope offers an install it cannot honour — and
-# once the dist branch drops the directory, the entry becomes a dangling fetch.
+# catalogue advertises every pack"; that rationale no longer holds. The route
+# installs at user scope, so advertising a pack whose `allowed-scopes` forbids
+# user scope offers an install it cannot honour — and once the dist branch
+# drops the directory, the entry becomes a dangling fetch.
 # Adapters outside this list (e.g. `kiro-ide`) are handled via the
 # `preferred_adapter` override path in `_effective_adapters`.
 _DEFAULT_SELF_HOST_ADAPTERS: tuple[str, ...] = ("claude-code", "codex")
@@ -678,7 +678,7 @@ EXCLUDED_PATTERNS: tuple[str, ...] = (
     # projection contract. Pyc files embed the absolute source path so they
     # can never be byte-identical across machines; excluding them prevents
     # false-positive drift failures when a skill script is imported or run
-    # before build-check executes. See docs/backlog.md § pycache-drift.
+    # before build-check executes.
     "**/__pycache__/**",
 )
 
@@ -765,7 +765,7 @@ def _project_seeds(
     Returns a `{relative_target → source}` map for use by the drift
     source-naming logic.
     """
-    # Two-pass design (per spec § Always do): build the full
+    # Two-pass design: build the full
     # {relative → source} map and detect collisions *before* writing
     # anything, so a collision-mid-real-write doesn't leave a partial
     # projection on disk.
@@ -791,9 +791,8 @@ def _project_seeds(
             # targets. They live in seeds so adopters can edit them;
             # the Phase-2 composite-agents-md recipe consumes them
             # by reading `packs/core/seeds/_agents-footer.md`
-            # directly. Skip standalone projection. Convention
-            # documented in ``docs/architecture/pack-layout.md`` § The source-of-truth split.
-            # split.
+            # directly. By convention a leading underscore marks a
+            # source-only partial, so it gets no standalone projection.
             if src.name.startswith("_"):
                 continue
             relative = src.relative_to(seeds_dir)
@@ -884,8 +883,7 @@ def _aggregate_marketplace(
         # marketplace add <owner>/<repo>` resolves — so it must apply the same
         # predicate as the dist writer. The prior note here said this function
         # "intentionally ignores the pack filter — the catalogue advertises
-        # every pack"; that is overturned by
-        # docs/specs/claude-plugin-route-scope: advertising a pack whose
+        # every pack"; that no longer holds: advertising a pack whose
         # allowed-scopes forbids user scope offers an install the route cannot
         # honour, and leaves a dangling fetch once the branch drops it.
         from agentbundle.build.main import pack_is_publishable
@@ -1008,7 +1006,7 @@ def _recreate_claude_symlink(output_root: Path, *, force_copy: bool = False) ->
             pass
         claude.unlink()
     elif claude.exists():
-        # Regular file at CLAUDE.md — replace with symlink per spec.
+        # Regular file at CLAUDE.md — replace it with the symlink.
         claude.unlink()
     claude.symlink_to(desired_target)
     return claude
@@ -1147,7 +1145,7 @@ def _emit_info_for_unclassified(
     `[info]` lines for paths that are neither Projected nor Excluded.
 
     Info-level — does not fail the build. Surfaces omissions so the
-    next PR can classify them (per spec § *Always do*). If the working
+    next PR can classify them. If the working
     tree is not a git repo or git is unavailable, emits a single
     warning rather than silently skipping classification — an operator
     seeing "zero info lines" should not mis-attribute it to "fully
@@ -1307,10 +1305,10 @@ def diff_against_working_tree(
 ) -> list[str]:
     """Compare every file in `shadow` against the corresponding path in
     `working_tree`. When `source_map` is provided, drift messages name
-    the source path and regeneration command per spec § *Always do*
+    the source path and regeneration command
     (`[drift] <projected>: edit <source>; run: make build-self`).
 
-    Phase-2 strengthening per the self-hosting spec:
+    Strengthened beyond a plain byte comparison:
 
     - **CRLF→LF normalisation** for text-like files (those that decode
       as UTF-8). Binary content is compared byte-for-byte. A CRLF-on-
@@ -1488,7 +1486,7 @@ def run_self_host(
     # Read `.adapt-discovery.toml` via the typed loader. Legacy
     # `[adapt]` table, unknown `discovery-schema-version`, and any
     # other invalid shape surface as `ConfigError` and refuse with
-    # the `self-host: ` prefix per spec.
+    # the `self-host: ` prefix.
     from agentbundle.config import ConfigError, load_adapt_discovery_typed
 
     try:
@@ -1576,7 +1574,7 @@ def run_self_host(
     # credentialed consumers resolve via the `credbroker`
     # pip library, not a vendored shim. The shim source survives only as
     # the adapter-root-bins companion-shim projection source (below).
-    # T6: project adapter-root-bins/ into <working_tree>/.agentbundle/bin/
+    # Project adapter-root-bins/ into <working_tree>/.agentbundle/bin/
     # with 0o755 on POSIX. Inter-pack basename collision raises
     # ValueError; surface as self-host: <msg> and exit 5.
     try:
@@ -1584,7 +1582,7 @@ def run_self_host(
     except ValueError as exc:
         print(f"self-host: {exc}", file=sys.stderr)
         return 5
-    # credbroker-user-scope T3: vendor the stdlib-base `credbroker` source
+    # Vendor the stdlib-base `credbroker` source
     # to the per-scope lib floor (`<working_tree>/.agentbundle/lib/credbroker/`)
     # and the catalogue-visible pack copy (`.apm/user-libs/credbroker/`). No-op
     # outside the monorepo (package source absent — see user_libs docstring).
@@ -2074,7 +2072,7 @@ def _refuse_fixture_packs_dir(packs_dir: Path, *, dry_run: bool) -> int | None:
     either alone:
 
     * **Components.** A `tests` component followed anywhere by a `fixtures`
-      component. RFC-0082 moved the engine suite to
+      component. The engine suite now lives at
       `tests/build_pipeline/fixtures/`, where the two are no longer adjacent;
       the original substring test missed that and failed *open*.
     * **The historical substring.** `tests/fixtures/` anywhere in the path.

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/build/validate.py

@@ -1,7 +1,7 @@
 """Stdlib-only JSON-Schema subset validator.
 
-The build pipeline depends on stdlib only (per spec § Boundaries —
-Never do), so we cannot import a JSON-Schema library. This module
+The build pipeline depends on stdlib only, so we cannot import a
+JSON-Schema library. This module
 ships this subset:
 
 Supported keywords:

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/catalogue.py

@@ -129,7 +129,7 @@ def resolve_git_ref(uri: str) -> str | None:
 
     A missing ``@<ref>`` suffix resolves to ``"main"`` — the same default
     ``_resolve_https`` fetches against, so this is the one parse both the
-    fetch and the AC-0037 pin read, rather than two parses that could
+    fetch and the pin read, rather than two parses that could
     disagree. A local path and the digest-bearing ``archive+https://`` and
     ``catalogue+https://`` schemes don't name a ref at all, so each of those
     resolves to ``None``.

{agentbundle-0.53.1 → agentbundle-0.53.2}/agentbundle/catalogue_tooling/__init__.py

@@ -3,7 +3,7 @@
 This package provides the configuration schema, result types, and command
 stubs for the agentbundle catalogue * and agentbundle lint packs CLI surface.
 
-Wave 2-4 specs fill the command logic; this package establishes the stable
+This package establishes the stable
 contract layer between all modules.
 """