@modootoday/pmcp 0.14.1 → 0.16.0

package/.agents/plugins/marketplace.json

@@ -612,7 +612,7 @@
     },
     {
       "name": "pmcp",
-      "version": "0.14.1",
+      "version": "0.16.0",
       "description": "Find package skills and use native runtime project configuration.",
       "source": { "source": "local", "path": "./plugins/pmcp" },
       "policy": { "installation": "AVAILABLE", "authentication": "ON_USE" },

package/.claude-plugin/marketplace.json

@@ -445,7 +445,7 @@
     },
     {
       "name": "pmcp",
-      "version": "0.14.1",
+      "version": "0.16.0",
       "description": "Find package skills and use native runtime project configuration.",
       "source": "./plugins/pmcp"
     },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pmcp",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "Find package skills and use native runtime project configuration.",
   "author": { "name": "modootoday" },
   "license": "Elastic-2.0",

package/README.md

@@ -37,7 +37,7 @@ npm install --save-dev @modootoday/pmcp
 For Claude Code, register the MCP server from the project directory:
 
 ```sh
-claude mcp add pmcp -- npx @modootoday/pmcp
+claude mcp add pmcp -- npx @modootoday/pmcp serve
 ```
 
 Other MCP hosts can use a stdio entry:
@@ -47,7 +47,7 @@ Other MCP hosts can use a stdio entry:
   "mcpServers": {
     "pmcp": {
       "command": "npx",
-      "args": ["@modootoday/pmcp"]
+      "args": ["@modootoday/pmcp", "serve"]
     }
   }
 }
@@ -141,14 +141,43 @@ coordination panel in one terminal workspace. The optional harness and TUI need
 Linux, tmux, util-linux flock, Node.js 22 or later and a working user systemd
 manager. Provider login, folder trust and tool approvals remain native.
 
+PMCP 0.16.0 adds the numbered runtime picker, worker menu, worker-start and
+read-only recovery flows below.
+
 ```sh
 npx @modootoday/pmcp --version
-npx @modootoday/pmcp harness doctor
+npx @modootoday/pmcp harness doctor inspect
 npx @modootoday/pmcp tui doctor
 ```
 
-Follow the [native terminal guide](docs/terminal-harness.md) to create an owned
-group and sessions, then [open a terminal workspace](docs/terminal-workspace.md).
+On a supported interactive host, open the workspace with:
+
+```sh
+pmcp
+```
+
+The first launch lists installed native runtimes. Choose a number or accept the
+default, then confirm the start; q cancels without creating a group. No group or
+view JSON is required. Later launches reconnect to the workspace
+created for this project. Native login and folder trust stay with the runtime.
+Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional default:
+
+```toml
+[tui]
+runtime = "codex-cli"
+```
+
+Once the workspace is open, press Ctrl-g then n to choose and confirm a worker.
+The menu releases input control and preserves the current draft. You can also use
+`pmcp tui start-worker --runtime gemini-cli`. The existing group keeps its
+runtime grants and resource bounds. Use `pmcp tui recovery` to inspect a saved
+workspace and obtain explicit next commands after an interrupted start. Inspection
+does not restart a runtime or replay input.
+
+`pmcp tui plan` previews the settings without starting anything. The
+[terminal workspace guide](docs/terminal-workspace.md) covers defaults, custom
+configuration and advanced controls. The [native terminal guide](docs/terminal-harness.md)
+explains explicit group and session operations.
 Views start read only; acquiring control and stopping a runtime are explicit
 actions. This optional CLI feature does not add execution tools to the MCP server.
 
@@ -166,11 +195,11 @@ pmcp validate
 ```
 
 `available` checks catalog packages against your installed dependencies.
-`install` and `sync` pin exact versions with npm or Bun and require confirmation
+`install` and `sync` use npm, Bun or pnpm and require confirmation
 before changing your manifest and lockfile. `--dry-run` previews the work.
 Use `--catalog <file>` to read a saved catalog response.
 
-On repository main, these commands use the bundled public catalog by default.
+These commands use the bundled public catalog by default.
 Public installation downloads verified content-only archives without PMCP login.
 Use `--provider hosted` or an explicit `--api` for a separately hosted service.
 CLI discovery includes the free marketplace unless `--no-builtin` is passed or
@@ -181,7 +210,27 @@ skills.modoo.today is a separate service built on PMCP. Your runtime's provider
 login remains with that runtime.
 
 Run `pmcp --help` or `pmcp <command> --help` for options.
-With no command, pmcp serves MCP on stdio.
+With no command, a supported interactive terminal opens the workspace. Piped
+launches retain MCP stdio; `pmcp serve` selects MCP explicitly. Unsupported
+interactive hosts show help and prerequisite guidance.
+
+## Compatibility
+
+| Surface                                | Current qualification                                                                                                                     |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| CLI and MCP on Linux amd64             | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
+| Optional terminal workspace            | Linux PTY/tmux checks and bounded native Codex, Gemini, Grok and agy main/worker acceptance; Claude remains deferred                      |
+| Public skill installation              | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled                                                                        |
+| Native plugin export                   | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin                                          |
+| pnpm workspace installation            | Selects the member, preserves root dependencies and updates the shared lockfile                                                           |
+| Yarn skill installation                | Refused without changing project files; Yarn PnP is not supported                                                                         |
+| macOS, Windows and other architectures | Not qualified by the Linux Docker tests                                                                                                   |
+
+Provider authentication, native children and vendor behavior have separate
+qualification scopes. An installed executable or exported manifest is not proof
+that every native feature works. Public package CI checks actual packed-archive
+installation, CLI startup, MCP and SQLite before publication; isolated projects
+on a host are distinct from Docker and OS qualification.
 
 ## Guides