@awak-app/simy-cli 0.5.65 → 0.5.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awak-app/simy-cli",
-  "version": "0.5.65",
+  "version": "0.5.67",
   "description": "Local SIMY executor for non-coding Local Tasks and Agentic Loop runs.",
   "type": "module",
   "bin": {

package/src/cli-contract.js

@@ -13,7 +13,7 @@ import {
 } from "./durable-local-task-steps-contract.js";
 import { buildExecutionCapabilityContract } from "./execution-capability-contract.js";
 
-export const CLI_VERSION = "0.5.65";
+export const CLI_VERSION = "0.5.67";
 export const CLI_API_CONTRACT_VERSION = 10;
 
 export function withCliContract(

package/src/codex-plugins/simy/hooks/hooks.json

@@ -1,4 +1,5 @@
 {
+  "description": "SIMY connection reminders, opt-in Delivery Loop lifecycle tracking, and development progress reporting. Trusting hooks does not enable automatic continuation for a task.",
   "hooks": {
     "SessionStart": [
       {
@@ -7,7 +8,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'connection-reminder.mjs')).href); await hook.main();\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY connection check at session start"
           }
         ]
       },
@@ -16,7 +18,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'delivery-loop.mjs')).href); await hook.main('codex');\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY Delivery Loop session tracking"
           }
         ]
       }
@@ -27,7 +30,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'connection-reminder.mjs')).href); await hook.main();\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY connection check before a prompt"
           }
         ]
       },
@@ -36,7 +40,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'delivery-loop.mjs')).href); await hook.main('codex');\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY Delivery Loop prompt tracking"
           }
         ]
       }
@@ -47,7 +52,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'delivery-loop.mjs')).href); await hook.main('codex');\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY Delivery Loop remaining-work check"
           }
         ]
       },
@@ -56,7 +62,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'dev-work.mjs')).href); await hook.main('codex');\"",
-            "timeout": 10
+            "timeout": 10,
+            "statusMessage": "SIMY development progress reporting"
           }
         ]
       }
@@ -67,7 +74,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'delivery-loop.mjs')).href); await hook.main('codex');\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY Delivery Loop session-exit tracking"
           }
         ]
       }
@@ -78,7 +86,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'delivery-loop.mjs')).href); await hook.main('codex');\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY Delivery Loop user-stop tracking"
           }
         ]
       }
@@ -89,7 +98,8 @@
           {
             "type": "command",
             "command": "node --input-type=module -e \"import { pathToFileURL } from 'node:url'; import { join } from 'node:path'; const hook = await import(pathToFileURL(join(process.env.PLUGIN_ROOT, 'hooks', 'delivery-loop.mjs')).href); await hook.main('codex');\"",
-            "timeout": 3
+            "timeout": 3,
+            "statusMessage": "SIMY Delivery Loop permission-wait tracking"
           }
         ]
       }

package/src/session-supervision/claude-sessions.js

@@ -3,6 +3,7 @@ import { lstat, open, readdir, realpath } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { boundConversation, CONVERSATION_LIMITS, textContent } from './conversation-context.js';
+import { sessionTitle } from './session-titles.js';
 
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const MAX_PROJECTS = 256;
@@ -54,21 +55,41 @@ function metadataFromPrefix(bytes, id) {
   const text = bytes.toString('utf8');
   const complete = text.slice(0, text.lastIndexOf('\n') + 1);
   if (!complete) return null;
-  let cwd = '', title = '', found = false;
+  let cwd = '', title = '', customTitle = '', found = false;
   for (const line of complete.split('\n').slice(0, MAX_LINES)) {
     if (!line) continue;
     let item;
     try { item = JSON.parse(line); } catch { return null; }
     if (item.sessionId !== id) return null;
+    if (item.type === 'custom-title' && item.isSidechain !== true) { customTitle = sessionTitle(item.customTitle); continue; }
     if (item.type !== 'user' && item.type !== 'assistant') continue;
     if (item.isSidechain === true) return null;
     if (typeof item.cwd !== 'string' || !isAbsolute(item.cwd)) continue;
     if (!cwd) cwd = resolve(item.cwd);
     if (cwd !== resolve(item.cwd)) return null;
-    if (!title && typeof item.slug === 'string') title = item.slug.replace(/[\x00-\x1f\x7f]/g, '').slice(0, 120);
+    if (!title) title = sessionTitle(item.slug);
     found = true;
   }
-  return found ? { cwd, title } : null;
+  return found ? { cwd, title: customTitle || title } : null;
+}
+
+// /rename appends a custom-title envelope, often beyond the bounded prefix.
+// Inspect only those envelopes; conversation text is never used as a title.
+async function latestCustomTitle(handle, size, id) {
+  const offset = Math.max(0, size - 64 * 1024);
+  const buffer = Buffer.alloc(Math.min(size, 64 * 1024));
+  const { bytesRead } = await handle.read(buffer, 0, buffer.length, offset);
+  let text = buffer.subarray(0, bytesRead).toString('utf8');
+  if (offset) text = text.slice(text.indexOf('\n') + 1);
+  text = text.slice(0, text.lastIndexOf('\n') + 1);
+  let title = '';
+  for (const line of text.split('\n')) {
+    try {
+      const item = JSON.parse(line);
+      if (item.type === 'custom-title' && item.sessionId === id && item.isSidechain !== true) title = sessionTitle(item.customTitle);
+    } catch { /* Ignore partial or unrelated tail entries. */ }
+  }
+  return title;
 }
 
 async function inspectTranscript(root, projectName, fileName, observedAt, includeContext = false, cacheMetadata = false) {
@@ -104,6 +125,7 @@ async function inspectTranscript(root, projectName, fileName, observedAt, includ
     const buffer = Buffer.allocUnsafe(Math.min(opened.size, MAX_PREFIX_BYTES));
     const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
     const metadata = metadataFromPrefix(buffer.subarray(0, bytesRead), id);
+    if (metadata) metadata.title = await latestCustomTitle(handle, opened.size, id) || metadata.title;
     if (cacheMetadata) {
       const [after, pathAfter] = await Promise.all([handle.stat({ bigint: true }), lstat(path, { bigint: true })]);
       if (fingerprint(after) === key && fingerprint(pathAfter) === key && pathAfter.isFile() && !pathAfter.isSymbolicLink())

package/src/session-supervision/index.js

@@ -4,6 +4,7 @@ import { TERMINAL as TERMINAL_RUNS, controlDelivery, listRecords, readRecord, pr
 import { listCodexSessions, openCodexAppServer, readCodexSession, CodexAppServerError } from './codex-app-server.js';
 import { listClaudeSessions, readClaudeSession } from './claude-sessions.js';
 import { originalSessionTarget } from './original-session-target.js';
+import { readCodexTitles, sessionTitle } from './session-titles.js';
 
 function autoContinueState(record, isRunning, supported) {
   if (record?.autoContinue !== true) return { autoContinueStatus: 'off', autoContinueReason: null };
@@ -55,7 +56,7 @@ async function liveClaudeHook(record, metadata, inspectProcess) {
 }
 
 export async function discoverSessions({ root, openClient = openCodexAppServer, listClaude = listClaudeSessions,
-  inspectProcess = processIdentity, now = Date.now(), signal } = {}) {
+  inspectProcess = processIdentity, now = Date.now(), signal, listCodexTitles = readCodexTitles } = {}) {
   const assertActive = () => { if (signal?.aborted) throw new CodexAppServerError('cancelled', 'Conversation discovery was cancelled.'); };
   assertActive();
   const records = await listRecords(root);
@@ -81,6 +82,8 @@ export async function discoverSessions({ root, openClient = openCodexAppServer,
   // Historical sessions must not fan out hundreds of process-inspection
   // subprocesses. Preserve input ordering while limiting live metadata probes.
   const items = [...byKey.values()], projected = new Array(items.length);
+  const codexTitles = items.some(item => item.provider === 'codex' && !sessionTitle(item.title)) ? await listCodexTitles() : new Map();
+  assertActive();
   let nextItem = 0;
   const project = async item => {
     const record = recordsByKey.get(`${item.provider}:${item.session}`);
@@ -97,7 +100,8 @@ export async function discoverSessions({ root, openClient = openCodexAppServer,
         else if (isRunning === undefined && !record.runtime.isRunning) isRunning = false;
       } catch { /* Unverified process leaves runtime status unknown. */ }
     }
-    return { provider: item.provider, session: item.session, cwd: item.cwd, title: item.title, source: item.source,
+    return { provider: item.provider, session: item.session, cwd: item.cwd,
+      title: sessionTitle(item.title) || (item.provider === 'codex' ? codexTitles.get(item.session) || '' : ''), source: item.source,
       ...(typeof isRunning === 'boolean' ? { isRunning } : {}),
       ...(item.providerGoal !== undefined ? { providerGoal: item.providerGoal } : {}),
       ...(item.goalReadState ? { goalReadState: item.goalReadState } : {}),

package/src/session-supervision/session-titles.js

@@ -0,0 +1,48 @@
+import { constants } from 'node:fs';
+import { lstat, open } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const MAX_INDEX_BYTES = 1024 * 1024;
+let cached;
+const fingerprint = info => [info.dev, info.ino, info.size, info.mtimeNs, info.ctimeNs].join(':');
+
+export function sessionTitle(value) {
+  return typeof value === 'string' ? value.replace(/[\x00-\x1f\x7f]/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 200) : '';
+}
+
+// Read title metadata only, including when an older CLI cannot list threads.
+// This never reads prompts or changes the provider's continuation capabilities.
+export async function readCodexTitles({ codexHome = process.env.CODEX_HOME || join(homedir(), '.codex') } = {}) {
+  const path = join(codexHome, 'session_index.jsonl');
+  let handle;
+  try {
+    const before = await lstat(path, { bigint: true });
+    if (!before.isFile() || before.isSymbolicLink()) return new Map();
+    const key = fingerprint(before);
+    if (cached?.path === path && cached.key === key) return new Map(cached.titles);
+    handle = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW || 0));
+    if (fingerprint(await handle.stat({ bigint: true })) !== key) return new Map();
+    const size = Number(before.size), offset = Math.max(0, size - MAX_INDEX_BYTES);
+    const buffer = Buffer.alloc(Math.min(size, MAX_INDEX_BYTES));
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, offset);
+    let text = buffer.subarray(0, bytesRead).toString('utf8');
+    if (offset) text = text.slice(text.indexOf('\n') + 1);
+    text = text.slice(0, text.lastIndexOf('\n') + 1);
+    const titles = new Map();
+    for (const line of text.split('\n')) {
+      try {
+        const item = JSON.parse(line);
+        if (!UUID.test(item.id || '')) continue;
+        const title = sessionTitle(item.thread_name);
+        // Appended renames win, including an explicitly cleared title.
+        if (typeof item.thread_name === 'string') titles.set(item.id, title);
+      } catch { /* A broken entry does not hide other sessions. */ }
+    }
+    if (fingerprint(await handle.stat({ bigint: true })) !== key || fingerprint(await lstat(path, { bigint: true })) !== key) return new Map();
+    cached = { path, key, titles };
+    return new Map(titles);
+  } catch { return new Map(); }
+  finally { await handle?.close(); }
+}

package/src/sqm/claude-plugin.js

@@ -29,9 +29,18 @@ export async function claudePluginFiles() {
   delete hooks.hooks.Interrupt; // Codex-only event; Claude interruptions cannot be vetoed.
   hooks.hooks.StopFailure = structuredClone(hooks.hooks.Stop);
   hooks.hooks.Notification = structuredClone(hooks.hooks.PermissionRequest);
-  for (const groups of Object.values(hooks.hooks)) {
+  for (const [event, groups] of Object.entries(hooks.hooks)) {
     for (const group of groups) {
       for (const hook of group.hooks) {
+        // These Claude events reuse handlers, but their review labels must describe
+        // the actual trigger rather than the Codex event they were copied from.
+        if (event === "StopFailure") {
+          hook.statusMessage = hook.command.includes("dev-work.mjs")
+            ? "SIMY development progress reporting after an error"
+            : "SIMY Delivery Loop error-recovery tracking";
+        } else if (event === "Notification") {
+          hook.statusMessage = "SIMY Delivery Loop permission-notification tracking";
+        }
         hook.command = hook.command.replace(/^node /, `${quoteRuntime(process.execPath)} `)
           .replaceAll("process.env.PLUGIN_ROOT", "process.env.CLAUDE_PLUGIN_ROOT")
           .replaceAll("hook.main('codex')", "hook.main('claude')");