npm - @ilya-lesikov/pi-pi - Versions diffs - 0.1.0 - Mend

@ilya-lesikov/pi-pi 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (271) hide show

package/3p/pi-ask-user/index.ts +1835 -0
package/3p/pi-ask-user/package.json +50 -0
package/3p/pi-ask-user/single-select-layout.ts +203 -0
package/3p/pi-lsp/extensions/lsp/client.ts +542 -0
package/3p/pi-lsp/extensions/lsp/config.ts +135 -0
package/3p/pi-lsp/extensions/lsp/effects/command.ts +42 -0
package/3p/pi-lsp/extensions/lsp/effects/filesystem.ts +50 -0
package/3p/pi-lsp/extensions/lsp/effects/runtime.ts +21 -0
package/3p/pi-lsp/extensions/lsp/errors.ts +113 -0
package/3p/pi-lsp/extensions/lsp/formatting.ts +315 -0
package/3p/pi-lsp/extensions/lsp/index.ts +231 -0
package/3p/pi-lsp/extensions/lsp/protocol.ts +209 -0
package/3p/pi-lsp/extensions/lsp/retry.ts +39 -0
package/3p/pi-lsp/extensions/lsp/tools/programs.ts +293 -0
package/3p/pi-lsp/extensions/lsp/tools.ts +89 -0
package/3p/pi-lsp/extensions/lsp/types.ts +243 -0
package/3p/pi-lsp/package.json +54 -0
package/3p/pi-plannotator/AGENTS.md +583 -0
package/3p/pi-plannotator/apps/pi-extension/README.md +228 -0
package/3p/pi-plannotator/apps/pi-extension/assistant-message.ts +128 -0
package/3p/pi-plannotator/apps/pi-extension/config.test.ts +166 -0
package/3p/pi-plannotator/apps/pi-extension/config.ts +318 -0
package/3p/pi-plannotator/apps/pi-extension/current-pi-session.ts +147 -0
package/3p/pi-plannotator/apps/pi-extension/index.ts +1279 -0
package/3p/pi-plannotator/apps/pi-extension/package.json +56 -0
package/3p/pi-plannotator/apps/pi-extension/plannotator-browser.test.ts +13 -0
package/3p/pi-plannotator/apps/pi-extension/plannotator-browser.ts +616 -0
package/3p/pi-plannotator/apps/pi-extension/plannotator-events.ts +342 -0
package/3p/pi-plannotator/apps/pi-extension/plannotator.json +12 -0
package/3p/pi-plannotator/apps/pi-extension/server/agent-jobs.ts +515 -0
package/3p/pi-plannotator/apps/pi-extension/server/ai-runtime.ts +169 -0
package/3p/pi-plannotator/apps/pi-extension/server/annotations.ts +85 -0
package/3p/pi-plannotator/apps/pi-extension/server/external-annotations.ts +189 -0
package/3p/pi-plannotator/apps/pi-extension/server/handlers.ts +210 -0
package/3p/pi-plannotator/apps/pi-extension/server/helpers.ts +78 -0
package/3p/pi-plannotator/apps/pi-extension/server/ide.ts +46 -0
package/3p/pi-plannotator/apps/pi-extension/server/integrations.ts +195 -0
package/3p/pi-plannotator/apps/pi-extension/server/network.test.ts +158 -0
package/3p/pi-plannotator/apps/pi-extension/server/network.ts +268 -0
package/3p/pi-plannotator/apps/pi-extension/server/pr.ts +126 -0
package/3p/pi-plannotator/apps/pi-extension/server/project.ts +64 -0
package/3p/pi-plannotator/apps/pi-extension/server/reference.ts +362 -0
package/3p/pi-plannotator/apps/pi-extension/server/serverAnnotate.ts +199 -0
package/3p/pi-plannotator/apps/pi-extension/server/serverPlan.ts +505 -0
package/3p/pi-plannotator/apps/pi-extension/server/serverReview.ts +1229 -0
package/3p/pi-plannotator/apps/pi-extension/server/vcs.ts +121 -0
package/3p/pi-plannotator/apps/pi-extension/server.test.ts +966 -0
package/3p/pi-plannotator/apps/pi-extension/server.ts +44 -0
package/3p/pi-plannotator/apps/pi-extension/tool-scope.test.ts +88 -0
package/3p/pi-plannotator/apps/pi-extension/tool-scope.ts +39 -0
package/3p/pi-plannotator/apps/pi-extension/tsconfig.json +16 -0
package/3p/pi-plannotator/apps/pi-extension/vendor.sh +48 -0
package/3p/pi-plannotator/package.json +53 -0
package/3p/pi-plannotator/packages/ai/ai.test.ts +1407 -0
package/3p/pi-plannotator/packages/ai/base-session.ts +94 -0
package/3p/pi-plannotator/packages/ai/context.ts +250 -0
package/3p/pi-plannotator/packages/ai/endpoints.ts +326 -0
package/3p/pi-plannotator/packages/ai/index.ts +105 -0
package/3p/pi-plannotator/packages/ai/package.json +21 -0
package/3p/pi-plannotator/packages/ai/provider.ts +103 -0
package/3p/pi-plannotator/packages/ai/providers/claude-agent-sdk.ts +447 -0
package/3p/pi-plannotator/packages/ai/providers/codex-sdk.ts +430 -0
package/3p/pi-plannotator/packages/ai/providers/command-path.ts +115 -0
package/3p/pi-plannotator/packages/ai/providers/opencode-sdk.ts +546 -0
package/3p/pi-plannotator/packages/ai/providers/pi-events.ts +110 -0
package/3p/pi-plannotator/packages/ai/providers/pi-sdk-node.ts +425 -0
package/3p/pi-plannotator/packages/ai/providers/pi-sdk.ts +469 -0
package/3p/pi-plannotator/packages/ai/session-manager.ts +195 -0
package/3p/pi-plannotator/packages/ai/tsconfig.json +15 -0
package/3p/pi-plannotator/packages/ai/types.ts +379 -0
package/3p/pi-plannotator/packages/server/agent-jobs.ts +538 -0
package/3p/pi-plannotator/packages/server/agent-review-message.test.ts +135 -0
package/3p/pi-plannotator/packages/server/agent-review-message.ts +243 -0
package/3p/pi-plannotator/packages/server/ai-runtime.ts +108 -0
package/3p/pi-plannotator/packages/server/annotate.ts +401 -0
package/3p/pi-plannotator/packages/server/browser.test.ts +87 -0
package/3p/pi-plannotator/packages/server/browser.ts +245 -0
package/3p/pi-plannotator/packages/server/claude-review.ts +352 -0
package/3p/pi-plannotator/packages/server/code-nav.ts +73 -0
package/3p/pi-plannotator/packages/server/codex-review-schema.json +41 -0
package/3p/pi-plannotator/packages/server/codex-review.ts +330 -0
package/3p/pi-plannotator/packages/server/config.ts +8 -0
package/3p/pi-plannotator/packages/server/draft.ts +1 -0
package/3p/pi-plannotator/packages/server/editor-annotations.ts +76 -0
package/3p/pi-plannotator/packages/server/external-annotations.test.ts +18 -0
package/3p/pi-plannotator/packages/server/external-annotations.ts +207 -0
package/3p/pi-plannotator/packages/server/git.ts +141 -0
package/3p/pi-plannotator/packages/server/goal-setup.test.ts +55 -0
package/3p/pi-plannotator/packages/server/goal-setup.ts +248 -0
package/3p/pi-plannotator/packages/server/ide.ts +43 -0
package/3p/pi-plannotator/packages/server/image.test.ts +63 -0
package/3p/pi-plannotator/packages/server/image.ts +66 -0
package/3p/pi-plannotator/packages/server/index.ts +648 -0
package/3p/pi-plannotator/packages/server/integrations.test.ts +172 -0
package/3p/pi-plannotator/packages/server/integrations.ts +214 -0
package/3p/pi-plannotator/packages/server/jj.test.ts +69 -0
package/3p/pi-plannotator/packages/server/jj.ts +86 -0
package/3p/pi-plannotator/packages/server/p4.ts +417 -0
package/3p/pi-plannotator/packages/server/package.json +40 -0
package/3p/pi-plannotator/packages/server/path-utils.ts +18 -0
package/3p/pi-plannotator/packages/server/pr.ts +146 -0
package/3p/pi-plannotator/packages/server/project.test.ts +115 -0
package/3p/pi-plannotator/packages/server/project.ts +45 -0
package/3p/pi-plannotator/packages/server/reference-handlers.ts +404 -0
package/3p/pi-plannotator/packages/server/remote.test.ts +150 -0
package/3p/pi-plannotator/packages/server/remote.ts +74 -0
package/3p/pi-plannotator/packages/server/repo.ts +80 -0
package/3p/pi-plannotator/packages/server/resolve-file.test.ts +310 -0
package/3p/pi-plannotator/packages/server/review-workspace.test.ts +1032 -0
package/3p/pi-plannotator/packages/server/review-workspace.ts +48 -0
package/3p/pi-plannotator/packages/server/review.ts +1318 -0
package/3p/pi-plannotator/packages/server/sessions.ts +111 -0
package/3p/pi-plannotator/packages/server/share-url.ts +53 -0
package/3p/pi-plannotator/packages/server/shared-handlers.test.ts +43 -0
package/3p/pi-plannotator/packages/server/shared-handlers.ts +177 -0
package/3p/pi-plannotator/packages/server/storage.test.ts +176 -0
package/3p/pi-plannotator/packages/server/storage.ts +17 -0
package/3p/pi-plannotator/packages/server/tour/tour-review.test.ts +146 -0
package/3p/pi-plannotator/packages/server/tour/tour-review.ts +604 -0
package/3p/pi-plannotator/packages/server/tsconfig.json +15 -0
package/3p/pi-plannotator/packages/server/vcs.test.ts +48 -0
package/3p/pi-plannotator/packages/server/vcs.ts +80 -0
package/3p/pi-plannotator/packages/shared/agent-jobs.ts +132 -0
package/3p/pi-plannotator/packages/shared/agents.ts +53 -0
package/3p/pi-plannotator/packages/shared/annotate-args.test.ts +386 -0
package/3p/pi-plannotator/packages/shared/annotate-args.ts +107 -0
package/3p/pi-plannotator/packages/shared/at-reference.test.ts +99 -0
package/3p/pi-plannotator/packages/shared/at-reference.ts +52 -0
package/3p/pi-plannotator/packages/shared/checklist.ts +52 -0
package/3p/pi-plannotator/packages/shared/code-file.test.ts +112 -0
package/3p/pi-plannotator/packages/shared/code-file.ts +41 -0
package/3p/pi-plannotator/packages/shared/code-nav.test.ts +515 -0
package/3p/pi-plannotator/packages/shared/code-nav.ts +436 -0
package/3p/pi-plannotator/packages/shared/compress.ts +51 -0
package/3p/pi-plannotator/packages/shared/config.ts +262 -0
package/3p/pi-plannotator/packages/shared/crypto.test.ts +172 -0
package/3p/pi-plannotator/packages/shared/crypto.ts +97 -0
package/3p/pi-plannotator/packages/shared/data-dir.ts +42 -0
package/3p/pi-plannotator/packages/shared/diff-paths.test.ts +30 -0
package/3p/pi-plannotator/packages/shared/diff-paths.ts +137 -0
package/3p/pi-plannotator/packages/shared/draft.ts +64 -0
package/3p/pi-plannotator/packages/shared/external-annotation.ts +397 -0
package/3p/pi-plannotator/packages/shared/extract-code-paths.test.ts +59 -0
package/3p/pi-plannotator/packages/shared/extract-code-paths.ts +66 -0
package/3p/pi-plannotator/packages/shared/favicon.ts +5 -0
package/3p/pi-plannotator/packages/shared/feedback-templates.test.ts +65 -0
package/3p/pi-plannotator/packages/shared/feedback-templates.ts +29 -0
package/3p/pi-plannotator/packages/shared/goal-setup.test.ts +231 -0
package/3p/pi-plannotator/packages/shared/goal-setup.ts +336 -0
package/3p/pi-plannotator/packages/shared/html-to-markdown.test.ts +62 -0
package/3p/pi-plannotator/packages/shared/html-to-markdown.ts +32 -0
package/3p/pi-plannotator/packages/shared/improvement-hooks.test.ts +135 -0
package/3p/pi-plannotator/packages/shared/improvement-hooks.ts +115 -0
package/3p/pi-plannotator/packages/shared/integrations-common.ts +243 -0
package/3p/pi-plannotator/packages/shared/jj-core.test.ts +236 -0
package/3p/pi-plannotator/packages/shared/jj-core.ts +433 -0
package/3p/pi-plannotator/packages/shared/package.json +55 -0
package/3p/pi-plannotator/packages/shared/pfm-reminder.test.ts +88 -0
package/3p/pi-plannotator/packages/shared/pfm-reminder.ts +80 -0
package/3p/pi-plannotator/packages/shared/pr-github.ts +661 -0
package/3p/pi-plannotator/packages/shared/pr-gitlab.test.ts +202 -0
package/3p/pi-plannotator/packages/shared/pr-gitlab.ts +620 -0
package/3p/pi-plannotator/packages/shared/pr-provider.test.ts +266 -0
package/3p/pi-plannotator/packages/shared/pr-provider.ts +123 -0
package/3p/pi-plannotator/packages/shared/pr-stack.test.ts +104 -0
package/3p/pi-plannotator/packages/shared/pr-stack.ts +194 -0
package/3p/pi-plannotator/packages/shared/pr-types.ts +326 -0
package/3p/pi-plannotator/packages/shared/project.ts +71 -0
package/3p/pi-plannotator/packages/shared/prompts-integration.test.ts +421 -0
package/3p/pi-plannotator/packages/shared/prompts.test.ts +504 -0
package/3p/pi-plannotator/packages/shared/prompts.ts +247 -0
package/3p/pi-plannotator/packages/shared/reference-common.ts +87 -0
package/3p/pi-plannotator/packages/shared/repo.ts +71 -0
package/3p/pi-plannotator/packages/shared/resolve-file.test.ts +113 -0
package/3p/pi-plannotator/packages/shared/resolve-file.ts +509 -0
package/3p/pi-plannotator/packages/shared/review-args.test.ts +64 -0
package/3p/pi-plannotator/packages/shared/review-args.ts +85 -0
package/3p/pi-plannotator/packages/shared/review-core.test.ts +286 -0
package/3p/pi-plannotator/packages/shared/review-core.ts +895 -0
package/3p/pi-plannotator/packages/shared/review-workspace-node.ts +230 -0
package/3p/pi-plannotator/packages/shared/review-workspace.ts +436 -0
package/3p/pi-plannotator/packages/shared/semantic-diff-types.ts +76 -0
package/3p/pi-plannotator/packages/shared/semantic-diff.test.ts +322 -0
package/3p/pi-plannotator/packages/shared/semantic-diff.ts +520 -0
package/3p/pi-plannotator/packages/shared/storage.ts +378 -0
package/3p/pi-plannotator/packages/shared/tour.ts +61 -0
package/3p/pi-plannotator/packages/shared/tsconfig.json +15 -0
package/3p/pi-plannotator/packages/shared/types.ts +29 -0
package/3p/pi-plannotator/packages/shared/url-to-markdown.test.ts +177 -0
package/3p/pi-plannotator/packages/shared/url-to-markdown.ts +351 -0
package/3p/pi-plannotator/packages/shared/vcs-core.test.ts +332 -0
package/3p/pi-plannotator/packages/shared/vcs-core.ts +482 -0
package/3p/pi-plannotator/packages/shared/worktree-pool.test.ts +162 -0
package/3p/pi-plannotator/packages/shared/worktree-pool.ts +103 -0
package/3p/pi-plannotator/packages/shared/worktree.ts +119 -0
package/3p/pi-subagents/package.json +50 -0
package/3p/pi-subagents/src/agent-manager.ts +413 -0
package/3p/pi-subagents/src/agent-runner.ts +502 -0
package/3p/pi-subagents/src/agent-types.ts +248 -0
package/3p/pi-subagents/src/context.ts +58 -0
package/3p/pi-subagents/src/cross-extension-rpc.ts +135 -0
package/3p/pi-subagents/src/custom-agents.ts +137 -0
package/3p/pi-subagents/src/default-agents.ts +144 -0
package/3p/pi-subagents/src/env.ts +33 -0
package/3p/pi-subagents/src/group-join.ts +141 -0
package/3p/pi-subagents/src/index.ts +1811 -0
package/3p/pi-subagents/src/invocation-config.ts +40 -0
package/3p/pi-subagents/src/memory.ts +165 -0
package/3p/pi-subagents/src/model-resolver.ts +81 -0
package/3p/pi-subagents/src/output-file.ts +77 -0
package/3p/pi-subagents/src/prompts.ts +85 -0
package/3p/pi-subagents/src/skill-loader.ts +79 -0
package/3p/pi-subagents/src/types.ts +111 -0
package/3p/pi-subagents/src/ui/agent-widget.ts +496 -0
package/3p/pi-subagents/src/ui/conversation-viewer.ts +250 -0
package/3p/pi-subagents/src/worktree.ts +162 -0
package/3p/pi-tasks/package.json +52 -0
package/3p/pi-tasks/src/auto-clear.ts +91 -0
package/3p/pi-tasks/src/index.ts +1150 -0
package/3p/pi-tasks/src/process-tracker.ts +140 -0
package/3p/pi-tasks/src/reminder-cadence.ts +90 -0
package/3p/pi-tasks/src/task-store.ts +324 -0
package/3p/pi-tasks/src/tasks-config.ts +27 -0
package/3p/pi-tasks/src/types.ts +40 -0
package/3p/pi-tasks/src/ui/settings-menu.ts +152 -0
package/3p/pi-tasks/src/ui/task-widget.ts +296 -0
package/AGENTS.md +28 -0
package/LICENSE +201 -0
package/extensions/orchestrator/agents/brainstorm-reviewer.ts +77 -0
package/extensions/orchestrator/agents/code-reviewer.ts +89 -0
package/extensions/orchestrator/agents/explore.ts +33 -0
package/extensions/orchestrator/agents/librarian.ts +43 -0
package/extensions/orchestrator/agents/plan-reviewer.ts +75 -0
package/extensions/orchestrator/agents/planner.ts +61 -0
package/extensions/orchestrator/agents/registry.ts +156 -0
package/extensions/orchestrator/agents/task.ts +50 -0
package/extensions/orchestrator/agents/tool-routing.ts +84 -0
package/extensions/orchestrator/ast-search.ts +85 -0
package/extensions/orchestrator/cbm.ts +330 -0
package/extensions/orchestrator/command-handlers.test.ts +163 -0
package/extensions/orchestrator/command-handlers.ts +116 -0
package/extensions/orchestrator/commands.test.ts +81 -0
package/extensions/orchestrator/commands.ts +75 -0
package/extensions/orchestrator/config.test.ts +221 -0
package/extensions/orchestrator/config.ts +230 -0
package/extensions/orchestrator/context.test.ts +293 -0
package/extensions/orchestrator/context.ts +206 -0
package/extensions/orchestrator/event-handlers.test.ts +190 -0
package/extensions/orchestrator/event-handlers.ts +1416 -0
package/extensions/orchestrator/exa.ts +104 -0
package/extensions/orchestrator/flant-infra.ts +486 -0
package/extensions/orchestrator/index.ts +80 -0
package/extensions/orchestrator/integration.test.ts +1214 -0
package/extensions/orchestrator/orchestrator.test.ts +252 -0
package/extensions/orchestrator/orchestrator.ts +538 -0
package/extensions/orchestrator/phases/brainstorm.test.ts +15 -0
package/extensions/orchestrator/phases/brainstorm.ts +273 -0
package/extensions/orchestrator/phases/implementation.ts +40 -0
package/extensions/orchestrator/phases/machine.test.ts +293 -0
package/extensions/orchestrator/phases/machine.ts +209 -0
package/extensions/orchestrator/phases/planning.ts +255 -0
package/extensions/orchestrator/phases/review.ts +193 -0
package/extensions/orchestrator/plannotator.ts +56 -0
package/extensions/orchestrator/pp-menu.ts +866 -0
package/extensions/orchestrator/state.test.ts +343 -0
package/extensions/orchestrator/state.ts +237 -0
package/extensions/orchestrator/validate-artifacts.test.ts +88 -0
package/extensions/orchestrator/validate-artifacts.ts +272 -0
package/extensions/orchestrator/vendor.d.ts +26 -0
package/package.json +73 -0
package/scripts/postinstall.sh +18 -0

package/3p/pi-plannotator/packages/server/browser.ts ADDED Viewed

@@ -0,0 +1,245 @@
+/**
+ * Cross-platform browser opening utility
+ */
+import { $ } from "bun";
+import { spawn } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+import { getPlannotatorDataDir } from "@plannotator/shared/data-dir";
+import { loadConfig, resolveUseGlimpse } from "@plannotator/shared/config";
+const IPC_REGISTRY = path.join(getPlannotatorDataDir(), "vscode-ipc.json");
+/**
+ * Common "no-op" values for $BROWSER used by headless/background environments
+ * (e.g. Claude Code's agent view sets BROWSER=true) to signal "do not actually
+ * launch a browser". Treating these as if the variable were unset prevents
+ * silently shelling out to e.g. `true <url>`, which exits 0 without opening
+ * anything and leaves the Plannotator server hanging on waitForDecision().
+ */
+const NOOP_BROWSER_VALUES = new Set(["true", "false", "none", ":", "0", "1"]);
+export function isNoOpBrowserSentinel(value: string | undefined): boolean {
+  if (!value) return false;
+  return NOOP_BROWSER_VALUES.has(value.trim().toLowerCase());
+}
+/**
+ * Try opening URL via VS Code extension IPC registry.
+ * Falls back when env vars (PLANNOTATOR_BROWSER) aren't available to the process.
+ */
+async function tryVscodeIpc(url: string): Promise<boolean> {
+  try {
+    const registry: Record<string, number> = JSON.parse(
+      fs.readFileSync(IPC_REGISTRY, "utf-8"),
+    );
+    const cwd = process.cwd();
+    // Find the best matching workspace (longest prefix match)
+    let bestMatch = "";
+    let bestPort = 0;
+    for (const [workspace, port] of Object.entries(registry)) {
+      if (cwd.startsWith(workspace) && workspace.length > bestMatch.length) {
+        bestMatch = workspace;
+        bestPort = port;
+      }
+    }
+    if (!bestPort) return false;
+    const ipcUrl = new URL("/open", `http://127.0.0.1:${bestPort}`);
+    ipcUrl.searchParams.set("url", url);
+    const resp = await fetch(ipcUrl.toString());
+    return resp.ok;
+  } catch {
+    return false;
+  }
+}
+/**
+ * Check if running in WSL (Windows Subsystem for Linux)
+ */
+export async function isWSL(): Promise<boolean> {
+  if (process.platform !== "linux") {
+    return false;
+  }
+  if (os.release().toLowerCase().includes("microsoft")) {
+    return true;
+  }
+  // Fallback: check /proc/version for WSL signature (if available)
+  try {
+    const file = Bun.file("/proc/version");
+    if (await file.exists()) {
+      const content = await file.text();
+      return (
+        content.toLowerCase().includes("wsl") ||
+        content.toLowerCase().includes("microsoft")
+      );
+    }
+  } catch {
+    // Ignore errors reading /proc/version
+  }
+  return false;
+}
+/**
+ * Open a URL in the browser
+ *
+ * Uses PLANNOTATOR_BROWSER env var if set, otherwise uses system default.
+ * - macOS: Set to app name ("Google Chrome") or path ("/Applications/Firefox.app")
+ * - Linux/Windows/WSL: Set to executable path ("/usr/bin/firefox")
+ *
+ * Fails silently if browser can't be opened
+ */
+export function shouldTryRemoteBrowserFallback(isRemote: boolean): boolean {
+  if (!isRemote) return false;
+  const plannotatorBrowser = process.env.PLANNOTATOR_BROWSER;
+  const browser = process.env.BROWSER;
+  // Treat headless sentinels (e.g. BROWSER=true from Claude Code's agent view)
+  // as if no real browser handler were configured, so the IPC fallback still runs.
+  const hasRealHandler =
+    (plannotatorBrowser && !isNoOpBrowserSentinel(plannotatorBrowser)) ||
+    (browser && !isNoOpBrowserSentinel(browser));
+  return !hasRealHandler;
+}
+function buildGlimpseHtml(url: string): string {
+  const encodedUrl = JSON.stringify(url);
+  return `<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>Plannotator</title>
+    <style>
+      html, body { width: 100%; height: 100%; margin: 0; }
+      body { overflow: hidden; background: #0f1115; }
+    </style>
+  </head>
+  <body>
+    <script>
+      location.replace(${encodedUrl});
+    </script>
+  </body>
+</html>`;
+}
+async function openGlimpse(url: string): Promise<boolean> {
+  const glimpseCli = Bun.which("glimpseui");
+  if (!glimpseCli) return false;
+  const args = [
+    "--width",
+    String(Number(process.env.PLANNOTATOR_GLIMPSE_WIDTH || 1280)),
+    "--height",
+    String(Number(process.env.PLANNOTATOR_GLIMPSE_HEIGHT || 900)),
+    "--title",
+    "Plannotator",
+    "--open-links",
+  ];
+  const html = buildGlimpseHtml(url);
+  // On Windows, `glimpseui` resolves to an npm script shim, not an exe, which
+  // spawn() can't launch without a shell. `shell: true` would break the stdin
+  // HTML pipe below, so run the package entry with node directly instead.
+  let command = glimpseCli;
+  let spawnArgs = args;
+  if (process.platform === "win32" && !/\.exe$/i.test(glimpseCli)) {
+    const node = Bun.which("node");
+    const entry = path.join(
+      path.dirname(glimpseCli),
+      "node_modules",
+      "glimpseui",
+      "bin",
+      "glimpse.mjs"
+    );
+    if (node && fs.existsSync(entry)) {
+      command = node;
+      spawnArgs = [entry, ...args];
+    }
+  }
+  return await new Promise<boolean>((resolve) => {
+    let settled = false;
+    let successTimer: ReturnType<typeof setTimeout> | undefined;
+    const finish = (opened: boolean) => {
+      if (settled) return;
+      settled = true;
+      if (successTimer) clearTimeout(successTimer);
+      resolve(opened);
+    };
+    const child = spawn(command, spawnArgs, {
+      detached: true,
+      stdio: ["pipe", "ignore", "ignore"],
+    });
+    successTimer = setTimeout(() => {
+      child.unref();
+      finish(true);
+    }, 750);
+    child.once("error", () => finish(false));
+    child.once("exit", () => finish(false));
+    child.stdin.once("error", () => finish(false));
+    child.stdin.end(html);
+  });
+}
+export async function openBrowser(
+  url: string,
+  options?: { isRemote?: boolean; useGlimpse?: boolean }
+): Promise<boolean> {
+  try {
+    const rawPlannotatorBrowser = process.env.PLANNOTATOR_BROWSER;
+    const rawBrowser = process.env.BROWSER;
+    const plannotatorBrowser = isNoOpBrowserSentinel(rawPlannotatorBrowser)
+      ? undefined
+      : rawPlannotatorBrowser;
+    const envBrowser = isNoOpBrowserSentinel(rawBrowser) ? undefined : rawBrowser;
+    const browser = plannotatorBrowser || envBrowser;
+    const isRemote = options?.isRemote ?? false;
+    if (shouldTryRemoteBrowserFallback(isRemote)) {
+      const openedViaIpc = await tryVscodeIpc(url);
+      if (openedViaIpc) {
+        return true;
+      }
+    }
+    if (options?.useGlimpse && !browser && !isRemote && resolveUseGlimpse(loadConfig())) {
+      const openedViaGlimpse = await openGlimpse(url);
+      if (openedViaGlimpse) {
+        return true;
+      }
+    }
+    const platform = process.platform;
+    const wsl = await isWSL();
+    if (browser) {
+      if (plannotatorBrowser && platform === "darwin") {
+        if (plannotatorBrowser.includes("/") && !plannotatorBrowser.endsWith(".app")) {
+          await $`${plannotatorBrowser} ${url}`.quiet();
+        } else {
+          await $`open -a ${plannotatorBrowser} ${url}`.quiet();
+        }
+      } else if ((platform === "win32" || wsl) && plannotatorBrowser) {
+        await $`cmd.exe /c start "" ${plannotatorBrowser} ${url}`.quiet();
+      } else {
+        await $`${browser} ${url}`.quiet();
+      }
+    } else {
+      // Default system browser
+      if (platform === "win32" || wsl) {
+        await $`cmd.exe /c start ${url}`.quiet();
+      } else if (platform === "darwin") {
+        await $`open ${url}`.quiet();
+      } else {
+        await $`xdg-open ${url}`.quiet();
+      }
+    }
+    return true;
+  } catch {
+    // Shell-based open failed — try VS Code IPC registry as fallback
+    return tryVscodeIpc(url);
+  }
+}

package/3p/pi-plannotator/packages/server/claude-review.ts ADDED Viewed

@@ -0,0 +1,352 @@
+import { toRelativePath } from "./path-utils";
+/**
+ * Claude Code Review Agent — prompt, command builder, and JSONL output parser.
+ *
+ * Claude has its own review model (severity-based findings with reasoning traces)
+ * separate from Codex's priority-based model. The transform layer normalizes
+ * both into the shared annotation format.
+ *
+ * Claude uses --json-schema (inline JSON + Ajv validation with retries) and
+ * --output-format stream-json for live JSONL streaming. The final event is
+ * type:"result" with structured_output containing validated findings.
+ */
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+export type ClaudeSeverity = "important" | "nit" | "pre_existing";
+export interface ClaudeFinding {
+  severity: ClaudeSeverity;
+  file: string;
+  line: number;
+  end_line: number;
+  description: string;
+  reasoning: string;
+}
+export interface ClaudeReviewOutput {
+  findings: ClaudeFinding[];
+  summary: {
+    important: number;
+    nit: number;
+    pre_existing: number;
+  };
+}
+// ---------------------------------------------------------------------------
+// Schema — Claude's own severity-based model
+// ---------------------------------------------------------------------------
+export const CLAUDE_REVIEW_SCHEMA_JSON = JSON.stringify({
+  type: "object",
+  properties: {
+    findings: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          severity: { type: "string", enum: ["important", "nit", "pre_existing"] },
+          file: { type: "string" },
+          line: { type: "integer" },
+          end_line: { type: "integer" },
+          description: { type: "string" },
+          reasoning: { type: "string" },
+        },
+        required: ["severity", "file", "line", "end_line", "description", "reasoning"],
+        additionalProperties: false,
+      },
+    },
+    summary: {
+      type: "object",
+      properties: {
+        important: { type: "integer" },
+        nit: { type: "integer" },
+        pre_existing: { type: "integer" },
+      },
+      required: ["important", "nit", "pre_existing"],
+      additionalProperties: false,
+    },
+  },
+  required: ["findings", "summary"],
+  additionalProperties: false,
+});
+// ---------------------------------------------------------------------------
+// Review prompt — converges open-source Claude Code review + remote service
+// ---------------------------------------------------------------------------
+export const CLAUDE_REVIEW_PROMPT = `# Claude Code Review System Prompt
+## Identity
+You are a code review system. Your job is to find bugs that would break
+production. You are not a linter, formatter, or style checker unless
+project guidance files explicitly expand your scope.
+## Pipeline
+Step 1: Gather context
+  - Retrieve the PR diff or local diff (gh pr diff, git diff, or jj diff)
+  - Read CLAUDE.md and REVIEW.md at the repo root and in every directory
+    containing modified files
+  - Build a map of which rules apply to which file paths
+  - Identify any skip rules (paths, patterns, or file types to ignore)
+Step 2: Launch 4 parallel review agents
+  Agent 1 — Bug + Regression (Opus-level reasoning)
+    Scan for logic errors, regressions, broken edge cases, build failures,
+    and code that will produce wrong results. Focus on the diff but read
+    surrounding code to understand call sites and data flow. Flag only
+    issues where the code is demonstrably wrong — not stylistic concerns,
+    not missing tests, not "could be cleaner."
+  Agent 2 — Security + Deep Analysis (Opus-level reasoning)
+    Look for security vulnerabilities with concrete exploit paths, race
+    conditions, incorrect assumptions about trust boundaries, and subtle
+    issues in introduced code. Read surrounding code for context. Do not
+    flag theoretical risks without a plausible path to harm.
+  Agent 3 — Code Quality + Reusability (Sonnet-level reasoning)
+    Look for code smells, unnecessary duplication, missed opportunities to
+    reuse existing utilities or patterns in the codebase, overly complex
+    implementations that could be simpler, and elegance issues. Read the
+    surrounding codebase to understand existing patterns before flagging.
+    Only flag issues a senior engineer would care about.
+  Agent 4 — Guideline Compliance (Haiku-level reasoning)
+    Audit changes against rules from CLAUDE.md and REVIEW.md gathered in
+    Step 1. Only flag clear, unambiguous violations where you can cite the
+    exact rule broken. If a PR makes a CLAUDE.md statement outdated, flag
+    that the docs need updating. Respect all skip rules — never flag files
+    or patterns that guidance says to ignore.
+  All agents:
+  - Do not duplicate each other's findings
+  - Do not flag issues in paths excluded by guidance files
+  - Provide file, line number, and a concise description for each candidate
+Step 3: Validate each candidate finding
+  For each candidate, launch a validation agent. The validator:
+  - Traces the actual code path to confirm the issue is real
+  - Checks whether the issue is handled elsewhere (try/catch, upstream
+    guard, fallback logic, type system guarantees)
+  - Confirms the finding is not a false positive with high confidence
+  - If validation fails, drop the finding silently
+  - If validation passes, write a clear reasoning chain explaining how
+    the issue was confirmed — this becomes the \`reasoning\` field
+Step 4: Classify each validated finding
+  Assign exactly one severity:
+  important — A bug that should be fixed before merging. Build failures,
+    clear logic errors, security vulnerabilities with exploit paths, data
+    loss risks, race conditions with observable consequences.
+  nit — A minor issue worth fixing but non-blocking. Style deviations
+    from project guidelines, code quality concerns, edge cases that are
+    unlikely but worth noting, convention violations that don't affect
+    correctness.
+  pre_existing — A bug that exists in the surrounding codebase but was
+    NOT introduced by this PR. Only flag when directly relevant to the
+    changed code path.
+Step 5: Deduplicate and rank
+  - Merge findings that describe the same underlying issue from different
+    agents — keep the most specific description and the highest severity
+  - Sort by severity: important → nit → pre_existing
+  - Within each severity, sort by file path and line number
+Step 6: Return structured JSON output matching the schema.
+  If no issues are found, return an empty findings array with zeroed summary.
+## Hard constraints
+- Never approve or block the PR
+- Never comment on formatting or code style unless guidance files say to
+- Never flag missing test coverage unless guidance files say to
+- Never invent rules — only enforce what CLAUDE.md or REVIEW.md state
+- Never flag issues in skipped paths or generated files unless guidance
+  explicitly includes them
+- Prefer silence over false positives — when in doubt, drop the finding
+- Do NOT post any comments to GitHub or GitLab
+- Do NOT use gh pr comment or any commenting tool
+- Your only output is the structured JSON findings`;
+// ---------------------------------------------------------------------------
+// Command builder
+// ---------------------------------------------------------------------------
+export interface ClaudeCommandResult {
+  command: string[];
+  /** Prompt text to write to stdin (Claude reads prompt from stdin, not argv). */
+  stdinPrompt: string;
+}
+/**
+ * Build the `claude -p` command. Prompt is passed via stdin, not as a
+ * positional arg — avoids quoting issues, argv limits, and variadic flag conflicts.
+ */
+export function buildClaudeCommand(prompt: string, model: string = "claude-opus-4-7", effort?: string): ClaudeCommandResult {
+  const allowedTools = [
+    "Agent", "Read", "Glob", "Grep",
+    // GitHub CLI
+    "Bash(gh pr view:*)", "Bash(gh pr diff:*)", "Bash(gh pr list:*)",
+    "Bash(gh issue view:*)", "Bash(gh issue list:*)",
+    "Bash(gh api repos/*/*/pulls/*)", "Bash(gh api repos/*/*/pulls/*/files*)",
+    "Bash(gh api repos/*/*/pulls/*/comments*)", "Bash(gh api repos/*/*/issues/*/comments*)",
+    // GitLab CLI
+    "Bash(glab mr view:*)", "Bash(glab mr diff:*)", "Bash(glab mr list:*)",
+    "Bash(glab api:*)",
+    // Git (read-only)
+    "Bash(git status:*)", "Bash(git diff:*)", "Bash(git log:*)",
+    "Bash(git show:*)", "Bash(git blame:*)", "Bash(git branch:*)",
+    "Bash(git grep:*)", "Bash(git ls-remote:*)", "Bash(git ls-tree:*)",
+    "Bash(git merge-base:*)", "Bash(git remote:*)", "Bash(git rev-parse:*)",
+    "Bash(git show-ref:*)", "Bash(git -C:*)",
+    // JJ (read-only)
+    "Bash(jj status:*)", "Bash(jj diff:*)", "Bash(jj log:*)",
+    "Bash(jj show:*)", "Bash(jj file show:*)", "Bash(jj cat:*)",
+    "Bash(jj bookmark list:*)",
+    "Bash(wc:*)",
+  ].join(",");
+  const disallowedTools = [
+    "Edit", "Write", "NotebookEdit", "WebFetch", "WebSearch",
+    "Bash(python:*)", "Bash(python3:*)", "Bash(node:*)", "Bash(npx:*)",
+    "Bash(bun:*)", "Bash(bunx:*)", "Bash(sh:*)", "Bash(bash:*)", "Bash(zsh:*)",
+    "Bash(curl:*)", "Bash(wget:*)",
+  ].join(",");
+  return {
+    command: [
+      "claude", "-p",
+      "--permission-mode", "dontAsk",
+      "--output-format", "stream-json",
+      "--verbose",
+      "--json-schema", CLAUDE_REVIEW_SCHEMA_JSON,
+      "--no-session-persistence",
+      "--model", model,
+      ...(effort ? ["--effort", effort] : []),
+      "--tools", "Agent,Bash,Read,Glob,Grep",
+      "--allowedTools", allowedTools,
+      "--disallowedTools", disallowedTools,
+    ],
+    stdinPrompt: prompt,
+  };
+}
+// ---------------------------------------------------------------------------
+// JSONL stream output parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse Claude Code's stream-json output (JSONL).
+ * Extracts structured_output from the final type:"result" event.
+ */
+export function parseClaudeStreamOutput(stdout: string): ClaudeReviewOutput | null {
+  if (!stdout.trim()) return null;
+  const lines = stdout.trim().split('\n');
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i].trim();
+    if (!line) continue;
+    try {
+      const event = JSON.parse(line);
+      if (event.type === 'result') {
+        if (event.is_error) return null;
+        const output = event.structured_output;
+        if (!output || !Array.isArray(output.findings)) return null;
+        return output as ClaudeReviewOutput;
+      }
+    } catch {
+      // Not valid JSON — skip
+    }
+  }
+  return null;
+}
+// ---------------------------------------------------------------------------
+// Finding transform — Claude findings → external annotations
+// ---------------------------------------------------------------------------
+/** Transform Claude findings into the external annotation format. */
+export function transformClaudeFindings(
+  findings: ClaudeFinding[],
+  source: string,
+  cwd?: string,
+  pathTransform?: (path: string) => string,
+): Array<{
+  source: string;
+  filePath: string;
+  lineStart: number;
+  lineEnd: number;
+  type: string;
+  side: string;
+  scope: string;
+  text: string;
+  severity: ClaudeSeverity;
+  reasoning: string;
+  author: string;
+}> {
+  return findings
+    .filter(f => f.file && typeof f.line === "number")
+    .map(f => ({
+      source,
+      filePath: pathTransform
+        ? pathTransform(toRelativePath(f.file, cwd))
+        : toRelativePath(f.file, cwd),
+      lineStart: f.line,
+      lineEnd: f.end_line ?? f.line,
+      type: "comment",
+      side: "new",
+      scope: "line",
+      text: `[${f.severity}] ${f.description}`,
+      severity: f.severity,
+      reasoning: f.reasoning,
+      author: "Claude Code",
+    }));
+}
+// ---------------------------------------------------------------------------
+// Live log formatter
+// ---------------------------------------------------------------------------
+/**
+ * Extract log-worthy content from a JSONL line for the LiveLogViewer.
+ * Returns a human-readable string, or null if the line should be skipped.
+ */
+export function formatClaudeLogEvent(line: string): string | null {
+  try {
+    const event = JSON.parse(line);
+    // Skip the final result event — handled separately
+    if (event.type === 'result') return null;
+    // Assistant messages (the agent's thinking/responses)
+    if (event.type === 'assistant' && event.message?.content) {
+      const parts = Array.isArray(event.message.content) ? event.message.content : [event.message.content];
+      const texts = parts
+        .filter((p: any) => p.type === 'text' && p.text)
+        .map((p: any) => p.text);
+      if (texts.length > 0) return texts.join('\n');
+      // Tool use events (only reached if no text parts found)
+      const tools = parts.filter((p: any) => p.type === 'tool_use');
+      if (tools.length > 0) {
+        return tools.map((t: any) => `[${t.name}] ${typeof t.input === 'string' ? t.input.slice(0, 100) : JSON.stringify(t.input).slice(0, 100)}`).join('\n');
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}

package/3p/pi-plannotator/packages/server/code-nav.ts ADDED Viewed

@@ -0,0 +1,73 @@
+/**
+ * Code navigation — Bun runtime adapter and request handler.
+ */
+import {
+  type CodeNavRequest,
+  type CodeNavRuntime,
+  type CodeNavResponse,
+  resolveCodeNav,
+  validateCodeNavRequest,
+  extractChangedFiles,
+} from "@plannotator/shared/code-nav";
+export type { CodeNavRequest, CodeNavResponse };
+const bunCodeNavRuntime: CodeNavRuntime = {
+  async runCommand(command, args, options) {
+    let proc;
+    try {
+      proc = Bun.spawn([command, ...args], {
+        cwd: options?.cwd,
+        stdout: "pipe",
+        stderr: "pipe",
+      });
+    } catch {
+      return { stdout: "", stderr: "command not found", exitCode: 1 };
+    }
+    let timer: ReturnType<typeof setTimeout> | undefined;
+    if (options?.timeoutMs) {
+      timer = setTimeout(() => proc.kill(), options.timeoutMs);
+    }
+    const [stdout, stderr, exitCode] = await Promise.all([
+      new Response(proc.stdout).text(),
+      new Response(proc.stderr).text(),
+      proc.exited,
+    ]);
+    if (timer) clearTimeout(timer);
+    return { stdout, stderr, exitCode };
+  },
+};
+export async function handleCodeNavResolve(
+  req: Request,
+  cwd: string,
+  changedFiles: string[],
+): Promise<Response> {
+  try {
+    const body = (await req.json()) as CodeNavRequest;
+    const error = validateCodeNavRequest(body);
+    if (error) {
+      return Response.json({ error }, { status: 400 });
+    }
+    const result = await resolveCodeNav(
+      bunCodeNavRuntime,
+      body,
+      cwd,
+      changedFiles,
+    );
+    return Response.json(result);
+  } catch (err) {
+    return Response.json(
+      { error: err instanceof Error ? err.message : "Code navigation failed" },
+      { status: 500 },
+    );
+  }
+}
+export { extractChangedFiles };