@astralyn/pi 0.82.2 → 0.82.3

package/docs/session-format.md

@@ -28,11 +28,11 @@ Existing sessions are automatically migrated to the current version (v3) when lo
 
 ## Source Files
 
-Source on GitHub ([pi-mono](https://github.com/earendil-works/pi-mono)):
-- [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
-- [`packages/coding-agent/src/core/messages.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
-- [`packages/ai/src/types.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
-- [`packages/agent/src/types.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/agent/src/types.ts) - AgentMessage union type
+Distribution source on GitHub ([ming-kang/pi](https://github.com/ming-kang/pi)):
+- [`src/core/session-manager.ts`](https://github.com/ming-kang/pi/blob/main/src/core/session-manager.ts) - Session entry types and SessionManager
+- [`src/core/messages.ts`](https://github.com/ming-kang/pi/blob/main/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
+- [`packages/ai/src/types.ts`](https://github.com/earendil-works/pi/blob/v0.82.1/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
+- [`packages/agent/src/types.ts`](https://github.com/earendil-works/pi/blob/v0.82.1/packages/agent/src/types.ts) - AgentMessage union type
 
 For TypeScript definitions in your project, inspect `node_modules/@astralyn/pi/dist/` and `node_modules/@earendil-works/pi-ai/dist/`.
 

package/docs/skills.md

@@ -131,7 +131,7 @@ cd /path/to/skill && npm install
 Use relative paths from the skill directory:
 
 ```markdown
-See [the reference guide](references/REFERENCE.md) for details.
+See the reference guide at `references/REFERENCE.md` for details.
 ```
 
 ## Frontmatter

package/docs/themes.md

@@ -52,7 +52,7 @@ vim ~/.pi/agent/themes/my-theme.json
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "$schema": "https://raw.githubusercontent.com/ming-kang/pi/main/src/modes/interactive/theme/theme-schema.json",
   "name": "my-theme",
   "vars": {
     "primary": "#00aaff",
@@ -123,7 +123,7 @@ vim ~/.pi/agent/themes/my-theme.json
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "$schema": "https://raw.githubusercontent.com/ming-kang/pi/main/src/modes/interactive/theme/theme-schema.json",
   "name": "my-theme",
   "vars": {
     "blue": "#0066cc",
@@ -292,10 +292,6 @@ echo $COLORTERM  # Should output "truecolor" or "24bit"
 
 ## Examples
 
-See the built-in themes:
-- [dark.json](../src/modes/interactive/theme/dark.json)
-- [light.json](../src/modes/interactive/theme/light.json)
-- [ice-cream-dark.json](../src/modes/interactive/theme/ice-cream-dark.json)
-- [ice-cream-light.json](../src/modes/interactive/theme/ice-cream-light.json)
+The built-in themes are selected by name: `dark`, `light`, `ice-cream-dark`, and `ice-cream-light`. When inspecting an installed package, their JSON assets are under `node_modules/@astralyn/pi/dist/modes/interactive/theme/` (the global-install equivalent is under Pi's npm package directory).
 
-The ice-cream palette and distribution-specific design notes are documented in [`docs/distribution/themes.md`](distribution/themes.md).
+The ice-cream palette and bundled design notes are documented in [Bundled themes](bundled/themes.md).

package/docs/tui.md

@@ -4,7 +4,7 @@
 
 Extensions and custom tools can render custom TUI components for interactive user interfaces. This page covers the component system and available building blocks.
 
-**Source:** [`@earendil-works/pi-tui`](https://github.com/earendil-works/pi-mono/tree/main/packages/tui)
+**Source:** [`@earendil-works/pi-tui@0.82.1`](https://github.com/earendil-works/pi/tree/v0.82.1/packages/tui)
 
 ## Component Interface
 

package/examples/extensions/README.md

@@ -42,7 +42,6 @@ cp permission-gate.ts ~/.pi/agent/extensions/
 | `minimal-mode.ts` | Override built-in tool rendering for minimal display (only tool calls, no output in collapsed mode) |
 | `truncated-tool.ts` | Wraps ripgrep with proper output truncation (50KB/2000 lines) |
 | `ssh.ts` | Delegate all tools to a remote machine via SSH using pluggable operations |
-| `subagent/` | Delegate tasks to specialized subagents with isolated context windows |
 
 ### Commands & UI
 

package/examples/extensions/custom-provider-anthropic/index.ts

@@ -8,15 +8,15 @@
  * - API key support via environment variable
  * - Two model definitions
  *
- * Usage:
+ * Usage (from the repository or package root):
  *   # First install dependencies
- *   cd packages/coding-agent/examples/extensions/custom-provider && npm install
+ *   npm install --prefix examples/extensions/custom-provider-anthropic
  *
  *   # With OAuth (run /login custom-anthropic first)
- *   pi -e ./packages/coding-agent/examples/extensions/custom-provider
+ *   pi -e examples/extensions/custom-provider-anthropic
  *
  *   # With API key
- *   CUSTOM_ANTHROPIC_API_KEY=sk-ant-... pi -e ./packages/coding-agent/examples/extensions/custom-provider
+ *   CUSTOM_ANTHROPIC_API_KEY=sk-ant-... pi -e examples/extensions/custom-provider-anthropic
  *
  * Then use /model to select custom-anthropic/claude-sonnet-4-5
  */

package/examples/extensions/custom-provider-gitlab-duo/index.ts

@@ -4,8 +4,8 @@
  * Provides access to GitLab Duo AI models (Claude and GPT) through GitLab's AI Gateway.
  * Delegates to pi-ai's built-in Anthropic and OpenAI streaming implementations.
  *
- * Usage:
- *   pi -e ./packages/coding-agent/examples/extensions/custom-provider-gitlab-duo
+ * Usage (from the repository or package root):
+ *   pi -e examples/extensions/custom-provider-gitlab-duo
  *   # Then /login gitlab-duo, or set GITLAB_TOKEN=glpat-...
  */
 

package/examples/extensions/dynamic-resources/dynamic.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://raw.githubusercontent.com/ming-kang/pi/main/src/modes/interactive/theme/theme-schema.json",
 	"name": "dynamic-resources",
 	"vars": {
 		"cyan": "#00d7ff",

package/examples/extensions/gondolin/index.ts

@@ -6,13 +6,11 @@
  * /workspace write through to the host; other guest filesystem changes are
  * isolated to the VM.
  *
- * Setup:
- *   cd packages/coding-agent/examples/extensions/gondolin
- *   npm install --ignore-scripts
+ * Setup (from the repository or package root):
+ *   npm install --ignore-scripts --prefix examples/extensions/gondolin
  *
- * Usage:
- *   cd /path/to/project
- *   pi -e /path/to/pi/packages/coding-agent/examples/extensions/gondolin
+ * Usage (from the project that should be mounted at /workspace):
+ *   pi -e /absolute/path/to/pi/examples/extensions/gondolin
  *
  * Requirements:
  *   - Node.js >= 23.6.0 for @earendil-works/gondolin

package/examples/extensions/message-renderer.ts

@@ -12,7 +12,7 @@ import { Box, Text } from "@earendil-works/pi-tui";
 
 export default function (pi: ExtensionAPI) {
 	// Register custom renderer for "status-update" messages
-	pi.registerMessageRenderer("status-update", (message, { expanded }, theme) => {
+	pi.registerMessageRenderer("status-update", (message, { expanded, outputPad }, theme) => {
 		const details = message.details as { level: string; timestamp: number } | undefined;
 		const level = details?.level ?? "info";
 
@@ -29,7 +29,7 @@ export default function (pi: ExtensionAPI) {
 		}
 
 		// Use Box with customMessageBg for consistent styling
-		const box = new Box(1, 1, (t) => theme.bg("customMessageBg", t));
+		const box = new Box(outputPad, 1, (t) => theme.bg("customMessageBg", t));
 		box.addChild(new Text(text, 0, 0));
 		return box;
 	});

package/examples/extensions/overlay-qa-tests.ts

@@ -485,13 +485,13 @@ class StreamingOverflowComponent extends BaseOverlay {
 			echo ""
 			for i in $(seq 1 100); do
 				# Simulate long file paths with OSC 8 hyperlinks (clickable) - tests width overflow
-				DIR="/Users/nicobailon/Documents/development/pi-mono/packages/coding-agent/src/modes/interactive"
+				DIR="/opt/overlay-qa-fixtures/a-deliberately-long-project-directory/src/modes/interactive"
 				FILE="\${DIR}/components/very-long-component-name-that-exceeds-width-\${i}.ts"
 				echo -e "\\033]8;;file://\${FILE}\\007▶ read: \${FILE}\\033]8;;\\007"
 
 				# Add some colored status messages with long text
 				if [ $((i % 5)) -eq 0 ]; then
-					echo -e "  \\033[32m✓ Successfully processed \${i} files in /Users/nicobailon/Documents/development/pi-mono\\033[0m"
+					echo -e "  \\033[32m✓ Successfully processed \${i} files in \${DIR}\\033[0m"
 				fi
 				if [ $((i % 7)) -eq 0 ]; then
 					echo -e "  \\033[33m⚠ Warning: potential issue detected at line \${i} in very-long-component-name-that-exceeds-width.ts\\033[0m"

package/examples/extensions/project-trust.ts

@@ -4,11 +4,11 @@
  * Demonstrates the project_trust event. Install globally or pass via -e:
  *
  *   mkdir -p ~/.pi/agent/extensions
- *   cp packages/coding-agent/examples/extensions/project-trust.ts ~/.pi/agent/extensions/
+ *   cp examples/extensions/project-trust.ts ~/.pi/agent/extensions/
  *
  * Or:
  *
- *   pi -e packages/coding-agent/examples/extensions/project-trust.ts
+ *   pi -e examples/extensions/project-trust.ts
  *
  * Try it in a project containing .pi, AGENTS.md/CLAUDE.md, or .agents/skills.
  */

package/examples/sdk/README.md

@@ -1,6 +1,6 @@
 # SDK Examples
 
-Programmatic usage of pi-coding-agent via `createAgentSession()` and `createAgentSessionRuntime()`.
+Programmatic usage of `@astralyn/pi` via `createAgentSession()` and `createAgentSessionRuntime()`.
 
 The runtime example shows how to build a recreate function that closes over process-global fixed inputs and recreates cwd-bound services and sessions as the active session cwd changes.
 
@@ -15,7 +15,7 @@ The runtime example shows how to build a recreate function that closes over proc
 | `05-tools.ts` | Built-in tool allowlists |
 | `06-extensions.ts` | Logging, blocking, result modification |
 | `07-context-files.ts` | AGENTS.md context files |
-| `08-slash-commands.ts` | File-based slash commands |
+| `08-prompt-templates.ts` | File-based prompt templates |
 | `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
 | `10-settings.ts` | Override compaction, retry, terminal settings |
 | `11-sessions.ts` | In-memory, persistent, continue, list sessions |
@@ -24,75 +24,69 @@ The runtime example shows how to build a recreate function that closes over proc
 
 ## Running
 
+From the repository root, or from the root of an unpacked npm package:
+
 ```bash
-cd packages/coding-agent
 npx tsx examples/sdk/01-minimal.ts
 ```
 
 ## Quick Reference
 
 ```typescript
-import { getModel } from "@earendil-works/pi-ai";
 import {
   createAgentSession,
   DefaultResourceLoader,
+  getAgentDir,
   ModelRuntime,
   SessionManager,
   SettingsManager,
 } from "@astralyn/pi";
+import { getModel } from "@earendil-works/pi-ai/compat";
 
-const modelRuntime = await ModelRuntime.create();
-
-// Minimal
-const { session } = await createAgentSession({ modelRuntime });
+// Minimal: uses the default model, resources, tools, settings, and session storage.
+const { session } = await createAgentSession();
 
-// Custom model
+// Select a built-in model.
+const modelRuntime = await ModelRuntime.create();
 const model = getModel("anthropic", "claude-opus-4-5");
-const { session } = await createAgentSession({ model, thinkingLevel: "high", modelRuntime });
-
-// Modify prompt
-const loader = new DefaultResourceLoader({
-  systemPromptOverride: (base) => `${base}\n\nBe concise.`,
+if (model) {
+  const { session: modelSession } = await createAgentSession({
+    model,
+    thinkingLevel: "high",
+    modelRuntime,
+  });
+}
+
+// Replace the system prompt.
+const resourceLoader = new DefaultResourceLoader({
+  cwd: process.cwd(),
+  agentDir: getAgentDir(),
+  systemPromptOverride: () => "You are helpful and concise.",
+  appendSystemPromptOverride: () => [],
 });
-await loader.reload();
-const { session } = await createAgentSession({ resourceLoader: loader, modelRuntime });
-
-// Read-only
-const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], modelRuntime });
-
-// In-memory
-const { session } = await createAgentSession({
+await resourceLoader.reload();
+const { session: promptSession } = await createAgentSession({
+  resourceLoader,
   sessionManager: SessionManager.inMemory(),
-  modelRuntime,
 });
 
-// Full control
-const customRuntime = await ModelRuntime.create({
-  authPath: "/my/app/auth.json",
-  modelsPath: "/my/app/models.json",
+// Enable only read-only built-in tools and keep the session in memory.
+const { session: readOnlySession } = await createAgentSession({
+  tools: ["read", "grep", "find", "ls"],
+  sessionManager: SessionManager.inMemory(),
 });
-customRuntime.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
 
-const resourceLoader = new DefaultResourceLoader({
-  systemPromptOverride: () => "You are helpful.",
-  extensionFactories: [myExtension],
-  skillsOverride: () => ({ skills: [], diagnostics: [] }),
-  agentsFilesOverride: () => ({ agentsFiles: [] }),
-  promptsOverride: () => ({ prompts: [], diagnostics: [] }),
+// Override settings without file I/O.
+const settingsManager = SettingsManager.inMemory({
+  compaction: { enabled: false },
+  retry: { enabled: true, maxRetries: 2 },
 });
-await resourceLoader.reload();
-
-const { session } = await createAgentSession({
-  model,
-  modelRuntime: customRuntime,
-  resourceLoader,
-  tools: ["read", "bash", "my_tool"],
-  customTools: [myTool],
+const { session: configuredSession } = await createAgentSession({
+  settingsManager,
   sessionManager: SessionManager.inMemory(),
-  settingsManager: SettingsManager.inMemory(),
 });
 
-// Run prompts
+// Stream a response.
 session.subscribe((event) => {
   if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
     process.stdout.write(event.assistantMessageEvent.delta);

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.82.2",
+	"version": "0.82.3",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@astralyn/pi",
-			"version": "0.82.2",
+			"version": "0.82.3",
 			"license": "MIT",
 			"dependencies": {
 				"@earendil-works/pi-agent-core": "0.82.1",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.82.2",
+	"version": "0.82.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -31,11 +31,15 @@
 		"clean": "shx rm -rf dist",
 		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
 		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
+		"dev": "node scripts/run-source.mjs",
 		"format": "biome check --write .",
-		"check": "biome check --error-on-warnings . && npm run check:pinned-deps && npm run check:ts-imports && tsgo --noEmit && tsgo -p tsconfig.examples.json",
+		"check": "biome check --error-on-warnings . && npm run check:pinned-deps && npm run check:ts-imports && npm run check:docs && tsgo --noEmit && tsgo -p tsconfig.examples.json",
 		"check:pinned-deps": "node scripts/check-pinned-deps.mjs",
 		"check:ts-imports": "node scripts/check-ts-relative-imports.mjs",
+		"check:docs": "node scripts/check-docs.mjs",
 		"test": "vitest --run",
+		"test:isolated": "node scripts/test-isolated.mjs",
+		"diff:upstream": "node scripts/diff-upstream.mjs",
 		"verify:package-install": "node scripts/verify-package-install.mjs",
 		"profile:tui": "node scripts/profile-node.mjs --mode tui",
 		"profile:rpc": "node scripts/profile-node.mjs --mode rpc",

package/docs/development.md

@@ -1,68 +0,0 @@
-# Development
-
-See the repository [AGENTS.md](../AGENTS.md) for the distribution contract and coding conventions.
-
-## Setup
-
-```bash
-git clone https://github.com/ming-kang/pi
-cd pi
-npm install --ignore-scripts
-npm run build
-npm run check
-```
-
-The repository is the standalone `@astralyn/pi` package. AI, Agent core, and TUI are installed as exact upstream npm dependencies; no sibling workspace build is required.
-
-Run from source:
-
-```bash
-./pi-test.sh
-```
-
-The script can be invoked from any directory. Pi keeps the caller's current working directory. Use `./pi-test.sh --no-env` to clear provider credentials for the source run.
-
-## Package identity
-
-Distribution identity and configuration directory defaults are defined in `package.json`:
-
-```json
-{
-  "name": "@astralyn/pi",
-  "piConfig": {
-    "configDir": ".pi"
-  },
-  "bin": {
-    "pi": "dist/cli.js"
-  }
-}
-```
-
-## Path resolution
-
-Pi supports npm installation and `tsx` source execution. Always use `src/config.ts` helpers such as `getPackageDir()` and `getThemeDir()` for package assets; do not derive asset paths directly from `__dirname`.
-
-## Debug command
-
-`/debug` (hidden) writes rendered TUI lines and the latest model messages to `~/.pi/agent/pi-debug.log`.
-
-## Testing
-
-```bash
-npm run check
-node node_modules/vitest/dist/cli.js --run test/specific.test.ts
-./test.sh  # complete isolated test suite
-```
-
-Release CI runs the full suite on Ubuntu. Interactive UI changes should also be verified in a real terminal.
-
-## Project structure
-
-```text
-src/                 runtime source
- test/                automated tests and local test helpers
- docs/                product and public API documentation
- examples/            SDK and extension examples
- docs/distribution/   standalone distribution documentation
- scripts/             package maintenance scripts
-```

package/docs/distribution/README.md

@@ -1,34 +0,0 @@
-# Distribution documentation
-
-This directory contains documentation owned by the standalone `@astralyn/pi` distribution. Product usage and public API documentation inherited from upstream coding-agent lives one level above under `docs/`.
-
-## User documentation
-
-- [Distribution overview](../../README.md) — package identity, installation, bundled features, and development entry points.
-- [Quickstart](../quickstart.md) — install, authenticate, and run a first session.
-- [User and API documentation](../index.md) — interactive mode, settings, customization, SDK, RPC, and platform notes.
-- [Extension API](../extensions.md) — write external TypeScript extensions.
-- [Theme API](../themes.md) — create and load custom themes.
-
-## Architecture and design
-
-- [Architecture and dependency boundaries](architecture.md)
-- [Native tool presentation](tool-presentation.md)
-- [Bundled theme design](themes.md)
-
-## Bundled extensions
-
-- [Catalog](extensions/README.md)
-- [deepwiki](extensions/deepwiki.md)
-- [question](extensions/question.md)
-- [rewind](extensions/rewind.md)
-- [router](extensions/router.md)
-- [statusline](extensions/statusline.md)
-- [subagent](extensions/subagent.md)
-- [todo](extensions/todo.md)
-
-## Maintainer documentation
-
-- [Upstream synchronization](maintenance.md)
-- [OIDC npm release checklist](release.md)
-- [Repository contract](../../AGENTS.md)

package/docs/distribution/architecture.md

@@ -1,102 +0,0 @@
-# Distribution architecture
-
-## Purpose
-
-This repository is a standalone personal distribution of Pi's coding-agent package. Its goals are to:
-
-- maintain only code that ships in `@astralyn/pi`;
-- consume AI, Agent core, and TUI from upstream npm releases;
-- keep native tool presentation, bundled workflow extensions, themes, and context-safety behavior local to this package;
-- avoid cross-workspace source changes and multi-package release coordination.
-
-## Package boundary
-
-The repository root is the npm package:
-
-```text
-src/                 coding-agent runtime
- test/                coding-agent tests
- docs/                product and API documentation
- examples/            SDK and extension examples
- docs/distribution/   distribution-owned documentation
- package.json          @astralyn/pi
- npm-shrinkwrap.json   development and published dependency lock
-```
-
-The runtime boundary is explicit and versioned in `package.json`:
-
-- `@earendil-works/pi-ai`
-- `@earendil-works/pi-agent-core`
-- `@earendil-works/pi-tui`
-
-These are exact registry dependencies. Their source is not copied into this repository and local verification resolves the same published packages that npm users install. A coding-agent synchronization that needs new upstream APIs must update all compatible dependency versions in the same change.
-
-Presentation-only metadata such as `toolGroup` uses coding-agent-local intersection types rather than changing `AgentTool`. The long-tool-loop compaction implementation uses the upstream stateful Agent's public `prepareNextTurnWithContext` callback for successful same-run continuation. Exceptional fail-closed paths are represented locally as explicit error/aborted lifecycle boundaries because the stateful Agent does not expose its low-level graceful turn-stop callback.
-
-## Core and extension boundary
-
-Pi core changes are reserved for behavior that must be global:
-
-- native tool call/result chrome and generic renderer fallback;
-- built-in renderer integration;
-- context-safety checks such as between-tool-batch auto-compaction;
-- globally configurable keybindings required by bundled UI.
-
-Personal workflow features remain self-contained extensions:
-
-```text
-src/extensions/
-├── deepwiki/
-├── question/
-├── todo/
-├── rewind/
-├── router/
-├── statusline/
-└── subagent/
-```
-
-They are registered as hidden `InlineExtension` entries in `src/extensions/index.ts`. No shared Fork framework, feature registry, or cross-extension internal API is used.
-
-## Configuration compatibility
-
-The command remains `pi`, and settings and sessions remain under `~/.pi/agent`. Built-in extensions store their first-class data alongside the normal agent data, including:
-
-```text
-~/.pi/agent/router.json
-~/.pi/agent/rewind/
-```
-
-No separate Fork configuration layer is introduced.
-
-## Themes
-
-`ice-cream-dark` and `ice-cream-light` are native theme assets under `src/modes/interactive/theme/`. The normal package build copies all theme JSON files into `dist`.
-
-## Upstream synchronization
-
-The `upstream` remote still points to `earendil-works/pi`, but upstream monorepo tags are not merged into this standalone branch. Synchronization extracts and reviews only `packages/coding-agent/**` from an upstream release tag, maps that subtree to the repository root, and updates exact registry dependency versions. See [maintenance.md](maintenance.md).
-
-Recurring review hotspots are:
-
-```text
-src/extensions/index.ts
-src/core/agent-session.ts
-src/core/keybindings.ts
-src/core/tools/*.ts
-src/modes/interactive/components/tool-execution.ts
-src/modes/interactive/interactive-mode.ts
-src/modes/interactive/theme/theme.ts
-package.json
-CHANGELOG.md
-```
-
-## Release model
-
-Only `@astralyn/pi` is published. Fork releases track the upstream `major.minor` line while using the patch number for this distribution's release sequence:
-
-```text
-upstream 0.82.x -> Fork 0.82.0, 0.82.1, 0.82.2, ...
-upstream 0.83.x -> Fork 0.83.0, 0.83.1, 0.83.2, ...
-```
-
-Tags use `pi-v<full-version>` so they do not collide with upstream `v<version>` tags. Ubuntu CI verifies the standalone package, and the manually dispatched publish workflow uploads the repository root with npm Trusted Publishing. No other package, binary release flow, model catalog, or update service is maintained here.

package/docs/distribution/extensions/README.md

@@ -1,17 +0,0 @@
-# Bundled extensions
-
-These are extensions shipped by the distribution. For the public API used to write external extensions, see the [Extension API documentation](../../extensions.md).
-
-The bundled extensions are maintained as self-contained TypeScript modules under `src/extensions/` and registered as hidden built-in extensions.
-
-| Extension | Tool or command | Documentation |
-|---|---|---|
-| `deepwiki` | `deepwiki` | [deepwiki.md](deepwiki.md) |
-| `question` | `question` | [question.md](question.md) |
-| `todo` | `todo`, `/todos` | [todo.md](todo.md) |
-| `rewind` | `/rewind`, `/tree` lifecycle | [rewind.md](rewind.md) |
-| `router` | `/router` | [router.md](router.md) |
-| `statusline` | Footer | [statusline.md](statusline.md) |
-| `subagent` | `subagent`, `/agents` | [subagent.md](subagent.md) |
-
-The extensions continue to use Pi's public Extension API. Keeping their distribution notes here does not merge their implementations into the coding-agent core.