@modootoday/pmcp 0.15.0 → 0.16.1

package/docs/terminal-workspace.md

@@ -13,11 +13,15 @@ retain their existing group budgets and execution profile.
 
 ## Open a workspace
 
+The numbered runtime picker, worker menu and worker-start/recovery commands in
+this guide require PMCP 0.16.0 or later.
+
 From a supported interactive terminal, run `pmcp` or `pmcp tui`. The first
-launch chooses an installed main in this order: Codex, Gemini, agy, Grok,
-Claude. It displays the selection and asks before starting. Press Enter to
-start or enter q to cancel. No provider request or group creation occurs before
-this confirmation. Use `--runtime` to choose a supported runtime ID explicitly.
+launch lists installed runtimes, with a default in this order: Codex, Gemini,
+agy, Grok, Claude. Enter accepts that default; a number selects another runtime.
+Confirm with Enter at the start prompt, or enter q to cancel. No provider request
+or group creation occurs before this confirmation. Use `--runtime` to skip the
+picker and choose a supported runtime ID explicitly.
 Provider login and folder trust still use the native screen.
 
 ```sh
@@ -34,6 +38,35 @@ This launches a native process; the defaults are cooperative host supervision,
 not a Docker isolation policy. Use an explicitly configured Docker group when
 you require that execution profile.
 
+After opening a workspace, start a worker without preparing a session JSON file:
+
+```sh
+pmcp tui start-worker --runtime gemini-cli
+```
+
+This explicitly starts a worker in the saved project workspace. It uses the
+configured session memory by default; `--memory-mb` overrides that reservation.
+The existing group retains its allowed runtimes, execution profile and budgets.
+An unavailable main, paused group or stale generation blocks the start. Native
+login, folder trust and tool approvals remain in the worker's own screen.
+
+In the view, Ctrl-g then n opens a worker picker. It releases input control
+without submitting the main draft. Select a granted installed runtime and
+confirm its start; q cancels without creating a worker. The new worker reserves
+the same memory as the live main, within the existing group limits. Selection
+does not switch the input target or acquire control. To use a different
+reservation or an advanced view, run:
+
+```sh
+pmcp tui start-worker --view "$VIEW_FILE" --runtime gemini-cli --memory-mb 512
+```
+
+Use either --view or --config. A view start uses its owned group and generation;
+it does not discover another project workspace. Docker runtime availability
+follows that group's command policy rather than host native executables.
+This worker menu is qualified on native groups; Docker execution remains subject
+to its separately tested CLI and profile grants.
+
 The nearest `pmcp.toml` within the Git repository determines the project root,
 including from nested cwd. A submodule does not inherit its parent's config;
 use `--config` when you explicitly want a different configuration scope.
@@ -99,6 +132,45 @@ right, and coordination occupies four bottom rows. Smaller terminals keep a
 full-width main and a separate management window. The minimum is 40 by 12.
 Views refer to an existing owned group and do not start a provider.
 
+Doctor checks host prerequisites, including access to the systemd user manager,
+and lists native executables found on PATH. An installed executable is not proof
+of authentication or successful native behavior. The report leaves native
+acceptance unassessed and does not read authentication profiles.
+
+| Finding                   | Next step                                                                                                                       |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| Missing tmux or flock     | Install tmux or util-linux for your Linux distribution and check PATH in this terminal.                                         |
+| Unsupported Node          | Select Node.js 22 or later through your existing version manager, then check node --version.                                    |
+| Unreachable user manager  | Run systemctl --user status in the same login session; restore manager access before launching. Doctor does not start services. |
+| Missing native runtime    | Install the vendor's CLI and select its runtime ID explicitly. Installation alone does not establish login or folder trust.     |
+| Unsupported terminal host | Use a qualified Linux host for this workspace. Other PMCP features keep their own prerequisites.                                |
+
+Doctor does not invoke a native runtime, inspect private authentication files,
+test a model reply or prove cgroup delegation. Native acceptance and isolated
+execution require separate measurements against the exact installed version.
+
+### Measured terminal behavior
+
+Linux acceptance on 2026-10-10 covered the following native main/worker pairs.
+Each run checked read-only observation, explicit worker input with an actual
+reply, main draft preservation, resize and detach/reconnect. These bounded
+checks do not certify every vendor feature or another authentication profile.
+
+| Native runtime | Tested version            | Main and worker terminal checks |
+| -------------- | ------------------------- | ------------------------------- |
+| Codex          | 0.161.0                   | Passed                          |
+| Gemini CLI     | 0.63.0                    | Passed                          |
+| Grok CLI       | 1.0.50                    | Passed                          |
+| agy            | 1.3.3                     | Passed                          |
+| Claude Code    | Not measured in this wave | Deferred                        |
+
+Separate synthetic PTY checks cover multiline Korean paste, read-only mouse
+input, owned history and nested tmux. They do not establish each vendor's
+own editing or mouse behavior. Use Ctrl-g then h to read owned history without
+sending input. Claude acceptance, other operating systems and physical host
+loss remain outside these results. Docker installation and native credential
+isolation have separate qualification; this terminal run does not replace them.
+
 ## Observe and control
 
 Press Ctrl-g, release it, then press a key:
@@ -107,6 +179,7 @@ Press Ctrl-g, release it, then press a key:
 | -------- | -------------------------------------------- | ----------------------- |
 | m        | Return to main and release worker control    | main                    |
 | w or 1–4 | Observe a worker                             | observe --index 1       |
+| n        | Choose and confirm a new worker              | worker-menu             |
 | c        | Request control of the current native target | control                 |
 | r        | Release control                              | release                 |
 | h        | Read owned native history                    | history                 |
@@ -121,9 +194,11 @@ the dock; CLI observe supports all available indices. Press Ctrl-g twice to
 forward Ctrl-g to the native interface. Native Ctrl-b remains available when
 you hold control. A surrounding tmux may consume its own prefix first.
 
-The default is read only. Control progresses through REQUESTING CONTROL and
+The status line identifies MAIN or WORKER, its session and OBSERVE / INPUT OFF.
+Control progresses through REQUESTING CONTROL and
 CONNECTING WRITER to CONTROL READY. A lease alone does not enable typing: PMCP
 checks that the writable native client is attached to the selected pane's TTY.
+Only CONTROL READY shows INPUT ON.
 Input stays blocked during acquisition and release. A control lease identifies
 the writer, not which native prompt or approval menu is active.
 
@@ -164,6 +239,28 @@ pmcp harness recovery inspect --group-file "$GROUP_FILE"
 pmcp harness attach inspect --group-file "$GROUP_FILE" --session "$SESSION"
 ```
 
+For a workspace opened through bare pmcp, inspect the saved launcher without
+starting a runtime:
+
+```sh
+pmcp tui recovery
+```
+
+This reads the checkpoint and validates its saved group ownership and
+generation. It reports exact inspection commands and, where applicable,
+explicit resume, stop or fresh-launch commands. It does not execute them or
+certify that a process is still alive. An explicitly selected configuration
+is preserved in the proposed fresh-launch command:
+
+```sh
+pmcp tui recovery --config /path/to/pmcp.toml
+```
+
+If creation stopped before a group reference was saved, the result is
+manual-inspection. Preserve the reported checkpoint and examine owned launch
+evidence before changing it. Matching project paths alone cannot establish
+ownership. Paused work stays paused, and uncertain input is never replayed.
+
 Close ends the presentation and preserves all native runtimes:
 
 ```sh

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "pmcp",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "mcpServers": {
     "pmcp": {
       "type": "stdio",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modootoday/pmcp",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "license": "Elastic-2.0",
   "author": "modootoday",
   "description": "Use the skills your packages already ship, and keep your AI tools' project configuration in one place.",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pmcp",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "Find package skills and use native runtime project configuration.",
   "author": { "name": "modootoday" },
   "license": "Elastic-2.0",

package/plugins/pmcp/.claude-plugin/plugin.json

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

package/plugins/pmcp/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "pmcp",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "mcpServers": {
     "pmcp": {
       "type": "stdio",

package/plugins/pmcp/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pmcp",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "Find package skills and use native runtime project configuration.",
   "author": { "name": "modootoday" },
   "license": "Elastic-2.0",