open-research-protocol 0.4.14 → 0.4.15

package/packages/orp-workspace-launcher/src/tabs.js

@@ -0,0 +1,166 @@
+import process from "node:process";
+
+import { buildDirectCommand, buildLaunchPlan, deriveWorkspaceId, getResumeCommand, parseWorkspaceSource } from "./core-plan.js";
+import { loadWorkspaceSource } from "./orp.js";
+
+export function parseWorkspaceTabsArgs(argv = []) {
+  const options = {
+    json: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+
+    if (arg === "-h" || arg === "--help") {
+      options.help = true;
+      continue;
+    }
+    if (arg === "--json") {
+      options.json = true;
+      continue;
+    }
+    if (arg.startsWith("--")) {
+      const next = argv[index + 1];
+      if (next == null || next.startsWith("--")) {
+        throw new Error(`missing value for ${arg}`);
+      }
+      if (arg === "--notes-file") {
+        options.notesFile = next;
+      } else if (arg === "--hosted-workspace-id") {
+        options.hostedWorkspaceId = next;
+      } else if (arg === "--workspace-file") {
+        options.workspaceFile = next;
+      } else if (arg === "--base-url") {
+        options.baseUrl = next;
+      } else if (arg === "--orp-command") {
+        options.orpCommand = next;
+      } else {
+        throw new Error(`unknown option: ${arg}`);
+      }
+      index += 1;
+      continue;
+    }
+
+    if (options.ideaId) {
+      throw new Error(`unexpected argument: ${arg}`);
+    }
+    options.ideaId = arg;
+  }
+
+  return options;
+}
+
+export function buildWorkspaceTabsReport(source, parsed, options = {}) {
+  const launchTabs = buildLaunchPlan(parsed.entries, {
+    tmux: false,
+    resume: true,
+  });
+
+  return {
+    sourceType: source.sourceType,
+    sourceLabel: source.sourceLabel,
+    title: parsed.manifest?.title || source.title,
+    workspaceId: deriveWorkspaceId(source, parsed),
+    parseMode: parsed.parseMode,
+    tabCount: launchTabs.length,
+    skippedCount: parsed.skipped.length,
+    tabs: launchTabs.map((tab, index) => ({
+      index: index + 1,
+      title: tab.title,
+      path: tab.path,
+      resumeCommand: getResumeCommand(tab),
+      restartCommand: buildDirectCommand(
+        {
+          path: tab.path,
+          resumeCommand: tab.resumeCommand || null,
+          resumeTool: tab.resumeTool || null,
+          resumeSessionId: tab.sessionId || null,
+          sessionId: tab.sessionId || null,
+        },
+        { resume: true },
+      ),
+      resumeTool: tab.resumeTool || null,
+      resumeSessionId: tab.sessionId || null,
+      codexSessionId: tab.resumeTool === "codex" ? tab.sessionId || null : null,
+      claudeSessionId: tab.resumeTool === "claude" ? tab.sessionId || null : null,
+    })),
+    skipped: parsed.skipped,
+  };
+}
+
+export function summarizeWorkspaceTabs(report) {
+  const lines = [
+    `Source: ${report.sourceLabel}`,
+    `Workspace ID: ${report.workspaceId}`,
+    `Saved tabs: ${report.tabCount}`,
+    `Parse mode: ${report.parseMode}`,
+    "",
+  ];
+
+  for (const tab of report.tabs) {
+    lines.push(`${String(tab.index).padStart(2, "0")}. ${tab.title}`);
+    lines.push(`    path: ${tab.path}`);
+    if (tab.resumeCommand) {
+      lines.push(`    resume: ${tab.restartCommand}`);
+    }
+  }
+
+  if (report.skipped.length > 0) {
+    lines.push("");
+    lines.push("Skipped lines:");
+    for (const skipped of report.skipped) {
+      lines.push(`  line ${skipped.lineNumber}: ${skipped.rawLine}`);
+    }
+  }
+
+  return lines.join("\n");
+}
+
+function printWorkspaceTabsHelp() {
+  console.log(`ORP workspace tabs
+
+Usage:
+  orp workspace tabs <name-or-id> [--json]
+  orp workspace tabs --hosted-workspace-id <workspace-id> [--json]
+  orp workspace tabs --notes-file <path> [--json]
+  orp workspace tabs --workspace-file <path> [--json]
+
+Options:
+  --json                  Print saved tab metadata as JSON
+  --hosted-workspace-id <id> Read a first-class hosted workspace instead of an idea
+  --notes-file <path>     Read a local notes file instead of ORP
+  --workspace-file <path> Read a structured workspace manifest JSON file
+  --base-url <url>        Override the ORP hosted base URL
+  --orp-command <cmd>     Override the ORP CLI executable used for hosted fetches
+  -h, --help              Show this help text
+
+Notes:
+  - This shows the saved tab order plus any stored \`codex resume ...\` or \`claude --resume ...\` command metadata.
+  - The human-readable \`resume:\` line is already copyable and includes the saved \`cd ... && resume ...\` recovery command.
+  - The selector can be \`main\`, \`offhand\`, a hosted idea id, a hosted workspace id, a local workspace id, or a saved workspace title/slug.
+`);
+}
+
+export async function runWorkspaceTabs(argv = process.argv.slice(2)) {
+  const options = parseWorkspaceTabsArgs(argv);
+  if (options.help) {
+    printWorkspaceTabsHelp();
+    return 0;
+  }
+
+  const source = await loadWorkspaceSource(options);
+  const parsed = parseWorkspaceSource(source);
+  const report = buildWorkspaceTabsReport(source, parsed, options);
+
+  if (report.tabCount === 0) {
+    throw new Error("No saved tabs were found in the provided workspace source.");
+  }
+
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    return 0;
+  }
+
+  process.stdout.write(`${summarizeWorkspaceTabs(report)}\n`);
+  return 0;
+}

package/packages/orp-workspace-launcher/test/commands.test.js

@@ -0,0 +1,164 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+import {
+  buildWorkspaceCommandsReport,
+  parseWorkspaceCommandsArgs,
+  parseWorkspaceSource,
+  runWorkspaceCommands,
+} from "../src/index.js";
+
+async function makeTempDir() {
+  return fs.mkdtemp(path.join(os.tmpdir(), "orp-workspace-commands-"));
+}
+
+async function captureStdout(fn) {
+  const chunks = [];
+  const originalWrite = process.stdout.write;
+  process.stdout.write = (chunk, encoding, callback) => {
+    chunks.push(typeof chunk === "string" ? chunk : chunk.toString(encoding || "utf8"));
+    if (typeof callback === "function") {
+      callback();
+    }
+    return true;
+  };
+
+  try {
+    const code = await fn();
+    return {
+      code,
+      stdout: chunks.join(""),
+    };
+  } finally {
+    process.stdout.write = originalWrite;
+  }
+}
+
+test("parseWorkspaceCommandsArgs accepts JSON and workspace selectors", () => {
+  const parsed = parseWorkspaceCommandsArgs([
+    "--workspace-file",
+    "/tmp/workspace.json",
+    "--json",
+  ]);
+
+  assert.equal(parsed.workspaceFile, "/tmp/workspace.json");
+  assert.equal(parsed.json, true);
+  assert.throws(() => parseWorkspaceCommandsArgs(["idea-123", "idea-456"]), /unexpected argument/);
+  assert.throws(() => parseWorkspaceCommandsArgs(["--wat"]), /missing value|unknown option/);
+});
+
+test("buildWorkspaceCommandsReport exposes direct restart commands and exact saved resume commands", () => {
+  const parsed = parseWorkspaceSource({
+    sourceType: "hosted-idea",
+    sourceLabel: "Workspace idea",
+    title: "Workspace idea",
+    notes: `
+/Volumes/Code_2TB/code/collaboration: codex resume abc-123
+/Volumes/Code_2TB/code/anthropic-lab: claude resume claude-456
+/Volumes/Code_2TB/code/collaboration
+`,
+  });
+
+  const report = buildWorkspaceCommandsReport(
+    {
+      sourceType: "hosted-idea",
+      sourceLabel: "Workspace idea",
+      title: "Workspace idea",
+    },
+    parsed,
+  );
+
+  assert.equal(report.commandCount, 3);
+  assert.equal(report.tabs[0]?.resumeCommand, "codex resume abc-123");
+  assert.equal(report.tabs[0]?.restartCommand, "cd '/Volumes/Code_2TB/code/collaboration' && codex resume abc-123");
+  assert.equal(report.tabs[1]?.resumeCommand, "claude resume claude-456");
+  assert.equal(
+    report.tabs[1]?.restartCommand,
+    "cd '/Volumes/Code_2TB/code/anthropic-lab' && claude resume claude-456",
+  );
+  assert.equal(report.tabs[2]?.restartCommand, "cd '/Volumes/Code_2TB/code/collaboration'");
+});
+
+test("runWorkspaceCommands prints JSON with copyable commands", async () => {
+  const tempDir = await makeTempDir();
+  const manifestPath = path.join(tempDir, "workspace.json");
+  await fs.writeFile(
+    manifestPath,
+    `${JSON.stringify(
+      {
+        version: "1",
+        workspaceId: "orp-main",
+        title: "ORP Main",
+        tabs: [
+          {
+            title: "orp",
+            path: "/Volumes/Code_2TB/code/orp",
+            resumeCommand: "claude resume claude-999",
+            resumeTool: "claude",
+            resumeSessionId: "claude-999",
+          },
+          {
+            title: "web",
+            path: "/Volumes/Code_2TB/code/orp-web-app",
+          },
+        ],
+      },
+      null,
+      2,
+    )}\n`,
+    "utf8",
+  );
+
+  const { code, stdout } = await captureStdout(() =>
+    runWorkspaceCommands(["--workspace-file", manifestPath, "--json"]),
+  );
+  const parsed = JSON.parse(stdout);
+
+  assert.equal(code, 0);
+  assert.equal(parsed.workspaceId, "orp-main");
+  assert.equal(parsed.commandCount, 2);
+  assert.equal(parsed.tabs[0]?.resumeCommand, "claude resume claude-999");
+  assert.equal(parsed.tabs[0]?.claudeSessionId, "claude-999");
+  assert.equal(parsed.tabs[0]?.restartCommand, "cd '/Volumes/Code_2TB/code/orp' && claude resume claude-999");
+  assert.equal(parsed.tabs[1]?.restartCommand, "cd '/Volumes/Code_2TB/code/orp-web-app'");
+});
+
+test("buildWorkspaceCommandsReport canonicalizes Claude restart commands from tool and session metadata", () => {
+  const parsed = parseWorkspaceSource({
+    sourceType: "workspace-file",
+    sourceLabel: "/tmp/workspace.json",
+    title: "workspace",
+    workspaceManifest: {
+      version: "1",
+      workspaceId: "orp-main",
+      tabs: [
+        {
+          title: "anthropic-lab",
+          path: "/Volumes/Code_2TB/code/anthropic-lab",
+          resumeTool: "claude",
+          resumeSessionId: "claude-456",
+        },
+      ],
+      notes: "",
+    },
+    notes: "",
+  });
+
+  const report = buildWorkspaceCommandsReport(
+    {
+      sourceType: "workspace-file",
+      sourceLabel: "/tmp/workspace.json",
+      title: "workspace",
+    },
+    parsed,
+  );
+
+  assert.equal(report.tabs[0]?.resumeCommand, "claude --resume claude-456");
+  assert.equal(
+    report.tabs[0]?.restartCommand,
+    "cd '/Volumes/Code_2TB/code/anthropic-lab' && claude --resume claude-456",
+  );
+});

package/packages/orp-workspace-launcher/test/core-plan.test.js

@@ -0,0 +1,253 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  buildLaunchPlan,
+  buildWorkspaceSyncPreview,
+  deriveBaseTitle,
+  extractStructuredWorkspaceFromNotes,
+  normalizeWorkspaceManifest,
+  parseCorePlanNotes,
+  parseWorkspaceSource,
+  resolveWorkspaceSyncTargetIdeaId,
+} from "../src/index.js";
+import { extractWorkspaceNarrativeNotes } from "../src/sync.js";
+
+test("parseCorePlanNotes extracts paths and generic resume commands", () => {
+  const notes = `
+/Volumes/Code_2TB/code/orp-web-app: codex resume 019ce2ee-6083-7d02-9d3a-d27a761132a8
+/Volumes/Code_2TB/code/anthropic-lab: claude resume claude-456
+
+/Volumes/Code_2TB/code/care-evidence-support
+not a path
+`;
+
+  const parsed = parseCorePlanNotes(notes);
+  assert.equal(parsed.entries.length, 3);
+  assert.deepEqual(
+    parsed.entries.map((entry) => ({
+      path: entry.path,
+      resumeCommand: entry.resumeCommand,
+      resumeTool: entry.resumeTool,
+      sessionId: entry.sessionId,
+    })),
+    [
+      {
+        path: "/Volumes/Code_2TB/code/orp-web-app",
+        resumeCommand: "codex resume 019ce2ee-6083-7d02-9d3a-d27a761132a8",
+        resumeTool: "codex",
+        sessionId: "019ce2ee-6083-7d02-9d3a-d27a761132a8",
+      },
+      {
+        path: "/Volumes/Code_2TB/code/anthropic-lab",
+        resumeCommand: "claude resume claude-456",
+        resumeTool: "claude",
+        sessionId: "claude-456",
+      },
+      {
+        path: "/Volumes/Code_2TB/code/care-evidence-support",
+        resumeCommand: null,
+        resumeTool: null,
+        sessionId: null,
+      },
+    ],
+  );
+  assert.equal(parsed.skipped.length, 1);
+});
+
+test("parseCorePlanNotes accepts real Claude resume flag syntax", () => {
+  const parsed = parseCorePlanNotes(`
+/Volumes/Code_2TB/code/anthropic-lab: claude --resume claude-456
+`);
+
+  assert.equal(parsed.entries.length, 1);
+  assert.equal(parsed.entries[0]?.resumeCommand, "claude --resume claude-456");
+  assert.equal(parsed.entries[0]?.resumeTool, "claude");
+  assert.equal(parsed.entries[0]?.sessionId, "claude-456");
+});
+
+test("buildLaunchPlan keeps duplicate titles unique and preserves exact resume commands", () => {
+  const parsed = parseCorePlanNotes(`
+/Volumes/Code_2TB/code/collaboration: codex resume abc-123
+/Volumes/Code_2TB/code/anthropic-lab: claude resume claude-456
+/Volumes/Code_2TB/code/collaboration
+`);
+
+  const plan = buildLaunchPlan(parsed.entries, {
+    tmux: false,
+  });
+
+  assert.equal(plan[0].title, "collaboration");
+  assert.equal(plan[1].title, "anthropic-lab");
+  assert.equal(plan[2].title, "collaboration (2)");
+  assert.equal(plan[0].resumeCommand, "codex resume abc-123");
+  assert.equal(plan[1].resumeCommand, "claude resume claude-456");
+});
+
+test("structured workspace blocks are extracted from notes", () => {
+  const notes = `
+Some overview text.
+
+\`\`\`orp-workspace
+{
+  "version": "1",
+  "workspaceId": "workspace-idea",
+  "tabs": [
+    { "title": "orp", "path": "/Volumes/Code_2TB/code/orp" },
+    { "title": "web", "path": "/Volumes/Code_2TB/code/orp-web-app", "resumeCommand": "claude resume claude-456", "resumeTool": "claude", "resumeSessionId": "claude-456" }
+  ]
+}
+\`\`\`
+`;
+  const manifest = extractStructuredWorkspaceFromNotes(notes);
+  const parsed = parseWorkspaceSource({
+    sourceType: "hosted-idea",
+    sourceLabel: "Workspace idea",
+    notes,
+  });
+
+  assert.equal(manifest.workspaceId, "workspace-idea");
+  assert.equal(parsed.parseMode, "manifest");
+  assert.equal(parsed.entries.length, 2);
+  assert.equal(parsed.entries[1]?.sessionId, "claude-456");
+  assert.equal(parsed.entries[1]?.resumeCommand, "claude resume claude-456");
+});
+
+test("normalizeWorkspaceManifest keeps ledger fields and strips nothing important", () => {
+  const manifest = normalizeWorkspaceManifest({
+    version: "1",
+    workspaceId: "terminal-paths",
+    title: "Terminal Paths",
+    tabs: [
+      {
+        title: "orp",
+        path: "/Volumes/Code_2TB/code/orp",
+      },
+      {
+        title: "lab",
+        path: "/Volumes/Code_2TB/code/anthropic-lab",
+        resumeTool: "claude",
+        resumeSessionId: "claude-456",
+      },
+    ],
+  });
+
+  assert.equal(manifest.workspaceId, "terminal-paths");
+  assert.equal(manifest.title, "Terminal Paths");
+  assert.equal(manifest.tabs[0]?.title, "orp");
+  assert.equal(manifest.tabs[1]?.resumeTool, "claude");
+});
+
+test("extractWorkspaceNarrativeNotes removes structured workspace blocks and legacy path lines", () => {
+  const notes = `
+Workspace summary.
+
+/Volumes/Code_2TB/code/orp
+
+\`\`\`orp-workspace
+{
+  "version": "1",
+  "workspaceId": "workspace-demo",
+  "tabs": [
+    { "path": "/Volumes/Code_2TB/code/orp" }
+  ]
+}
+\`\`\`
+`;
+
+  assert.equal(
+    extractWorkspaceNarrativeNotes(notes, { stripLegacyWorkspaceLines: true }),
+    "Workspace summary.",
+  );
+});
+
+test("buildWorkspaceSyncPreview converts path notes into a structured workspace block", () => {
+  const source = {
+    sourceType: "hosted-idea",
+    sourceLabel: "Workspace idea",
+    title: "Workspace idea",
+    notes: `
+Workspace summary.
+
+/Volumes/Code_2TB/code/orp: codex resume abc-123
+/Volumes/Code_2TB/code/orp-web-app
+`,
+    idea: { id: "idea-123" },
+  };
+  const parsed = parseWorkspaceSource(source);
+  const preview = buildWorkspaceSyncPreview({
+    source,
+    parsed,
+    targetIdea: {
+      id: "idea-123",
+      title: "Workspace idea",
+      notes: source.notes,
+    },
+  });
+
+  assert.equal(preview.workspaceId, "idea-idea-123");
+  assert.equal(preview.tabs.length, 2);
+  assert.equal(preview.tabs[0]?.resumeCommand, "codex resume abc-123");
+  assert.equal(preview.tabs[1]?.title, deriveBaseTitle(preview.tabs[1]));
+  assert.match(preview.nextNotes, /```orp-workspace/);
+  assert.match(preview.nextNotes, /"workspaceId": "idea-idea-123"/);
+  assert.match(preview.nextNotes, /Workspace summary\./);
+  assert.match(preview.nextNotes, /\/Volumes\/Code_2TB\/code\/orp: codex resume abc-123/);
+  assert.match(preview.nextNotes, /\/Volumes\/Code_2TB\/code\/orp-web-app/);
+});
+
+test("buildWorkspaceSyncPreview strips stale legacy path lines when syncing from a workspace file", () => {
+  const source = {
+    sourceType: "workspace-file",
+    sourceLabel: "/tmp/workspace.json",
+    sourcePath: "/tmp/workspace.json",
+    title: "Workspace idea",
+    notes: "",
+    workspaceManifest: {
+      version: "1",
+      workspaceId: "workspace-file-demo",
+      tabs: [{ title: "orp", path: "/Volumes/Code_2TB/code/orp" }],
+    },
+  };
+  const parsed = parseWorkspaceSource(source);
+  const preview = buildWorkspaceSyncPreview({
+    source,
+    parsed,
+    targetIdea: {
+      id: "idea-123",
+      title: "Workspace idea",
+      notes: `
+Workspace summary.
+
+/Volumes/Code_2TB/code/orp: codex resume stale-session
+`,
+    },
+  });
+
+  assert.match(preview.nextNotes, /Workspace summary\./);
+  assert.match(preview.nextNotes, /```orp-workspace/);
+  assert.doesNotMatch(preview.nextNotes, /stale-session/);
+  assert.doesNotMatch(preview.nextNotes, /\/Volumes\/Code_2TB\/code\/orp: codex resume/);
+});
+
+test("resolveWorkspaceSyncTargetIdeaId supports hosted idea and hosted workspace sources", () => {
+  assert.equal(
+    resolveWorkspaceSyncTargetIdeaId({
+      sourceType: "hosted-idea",
+      idea: { id: "idea-123" },
+    }),
+    "idea-123",
+  );
+
+  assert.equal(
+    resolveWorkspaceSyncTargetIdeaId({
+      sourceType: "hosted-workspace",
+      hostedWorkspace: {
+        linkedIdea: {
+          ideaId: "idea-456",
+        },
+      },
+    }),
+    "idea-456",
+  );
+});

package/packages/orp-workspace-launcher/test/fixtures/smoke-notes.txt

@@ -0,0 +1,2 @@
+/Volumes/Code_2TB/code/orp
+/Volumes/Code_2TB/code/orp-web-app

package/packages/orp-workspace-launcher/test/fixtures/workspace-manifest.json

@@ -0,0 +1,17 @@
+{
+  "version": "1",
+  "workspaceId": "terminal-paths-and-codex-sessions",
+  "title": "Terminal paths and codex sessions",
+  "tmuxPrefix": "backtothefort",
+  "tabs": [
+    {
+      "title": "orp",
+      "path": "/Volumes/Code_2TB/code/orp"
+    },
+    {
+      "title": "orp-web-app",
+      "path": "/Volumes/Code_2TB/code/orp-web-app",
+      "codexSessionId": "019ce2ee-6083-7d02-9d3a-d27a761132a8"
+    }
+  ]
+}