ace-handbook-integration-pi 0.3.11 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a453f9cbc9dafa9dfbddb6d01fca775da73cab2e64824fbed42db982831c244c
-  data.tar.gz: 42530bef549e402b40c0981272515c8df3104b20bbd1eb78dbc2d9d59254ca00
+  metadata.gz: 0aecac8cdb81dfb6b51efda48199aeaf10e7267bbaed81dcec49acb0fa985553
+  data.tar.gz: baeff1aa2723ed7a0333c28d78fc5825d6b32dc5b6cdb7090900f3350358239f
 SHA512:
-  metadata.gz: fd82e99584d2825688a21a109d3dce6c0c01817696622223c86e5f396e6bcd7d0314eee12ef5047d6077226d0cb5e9cdd9e09720e9b122070a2eb89394f889cd
-  data.tar.gz: b81e382c6dd6f8dc54b3b4e8ee2641d7dfcf77d76e74f7d2624404c60740932f7cb2e1d2580398f2637ec822a3d173bef431730804115a7bfa4863622b367d25
+  metadata.gz: 761967528dfe314d715ea45cbc25476f27d2d5a2835bd12a3b39b3b2faba352adae6ff81ec7e91b0168fd9af44bb28f71a3a7e98f35fb55edf69cb1bae98edfd
+  data.tar.gz: bf06c8004e8b1c865093685cf7d17e3463857d3521fcfc3dfe89d088a4f6fd73d9b2f5d27b539d8e3555a843b4c7ed3e906a47aab92befeee9a4803311dd4c2d

data/.ace-defaults/handbook/providers/pi.yml

@@ -1,2 +1,3 @@
 provider: pi
 output_dir: .pi/skills
+prompts_dir: .pi/prompts

data/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to ace-handbook-integration-pi will be documented in this fi
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-27
+
+### Added
+- Provider manifest now declares `prompts_dir: .pi/prompts`; canonical pi prompt templates from `handbook/prompts/` project there via `ace-handbook sync`.
+- Shipped the canonical `loop` prompt template: the ACE overseer loop running in-process inside a pi session (`/loop`), cycling the task backlog through the `as-task-work` discipline with executed-evidence stop conditions. Projected to `.pi/prompts/loop.md`.
+
 
 ## [0.3.11] - 2026-09-02
 

data/README.md

@@ -21,6 +21,8 @@
 
 **Consume canonical skills from PI tooling** - keep provider-specific behavior while preserving shared semantics, so agents running under pi-agent get the same skill intent as any other provider.
 
+**Run the in-process overseer loop with `/loop`** - the canonical `handbook/prompts/loop.md` template projects to `.pi/prompts/loop.md` (`ace-handbook sync --provider pi`), giving pi a slash command that cycles the task backlog (select → execute via `as-task-work` → verify → report) inside the pi session itself - no tmux windows or external orchestrator.
+
 **Keep provider updates constrained** - update projection assets inside this package instead of canonical definitions, keeping changes isolated from [ace-handbook](../ace-handbook).
 
 **Enable incremental provider onboarding** - add or update PI support independently of core ACE changes, maintaining a focused provider shim layer.

data/handbook/prompts/loop.md

@@ -0,0 +1,38 @@
+---
+description: Run the ACE overseer loop in-process — pick, execute, and close backlog tasks one after another until a stop condition fires
+argument-hint: "[task-ref]"
+source: ace-handbook-integration-pi
+last_modified: 2026-09-27
+---
+
+Run the ACE overseer loop **in-process**: this pi session is the overseer. Work the task backlog one task at a time from selection to terminal state, then continue with the next task -- no tmux windows, no detached workers, no external orchestrator. The loop lives in this session; every cycle uses the project's ACE CLI tools.
+
+## Arguments
+
+`${1:-}` is an optional task ref for the first cycle. When omitted, select from the backlog.
+
+## Loop cycle
+
+Repeat until a stop condition fires:
+
+1. **Select.** If `${1:-}` is set and not yet consumed, use it for this cycle and clear it afterwards. Otherwise run `ace-task list` and pick the first `pending` task in priority order that is actionable. Never pick a `done` task; skip tasks whose blocker is confirmed by an executed check (see below).
+2. **Execute.** Load the canonical `as-task-work` skill (`/skill:as-task-work <ref>`, or read `.pi/skills/as-task-work/SKILL.md`) and follow it end-to-end for the chosen ref: load the task spec and plan, mark the task in-progress, then work the plan step by step -- test after every change, commit each logical step with `ace-git-commit <paths>`, and leave the task in-progress (final delivery owns `done`).
+3. **Verify.** Before closing the cycle: `git status --short` is clean for everything your work produced, and the task's plan checklist and success criteria are satisfied -- or blockers are recorded with executed evidence.
+4. **Report.** One progress update per cycle: task ref, outcome (completed / blocked / skipped), and the executed command + observed output that proves it.
+
+## Stop conditions
+
+Stop the loop and give a final summary only when one of these holds:
+
+- **Backlog drained.** `ace-task list` shows no actionable `pending` work.
+- **Human decision required.** A task's spec is ambiguous or incomplete, or a blocker cannot be verified or cleared without the user. Do not assume and do not silently skip -- report the blocker together with the executed check that surfaced it.
+- **Interrupted.** The user interjects. Yield immediately and summarize the state of every cycle run so far.
+
+## Non-negotiable rules
+
+- Do not stop after intermediate progress; do not pause between cycles for confirmation.
+- A cycle that ends blocked on an owner dependency (confirmed by a runnable, non-secret executed check) does not stop the loop: record the blocker on the task with `ace-task update`, close stale blockers in the same pass, and continue with the next task. Only unverifiable or human-only blockers stop the loop.
+- Status truth: recorded blockers are claims, not state. Confirm or refute each blocker you rely on with an executed check in this session.
+- Never modify task frontmatter directly -- use `ace-task update <ref> --set key=value`.
+- Never reset or discard unrelated changes; commit path-scoped with `ace-git-commit <paths>`.
+- Temp files go to `/tmp/` or `.ace-local/<subfolder>/`, never the project root.

data/lib/ace/handbook/integration/pi/version.rb

@@ -4,7 +4,7 @@ module Ace
   module Handbook
     module Integration
       module Pi
-        VERSION = "0.3.11"
+        VERSION = "0.4.0"
       end
     end
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-handbook-integration-pi
 version: !ruby/object:Gem::Version
-  version: 0.3.11
+  version: 0.4.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-09-05 00:00:00.000000000 Z
+date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-handbook
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: '0.32'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: '0.32'
 description: PI-specific provider integration package that extends ace-handbook with
   provider manifests.
 email:
@@ -34,6 +34,7 @@ files:
 - ".ace-defaults/handbook/providers/pi.yml"
 - CHANGELOG.md
 - README.md
+- handbook/prompts/loop.md
 - lib/ace/handbook/integration/pi.rb
 - lib/ace/handbook/integration/pi/version.rb
 homepage: https://github.com/cs3b/ace