hardproof 0.2.0__tar.gz → 0.3.1__tar.gz

hardproof-0.3.1/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: hardproof
+Version: 0.3.1
+Summary: A persistent, risk-aware engineering protocol for Hermes Agent
+Author: Hardproof contributors
+License-Expression: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: PyYAML<7,>=6
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: cyclonedx-bom>=7; extra == "dev"
+Requires-Dist: hypothesis>=6; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: pytest-xdist>=3; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Requires-Dist: types-PyYAML>=6; extra == "dev"
+Dynamic: license-file
+
+# HARDPROOF
+
+> Software has to earn done.
+
+[![CI](https://github.com/asimons81/hardproof/actions/workflows/ci.yml/badge.svg)](https://github.com/asimons81/hardproof/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/hardproof)](https://pypi.org/project/hardproof/)
+[![X Follow](https://img.shields.io/twitter/follow/asimons81?style=social)](https://x.com/asimons81)
+
+> **Alpha software.** v0.3.0 Workcells is the current public alpha on PyPI. v0.3.1 Workcells Hardening has been prepared. v0.4.0 Challenge Chamber development has not begun. Commands, schemas, and contracts may change before v1.0.0.
+
+Hardproof gives coding agents a persistent, risk-aware engineering process that turns ambiguous software requests into reviewed, verified results while preserving the evidence behind every completion claim.
+
+> A persistent, risk-aware engineering protocol for Hermes Agent.
+
+## Current Release
+
+| Current | v0.3.0 Workcells | Released on GitHub and PyPI |
+| Hardening | v0.3.1 Workcells Hardening | Prepared, pending release |
+| Previous | v0.2.0 Gatehouse | Released on GitHub and PyPI |
+| Previous | v0.1.1 Core Heat | Released on GitHub and PyPI |
+| Previous | v0.1.0 Core Heat | Released on GitHub |
+| Future | v0.4.0 Challenge Chamber | Not started |
+
+## Install
+
+From PyPI:
+
+```bash
+pip install hardproof
+hermes plugins enable hardproof
+```
+
+From GitHub:
+
+```bash
+hermes plugins install asimons81/hardproof --enable
+```
+
+## Enable
+
+Enable the plugin in Hermes:
+
+```bash
+hermes plugins enable hardproof
+```
+
+Verify discovery:
+
+```bash
+hermes hardproof doctor
+```
+
+## Quick Start
+
+Both the CLI and slash-command surfaces work identically:
+
+```bash
+# Terminal
+hermes hardproof start standard "Build API-key rotation with rollback support"
+hermes hardproof status
+hermes hardproof doctor
+
+# In Hermes chat
+/hardproof start standard "Build API-key rotation with rollback support"
+/hardproof status
+```
+
+Hardproof stores state under `.hardproof/`, adds that directory to the repository-local Git exclude file, and injects compact stage context into bound Hermes sessions.
+
+## How Hardproof Changes an Agent Workflow
+
+1. **INT AKE** — clarify the request before any code is written
+2. **DISCOVERY** — inspect the repository, constraints, and unknowns
+3. **DESIGN** — shape a reversible solution (requires human approval)
+4. **PLAN** — turn the design into dependency-aware tasks (requires human approval)
+5. **IMPLEMENT** — execute approved tasks with focused tests
+6. **REVIEW** — challenge the implementation and risks
+7. **VERIFY** — run checks and evaluate fresh workspace-bound evidence
+8. **DELIVER** — prepare an evidence-backed completion handoff
+9. **LEARN** — capture lessons or explicitly skip
+
+Every stage has defined gates. No run completes without fresh successful evidence.
+
+## Profiles
+
+| Profile | Use Case | Key Requirements |
+|---------|----------|-----------------|
+| **Quick** | Typo fixes, doc updates, one-line changes | Recorded skips, at least one fresh verification check |
+| **Standard** | Feature work, refactors, multi-file changes | Discovery, design and plan, human design and plan approval, tracked implementation, review, fresh verification, delivery, learning decision |
+| **Critical** | Auth changes, data migrations, production config | Destructive-action approvals, at least two checks, rollback and risk material, fail-closed mutation policy, human completion approval |
+
+No profile permits completion without fresh successful evidence.
+
+## Gatehouse v0.2.0 Features
+
+Gatehouse adds strict project allow/deny/approval rules, ordered policy explanations, human-only
+scoped waivers, advisory risk suggestions, bounded monotonic stage graphs, configuration and
+migration diagnostics, and versioned Python/Node/Rust/Go policy packs. See
+[configuration and migrations](docs/configuration-and-migrations.md) and
+[policy packs](docs/policy-packs.md).
+
+## Common Commands
+
+```bash
+hermes hardproof start quick|standard|critical "request"
+hermes hardproof status
+hermes hardproof doctor
+hermes hardproof approve design|plan|completion [reason]
+hermes hardproof waive <reason>
+hermes hardproof pause [reason]
+hermes hardproof resume [run-id]
+hermes hardproof abort <reason>
+hermes hardproof evidence
+hermes hardproof export [path]
+hermes hardproof config init|validate|explain
+hermes hardproof db status|migrate [--dry-run]
+hermes hardproof migrate-state
+hermes hardproof runs
+hermes hardproof show <run-id>
+hermes hardproof policy <args>
+```
+
+All commands also work as `/hardproof <subcommand>` in Hermes chat.
+
+## Point Hermes Agent at This Repository
+
+Hermes Agent automatically reads `AGENTS.md` when started in the repository. To work on Hardproof itself:
+
+1. Clone or open the repo
+2. Start Hermes from the repository root
+3. Confirm `AGENTS.md` is loaded (Hermes prints a context-file banner on startup)
+4. Follow the instructions in [docs/hermes-agent-guide.md](docs/hermes-agent-guide.md)
+
+## Architecture
+
+Hardproof is a standalone Python package discovered through the `hermes_agent.plugins` entry-point group. It uses only the public Hermes registration, hook, command, skill, and dispatch APIs.
+
+1. **Plugin layer** — registers slash commands, CLI commands, six tools, lifecycle hooks, and nine stage skills
+2. **Domain layer** — run profiles, stages, transitions, approval gates, and immutable event models
+3. **Policy layer** — stage-aware mutation rules, tool policies, and human-required approval escalation
+4. **Storage layer** — project-local SQLite database with forward-only migrations plus human-readable artifacts under `.hardproof/runs/<run-id>/`
+5. **Verification layer** — workspace-bound evidence with Git HEAD capture, binary diff freshness checks, and redacted output recording
+
+See [architecture](docs/architecture.md), [profiles](docs/profiles.md), and [compatibility](docs/compatibility.md).
+
+## Verification Evidence
+
+Hardproof requires fresh, workspace-bound evidence before any run can complete. Verification checks capture:
+
+- Git HEAD commit hash at the time of verification
+- Binary diff against the working tree to detect uncommitted changes
+- Redacted, size-bounded output from each configured check
+- Strict exit-code evaluation (only explicit zero passes)
+
+Stale evidence — recorded against a different workspace state — is flagged and cannot satisfy completion gates.
+
+## Security Boundary
+
+Hardproof coordinates engineering process; it is not a security sandbox. Policy hooks do not replace OS permissions, protected branches, sandboxing, isolation, or human code review.
+
+Hardproof includes these protections:
+- Force pushes and destructive Git operations are blocked
+- Recognized destructive actions are blocked or require human approval
+- Source mutation is stage-aware (locked in later stages)
+- Human-only approval gates prevent model self-approval
+- Policy decisions are recorded with cryptographic hashes of arguments and configuration
+
+See [SECURITY.md](SECURITY.md) and the [security model](docs/security-model.md).
+
+## Privacy
+
+Hardproof has **no telemetry, no analytics, no accounts, no hosted dependencies, no remote asset fetching, and no automatic update checks.** Normal local operation makes no intentional network request. Verification output is redacted and size-bounded. Policy events store argument keys and hashes rather than raw values. Nothing phones home.
+
+## Known Limitations
+
+- Policy hooks coordinate process but are not a security sandbox or complete shell parser
+- Managed runs require a Git worktree for workspace-bound freshness evidence
+- Local compatibility evidence covers Hermes Agent 0.18.2 on native Windows; macOS and Linux are CI-enforced
+- Downgrade from a migrated v0.2.0 database is not supported
+
+## Documentation Index
+
+| Document | Audience |
+|----------|----------|
+| [docs/README.md](docs/README.md) | Full documentation index |
+| [docs/hermes-agent-guide.md](docs/hermes-agent-guide.md) | Hermes Agent operators |
+| [docs/architecture.md](docs/architecture.md) | Architecture overview |
+| [docs/profiles.md](docs/profiles.md) | Run profiles |
+| [docs/protocol.md](docs/protocol.md) | Protocol specification |
+| [docs/security-model.md](docs/security-model.md) | Security model |
+| [docs/configuration-and-migrations.md](docs/configuration-and-migrations.md) | Config and migrations |
+| [docs/policy-packs.md](docs/policy-packs.md) | Language policy packs |
+| [docs/command-reference.md](docs/command-reference.md) | All commands and tools |
+| [docs/repository-map.md](docs/repository-map.md) | Repository layout |
+
+## Contributing
+
+Start with [CONTRIBUTING.md](CONTRIBUTING.md), [GOVERNANCE.md](GOVERNANCE.md), and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). Coding agents should read [AGENTS.md](AGENTS.md) first. Design changes use ADRs; breaking protocol changes require a public RFC issue. Contributions use the Developer Certificate of Origin rather than a CLA.
+
+## Roadmap
+
+| Version | Codename | Focus |
+|---------|----------|-------|
+| v0.1.1 | Core Heat | Standalone plugin, durable stages, SQLite state, approvals, skills, fresh evidence, reports |
+| v0.2.0 | Gatehouse | Explainable configurable policy, scoped waivers, risk suggestions, language packs |
+| v0.3.0 | Workcells | Dependency-aware task waves, resumable subagent implementers |
+| v0.4.0 | Challenge Chamber | Independent specialized reviewers, severity, fix/re-review loops |
+| v0.5.0 | Isolation | Branches, worktrees, baseline proof, rollback, backend adapters |
+
+Full roadmap: [ROADMAP.md](ROADMAP.md).
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+
+## Affiliation
+
+Hardproof is independent open-source software. It is not affiliated with, endorsed by, or sponsored by Hermes Agent, Nous Research, Atlassian, or any other organization.
+
+---
+
+**Topics:** `hermes-agent` `coding-agents` `agentic-coding` `software-engineering` `verification` `developer-tools` `open-source` `python`

hardproof-0.3.1/README.md

@@ -0,0 +1,223 @@
+# HARDPROOF
+
+> Software has to earn done.
+
+[![CI](https://github.com/asimons81/hardproof/actions/workflows/ci.yml/badge.svg)](https://github.com/asimons81/hardproof/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/hardproof)](https://pypi.org/project/hardproof/)
+[![X Follow](https://img.shields.io/twitter/follow/asimons81?style=social)](https://x.com/asimons81)
+
+> **Alpha software.** v0.3.0 Workcells is the current public alpha on PyPI. v0.3.1 Workcells Hardening has been prepared. v0.4.0 Challenge Chamber development has not begun. Commands, schemas, and contracts may change before v1.0.0.
+
+Hardproof gives coding agents a persistent, risk-aware engineering process that turns ambiguous software requests into reviewed, verified results while preserving the evidence behind every completion claim.
+
+> A persistent, risk-aware engineering protocol for Hermes Agent.
+
+## Current Release
+
+| Current | v0.3.0 Workcells | Released on GitHub and PyPI |
+| Hardening | v0.3.1 Workcells Hardening | Prepared, pending release |
+| Previous | v0.2.0 Gatehouse | Released on GitHub and PyPI |
+| Previous | v0.1.1 Core Heat | Released on GitHub and PyPI |
+| Previous | v0.1.0 Core Heat | Released on GitHub |
+| Future | v0.4.0 Challenge Chamber | Not started |
+
+## Install
+
+From PyPI:
+
+```bash
+pip install hardproof
+hermes plugins enable hardproof
+```
+
+From GitHub:
+
+```bash
+hermes plugins install asimons81/hardproof --enable
+```
+
+## Enable
+
+Enable the plugin in Hermes:
+
+```bash
+hermes plugins enable hardproof
+```
+
+Verify discovery:
+
+```bash
+hermes hardproof doctor
+```
+
+## Quick Start
+
+Both the CLI and slash-command surfaces work identically:
+
+```bash
+# Terminal
+hermes hardproof start standard "Build API-key rotation with rollback support"
+hermes hardproof status
+hermes hardproof doctor
+
+# In Hermes chat
+/hardproof start standard "Build API-key rotation with rollback support"
+/hardproof status
+```
+
+Hardproof stores state under `.hardproof/`, adds that directory to the repository-local Git exclude file, and injects compact stage context into bound Hermes sessions.
+
+## How Hardproof Changes an Agent Workflow
+
+1. **INT AKE** — clarify the request before any code is written
+2. **DISCOVERY** — inspect the repository, constraints, and unknowns
+3. **DESIGN** — shape a reversible solution (requires human approval)
+4. **PLAN** — turn the design into dependency-aware tasks (requires human approval)
+5. **IMPLEMENT** — execute approved tasks with focused tests
+6. **REVIEW** — challenge the implementation and risks
+7. **VERIFY** — run checks and evaluate fresh workspace-bound evidence
+8. **DELIVER** — prepare an evidence-backed completion handoff
+9. **LEARN** — capture lessons or explicitly skip
+
+Every stage has defined gates. No run completes without fresh successful evidence.
+
+## Profiles
+
+| Profile | Use Case | Key Requirements |
+|---------|----------|-----------------|
+| **Quick** | Typo fixes, doc updates, one-line changes | Recorded skips, at least one fresh verification check |
+| **Standard** | Feature work, refactors, multi-file changes | Discovery, design and plan, human design and plan approval, tracked implementation, review, fresh verification, delivery, learning decision |
+| **Critical** | Auth changes, data migrations, production config | Destructive-action approvals, at least two checks, rollback and risk material, fail-closed mutation policy, human completion approval |
+
+No profile permits completion without fresh successful evidence.
+
+## Gatehouse v0.2.0 Features
+
+Gatehouse adds strict project allow/deny/approval rules, ordered policy explanations, human-only
+scoped waivers, advisory risk suggestions, bounded monotonic stage graphs, configuration and
+migration diagnostics, and versioned Python/Node/Rust/Go policy packs. See
+[configuration and migrations](docs/configuration-and-migrations.md) and
+[policy packs](docs/policy-packs.md).
+
+## Common Commands
+
+```bash
+hermes hardproof start quick|standard|critical "request"
+hermes hardproof status
+hermes hardproof doctor
+hermes hardproof approve design|plan|completion [reason]
+hermes hardproof waive <reason>
+hermes hardproof pause [reason]
+hermes hardproof resume [run-id]
+hermes hardproof abort <reason>
+hermes hardproof evidence
+hermes hardproof export [path]
+hermes hardproof config init|validate|explain
+hermes hardproof db status|migrate [--dry-run]
+hermes hardproof migrate-state
+hermes hardproof runs
+hermes hardproof show <run-id>
+hermes hardproof policy <args>
+```
+
+All commands also work as `/hardproof <subcommand>` in Hermes chat.
+
+## Point Hermes Agent at This Repository
+
+Hermes Agent automatically reads `AGENTS.md` when started in the repository. To work on Hardproof itself:
+
+1. Clone or open the repo
+2. Start Hermes from the repository root
+3. Confirm `AGENTS.md` is loaded (Hermes prints a context-file banner on startup)
+4. Follow the instructions in [docs/hermes-agent-guide.md](docs/hermes-agent-guide.md)
+
+## Architecture
+
+Hardproof is a standalone Python package discovered through the `hermes_agent.plugins` entry-point group. It uses only the public Hermes registration, hook, command, skill, and dispatch APIs.
+
+1. **Plugin layer** — registers slash commands, CLI commands, six tools, lifecycle hooks, and nine stage skills
+2. **Domain layer** — run profiles, stages, transitions, approval gates, and immutable event models
+3. **Policy layer** — stage-aware mutation rules, tool policies, and human-required approval escalation
+4. **Storage layer** — project-local SQLite database with forward-only migrations plus human-readable artifacts under `.hardproof/runs/<run-id>/`
+5. **Verification layer** — workspace-bound evidence with Git HEAD capture, binary diff freshness checks, and redacted output recording
+
+See [architecture](docs/architecture.md), [profiles](docs/profiles.md), and [compatibility](docs/compatibility.md).
+
+## Verification Evidence
+
+Hardproof requires fresh, workspace-bound evidence before any run can complete. Verification checks capture:
+
+- Git HEAD commit hash at the time of verification
+- Binary diff against the working tree to detect uncommitted changes
+- Redacted, size-bounded output from each configured check
+- Strict exit-code evaluation (only explicit zero passes)
+
+Stale evidence — recorded against a different workspace state — is flagged and cannot satisfy completion gates.
+
+## Security Boundary
+
+Hardproof coordinates engineering process; it is not a security sandbox. Policy hooks do not replace OS permissions, protected branches, sandboxing, isolation, or human code review.
+
+Hardproof includes these protections:
+- Force pushes and destructive Git operations are blocked
+- Recognized destructive actions are blocked or require human approval
+- Source mutation is stage-aware (locked in later stages)
+- Human-only approval gates prevent model self-approval
+- Policy decisions are recorded with cryptographic hashes of arguments and configuration
+
+See [SECURITY.md](SECURITY.md) and the [security model](docs/security-model.md).
+
+## Privacy
+
+Hardproof has **no telemetry, no analytics, no accounts, no hosted dependencies, no remote asset fetching, and no automatic update checks.** Normal local operation makes no intentional network request. Verification output is redacted and size-bounded. Policy events store argument keys and hashes rather than raw values. Nothing phones home.
+
+## Known Limitations
+
+- Policy hooks coordinate process but are not a security sandbox or complete shell parser
+- Managed runs require a Git worktree for workspace-bound freshness evidence
+- Local compatibility evidence covers Hermes Agent 0.18.2 on native Windows; macOS and Linux are CI-enforced
+- Downgrade from a migrated v0.2.0 database is not supported
+
+## Documentation Index
+
+| Document | Audience |
+|----------|----------|
+| [docs/README.md](docs/README.md) | Full documentation index |
+| [docs/hermes-agent-guide.md](docs/hermes-agent-guide.md) | Hermes Agent operators |
+| [docs/architecture.md](docs/architecture.md) | Architecture overview |
+| [docs/profiles.md](docs/profiles.md) | Run profiles |
+| [docs/protocol.md](docs/protocol.md) | Protocol specification |
+| [docs/security-model.md](docs/security-model.md) | Security model |
+| [docs/configuration-and-migrations.md](docs/configuration-and-migrations.md) | Config and migrations |
+| [docs/policy-packs.md](docs/policy-packs.md) | Language policy packs |
+| [docs/command-reference.md](docs/command-reference.md) | All commands and tools |
+| [docs/repository-map.md](docs/repository-map.md) | Repository layout |
+
+## Contributing
+
+Start with [CONTRIBUTING.md](CONTRIBUTING.md), [GOVERNANCE.md](GOVERNANCE.md), and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). Coding agents should read [AGENTS.md](AGENTS.md) first. Design changes use ADRs; breaking protocol changes require a public RFC issue. Contributions use the Developer Certificate of Origin rather than a CLA.
+
+## Roadmap
+
+| Version | Codename | Focus |
+|---------|----------|-------|
+| v0.1.1 | Core Heat | Standalone plugin, durable stages, SQLite state, approvals, skills, fresh evidence, reports |
+| v0.2.0 | Gatehouse | Explainable configurable policy, scoped waivers, risk suggestions, language packs |
+| v0.3.0 | Workcells | Dependency-aware task waves, resumable subagent implementers |
+| v0.4.0 | Challenge Chamber | Independent specialized reviewers, severity, fix/re-review loops |
+| v0.5.0 | Isolation | Branches, worktrees, baseline proof, rollback, backend adapters |
+
+Full roadmap: [ROADMAP.md](ROADMAP.md).
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+
+## Affiliation
+
+Hardproof is independent open-source software. It is not affiliated with, endorsed by, or sponsored by Hermes Agent, Nous Research, Atlassian, or any other organization.
+
+---
+
+**Topics:** `hermes-agent` `coding-agents` `agentic-coding` `software-engineering` `verification` `developer-tools` `open-source` `python`

{hardproof-0.2.0 → hardproof-0.3.1}/hardproof/__init__.py

@@ -1,3 +1,3 @@
 """Hardproof public package."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"

{hardproof-0.2.0 → hardproof-0.3.1}/hardproof/commands/cli.py

@@ -31,6 +31,22 @@ def _configure(parser: argparse.ArgumentParser) -> None:
     export.add_argument("path", nargs="?")
     sub.add_parser("doctor")
     sub.add_parser("runs")
+    sub.add_parser("tasks")
+    task = sub.add_parser("task").add_subparsers(dest="task_command", required=True)
+    task.add_parser("graph")
+    task_show = task.add_parser("show")
+    task_show.add_argument("task_id")
+    task_attempts = task.add_parser("attempts")
+    task_attempts.add_argument("task_id")
+    workcells = sub.add_parser("workcells").add_subparsers(dest="workcells_command", required=True)
+    workcells.add_parser("status")
+    plan = workcells.add_parser("plan")
+    plan.add_argument("--tasks-json", required=True)
+    workcells.add_parser("run-next")
+    result = workcells.add_parser("result")
+    result.add_argument("attempt_id")
+    reconcile = workcells.add_parser("reconcile")
+    reconcile.add_argument("attempt_id")
     show = sub.add_parser("show")
     show.add_argument("run_id")
     config = sub.add_parser("config").add_subparsers(dest="config_command", required=True)
@@ -68,6 +84,12 @@ def _to_argv(args: argparse.Namespace) -> list[str]:
         return [command, *([args.path] if args.path else [])]
     if command == "show":
         return [command, args.run_id]
+    if command == "task":
+        return [command, args.task_command, *([args.task_id] if hasattr(args, "task_id") else [])]
+    if command == "workcells":
+        if args.workcells_command == "plan":
+            return [command, "plan", "--tasks-json", args.tasks_json]
+        return [command, args.workcells_command, *([args.attempt_id] if hasattr(args, "attempt_id") else [])]
     if command == "config":
         return [command, args.config_command]
     if command == "db":