regent-cli 0.2.0__tar.gz → 0.5.0__tar.gz

regent_cli-0.5.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: regent-cli
+Version: 0.5.0
+Summary: Autonomous conduction and mediated adversarial deliberation between AI agents, pluggable into any project.
+Author-email: Flavio Alvim <flavioalvim@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/flavioalvim/regent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# regent
+
+Autonomous conduction and mediated adversarial deliberation between AI agents, pluggable
+into any project.
+
+**regent** governs turns between agents (Claude, Codex, human mediators) under a frozen
+protocol: atomic turn mutex, CAS-versioned state, deliberation rounds with versioned
+acceptances, and a conduction daemon that executes production batches with a confined agent,
+test gates and evidence proof.
+
+Extracted from the tool proven end-to-end in the ArtNFT project (IMP-003: first product
+batch fully conducted by the daemon, deliberated, accepted and deployed to production).
+
+- Requirements: [`docs/PRD.md`](docs/PRD.md)
+- Extraction scope and decisions: [`docs/ESCOPO.md`](docs/ESCOPO.md) (PT-BR, pre-rename)
+- Deliberation rounds: [`docs/brainstorm/`](docs/brainstorm/) (mediator's language, PT-BR)
+- Status: **pre-extraction** (scope closed 2026-07-20; code not yet migrated)
+
+## Install
+
+```bash
+pip install <path-to-this-repo>   # package: regent-cli; CLI: regent (not on PyPI yet)
+cd <your-project>
+regent init                        # seeds .regent/ + .claude/skills symlinks (atomic, idempotent)
+regent doctor                      # checks executor (claude) and advisor (codex) CLIs
+```
+
+Then open a Claude Code session in the project — `/regent` and `/regent-stop` are available
+(`/regent brainstorm "<question>"` opens the first round). The v1 skills are
+**control-backed**: activity state lives in `.regent/control.json` and is driven through
+the JSON subcommands — `regent status` (control + lock + the executable control×files
+matrix as `workspace.verdict`), `regent activity
+start|resume|suspend|conclude|heartbeat|takeover`, `regent stop request|check`. Hosts
+seeded by older versions upgrade automatically on `regent init` (known-version manifest;
+unknown local edits are preserved as conflicts). The advisor requires the `codex` CLI. Conduction
+phase 1 mechanizes the two most error-prone sub-steps: `regent advisor consult
+--prompt-file … --artifact … --linkage …` (read-only sandboxed consultation with the
+REQ-003 §5 evidence pair generated by the command, fail-closed verdict expectation) and
+`regent gate run --command … --declared-in <plan> --artifact … --linkage …` (verbatim
+provenance check, process-group-killing timeout, integral output preserved).
+
+Development: `PYTHONPATH=src python3 -m unittest discover -s tests`; packaging gate:
+`bash scripts/gate-package.sh`. Canonical skill content lives in `src/regent/templates/`
+(ships inside the wheel); the repo's own `.regent/skills/` symlinks into it (dogfood
+without duplication).
+
+## Protocol layer
+
+`regent.protocol` (PLAN-001) is the transactional foundation the conduction daemon will
+drive: `ControlStore` (control.json with a real CAS — every mutation runs inside a
+kernel-flock critical section, atomic AND durable publication with file+directory fsync),
+`TurnLock` (executor-only turn ownership by uuid4 token; the whole lifecycle —
+acquire/heartbeat/release/takeover — is serialized under a flock; takeover is graced,
+audited, and rotates the control turn token BEFORE the new lock exists, aborting on
+divergence), stop-request representation (`record_stop_request` /
+`read_valid_stop_request` / `suspend_activity`, with activity/epoch/turn-token staleness
+fencing) and `AuditLog` (flock-serialized, fsynced JSONL under
+`.regent/protocol/audit.jsonl`). Dormant until the conduction phase wires it to the
+skills; the v0 skills remain file-driven.
+
+MIT License © 2026 Flavio Alvim.

regent_cli-0.5.0/README.md

@@ -0,0 +1,61 @@
+# regent
+
+Autonomous conduction and mediated adversarial deliberation between AI agents, pluggable
+into any project.
+
+**regent** governs turns between agents (Claude, Codex, human mediators) under a frozen
+protocol: atomic turn mutex, CAS-versioned state, deliberation rounds with versioned
+acceptances, and a conduction daemon that executes production batches with a confined agent,
+test gates and evidence proof.
+
+Extracted from the tool proven end-to-end in the ArtNFT project (IMP-003: first product
+batch fully conducted by the daemon, deliberated, accepted and deployed to production).
+
+- Requirements: [`docs/PRD.md`](docs/PRD.md)
+- Extraction scope and decisions: [`docs/ESCOPO.md`](docs/ESCOPO.md) (PT-BR, pre-rename)
+- Deliberation rounds: [`docs/brainstorm/`](docs/brainstorm/) (mediator's language, PT-BR)
+- Status: **pre-extraction** (scope closed 2026-07-20; code not yet migrated)
+
+## Install
+
+```bash
+pip install <path-to-this-repo>   # package: regent-cli; CLI: regent (not on PyPI yet)
+cd <your-project>
+regent init                        # seeds .regent/ + .claude/skills symlinks (atomic, idempotent)
+regent doctor                      # checks executor (claude) and advisor (codex) CLIs
+```
+
+Then open a Claude Code session in the project — `/regent` and `/regent-stop` are available
+(`/regent brainstorm "<question>"` opens the first round). The v1 skills are
+**control-backed**: activity state lives in `.regent/control.json` and is driven through
+the JSON subcommands — `regent status` (control + lock + the executable control×files
+matrix as `workspace.verdict`), `regent activity
+start|resume|suspend|conclude|heartbeat|takeover`, `regent stop request|check`. Hosts
+seeded by older versions upgrade automatically on `regent init` (known-version manifest;
+unknown local edits are preserved as conflicts). The advisor requires the `codex` CLI. Conduction
+phase 1 mechanizes the two most error-prone sub-steps: `regent advisor consult
+--prompt-file … --artifact … --linkage …` (read-only sandboxed consultation with the
+REQ-003 §5 evidence pair generated by the command, fail-closed verdict expectation) and
+`regent gate run --command … --declared-in <plan> --artifact … --linkage …` (verbatim
+provenance check, process-group-killing timeout, integral output preserved).
+
+Development: `PYTHONPATH=src python3 -m unittest discover -s tests`; packaging gate:
+`bash scripts/gate-package.sh`. Canonical skill content lives in `src/regent/templates/`
+(ships inside the wheel); the repo's own `.regent/skills/` symlinks into it (dogfood
+without duplication).
+
+## Protocol layer
+
+`regent.protocol` (PLAN-001) is the transactional foundation the conduction daemon will
+drive: `ControlStore` (control.json with a real CAS — every mutation runs inside a
+kernel-flock critical section, atomic AND durable publication with file+directory fsync),
+`TurnLock` (executor-only turn ownership by uuid4 token; the whole lifecycle —
+acquire/heartbeat/release/takeover — is serialized under a flock; takeover is graced,
+audited, and rotates the control turn token BEFORE the new lock exists, aborting on
+divergence), stop-request representation (`record_stop_request` /
+`read_valid_stop_request` / `suspend_activity`, with activity/epoch/turn-token staleness
+fencing) and `AuditLog` (flock-serialized, fsynced JSONL under
+`.regent/protocol/audit.jsonl`). Dormant until the conduction phase wires it to the
+skills; the v0 skills remain file-driven.
+
+MIT License © 2026 Flavio Alvim.

{regent_cli-0.2.0 → regent_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "regent-cli"
-version = "0.2.0"
+version = "0.5.0"
 description = "Autonomous conduction and mediated adversarial deliberation between AI agents, pluggable into any project."
 readme = "README.md"
 requires-python = ">=3.10"

{regent_cli-0.2.0 → regent_cli-0.5.0}/src/regent/__init__.py

@@ -1,3 +1,3 @@
 """regent — autonomous conduction and mediated adversarial deliberation between AI agents."""
 
-__version__ = "0.2.0"
+__version__ = "0.5.0"