Metadata-Version: 2.4
Name: arcgentic
Version: 0.2.2a3
Summary: Agentic harness for rigorous round-driven development — Python CLI for the arcgentic Claude Code plugin
Project-URL: Homepage, https://github.com/Arch1eSUN/Arcgentic
Project-URL: Repository, https://github.com/Arch1eSUN/Arcgentic
Author: Arc Studio
License: MIT
Keywords: agentic-harness,claude-code,ide-adapter,round-driven-development
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.13
Requires-Dist: jsonschema>=4.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: mypy>=1.14; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.15; extra == 'dev'
Description-Content-Type: text/markdown

# arcgentic toolkit

Python CLI + adapter layer for the `arcgentic` Claude Code plugin.

This is the **toolkit surface** of the arcgentic hybrid monorepo (see
[Spec Amendment 01](../docs/plans/2026-05-13-arcgentic-v0.2.0-spec-amendment-01-layout.md)
for why). The plugin surface (`skills/`, `agents/`, `hooks/`, `.githooks/` at repo root)
provides markdown contracts discoverable by Claude Code; this toolkit provides the
Python implementation that markdown skills shell out to.

## Install (dev)

```bash
cd toolkit
pip install -e ".[dev]"
arcgentic --help
```

## CLI commands

```bash
arcgentic plan-round-impl --round R1.0 --type substrate-touching --anchor <sha40>
arcgentic execute-round-impl --round R1.0 --handoff docs/superpowers/plans/R1.0.md
arcgentic audit-check docs/audits/R1.0.md --strict-extended
arcgentic quality-gate-enforce --repo-root .
arcgentic validate-handoff docs/superpowers/plans/R1.0.md
arcgentic codify-lesson --audit-dir docs/audits
arcgentic track-refs add references/example --owner-repo owner/repo --round R1 --usage-evidence '{"pattern_only": true}'
arcgentic cross-session-handoff read
```

## Quality gates (run from `toolkit/`)

```bash
mypy --strict src/ tests/
pytest --tb=no
ruff check .
```

## Layout

- `src/arcgentic/adapters/` — IDE adapter Protocol + implementations
- `src/arcgentic/skills_impl/` — skill implementation backends
- `src/arcgentic/audit_check.py` — mechanical audit fact checker
- `src/arcgentic/source_rules.py` — Moirai-derived source-rule contract validators
- `src/arcgentic/utils/pattern_detection.py` — repeated audit-pattern clustering for lessons
- `src/arcgentic/cli.py` — command-line bridge for skills, gates, and validators
- `tests/unit/`, `tests/integration/` — pytest suites
