Merge pull request #43 from narumiruna/chore/deprecate-split-lsp

chore: deprecate split lsp extensions

Author: narumiruna

AGENTS.md

@@ -15,8 +15,8 @@ Run commands from the repository root unless noted otherwise.
 - Full verification: `npm run check` or `just check`
 - Format with Biome: `npm run format` or `just format`
 - Typecheck all workspaces: `npm run typecheck`
-- Preview npm package contents: `just pack-caffeinate`, `just pack-chrome-devtools`, `just pack-firecrawl`, `just pack-goal`, `just pack-python-lsp`, `just pack-retry`, or `just pack-statusline`
-- Try a local extension without installing: `just try-caffeinate`, `just try-chrome-devtools`, `just try-firecrawl`, `just try-goal`, `just try-python-lsp`, `just try-retry`, or `just try-statusline`
+- Preview npm package contents: `just pack-caffeinate`, `just pack-chrome-devtools`, `just pack-firecrawl`, `just pack-goal`, `just pack-lsp`, `just pack-retry`, or `just pack-statusline`
+- Try a local extension without installing: `just try-caffeinate`, `just try-chrome-devtools`, `just try-firecrawl`, `just try-goal`, `just try-lsp`, `just try-retry`, or `just try-statusline`
 - Inspect available recipes before adding new workflow commands: `just --list`
 
 ## Code style

README.md

@@ -2,23 +2,21 @@
 
 [![npm scope](https://img.shields.io/badge/npm-@narumitw-blue)](https://www.npmjs.com/org/narumitw) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 
-Production-ready, independently installable [Pi](https://pi.dev) extension packages for the Pi coding agent. This monorepo provides native Pi tools and commands for shared LSP diagnostics and edits, Biome LSP diagnostics, Chrome DevTools automation, Codex usage status, Firecrawl web scraping, Python LSP diagnostics with ty and Ruff, goal-driven task completion, retry handling, terminal statuslines, and keep-awake automation.
+Production-ready, independently installable [Pi](https://pi.dev) extension packages for the Pi coding agent. This monorepo provides native Pi tools and commands for shared LSP diagnostics and edits, Chrome DevTools automation, Codex usage status, Firecrawl web scraping, goal-driven task completion, retry handling, terminal statuslines, and keep-awake automation.
 
 ## 📦 Pi extension packages
 
 Install only the Pi extensions you need. Each package is published under the `@narumitw` npm scope and can be installed directly with `pi install npm:<package>`.
 
 | Pi extension | What it adds | Install |
 | --- | --- | --- |
-| [`@narumitw/pi-biome-lsp`](./extensions/pi-biome-lsp) | 🧬 Biome language-server tools for diagnostics, formatting, import organization, and source fixes. | `pi install npm:@narumitw/pi-biome-lsp` |
 | [`@narumitw/pi-btw`](./extensions/pi-btw) | 💬 `/btw` side-question command for asking quick questions without polluting the main conversation. | `pi install npm:@narumitw/pi-btw` |
 | [`@narumitw/pi-caffeinate`](./extensions/pi-caffeinate) | ☕ Cross-platform sleep prevention while the Pi agent is processing long-running prompts. | `pi install npm:@narumitw/pi-caffeinate` |
 | [`@narumitw/pi-chrome-devtools`](./extensions/pi-chrome-devtools) | 🌐 Native Chrome DevTools Protocol tools for listing tabs, navigating pages, evaluating JavaScript, and taking screenshots. | `pi install npm:@narumitw/pi-chrome-devtools` |
 | [`@narumitw/pi-codex-usage`](./extensions/pi-codex-usage) | 📊 `/codex-status` command and automatic statusline item for ChatGPT Codex subscription usage, using Pi auth first and Codex CLI only as fallback. | `pi install npm:@narumitw/pi-codex-usage` |
 | [`@narumitw/pi-firecrawl`](./extensions/pi-firecrawl) | 🔥 Firecrawl-powered web scraping, crawling, URL discovery, and web search tools for research workflows. | `pi install npm:@narumitw/pi-firecrawl` |
 | [`@narumitw/pi-goal`](./extensions/pi-goal) | 🎯 `/goal` mode that keeps the agent working until a verifiable task is complete. | `pi install npm:@narumitw/pi-goal` |
 | [`@narumitw/pi-lsp`](./extensions/pi-lsp) | 🧠 Shared language-server tools for Biome diagnostics/edits, ty diagnostics, and Ruff diagnostics/edits. | `pi install npm:@narumitw/pi-lsp` |
-| [`@narumitw/pi-python-lsp`](./extensions/pi-python-lsp) | 🐍 Python language-server tools for ty type diagnostics and Ruff linting, formatting, and fixes. | `pi install npm:@narumitw/pi-python-lsp` |
 | [`@narumitw/pi-retry`](./extensions/pi-retry) | 🔁 Retry support for provider responses that fail with `Unknown error (no error details in response)`. | `pi install npm:@narumitw/pi-retry` |
 | [`@narumitw/pi-statusline`](./extensions/pi-statusline) | ✨ A rich Pi terminal statusline with model, tools, git branch, context usage, token totals, cost, and time. | `pi install npm:@narumitw/pi-statusline` |
 | [`@narumitw/pi-subagents`](./extensions/pi-subagents) | 🤖 Delegate work to specialized isolated subagents with single, parallel, and chained execution modes. | `pi install npm:@narumitw/pi-subagents` |
@@ -47,11 +45,11 @@ pi -e npm:@narumitw/pi-goal -e npm:@narumitw/pi-statusline -e npm:@narumitw/pi-l
 
 ### 🧠 Shared language-server workflows
 
-Use [`@narumitw/pi-lsp`](./extensions/pi-lsp) to let Pi run Biome, ty, and Ruff language-server tools through one shared LSP runner. It covers Biome diagnostics and edits, ty type diagnostics, and Ruff lint diagnostics, formatting, import organization, and source fixes. The older [`@narumitw/pi-biome-lsp`](./extensions/pi-biome-lsp) and [`@narumitw/pi-python-lsp`](./extensions/pi-python-lsp) packages remain available and are not deprecated yet.
+Use [`@narumitw/pi-lsp`](./extensions/pi-lsp) to let Pi run Biome, ty, and Ruff language-server tools through one shared LSP runner. It covers Biome diagnostics and edits, ty type diagnostics, and Ruff lint diagnostics, formatting, import organization, and source fixes. The older split packages [`@narumitw/pi-biome-lsp`](./extensions/deprecated/pi-biome-lsp) and [`@narumitw/pi-python-lsp`](./extensions/deprecated/pi-python-lsp) are deprecated, kept for reference, and excluded from active workspace scripts.
 
 ### 🧬 JavaScript and TypeScript coding with Biome
 
-Use [`@narumitw/pi-biome-lsp`](./extensions/pi-biome-lsp) to let Pi run Biome diagnostics through `biome lsp-proxy`, format supported files, organize imports, and apply safe Biome source fixes.
+Use [`@narumitw/pi-lsp`](./extensions/pi-lsp) to let Pi run Biome diagnostics through `biome lsp-proxy`, format supported files, organize imports, and apply safe Biome source fixes.
 
 ### 🌐 Browser automation and debugging
 
@@ -67,7 +65,7 @@ Use [`@narumitw/pi-codex-usage`](./extensions/pi-codex-usage) to show ChatGPT Co
 
 ### 🐍 Python coding with ty and Ruff
 
-Use [`@narumitw/pi-python-lsp`](./extensions/pi-python-lsp) to let Pi run Python type checks through `ty server`, lint diagnostics through `ruff server`, Ruff formatting, and Ruff source fixes such as import organization.
+Use [`@narumitw/pi-lsp`](./extensions/pi-lsp) to let Pi run Python type checks through `ty server`, lint diagnostics through `ruff server`, Ruff formatting, and Ruff source fixes such as import organization.
 
 ### 🎯 Autonomous task completion
 
@@ -98,15 +96,13 @@ npm run check
 Try a package locally:
 
 ```bash
-pi -e ./extensions/pi-biome-lsp
 pi -e ./extensions/pi-btw
 pi -e ./extensions/pi-caffeinate
 pi -e ./extensions/pi-chrome-devtools
 pi -e ./extensions/pi-codex-usage
 pi -e ./extensions/pi-firecrawl
 pi -e ./extensions/pi-goal
 pi -e ./extensions/pi-lsp
-pi -e ./extensions/pi-python-lsp
 pi -e ./extensions/pi-retry
 pi -e ./extensions/pi-statusline
 pi -e ./extensions/pi-subagents
@@ -115,15 +111,13 @@ pi -e ./extensions/pi-subagents
 Preview npm package contents before publishing:
 
 ```bash
-npm run pack:biome-lsp
 npm run pack:btw
 npm run pack:caffeinate
 npm run pack:chrome-devtools
 npm run pack:codex-usage
 npm run pack:firecrawl
 npm run pack:goal
 npm run pack:lsp
-npm run pack:python-lsp
 npm run pack:retry
 npm run pack:statusline
 npm run pack:subagents
@@ -141,16 +135,16 @@ npm publish --workspace @narumitw/pi-subagents --access public
 extensions/
 ├── deprecated/
 │   ├── pi-auto-thinking/
+│   ├── pi-biome-lsp/
+│   ├── pi-python-lsp/
 │   └── pi-sidebar/
-├── pi-biome-lsp/
 ├── pi-btw/
 ├── pi-caffeinate/
 ├── pi-chrome-devtools/
 ├── pi-codex-usage/
 ├── pi-firecrawl/
 ├── pi-goal/
 ├── pi-lsp/
-├── pi-python-lsp/
 ├── pi-retry/
 ├── pi-statusline/
 └── pi-subagents/

docs/implementation-notes/pi-lsp-parity-checklist.md

@@ -1,6 +1,6 @@
 # pi-lsp parity checklist
 
-`@narumitw/pi-lsp` keeps the existing public tool Interface from `@narumitw/pi-biome-lsp` and `@narumitw/pi-python-lsp` while moving common LSP behavior into a shared runner Module.
+`@narumitw/pi-lsp` keeps the public tool Interface from the now-deprecated `@narumitw/pi-biome-lsp` and `@narumitw/pi-python-lsp` packages while moving common LSP behavior into a shared runner Module.
 
 ## Tool names and parameters
 
@@ -44,6 +44,6 @@
 
 ## Documentation and compatibility
 
-- [x] `extensions/pi-lsp/README.md` documents tool-name compatibility, environment variables, and no-deprecation status for the old packages.
+- [x] `extensions/pi-lsp/README.md` documents tool-name compatibility, environment variables, and the deprecated status for the old packages.
 - [x] Root `README.md`, `package.json`, and `justfile` include `pi-lsp` integration.
-- [x] `pi-biome-lsp` and `pi-python-lsp` package metadata and READMEs are unchanged in this phase.
+- [x] `pi-biome-lsp` and `pi-python-lsp` now live under `extensions/deprecated/` and are excluded from active workspace scripts.

extensions/pi-biome-lsp/LICENSE …tensions/deprecated/pi-biome-lsp/LICENSEextensions/pi-biome-lsp/LICENSE renamed to extensions/deprecated/pi-biome-lsp/LICENSE extensions/pi-biome-lsp/LICENSE renamed to extensions/deprecated/pi-biome-lsp/LICENSE

@@ -2,6 +2,8 @@
 
 [![npm](https://img.shields.io/npm/v/@narumitw/pi-biome-lsp)](https://www.npmjs.com/package/@narumitw/pi-biome-lsp) [![Pi extension](https://img.shields.io/badge/Pi-extension-blue)](https://pi.dev) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 
+> Deprecated: use [`@narumitw/pi-lsp`](../../pi-lsp) instead. This package is kept for reference under `extensions/deprecated/` and is no longer part of the active workspace package set.
+
 `@narumitw/pi-biome-lsp` is a native [Pi coding agent](https://pi.dev) extension that exposes [Biome](https://biomejs.dev/) language-server tools.
 
 Use it to give Pi Biome diagnostics, formatting, import organization, and safe source fixes through Language Server Protocol (LSP) workflows.
@@ -31,7 +33,7 @@ pi -e npm:@narumitw/pi-biome-lsp
 Try this package locally from the repository root:
 
 ```bash
-pi -e ./extensions/pi-biome-lsp
+pi -e ./extensions/deprecated/pi-biome-lsp
 ```
 
 ## ✅ Requirements
@@ -45,13 +47,13 @@ npm install -D @biomejs/biome
 Or provide a custom server command:
 
 ```bash
-PI_BIOME_LSP_COMMAND="npx biome lsp-proxy" pi -e ./extensions/pi-biome-lsp
+PI_BIOME_LSP_COMMAND="npx biome lsp-proxy" pi -e ./extensions/deprecated/pi-biome-lsp
 ```
 
 Optional timeout override:
 
 ```bash
-PI_BIOME_LSP_TIMEOUT_MS=30000 pi -e ./extensions/pi-biome-lsp
+PI_BIOME_LSP_TIMEOUT_MS=30000 pi -e ./extensions/deprecated/pi-biome-lsp
 ```
 
 ## 🛠️ Pi tools
@@ -66,7 +68,7 @@ Check a project subset with Biome diagnostics:
 
 ```json
 {
-  "paths": ["src", "extensions/pi-biome-lsp/src"],
+  "paths": ["src", "extensions/deprecated/pi-biome-lsp/src"],
   "limit": 100
 }
 ```
@@ -103,7 +105,7 @@ Shows the configured Biome LSP command and whether it is available on `PATH`.
 ## 🗂️ Package layout
 
 ```txt
-extensions/pi-biome-lsp/
+extensions/deprecated/pi-biome-lsp/
 ├── src/
 │   └── biome-lsp.ts
 ├── README.md

extensions/pi-biome-lsp/README.md …nsions/deprecated/pi-biome-lsp/README.mdextensions/pi-biome-lsp/README.md renamed to extensions/deprecated/pi-biome-lsp/README.md extensions/pi-biome-lsp/README.md renamed to extensions/deprecated/pi-biome-lsp/README.md

@@ -1,7 +1,7 @@
 {
 	"name": "@narumitw/pi-biome-lsp",
 	"version": "0.1.20",
-	"description": "Pi extension that exposes Biome language-server tools for diagnostics, formatting, and fixes.",
+	"description": "Deprecated Pi extension that exposes Biome language-server tools for diagnostics, formatting, and fixes.",
 	"type": "module",
 	"license": "MIT",
 	"private": false,
@@ -41,6 +41,6 @@
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/narumiruna/pi-extensions",
-		"directory": "extensions/pi-biome-lsp"
+		"directory": "extensions/deprecated/pi-biome-lsp"
 	}
 }

extensions/pi-biome-lsp/package.json …ons/deprecated/pi-biome-lsp/package.jsonextensions/pi-biome-lsp/package.json renamed to extensions/deprecated/pi-biome-lsp/package.json extensions/pi-biome-lsp/package.json renamed to extensions/deprecated/pi-biome-lsp/package.json

@@ -2,6 +2,8 @@
 
 [![npm](https://img.shields.io/npm/v/@narumitw/pi-python-lsp)](https://www.npmjs.com/package/@narumitw/pi-python-lsp) [![Pi extension](https://img.shields.io/badge/Pi-extension-blue)](https://pi.dev) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 
+> Deprecated: use [`@narumitw/pi-lsp`](../../pi-lsp) instead. This package is kept for reference under `extensions/deprecated/` and is no longer part of the active workspace package set.
+
 `@narumitw/pi-python-lsp` is a native [Pi coding agent](https://pi.dev) extension that exposes Python language-server tools from [ty](https://github.com/astral-sh/ty) and [Ruff](https://docs.astral.sh/ruff/).
 
 Use it to give Pi reliable Python type diagnostics, Ruff lint diagnostics, formatting, import organization, and source fixes through Language Server Protocol (LSP) workflows.
@@ -32,7 +34,7 @@ pi -e npm:@narumitw/pi-python-lsp
 Try this package locally from the repository root:
 
 ```bash
-pi -e ./extensions/pi-python-lsp
+pi -e ./extensions/deprecated/pi-python-lsp
 ```
 
 ## ✅ Requirements
@@ -47,13 +49,13 @@ uv tool install ruff
 Or provide custom server commands:
 
 ```bash
-PI_TY_LSP_COMMAND="uvx ty server" PI_RUFF_LSP_COMMAND="uvx ruff server" pi -e ./extensions/pi-python-lsp
+PI_TY_LSP_COMMAND="uvx ty server" PI_RUFF_LSP_COMMAND="uvx ruff server" pi -e ./extensions/deprecated/pi-python-lsp
 ```
 
 Optional timeout overrides:
 
 ```bash
-PI_TY_LSP_TIMEOUT_MS=30000 PI_RUFF_LSP_TIMEOUT_MS=30000 pi -e ./extensions/pi-python-lsp
+PI_TY_LSP_TIMEOUT_MS=30000 PI_RUFF_LSP_TIMEOUT_MS=30000 pi -e ./extensions/deprecated/pi-python-lsp
 ```
 
 ## 🛠️ Pi tools
@@ -114,7 +116,7 @@ Shows the configured ty and Ruff LSP commands and whether each command is availa
 ## 🗂️ Package layout
 
 ```txt
-extensions/pi-python-lsp/
+extensions/deprecated/pi-python-lsp/
 ├── src/
 │   └── python-lsp.ts
 ├── README.md