stellars-claude-code-plugins 0.8.44__py3-none-any.whl

stellars_claude_code_plugins-0.8.44.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: stellars_claude_code_plugins
+Version: 0.8.44
+Summary: Claude Code plugins for autonomous development workflows
+Author-email: Stellars Henson <konrad.jelen@gmail.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Requires-Python: ~=3.12.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: pip; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# stellars-claude-code-plugins
+
+[![GitHub Actions](https://github.com/stellarshenson/claude-code-plugins/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/claude-code-plugins/actions/workflows/build.yml)
+[![PyPI version](https://img.shields.io/pypi/v/stellars-claude-code-plugins.svg)](https://pypi.org/project/stellars-claude-code-plugins/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/stellars-claude-code-plugins)](https://pepy.tech/project/stellars-claude-code-plugins)
+[![Python 3.12](https://img.shields.io/badge/Python-3.12-blue.svg)](https://www.python.org/downloads/)
+[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
+
+> [!TIP]
+> Each plugin provides only YAML configuration files. The shared orchestration engine in `stellars_claude_code_plugins` handles all execution logic - FSM transitions, gate validation, multi-agent coordination, and state management.
+
+Claude Code plugins for autonomous development workflows. A shared YAML-driven orchestration engine with individual plugins that define their own phases, agents, and gates through declarative configuration.
+
+## Plugins
+
+| Plugin | Description |
+|--------|-------------|
+| [auto-build-claw](auto-build-claw/) | Autonomous build iteration orchestrator with multi-agent review |
+
+## Features
+
+- **YAML-driven orchestration** - All phases, agents, gates, and display text defined in 4 YAML files per plugin
+- **Finite state machine** - Declarative phase lifecycle with readback, gatekeeper, reject, and skip transitions
+- **Multi-agent coordination** - Spawn parallel agent panels per phase with role-specific prompts
+- **Independent gates** - Readback validation at phase start, gatekeeper evaluation at phase end via `claude -p`
+- **Hypothesis tracking** - Persistent hypothesis catalogue across iterations with garbage collection
+- **Failure logging** - Structured failure modes feed into next iteration's research context
+- **Iteration planning** - Optional iteration 0 planning phase with dependency workflow chaining
+- **Auditable state** - Every transition, readback, and gatekeeper verdict logged to YAML
+
+## Architecture
+
+```
+stellars_claude_code_plugins/          # Shared engine (pip installable)
+  engine/
+    fsm.py                             # Phase lifecycle state machine
+    model.py                           # Typed YAML model loader + validator
+    orchestrator.py                    # Complete orchestration engine
+
+auto-build-claw/                       # Plugin (YAML content + thin entrypoint)
+  skills/auto-build-claw/
+    orchestrate.py                     # 18-line entrypoint
+    resources/
+      workflow.yaml                    # Iteration types and phase sequences
+      phases.yaml                      # Phase instruction templates
+      agents.yaml                      # Agent definitions and gate prompts
+      app.yaml                         # Display text and CLI configuration
+```
+
+## Install
+
+```bash
+pip install stellars-claude-code-plugins
+```
+
+This installs the shared orchestration engine and the `orchestrate` CLI command.
+
+## Usage
+
+### As a Claude Code plugin
+
+```bash
+/plugin marketplace add stellarshenson/claude-code-plugins
+```
+
+The auto-build-claw skill triggers automatically when you ask Claude to iterate on code, improve quality, fix bugs, or run structured development cycles.
+
+### As a standalone CLI
+
+```bash
+orchestrate --resources-dir /path/to/plugin/resources new --type full --objective "..." --iterations 3
+orchestrate start --understanding "brief summary"
+orchestrate end --evidence "..." --agents "researcher,planner" --output-file output.md
+orchestrate status
+```
+
+## Building a new plugin
+
+Create a directory with 4 YAML resource files and a thin entrypoint:
+
+```python
+#!/usr/bin/env python3
+from pathlib import Path
+from stellars_claude_code_plugins.engine.orchestrator import main
+
+if __name__ == "__main__":
+    main(resources_dir=Path(__file__).parent / "resources")
+```
+
+Define your workflow phases, agent prompts, gate templates, and display text in the YAML files. The engine handles everything else - state management, FSM transitions, CLI parsing, gate execution, and audit logging.
+
+## Development
+
+```bash
+make install          # create venv, install deps, editable install
+make test             # run 115 tests
+make lint             # ruff format + check
+make format           # auto-fix formatting
+make build            # clean, test, bump version, build wheel
+make publish          # build + twine upload to PyPI
+```
+
+## License
+
+MIT License

stellars_claude_code_plugins-0.8.44.dist-info/RECORD

@@ -0,0 +1,11 @@
+stellars_claude_code_plugins/__init__.py,sha256=9e45K1ZZQdkzqIiigYTfc32O9fALnY0hUpXqLKJWWvg,90
+stellars_claude_code_plugins/engine/__init__.py,sha256=W7zsJEsrhQsXoSQcI0thmn5IHu3NVOYTiVU_0bA2IHA,717
+stellars_claude_code_plugins/engine/fsm.py,sha256=KjPT5R51OmglYh60yup9CNoLgwoCUCZ-orFlYmYfX5Q,9394
+stellars_claude_code_plugins/engine/model.py,sha256=rXRJEabPvn0pvNLq0XSylmoFvRY6j2mtsH1NEr3wTuo,16840
+stellars_claude_code_plugins/engine/orchestrator.py,sha256=uib16tk1C-0q8BO098lzFQt8hlBG7R76ekZLhvkUja8,89388
+stellars_claude_code_plugins-0.8.44.dist-info/licenses/LICENSE,sha256=2SVNhEG8lzSrf5Fn4cYH0K1xDIKqM-4e5Gw8p046MrE,1072
+stellars_claude_code_plugins-0.8.44.dist-info/METADATA,sha256=1xnEnwMhim-S4JOjtBB-9iv5xqHBSRZkQMsud07EGao,5296
+stellars_claude_code_plugins-0.8.44.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+stellars_claude_code_plugins-0.8.44.dist-info/entry_points.txt,sha256=RykK8wbPMSubqs2srQhlr-vKFDcQaRrjsTfnbuUB5KU,86
+stellars_claude_code_plugins-0.8.44.dist-info/top_level.txt,sha256=jQk3akQV3PVcHTwF8Z80wh1OPoPtHeQgVByLzWyfuGI,29
+stellars_claude_code_plugins-0.8.44.dist-info/RECORD,,

stellars_claude_code_plugins-0.8.44.dist-info/WHEEL

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

stellars_claude_code_plugins-0.8.44.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+orchestrate = stellars_claude_code_plugins.engine.orchestrator:main

stellars_claude_code_plugins-0.8.44.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stellars Henson
+
+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.

stellars_claude_code_plugins-0.8.44.dist-info/top_level.txt

@@ -0,0 +1 @@
+stellars_claude_code_plugins