@llblab/pi-actors 0.30.0 → 0.30.1

package/BACKLOG.md

@@ -41,6 +41,13 @@ Non-goals:
 
 No open hotfix items.
 
+## Backlog Curation Rules
+
+- Completed work belongs in `CHANGELOG.md`, not in `BACKLOG.md`.
+- File length alone is not a domain-split trigger: ~1000-line cohesive domain files are acceptable when ownership is clear.
+- Consider splitting only when a file crosses roughly 2000 lines, mixes real ownership zones, or hides a clearer domain boundary.
+- Prefer semantic compression before file splitting: fewer public nouns, consistent outcomes, compact diagnostics, and domain-owned constants/helpers.
+
 ## Minor Backlog
 
 The backlog is intentionally pruned to the 20% of work most likely to deliver 80% of value for `pi-actors` as a local actor kernel. Bias toward consolidation, smaller public surface area, and reliability over new feature breadth.
@@ -73,6 +80,20 @@ The backlog is intentionally pruned to the 20% of work most likely to deliver 80
   - Stale claims are reproducible and visible in worker status.
   - Tests cover stale-claim counting without adding scheduler/broker policy.
 
+### M-23 Tool Boundary Type Tightening
+
+- Priority: Low.
+- Status: Planned.
+- Goal: Remove avoidable `any` at the Pi/tool boundary where a narrow local type can express the real contract without broad rewiring.
+- Why now: `index.ts` still keeps runtime tool definitions in a `Map<string, any>`; this is small but visible in the composition root.
+- Direction:
+  - Add or reuse a narrow exported tool-definition type from the Pi adapter or tools domain.
+  - Keep SDK details behind `lib/pi.ts`.
+  - Do not introduce a broad type-modeling pass across every schema helper.
+- Acceptance:
+  - `index.ts` no longer uses `Map<string, any>` for actor tool definitions.
+  - TypeScript validation still passes without weakening public tool schemas.
+
 ### M-17 Message Delivery Outcome Contract
 
 - Priority: High.
@@ -108,6 +129,20 @@ The backlog is intentionally pruned to the 20% of work most likely to deliver 80
   - Tests cover valid promotion, invalid candidate, name collision, and packaged-recipe shadowing.
   - Docs explain candidate memory vs active tool memory in one compact section.
 
+### M-24 Registry Path Naming Cleanup
+
+- Priority: Low.
+- Status: Planned.
+- Goal: Reduce legacy-storage naming noise without changing the persistent file path.
+- Why now: `legacy-tool-registry.json` is still a compatibility storage path, but helper names and tests should make clear that the stable path is retained intentionally.
+- Direction:
+  - Prefer neutral helper/test wording such as registry path or retained registry storage path.
+  - Keep the on-disk filename unchanged unless a separate migration is justified.
+  - Do not reintroduce legacy migration code.
+- Acceptance:
+  - Path helpers and tests no longer imply an unfinished migration.
+  - Existing registry storage compatibility remains unchanged.
+
 ### M-19 Recipe Doctor Risk Labels v2
 
 - Priority: Medium.
@@ -193,4 +228,5 @@ These are valid ideas but not current focus. Reintroduce only with concrete evid
 ```text
 Next milestone: M-14 Session Mismatch Follow-through.
 Then: M-15 Worker Stale-Claim Dogfood → M-17 Message Delivery Outcome Contract → M-18 Candidate Recipe Promotion UX.
+Small cleanup lane: M-23 Tool Boundary Type Tightening → M-24 Registry Path Naming Cleanup.
 ```

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.30.1: Backlog Curation Hotfix
+
+- `[Backlog]` Added curation rules clarifying that completed work belongs only in the changelog, that cohesive ~1000-line domain files are acceptable, and that file splitting should follow real ownership boundaries rather than line count alone.
+- `[Backlog]` Added small cleanup candidates for typed tool-boundary tightening and retained registry-path naming clarity without expanding the public actor surface.
+
 ## 0.30.0: Composition Root Compression
 
 - `[Entrypoint]` Added a narrow Pi SDK adapter domain, moved recipe live-reload mechanics into the runtime domain, moved run-state watcher, run UI observation state, and run notification formatting into observability, moved runtime path constants and co-located skill path discovery to the paths domain, grouped core actor tool definitions in the tools domain, and shifted actor-inspector command state/parsing/render selection into the actor-inspector domain so `index.ts` keeps only live Pi wiring.

package/dist/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.30.0
+  version: 0.30.1
 ---
 
 # Actors (pi-actors)

package/dist/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.30.0
+  version: 0.30.1
 ---
 
 # Swarm

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "private": false,
   "description": "Local Actor Kernel for Pi",
   "keywords": [

package/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.30.0
+  version: 0.30.1
 ---
 
 # Actors (pi-actors)

package/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.30.0
+  version: 0.30.1
 ---
 
 # Swarm