open-research-protocol 0.4.29 → 0.4.30

package/CHANGELOG.md

@@ -6,6 +6,19 @@ There was no prior in-repo changelog file, so the first formal entry starts
 with the currently shipped `v0.4.4` release and summarizes the full release
 delta reflected in this repo.
 
+## v0.4.30 - 2026-04-25
+
+This release tightens ORP-managed Codex session tracking so short-lived
+`codex exec` runs, including Clawdad summary and planning work, do not replace
+the saved interactive workspace thread.
+
+### Changed
+
+- `orp codex status` and `orp codex reconcile` now ignore local Codex exec
+  sessions by default, alongside the existing delegated/subagent filtering.
+- Added `--include-exec` to the ORP/Codex status and reconcile flows for
+  explicit diagnostics when exec sessions need to be inspected.
+
 ## v0.4.29 - 2026-04-25
 
 This release adds ORP-managed Codex session tracking so starting a Codex thread

package/README.md

@@ -473,10 +473,11 @@ orp schedule add codex --name morning-summary --prompt "Summarize this repo" --j
 aligned with Codex sessions. `status` compares the current repo against the
 latest local Codex session metadata, `reconcile` refreshes stale saved sessions,
 and bare `orp codex` launches Codex from the repo root while watching for the new
-session id. Delegated/subagent sessions are ignored by default, and
-artifact-output repos should be left untracked when a separate lab repo is the
-source of truth. Use `--` before Codex args that conflict with ORP wrapper
-options. The manual fallback from inside Codex is still:
+session id. Codex exec and delegated/subagent sessions are ignored by default,
+and artifact-output repos should be left untracked when a separate lab repo is
+the source of truth. Use `--include-exec` only when diagnosing short-lived exec
+sessions, and use `--` before Codex args that conflict with ORP wrapper options.
+The manual fallback from inside Codex is still:
 
 ```bash
 orp workspace add-tab main --here --current-codex

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-research-protocol",
-  "version": "0.4.29",
+  "version": "0.4.30",
   "description": "ORP CLI (Open Research Protocol): workspace ledgers, secrets, scheduling, governed execution, and agent-friendly research workflows.",
   "license": "MIT",
   "author": "Fractal Research Group <cody@frg.earth>",

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

@@ -77,6 +77,22 @@ export function isDelegatedCodexSession(session) {
   return sourceText.includes("subagent") || sourceText.includes("delegate");
 }
 
+export function isCodexExecSession(session) {
+  const originator = normalizeOptionalString(session?.originator)?.toLowerCase();
+  if (originator === "codex_exec" || originator === "codex-exec") {
+    return true;
+  }
+  const source = session?.source;
+  if (typeof source === "string") {
+    return source.trim().toLowerCase() === "exec";
+  }
+  if (!source || typeof source !== "object" || Array.isArray(source)) {
+    return false;
+  }
+  const sourceKind = normalizeOptionalString(source.kind ?? source.type ?? source.source)?.toLowerCase();
+  return sourceKind === "exec";
+}
+
 export function parseCodexSessionMetaLine(line, filePath, stat = {}) {
   let row;
   try {
@@ -97,6 +113,12 @@ export function parseCodexSessionMetaLine(line, filePath, stat = {}) {
 
   const timestamp = normalizeOptionalString(payload.timestamp) || normalizeOptionalString(row.timestamp);
   const timestampMs = timestamp ? Date.parse(timestamp) : 0;
+  const source =
+    typeof payload.source === "string"
+      ? normalizeOptionalString(payload.source)
+      : payload.source && typeof payload.source === "object" && !Array.isArray(payload.source)
+        ? payload.source
+        : null;
   return {
     sessionId,
     cwd: path.resolve(cwd),
@@ -106,7 +128,7 @@ export function parseCodexSessionMetaLine(line, filePath, stat = {}) {
     filePath,
     originator: normalizeOptionalString(payload.originator),
     cliVersion: normalizeOptionalString(payload.cli_version ?? payload.cliVersion),
-    source: payload.source && typeof payload.source === "object" && !Array.isArray(payload.source) ? payload.source : null,
+    source,
   };
 }
 
@@ -171,6 +193,7 @@ export async function scanCodexSessions(options = {}) {
   const sessionsDir = path.join(codexHome, "sessions");
   const sinceMs = typeof options.sinceMs === "number" ? options.sinceMs : 0;
   const includeDelegated = Boolean(options.includeDelegated || options.includeSubagents);
+  const includeExec = Boolean(options.includeExec || options.includeCodexExec);
   const files = await walkSessionFiles(sessionsDir, options);
   const sessions = [];
 
@@ -192,6 +215,9 @@ export async function scanCodexSessions(options = {}) {
     if (!session) {
       continue;
     }
+    if (!includeExec && isCodexExecSession(session)) {
+      continue;
+    }
     if (!includeDelegated && isDelegatedCodexSession(session)) {
       continue;
     }
@@ -287,6 +313,7 @@ function sessionSummary(session) {
     updatedAt: session.updatedMs ? new Date(session.updatedMs).toISOString() : null,
     originator: session.originator || null,
     cliVersion: session.cliVersion || null,
+    source: session.source || null,
     filePath: session.filePath || null,
   };
 }
@@ -563,6 +590,10 @@ function parseCommonOptions(argv = [], defaults = {}, parseOptions = {}) {
       options.includeDelegated = true;
       continue;
     }
+    if (arg === "--include-exec") {
+      options.includeExec = true;
+      continue;
+    }
     if (arg === "--include-artifacts") {
       options.includeArtifactRepos = true;
       continue;
@@ -658,6 +689,7 @@ Commands:
   start      Launch Codex in the repo root and save the new session when metadata appears
 
 Notes:
+  - Codex exec sessions are ignored by default.
   - Delegated/subagent sessions are ignored by default.
   - Broad roots and artifact-output repos are refused unless explicitly overridden.
   - Use -- before Codex args that conflict with ORP wrapper options.
@@ -669,7 +701,7 @@ function printStatusHelp() {
   console.log(`ORP Codex status
 
 Usage:
-  orp codex status [--workspace main] [--path <repo-or-subdir>] [--codex-home <path>] [--json]
+  orp codex status [--workspace main] [--path <repo-or-subdir>] [--codex-home <path>] [--include-exec] [--json]
 `);
 }
 
@@ -677,7 +709,7 @@ function printReconcileHelp() {
   console.log(`ORP Codex reconcile
 
 Usage:
-  orp codex reconcile [--workspace main] [--dry-run] [--add-missing] [--since-days <n>] [--json]
+  orp codex reconcile [--workspace main] [--dry-run] [--add-missing] [--since-days <n>] [--include-exec] [--json]
 `);
 }
 

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

@@ -129,6 +129,38 @@ test("scanCodexSessions ignores delegated sessions by default", async () => {
   );
 });
 
+test("scanCodexSessions ignores exec sessions by default", async () => {
+  const tempDir = await makeTempDir();
+  const codexHome = path.join(tempDir, "codex-home");
+  const repoRoot = path.join(tempDir, "repo");
+  await writeSession(
+    codexHome,
+    "019dc2cb-d435-7072-bbfd-4ae4280474d1",
+    repoRoot,
+    "2026-04-25T12:00:00Z",
+  );
+  await writeSession(
+    codexHome,
+    "019dc2cb-d435-7072-bbfd-4ae4280474d2",
+    repoRoot,
+    "2026-04-25T12:01:00Z",
+    { originator: "codex_exec", source: "exec" },
+  );
+
+  const defaultSessions = await scanCodexSessions({ codexHome, sinceMs: 0 });
+  assert.deepEqual(
+    defaultSessions.map((session) => session.sessionId),
+    ["019dc2cb-d435-7072-bbfd-4ae4280474d1"],
+  );
+
+  const withExecSessions = await scanCodexSessions({ codexHome, sinceMs: 0, includeExec: true });
+  assert.deepEqual(
+    withExecSessions.map((session) => session.sessionId),
+    ["019dc2cb-d435-7072-bbfd-4ae4280474d2", "019dc2cb-d435-7072-bbfd-4ae4280474d1"],
+  );
+  assert.equal(withExecSessions[0].source, "exec");
+});
+
 test("scanCodexSessions finds session metadata near the start of a rollout file", async () => {
   const tempDir = await makeTempDir();
   const codexHome = path.join(tempDir, "codex-home");