agentbundle 0.2.0__py3-none-any.whl

agentbundle/_data/pack.schema.json

@@ -0,0 +1,152 @@
+{
+  "type": "object",
+  "required": ["pack"],
+  "properties": {
+    "pack": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": {"type": "string"},
+        "version": {"type": "string"},
+        "description": {"type": "string"},
+        "adapter-contract": {
+          "type": "object",
+          "properties": {
+            "version": {"type": "string"}
+          }
+        },
+        "recipes": {
+          "type": "array",
+          "items": {"type": "string"}
+        },
+        "dependencies": {
+          "type": "object",
+          "properties": {
+            "required": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["catalogue", "pack", "version"],
+                "properties": {
+                  "catalogue": {"type": "string"},
+                  "pack": {"type": "string"},
+                  "version": {"type": "string"}
+                }
+              }
+            },
+            "recommended": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["catalogue", "pack", "version"],
+                "properties": {
+                  "catalogue": {"type": "string"},
+                  "pack": {"type": "string"},
+                  "version": {"type": "string"}
+                }
+              }
+            },
+            "conflicts": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["catalogue", "pack", "version"],
+                "properties": {
+                  "catalogue": {"type": "string"},
+                  "pack": {"type": "string"},
+                  "version": {"type": "string"}
+                }
+              }
+            }
+          }
+        },
+        "adaptation": {
+          "type": "object",
+          "properties": {
+            "infer-from": {"type": "string"},
+            "substitutions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "marker": {"type": "string"},
+                  "infer-from": {"type": "string"}
+                }
+              }
+            },
+            "augmentation-points": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "target": {"type": "string"},
+                  "section-marker": {"type": "string"},
+                  "describe": {"type": "string"}
+                }
+              }
+            }
+          }
+        },
+        "seeds": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[^/].*"
+          }
+        }
+      },
+      "if": {
+        "properties": {
+          "adapter-contract": {
+            "type": "object",
+            "properties": {"version": {"enum": ["0.2", "0.3", "0.6"]}},
+            "required": ["version"]
+          }
+        },
+        "required": ["adapter-contract"]
+      },
+      "then": {
+        "required": ["install"],
+        "properties": {
+          "install": {
+            "type": "object",
+            "required": ["default-scope"],
+            "properties": {
+              "default-scope": {"enum": ["repo", "user"]},
+              "allowed-scopes": {
+                "type": "array",
+                "minItems": 1,
+                "items": {"enum": ["repo", "user"]}
+              },
+              "user-scope-hooks": {"type": "boolean"},
+              "allowed-adapters": {
+                "type": "array",
+                "minItems": 1,
+                "uniqueItems": true,
+                "items": {"type": "string"}
+              }
+            },
+            "if": {
+              "properties": {"default-scope": {"enum": ["user"]}},
+              "required": ["default-scope"]
+            },
+            "then": {
+              "properties": {
+                "allowed-scopes": {
+                  "contains": {"enum": ["user"]}
+                }
+              }
+            },
+            "else": {
+              "properties": {
+                "allowed-scopes": {
+                  "contains": {"enum": ["repo"]}
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

agentbundle/_data/plugin-manifest.derived.schema.json

@@ -0,0 +1,33 @@
+{
+  "type": "object",
+  "required": ["name", "version", "description"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {"type": "string"},
+    "version": {"type": "string"},
+    "description": {"type": "string"},
+    "skills": {
+      "type": "array",
+      "items": {"type": "string"}
+    },
+    "agents": {
+      "type": "array",
+      "items": {"type": "string"}
+    },
+    "hooks": {
+      "type": "object",
+      "properties": {
+        "SessionStart": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["command"],
+            "properties": {
+              "command": {"type": "string"}
+            }
+          }
+        }
+      }
+    }
+  }
+}

agentbundle/_data/plugin-manifest.schema.json

@@ -0,0 +1,18 @@
+{
+  "type": "object",
+  "required": ["name", "version", "description"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {"type": "string"},
+    "version": {"type": "string"},
+    "description": {"type": "string"},
+    "skills": {
+      "type": "array",
+      "items": {"type": "string"}
+    },
+    "agents": {
+      "type": "array",
+      "items": {"type": "string"}
+    }
+  }
+}

agentbundle/build/__init__.py

@@ -0,0 +1,206 @@
+"""Build pipeline: adapter contract, reference adapters, recipes, self-host gate.
+
+`main` is the CLI entrypoint — `python -m agentbundle.build` and the
+`tools/build/build.py` shim both call it. Sibling specs (self-hosting,
+RFC-0003's CLI) import `agentbundle.build` as a library; the public
+surface is `main`, `validate.validate`, and the adapter `project`
+functions exposed through `adapters`.
+
+Subcommands landed in T1a:
+  - `validate <path>` — load a TOML contract and check it against
+    adapter.schema.json. Exit 0 on valid; 1 on invalid with a one-line stderr
+    message.
+
+Subcommands landing in later tasks (T6–T8):
+  - `build` (default) + `--recipe`, `--self`, `--dry-run`, `--check`,
+    `--force`, `--scaffold`, `PACK=`, `RECIPE=`.
+"""
+
+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.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.self_host import cmd_check, cmd_self
+
+__all__ = ["main"]
+
+
+def _cmd_validate(args: argparse.Namespace) -> int:
+    contract_path = Path(args.path)
+    if not contract_path.exists():
+        print(
+            f"validate: contract file not found at {contract_path}",
+            file=sys.stderr,
+        )
+        return 1
+
+    schema_path = (
+        Path(__file__).resolve().parent.parent.parent.parent.parent
+        / "docs"
+        / "contracts"
+        / "adapter.schema.json"
+    )
+    if not schema_path.exists():
+        print(
+            f"validate: adapter.schema.json not found at {schema_path}",
+            file=sys.stderr,
+        )
+        return 1
+
+    try:
+        contract = load_contract(contract_path)
+    except Exception as exc:
+        print(f"validate: failed to load {contract_path}: {exc}", file=sys.stderr)
+        return 1
+
+    schema = json.loads(schema_path.read_text(encoding="utf-8"))
+    errors = validate_instance(contract, schema)
+    if errors:
+        print(
+            f"validate: {contract_path} failed schema validation:",
+            file=sys.stderr,
+        )
+        for error in errors:
+            print(f"  {error}", file=sys.stderr)
+        return 1
+
+    return 0
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="agentbundle.build",
+        description="Build pipeline for the agent-ready-repo catalogue.",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+
+    validate_parser = subparsers.add_parser(
+        "validate",
+        help="Validate a TOML file against the adapter-contract schema.",
+    )
+    validate_parser.add_argument(
+        "path",
+        help="path to adapter.toml (or any TOML file the schema accepts)",
+    )
+    validate_parser.set_defaults(func=_cmd_validate)
+
+    build_parser = subparsers.add_parser(
+        "build",
+        help="Run a recipe (or the three RFC-0001 default recipes).",
+    )
+    build_parser.add_argument(
+        "--recipe",
+        help="Recipe name (under build/recipes/) or explicit .toml path.",
+    )
+    build_parser.add_argument("--pack", help="Limit to one pack by name.")
+    build_parser.add_argument(
+        "--packs-dir",
+        default="packs",
+        help="Directory containing pack subdirectories (default: packs/).",
+    )
+    build_parser.add_argument(
+        "--output-dir",
+        default="dist",
+        help="Where to write build artefacts (default: dist/).",
+    )
+    build_parser.set_defaults(func=cmd_build)
+
+    self_parser = subparsers.add_parser(
+        "self",
+        help="Self-host build: render into the working tree (--dry-run for diff).",
+    )
+    self_parser.add_argument("--dry-run", action="store_true")
+    self_parser.add_argument("--force", action="store_true")
+    self_parser.add_argument("--packs-dir", default="packs")
+    self_parser.add_argument("--output-dir", default=".")
+    self_parser.add_argument(
+        "--no-symlink",
+        action="store_true",
+        help=(
+            "Write CLAUDE.md as a regular-file copy of AGENTS.md instead of "
+            "a symlink. Default behaviour on Windows hosts; available on any "
+            "OS for filesystems or workflows that disallow symlinks."
+        ),
+    )
+    self_parser.set_defaults(func=cmd_self)
+
+    check_parser = subparsers.add_parser(
+        "check",
+        help="Strict self-host dry-run; non-zero on any drift.",
+    )
+    check_parser.add_argument("--packs-dir", default="packs")
+    check_parser.add_argument("--output-dir", default=".")
+    check_parser.add_argument(
+        "--no-symlink",
+        action="store_true",
+        help=(
+            "As `self --no-symlink`: compare the projection against a "
+            "regular-file CLAUDE.md copy rather than a symlink."
+        ),
+    )
+    check_parser.set_defaults(func=cmd_check)
+
+    scaffold_parser = subparsers.add_parser(
+        "scaffold",
+        help="Drop a pack's seeds/ into the named output directory.",
+    )
+    scaffold_parser.add_argument("--packs-dir", default="packs")
+    scaffold_parser.add_argument("--pack", default="core")
+    scaffold_parser.add_argument("--output", required=True)
+    scaffold_parser.set_defaults(func=_cmd_scaffold)
+
+    lint_packs_parser = subparsers.add_parser(
+        "lint-packs",
+        help=(
+            "Windows-portability lint: reject packs that ship symlinks "
+            "or Windows-poisonous names under seeds/ or .apm/."
+        ),
+    )
+    lint_packs_parser.add_argument("--packs-dir", default="packs")
+    lint_packs_parser.set_defaults(func=cmd_lint_packs)
+
+    return parser
+
+
+def _cmd_scaffold(args) -> int:
+    pack_seeds = Path(args.packs_dir) / args.pack / "seeds"
+    output = Path(args.output)
+    if not pack_seeds.exists():
+        print(f"scaffold: no seeds/ in pack {args.pack!r}", file=sys.stderr)
+        return 1
+    output.mkdir(parents=True, exist_ok=True)
+    for entry in pack_seeds.iterdir():
+        destination = output / entry.name
+        if entry.is_dir():
+            if destination.exists():
+                shutil.rmtree(destination)
+            shutil.copytree(entry, destination)
+        else:
+            shutil.copy2(entry, destination)
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    # Lazy import: keeps the helper resolved at the call site so a
+    # future split between `agentbundle.cli` and `agentbundle.build`
+    # (different distributions, different load orders) doesn't break
+    # this entry point. No circular dependency exists today and the
+    # incremental import cost is sub-millisecond; this is a
+    # call-site-locality choice, not a perf optimisation.
+    from agentbundle.cli import _normalise_path_separators
+
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+    if not getattr(args, "func", None):
+        parser.print_help()
+        return 0
+    _normalise_path_separators(args)
+    return int(args.func(args))

agentbundle/build/__main__.py

@@ -0,0 +1,8 @@
+"""`python -m agentbundle.build` entrypoint."""
+
+import sys
+
+from agentbundle.build import main
+
+if __name__ == "__main__":
+    sys.exit(main())