codexloop 0.1.0__tar.gz → 0.3.0__tar.gz

{codexloop-0.1.0 → codexloop-0.3.0}/.github/workflows/ci.yml

@@ -35,7 +35,42 @@ jobs:
       - run: lint-imports
       - run: bandit -q -r src/codexloop
       - run: pip-audit
-      - run: pytest --cov-report=term-missing
+      # Per layer, not in aggregate: a blanket floor lets a well-tested domain
+      # hide an untested adapter. pytest-cov unions --cov scopes within one
+      # invocation, so each floor needs its own run.
+      - name: Coverage floor - domain (100%)
+        run: pytest -q --cov=codexloop.domain --cov-fail-under=100
+      - name: Coverage floor - application (100%)
+        run: pytest -q --cov=codexloop.application --cov-fail-under=100
+      - name: Coverage floor - infrastructure (100%)
+        run: pytest -q --cov=codexloop.infrastructure --cov-fail-under=100
+      - name: Coverage floor - cli (100%)
+        run: pytest -q --cov=codexloop.cli --cov-fail-under=100
+
+  docs:
+    name: MkDocs builds strictly
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[docs]"
+      - run: mkdocs build --strict
+
+  uv-lock:
+    name: uv.lock is in sync with pyproject.toml
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: actions/setup-python@v7.0.0
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - run: uv lock --check
 
   build:
     name: Package builds and is installable

codexloop-0.3.0/.github/workflows/docs.yml

@@ -0,0 +1,40 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[docs]"
+      - run: mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

{codexloop-0.1.0 → codexloop-0.3.0}/.github/workflows/publish-testpypi.yml

@@ -16,6 +16,7 @@ concurrency:
 jobs:
   publish:
     name: Build and publish to TestPyPI
+    if: ${{ github.ref == 'refs/heads/develop' }}
     runs-on: ubuntu-latest
     environment: testpypi
     steps:

{codexloop-0.1.0 → codexloop-0.3.0}/.github/workflows/release-please.yml

@@ -5,10 +5,14 @@ on:
     branches: [main]
   workflow_dispatch:
     inputs:
-      publish_to_testpypi:
-        description: "Also build and publish this commit to TestPyPI (Trusted Publishing)."
+      publish_to_pypi:
+        description: "Build and publish ref to PyPI (Trusted Publishing). Use after tagging or to retry a release."
         type: boolean
         default: false
+      publish_tag:
+        description: "Git tag to build/publish when publish_to_pypi=true"
+        type: string
+        default: "v0.2.0"
 
 permissions:
   contents: write
@@ -22,9 +26,12 @@ jobs:
       release_created: ${{ steps.release.outputs.release_created }}
       tag_name: ${{ steps.release.outputs.tag_name }}
     steps:
-      - uses: googleapis/release-please-action@v4
+      - uses: googleapis/release-please-action@v5
         id: release
         with:
+          # Repo default branch is develop; releases must target main only
+          # (feat → develop → TestPyPI → main → tag/PyPI).
+          target-branch: main
           release-type: python
           config-file: release-please-config.json
           manifest-file: .release-please-manifest.json
@@ -52,15 +59,17 @@ jobs:
           packages-dir: dist/
           print-hash: true
 
-  publish-testpypi-manual:
-    if: ${{ github.event_name == 'workflow_dispatch' && inputs.publish_to_testpypi }}
+  publish-pypi-manual:
+    if: ${{ github.event_name == 'workflow_dispatch' && inputs.publish_to_pypi }}
     runs-on: ubuntu-latest
-    environment: testpypi
+    environment: pypi
     permissions:
       id-token: write
       contents: read
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.publish_tag }}
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
@@ -69,7 +78,5 @@ jobs:
       - run: twine check --strict dist/*
       - uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          repository-url: https://test.pypi.org/legacy/
           packages-dir: dist/
-          skip-existing: true
           print-hash: true

{codexloop-0.1.0 → codexloop-0.3.0}/.gitignore

@@ -46,3 +46,4 @@ site/
 
 # --- SDD scratch ---
 .superpowers/
+.venv-docs/

codexloop-0.3.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.3.0"
+}

codexloop-0.3.0/CHANGELOG.md

@@ -0,0 +1,140 @@
+# Changelog
+
+## [0.3.0](https://github.com/adammatthewsteinberger/codexloop/compare/v0.2.0...v0.3.0) (2026-08-16)
+
+
+### Features
+
+* add a -v/-q verbosity ladder and third-party log control ([b58dfc0](https://github.com/adammatthewsteinberger/codexloop/commit/b58dfc017ce9af34af07cb390ea9a8efd67435d3))
+* add capacity forecasting (measurement only, disabled by default) ([c2a362b](https://github.com/adammatthewsteinberger/codexloop/commit/c2a362bcbd111e7f87e5fb2534eb1687e50dc42d))
+* add the wind-down decision to the run loop state machine ([033b5b2](https://github.com/adammatthewsteinberger/codexloop/commit/033b5b2ecece721832f31cd08e103738c193c812))
+* let the caller name a run with --run-id ([e22c2d0](https://github.com/adammatthewsteinberger/codexloop/commit/e22c2d05c03db5be84ecbbd544da418130c1023c))
+
+
+### Bug Fixes
+
+* **tests:** remove residual SHA-collision flake in savepoints test ([#20](https://github.com/adammatthewsteinberger/codexloop/issues/20)) ([b375f71](https://github.com/adammatthewsteinberger/codexloop/commit/b375f71ba5ebda62f178bdc39bb619418932dedf))
+
+## [0.3.0](https://github.com/adammatthewsteinberger/codexloop/compare/v0.2.0...v0.3.0) (2026-08-16)
+
+
+### Features
+
+* add a -v/-q verbosity ladder and third-party log control ([b58dfc0](https://github.com/adammatthewsteinberger/codexloop/commit/b58dfc017ce9af34af07cb390ea9a8efd67435d3))
+* add capacity forecasting (measurement only, disabled by default) ([c2a362b](https://github.com/adammatthewsteinberger/codexloop/commit/c2a362bcbd111e7f87e5fb2534eb1687e50dc42d))
+* add the wind-down decision to the run loop state machine ([033b5b2](https://github.com/adammatthewsteinberger/codexloop/commit/033b5b2ecece721832f31cd08e103738c193c812))
+* let the caller name a run with --run-id ([e22c2d0](https://github.com/adammatthewsteinberger/codexloop/commit/e22c2d05c03db5be84ecbbd544da418130c1023c))
+
+
+### Bug Fixes
+
+* **tests:** remove residual SHA-collision flake in savepoints test ([#20](https://github.com/adammatthewsteinberger/codexloop/issues/20)) ([b375f71](https://github.com/adammatthewsteinberger/codexloop/commit/b375f71ba5ebda62f178bdc39bb619418932dedf))
+
+## [0.2.0](https://github.com/adammatthewsteinberger/codexloop/compare/v0.1.1...v0.2.0) (2026-08-14)
+
+
+### Features
+
+* add app-server rate-limit probe client ([a30ef93](https://github.com/adammatthewsteinberger/codexloop/commit/a30ef9377685ef9aea8f5096e1759b0f6293574e))
+* add application ports and fakes ([33e721d](https://github.com/adammatthewsteinberger/codexloop/commit/33e721d0dab21b38c614ab71ea7c3e47a8126fb3))
+* add autonomous runner and run/resume use cases ([bd36f45](https://github.com/adammatthewsteinberger/codexloop/commit/bd36f457548c5969f0fd37453c2d1ab5727d3302))
+* add backoff and adaptive wait policy ([43c70c6](https://github.com/adammatthewsteinberger/codexloop/commit/43c70c68396255e10c61907497c53dd0d1c2ba63))
+* add bootstrap and core CLI commands ([6b6aafc](https://github.com/adammatthewsteinberger/codexloop/commit/6b6aafc94f8d2513282389f154682b1b5a97bcee))
+* add capacity value objects ([1aa3fed](https://github.com/adammatthewsteinberger/codexloop/commit/1aa3fede743d6c5db518f869d03826788c64da5b))
+* add clock, logging, config, rundir, state, and lock adapters ([8f7e4ad](https://github.com/adammatthewsteinberger/codexloop/commit/8f7e4ad1aad0f9a754e7ff5777898bfe5a35c5cd))
+* add codex argv builder ([42ab842](https://github.com/adammatthewsteinberger/codexloop/commit/42ab8426e676b0c6b59bb655bfc94e4a607338ba))
+* add control plane, savepoints, and ops CLI ([512e03f](https://github.com/adammatthewsteinberger/codexloop/commit/512e03f24eddf226425326b992eacc4732f1bc7b))
+* add ephemeral read-only exec capacity probe ([427620b](https://github.com/adammatthewsteinberger/codexloop/commit/427620bda645389caf571bcef010d269d3457093))
+* add error hierarchy and OpenAI error-code taxonomy ([1bf5aa2](https://github.com/adammatthewsteinberger/codexloop/commit/1bf5aa2f2805c80aeba0f37fbe6da1dcb4a59585))
+* add generated OpenAI REST CLI surface with drift gate ([53320f8](https://github.com/adammatthewsteinberger/codexloop/commit/53320f82512869b43075d6eeaf3f6fe73a06a3dd))
+* add optional app-server gateway, stream UI, docs, and release scaffolding ([23bfddf](https://github.com/adammatthewsteinberger/codexloop/commit/23bfddfb169cfb37e8fe60a9a80bd7f9b644bba9))
+* add plan, budget, session, profile, approval, and control types ([07a8188](https://github.com/adammatthewsteinberger/codexloop/commit/07a8188207fa6fbac5f85114d891b266b6be1bf9))
+* add read-only CODEX_HOME rollout tail ([071d6ab](https://github.com/adammatthewsteinberger/codexloop/commit/071d6abe526935893d7d330909e96a308e5203b2))
+* add run-loop state machine ([582144f](https://github.com/adammatthewsteinberger/codexloop/commit/582144fcd2b5d3c327f6af36c74307a9a8818966))
+* add scripted system harness and test-agent gate ([68a7ebf](https://github.com/adammatthewsteinberger/codexloop/commit/68a7ebf9483013f5e7fae4ff98ff2b0f5da843f0))
+* add three-layer completion evaluation ([eee2cc3](https://github.com/adammatthewsteinberger/codexloop/commit/eee2cc3a70562126c438e1a1ba842abca9aa0db6))
+* classify turn signals into capacity states ([f7c4162](https://github.com/adammatthewsteinberger/codexloop/commit/f7c4162048b62f83a7b7ea3f99474605f18376ef))
+* implement codexloop M1–M5 (onion runner + REST + docs) ([1dbef91](https://github.com/adammatthewsteinberger/codexloop/commit/1dbef9118097d8b8210f6a770df8c4c05956f6ce))
+* parse codex exec JSONL events ([1cdc76c](https://github.com/adammatthewsteinberger/codexloop/commit/1cdc76c754f0e0f023f7dc94472be59f9776d3f5))
+* supervise codex subprocess with concurrent pumps ([1c95f6e](https://github.com/adammatthewsteinberger/codexloop/commit/1c95f6e6fe628daefe0256e5ba5fb921bfd595a5))
+* translate JSONL and drive codex exec gateway ([6a1842c](https://github.com/adammatthewsteinberger/codexloop/commit/6a1842c3bab3b9eb57d052b2bb8f1c45b919b69f))
+* wire composite capacity probe and adaptive wait loop ([ab682b1](https://github.com/adammatthewsteinberger/codexloop/commit/ab682b16130829e3ae7a523597213c33509dec22))
+
+
+### Bug Fixes
+
+* jitter throttle waits above Retry-After ([666a4e6](https://github.com/adammatthewsteinberger/codexloop/commit/666a4e6c3d73f277946e866d33866091c225e1c8))
+* only break session locks for known-dead pids ([712b0f4](https://github.com/adammatthewsteinberger/codexloop/commit/712b0f4a4b25d83ba27c0ca53d8278e6961efbd9))
+* pin release-please to main ([4c974a2](https://github.com/adammatthewsteinberger/codexloop/commit/4c974a243f98d0790325929fd124c4aca72f04f7))
+* pin release-please to main and Node 24 action ([cf19789](https://github.com/adammatthewsteinberger/codexloop/commit/cf19789c9ed4fc179f88ef6176f8b05859d05cb8))
+* preserve remaining work across capacity-rejected turns ([d2d10c3](https://github.com/adammatthewsteinberger/codexloop/commit/d2d10c36a93084a36f48509433d9bb6865172fde))
+* resolve all-digit SHA prefixes as save-point SHAs ([43cdde7](https://github.com/adammatthewsteinberger/codexloop/commit/43cdde7d5f65910c06ef6273e64987a391ce0488))
+* seal onion contracts and order drain before signals ([cecf827](https://github.com/adammatthewsteinberger/codexloop/commit/cecf827e841d11df0fb34c71724415970da3ab7d))
+* stabilize CI help and process-group cancel tests ([3fe2c6d](https://github.com/adammatthewsteinberger/codexloop/commit/3fe2c6d09f94adb0de528a74364a0d9d177ee77b))
+* terminate fatals, apply mid-run controls, harden ops edges ([9171835](https://github.com/adammatthewsteinberger/codexloop/commit/91718359a07f5e25ffd1366c7ea8bbfba51b0a01))
+* treat ControlCommand as the inbox union and wrap parse errors ([0885204](https://github.com/adammatthewsteinberger/codexloop/commit/08852040d2a48a14eb5b7b750fa5d02bb9314e4b))
+* unstick version CI and keep TestPyPI on develop ([a4cf78e](https://github.com/adammatthewsteinberger/codexloop/commit/a4cf78eb32a622af03f707a5654c8da708a81f83))
+* version CI + TestPyPI only from develop ([01d7695](https://github.com/adammatthewsteinberger/codexloop/commit/01d7695de87849b949ffd6e275b1f79126f9f2c6))
+
+
+### Documentation
+
+* deploy MkDocs site to GitHub Pages ([bce3384](https://github.com/adammatthewsteinberger/codexloop/commit/bce33843a1eb7f2579fea6d895b9966abcf5f11e))
+* GitHub Pages MkDocs site ([e1c286b](https://github.com/adammatthewsteinberger/codexloop/commit/e1c286bef14b63f5b337548eb99bad94b917f21a))
+
+## [0.1.1](https://github.com/adammatthewsteinberger/codexloop/compare/v0.1.0...v0.1.1) (2026-08-14)
+
+
+### Bug Fixes
+
+* pin release-please to main ([4c974a2](https://github.com/adammatthewsteinberger/codexloop/commit/4c974a243f98d0790325929fd124c4aca72f04f7))
+* pin release-please to main and Node 24 action ([cf19789](https://github.com/adammatthewsteinberger/codexloop/commit/cf19789c9ed4fc179f88ef6176f8b05859d05cb8))
+* unstick version CI and keep TestPyPI on develop ([a4cf78e](https://github.com/adammatthewsteinberger/codexloop/commit/a4cf78eb32a622af03f707a5654c8da708a81f83))
+* version CI + TestPyPI only from develop ([01d7695](https://github.com/adammatthewsteinberger/codexloop/commit/01d7695de87849b949ffd6e275b1f79126f9f2c6))
+
+
+### Documentation
+
+* deploy MkDocs site to GitHub Pages ([bce3384](https://github.com/adammatthewsteinberger/codexloop/commit/bce33843a1eb7f2579fea6d895b9966abcf5f11e))
+* GitHub Pages MkDocs site ([e1c286b](https://github.com/adammatthewsteinberger/codexloop/commit/e1c286bef14b63f5b337548eb99bad94b917f21a))
+
+## 0.1.0 (2026-08-13)
+
+
+### Features
+
+* add app-server rate-limit probe client ([a30ef93](https://github.com/adammatthewsteinberger/codexloop/commit/a30ef9377685ef9aea8f5096e1759b0f6293574e))
+* add application ports and fakes ([33e721d](https://github.com/adammatthewsteinberger/codexloop/commit/33e721d0dab21b38c614ab71ea7c3e47a8126fb3))
+* add autonomous runner and run/resume use cases ([bd36f45](https://github.com/adammatthewsteinberger/codexloop/commit/bd36f457548c5969f0fd37453c2d1ab5727d3302))
+* add backoff and adaptive wait policy ([43c70c6](https://github.com/adammatthewsteinberger/codexloop/commit/43c70c68396255e10c61907497c53dd0d1c2ba63))
+* add bootstrap and core CLI commands ([6b6aafc](https://github.com/adammatthewsteinberger/codexloop/commit/6b6aafc94f8d2513282389f154682b1b5a97bcee))
+* add capacity value objects ([1aa3fed](https://github.com/adammatthewsteinberger/codexloop/commit/1aa3fede743d6c5db518f869d03826788c64da5b))
+* add clock, logging, config, rundir, state, and lock adapters ([8f7e4ad](https://github.com/adammatthewsteinberger/codexloop/commit/8f7e4ad1aad0f9a754e7ff5777898bfe5a35c5cd))
+* add codex argv builder ([42ab842](https://github.com/adammatthewsteinberger/codexloop/commit/42ab8426e676b0c6b59bb655bfc94e4a607338ba))
+* add control plane, savepoints, and ops CLI ([512e03f](https://github.com/adammatthewsteinberger/codexloop/commit/512e03f24eddf226425326b992eacc4732f1bc7b))
+* add ephemeral read-only exec capacity probe ([427620b](https://github.com/adammatthewsteinberger/codexloop/commit/427620bda645389caf571bcef010d269d3457093))
+* add error hierarchy and OpenAI error-code taxonomy ([1bf5aa2](https://github.com/adammatthewsteinberger/codexloop/commit/1bf5aa2f2805c80aeba0f37fbe6da1dcb4a59585))
+* add generated OpenAI REST CLI surface with drift gate ([53320f8](https://github.com/adammatthewsteinberger/codexloop/commit/53320f82512869b43075d6eeaf3f6fe73a06a3dd))
+* add optional app-server gateway, stream UI, docs, and release scaffolding ([23bfddf](https://github.com/adammatthewsteinberger/codexloop/commit/23bfddfb169cfb37e8fe60a9a80bd7f9b644bba9))
+* add plan, budget, session, profile, approval, and control types ([07a8188](https://github.com/adammatthewsteinberger/codexloop/commit/07a8188207fa6fbac5f85114d891b266b6be1bf9))
+* add read-only CODEX_HOME rollout tail ([071d6ab](https://github.com/adammatthewsteinberger/codexloop/commit/071d6abe526935893d7d330909e96a308e5203b2))
+* add run-loop state machine ([582144f](https://github.com/adammatthewsteinberger/codexloop/commit/582144fcd2b5d3c327f6af36c74307a9a8818966))
+* add scripted system harness and test-agent gate ([68a7ebf](https://github.com/adammatthewsteinberger/codexloop/commit/68a7ebf9483013f5e7fae4ff98ff2b0f5da843f0))
+* add three-layer completion evaluation ([eee2cc3](https://github.com/adammatthewsteinberger/codexloop/commit/eee2cc3a70562126c438e1a1ba842abca9aa0db6))
+* classify turn signals into capacity states ([f7c4162](https://github.com/adammatthewsteinberger/codexloop/commit/f7c4162048b62f83a7b7ea3f99474605f18376ef))
+* implement codexloop M1–M5 (onion runner + REST + docs) ([1dbef91](https://github.com/adammatthewsteinberger/codexloop/commit/1dbef9118097d8b8210f6a770df8c4c05956f6ce))
+* parse codex exec JSONL events ([1cdc76c](https://github.com/adammatthewsteinberger/codexloop/commit/1cdc76c754f0e0f023f7dc94472be59f9776d3f5))
+* supervise codex subprocess with concurrent pumps ([1c95f6e](https://github.com/adammatthewsteinberger/codexloop/commit/1c95f6e6fe628daefe0256e5ba5fb921bfd595a5))
+* translate JSONL and drive codex exec gateway ([6a1842c](https://github.com/adammatthewsteinberger/codexloop/commit/6a1842c3bab3b9eb57d052b2bb8f1c45b919b69f))
+* wire composite capacity probe and adaptive wait loop ([ab682b1](https://github.com/adammatthewsteinberger/codexloop/commit/ab682b16130829e3ae7a523597213c33509dec22))
+
+
+### Bug Fixes
+
+* jitter throttle waits above Retry-After ([666a4e6](https://github.com/adammatthewsteinberger/codexloop/commit/666a4e6c3d73f277946e866d33866091c225e1c8))
+* only break session locks for known-dead pids ([712b0f4](https://github.com/adammatthewsteinberger/codexloop/commit/712b0f4a4b25d83ba27c0ca53d8278e6961efbd9))
+* preserve remaining work across capacity-rejected turns ([d2d10c3](https://github.com/adammatthewsteinberger/codexloop/commit/d2d10c36a93084a36f48509433d9bb6865172fde))
+* seal onion contracts and order drain before signals ([cecf827](https://github.com/adammatthewsteinberger/codexloop/commit/cecf827e841d11df0fb34c71724415970da3ab7d))
+* stabilize CI help and process-group cancel tests ([3fe2c6d](https://github.com/adammatthewsteinberger/codexloop/commit/3fe2c6d09f94adb0de528a74364a0d9d177ee77b))
+* terminate fatals, apply mid-run controls, harden ops edges ([9171835](https://github.com/adammatthewsteinberger/codexloop/commit/91718359a07f5e25ffd1366c7ea8bbfba51b0a01))
+* treat ControlCommand as the inbox union and wrap parse errors ([0885204](https://github.com/adammatthewsteinberger/codexloop/commit/08852040d2a48a14eb5b7b750fa5d02bb9314e4b))

{codexloop-0.1.0 → codexloop-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codexloop
-Version: 0.1.0
+Version: 0.3.0
 Summary: Onion-architected, autonomous OpenAI Codex session runner — never blocks on a human, distinguishes rate limits from exhausted credits, and resumes safely across usage windows.
 Project-URL: Homepage, https://github.com/adammatthewsteinberger/codexloop
 Project-URL: Repository, https://github.com/adammatthewsteinberger/codexloop
@@ -56,18 +56,26 @@ Autonomous OpenAI Codex / GPT session runner. Same job as
 a human, and never treat `insufficient_quota` / billing as a waitable
 `rate_limit_exceeded` window.
 
-**Status:** M1–M5 implemented on `feat/m1-pure-core` (onion core, exec gateway,
-capacity probes, control plane, generated REST CLI, optional app-server transport
-with exec fallback). MIT-licensed; author Adam Matthew Steinberger.
+**Docs:** https://adammatthewsteinberger.github.io/codexloop/
+
+**Status:** M1–M5 on PyPI (`0.1.0`) — onion core, exec gateway, capacity probes,
+control plane, generated REST CLI, optional app-server transport with exec
+fallback. MIT-licensed; author Adam Matthew Steinberger.
 
 ## Install
 
 ```bash
-pip install -e ".[dev]"
+pip install codexloop
 codexloop --version
 codexloop doctor
 ```
 
+For local development:
+
+```bash
+pip install -e ".[dev]"
+```
+
 ## Quick start
 
 ```bash

{codexloop-0.1.0 → codexloop-0.3.0}/README.md

@@ -5,18 +5,26 @@ Autonomous OpenAI Codex / GPT session runner. Same job as
 a human, and never treat `insufficient_quota` / billing as a waitable
 `rate_limit_exceeded` window.
 
-**Status:** M1–M5 implemented on `feat/m1-pure-core` (onion core, exec gateway,
-capacity probes, control plane, generated REST CLI, optional app-server transport
-with exec fallback). MIT-licensed; author Adam Matthew Steinberger.
+**Docs:** https://adammatthewsteinberger.github.io/codexloop/
+
+**Status:** M1–M5 on PyPI (`0.1.0`) — onion core, exec gateway, capacity probes,
+control plane, generated REST CLI, optional app-server transport with exec
+fallback. MIT-licensed; author Adam Matthew Steinberger.
 
 ## Install
 
 ```bash
-pip install -e ".[dev]"
+pip install codexloop
 codexloop --version
 codexloop doctor
 ```
 
+For local development:
+
+```bash
+pip install -e ".[dev]"
+```
+
 ## Quick start
 
 ```bash

codexloop-0.3.0/docs/publishing.md

@@ -0,0 +1,74 @@
+# Publishing
+
+`codexloop` ships via [Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
+(OIDC). No long-lived PyPI API tokens are stored in GitHub.
+
+## Environments
+
+| GitHub Environment | Index | Branch / workflow |
+|---|---|---|
+| `testpypi` | https://test.pypi.org | **`develop`** → `.github/workflows/publish-testpypi.yml` |
+| `pypi` | https://pypi.org | **`main`** → `.github/workflows/release-please.yml` (`publish-pypi`) |
+
+Create them once (repo **Settings → Environments**), or via API as in the
+setup checklist below.
+
+## One-time Trusted Publisher setup
+
+Do this **before** the first upload (pending publisher), signed in as the PyPI
+owner account.
+
+### TestPyPI
+
+1. Open https://test.pypi.org/manage/account/publishing/
+2. Add a pending publisher:
+   - **PyPI Project Name:** `codexloop`
+   - **Owner:** `adammatthewsteinberger`
+   - **Repository name:** `codexloop`
+   - **Workflow name:** `publish-testpypi.yml`
+   - **Environment name:** `testpypi`
+
+### PyPI
+
+1. Open https://pypi.org/manage/account/publishing/
+2. Add a pending publisher:
+   - **PyPI Project Name:** `codexloop`
+   - **Owner:** `adammatthewsteinberger`
+   - **Repository name:** `codexloop`
+   - **Workflow name:** `release-please.yml`
+   - **Environment name:** `pypi`
+
+## Release flow
+
+```text
+feat/* ──PR──► develop ──auto TestPyPI──► main ──release-please──► PyPI
+```
+
+1. Land work on `develop`. Every push to `develop` runs **Publish TestPyPI**
+   (`publish-testpypi.yml`). Do not publish TestPyPI from `main`.
+2. Smoke-install from TestPyPI if needed:
+   `pip install -i https://test.pypi.org/simple/ --pre codexloop`.
+3. Merge `develop` → `main` when ready.
+4. `release-please` opens a release PR against **`main` only**
+   (`target-branch: main` in `.github/workflows/release-please.yml`).
+5. Squash-merge the release PR → GitHub Release + tag → `publish-pypi`
+   uploads to **PyPI**. Do not open or merge `chore(develop): release …` PRs.
+
+Manual PyPI retry (Trusted Publishing, `main` / tagged release only):
+
+```bash
+gh workflow run release-please.yml -f publish_to_pypi=true
+```
+
+Manual TestPyPI from `develop`:
+
+```bash
+gh workflow run "Publish TestPyPI" --ref develop
+```
+
+## Local dry-run (no upload)
+
+```bash
+python -m build
+twine check --strict dist/*
+```

codexloop-0.3.0/mkdocs.yml

@@ -0,0 +1,44 @@
+site_name: codexloop
+site_description: Autonomous OpenAI Codex session runner
+site_url: https://adammatthewsteinberger.github.io/codexloop/
+repo_url: https://github.com/adammatthewsteinberger/codexloop
+repo_name: adammatthewsteinberger/codexloop
+theme:
+  name: material
+  features:
+    - navigation.sections
+    - content.code.copy
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - toc:
+      permalink: true
+exclude_docs: |
+  plans/**
+  superpowers/**
+nav:
+  - Home: index.md
+  - Getting started: getting-started.md
+  - Guides:
+      - REST API surface: guides/rest-api-surface.md
+  - Architecture:
+      - Overview: architecture/index.md
+      - ADRs:
+          - Index: architecture/adr/index.md
+          - "0001 Onion import-linter": architecture/adr/0001-onion-import-linter.md
+          - "0002 Subprocess codex exec": architecture/adr/0002-subprocess-codex-exec.md
+          - "0003 Credits exhausted": architecture/adr/0003-credits-exhausted.md
+          - "0004 Adaptive probe loop": architecture/adr/0004-adaptive-probe-loop.md
+          - "0005 Layered capacity probe": architecture/adr/0005-layered-capacity-probe.md
+          - "0006 Generated OpenAI REST": architecture/adr/0006-generated-openai-rest.md
+          - "0007 Default approval/sandbox": architecture/adr/0007-default-approval-sandbox.md
+          - "0008 Policy via -c flags": architecture/adr/0008-policy-via-c-flags.md
+          - "0009 Optional app-server": architecture/adr/0009-optional-app-server.md
+          - "0010 Rollout best-effort": architecture/adr/0010-rollout-best-effort.md
+          - "0011 Never consume resets": architecture/adr/0011-never-consume-resets.md
+          - "0012 Minimum Codex version": architecture/adr/0012-minimum-codex-version.md
+  - Reference: reference/cli.md
+  - Contributing: contributing.md
+  - Publishing: publishing.md
+strict: true

{codexloop-0.1.0 → codexloop-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codexloop"
-version = "0.1.0"
+version = "0.3.0"
 description = "Onion-architected, autonomous OpenAI Codex session runner — never blocks on a human, distinguishes rate limits from exhausted credits, and resumes safely across usage windows."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -173,3 +173,16 @@ forbidden_modules = [
     "docker",
     "sqlalchemy",
 ]
+
+
+[[tool.importlinter.contracts]]
+name = "Interfaces declare seams, never consume them"
+type = "forbidden"
+source_modules = ["codexloop.application.interfaces"]
+forbidden_modules = [
+    "codexloop.application.runner",
+    "codexloop.application.usecases",
+    "codexloop.infrastructure",
+    "codexloop.cli",
+    "codexloop.bootstrap",
+]

{codexloop-0.1.0 → codexloop-0.3.0}/src/codexloop/__init__.py

@@ -1,3 +1,3 @@
 """codexloop — onion-architected, autonomous OpenAI Codex session runner."""
 
-__version__ = "0.1.0"
+__version__ = "0.3.0"

codexloop-0.3.0/src/codexloop/application/interfaces/__init__.py

@@ -0,0 +1,75 @@
+"""Application interfaces -- every seam implemented by infrastructure/ and
+never imported from it.
+
+One module per collaborator family so a reader finds a seam by what it does
+rather than by scrolling one long file. `application/ports.py` re-exports
+this package unchanged, so existing imports keep working.
+"""
+
+from __future__ import annotations
+
+from codexloop.application.interfaces.agent import (
+    AgentGateway,
+    CapacityProbe,
+    RunResources,
+    ThreadCatalog,
+)
+from codexloop.application.interfaces.api import (
+    ApiGateway,
+)
+from codexloop.application.interfaces.control import (
+    ControlInbox,
+    RunControl,
+)
+from codexloop.application.interfaces.doctor import (
+    DoctorCheck,
+    DoctorEnvironment,
+    DoctorReport,
+)
+from codexloop.application.interfaces.observability import (
+    AuditLog,
+    Logger,
+    Notifier,
+    ProgressReporter,
+    RunEventSink,
+    StateBus,
+)
+from codexloop.application.interfaces.permissions import (
+    PermissionMode,
+)
+from codexloop.application.interfaces.storage import (
+    RunSnapshotSink,
+    RunStateStore,
+    SavePointStore,
+    SessionLock,
+)
+from codexloop.application.interfaces.system import (
+    Clock,
+    Sleeper,
+)
+
+__all__ = [
+    "AgentGateway",
+    "ApiGateway",
+    "AuditLog",
+    "CapacityProbe",
+    "Clock",
+    "ControlInbox",
+    "DoctorCheck",
+    "DoctorEnvironment",
+    "DoctorReport",
+    "Logger",
+    "Notifier",
+    "PermissionMode",
+    "ProgressReporter",
+    "RunControl",
+    "RunEventSink",
+    "RunResources",
+    "RunSnapshotSink",
+    "RunStateStore",
+    "SavePointStore",
+    "SessionLock",
+    "Sleeper",
+    "StateBus",
+    "ThreadCatalog",
+]

codexloop-0.3.0/src/codexloop/application/interfaces/agent.py

@@ -0,0 +1,46 @@
+"""The vendor session seam: sending turns, probing capacity, enumerating
+sessions, and the run-scoped resources attached to one."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping, Sequence
+from typing import Protocol, runtime_checkable
+
+from codexloop.application.dto import ProbeResult, TurnOutcome
+from codexloop.application.interfaces.permissions import PermissionMode
+from codexloop.domain.model_profile import ModelEffortProfile
+from codexloop.domain.session import ThreadRef
+
+
+@runtime_checkable
+class AgentGateway(Protocol):
+    """Vendor-agnostic agent session (exec and app-server adapters implement this)."""
+
+    async def send_turn(self, prompt: str) -> TurnOutcome: ...
+    async def close(self) -> None: ...
+    async def set_profile(self, profile: ModelEffortProfile) -> None: ...
+    async def set_permission_mode(self, mode: PermissionMode) -> None: ...
+    async def set_cwd(self, path: str) -> None: ...
+    async def set_session_resources(self, resources: Mapping[str, object]) -> None: ...
+    def resolve_tool_approval(self, request_id: str, *, allow: bool, reason: str = "") -> bool: ...
+
+
+@runtime_checkable
+class CapacityProbe(Protocol):
+    async def probe(self) -> ProbeResult: ...
+
+
+@runtime_checkable
+class ThreadCatalog(Protocol):
+    """Our run registry keyed by ``thread_id``, not vendor session discovery."""
+
+    def list_threads(self) -> Sequence[ThreadRef]: ...
+    def get(self, thread_id: str) -> ThreadRef | None: ...
+    def record(self, ref: ThreadRef) -> None: ...
+
+
+@runtime_checkable
+class RunResources(Protocol):
+    """Placeholder for run-scoped attachments applied mid-run."""
+
+    def as_payload(self) -> Mapping[str, object]: ...