canopy-agent-factory 1.0.0__tar.gz

canopy_agent_factory-1.0.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+uv.lock
+.superpowers/
+.gstack/
+.claude/settings.local.json
+.claude/worktrees/
+node_modules/
+# package-lock.json is COMMITTED on purpose. CI ran a bare `npm install`, which
+# re-resolves from the live registry on every run — so the gws-mcp gate reddened on
+# every open branch at once when npm's resolver choked (`Cannot read properties of
+# null (reading 'edgesOut')`, canopy#594), and could equally have gone GREEN on a
+# tree nobody had tested. A gate whose inputs move under it is not a gate.

canopy_agent_factory-1.0.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.5
+Name: canopy-agent-factory
+Version: 1.0.0
+Summary: Stamp out a new Claude Code agent from the canopy operating model — a self-contained, zero-runtime-dependency factory. Pip-installable into canopy / canopy-web / any second consumer.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# canopy-agent-factory
+
+Stamp out a new Claude Code agent from the canopy operating model — a persona, the `turn`
+orchestrator, reads-free / writes-gated guarding via a config-driven PreToolUse hook, and a
+canopy-web-ready layout. Extracted from the `canopy` distribution's
+`src/orchestrator/agent_factory.py` so a second consumer (canopy-web, a Django app) can
+scaffold an agent repo without inheriting canopy's video-tooling dependency footprint
+(Pillow, NumPy).
+
+Zero runtime dependencies. Versions independently of `canopy`.
+
+## Public API
+
+```python
+from canopy_agent_factory import AgentSpec, create_agent, normalize_slug, AgentFactoryError
+from canopy_agent_factory import templates, gating_config  # canonical stamp-table baseline
+```
+
+- `AgentSpec` — dataclass describing the agent to scaffold.
+- `create_agent(spec, target_dir, *, force=False) -> list[Path]` — writes the templated
+  files into `target_dir` (caller-supplied; this function does no `git init` and no other
+  I/O beyond writing the scaffold) and returns the paths it wrote.
+- `normalize_slug(raw) -> str` — validate + normalize an agent slug.
+- `AgentFactoryError` — raised for bad input or an unsafe target directory.
+- `templates() -> Mapping[str, str]` — the canonical stamp table (repo-relative path →
+  rendered-template source), read-only. Ground truth for "what a factory-stamped agent
+  looks like"; used by canopy's fleet-alignment lens to diff real agent repos against the
+  baseline.
+- `gating_config() -> str` — the canonical `config/gating.json` body a stamped agent ships
+  with.
+
+## Development
+
+```bash
+uv run --with pytest pytest -q
+```
+
+Runs standalone — no orchestrator import, no Django.

canopy_agent_factory-1.0.0/README.md

@@ -0,0 +1,38 @@
+# canopy-agent-factory
+
+Stamp out a new Claude Code agent from the canopy operating model — a persona, the `turn`
+orchestrator, reads-free / writes-gated guarding via a config-driven PreToolUse hook, and a
+canopy-web-ready layout. Extracted from the `canopy` distribution's
+`src/orchestrator/agent_factory.py` so a second consumer (canopy-web, a Django app) can
+scaffold an agent repo without inheriting canopy's video-tooling dependency footprint
+(Pillow, NumPy).
+
+Zero runtime dependencies. Versions independently of `canopy`.
+
+## Public API
+
+```python
+from canopy_agent_factory import AgentSpec, create_agent, normalize_slug, AgentFactoryError
+from canopy_agent_factory import templates, gating_config  # canonical stamp-table baseline
+```
+
+- `AgentSpec` — dataclass describing the agent to scaffold.
+- `create_agent(spec, target_dir, *, force=False) -> list[Path]` — writes the templated
+  files into `target_dir` (caller-supplied; this function does no `git init` and no other
+  I/O beyond writing the scaffold) and returns the paths it wrote.
+- `normalize_slug(raw) -> str` — validate + normalize an agent slug.
+- `AgentFactoryError` — raised for bad input or an unsafe target directory.
+- `templates() -> Mapping[str, str]` — the canonical stamp table (repo-relative path →
+  rendered-template source), read-only. Ground truth for "what a factory-stamped agent
+  looks like"; used by canopy's fleet-alignment lens to diff real agent repos against the
+  baseline.
+- `gating_config() -> str` — the canonical `config/gating.json` body a stamped agent ships
+  with.
+
+## Development
+
+```bash
+uv run --with pytest pytest -q
+```
+
+Runs standalone — no orchestrator import, no Django.

canopy_agent_factory-1.0.0/canopy_agent_factory/__init__.py

@@ -0,0 +1,28 @@
+"""canopy-agent-factory — stamp out a new Claude Code agent from the canopy operating model.
+
+Zero-runtime-dependency, published separately from the `canopy` distribution so a second
+consumer (e.g. a Django web app) can scaffold an agent repo without inheriting canopy's
+video-tooling dependency footprint (Pillow, NumPy). See `_factory.py` for the implementation;
+this module re-exports only the public surface.
+"""
+from __future__ import annotations
+
+from ._factory import (
+    AgentFactoryError,
+    AgentSpec,
+    create_agent,
+    gating_config,
+    normalize_slug,
+    templates,
+)
+
+__all__ = [
+    "AgentFactoryError",
+    "AgentSpec",
+    "create_agent",
+    "gating_config",
+    "normalize_slug",
+    "templates",
+]
+
+__version__ = "1.0.0"