@vitos-pizza/vitos-pizza 0.1.0

package/AGENTS.md

@@ -0,0 +1,158 @@
+# Vito's Pizzeria — Agent Instructions
+
+This repository is **vitos-pizza**, a [Pi](https://pi.dev/) **distribution** (like LazyVim for Neovim). Users install the repo root once via `pi install .` and get the full curated experience.
+
+Inspired by Vito's Pizzeria from Garfield — one brand, one install.
+
+## Structure
+
+- **Repo root** — The distribution. `package.json` is the pi-package manifest.
+- **`packages/<module>/`** — Built-in modules (e.g. `@vitos-pizza/agent-mode`, `@vitos-pizza/question`, `@vitos-pizza/session-title`, `@vitos-pizza/permission-system`, `@vitos-pizza/subagents`, `@vitos-pizza/keybindings`). Not installed separately by users.
+- **`scripts/sync-pi-manifest.mjs`** — Scans `packages/*`, merges `piBundled` npm packages, and updates root `dependencies` + `pi` manifest. Honors `pi.requires` for extension load order.
+
+## Bundled third-party Pi packages
+
+Declare npm pi packages in root `package.json`:
+
+- `dependencies` — version range
+- `bundledDependencies` — include in the distribution tarball
+- `piBundled` — list read by `sync-pi-manifest.mjs` to merge `node_modules/<pkg>/` paths into the root `pi` manifest
+
+Extension load order: topological sort of `pi.requires`, with `LOCAL_ORDER` tie-break. Default: `permission-system` → `question` → `ui-enhancements` → `agent-mode` → `subagents` → `session-title` → `keybindings`.
+
+## Agent mode
+
+Vito's Pizzeria uses three centralized modes via **`@vitos-pizza/agent-mode`**:
+
+| Mode | Permissions | Behavior |
+|------|-------------|----------|
+| `agent` | `default` preset | Balanced daily work |
+| `plan` | `plan` preset | Read-only; scout → planner via subagents + `question` |
+| `execute` | `yolo` preset | Minimal gates; full implementation |
+
+Switch with `/mode [agent|plan|execute]` or **`F6`** (`agent-mode.cycle`). Current mode appears in the ui-enhancements border bar (`· plan` / `· execute`).
+
+## Keyboard shortcuts
+
+Pi already provides built-in keybindings (`~/.pi/agent/keybindings.json`, namespaced `app.*` / `tui.*`) and extension shortcuts via `pi.registerShortcut()`.
+
+**vitos-pizza convention:** only `@vitos-pizza/keybindings` may call `pi.registerShortcut`. Other modules register **actions** (not keys) during `session_start`:
+
+```typescript
+import { emitShortcutAction } from "@vitos-pizza/keybindings/types";
+
+// session_start — register handler only; keys come from vitos-shortcuts.json
+emitShortcutAction(pi.events, {
+  id: "agent-mode.cycle",
+  description: "Cycle agent mode (agent → plan → execute)",
+  handler: async (ctx) => { /* ... */ },
+});
+```
+
+Key config (project overrides global overrides preset defaults):
+
+- `packages/keybindings/presets/shortcuts.json` — distribution defaults
+- `~/.pi/agent/vitos-shortcuts.json` — user global overrides
+- `<cwd>/.pi/vitos-shortcuts.json` — project overrides
+
+Use `/vitos-shortcuts` to list registered actions and current bindings. Pi built-in shortcuts remain in `/hotkeys` and `keybindings.json`.
+
+Each module follows Pi conventions:
+
+```
+packages/<module>/
+├── extensions/     # TypeScript (*.ts)
+├── skills/         # */SKILL.md (optional)
+├── prompts/        # *.md slash templates (optional)
+└── themes/         # *.json (optional)
+```
+
+## Adding a module
+
+1. Create `packages/<name>/` with `package.json` (`"name": "@vitos-pizza/<name>"`).
+2. Optional: declare `"pi": { "requires": ["@vitos-pizza/other-module"] }` so sync orders extensions correctly.
+3. Add extensions, skills, prompts, or themes as needed.
+4. If you referenced external open source, add an **Acknowledgments** row in [README.md](README.md) (see **Open-source acknowledgments** below).
+5. Run `npm run sync && npm install` at repo root.
+6. Reload Pi with `/reload` or `pi install .`.
+
+## Dependency rules
+
+- **Pi core packages** (`@earendil-works/pi-coding-agent`, `@earendil-works/pi-agent-core`, `@earendil-works/pi-ai`, `@earendil-works/pi-tui`, `typebox`) → `peerDependencies: "*"` only.
+- **Third-party runtime deps** → `dependencies` in the module that uses them.
+
+## Subagent delegation
+
+All child-agent work in vitos-pizza modules must go through **`@vitos-pizza/subagents`** — use `requestSubagentRun` / `requestSubagentWait` from `@vitos-pizza/subagents/rpc/client` on `pi.events`. Do not call `completeSimple` or spawn `pi` directly for delegated agent runs.
+
+Declare `"pi": { "requires": ["@vitos-pizza/subagents"] }` in the consuming module's `package.json` so extension load order is correct.
+
+## Ask-user questions
+
+Structured clarification (multiple-choice UI) uses **`@vitos-pizza/question`** — the `question` tool. Main sessions show the TUI directly; subagent children forward prompts to the parent session (events RPC + file fallback). Planner and scout agents include `question` in their `tools:` list.
+
+## Open-source acknowledgments
+
+Whenever work **references, adapts, or depends on** external open source, add or update an entry in [README.md](README.md) → **Acknowledgments**. Do this in the **same PR** as the feature or dependency change — not as a follow-up.
+
+**Must acknowledge:**
+
+- Pi extensions / npm packages you read, port patterns from, or bundle (`piBundled`, `dependencies`)
+- GitHub repos or docs used as implementation reference (even if reimplemented in-tree)
+- New runtime `dependencies` in any `packages/*/package.json`
+- UX or architecture inspiration with a named upstream (e.g. Claude Code–style presets)
+
+**Do not** list every transitive npm package — only direct references and meaningful upstreams.
+
+**Where to put each entry** (keep existing subsection structure):
+
+| Kind | README subsection |
+|------|-------------------|
+| Platform / distribution model | `### Platform & distribution model` |
+| Feature reference, port, or bundled Pi package | `### Features referenced or adapted` |
+| Direct runtime or dev tooling dependency | `### Runtime & tooling libraries` |
+
+**Row format** (match existing tables):
+
+```markdown
+| [Project name](https://…/) | `@vitos-pizza/<module>` or area | One line: what we took or how we use it |
+```
+
+For libraries, the Link column can hold the homepage; for features, link the repo, npm page, or Pi package catalog URL.
+
+**Adding a module checklist** — in addition to sync/install, if the module references upstream work, extend README Acknowledgments before merging.
+
+## Development
+
+- No build step — Pi loads TypeScript via jiti.
+- After editing extensions: `/reload`.
+- Type-check: `npm run typecheck`
+- Test: `npm run test`
+- Lint: `npm run lint`
+
+## Plan documents
+
+Feature plans should include a short **`## 功能验收`** section (3–6 checkboxes) between the implementation approach and risks/constraints. Each item states an observable outcome, e.g. `xxx 功能已实现：<what the user can verify>`. Implementation is not done until every item can be answered yes/no.
+
+If the plan references external open source, include a checkbox: `README Acknowledgments 已更新（如有上游参考）`.
+
+## Install
+
+```bash
+pi install .           # global settings
+pi install -l .        # project .pi/settings.json
+pi -e .                # try without installing
+```
+
+## Extension API
+
+```typescript
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+  pi.registerCommand("hello", { /* ... */ });
+  pi.on("session_start", async (_event, ctx) => { /* ... */ });
+}
+```
+
+See [Pi Extensions docs](https://pi.dev/docs/latest/extensions).

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to vitos-pizza are documented here.
+
+## [0.1.0] - 2026-07-10
+
+### Added
+
+- Rebrand from xin-pi to **vitos-pizza** (维多披萨 / Vito's Pizzeria)
+- Pi distribution layout: repo root as single install entry
+- `scripts/sync-pi-manifest.mjs` module assembler
+- Original logo at `assets/logo.svg`
+
+### Removed
+
+- Nested `packages/xin-pi` aggregator
+- `@xin-pi/core`, template scaffold, postinstall symlink hack
+
+### Publishing
+
+- GitHub Actions publishes `@vitos-pizza/vitos-pizza` via **npm Trusted Publishing (OIDC)** — no long-lived `NPM_TOKEN`
+- Workflow: `.github/workflows/publish.yml` (triggers on `v*` tags / `workflow_dispatch`)
+- `scripts/prepare-publish.mjs` rewrites `file:` workspace deps for the npm tarball
+- First package version must be published once manually (or as a stub) before Trusted Publisher can be configured on npmjs.com

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vitos-pizza contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+<p align="center">
+  <img src="./assets/logo.svg" alt="Vito's Pizzeria — Pi distribution" width="160" />
+  <br />
+  <strong>维多披萨 · Vito's Pizzeria</strong>
+  <br />
+  <em>加菲猫同款 Pi 发行版 — 一次安装，开箱即用</em>
+</p>
+
+# vitos-pizza
+
+**Vito's Pizzeria** is a personal [Pi](https://pi.dev/) distribution — like LazyVim for Neovim. One install gives you a curated set of extensions and workflows. Built on upstream Pi, not a fork.
+
+Inspired by [Vito's Pizzeria](https://garfield.fandom.com/wiki/Vito_Cappelletti) from Garfield — Garfield's favorite pizza place.
+
+## Prerequisites
+
+- Node.js >= 22.19.0
+- [Pi](https://pi.dev/) installed globally:
+
+```bash
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent
+```
+
+## Install
+
+```bash
+# npm (recommended)
+pi install npm:@vitos-pizza/vitos-pizza@0.1.0
+
+# git (pinned tag)
+pi install git:github.com/xin2017338/vitos-pizza@v0.1.0
+```
+
+From source:
+
+```bash
+git clone https://github.com/xin2017338/vitos-pizza.git vitos-pizza
+cd vitos-pizza
+npm install
+
+# Global Pi settings (~/.pi/agent/settings.json)
+npm run install:pi
+# or: pi install .
+
+# Project-local settings (.pi/settings.json)
+npm run install:pi:local
+# or: pi install -l .
+
+# Try without installing
+npm run try:pi
+# or: pi -e .
+```
+
+After install, start `pi`. Sessions are auto-titled from the first meaningful user message (see **Session auto-title** below). Delegate work with **subagents** (see below). When you change extension code, use `/reload`.
+
+## Structure
+
+```
+vitos-pizza/                 # Pi distribution (install this)
+├── assets/logo.svg
+├── package.json             # distro manifest + pi-package entry
+├── AGENTS.md
+└── packages/                # built-in modules (not installed separately)
+    ├── ui-enhancements/   # @vitos-pizza/ui-enhancements — TUI display optimizations
+    ├── agent-mode/          # @vitos-pizza/agent-mode — agent / plan / execute mode switching
+    ├── permission-system/   # @vitos-pizza/permission-system — allow/ask/deny gates
+    ├── question/            # @vitos-pizza/question — structured ask-user question tool
+    ├── session-title/       # @vitos-pizza/session-title — auto session naming
+    ├── subagents/           # @vitos-pizza/subagents — scout/planner/worker delegation
+    ├── websearch/           # @vitos-pizza/websearch — web_search / web_read tools
+    └── keybindings/         # @vitos-pizza/keybindings — centralized shortcut bindings
+```
+
+Built-in modules are wired via `scripts/sync-pi-manifest.mjs` (supports `pi.requires` load order).
+
+| Path | Role |
+|------|------|
+| Repo root | **The distribution** — `pi install .` |
+| `packages/<module>/` | Built-in capability modules |
+| `scripts/sync-pi-manifest.mjs` | Wires modules into the root pi manifest |
+
+## Session auto-title
+
+Built-in module `@vitos-pizza/session-title` names sessions asynchronously after the **first agent reply**:
+
+- Waits for the first turn to finish, then summarizes user intent + assistant reply via the **subagents `title` agent** (RPC, not a direct LLM call)
+- Title is ≤20 characters; trivial greetings are skipped via fast rules
+- Runs in the background — does not block the main agent
+- Optional dedicated model via `.pi/settings.json`; defaults to the current session model
+
+Example settings (also in [`.pi/settings.example.json`](.pi/settings.example.json)):
+
+```json
+{
+  "session": {
+    "autoTitle": {
+      "enabled": true,
+      "model": "google/gemini-2.5-flash",
+      "minCharsForLlm": 4,
+      "fastRules": true
+    }
+  }
+}
+```
+
+Use `/name` to override manually. See auto titles in `/resume`.
+
+## Subagents & permissions
+
+Built-in **@vitos-pizza/subagents** lets the main agent delegate via the `subagent` and `wait` tools:
+
+```text
+subagent({ agent: "scout", task: "map the auth module" })
+subagent({ chain: [{ agent: "scout", task: "..." }, { agent: "planner", task: "plan from {previous}" }] })
+subagent({ tasks: [{ agent: "scout", task: "scan src" }, { agent: "scout", task: "scan tests" }] })
+subagent({ agent: "worker", task: "...", async: true })  →  wait({ id: "<runId>" })
+```
+
+Built-in agents: **scout**, **planner**, **worker**, **title** (session auto-naming). Other modules request runs over `pi.events` RPC — import `requestSubagentRun` from `@vitos-pizza/subagents/rpc/client`.
+
+## Web search
+
+Built-in **@vitos-pizza/websearch** adds `web_search` and `web_read` tools. Works out of the box via Exa MCP and keyless Firecrawl — no API keys required for basic use.
+
+```text
+web_search({ query: "TypeScript 5.8 release notes" })
+web_read({ url: "https://docs.example.com/guide" })
+/search-status
+```
+
+Default backends: **Exa MCP** → **Firecrawl** → optional keyed providers. Configure globally at `~/.pi/agent/extensions/search.json` or per-project at `.pi/search.json` (see [`.pi/search.example.json`](.pi/search.example.json)).
+
+Permissions: `web_search` and `web_read` are **ask** in `agent` and `plan` modes (subagent `ask` prompts forward to the parent session); **allow** in `execute` mode.
+
+Do not install community search extensions (e.g. `pi-web-access`, `pi-search-hub`) alongside vitos-pizza — tool names would collide.
+
+Built-in **@vitos-pizza/ui-enhancements** improves TUI readability: built-in tools use smart compact rendering (read-only `bash`/`grep`/`read` collapsed by default; `write`/`edit`/dangerous commands always show full output). Toggle expansion with `Ctrl+O`. Welcome header and border status bar are on by default (no settings required). Use `/vitos-ui` for status; `/builtin-header` restores Pi's built-in header.
+
+Built-in **@vitos-pizza/permission-system** enforces allow / ask / deny on tools, bash, and paths. Child subagent `ask` prompts forward to the parent session UI automatically.
+
+### Agent modes
+
+`@vitos-pizza/agent-mode` provides three project-level modes. Switch with:
+
+```text
+/mode                         # interactive picker
+/mode plan                    # or agent | execute
+```
+
+Or press **`F6`** to cycle agent → plan → execute. Use `/vitos-shortcuts` to view bindings.
+
+| Mode | Permissions | Behavior |
+|------|-------------|----------|
+| `agent` | `default` | Balanced — read/grep/find/ls allowed in the git repo; bash `ask` for other commands |
+| `plan` | `plan` | Read-only — explore without edits or shell; `subagent` / `question` for scout/planner |
+| `execute` | `yolo` | Minimal gates — only blocks `.env`, `~/.ssh`, `rm -rf` |
+
+Current mode is shown in the border status bar (`· plan` / `· execute`). On first session in a project, `agent` + `default` preset is written to `.pi/extensions/pi-permission-system/config.json` if missing. Use `/permission-system` for debug/YOLO runtime toggles. See [config.example.json](.pi/extensions/pi-permission-system/config.example.json).
+
+Optional subagents settings in [`.pi/settings.example.json`](.pi/settings.example.json) (`subagents.disableThinking`, model overrides, etc.).
+
+## Adding a module
+
+1. Have AI (or you) create `packages/<name>/` with `package.json`, `extensions/`, etc.
+2. Set `"name": "@vitos-pizza/<name>"` in the module's `package.json`.
+3. Run:
+
+```bash
+npm run sync
+npm install
+pi install .   # or /reload in Pi
+```
+
+## Development
+
+```bash
+npm run sync         # Regenerate root pi manifest from packages/*
+npm run typecheck
+npm run lint
+npm run lint:fix
+```
+
+Pi loads TypeScript extensions directly — no build step.
+
+## Acknowledgments
+
+vitos-pizza builds on the Pi ecosystem and several open-source projects. We are grateful to their authors and contributors.
+
+**Convention:** any new feature, module, or dependency that references external open source must add a row here (see [AGENTS.md](AGENTS.md) → Open-source acknowledgments).
+
+### Platform & distribution model
+
+| Project | Role | Link |
+|---------|------|------|
+| **Pi** (`@earendil-works/pi-coding-agent`) | Agent runtime, extension API, and TUI — the foundation this distribution installs on top of | [pi.dev](https://pi.dev/) · [GitHub](https://github.com/earendil-works/pi) |
+| **LazyVim** | Inspiration for the “one install, curated defaults” distribution model (Pi distribution ≈ LazyVim for Neovim) | [GitHub](https://github.com/LazyVim/LazyVim) |
+
+### Features referenced or adapted
+
+| Project | Used in | Notes |
+|---------|---------|-------|
+| [Pi official subagent example](https://github.com/earendil-works/pi/tree/main/packages/coding-agent/examples/extensions/subagent) | `@vitos-pizza/subagents` | Subprocess spawn, chain/parallel delegation, agent markdown discovery |
+| [Pi official `question` example](https://github.com/earendil-works/pi/tree/main/packages/coding-agent/examples/extensions/question.ts) | `@vitos-pizza/question` | Structured ask-user UI (`ctx.ui.custom`); adapted with subagent parent-session forwarding |
+| [@gotgenes/pi-permission-system](https://www.npmjs.com/package/@gotgenes/pi-permission-system) | `@vitos-pizza/permission-system` | Flat permission config format, preset modes, subagent prompt forwarding — reimplemented in-tree |
+| [@ryan_nookpi/pi-extension-auto-name](https://www.npmjs.com/package/@ryan_nookpi/pi-extension-auto-name) | `@vitos-pizza/session-title` | Fire-and-forget async title via `completeSimple` |
+| [djdembeck/pi-session-title](https://github.com/djdembeck/pi-session-title) | `@vitos-pizza/session-title` | Early community session naming patterns |
+| [pi-subagents](https://pi.dev/packages/pi-subagents) (nicobailon) | Subagent design | Community reference when shaping chain/parallel UX |
+| [pi-search-hub](https://github.com/ronnieops/pi-search-hub) | `@vitos-pizza/websearch` | Backend registry, config merge, auto-fallback dispatch, `/search-status` |
+| [pi-web-access](https://github.com/nicobailon/pi-web-access) | `@vitos-pizza/websearch` | Zero-config Exa MCP default chain and tool prompt guidelines |
+| [pi-web-search](https://github.com/ttttmr/pi-web-search) | `@vitos-pizza/websearch` | `session_start` config refresh lifecycle pattern |
+| [Pi `minimal-mode` / `built-in-tool-renderer` examples](https://github.com/earendil-works/pi/tree/main/packages/coding-agent/examples/extensions) | `@vitos-pizza/ui-enhancements` | Compact built-in tool rendering and smart bash collapse |
+| [Virgil-Bulens minimal-mode gist](https://gist.github.com/Virgil-Bulens/4d9d747ef85709b0850fc5aa01a6a4ef) | `@vitos-pizza/ui-enhancements` | Read-only bash whitelist and session collapsed-by-default UX |
+| [pi-statusbar](https://github.com/BumpyClock/pi-statusbar) | `@vitos-pizza/ui-enhancements` | Welcome header layout and loaded-counts information architecture |
+| [pi-powerline-footer](https://github.com/nicobailon/pi-powerline-footer) | `@vitos-pizza/ui-enhancements` | Welcome panel design and recent-sessions discovery |
+| [Pi `border-status-editor` example](https://github.com/earendil-works/pi/tree/main/packages/coding-agent/examples/extensions/border-status-editor.ts) | `@vitos-pizza/ui-enhancements` | Editor-border status bar (model, thinking, context, cwd, git) |
+| [sf-welcome](https://github.com/salesforce/sf-pi/blob/main/extensions/sf-welcome/index.ts) | `@vitos-pizza/ui-enhancements` | Welcome header session lifecycle and tips layout |
+| **Claude Code** permission UX | Agent modes (`agent` / `plan` / `execute`) | Preset naming and mode-switching inspiration (not a code dependency) |
+| [pi-package-template](https://github.com/S1M0N38/pi-package-template) | Repo layout | Pi package monorepo conventions |
+
+### Runtime & tooling libraries
+
+| Library | Used in | Link |
+|---------|---------|------|
+| [tree-sitter-bash](https://github.com/tree-sitter/tree-sitter-bash) + [web-tree-sitter](https://github.com/tree-sitter/tree-sitter) | `@vitos-pizza/permission-system` | Bash command parsing for permission gates |
+| [Zod](https://github.com/colinhacks/zod) | `@vitos-pizza/permission-system` | Config validation |
+| [Biome](https://biomejs.dev/) | Dev tooling | Lint and format |
+| [Vitest](https://vitest.dev/) | Tests | Unit and integration tests |
+| [TypeScript](https://www.typescriptlang.org/) | All packages | Type checking |
+
+If we missed a project you rely on, please open an issue or PR — we want to credit every upstream contribution properly.
+
+## License
+
+MIT

package/assets/logo.svg

@@ -0,0 +1,28 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" role="img" aria-label="Vito's Pizzeria">
+  <defs>
+    <linearGradient id="crust" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#f4a442"/>
+      <stop offset="100%" stop-color="#d97706"/>
+    </linearGradient>
+    <linearGradient id="neon" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#ff6b6b"/>
+      <stop offset="50%" stop-color="#ff4757"/>
+      <stop offset="100%" stop-color="#c0392b"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="2.5" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+  <path d="M100 24 L168 156 Q100 176 32 156 Z" fill="url(#crust)" stroke="#b45309" stroke-width="3"/>
+  <path d="M100 24 L100 156" stroke="#b45309" stroke-width="2" opacity="0.5"/>
+  <circle cx="118" cy="98" r="9" fill="#dc2626"/>
+  <circle cx="88" cy="118" r="8" fill="#dc2626"/>
+  <circle cx="108" cy="132" r="7" fill="#dc2626"/>
+  <circle cx="72" cy="108" r="6" fill="#dc2626"/>
+  <rect x="18" y="162" width="164" height="28" rx="6" fill="#1a1a2e" stroke="#334155" stroke-width="2"/>
+  <text x="100" y="182" text-anchor="middle" font-family="Georgia, 'Times New Roman', serif" font-size="18" font-weight="bold" fill="url(#neon)" filter="url(#glow)">VITO</text>
+</svg>

package/node_modules/@vitos-pizza/agent-mode/extensions/index.ts

@@ -0,0 +1,117 @@
+/**
+ * @vitos-pizza/agent-mode — centralized agent / plan / execute mode switching.
+ */
+
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { emitShortcutAction } from "@vitos-pizza/keybindings/types";
+import {
+	applyAgentMode,
+	createReloadEmitter,
+	ensureAgentModePersisted,
+} from "../src/apply-mode.ts";
+import {
+	clearAgentModeStatus,
+	emitAgentModeChanged,
+	updateAgentModeStatusFallback,
+} from "../src/mode-events.ts";
+import {
+	AGENT_MODES,
+	cycleAgentMode,
+	isAgentMode,
+	MODE_LABELS,
+	type AgentMode,
+} from "../src/modes.ts";
+import {
+	PLAN_INSTRUCTIONS,
+	PLAN_MODE_MESSAGE,
+	PLAN_MODE_TOOLS,
+} from "../src/plan-instructions.ts";
+
+export default function (pi: ExtensionAPI): void {
+	let currentMode: AgentMode = "agent";
+
+	const emitReload = createReloadEmitter(pi.events);
+
+	const publishMode = (ctx: ExtensionContext, mode: AgentMode) => {
+		currentMode = mode;
+		emitAgentModeChanged(pi.events, mode);
+		updateAgentModeStatusFallback(ctx, mode);
+	};
+
+	const switchMode = async (ctx: ExtensionContext, mode: AgentMode) => {
+		applyAgentMode(ctx.cwd, mode, { emitReload: emitReload });
+		publishMode(ctx, mode);
+		ctx.ui.notify(`Mode: ${mode}`, "info");
+	};
+
+	emitShortcutAction(pi.events, {
+		id: "agent-mode.cycle",
+		description: "Cycle agent mode (agent → plan → execute)",
+		handler: async (shortcutCtx) => {
+			const next = cycleAgentMode(currentMode);
+			await switchMode(shortcutCtx, next);
+		},
+	});
+
+	pi.on("session_start", async (_event, ctx) => {
+		const mode = ensureAgentModePersisted(ctx.cwd, { emitReload });
+		publishMode(ctx, mode);
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		clearAgentModeStatus(ctx);
+	});
+
+	pi.on("before_agent_start", async (event, _ctx) => {
+		if (currentMode !== "plan") return {};
+
+		const registered = new Set(pi.getAllTools().map((tool) => tool.name));
+		const activeTools = PLAN_MODE_TOOLS.filter((name) => registered.has(name));
+		if (activeTools.length > 0) {
+			pi.setActiveTools([...activeTools]);
+		}
+
+		return {
+			message: {
+				customType: "agent-plan-mode",
+				content: PLAN_MODE_MESSAGE,
+				display: false,
+			},
+			systemPrompt: `${event.systemPrompt}\n\n${PLAN_INSTRUCTIONS}`,
+		};
+	});
+
+	pi.registerCommand("mode", {
+		description: "Switch agent mode (agent|plan|execute)",
+		handler: async (args, ctx) => {
+			const requested = args?.trim().toLowerCase();
+			let mode: AgentMode | undefined;
+
+			if (requested) {
+				if (!isAgentMode(requested)) {
+					ctx.ui.notify(
+						`Unknown mode "${requested}". Use: ${AGENT_MODES.join(", ")}`,
+						"error",
+					);
+					return;
+				}
+				mode = requested;
+			} else if (ctx.hasUI) {
+				const options = AGENT_MODES.map((m) => MODE_LABELS[m]);
+				const selected = await ctx.ui.select("Agent mode", options);
+				if (!selected) return;
+				const index = options.indexOf(selected);
+				if (index < 0) return;
+				mode = AGENT_MODES[index];
+			} else {
+				ctx.ui.notify(`Usage: /mode <${AGENT_MODES.join("|")}>`, "info");
+				return;
+			}
+
+			await switchMode(ctx, mode);
+		},
+	});
+}

package/node_modules/@vitos-pizza/agent-mode/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@vitos-pizza/agent-mode",
+	"version": "0.1.0",
+	"description": "Centralized agent / plan / execute mode switching for Vito's Pizzeria",
+	"type": "module",
+	"license": "MIT",
+	"private": true,
+	"scripts": {
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write ."
+	},
+	"dependencies": {
+		"@vitos-pizza/keybindings": "0.1.0",
+		"@vitos-pizza/permission-system": "0.1.0"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*"
+	},
+	"pi": {
+		"requires": [
+			"@vitos-pizza/permission-system"
+		]
+	},
+	"devDependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"vitest": "^3.2.4"
+	}
+}

package/node_modules/@vitos-pizza/agent-mode/src/apply-mode.ts

@@ -0,0 +1,60 @@
+import {
+	applyPermissionPreset,
+	loadProjectConfig,
+	PERMISSION_RELOAD_CONFIG_EVENT,
+	saveProjectConfig,
+} from "@vitos-pizza/permission-system/mode-api";
+import {
+	inferAgentMode,
+	PRESET_BY_MODE,
+	type AgentMode,
+} from "./modes.ts";
+
+export interface ApplyAgentModeDeps {
+	emitReload: () => void;
+}
+
+export function applyAgentMode(
+	cwd: string,
+	mode: AgentMode,
+	deps?: ApplyAgentModeDeps,
+): AgentMode {
+	const preset = PRESET_BY_MODE[mode];
+	applyPermissionPreset(cwd, preset);
+	const existing = loadProjectConfig(cwd);
+	const next = {
+		...existing,
+		agentMode: mode,
+		yoloMode: false,
+	};
+	saveProjectConfig(cwd, next);
+	deps?.emitReload();
+	return mode;
+}
+
+export function resolveCurrentAgentMode(cwd: string): AgentMode {
+	const config = loadProjectConfig(cwd);
+	return inferAgentMode(config);
+}
+
+export function ensureAgentModePersisted(
+	cwd: string,
+	deps?: ApplyAgentModeDeps,
+): AgentMode {
+	const config = loadProjectConfig(cwd);
+	const mode = inferAgentMode(config);
+	if (config.agentMode !== mode) {
+		applyAgentMode(cwd, mode, deps);
+		return mode;
+	}
+	deps?.emitReload();
+	return mode;
+}
+
+export function createReloadEmitter(
+	events: { emit: (channel: string, payload: unknown) => void },
+): () => void {
+	return () => {
+		events.emit(PERMISSION_RELOAD_CONFIG_EVENT, {});
+	};
+}