codexloop 0.1.0__tar.gz → 0.2.0__tar.gz

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

@@ -37,6 +37,18 @@ jobs:
       - run: pip-audit
       - run: pytest --cov-report=term-missing
 
+  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
+
   build:
     name: Package builds and is installable
     runs-on: ubuntu-latest

codexloop-0.2.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.2.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.2.0}/.github/workflows/release-please.yml

@@ -5,8 +5,8 @@ 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
 
@@ -22,9 +22,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 +55,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: v0.1.0
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
@@ -69,7 +74,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.2.0}/.gitignore

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

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

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

codexloop-0.2.0/CHANGELOG.md

@@ -0,0 +1,110 @@
+# Changelog
+
+## [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.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codexloop
-Version: 0.1.0
+Version: 0.2.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.2.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.2.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.2.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.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codexloop"
-version = "0.1.0"
+version = "0.2.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"

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

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

{codexloop-0.1.0 → codexloop-0.2.0}/src/codexloop/infrastructure/git_savepoints.py

@@ -148,15 +148,19 @@ class GitSavePointStore:
             handle.write(json.dumps(entry) + "\n")
 
     def _resolve_target(self, points: list[SavePointRef], to: str) -> SavePointRef:
+        # Numeric save-point indexes (``1``, ``2``, …) are accepted, but a
+        # shortened SHA can be all digits (e.g. ``4158599``). Prefer an exact
+        # index hit, then fall through to SHA/ref/label matching.
         if to.isdigit():
             n = int(to)
             for point in points:
                 if point.n == n:
                     return point
-            raise ValueError(f"no save point numbered {n}")
         for point in points:
             if point.ref == to or point.sha.startswith(to) or point.label == to:
                 return point
+        if to.isdigit():
+            raise ValueError(f"no save point numbered {int(to)}")
         raise ValueError(f"no save point matching {to!r}")
 
     def _is_git_repo(self) -> bool:

{codexloop-0.1.0 → codexloop-0.2.0}/tests/cli/test_app.py

@@ -9,6 +9,7 @@ from pathlib import Path
 import pytest
 from typer.testing import CliRunner
 
+from codexloop import __version__
 from codexloop.application.dto import RunResult
 from codexloop.cli.app import app
 from codexloop.domain.control import Stop
@@ -58,7 +59,8 @@ def _plain(text: str) -> str:
 def test_version_prints_package_version() -> None:
     result = _invoke("--version")
     assert result.exit_code == 0
-    assert "0.1.0" in result.output
+    assert __version__ in result.output
+    assert result.output.strip() == f"codexloop {__version__}"
 
 
 def test_help_lists_every_command() -> None:

{codexloop-0.1.0 → codexloop-0.2.0}/tests/infrastructure/test_coverage_boost.py

@@ -11,6 +11,7 @@ from pathlib import Path
 import pytest
 
 from codexloop.domain.errors import ConfigurationError
+from codexloop.domain.savepoint import SavePointRef
 from codexloop.infrastructure.agent import events as events_mod
 from codexloop.infrastructure.agent.process import _StdoutCollector
 from codexloop.infrastructure.clock import AnyioSleeper, SystemClock
@@ -179,6 +180,24 @@ def test_git_savepoints_list_unwind_and_errors(tmp_path: Path) -> None:
     assert store2._staged_paths() == ()
 
 
+def test_resolve_target_accepts_all_digit_sha_prefix(tmp_path: Path) -> None:
+    """Short SHAs can be decimal-only; do not treat them as save-point indexes."""
+    store = GitSavePointStore(cwd=tmp_path, index_path=tmp_path / "idx.jsonl")
+    point = SavePointRef(
+        n=1,
+        ref="refs/codexloop/r1/1",
+        sha="41585994ef67172a1b376616357ca2b92f4cb33d",
+        label="turn",
+        at=datetime.now(UTC),
+        plan_item=None,
+        committed=True,
+    )
+    assert store._resolve_target([point], "4158599") is point
+    assert store._resolve_target([point], "1") is point
+    with pytest.raises(ValueError, match="numbered"):
+        store._resolve_target([point], "99")
+
+
 def test_git_savepoints_missing_index_file(tmp_path: Path) -> None:
     store = GitSavePointStore(cwd=tmp_path, index_path=tmp_path / "missing.jsonl")
     store._index_path.unlink()

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

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

codexloop-0.1.0/CHANGELOG.md

@@ -1,42 +0,0 @@
-# Changelog
-
-## 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/docs/publishing.md

@@ -1,65 +0,0 @@
-# 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 | Workflow |
-|---|---|---|
-| `testpypi` | https://test.pypi.org | `.github/workflows/publish-testpypi.yml` |
-| `pypi` | https://pypi.org | `.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 ──smoke TestPyPI──► main ──release-please──► PyPI
-```
-
-1. Land work on `develop` (or merge feature → `main` for the bootstrap release).
-2. Push/`workflow_dispatch` **Publish TestPyPI** to verify the wheel on
-   TestPyPI (`pip install -i https://test.pypi.org/simple/ --pre codexloop`).
-3. Merge to `main`.
-4. `release-please` opens a release PR from Conventional Commits.
-5. Merge the release PR → GitHub Release + tag → `publish-pypi` uploads to PyPI.
-
-Manual TestPyPI from `main`:
-
-```bash
-gh workflow run release-please.yml -f publish_to_testpypi=true
-```
-
-## Local dry-run (no upload)
-
-```bash
-python -m build
-twine check --strict dist/*
-```