aepkit 0.7.3__tar.gz → 0.7.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. {aepkit-0.7.3 → aepkit-0.7.4}/CHANGELOG.md +26 -1
  2. {aepkit-0.7.3/src/aepkit.egg-info → aepkit-0.7.4}/PKG-INFO +3 -3
  3. {aepkit-0.7.3 → aepkit-0.7.4}/README.md +2 -2
  4. {aepkit-0.7.3 → aepkit-0.7.4}/references/autonomous-mode.md +13 -0
  5. aepkit-0.7.4/src/aepkit/__init__.py +1 -0
  6. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/skill/references/autonomous-mode.md +13 -0
  7. {aepkit-0.7.3 → aepkit-0.7.4/src/aepkit.egg-info}/PKG-INFO +3 -3
  8. aepkit-0.7.3/src/aepkit/__init__.py +0 -1
  9. {aepkit-0.7.3 → aepkit-0.7.4}/LICENSE +0 -0
  10. {aepkit-0.7.3 → aepkit-0.7.4}/MANIFEST.in +0 -0
  11. {aepkit-0.7.3 → aepkit-0.7.4}/SKILL.md +0 -0
  12. {aepkit-0.7.3 → aepkit-0.7.4}/pyproject.toml +0 -0
  13. {aepkit-0.7.3 → aepkit-0.7.4}/references/failure-modes-and-example.md +0 -0
  14. {aepkit-0.7.3 → aepkit-0.7.4}/references/handoffs.md +0 -0
  15. {aepkit-0.7.3 → aepkit-0.7.4}/references/tasks-and-gates.md +0 -0
  16. {aepkit-0.7.3 → aepkit-0.7.4}/setup.cfg +0 -0
  17. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/__main__.py +0 -0
  18. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/cli.py +0 -0
  19. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/install_skill.py +0 -0
  20. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/lint.py +0 -0
  21. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/negcontrol.py +0 -0
  22. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/py.typed +0 -0
  23. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/scaffold.py +0 -0
  24. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/skill/SKILL.md +0 -0
  25. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/skill/references/failure-modes-and-example.md +0 -0
  26. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/skill/references/handoffs.md +0 -0
  27. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/skill/references/tasks-and-gates.md +0 -0
  28. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/status.py +0 -0
  29. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/templates/compliance-log.md +0 -0
  30. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/templates/execution-guide.md +0 -0
  31. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit/templates/plan-of-record.md +0 -0
  32. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit.egg-info/SOURCES.txt +0 -0
  33. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit.egg-info/dependency_links.txt +0 -0
  34. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit.egg-info/entry_points.txt +0 -0
  35. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit.egg-info/requires.txt +0 -0
  36. {aepkit-0.7.3 → aepkit-0.7.4}/src/aepkit.egg-info/top_level.txt +0 -0
  37. {aepkit-0.7.3 → aepkit-0.7.4}/tests/run.py +0 -0
  38. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_cli.py +0 -0
  39. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_install_skill.py +0 -0
  40. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_lint.py +0 -0
  41. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_negcontrol.py +0 -0
  42. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_readme_claims.py +0 -0
  43. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_scaffold.py +0 -0
  44. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_skill_sync.py +0 -0
  45. {aepkit-0.7.3 → aepkit-0.7.4}/tests/test_status.py +0 -0
@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.7.4] - 2026-11-08
11
+
12
+ ### Added
13
+ - `references/autonomous-mode.md`: "Tool versions at the start of a run". Before the first task
14
+ the Auditor updates the tools the run depends on (`aepkit`, any plugin or harness) and records
15
+ their versions in the plan of record; the Auditor brief gains a `TOOLS` field for it.
16
+ - `aeprogress` 0.4.0:
17
+ - Expandable phases: each phase row opens its full title, its bar and count, and its tasks and
18
+ gate as state chips (approved, conditional, in progress with the worker, awaiting audit,
19
+ pending, rejected). The active phase opens by itself; a phase the owner closes stays closed.
20
+ Where the surface reports hover (desktop app, fullscreen terminal), a closed phase shows the
21
+ same in a card.
22
+ - Update check: the pane and `/aeprogress` say when a newer version exists, from the
23
+ marketplace catalog Claude Code keeps on disk and, at most once a day, from the version
24
+ published on GitHub (one request for a public file; option **Update check**: `daily`,
25
+ `offline` or `off`; skipped for copies from the claude.ai directory and when
26
+ `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` is set). The README explains how to turn on
27
+ auto-update for this marketplace.
28
+ - An icon (`.claude-plugin/icon.png`, source in `assets/icon.svg`), and `documentationUrl`,
29
+ `supportUrl` and `privacyPolicyUrl` in `plugin.json`, for the plugin directory. The README
30
+ gains "What it does on your machine" (every process it starts, the files and variables it
31
+ reads, the one network request, and what it can refuse) and "Privacy", and shows its
32
+ screenshots as Markdown images inside the plugin.
33
+
10
34
  ## [0.7.3] - 2026-11-08
11
35
 
12
36
  No change to the package's code. This release puts the new README on PyPI: the protocol's
@@ -369,7 +393,8 @@ Fixes from an independent review of 0.3.0.
369
393
  - Multi-framework agent installation support for Antigravity, Claude Code, and Cursor.
370
394
  - Zero-dependency test runner (`tests/run.py`).
371
395
 
372
- [Unreleased]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.3...HEAD
396
+ [Unreleased]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.4...HEAD
397
+ [0.7.4]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.3...v0.7.4
373
398
  [0.7.3]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.2...v0.7.3
374
399
  [0.7.2]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.1...v0.7.2
375
400
  [0.7.1]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.0...v0.7.1
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aepkit
3
- Version: 0.7.3
3
+ Version: 0.7.4
4
4
  Summary: Mechanical support for the Auditor/Executor protocol: scaffold, lint, and negative-control the document set for a multi-phase, multi-agent execution.
5
5
  Author-email: tBeltty <jhonatan@tbelt.online>
6
6
  License-Expression: MIT
@@ -183,7 +183,7 @@ A failure only proves something if it is the failure you meant. A syntax error,
183
183
 
184
184
  `aeprogress` is a Claude Code mod for runs where the Auditor launches Executors as subagents or as workers of a harness such as Orca. The protocol does not depend on it, and it reads the run only through `aepkit status --json`.
185
185
 
186
- <img src="https://raw.githubusercontent.com/tBeltty/auditor-executor-protocol/main/integrations/claude-code/aeprogress/assets/pane.png" alt="The aeprogress pane: 43.3% overall, a bar per phase, P2-T3 in progress on a subagent, P2-T4 awaiting audit, P2-T2 conditional, and the machine at 31% with 1 of 2 workers live" width="420">
186
+ <img src="https://raw.githubusercontent.com/tBeltty/auditor-executor-protocol/main/integrations/claude-code/aeprogress/assets/pane.png" alt="The aeprogress pane: 43.3% overall, a bar per phase, the active phase P2 open with its task chips, P2-T3 in progress on a subagent, P2-T4 awaiting audit and P2-T2 conditional" width="420">
187
187
 
188
188
  It does three things:
189
189
 
@@ -203,7 +203,7 @@ Install it at the prompt of a Claude Code terminal session, then open it:
203
203
  /aeprogress docs/<task-name>
204
204
  ```
205
205
 
206
- It works in the terminal and in the desktop app's local sessions (in the app: **+** next to the prompt, **Plugins**, **Add marketplace**). Every limit and feature is an option in `/config`. Claude Code marks its mod API as early access, so a Claude Code release can break it. Setup, options and how each number is computed: [integrations/claude-code/aeprogress](https://github.com/tBeltty/auditor-executor-protocol/tree/main/integrations/claude-code/aeprogress).
206
+ It works in the terminal and in the desktop app's local sessions (in the app: **+** next to the prompt, **Plugins**, **Add marketplace**). Every limit and feature is an option in `/config`. It needs Claude Code 2.1.287 or later and sends no data about you anywhere (its one network request, a daily version check, can be turned off); its README lists every process it starts and everything it can refuse. To get new versions on their own, turn on auto-update once: `/plugin`, **Marketplaces**, `auditor-executor-protocol`, **Enable auto-update**. Setup, options and how each number is computed: [integrations/claude-code/aeprogress](https://github.com/tBeltty/auditor-executor-protocol/tree/main/integrations/claude-code/aeprogress).
207
207
 
208
208
  ---
209
209
 
@@ -145,7 +145,7 @@ A failure only proves something if it is the failure you meant. A syntax error,
145
145
 
146
146
  `aeprogress` is a Claude Code mod for runs where the Auditor launches Executors as subagents or as workers of a harness such as Orca. The protocol does not depend on it, and it reads the run only through `aepkit status --json`.
147
147
 
148
- <img src="https://raw.githubusercontent.com/tBeltty/auditor-executor-protocol/main/integrations/claude-code/aeprogress/assets/pane.png" alt="The aeprogress pane: 43.3% overall, a bar per phase, P2-T3 in progress on a subagent, P2-T4 awaiting audit, P2-T2 conditional, and the machine at 31% with 1 of 2 workers live" width="420">
148
+ <img src="https://raw.githubusercontent.com/tBeltty/auditor-executor-protocol/main/integrations/claude-code/aeprogress/assets/pane.png" alt="The aeprogress pane: 43.3% overall, a bar per phase, the active phase P2 open with its task chips, P2-T3 in progress on a subagent, P2-T4 awaiting audit and P2-T2 conditional" width="420">
149
149
 
150
150
  It does three things:
151
151
 
@@ -165,7 +165,7 @@ Install it at the prompt of a Claude Code terminal session, then open it:
165
165
  /aeprogress docs/<task-name>
166
166
  ```
167
167
 
168
- It works in the terminal and in the desktop app's local sessions (in the app: **+** next to the prompt, **Plugins**, **Add marketplace**). Every limit and feature is an option in `/config`. Claude Code marks its mod API as early access, so a Claude Code release can break it. Setup, options and how each number is computed: [integrations/claude-code/aeprogress](https://github.com/tBeltty/auditor-executor-protocol/tree/main/integrations/claude-code/aeprogress).
168
+ It works in the terminal and in the desktop app's local sessions (in the app: **+** next to the prompt, **Plugins**, **Add marketplace**). Every limit and feature is an option in `/config`. It needs Claude Code 2.1.287 or later and sends no data about you anywhere (its one network request, a daily version check, can be turned off); its README lists every process it starts and everything it can refuse. To get new versions on their own, turn on auto-update once: `/plugin`, **Marketplaces**, `auditor-executor-protocol`, **Enable auto-update**. Setup, options and how each number is computed: [integrations/claude-code/aeprogress](https://github.com/tBeltty/auditor-executor-protocol/tree/main/integrations/claude-code/aeprogress).
169
169
 
170
170
  ---
171
171
 
@@ -104,6 +104,16 @@ Do not end a turn between a verdict and the next launch unless something on the
104
104
  critical-risk list is open. A run that stops to report an `APPROVED` and wait is Guided
105
105
  mode by accident.
106
106
 
107
+ ### Tool versions at the start of a run
108
+
109
+ Before launching the first task, the Auditor updates the tools the run depends on (`aepkit`
110
+ with `pipx upgrade aepkit`; any plugin or harness the run uses, such as the optional
111
+ `aeprogress` mod with `claude plugin update aeprogress@auditor-executor-protocol`) and
112
+ records the versions it ends up on as a governance decision in the plan of record. A run
113
+ then uses one set of tools from its first task to its last, and whoever reads the log
114
+ later knows which `aepkit lint` rules and which launch limits judged it. Updating mid-run
115
+ is a decision like any other: record it, with the reason.
116
+
107
117
  ### Starting the Auditor (the Auditor brief)
108
118
 
109
119
  An autonomous run is started by giving a fresh Auditor session a brief, the same way an
@@ -132,6 +142,9 @@ DOCUMENTS: <plan of record, guide, log — what each contains and who writes whe
132
142
 
133
143
  STATE: <local/pushed commits, clean tree or not, first task and its model>.
134
144
 
145
+ TOOLS: <the tools the run depends on and the versions to update to and record before task 1
146
+ (aepkit; any plugin or harness), per "Tool versions at the start of a run">.
147
+
135
148
  GOAL (non-negotiable): <the owner's objective, in their own words>. Splitting into
136
149
  phases, yes; shrinking it, no. RUN COMPLETE only with <final gate> APPROVED.
137
150
 
@@ -0,0 +1 @@
1
+ __version__ = "0.7.4"
@@ -104,6 +104,16 @@ Do not end a turn between a verdict and the next launch unless something on the
104
104
  critical-risk list is open. A run that stops to report an `APPROVED` and wait is Guided
105
105
  mode by accident.
106
106
 
107
+ ### Tool versions at the start of a run
108
+
109
+ Before launching the first task, the Auditor updates the tools the run depends on (`aepkit`
110
+ with `pipx upgrade aepkit`; any plugin or harness the run uses, such as the optional
111
+ `aeprogress` mod with `claude plugin update aeprogress@auditor-executor-protocol`) and
112
+ records the versions it ends up on as a governance decision in the plan of record. A run
113
+ then uses one set of tools from its first task to its last, and whoever reads the log
114
+ later knows which `aepkit lint` rules and which launch limits judged it. Updating mid-run
115
+ is a decision like any other: record it, with the reason.
116
+
107
117
  ### Starting the Auditor (the Auditor brief)
108
118
 
109
119
  An autonomous run is started by giving a fresh Auditor session a brief, the same way an
@@ -132,6 +142,9 @@ DOCUMENTS: <plan of record, guide, log — what each contains and who writes whe
132
142
 
133
143
  STATE: <local/pushed commits, clean tree or not, first task and its model>.
134
144
 
145
+ TOOLS: <the tools the run depends on and the versions to update to and record before task 1
146
+ (aepkit; any plugin or harness), per "Tool versions at the start of a run">.
147
+
135
148
  GOAL (non-negotiable): <the owner's objective, in their own words>. Splitting into
136
149
  phases, yes; shrinking it, no. RUN COMPLETE only with <final gate> APPROVED.
137
150
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aepkit
3
- Version: 0.7.3
3
+ Version: 0.7.4
4
4
  Summary: Mechanical support for the Auditor/Executor protocol: scaffold, lint, and negative-control the document set for a multi-phase, multi-agent execution.
5
5
  Author-email: tBeltty <jhonatan@tbelt.online>
6
6
  License-Expression: MIT
@@ -183,7 +183,7 @@ A failure only proves something if it is the failure you meant. A syntax error,
183
183
 
184
184
  `aeprogress` is a Claude Code mod for runs where the Auditor launches Executors as subagents or as workers of a harness such as Orca. The protocol does not depend on it, and it reads the run only through `aepkit status --json`.
185
185
 
186
- <img src="https://raw.githubusercontent.com/tBeltty/auditor-executor-protocol/main/integrations/claude-code/aeprogress/assets/pane.png" alt="The aeprogress pane: 43.3% overall, a bar per phase, P2-T3 in progress on a subagent, P2-T4 awaiting audit, P2-T2 conditional, and the machine at 31% with 1 of 2 workers live" width="420">
186
+ <img src="https://raw.githubusercontent.com/tBeltty/auditor-executor-protocol/main/integrations/claude-code/aeprogress/assets/pane.png" alt="The aeprogress pane: 43.3% overall, a bar per phase, the active phase P2 open with its task chips, P2-T3 in progress on a subagent, P2-T4 awaiting audit and P2-T2 conditional" width="420">
187
187
 
188
188
  It does three things:
189
189
 
@@ -203,7 +203,7 @@ Install it at the prompt of a Claude Code terminal session, then open it:
203
203
  /aeprogress docs/<task-name>
204
204
  ```
205
205
 
206
- It works in the terminal and in the desktop app's local sessions (in the app: **+** next to the prompt, **Plugins**, **Add marketplace**). Every limit and feature is an option in `/config`. Claude Code marks its mod API as early access, so a Claude Code release can break it. Setup, options and how each number is computed: [integrations/claude-code/aeprogress](https://github.com/tBeltty/auditor-executor-protocol/tree/main/integrations/claude-code/aeprogress).
206
+ It works in the terminal and in the desktop app's local sessions (in the app: **+** next to the prompt, **Plugins**, **Add marketplace**). Every limit and feature is an option in `/config`. It needs Claude Code 2.1.287 or later and sends no data about you anywhere (its one network request, a daily version check, can be turned off); its README lists every process it starts and everything it can refuse. To get new versions on their own, turn on auto-update once: `/plugin`, **Marketplaces**, `auditor-executor-protocol`, **Enable auto-update**. Setup, options and how each number is computed: [integrations/claude-code/aeprogress](https://github.com/tBeltty/auditor-executor-protocol/tree/main/integrations/claude-code/aeprogress).
207
207
 
208
208
  ---
209
209
 
@@ -1 +0,0 @@
1
- __version__ = "0.7.3"
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes