aepkit 0.7.0__tar.gz → 0.7.2__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.0 → aepkit-0.7.2}/CHANGELOG.md +34 -1
  2. {aepkit-0.7.0/src/aepkit.egg-info → aepkit-0.7.2}/PKG-INFO +2 -2
  3. {aepkit-0.7.0 → aepkit-0.7.2}/README.md +1 -1
  4. {aepkit-0.7.0 → aepkit-0.7.2}/references/autonomous-mode.md +6 -0
  5. {aepkit-0.7.0/src/aepkit/skill → aepkit-0.7.2}/references/handoffs.md +9 -0
  6. aepkit-0.7.2/src/aepkit/__init__.py +1 -0
  7. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/skill/references/autonomous-mode.md +6 -0
  8. {aepkit-0.7.0 → aepkit-0.7.2/src/aepkit/skill}/references/handoffs.md +9 -0
  9. {aepkit-0.7.0 → aepkit-0.7.2/src/aepkit.egg-info}/PKG-INFO +2 -2
  10. aepkit-0.7.0/src/aepkit/__init__.py +0 -1
  11. {aepkit-0.7.0 → aepkit-0.7.2}/LICENSE +0 -0
  12. {aepkit-0.7.0 → aepkit-0.7.2}/MANIFEST.in +0 -0
  13. {aepkit-0.7.0 → aepkit-0.7.2}/SKILL.md +0 -0
  14. {aepkit-0.7.0 → aepkit-0.7.2}/pyproject.toml +0 -0
  15. {aepkit-0.7.0 → aepkit-0.7.2}/references/failure-modes-and-example.md +0 -0
  16. {aepkit-0.7.0 → aepkit-0.7.2}/references/tasks-and-gates.md +0 -0
  17. {aepkit-0.7.0 → aepkit-0.7.2}/setup.cfg +0 -0
  18. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/__main__.py +0 -0
  19. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/cli.py +0 -0
  20. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/install_skill.py +0 -0
  21. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/lint.py +0 -0
  22. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/negcontrol.py +0 -0
  23. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/py.typed +0 -0
  24. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/scaffold.py +0 -0
  25. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/skill/SKILL.md +0 -0
  26. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/skill/references/failure-modes-and-example.md +0 -0
  27. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/skill/references/tasks-and-gates.md +0 -0
  28. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/status.py +0 -0
  29. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/templates/compliance-log.md +0 -0
  30. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/templates/execution-guide.md +0 -0
  31. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit/templates/plan-of-record.md +0 -0
  32. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit.egg-info/SOURCES.txt +0 -0
  33. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit.egg-info/dependency_links.txt +0 -0
  34. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit.egg-info/entry_points.txt +0 -0
  35. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit.egg-info/requires.txt +0 -0
  36. {aepkit-0.7.0 → aepkit-0.7.2}/src/aepkit.egg-info/top_level.txt +0 -0
  37. {aepkit-0.7.0 → aepkit-0.7.2}/tests/run.py +0 -0
  38. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_cli.py +0 -0
  39. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_install_skill.py +0 -0
  40. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_lint.py +0 -0
  41. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_negcontrol.py +0 -0
  42. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_readme_claims.py +0 -0
  43. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_scaffold.py +0 -0
  44. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_skill_sync.py +0 -0
  45. {aepkit-0.7.0 → aepkit-0.7.2}/tests/test_status.py +0 -0
@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.7.2] - 2026-11-08
11
+
12
+ ### Added
13
+ - `references/autonomous-mode.md`: an optional step at a phase's close. Once the gate is
14
+ `APPROVED`, the work is pushed and the Auditor brief is up to date, the Auditor may compact
15
+ its own session and resume itself from the brief.
16
+ - `aeprogress` 0.3.0: a `compact_and_resume` tool for the Auditor. After its turn ends, a band
17
+ counts down 40 seconds with Cancel and Compact now; at zero the session is compacted and the
18
+ Auditor resumed with its own `resume` message. A prompt typed by the owner, Esc on the turn,
19
+ or Cancel drops it; a manual `/compact` during the countdown resumes once; a refused or vetoed
20
+ compaction resumes nothing. Options for the seconds and to turn it off.
21
+
22
+ ## [0.7.1] - 2026-11-08
23
+
24
+ ### Added
25
+ - `references/handoffs.md`: an optional `Load: docs-only` line in the handoff template, for
26
+ runs where a tool holds back Executor launches while the machine is busy. It marks a task
27
+ that builds nothing, so it may run beside one that builds; a handoff without it counts as
28
+ a build. The protocol does not require it.
29
+ - `aeprogress` 0.2.0 (`integrations/claude-code/aeprogress/`): a launch limit that, while a
30
+ run is found, refuses launching another Executor past 2 live workers, 1 building worker,
31
+ or a machine more than 75% busy for a build (each a `/config` option), with the reason in
32
+ the refusal. It sees Claude Code subagents whose prompt names a task of the run, and Orca
33
+ `worker-start` and `send` to a dispatch that is not live; it counts both together, and
34
+ refuses when Orca cannot be asked. The pane shows the machine's load (Linux `/proc`,
35
+ macOS and BSD `sysctl`, Windows PowerShell) and how full the limit is. On macOS, when
36
+ Spotlight's indexing stays busy, it recommends excluding the project folder in System
37
+ Settings; it never changes a setting.
38
+ - `aeprogress`: Windows fallbacks for finding aepkit (`python -m`, `py -m`,
39
+ `%USERPROFILE%\.local\bin`).
40
+
10
41
  ## [0.7.0] - 2026-11-08
11
42
 
12
43
  ### Added
@@ -315,7 +346,9 @@ Fixes from an independent review of 0.3.0.
315
346
  - Multi-framework agent installation support for Antigravity, Claude Code, and Cursor.
316
347
  - Zero-dependency test runner (`tests/run.py`).
317
348
 
318
- [Unreleased]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.0...HEAD
349
+ [Unreleased]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.2...HEAD
350
+ [0.7.2]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.1...v0.7.2
351
+ [0.7.1]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.7.0...v0.7.1
319
352
  [0.7.0]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.6.0...v0.7.0
320
353
  [0.6.0]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.5.1...v0.6.0
321
354
  [0.5.1]: https://github.com/tBeltty/auditor-executor-protocol/compare/v0.5.0...v0.5.1
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aepkit
3
- Version: 0.7.0
3
+ Version: 0.7.2
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
@@ -178,7 +178,7 @@ A failure only proves something if it is the failure you meant. A syntax error,
178
178
 
179
179
  ### Optional: Progress Pane for Claude Code
180
180
 
181
- `aeprogress` is a Claude Code mod that keeps a pane beside the chat with the run's overall percentage, a bar per phase, who is working on which task ID (Claude Code subagents, Orca workers, or any other harness through a command of your own), what awaits audit and what needs attention. It reads the log through `aepkit status --json` and refreshes after each turn, and every 20 seconds while the pane is open. The protocol does not depend on it.
181
+ `aeprogress` is a Claude Code mod that keeps a pane beside the chat with the run's overall percentage, a bar per phase, who is working on which task ID (Claude Code subagents, Orca workers, or any other harness through a command of your own), what awaits audit, what needs attention, and the machine's load. It reads the log through `aepkit status --json` and refreshes after each turn, and every 20 seconds while the pane is open. While a run is found it also holds back launching another Executor past a worker count or a machine load (2 workers, 1 building, 75% busy by default; a handoff marked `Load: docs-only` does not count as a build), and on macOS it recommends excluding the project from Spotlight when indexing keeps the machine busy. The protocol does not depend on it.
182
182
 
183
183
  ```
184
184
  /plugin install aeprogress --marketplace tBeltty/auditor-executor-protocol
@@ -140,7 +140,7 @@ A failure only proves something if it is the failure you meant. A syntax error,
140
140
 
141
141
  ### Optional: Progress Pane for Claude Code
142
142
 
143
- `aeprogress` is a Claude Code mod that keeps a pane beside the chat with the run's overall percentage, a bar per phase, who is working on which task ID (Claude Code subagents, Orca workers, or any other harness through a command of your own), what awaits audit and what needs attention. It reads the log through `aepkit status --json` and refreshes after each turn, and every 20 seconds while the pane is open. The protocol does not depend on it.
143
+ `aeprogress` is a Claude Code mod that keeps a pane beside the chat with the run's overall percentage, a bar per phase, who is working on which task ID (Claude Code subagents, Orca workers, or any other harness through a command of your own), what awaits audit, what needs attention, and the machine's load. It reads the log through `aepkit status --json` and refreshes after each turn, and every 20 seconds while the pane is open. While a run is found it also holds back launching another Executor past a worker count or a machine load (2 workers, 1 building, 75% busy by default; a handoff marked `Load: docs-only` does not count as a build), and on macOS it recommends excluding the project from Spotlight when indexing keeps the machine busy. The protocol does not depend on it.
144
144
 
145
145
  ```
146
146
  /plugin install aeprogress --marketplace tBeltty/auditor-executor-protocol
@@ -94,6 +94,12 @@ each handoff. The shape that has worked here:
94
94
  yet expanded, expand it (tasks, gate, model per task, log sections) before launching
95
95
  its first task.
96
96
 
97
+ Optional, at a phase's close: once the gate is `APPROVED`, the work is pushed and the
98
+ Auditor brief is up to date on disk, the Auditor may compact its own session and resume
99
+ itself from the brief, so a long run does not carry every earlier phase in its context.
100
+ On Claude Code the optional `aeprogress` mod offers this as a tool that waits out a short
101
+ countdown the owner can cancel. The protocol does not depend on it.
102
+
97
103
  Do not end a turn between a verdict and the next launch unless something on the
98
104
  critical-risk list is open. A run that stops to report an `APPROVED` and wait is Guided
99
105
  mode by accident.
@@ -32,6 +32,8 @@ ROLE: Executor. Work from <EXECUTION_GUIDE> (Phase <n>, `<TASK-ID>`) only; repor
32
32
  [Autonomous mode only:] You are the Auditor's subagent. Questions go as BLOCKED in the
33
33
  log and in your final report; you do not address the owner.
34
34
 
35
+ [Optional, only when the run uses a launch limit:] Load: docs-only
36
+
35
37
  REPORTED STATE: <what is already DONE in the log, and whether it was audited or only
36
38
  self-reported — do not conflate the two>. Do not reopen <prior tasks>.
37
39
 
@@ -71,6 +73,13 @@ mid-task.
71
73
  Do not paste a rules-of-engagement block from one project's run into another's handoff
72
74
  without re-confirming it applies. It is a per-run artifact, not part of this skill.
73
75
 
76
+ `Load: docs-only` is for runs where a tool holds back Executor launches while the machine
77
+ is busy, such as the optional `aeprogress` mod for Claude Code. Put it on its own line in
78
+ a handoff whose task compiles, builds and tests nothing (documentation, a plan, a review),
79
+ so it can run beside a task that builds. Leave it out when unsure: a handoff without it
80
+ counts as a build, which is the safe side. The protocol does not require the line, and a
81
+ run with no such tool ignores it.
82
+
74
83
  ## Remediation handoff (Auditor)
75
84
 
76
85
  A verdict is not the deliverable — a well-evidenced `CONDITIONAL` or `REJECTED` that
@@ -0,0 +1 @@
1
+ __version__ = "0.7.2"
@@ -94,6 +94,12 @@ each handoff. The shape that has worked here:
94
94
  yet expanded, expand it (tasks, gate, model per task, log sections) before launching
95
95
  its first task.
96
96
 
97
+ Optional, at a phase's close: once the gate is `APPROVED`, the work is pushed and the
98
+ Auditor brief is up to date on disk, the Auditor may compact its own session and resume
99
+ itself from the brief, so a long run does not carry every earlier phase in its context.
100
+ On Claude Code the optional `aeprogress` mod offers this as a tool that waits out a short
101
+ countdown the owner can cancel. The protocol does not depend on it.
102
+
97
103
  Do not end a turn between a verdict and the next launch unless something on the
98
104
  critical-risk list is open. A run that stops to report an `APPROVED` and wait is Guided
99
105
  mode by accident.
@@ -32,6 +32,8 @@ ROLE: Executor. Work from <EXECUTION_GUIDE> (Phase <n>, `<TASK-ID>`) only; repor
32
32
  [Autonomous mode only:] You are the Auditor's subagent. Questions go as BLOCKED in the
33
33
  log and in your final report; you do not address the owner.
34
34
 
35
+ [Optional, only when the run uses a launch limit:] Load: docs-only
36
+
35
37
  REPORTED STATE: <what is already DONE in the log, and whether it was audited or only
36
38
  self-reported — do not conflate the two>. Do not reopen <prior tasks>.
37
39
 
@@ -71,6 +73,13 @@ mid-task.
71
73
  Do not paste a rules-of-engagement block from one project's run into another's handoff
72
74
  without re-confirming it applies. It is a per-run artifact, not part of this skill.
73
75
 
76
+ `Load: docs-only` is for runs where a tool holds back Executor launches while the machine
77
+ is busy, such as the optional `aeprogress` mod for Claude Code. Put it on its own line in
78
+ a handoff whose task compiles, builds and tests nothing (documentation, a plan, a review),
79
+ so it can run beside a task that builds. Leave it out when unsure: a handoff without it
80
+ counts as a build, which is the safe side. The protocol does not require the line, and a
81
+ run with no such tool ignores it.
82
+
74
83
  ## Remediation handoff (Auditor)
75
84
 
76
85
  A verdict is not the deliverable — a well-evidenced `CONDITIONAL` or `REJECTED` that
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aepkit
3
- Version: 0.7.0
3
+ Version: 0.7.2
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
@@ -178,7 +178,7 @@ A failure only proves something if it is the failure you meant. A syntax error,
178
178
 
179
179
  ### Optional: Progress Pane for Claude Code
180
180
 
181
- `aeprogress` is a Claude Code mod that keeps a pane beside the chat with the run's overall percentage, a bar per phase, who is working on which task ID (Claude Code subagents, Orca workers, or any other harness through a command of your own), what awaits audit and what needs attention. It reads the log through `aepkit status --json` and refreshes after each turn, and every 20 seconds while the pane is open. The protocol does not depend on it.
181
+ `aeprogress` is a Claude Code mod that keeps a pane beside the chat with the run's overall percentage, a bar per phase, who is working on which task ID (Claude Code subagents, Orca workers, or any other harness through a command of your own), what awaits audit, what needs attention, and the machine's load. It reads the log through `aepkit status --json` and refreshes after each turn, and every 20 seconds while the pane is open. While a run is found it also holds back launching another Executor past a worker count or a machine load (2 workers, 1 building, 75% busy by default; a handoff marked `Load: docs-only` does not count as a build), and on macOS it recommends excluding the project from Spotlight when indexing keeps the machine busy. The protocol does not depend on it.
182
182
 
183
183
  ```
184
184
  /plugin install aeprogress --marketplace tBeltty/auditor-executor-protocol
@@ -1 +0,0 @@
1
- __version__ = "0.7.0"
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