@lebronj/pi-suite 0.1.10 → 0.1.11
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.
- package/README.md +37 -8
- package/extensions/autogoal.ts +1302 -0
- package/package.json +1 -1
- package/scripts/bootstrap.sh +4 -0
- package/skills/pi-skill/SKILL.md +19 -2
package/package.json
CHANGED
package/scripts/bootstrap.sh
CHANGED
package/skills/pi-skill/SKILL.md
CHANGED
|
@@ -18,6 +18,7 @@ When adding, removing, renaming, or materially changing any pi capability in thi
|
|
|
18
18
|
- `edit`: precise exact-text replacements in one file.
|
|
19
19
|
- `write`: create or overwrite files.
|
|
20
20
|
- `goal`: inspect, resume/drop, or complete an active goal-mode objective when goal mode is running.
|
|
21
|
+
- `autogoal`: inspect, checkpoint, pause/resume/drop, block, or complete an active bounded autogoal run when `/autogoal` is running.
|
|
21
22
|
- `lsp_diagnostics` / `lsp_navigation`: code-intelligence path for diagnostics, definitions, references, hover, symbols, call hierarchy, rename, and workspace diagnostics when pi-lens/LSP tools are installed.
|
|
22
23
|
- `ast_grep_search` / `ast_grep_replace` / `ast_dump`: AST-aware code search and replacement when pi-lens tools are installed; prefer over raw text search for structural code patterns.
|
|
23
24
|
- `lens_diagnostics`: inspect pi-lens warnings/errors for files touched this session when available.
|
|
@@ -170,6 +171,19 @@ mcp({ tool: "tool_name", args: "{}" })
|
|
|
170
171
|
|
|
171
172
|
Do not route built-in pi tools through MCP; call them directly.
|
|
172
173
|
|
|
174
|
+
## Autogoal
|
|
175
|
+
|
|
176
|
+
Autogoal is provided by `autogoal.ts`.
|
|
177
|
+
|
|
178
|
+
- Start with `/autogoal <task>`.
|
|
179
|
+
- It persists the objective, injects hidden loop context, enables the `autogoal` tool, and auto-continues until verified complete, paused, dropped, blocked, or interrupted.
|
|
180
|
+
- It uses bounded loop defaults: 12 autonomous turns per session, 2 no-progress turns, 3 repeated repair attempts, and 4 subagent jobs per run.
|
|
181
|
+
- Context thresholds are 60% prepare, 75% checkpoint, and 85% checkpoint plus automatic new-session continuation.
|
|
182
|
+
- Completion is gated by current-state evidence: changed files must be read after edits and a relevant validation command must pass before `autogoal({ op: "complete" })` succeeds.
|
|
183
|
+
- Subagents are optional; scout/reviewer/verifier are allowed when useful, while worker subagents must use isolated worktrees.
|
|
184
|
+
- Run artifacts are audit-only and live under `~/.pi/agent/workflow-runs/autogoal-<run-id>/`; checkpoints also live under `~/.pi/agent/autogoal/checkpoints/`.
|
|
185
|
+
- Useful commands: `/autogoal status`, `/autogoal pause`, `/autogoal resume`, `/autogoal checkpoint`, `/autogoal drop`, `/autogoal auto on`, `/autogoal auto off`.
|
|
186
|
+
|
|
173
187
|
## Goal Mode
|
|
174
188
|
|
|
175
189
|
Goal mode is provided by `goal-mode.ts`.
|
|
@@ -209,6 +223,7 @@ Suite skills currently include:
|
|
|
209
223
|
|
|
210
224
|
Optional package-provided skills can include:
|
|
211
225
|
|
|
226
|
+
- `figma`: Figma REST/API design exploration and design-to-code workflows from `pi-mono-figma`; not installed or loaded by default, enabled with `pi install npm:pi-mono-figma`.
|
|
212
227
|
- `librarian`: library internals research with source citations.
|
|
213
228
|
- `pi-subagents`: subagent delegation workflows.
|
|
214
229
|
- `ast-grep`: AST-aware code search/replace guidance.
|
|
@@ -231,11 +246,12 @@ Global user package configuration is in `~/.pi/agent/settings.json`; project pac
|
|
|
231
246
|
|
|
232
247
|
Current suite package:
|
|
233
248
|
|
|
234
|
-
- `@lebronj/pi-suite`: bundles local extensions, prompts, suite skills, vendored `@jhp/pi-memory`, and optional package hooks for `pi-mcp-adapter`, `pi-subagents`, and `pi-web-access`.
|
|
249
|
+
- `@lebronj/pi-suite`: bundles local extensions, prompts, suite skills, vendored `@jhp/pi-memory`, and optional package hooks for `pi-mcp-adapter`, `pi-subagents`, and `pi-web-access`. It does not install or load `pi-mono-figma` by default.
|
|
235
250
|
|
|
236
251
|
Common project packages:
|
|
237
252
|
|
|
238
253
|
- `@jhp/pi-memory`
|
|
254
|
+
- `pi-mono-figma` (install and enable only on demand with `pi install npm:pi-mono-figma`)
|
|
239
255
|
- `pi-web-access`
|
|
240
256
|
- `pi-mcp-adapter`
|
|
241
257
|
- `pi-subagents`
|
|
@@ -246,7 +262,8 @@ Bootstrap behavior:
|
|
|
246
262
|
- Installs global `@earendil-works/pi-coding-agent`.
|
|
247
263
|
- Writes the team OpenAI-compatible provider to `~/.pi/agent/models.json`.
|
|
248
264
|
- Sets default provider/model in `~/.pi/agent/settings.json`.
|
|
249
|
-
- Runs `pi install npm:@lebronj/pi-suite` by default
|
|
265
|
+
- Runs `pi install npm:@lebronj/pi-suite` by default; this does not install or load `pi-mono-figma`.
|
|
266
|
+
- Prints follow-up instructions for enabling Figma later with `pi install npm:pi-mono-figma` and disabling it with `pi remove npm:pi-mono-figma`.
|
|
250
267
|
- Creates `~/.pi/agent/memory` and links it into the workspace `.pi/memory` when safe.
|
|
251
268
|
- Optionally initializes the local `~/.pi/agent/evolution` repo for memory/skill-draft snapshots; it never writes tokens or enables auto-push.
|
|
252
269
|
- Links suite skills into the workspace `.pi/skills` when safe.
|