feat: vendor subagent and rpiv packages

Author: danjdewhurst

CONTRIBUTING.md

@@ -9,7 +9,13 @@ npm install
 npm run typecheck
 ```
 
-To test the extension in pi without installing it globally:
+To test the package set in pi without installing it globally:
+
+```bash
+pi -e /path/to/forjd-pi
+```
+
+To test only the Git diff sidebar extension:
 
 ```bash
 pi -e ./extensions/git-diff-sidebar.ts
@@ -20,7 +26,7 @@ pi -e ./extensions/git-diff-sidebar.ts
 - Keep extensions small and focused.
 - Prefer passive UI that does not interrupt the main editor unless a command explicitly asks for interaction.
 - Run `npm run typecheck` before opening a PR.
-- Update the README when adding commands, configuration, or visible UI changes.
+- Update the README when adding commands, configuration, package contents, or visible UI changes.
 
 ## Security
 

README.md

@@ -1,8 +1,12 @@
 # forjd-pi
 
-A small [pi coding agent](https://pi.dev) extension pack from Forjd.
+A [pi coding agent](https://pi.dev) package set from Forjd.
 
-The first extension is a high-level Git diff sidebar: a passive right-side panel that keeps the current working tree visible while you code with pi.
+This package bundles the Forjd Git diff sidebar plus three cloned pi packages:
+
+- [`pi-subagents`](https://github.com/nicobailon/pi-subagents) for delegating work to subagents, chains, and parallel runs
+- [`@juicesharp/rpiv-todo`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-todo) for model-managed task tracking with a live overlay
+- [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) for structured clarification prompts
 
 ## Features
 
@@ -13,6 +17,9 @@ The first extension is a high-level Git diff sidebar: a passive right-side panel
 - Largest changed files sorted to the top
 - Non-capturing overlay, so the editor keeps focus
 - Automatically hides on narrow terminals and leaves a compact footer status
+- Subagent delegation tools, slash commands, bundled agents, skills, and prompts
+- Persistent todo tool and overlay for multi-step work
+- Structured `ask_user_question` tool for option-based clarification
 
 ## Preview
 
@@ -45,15 +52,15 @@ Or install from a local checkout while developing:
 pi install /path/to/forjd-pi
 ```
 
-You can also test the extension for one pi run without installing it:
+You can also test the whole package set for one pi run without installing it:
 
 ```bash
-pi -e ./extensions/git-diff-sidebar.ts
+pi -e /path/to/forjd-pi
 ```
 
 ## Usage
 
-The sidebar starts automatically in interactive pi sessions when this package is installed.
+The Git diff sidebar starts automatically in interactive pi sessions when this package is installed.
 
 Commands:
 
@@ -66,21 +73,25 @@ Commands:
 
 The overlay is passive. It does not capture keyboard input, and it is hidden when the terminal is narrower than 100 columns.
 
+The cloned packages also register their upstream tools and commands:
+
+- `subagent` tool, `/subagent`, `/chain`, `/parallel`, and bundled subagent prompts/skills from `pi-subagents`
+- `todo` tool and `/todos` command from `rpiv-todo`
+- `ask_user_question` tool from `rpiv-ask-user-question`
+
+See the upstream READMEs under `packages/` for detailed usage.
+
 ## Package contents
 
 ```text
-extensions/git-diff-sidebar.ts  Git diff sidebar extension
+extensions/git-diff-sidebar.ts                Git diff sidebar extension
+packages/pi-subagents/                        Cloned pi-subagents package
+packages/rpiv-todo/                           Cloned rpiv-todo package
+packages/rpiv-ask-user-question/              Cloned rpiv-ask-user-question package
+packages/UPSTREAM.md                           Upstream source commits for cloned packages
 ```
 
-The pi manifest is declared in `package.json`:
-
-```json
-{
-  "pi": {
-    "extensions": ["./extensions"]
-  }
-}
-```
+The pi manifest is declared in `package.json` and loads extension, skill, and prompt resources from those paths.
 
 ## Development