agentbundle 0.19.0__tar.gz → 0.20.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.19.0
+Version: 0.20.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
@@ -34,6 +34,8 @@ Requires-Dist: pyyaml>=6.0; extra == "lint"
 pip install agentbundle
 ```
 
+Requires Python 3.11+. Runs on macOS, Linux, and Windows.
+
 **Install into a repo** — so everyone who clones it gets the pack. `core` is the flagship pack, the loop itself:
 
 ```bash

{agentbundle-0.19.0 → agentbundle-0.20.1}/README.md

@@ -12,6 +12,8 @@
 pip install agentbundle
 ```
 
+Requires Python 3.11+. Runs on macOS, Linux, and Windows.
+
 **Install into a repo** — so everyone who clones it gets the pack. `core` is the flagship pack, the loop itself:
 
 ```bash

{agentbundle-0.19.0 → agentbundle-0.20.1}/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.1}/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",
@@ -913,6 +936,13 @@ def _normalise_path_separators(args: argparse.Namespace) -> None:
 
 
 def main(argv: Sequence[str] | None = None) -> int:
+    # Windows cp1252 consoles can't represent non-ASCII chars (⚠, →, etc.).
+    # Reconfigure to UTF-8 with backslash-escape fallback so the process
+    # never crashes on non-ASCII output regardless of console code page.
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="backslashreplace")
+    if hasattr(sys.stderr, "reconfigure"):
+        sys.stderr.reconfigure(encoding="utf-8", errors="backslashreplace")
     parser = _build_parser()
     args = parser.parse_args(argv)
     if not getattr(args, "func", None):

{agentbundle-0.19.0 → agentbundle-0.20.1}/agentbundle/commands/_common.py

@@ -100,13 +100,21 @@ def _classify_seeds(seeds_dir: Path, root: Path) -> list[SeedDelivery]:
     from agentbundle import safety
 
     footer_path = seeds_dir / "_agents-footer.md"
-    footer_ok = footer_path.is_file() and not footer_path.is_symlink()
+    try:
+        footer_is_symlink = footer_path.is_symlink()
+    except OSError:
+        footer_is_symlink = True  # can't determine; skip conservatively
+    footer_ok = footer_path.is_file() and not footer_is_symlink
 
     seed_files: list[Path] = []
     for dirpath, _dirnames, filenames in os.walk(seeds_dir, followlinks=False):
         for fname in filenames:
             fpath = Path(dirpath) / fname
-            if fpath.is_symlink():
+            try:
+                fpath_is_symlink = fpath.is_symlink()
+            except OSError:
+                fpath_is_symlink = True  # can't determine; skip conservatively
+            if fpath_is_symlink:
                 continue
             seed_files.append(fpath)
 

agentbundle-0.20.1/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.1}/agentbundle/commands/install.py

@@ -1648,7 +1648,11 @@ def _deliver_user_scope_floor(
     # Reject a symlinked primitive dir itself (os.walk(top=symlink) enumerates
     # the link target's real files, which the per-entry is_symlink() skip below
     # would not catch) — see collect_pack_root_bins for the bin/ twin.
-    has_lib = lib_src_root.is_dir() and not lib_src_root.is_symlink()
+    try:
+        lib_src_is_symlink = lib_src_root.is_symlink()
+    except OSError:
+        lib_src_is_symlink = True  # can't determine; skip conservatively
+    has_lib = lib_src_root.is_dir() and not lib_src_is_symlink
     if not bin_sources and not has_lib:
         # No floor content in this pack — nothing to deliver, and no reason to
         # gate the install on the floor dirs' modes.
@@ -1686,7 +1690,11 @@ def _deliver_user_scope_floor(
             )
             for fname in sorted(filenames):
                 src = Path(dirpath) / fname
-                if src.is_symlink():
+                try:
+                    src_is_symlink = src.is_symlink()
+                except OSError:
+                    src_is_symlink = True  # can't determine; skip conservatively
+                if src_is_symlink:
                     continue
                 rel = src.relative_to(lib_src_root)
                 relpath = (Path(".agentbundle") / "lib" / rel).as_posix()

{agentbundle-0.19.0 → agentbundle-0.20.1}/agentbundle/source_defaults.py

@@ -294,7 +294,11 @@ def _enclosing_git_root(start: Path) -> Path | None:
     """
     cur = start
     while True:
-        if (cur / ".git").exists():
+        try:
+            exists = (cur / ".git").exists()
+        except OSError:
+            exists = False
+        if exists:
             return cur
         if cur.parent == cur:
             return None
@@ -354,7 +358,12 @@ def _detect_editable_source(dist: object, *, stream: TextIO | None = None) -> st
         return None
     if parts.netloc not in ("", "localhost"):
         return None
-    pkg_path = Path(url2pathname(unquote(parts.path)))
+    raw = url2pathname(unquote(parts.path))
+    # url2pathname on some Windows Python builds returns "/C:\path" with a
+    # spurious leading slash before the drive letter; strip it.
+    if sys.platform == "win32" and len(raw) >= 3 and raw[0] == "/" and raw[2] == ":":
+        raw = raw[1:]
+    pkg_path = Path(raw)
     try:
         pkg_root = pkg_path.resolve(strict=True)
     except OSError:

{agentbundle-0.19.0 → agentbundle-0.20.1}/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.1"
 
 _HERE = Path(__file__).resolve().parent
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.19.0
+Version: 0.20.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
@@ -34,6 +34,8 @@ Requires-Dist: pyyaml>=6.0; extra == "lint"
 pip install agentbundle
 ```
 
+Requires Python 3.11+. Runs on macOS, Linux, and Windows.
+
 **Install into a repo** — so everyone who clones it gets the pack. `core` is the flagship pack, the loop itself:
 
 ```bash

{agentbundle-0.19.0 → agentbundle-0.20.1}/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.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentbundle"
-version = "0.19.0"
+version = "0.20.1"
 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 = []