agentbundle 0.19.0__tar.gz → 0.20.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.19.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

{agentbundle-0.19.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.19.0 → agentbundle-0.20.0}/agentbundle/cli.py

@@ -328,6 +328,29 @@ def _build_parser() -> argparse.ArgumentParser:
     )
     sp.set_defaults(func=_lazy("show"))
 
+    # --- docs --- (catalogue query; reads packs/<pack>/docs/)
+    sp = subparsers.add_parser(
+        "docs",
+        help=(
+            "Read pack documentation from the catalogue source. "
+            "Displays index.md by default; use --list to enumerate files."
+        ),
+    )
+    sp.add_argument("pack", help="Pack name to read docs for (e.g. core).")
+    sp.add_argument(
+        "file",
+        nargs="?",
+        default=None,
+        help="Documentation file stem to display (e.g. 'concept'). Default: index.",
+    )
+    sp.add_argument(
+        "--list",
+        action="store_true",
+        dest="list_docs",
+        help="List available documentation files for the pack.",
+    )
+    sp.set_defaults(func=_lazy("docs"))
+
     # --- scaffold --- (no --scope; always repo-targeted)
     sp = subparsers.add_parser(
         "scaffold",

agentbundle-0.20.0/agentbundle/commands/docs.py

@@ -0,0 +1,117 @@
+"""``agentbundle docs <pack>`` subcommand.
+
+Display pack documentation from the pack's docs/ directory.
+
+  agentbundle docs <pack>           — display index.md
+  agentbundle docs <pack> --list    — list available .md files by stem
+  agentbundle docs <pack> <file>    — display a specific file by stem
+
+Resolution uses the same four-layer source chain as install. The docs/
+directory travels inside Artifactory archives, so this verb works across
+all four source types (local path, editable install, git+https, archive).
+
+Exit codes:
+  0  — success
+  1  — catalogue unavailable, pack not found, no docs/ directory, or file
+       not found
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import argparse
+
+_BOLD_ON = "\x1b[1m"
+_BOLD_OFF = "\x1b[0m"
+
+
+def run(args: "argparse.Namespace") -> int:
+    from agentbundle.catalogue import CatalogueError, resolve_catalogue
+    from agentbundle.commands._common import resolve_catalogue_uri
+    from agentbundle.commands.show import _find_pack_dir
+
+    pack_name: str = args.pack
+    file_stem: str | None = getattr(args, "file", None)
+    list_mode: bool = getattr(args, "list_docs", False)
+
+    try:
+        catalogue_dir = resolve_catalogue(resolve_catalogue_uri(args))
+    except CatalogueError as exc:
+        print(f"docs: {exc}", file=sys.stderr)
+        return 1
+
+    match = _find_pack_dir(catalogue_dir, pack_name)
+    if match is None:
+        print(f"docs: pack {pack_name!r} not found in catalogue", file=sys.stderr)
+        return 1
+
+    pack_dir, _ = match
+    docs_dir = pack_dir / "docs"
+    if not docs_dir.is_dir():
+        print(f"docs: {pack_name}: no docs directory in pack source", file=sys.stderr)
+        return 1
+
+    md_files = sorted(
+        p for p in docs_dir.iterdir()
+        if p.suffix == ".md" and not p.name.startswith("_")
+    )
+
+    if list_mode:
+        for f in md_files:
+            print(f.stem)
+        return 0
+
+    stem = file_stem or "index"
+    target: Path | None = None
+    for f in md_files:
+        if f.stem == stem:
+            target = f
+            break
+
+    if target is None:
+        available = ", ".join(f.stem for f in md_files) or "none"
+        print(
+            f"docs: {pack_name}: file {stem!r} not found. Available: {available}",
+            file=sys.stderr,
+        )
+        return 1
+
+    text = target.read_text(encoding="utf-8")
+    tty = sys.stdout.isatty()
+    print(_render_md(text, tty=tty), end="")
+    return 0
+
+
+def _render_md(text: str, *, tty: bool) -> str:
+    """Render Markdown as plain text, optionally with ANSI bold headings.
+
+    Preserves code blocks verbatim. Strips heading # markers (bold on tty,
+    plain text otherwise). Strips link syntax [text](url) to bare text.
+    """
+    import re
+
+    lines = text.splitlines(keepends=False)
+    out: list[str] = []
+    in_code = False
+
+    for line in lines:
+        if line.startswith("```"):
+            in_code = not in_code
+            out.append(line)
+            continue
+        if in_code:
+            out.append(line)
+            continue
+        m = re.match(r"^(#{1,6})\s+(.*)", line)
+        if m:
+            content = m.group(2)
+            out.append(f"{_BOLD_ON}{content}{_BOLD_OFF}" if tty else content)
+            continue
+        processed = re.sub(r"\[([^\]]+)\]\([^)]*\)", r"\1", line)
+        out.append(processed)
+
+    return "\n".join(out) + ("\n" if out else "")

{agentbundle-0.19.0 → agentbundle-0.20.0}/agentbundle/version.py

@@ -14,7 +14,7 @@ import tomllib
 from importlib.resources import files
 from pathlib import Path
 
-CLI_VERSION = "0.19.0"
+CLI_VERSION = "0.20.0"
 
 _HERE = Path(__file__).resolve().parent
 

{agentbundle-0.19.0 → agentbundle-0.20.0}/agentbundle.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.19.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

{agentbundle-0.19.0 → agentbundle-0.20.0}/agentbundle.egg-info/SOURCES.txt

@@ -139,6 +139,7 @@ agentbundle/commands/catalogue_tooling_stub.py
 agentbundle/commands/catalogue_verify.py
 agentbundle/commands/config.py
 agentbundle/commands/diff.py
+agentbundle/commands/docs.py
 agentbundle/commands/init_state.py
 agentbundle/commands/install.py
 agentbundle/commands/list_installed.py

{agentbundle-0.19.0 → agentbundle-0.20.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentbundle"
-version = "0.19.0"
+version = "0.20.0"
 description = "npm for your coding agent. Install packs of skills, subagents, and hooks into any repo, for every major agent."
 requires-python = ">=3.11"
 dependencies = []