@gotcos/glasses-server 6.78.0 → 6.78.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 6.78.1 - Glasses messages reach open Claude sessions again, whatever the size of ~/.claude/projects
+
+Hotfix on 6.78.0. No companion or COS Control change.
+
+- **What broke.** To decide whether an open Claude session is idle, the server finds its transcript by walking `~/.claude/projects`, and it refused the walk past 2,048 folders. Every Claude transcript then read as missing, so occupancy answered `live_desktop_process` for every open session: queued glasses messages waited until they expired (the lens said "Waiting for the current turn to end"), and live delivery through the peer inbox could not confirm either. On Miles's Mac the count passed 2,048 on 2026-10-17 12:33, almost all of it empty folders left by COS's own stateless `claude -p` calls (fixed in the COS scripts separately). The ceiling dates from 6.36; 6.77.0 has the same refusal.
+- **The fix.** The transcript path Claude Code reports in every hook event (`transcript_path`, already in the session signal store) is used first, registered at boot so every reader of Claude transcripts gets it: no walk, no folder limit. It is used only when it is `<projects>/<one folder>/<session id>.jsonl` and the file exists; anything else falls back to the walk, unchanged. The walk ceiling rises to 8,192, and a refusal now logs one `[native-head]` line at most once an hour instead of failing silently.
+- **Checks.** Full suite 7,715 passed, 2 skipped. 9 of 9 guard mutants killed by named tests.
+
 ## 6.78.0 - Steer from the glasses, Retry and Send again, and crash safety for Asks and desk turns (Pi Durable parity)
 
 Pairs with COS Glasses companion 6.10.645. Includes 6.77.0. No COS Control change is required (0.5.322 and 0.5.323 work; see the client matrix). Miles, 2026-10-18: steer from the glasses and retry, for Messages and Sessions; no regressions; better offline to online. Plan: Pi Durable parity build v3.1.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotcos/glasses-server",
-  "version": "6.78.0",
+  "version": "6.78.1",
   "description": "COS Glasses: self-hosted AI heads-up-display server for Even G2 smart glasses, powered by Claude Code, Codex, Cursor Agent CLI, or local Ollama",
   "type": "module",
   "bin": {

package/server/index.ts

@@ -70,7 +70,7 @@ import { nativeQueueControl, plainQueueText } from './lib/codex-queue-control.js
 import { makeCodexLiveDeliverer } from './lib/codex-live-queue-deps.js'
 import { forkThread, realForkDeps } from './lib/fork-thread.js'
 import { ForkJobLedger, fileForkJobPersistence } from './lib/fork-job-ledger.js'
-import { nativeHead, realNativeHeadDeps } from './lib/native-head.js'
+import { nativeHead, realNativeHeadDeps, registerClaudeTranscriptHint } from './lib/native-head.js'
 import { threadOccupancy, holderActivity } from './lib/thread-occupancy.js'
 import { displayRouter } from './routes/display.js'
 import { transcribeStreamRouter, getActiveTranscriptionSessionCount } from './routes/transcribe-stream.js'
@@ -536,6 +536,9 @@ bindingReapTimer.unref()
 // re-deriving roots per request.
 const occupancyDirs = realOccupancyDirs()
 const nativeHeadDeps = realNativeHeadDeps()
+// 6.78.1: Claude Code's own transcript path from the hooks, so finding a session's transcript
+// needs no walk of ~/.claude/projects (which refused past its folder limit; see native-head.ts).
+registerClaudeTranscriptHint(sessionId => signalFor(sessionId)?.transcriptPath ?? null)
 const attachedWorkspaceDeps = realAttachedWorkspaceDeps(nativeHeadDeps)
 // 6.62.0: one set of readers for the Continue plan, rows, detail and the attach verdict.
 const continueFactsDeps = realContinueFactsDeps()

package/server/lib/native-head.ts

@@ -119,7 +119,7 @@
 
 import { createHash } from 'node:crypto'
 import { closeSync, constants as fsConstants, fstatSync, openSync, readSync, readdirSync, statSync } from 'node:fs'
-import { join } from 'node:path'
+import { basename, dirname, join, resolve } from 'node:path'
 import { agentSessionRoots, idFromCodexFilename } from './agent-session-store.js'
 import { cursorTranscriptPath } from './cursor-agent-store.js'
 import { isValidNativeThreadId } from './native-thread-id.js'
@@ -177,8 +177,16 @@ export const TAIL_WINDOW_BYTES_BY_PROVIDER: Record<NativeHeadProvider, number> =
  */
 export const HEAD_ROW_COUNT = 3
 
-/** Ceilings that keep a pathological tree from turning attach into a directory walk. */
-export const MAX_CLAUDE_PROJECT_DIRS = 2048
+/**
+ * Ceilings that keep a pathological tree from turning attach into a directory walk.
+ *
+ * 6.78.1: Claude raised from 2048. COS's own stateless `claude -p` calls each left an empty
+ * project folder behind (about 100 to 270 a day on Miles's Mac); at 2,049 the walk refused,
+ * every Claude transcript read as missing, and every glasses message to an open Claude session
+ * waited from 2026-10-17 12:33 until it expired. A session whose hooks name its transcript
+ * no longer walks at all (`hintedClaudeTranscript`); this ceiling now bounds only the rest.
+ */
+export const MAX_CLAUDE_PROJECT_DIRS = 8192
 export const MAX_CODEX_DIR_ENTRIES = 512
 export const MAX_CODEX_FILES_SCANNED = 20_000
 
@@ -224,6 +232,13 @@ export interface NativeHeadDeps {
    * as `agentSessionLines`' injectable head/tail sizes.
    */
   tailWindowBytes?: number
+  /**
+   * 6.78.1: where Claude Code itself says this session's transcript is (the `transcript_path`
+   * its hook events carry), or null. Optional: absent, or null, means walk the project folders
+   * as before. Validated before use (`hintedClaudeTranscript`), so a wrong hint can only fall
+   * back to the walk, never name another file.
+   */
+  claudeTranscriptHint?: (sessionId: string) => string | null
 }
 
 /**
@@ -406,6 +421,41 @@ export function transcriptPathFor(
   }
 }
 
+/**
+ * The hook's transcript path, only if it is exactly `<root>/<one folder>/<threadId>.jsonl` and
+ * the file exists. The walk's two-copies refusal is not repeated here: this is the file Claude
+ * Code reported writing for this very session, which is stronger evidence than a name match.
+ */
+function hintedClaudeTranscript(filename: string, root: string, threadId: string, deps: NativeHeadDeps): string | null {
+  if (typeof deps.claudeTranscriptHint !== 'function') return null
+  let hint: string | null
+  try {
+    hint = deps.claudeTranscriptHint(threadId)
+  } catch {
+    return null
+  }
+  if (typeof hint !== 'string') return null
+  const path = resolve(hint)
+  if (basename(path) !== filename) return null
+  if (dirname(dirname(path)) !== resolve(root)) return null
+  return deps.fileExists(path) ? path : null
+}
+
+/** Said at most once an hour: the walk refusing is otherwise silent, and it was for 26 hours. */
+let lastOverflowWarnAt = 0
+function warnClaudeProjectsOverflow(root: string, count: number): void {
+  const now = Date.now()
+  if (now - lastOverflowWarnAt < 60 * 60_000) return
+  lastOverflowWarnAt = now
+  console.warn(`[native-head] ${count} folders in ${root}, over the ${MAX_CLAUDE_PROJECT_DIRS} walk limit: Claude sessions without a hook-reported transcript read as missing`)
+}
+
+/** Where index.ts registers the hook lookup, so every `realNativeHeadDeps()` gets it. */
+let claudeTranscriptHintSource: ((sessionId: string) => string | null) | null = null
+export function registerClaudeTranscriptHint(read: ((sessionId: string) => string | null) | null): void {
+  claudeTranscriptHintSource = read
+}
+
 function cursorAgentTranscriptPath(threadId: string, deps: NativeHeadDeps): string | null {
   return cursorTranscriptPath(threadId, deps.dirs.cursorProjectsDir)
 }
@@ -414,10 +464,16 @@ function claudeTranscriptPath(threadId: string, deps: NativeHeadDeps): string |
   const root = deps.dirs.claudeProjectsDir
   if (!deps.dirExists(root)) return null
 
+  const filename = `${threadId}.jsonl`
+  const hinted = hintedClaudeTranscript(filename, root, threadId, deps)
+  if (hinted !== null) return hinted
+
   const folders = deps.readDir(root)
-  if (folders.length > MAX_CLAUDE_PROJECT_DIRS) return null
+  if (folders.length > MAX_CLAUDE_PROJECT_DIRS) {
+    warnClaudeProjectsOverflow(root, folders.length)
+    return null
+  }
 
-  const filename = `${threadId}.jsonl`
   let found: string | null = null
   for (const folder of folders) {
     const candidate = join(root, folder, filename)
@@ -660,5 +716,8 @@ function readTail(path: string, maxBytes: number): TailRead | null {
 }
 
 export function realNativeHeadDeps(dirs: NativeHeadDirs = realNativeHeadDirs()): NativeHeadDeps {
-  return { dirs, dirExists, readDir, fileExists, readTail }
+  return {
+    dirs, dirExists, readDir, fileExists, readTail,
+    claudeTranscriptHint: sessionId => (claudeTranscriptHintSource === null ? null : claudeTranscriptHintSource(sessionId)),
+  }
 }