agent-bootstrap 0.1.0__py3-none-any.whl

agent_bootstrap-0.1.0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: agent-bootstrap
+Version: 0.1.0
+Summary: Scaffold AI-agent-ready projects from curated templates, presets, or a dirtree layout
+Author: marcelodevops
+License: MIT License
+        
+        Copyright (c) 2025 marcelodevops
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/marcelodevops/project_bootstrapper
+Project-URL: Repository, https://github.com/marcelodevops/project_bootstrapper
+Project-URL: Issues, https://github.com/marcelodevops/project_bootstrapper/issues
+Keywords: scaffold,boilerplate,ai-agents,project-template,codegen,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9
+Requires-Dist: PyGithub>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Dynamic: license-file
+
+# agent-bootstrap (`projboot`)
+
+Scaffold AI-agent-ready projects from curated language templates, customizable workflow presets, or a `tree`-style layout — locally first, with one-command GitHub repository creation.
+
+## Install
+
+```bash
+pip install agent-bootstrap          # installs both `projboot` and `agent-bootstrap`
+pip install -e ".[dev]"              # dev: + pytest for the test suite
+```
+
+Requires Python 3.11+. Local scaffolding needs no token and no network; GitHub remote creation (`-r github --create`) uses `GITHUB_TOKEN`.
+
+---
+
+## Quickstart: AI Agent Project Bootstrapping (`projboot create`)
+
+Create a new Python project pre-wired for **Claude Code** and **GitHub Copilot**, scaffolded locally and pushed to a new GitHub repository:
+
+```bash
+projboot create new-project -l python -a claude -a gh-copilot -r github --create --clone
+```
+
+Or scaffold locally with custom directories for generated outputs, helper scripts, an ordered prompts catalog, and architecture conventions (all automatically wired into `AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md`, etc.):
+
+```bash
+projboot create new-project \
+  -l python \
+  -a claude -a gh-copilot -a codeassistant \
+  --arch hexagonal \
+  --outputs-dir artifacts/out \
+  --scripts-dir hack \
+  --prompts-file docs/PROMPTS.md
+```
+
+### What `projboot create` Generates
+
+1. **Base Language Stack (`-l / --lang`)**:
+   - `python` / `python-microservice`: `src/` layout, `pyproject.toml`, `Dockerfile`, GitHub CI
+   - `typescript`: `package.json`, `tsconfig.json`, `src/index.ts`, multi-stage `Dockerfile`
+   - `helm-chart`: `Chart.yaml`, `values.yaml`, `templates/`, `helm lint` CI
+   - `rails`: Minimal Rails skeleton
+   - `none`: Minimal agent-only repo (`README.md` + `.gitignore`)
+2. **Universal Agent Harness (Always Included)**:
+   - `AGENTS.md`: Project overview, `$arch` rules, directory map (`$outputs_dir/`, `$scripts_dir/`, `$prompts_file`), and `graphify` instructions
+   - `graphify-out/`: Knowledge graph folder (automatically updated via `graphify update .` if `graphify` is installed)
+   - `.remember/`: Persistent agent memory (`MEMORY.md` & `decisions.md`, or copied from `~/.config/projboot/remember/`)
+   - `.agents/skills/`: Reusable project skills (copied from `~/.config/projboot/skills/` or starter `project-conventions/SKILL.md`)
+   - `$prompts_file` (default `PROMPTS.md`): Ordered prompt catalog
+   - `$outputs_dir/` & `$scripts_dir/` directories
+3. **Assistant Overlays (`-a / --agent`, repeatable)**:
+   - `-a claude`: `CLAUDE.md` + `.claude/settings.json`
+   - `-a gh-copilot`: `.github/copilot-instructions.md` + `.github/prompts/bootstrap.prompt.md`
+   - `-a codeassistant`: `.codeassistant/instructions.md`
+   - `-a cursor`: `.cursor/rules/project.mdc`
+
+---
+
+## Presets & Personal User Store (`~/.config/projboot/`)
+
+Initialize your personal `projboot` configuration directory (or set `PROJBOOT_HOME` to customize its path):
+
+```bash
+projboot config-init
+projboot list-presets
+```
+
+This creates:
+- `~/.config/projboot/presets.toml` — Define named presets (`default`, `clean-arch`, or your own) with default `arch`, `outputs_dir`, `scripts_dir`, `prompts_file`, and `agents`.
+- `~/.config/projboot/skills/` — Any skill files placed here are automatically copied into `.agents/skills/` and rendered with your project's `$name`, `$arch`, `$outputs_dir`, `$scripts_dir`, and `$prompts_file` variables.
+- `~/.config/projboot/remember/` — Starter memory templates copied into `.remember/` on every new project.
+
+Use a named preset with `-p / --preset`:
+
+```bash
+projboot create my-service -l python -p clean-arch
+```
+
+---
+
+## Classic Template & Dirtree Commands
+
+List available base templates:
+
+```bash
+projboot list-templates
+```
+
+Scaffold directly from a base template (without the AI agent harness):
+
+```bash
+projboot init --name my-svc --template python-microservice \
+  --description "My service" --license mit --holder "Your Name" --local
+```
+
+Override or add template variables with `--var` (repeatable):
+
+```bash
+projboot init --name demo --template typescript --var name=real-package-name --local
+```
+
+Build a layout from a `tree`-style file — directories become paths, leaf files are materialized empty:
+
+```bash
+projboot init-from-tree --name myproject --tree-file examples/tree.txt --gitkeep --local
+```
+
+`--gitkeep` drops a `.gitkeep` in empty directories so they survive; `--force` allows overwriting a non-empty local target directory.
+
+---
+
+## How Templating Works
+
+Templates render with Python's `string.Template` (`$name`, `$description`, `$year`, `$holder`, `$arch`, `$outputs_dir`, `$scripts_dir`, `$prompts_file`, plus any `--var`). This is deliberate: Helm's Go-template syntax (`{{ .Values.foo }}`) and GitHub Actions expressions (`${{ secrets.X }}`) contain no bare `$identifier`, so they pass through untouched. `str.format()` or Jinja2 would corrupt them.
+
+## Tests
+
+```bash
+pytest -q
+```
+
+The dirtree parser, template rendering, preset & user store loader, AI agent overlays, CLI (local + GitHub dispatch via mocks), and GitHub helper are all covered without any network access.

agent_bootstrap-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+agent_bootstrap-0.1.0.dist-info/licenses/LICENSE,sha256=ROTPTYx7JJRaA9YLznUjB7n3do98U_pe1HPNkpnzVsQ,1070
+bootstrapper/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+bootstrapper/__main__.py,sha256=wcCrL4PjG51r5wVKqJhcoJPTLfHW0wNbD31DrUN0MWI,28
+bootstrapper/agents.py,sha256=DRs2WrI5Ho5HM3-LWWBZ4TnvwrpBHUU5Fn0otMVHh28,5903
+bootstrapper/cli.py,sha256=-22u7Ci4Cb1EdDFYqC2v4QibjlLt3jRVSrvgdihxnuk,14202
+bootstrapper/composer.py,sha256=B7EHYFID_gvur3-MAj0tZ6pQCAjBx2KpuhAWAxtUwP8,5991
+bootstrapper/dirtree.py,sha256=Txwl_ZeLyvfCWxt-ldW2iD2YghvQmNM1cM3-q0IJARU,3667
+bootstrapper/github_utils.py,sha256=gUzUpNMJtY516B9lNKzNxA9aVThSSTtl9zReaDzrq9A,2251
+bootstrapper/presets.py,sha256=WDZAu8wvsMDsRFVhvUmvoQG0RgMaEEgutPaxQRCENNE,8350
+bootstrapper/templates.py,sha256=w-LXbgKo8TO0I0TG_fp3PxSnoPk6WmCQhdOATrhiHq4,13686
+agent_bootstrap-0.1.0.dist-info/METADATA,sha256=z4AQKhzVpAWz8QB5_Rs-MnNp_jyZslmwHJwTddqUDEo,7497
+agent_bootstrap-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+agent_bootstrap-0.1.0.dist-info/entry_points.txt,sha256=ydhNCPAUwwuGj0ru5RTHOdAxKLHGIZaVYnutfjHpAMo,89
+agent_bootstrap-0.1.0.dist-info/top_level.txt,sha256=RyaE32_UMIFaj-7Cm1LC4iQVSJ-zhXMC4RV982x-InQ,13
+agent_bootstrap-0.1.0.dist-info/RECORD,,

agent_bootstrap-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agent_bootstrap-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+agent-bootstrap = bootstrapper.cli:app
+projboot = bootstrapper.cli:app

agent_bootstrap-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 marcelodevops
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_bootstrap-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+bootstrapper

bootstrapper/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

bootstrapper/__main__.py

@@ -0,0 +1,3 @@
+from .cli import app
+
+app()

bootstrapper/agents.py

@@ -0,0 +1,143 @@
+"""Universal AI agent harness and assistant-specific overlay templates."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from .presets import PresetConfig, load_user_store_files
+
+AGENTS_MD_TEMPLATE = """\
+# AGENTS.md — $name
+
+$description
+
+## Project Architecture & Layout
+
+- **Architecture Style**: `$arch`
+- **Outputs Directory**: `$outputs_dir/` — place all generated artifacts, reports, and exports here.
+- **Scripts Directory**: `$scripts_dir/` — store helper, automation, and maintenance scripts here.
+- **Ordered Prompts File**: `$prompts_file` — maintain ordered prompts and reusable agent instructions here.
+- **Persistent Memory**: `.remember/` — read `.remember/MEMORY.md` and `.remember/decisions.md` before starting work, and update them when key decisions are made.
+- **Agent Skills**: `.agents/skills/` — project-specific reusable skills.
+
+## Knowledge Graph (`graphify`)
+
+- When `graphify-out/graph.json` exists, prefer querying the graph before reading raw files:
+  - `graphify query "<question>"`
+  - `graphify path "<NodeA>" "<NodeB>"`
+  - `graphify explain "<concept>"`
+- If `graphify-out/wiki/index.md` exists, navigate it first.
+- After modifying code files, run `graphify update .` to keep `graphify-out/` current.
+"""
+
+PROMPTS_MD_TEMPLATE = """\
+# Ordered Prompts Catalog — $name
+
+Keep project prompts ordered and versioned in this file.
+
+## 01. Architecture & Context Prompt
+> Review `AGENTS.md`, `.remember/MEMORY.md`, and `graphify-out/` before proposing changes. Follow the `$arch` architecture pattern. Put outputs in `$outputs_dir/` and scripts in `$scripts_dir/`.
+
+## 02. Feature Implementation Prompt
+> Implement the requested feature following `$arch` boundaries, add unit tests, and run `graphify update .` when finished.
+"""
+
+AGENT_OVERLAYS: dict[str, dict[str, str]] = {
+    "claude": {
+        "CLAUDE.md": (
+            "# CLAUDE.md — $name\n\n"
+            "Read and follow @AGENTS.md and @.remember/MEMORY.md at the start of every session.\n\n"
+            "## Quick Conventions\n"
+            "- **Architecture**: `$arch`\n"
+            "- **Outputs folder**: `$outputs_dir/`\n"
+            "- **Scripts folder**: `$scripts_dir/`\n"
+            "- **Ordered prompts**: `$prompts_file`\n"
+            "- **Skills**: `.agents/skills/`\n"
+            "- **Knowledge graph**: `graphify-out/` (run `graphify update .` after code changes)\n"
+        ),
+        ".claude/settings.json": (
+            "{\n"
+            '  "project": "$name",\n'
+            '  "conventions": {\n'
+            '    "outputsDir": "$outputs_dir",\n'
+            '    "scriptsDir": "$scripts_dir",\n'
+            '    "promptsFile": "$prompts_file"\n'
+            "  }\n"
+            "}\n"
+        ),
+    },
+    "gh-copilot": {
+        ".github/copilot-instructions.md": (
+            "# GitHub Copilot Instructions — $name\n\n"
+            "$description\n\n"
+            "## Workspace Conventions\n"
+            "- Follow the **$arch** architecture pattern.\n"
+            "- Read `AGENTS.md` and `.remember/MEMORY.md` for project context and decisions.\n"
+            "- Save generated outputs and reports in `$outputs_dir/`.\n"
+            "- Place helper and automation scripts in `$scripts_dir/`.\n"
+            "- Keep ordered prompts in `$prompts_file`.\n"
+            "- Check `.agents/skills/` for domain skills and `graphify-out/` for the project graph.\n"
+        ),
+        ".github/prompts/bootstrap.prompt.md": (
+            "---\n"
+            'description: "Context-aware task execution for $name"\n'
+            "---\n\n"
+            "Review `AGENTS.md`, `.remember/MEMORY.md`, and `$prompts_file`.\n"
+            "Ensure generated outputs go into `$outputs_dir/` and scripts go into `$scripts_dir/`.\n"
+        ),
+    },
+    "codeassistant": {
+        ".codeassistant/instructions.md": (
+            "# CodeAssistant Instructions — $name\n\n"
+            "- **Architecture**: `$arch`\n"
+            "- **Outputs Directory**: `$outputs_dir/`\n"
+            "- **Scripts Directory**: `$scripts_dir/`\n"
+            "- **Prompts Log**: `$prompts_file`\n"
+            "- **Memory & Decisions**: `.remember/MEMORY.md`, `.remember/decisions.md`\n"
+            "- **Skills**: `.agents/skills/`\n"
+            "- **Graphify**: `graphify-out/` (refer to `AGENTS.md`)\n"
+        ),
+    },
+    "cursor": {
+        ".cursor/rules/project.mdc": (
+            "---\n"
+            "description: Core project architecture and directory rules for $name\n"
+            "globs: *\n"
+            "alwaysApply: true\n"
+            "---\n\n"
+            "# $name Rules\n\n"
+            "- Follow `$arch` architecture.\n"
+            "- Read `AGENTS.md` and `.remember/MEMORY.md`.\n"
+            "- Put outputs in `$outputs_dir/`, scripts in `$scripts_dir/`, and prompts in `$prompts_file`.\n"
+        ),
+    },
+}
+
+SUPPORTED_AGENTS: tuple[str, ...] = tuple(AGENT_OVERLAYS.keys())
+
+
+def universal_harness_files(
+    preset: PresetConfig, config_dir: Path | None = None
+) -> dict[str, str]:
+    """Return unrendered template bodies for the universal AI agent harness."""
+    files: dict[str, str] = {
+        "AGENTS.md": AGENTS_MD_TEMPLATE,
+        "graphify-out/.gitkeep": "",
+        f"{preset.outputs_dir}/.gitkeep": "",
+        f"{preset.scripts_dir}/.gitkeep": "",
+        preset.prompts_file: PROMPTS_MD_TEMPLATE,
+    }
+    files.update(load_user_store_files(config_dir))
+    return files
+
+
+def agent_overlay_files(agents: list[str]) -> dict[str, str]:
+    """Return unrendered template bodies for the selected `-a` assistant adapters."""
+    out: dict[str, str] = {}
+    for agent in agents:
+        key = agent.strip().lower()
+        if key not in AGENT_OVERLAYS:
+            available = ", ".join(SUPPORTED_AGENTS)
+            raise KeyError(f"Unknown agent '{agent}'. Available: {available}")
+        out.update(AGENT_OVERLAYS[key])
+    return out