overlord-cli 0.2607141312.0 → 0.2607151113.0

package/README.md

@@ -182,7 +182,7 @@ export OVERLORD_BACKEND_URL="https://overlord.example.com"
 export OVERLORD_USER_TOKEN="out_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 
 # 4. Agent connector — write the local agent connector config (non-interactive).
-ovld agent-setup claude            # one of: claude | codex | cursor | all
+ovld agent-setup claude            # one of: claude | codex | cursor | pi | all
 ```
 
 Then verify the backend is reachable and authenticated:

package/dist/connectors/README.md

@@ -22,7 +22,7 @@ OpenCode, Antigravity, and others). A connector is what lets an agent speak the
 Install or refresh a connector with:
 
 ```bash
-ovld agent-setup <agent>    # claude | codex | cursor | all
+ovld agent-setup <agent>    # claude | codex | cursor | pi | all
 ovld doctor                 # verify managed files and permissions
 ```
 
@@ -35,6 +35,7 @@ connector contract version changes.
 - [Claude Code](adapters/claude/README.md): installable Claude plugin bundle with a Claude overlay for the shared core, slash commands, hooks, adapter manifest, prompt wrapper notes, and connector conformance manifest.
 - [Codex](adapters/codex/README.md): Codex plugin with hooks, MCP bridge, and permission warmup.
 - [Cursor](adapters/cursor/README.md): Cursor plugin with slash commands, hooks, rules, and MCP bridge.
+- [PI](adapters/pi/README.md): PI Agent skill and extension with follow-up capture and native-session resume.
 
 ### Extension point
 

package/dist/connectors/VERSION

@@ -1 +1 @@
-0.3.0
+0.3.1

package/dist/connectors/adapters/antigravity/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "overlord",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Chat-driven access to Overlord mission protocol workflows with hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/adapters/antigravity/scripts/overlord-mcp.mjs

@@ -328,7 +328,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-antigravity', version: '0.2.9' }
+          serverInfo: { name: 'overlord-antigravity', version: '0.3.1' }
         }
       });
       continue;

package/dist/connectors/adapters/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Overlord mission protocol workflow for Claude Code — attach/update/ask/deliver, slash commands, and hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",
@@ -9,7 +9,15 @@
   "homepage": "https://www.ovld.ai",
   "repository": "https://github.com/cooperativ-labs/overlord",
   "license": "UNLICENSED",
-  "keywords": ["overlord", "ticket", "agents", "mission", "workflow", "protocol", "claude-code"],
+  "keywords": [
+    "overlord",
+    "ticket",
+    "agents",
+    "mission",
+    "workflow",
+    "protocol",
+    "claude-code"
+  ],
   "userConfig": {
     "overlord_url": {
       "type": "string",

package/dist/connectors/adapters/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Chat-driven access to Overlord mission protocol workflows with hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",
@@ -28,7 +28,10 @@
     "longDescription": "Connect Codex to Overlord's local mission workflow through the existing `ovld protocol` CLI. The plugin bundles workflow skills plus MCP tools for mission attachment, progress updates, shared context, artifacts, delivery, and follow-up mission creation.",
     "developerName": "Cooperativ",
     "category": "Productivity",
-    "capabilities": ["Interactive", "Write"],
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
     "websiteURL": "https://www.ovld.ai/docs",
     "privacyPolicyURL": "https://www.ovld.ai/privacy",
     "termsOfServiceURL": "https://www.ovld.ai/terms",
@@ -40,6 +43,8 @@
     "brandColor": "#1E6B5C",
     "composerIcon": "./assets/icon.png",
     "logo": "./assets/logo.png",
-    "screenshots": ["./assets/screenshot.svg"]
+    "screenshots": [
+      "./assets/screenshot.svg"
+    ]
   }
 }

package/dist/connectors/adapters/codex/scripts/overlord-mcp.mjs

@@ -328,7 +328,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-codex', version: '0.2.9' }
+          serverInfo: { name: 'overlord-codex', version: '0.3.1' }
         }
       });
       continue;

package/dist/connectors/adapters/cursor/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Overlord mission protocol workflow for Cursor — attach/update/ask/deliver, slash commands, MCP bridge, and follow-up capture.",
   "author": {
     "name": "Cooperativ",
@@ -9,7 +9,16 @@
   "homepage": "https://www.ovld.ai",
   "repository": "https://github.com/cooperativ-labs/overlord",
   "license": "UNLICENSED",
-  "keywords": ["overlord", "cursor", "mcp", "ticket", "agents", "mission", "workflow", "protocol"],
+  "keywords": [
+    "overlord",
+    "cursor",
+    "mcp",
+    "ticket",
+    "agents",
+    "mission",
+    "workflow",
+    "protocol"
+  ],
   "skills": "./skills/",
   "mcpServers": "./mcp.json",
   "interface": {
@@ -18,7 +27,10 @@
     "longDescription": "Connect Cursor to Overlord's local mission workflow through the ovld protocol CLI. Includes workflow rules, slash commands, MCP bridge tools, and follow-up capture.",
     "developerName": "Cooperativ",
     "category": "Productivity",
-    "capabilities": ["Interactive", "Write"],
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
     "websiteURL": "https://www.ovld.ai/docs",
     "privacyPolicyURL": "https://www.ovld.ai/privacy",
     "termsOfServiceURL": "https://www.ovld.ai/terms"

package/dist/connectors/adapters/cursor/scripts/overlord-mcp.mjs

@@ -328,7 +328,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-cursor', version: '0.2.9' }
+          serverInfo: { name: 'overlord-cursor', version: '0.3.1' }
         }
       });
       continue;

package/dist/connectors/adapters/pi/README.md

@@ -0,0 +1,42 @@
+# PI Connector
+
+The PI connector installs an Overlord Agent Skill and a small PI extension. It gives PI the shared mission lifecycle instructions, records ordinary follow-up prompts, and exposes PI's native session ID for review-session resume.
+
+## Setup
+
+Install PI separately, then install or refresh this adapter:
+
+```bash
+ovld agent-setup pi
+ovld doctor
+```
+
+The adapter writes only Overlord-managed files under `~/.pi/agent`:
+
+- `extensions/overlord.ts`
+- `skills/overlord-mission/`
+- `prompt-wrapper.md` and this README
+
+Re-running setup is idempotent. `ovld doctor` reports missing or modified managed files and whether the `pi` binary is on `PATH`.
+
+## Models and thinking
+
+PI accepts provider-qualified models with `--model` and an independent `--thinking` level. The built-in catalog includes:
+
+| Display name | PI model ID |
+| --- | --- |
+| GLM 5.2 | `zai/glm-5.2` |
+| Claude Opus 4.8 | `anthropic/claude-opus-4-8` |
+| GPT-5.6 Terra | `openai-codex/gpt-5.6-terra` |
+
+Authenticate the matching PI provider through PI's login/configuration flow or its supported environment variables. Use `pi --list-models` to inspect the models available to the current PI configuration.
+
+## Follow-ups and resume
+
+The extension records human input after the initial Overlord launch prompt through `ovld protocol hook-event`. It never blocks the PI input pipeline if that protocol call fails. PI has no native permission-request hook, so this connector does not report permission prompts.
+
+When PI supplies a native session ID, Overlord's review UI can reopen it with:
+
+```bash
+pi --session <session-id>
+```

package/dist/connectors/adapters/pi/conformance-manifest.yaml

@@ -0,0 +1,27 @@
+contractVersion: "0"
+componentType: connector
+componentKey: pi
+label: "PI Connector"
+description: "PI Agent skill and extension adapter for the Overlord mission protocol workflow."
+
+connector:
+  agentIdentifier: pi
+  capabilities:
+    - followUpHook
+    - nativeResume
+    - modelFlag
+    - effortFlag
+    - contextFilePrompt
+  hookTypes:
+    - UserPromptSubmit
+  installPath: "~/.pi/agent"
+  managedFiles:
+    - "README.md"
+    - "extensions/overlord.ts"
+    - "prompt-wrapper.md"
+    - "skills/overlord-mission/SKILL.md"
+    - "skills/overlord-mission/reference/cli.md"
+    - "skills/overlord-mission/reference/context.md"
+    - "skills/overlord-mission/reference/devices.md"
+    - "skills/overlord-mission/reference/mcp.md"
+    - "skills/overlord-mission/reference/shell-escaping.md"

package/dist/connectors/adapters/pi/extensions/overlord.ts

@@ -0,0 +1,70 @@
+import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+import { createHash } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+
+const missionId = process.env.MISSION_ID ?? process.env.OVERLORD_MISSION_ID ?? '';
+const executionRequestId = process.env.OVERLORD_EXECUTION_REQUEST_ID ?? '';
+const sessionKey = process.env.SESSION_KEY ?? '';
+
+function externalSessionId(ctx: ExtensionContext): string | null {
+  const id = ctx.sessionManager.getSessionId().trim();
+  return id || null;
+}
+
+async function cacheNativeSession(ctx: ExtensionContext): Promise<void> {
+  if (!missionId) return;
+  const sessionId = externalSessionId(ctx);
+  if (!sessionId) return;
+
+  const key = createHash('sha256').update(`${ctx.cwd}\0${missionId}\0pi`).digest('hex');
+  const directory = path.join(homedir(), '.ovld', 'native-sessions');
+
+  await mkdir(directory, { recursive: true });
+  await writeFile(
+    path.join(directory, key),
+    JSON.stringify({ agent: 'pi', missionId, externalSessionId: sessionId }),
+    'utf8'
+  );
+}
+
+export default function overlordPiExtension(pi: ExtensionAPI): void {
+  let skipFirstInput = Boolean(missionId && executionRequestId);
+  let turnIndex = 0;
+
+  pi.on('session_start', (_event, ctx) => {
+    void cacheNativeSession(ctx).catch(() => {});
+  });
+
+  pi.on('input', (event, ctx) => {
+    void cacheNativeSession(ctx).catch(() => {});
+
+    if (!missionId || event.source === 'extension' || event.text.trim().length === 0) {
+      return { action: 'continue' };
+    }
+    if (skipFirstInput) {
+      skipFirstInput = false;
+      return { action: 'continue' };
+    }
+
+    const args = [
+      'protocol',
+      'hook-event',
+      '--hook-type',
+      'UserPromptSubmit',
+      '--mission-id',
+      missionId,
+      '--prompt',
+      event.text,
+      '--turn-index',
+      String(++turnIndex)
+    ];
+    const sessionId = externalSessionId(ctx);
+    if (sessionId) args.push('--external-session-id', sessionId);
+    if (sessionKey) args.push('--session-key', sessionKey);
+
+    void pi.exec('ovld', args).catch(() => {});
+    return { action: 'continue' };
+  });
+}

package/dist/connectors/adapters/pi/prompt-wrapper.md

@@ -0,0 +1,14 @@
+# PI Prompt Wrapper
+
+PI receives Overlord's generated mission context as a native file input and a short visible launch message:
+
+```bash
+pi --model <provider/id> --thinking <level> @<context-file> "Start work on <mission>."
+```
+
+Rules:
+
+- Pass the selected provider-qualified model unchanged with `--model`; do not split it into `--provider` plus a bare model ID.
+- Pass thinking separately with `--thinking` only when the selected launch configuration specifies it.
+- Place user-configured launch flags before the `@<context-file>` and visible message arguments.
+- The context file contains the mission, objectives, history, artifacts, attachments, and lifecycle instructions. Do not put credentials in it.

package/dist/connectors/adapters/pi/skills/overlord-mission/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: overlord-mission
+description: PI adapter for the shared Overlord mission workflow.
+---
+
+<!-- @connector-core -->
+
+## PI Adapter Notes
+
+- Agent identifier: `pi` for `ovld protocol create` and `ovld protocol prompt`.
+- Model selection: pass PI provider-qualified model IDs with `--model <provider/id>` and thinking separately with `--thinking <off|minimal|low|medium|high|xhigh|max>`.
+- Follow-up capture: the installed PI extension records ordinary user input as `UserPromptSubmit` after the launch-injected turn. Do not manually publish `user_follow_up` unless the extension is unavailable.
+- Native resume: the PI extension reports its native session ID; Overlord review can reopen it with `pi --session <id>`.
+- PI does not expose a native permission-request event. Do not claim permission activity is captured automatically.
+- Authentication: use PI's provider login or API-key configuration for models, and shared `ovld auth` credentials, Overlord-launched environment variables, or `Overlord_USER_TOKEN` / `OVLD_USER_TOKEN` for protocol calls.
+
+## PI Command Mapping
+
+- Create draft mission: `ovld protocol create --agent pi --objectives-json '[{"objective":"..."}]'`
+- Create and execute immediately: `ovld protocol prompt --agent pi --objectives-json '[{"objective":"..."}]'`
+- Load context without a session: `ovld protocol load-context --mission-id <mission_id>`
+- Attach for execution: `ovld protocol attach --mission-id <mission_id>`
+- Resume delivered work for follow-up execution: `ovld protocol resume-follow-up --mission-id <mission_id>`

package/dist/connectors/core/README.md

@@ -26,7 +26,7 @@ follow:
 - repair local auth/setup before asking the user to intervene
 
 You do not install Connector Core directly. It is bundled into each agent adapter
-(Claude, Codex, Cursor) when you run `ovld agent-setup <agent>`. See the
+(Claude, Codex, Cursor, PI) when you run `ovld agent-setup <agent>`. See the
 [connectors module README](../README.md) for setup instructions.
 
 ## For Developers

package/dist/connectors/docs/05-connectors-and-agent-plugins.md

@@ -103,6 +103,16 @@ Requirements:
 - Launch with model flag where supported.
 - No thinking/effort flag required initially.
 
+## PI Connector
+
+Requirements:
+
+- Install the Overlord Agent Skill and extension beneath `~/.pi/agent`.
+- Use PI's `input` extension event only for `UserPromptSubmit` follow-up capture; PI has no native permission-request hook.
+- Record PI's native session ID through the existing `~/.ovld/native-sessions` cache so the review UI can offer `pi --session <id>`.
+- Launch with provider-qualified models via `--model <provider/id>` and independent thinking via `--thinking <level>`.
+- Pass the generated mission context as PI's native `@<context-file>` input and retain a short visible launch message.
+
 ## Antigravity Connector
 
 Can be implemented after local MVP.

package/dist/connectors/docs/agent-harness-configuration-architecture.md

@@ -204,7 +204,7 @@ The storage split should be:
 
 | Layer | Storage | Purpose |
 | --- | --- | --- |
-| Packaged harnesses | Code-level registry bundled with Overlord | Immutable definitions for built-in agents such as `codex` and `claude`. |
+| Packaged harnesses | Code-level registry bundled with Overlord | Immutable definitions for built-in agents such as `codex`, `claude`, and `pi`. |
 | Personal extension definitions | `user_harness_extensions` plus local bundle files or hosted blobs | User-authored draft/private custom connectors. |
 | Workspace extension catalog | `workspace_harness_extensions` | Workspace-approved installed extensions available to members. |
 | Local connector installation state | `connector_installations` | Doctor/setup state for files installed into a specific local agent runtime. |