refactor(ai-vault): group scanner modules by defining owner (#41520)

* refactor(ai-vault): group scanner modules by defining owner

* refactor(ai-vault): consolidate owner imports and isolate path absence

* Preserve mobile CI triggers for extracted absence predicate
This commit is contained in:
Neil
2026-11-12 03:44:09 -08:00
committed by GitHub
parent 0be9bc607b
commit 9eb2195c64
314 changed files with 1766 additions and 4926 deletions
+118 -2
View File
@@ -54,7 +54,65 @@ on:
- 'src/main/codex/structured/journal/codex-goal-journal-rows.ts'
- 'src/main/codex/__fixtures__/codex-hook-outcomes.jsonl'
- 'src/main/ai-vault/session-scanner-*.ts'
- 'src/main/ai-vault/ai-vault-scan-cancellation.ts'
- 'src/main/ai-vault/discovery/agent-session-directories.ts'
- 'src/main/ai-vault/discovery/session-file-discovery.ts'
- 'src/main/ai-vault/discovery/session-json-file.ts'
- 'src/main/ai-vault/discovery/session-path-absence.ts'
- 'src/main/ai-vault/discovery/session-scanner-agent-root-overrides.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-agent-sources.ts'
- 'src/main/ai-vault/discovery/session-scanner-candidates.ts'
- 'src/main/ai-vault/discovery/session-scanner-directory-reader.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-discovery-pipeline.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-discovery.ts'
- 'src/main/ai-vault/discovery/session-scanner-roots.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-roots.ts'
- 'src/main/ai-vault/discovery/session-scanner-source-discovery.ts'
- 'src/main/ai-vault/parsing/session-json-object.ts'
- 'src/main/ai-vault/parsing/session-record-fields.ts'
- 'src/main/ai-vault/parsing/session-record-time.ts'
- 'src/main/ai-vault/parsing/session-scanner-accumulator.ts'
- 'src/main/ai-vault/parsing/session-scanner-agent-parser.ts'
- 'src/main/ai-vault/parsing/session-scanner-candidate-parse.ts'
- 'src/main/ai-vault/parsing/session-scanner-conversation-name-requests.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-core-parser-wsl-stall.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-injected-title.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-jsonl-reader.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-jsonl-reader.ts'
- 'src/main/ai-vault/parsing/session-scanner-messages.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-messages.ts'
- 'src/main/ai-vault/parsing/session-scanner-parse-wsl-stall.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-parser-stream-cleanup.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-record-budget.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-recoverable-empty.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-text-normalization.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-text-normalization.ts'
- 'src/main/ai-vault/parsing/session-scanner-timeline.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-token-values.ts'
- 'src/main/ai-vault/parsing/session-scanner-unlimited-dedup.test.ts'
- 'src/main/ai-vault/prompts/session-scanner-first-user-prompt-capture.ts'
- 'src/main/ai-vault/prompts/session-scanner-first-user-prompt.test.ts'
- 'src/main/ai-vault/prompts/session-scanner-first-user-prompt.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-document-agent-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-every-agent-fixture.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-incremental-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-log-agent-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-prime-agent-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-test-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-vault-roots.ts'
- 'src/main/ai-vault/scanners/copilot/session-scanner-copilot-parser.ts'
- 'src/main/ai-vault/scanners/opencode/session-scanner-opencode-parser.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-discovery.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-inventory.test.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-inventory.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-only.test.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-walk.test.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-walk.ts'
- 'src/main/ai-vault/scope/session-scanner-scope.test.ts'
- 'src/main/ai-vault/session-scanner.ts'
- 'src/shared/error-message.ts'
- 'src/shared/surrogate-safe-text-slice.ts'
- 'src/shared/trimmed-string.ts'
- 'src/main/ai-vault/scan-lifecycle/ai-vault-scan-cancellation.ts'
- 'src/main/ai-vault/scan-service/session-scanner-service-env.ts'
- 'src/main/ai-vault/scanners/grok/session-scanner-grok-user-text.ts'
- 'src/main/provider-process/provider-json-record.ts'
@@ -142,7 +200,65 @@ on:
- 'src/main/codex/structured/journal/codex-goal-journal-rows.ts'
- 'src/main/codex/__fixtures__/codex-hook-outcomes.jsonl'
- 'src/main/ai-vault/session-scanner-*.ts'
- 'src/main/ai-vault/ai-vault-scan-cancellation.ts'
- 'src/main/ai-vault/discovery/agent-session-directories.ts'
- 'src/main/ai-vault/discovery/session-file-discovery.ts'
- 'src/main/ai-vault/discovery/session-json-file.ts'
- 'src/main/ai-vault/discovery/session-path-absence.ts'
- 'src/main/ai-vault/discovery/session-scanner-agent-root-overrides.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-agent-sources.ts'
- 'src/main/ai-vault/discovery/session-scanner-candidates.ts'
- 'src/main/ai-vault/discovery/session-scanner-directory-reader.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-discovery-pipeline.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-discovery.ts'
- 'src/main/ai-vault/discovery/session-scanner-roots.test.ts'
- 'src/main/ai-vault/discovery/session-scanner-roots.ts'
- 'src/main/ai-vault/discovery/session-scanner-source-discovery.ts'
- 'src/main/ai-vault/parsing/session-json-object.ts'
- 'src/main/ai-vault/parsing/session-record-fields.ts'
- 'src/main/ai-vault/parsing/session-record-time.ts'
- 'src/main/ai-vault/parsing/session-scanner-accumulator.ts'
- 'src/main/ai-vault/parsing/session-scanner-agent-parser.ts'
- 'src/main/ai-vault/parsing/session-scanner-candidate-parse.ts'
- 'src/main/ai-vault/parsing/session-scanner-conversation-name-requests.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-core-parser-wsl-stall.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-injected-title.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-jsonl-reader.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-jsonl-reader.ts'
- 'src/main/ai-vault/parsing/session-scanner-messages.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-messages.ts'
- 'src/main/ai-vault/parsing/session-scanner-parse-wsl-stall.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-parser-stream-cleanup.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-record-budget.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-recoverable-empty.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-text-normalization.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-text-normalization.ts'
- 'src/main/ai-vault/parsing/session-scanner-timeline.test.ts'
- 'src/main/ai-vault/parsing/session-scanner-token-values.ts'
- 'src/main/ai-vault/parsing/session-scanner-unlimited-dedup.test.ts'
- 'src/main/ai-vault/prompts/session-scanner-first-user-prompt-capture.ts'
- 'src/main/ai-vault/prompts/session-scanner-first-user-prompt.test.ts'
- 'src/main/ai-vault/prompts/session-scanner-first-user-prompt.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-document-agent-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-every-agent-fixture.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-incremental-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-log-agent-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-prime-agent-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-test-fixtures.ts'
- 'src/main/ai-vault/scanner-fixtures/session-scanner-vault-roots.ts'
- 'src/main/ai-vault/scanners/copilot/session-scanner-copilot-parser.ts'
- 'src/main/ai-vault/scanners/opencode/session-scanner-opencode-parser.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-discovery.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-inventory.test.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-inventory.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-only.test.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-walk.test.ts'
- 'src/main/ai-vault/scope/session-scanner-scope-walk.ts'
- 'src/main/ai-vault/scope/session-scanner-scope.test.ts'
- 'src/main/ai-vault/session-scanner.ts'
- 'src/shared/error-message.ts'
- 'src/shared/surrogate-safe-text-slice.ts'
- 'src/shared/trimmed-string.ts'
- 'src/main/ai-vault/scan-lifecycle/ai-vault-scan-cancellation.ts'
- 'src/main/ai-vault/scan-service/session-scanner-service-env.ts'
- 'src/main/ai-vault/scanners/grok/session-scanner-grok-user-text.ts'
- 'src/main/provider-process/provider-json-record.ts'
-1
View File
@@ -408,7 +408,6 @@
2 test-no-wall-clock:src/main/ai-vault/scanners/cursor/session-scanner-cursor-chat-meta.test.ts
1 test-no-wall-clock:src/main/ai-vault/scanners/devin/session-scanner-devin-db.test.ts
2 test-no-wall-clock:src/main/ai-vault/scanners/grok/session-scanner-grok-parser.test.ts
1 test-no-wall-clock:src/main/ai-vault/scanners/kimi/session-scanner-kimi-parser.test.ts
1 test-no-wall-clock:src/main/ai-vault/scanners/opencode/reader-transport/session-scanner-opencode-sqlite-process.test.ts
2 test-no-wall-clock:src/main/ai-vault/scanners/opencode/session-scanner-opencode-parser.test.ts
2 test-no-wall-clock:src/main/antigravity/posix-hook-invocation.test.ts
@@ -5,7 +5,7 @@ import { buildCounterbalancedSchedule } from '../measurement/counterbalanced-ben
const bundled = await build({
stdin: {
contents: "export * from './src/main/ai-vault/session-root-dedup.ts'",
contents: "export * from './src/main/ai-vault/parsing/session-root-dedup.ts'",
resolveDir: process.cwd(),
loader: 'ts'
},
@@ -32,10 +32,10 @@ async function load(contents) {
return import(`data:text/javascript;base64,${encoded}`)
}
const [baselineModule, currentModule] = await Promise.all([
load(`import { sessionSortTime } from './session-scanner-accumulator';
load(`import { sessionSortTime } from './parsing/session-scanner-accumulator';
export ${baselineFunction.getText(baselineSource)}`),
load(`export { canStopParsingSessions } from './session-scan-cutoff';
export { ScannedSessionCollection } from './session-root-dedup';`)
load(`export { canStopParsingSessions } from './parsing/session-scan-cutoff';
export { ScannedSessionCollection } from './parsing/session-root-dedup';`)
])
const baseline = baselineModule.canStopParsingSessions
const current = currentModule.canStopParsingSessions
@@ -1,28 +1,81 @@
import assert from 'node:assert/strict'
import { readFileSync } from 'node:fs'
import { dirname, resolve } from 'node:path'
import { mkdtemp, rm, writeFile } from 'node:fs/promises'
import { createRequire } from 'node:module'
import { tmpdir } from 'node:os'
import { dirname, join, resolve } from 'node:path'
import { performance } from 'node:perf_hooks'
import { build } from 'esbuild'
import { buildCounterbalancedSchedule } from '../measurement/counterbalanced-benchmark-schedule.mjs'
import { summarizeBenchmarkSamples } from '../measurement/benchmark-sample-summary.mjs'
import ts from 'typescript-api'
const baselineSourcePathArgument = process.argv.find((arg) =>
arg.startsWith('--baseline-source-path=')
)
const baselineSourcePath = resolve(
baselineSourcePathArgument?.slice('--baseline-source-path='.length) ??
'src/main/ai-vault/session-scanner-accumulator.ts'
)
function retargetLegacyAccumulatorValueImports(source) {
const program = ts.createSourceFile(baselineSourcePath, source, ts.ScriptTarget.Latest, true)
assert.equal(program.parseDiagnostics.length, 0, 'Baseline source must parse')
const replacements = []
for (const statement of program.statements) {
if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
continue
}
if (
resolve(dirname(baselineSourcePath), statement.moduleSpecifier.text) !==
resolve('src/main/ai-vault/session-scanner-values')
) {
continue
}
const clause = statement.importClause
assert(
clause && !clause.name && clause.namedBindings && ts.isNamedImports(clause.namedBindings)
)
const imports = clause.namedBindings.elements.map((binding) => {
const name = (binding.propertyName ?? binding.name).text
const owner =
name === 'extractString'
? 'src/shared/trimmed-string.ts'
: name === 'timestampMs'
? 'src/main/ai-vault/parsing/session-record-time.ts'
: null
assert(owner, `Unsupported historical accumulator value import: ${name}`)
return `import ${clause.isTypeOnly ? 'type ' : ''}{ ${binding.getText(program)} } from ${JSON.stringify(resolve(owner))}`
})
replacements.push({
start: statement.getStart(program),
end: statement.end,
text: imports.join('\n')
})
}
for (const replacement of replacements.toReversed()) {
source = source.slice(0, replacement.start) + replacement.text + source.slice(replacement.end)
}
return source
}
// git show <ref>:src/main/ai-vault/session-scanner-accumulator.ts | node config/scripts/session-timeline-benchmark.mjs
const target = resolve('src/main/ai-vault/session-scanner-accumulator.ts')
async function load(source) {
const target = resolve('src/main/ai-vault/parsing/session-scanner-accumulator.ts')
async function load(source, sourcePath = target) {
const result = await build({
stdin: {
contents: `
export {createAccumulator, cloneSessionAccumulator, updateTimeline, finalizeSession}
from './session-scanner-accumulator';
export {createClaudeSessionParseState, consumeClaudeSessionLine}
from './session-scanner-primary-parsers';`,
from '../scanners/claude/session-scanner-primary-parsers';`,
loader: 'ts',
resolveDir: dirname(target)
},
bundle: true,
write: false,
platform: 'node',
format: 'esm',
format: 'cjs',
plugins: [
{
name: 'timeline-baseline',
@@ -30,18 +83,26 @@ async function load(source) {
plugin.onLoad({ filter: /session-scanner-accumulator\.ts$/ }, () => ({
contents: source,
loader: 'ts',
resolveDir: dirname(target)
resolveDir: dirname(sourcePath)
}))
}
}
]
})
return import(
`data:text/javascript;base64,${Buffer.from(result.outputFiles[0].text).toString('base64')}`
)
const directory = await mkdtemp(join(tmpdir(), 'orca-session-timeline-'))
try {
const file = join(directory, 'timeline.cjs')
await writeFile(file, result.outputFiles[0].text)
return createRequire(import.meta.url)(file)
} finally {
await rm(directory, { recursive: true, force: true })
}
}
const implementations = {
before: await load(readFileSync(0, 'utf8')),
before: await load(
retargetLegacyAccumulatorValueImports(readFileSync(0, 'utf8')),
baselineSourcePath
),
after: await load(readFileSync(target, 'utf8'))
}
const file = { path: 'timeline.jsonl', mtimeMs: 0, modifiedAt: '2026-01-01T00:00:00.000Z' }
@@ -12,12 +12,11 @@ const NODE_RUNTIME_INCLUDE = [
'tests/e2e/cursor-quota-transport.unit.test.ts',
'tests/e2e/helpers/electron-process-shutdown.unit.test.ts',
'src/main/ai-vault-search/storage/session-search-index-writer.test.ts',
'src/main/ai-vault/session-scanner-unlimited-dedup.test.ts',
'src/main/ai-vault/parsing/session-scanner-unlimited-dedup.test.ts',
// The parse cache persists through node:sqlite.
'src/main/ai-vault/parse-cache/session-parse-cache-antigravity-upgrade.test.ts',
'src/main/ai-vault/parse-cache/session-parse-cache-persistence.test.ts',
'src/main/ai-vault/session-scanner-scope-cwd-facts.test.ts',
'src/main/ai-vault/session-scanner-scope-walk.test.ts',
'src/main/ai-vault/scope/session-scanner-scope-walk.test.ts',
// The forced-probe handoff race opens only under V8's promise scheduling, which Electron main uses.
'src/main/github/rate-limit.test.ts',
// Electron main bridges streams with Node's implementation.
@@ -241,7 +241,7 @@ const CROSS_VERSION_WIRE_PREFIXES = [
'src/shared/agent-session-record',
'src/shared/agent-session-provider-handle',
'src/shared/agent-session/journal/',
'src/main/ai-vault/structured-session-ownership.ts',
'src/main/ai-vault/structured-sessions/structured-session-ownership.ts',
'src/main/native-chat/agent-session-journal/',
'src/main/native-chat/agent-session-wire/',
// The released phone contract runs the current discovery owner and Claude producer.
@@ -1,8 +1,8 @@
import type { AiVaultScanIssue } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { AI_VAULT_AGENT_SOURCES } from '../../ai-vault/session-scanner-agent-sources'
import { normalizedWslHomeDirs } from '../../ai-vault/session-scanner-roots'
import { sessionCandidatesFromDiscoveries } from '../../ai-vault/session-scanner-candidates'
import { discoverAiVaultSessionSources } from '../../ai-vault/session-scanner-source-discovery'
import { AI_VAULT_AGENT_SOURCES } from '../../ai-vault/discovery/session-scanner-agent-sources'
import { normalizedWslHomeDirs } from '../../ai-vault/discovery/session-scanner-roots'
import { sessionCandidatesFromDiscoveries } from '../../ai-vault/discovery/session-scanner-candidates'
import { discoverAiVaultSessionSources } from '../../ai-vault/discovery/session-scanner-source-discovery'
import type {
AiVaultScanOptions,
SessionFileCandidate,
@@ -1,4 +1,4 @@
import { throwIfAiVaultScanCancelled } from '../../ai-vault/ai-vault-scan-cancellation'
import { throwIfAiVaultScanCancelled } from '../../ai-vault/scan-lifecycle/ai-vault-scan-cancellation'
import {
createSessionParseStats,
parseAgentSessionFileCached,
@@ -3,7 +3,7 @@ import { mkdir, mkdtemp, rename, rm, stat, utimes, writeFile } from 'node:fs/pro
import { tmpdir } from 'node:os'
import { dirname, join } from 'node:path'
import SyncDatabase from '../../sqlite/sync-database'
import { isolatedScanRoots } from '../../ai-vault/session-scanner-test-fixtures'
import { isolatedScanRoots } from '../../ai-vault/scanner-fixtures/session-scanner-test-fixtures'
import type { SessionSearchClock, SessionSearchTimerHandle } from './session-search-clock'
import type { SessionSearchScanRoots } from '../discovery/session-search-scan-roots'
import { assistantRecord, userRecord } from './session-search-transcript-fixtures'
@@ -3,7 +3,7 @@ import {
cursorChatMetaRefusals,
withCursorChatMetaScan
} from '../../ai-vault/scanners/cursor/session-scanner-cursor-chat-meta'
import { recordSessionScanIssue } from '../../ai-vault/session-scan-issues'
import { recordSessionScanIssue } from '../../ai-vault/parsing/session-scan-issues'
import {
mergeDegradedRoots,
scanIssueDegradedRoots,
@@ -1,6 +1,6 @@
import type SyncDatabase from '../../sqlite/sync-database'
import type { TranscriptMessageRole } from '../../ai-vault/transcripts/session-transcript-consumers'
import '../../ai-vault/session-scanner-text-normalization'
import '../../ai-vault/parsing/session-scanner-text-normalization'
import { sliceAtCodeUnitLimit } from '../../../shared/surrogate-safe-text-slice'
import {
hasAiVaultSearchQueryOperators,
@@ -14,7 +14,7 @@ import { resetSessionSearchPolicyForTests } from './session-search-policy'
import { resetSessionSearchServiceInitForTests } from './session-search-service-init'
const localAiVaultScanRoots = vi.hoisted(() => vi.fn())
vi.mock('../ai-vault/cached-session-list', async (importOriginal) => ({
vi.mock('../ai-vault/discovery/ai-vault-scan-roots', async (importOriginal) => ({
...(await importOriginal<object>()),
localAiVaultScanRoots
}))
@@ -1,4 +1,4 @@
import { abandonRemoteSessionScanOnCancel } from '../ai-vault/ai-vault-scan-cancellation'
import { abandonRemoteSessionScanOnCancel } from '../ai-vault/scan-lifecycle/ai-vault-scan-cancellation'
/** Cleanup continues after a caller leaves; native retirement must never extend an IPC deadline. */
export async function withinSessionSearchDeadline<T>(
@@ -2,7 +2,7 @@ import { removeTree } from '../../../shared/windows-transient-lock-removal'
import { randomUUID } from 'node:crypto'
import type SyncDatabase from '../../sqlite/sync-database'
import { openVersionedCacheDatabase } from '../../sqlite/versioned-cache-database'
import { asRecord } from '../../ai-vault/session-scanner-record-value'
import { asRecord } from '../../ai-vault/parsing/session-record-fields'
// Cache transcript content verbatim; outbound snippet policy belongs at the transport boundary.
@@ -6,7 +6,7 @@ import type {
SessionSearchStateCounts
} from './session-search-store-types'
import type SyncDatabase from '../../sqlite/sync-database'
import { asRecord } from '../../ai-vault/session-scanner-record-value'
import { asRecord } from '../../ai-vault/parsing/session-record-fields'
import type { SessionFileCandidate } from '../../ai-vault/session-scanner-types'
import type { TranscriptSessionIdentity } from '../../ai-vault/transcripts/session-transcript-consumers'
import {
@@ -1,7 +1,7 @@
import {
createAiVaultScanCancelledError,
abandonRemoteSessionScanOnCancel
} from '../../ai-vault/ai-vault-scan-cancellation'
} from '../../ai-vault/scan-lifecycle/ai-vault-scan-cancellation'
import {
SessionSearchWorkerClient,
SessionSearchOperationError
@@ -8,7 +8,7 @@ import type {
import {
createAiVaultScanCancelledError,
abandonRemoteSessionScanOnCancel
} from '../../ai-vault/ai-vault-scan-cancellation'
} from '../../ai-vault/scan-lifecycle/ai-vault-scan-cancellation'
import { EMPTY_CONTENT_HASH, foldContentHash } from '../storage/session-search-content-hash'
import { searchMessageRows } from '../storage/session-search-message-rows'
import type { SessionSearchFileWrite } from '../storage/session-search-index-writer'
@@ -1,187 +0,0 @@
import { mkdtemp, rm, utimes } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { basename, join } from 'node:path'
import { afterEach, expect, it, vi } from 'vitest'
import type { AiVaultScanWork } from '../../shared/ai-vault/scanning/ai-vault-scan-progress'
import { resetLocalAiVaultScanProgressForTests } from './ai-vault-local-scan-progress'
import * as parseCache from './parse-cache/session-scanner-parse-cache'
import * as transcriptFs from '../native-chat/wsl-transcript-fs-access'
import { aiVaultScanWork, trackAiVaultScanProgress } from './ai-vault-scan-progress'
import { scanAiVaultSessions } from './session-scanner'
import { resetSessionParseCacheForTests } from './parse-cache/session-parse-cache-store'
import { isolatedScanRoots, writeJsonlFile } from './session-scanner-test-fixtures'
// Source fixtures exercise the real SQLite readers without a packaged worker bundle.
vi.mock(
'./scanners/opencode/reader-transport/session-scanner-opencode-sqlite-worker-spawn',
async () => {
const { listOpenCodeSqliteSessions } =
await import('./scanners/opencode/sqlite/session-scanner-opencode-sqlite-list')
const { listOpenCode2SqliteSessions } =
await import('./scanners/opencode2/session-scanner-opencode2-sqlite-list')
const { parseOpenCodeSqliteSession } =
await import('./scanners/opencode/sqlite/session-scanner-opencode-sqlite')
return {
listOpenCode2SqliteSessionsViaWorker: listOpenCode2SqliteSessions,
listOpenCodeSqliteSessionsViaWorker: listOpenCodeSqliteSessions,
listZcodeSqliteSessionsViaWorker: (args: Parameters<typeof listOpenCodeSqliteSessions>[0]) =>
listOpenCodeSqliteSessions({ ...args, agent: 'zcode' }),
parseOpenCodeSqliteSessionViaWorker: parseOpenCodeSqliteSession
}
}
)
let tempRoot: string | null = null
afterEach(async () => {
vi.useRealTimers()
vi.restoreAllMocks()
resetSessionParseCacheForTests()
resetLocalAiVaultScanProgressForTests()
if (tempRoot) {
await rm(tempRoot, { recursive: true, force: true })
tempRoot = null
}
})
it.each(['cutoff', 'bucket', 'filtered'] as const)(
'freezes %s work without changing cold/warm execution',
async (flow) => {
tempRoot = await mkdtemp(join(tmpdir(), 'orca-scan-frozen-'))
const roots = isolatedScanRoots(tempRoot)
for (let index = 0; index < (flow === 'filtered' ? 27 : 6); index++) {
const timestamp = new Date(Date.UTC(2026, 9, 19) - index * 60_000).toISOString()
const cwd =
index >= 3 && (flow === 'bucket' || (index - 3) % 8 === 0) ? '/repo' : '/elsewhere'
const path =
flow === 'filtered'
? join(roots.codexSessionsDir, `rollout-${index}.jsonl`)
: join(
roots.claudeProjectsDir,
cwd === '/repo' ? '-repo' : '-elsewhere',
`${index}.jsonl`
)
await writeJsonlFile(
path,
flow === 'filtered'
? [
{ timestamp, type: 'session_meta', payload: { id: `fixture-${index}`, cwd } },
{
timestamp,
type: 'event_msg',
payload: { type: 'user_message', message: `Generated ${index}` }
}
]
: [
{
type: 'user',
sessionId: `fixture-${index}`,
timestamp,
cwd,
message: { role: 'user', content: `Generated ${index}` }
}
]
)
await utimes(path, Date.parse(timestamp) / 1000, Date.parse(timestamp) / 1000)
}
const listed = vi.spyOn(parseCache, 'parseListedSessionFile')
const walked = vi.spyOn(parseCache, 'parseAgentSessionFileCached')
const stats = vi.spyOn(parseCache, 'createSessionParseStats')
const opened = vi.spyOn(transcriptFs, 'openTranscriptReadStream')
const ids =
flow === 'cutoff'
? [0, 1, 2]
: flow === 'filtered'
? [0, 1, 2, 3, 11, 19]
: [0, 1, 2, 3, 4, 5]
for (const warm of [false, true]) {
const reports: AiVaultScanWork[] = []
const signal = new AbortController().signal
let now = 0
const stop = trackAiVaultScanProgress(
signal,
(work) => reports.push(work),
() => (now += 1000)
)
try {
const result = await scanAiVaultSessions({
...roots,
platform: 'darwin',
limit: 3,
limitPerAgent: 50,
signal,
...(flow === 'cutoff' ? {} : { scopePaths: ['/repo'] })
})
expect(result.issues).toEqual([])
expect(result.sessions.map((row) => row.sessionId)).toEqual(
ids.map((id) => `fixture-${id}`)
)
const attempts = [...listed.mock.calls, ...walked.mock.calls].map(
([candidate]) => candidate.file.path
)
expect(
attempts.map((path) =>
Number(basename(path).replace('rollout-', '').replace('.jsonl', ''))
)
).toEqual(ids)
expect(opened.mock.calls).toHaveLength(warm ? 0 : flow === 'bucket' ? 7 : ids.length)
expect(stats.mock.results.at(-1)?.value).toEqual({
reused: warm ? ids.length : 0,
incremental: 0,
fullParses: warm ? 0 : ids.length,
earlyStopped: 0,
bytesRead: warm ? 0 : flow === 'filtered' ? 1363 : flow === 'bucket' ? 873 : 444
})
const reading = reports.filter((work) => work.stage === 'reading')
const total = flow === 'filtered' ? 27 : 6
let settled = 0
for (const work of reading) {
expect(work.read.total).toBe(total)
expect(work.read.done + (work.read.skipped ?? 0)).toBeGreaterThanOrEqual(settled)
settled = work.read.done + (work.read.skipped ?? 0)
expect(work.agents.reduce((sum, agent) => sum + (agent.read?.total ?? 0), 0)).toBe(total)
expect(work.agents.reduce((sum, agent) => sum + (agent.read?.done ?? 0), 0)).toBe(
work.read.done
)
expect(work.agents.reduce((sum, agent) => sum + (agent.read?.skipped ?? 0), 0)).toBe(
work.read.skipped
)
}
expect(aiVaultScanWork(signal)?.read).toEqual({
done: ids.length,
total,
skipped: total - ids.length
})
} finally {
stop()
}
listed.mockClear()
walked.mockClear()
opened.mockClear()
}
}
)
it('does not settle a batch interrupted during its real parser invocation', async () => {
tempRoot = await mkdtemp(join(tmpdir(), 'orca-scan-abort-'))
const roots = isolatedScanRoots(tempRoot)
await writeJsonlFile(join(roots.claudeProjectsDir, 'project', 'a.jsonl'), [
{ type: 'user', sessionId: 'a', message: { role: 'user', content: 'Generated' } }
])
const controller = new AbortController()
const original = parseCache.parseListedSessionFile
vi.spyOn(parseCache, 'parseListedSessionFile').mockImplementation(async (...args) => {
const result = await original(...args)
controller.abort()
return result
})
const stop = trackAiVaultScanProgress(controller.signal, () => undefined)
try {
await expect(
scanAiVaultSessions({ ...roots, signal: controller.signal })
).rejects.toMatchObject({ name: 'AbortError' })
expect(aiVaultScanWork(controller.signal)?.read).toEqual({ done: 0, total: 1, skipped: 0 })
} finally {
stop()
}
})
@@ -1,14 +1,15 @@
import { rm } from 'node:fs/promises'
import { getAiVaultWslHomeDirs, invalidateAiVaultSessionListCache } from './cached-session-list'
import { getAiVaultWslHomeDirs } from '../discovery/ai-vault-scan-roots'
import { invalidateAiVaultSessionListCache } from '../listing/cached-session-list'
import { deleteAiVaultSessionFile, type AiVaultSessionPathRemover } from './session-delete'
import { invalidateSessionParseCacheEntry } from './parse-cache/session-parse-cache-store'
import { invalidateAiVaultBackgroundCache } from './scan-service/session-scanner-background'
import type { AiVaultAgent } from '../../shared/ai-vault/contracts/ai-vault-types'
import { LOCAL_EXECUTION_HOST_ID } from '../../shared/execution-host'
import { invalidateSessionParseCacheEntry } from '../parse-cache/session-parse-cache-store'
import { invalidateAiVaultBackgroundCache } from '../scan-service/session-scanner-background'
import type { AiVaultAgent } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { LOCAL_EXECUTION_HOST_ID } from '../../../shared/execution-host'
import type {
AiVaultDeleteSessionArgs,
AiVaultDeleteSessionResult
} from '../../shared/ai-vault/contracts/ai-vault-session-deletion'
} from '../../../shared/ai-vault/contracts/ai-vault-session-deletion'
export type HostAiVaultSessionDeleteDeps = {
removePath: AiVaultSessionPathRemover
@@ -1,5 +1,5 @@
import { basename, dirname, extname, join, resolve } from 'node:path'
import type { AiVaultAgent } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultAgent } from '../../../shared/ai-vault/contracts/ai-vault-types'
import {
isAiVaultDeletableAgent,
isAiVaultSyntheticSessionPath,
@@ -7,20 +7,20 @@ import {
type AiVaultSessionDeleteRejectionCode,
type AiVaultSessionDeleteRemoval,
type AiVaultSessionDeleteValidationResult
} from '../../shared/ai-vault/contracts/ai-vault-session-deletion'
} from '../../../shared/ai-vault/contracts/ai-vault-session-deletion'
import {
LOCAL_EXECUTION_HOST_ID,
normalizeExecutionHostId,
type ExecutionHostId
} from '../../shared/execution-host'
import { isPathInsideOrEqual } from '../../shared/cross-platform-path'
} from '../../../shared/execution-host'
import { isPathInsideOrEqual } from '../../../shared/cross-platform-path'
import {
AI_VAULT_AGENT_SOURCES,
isDiscoverableSessionFile,
sessionRowRootDirs
} from './session-scanner-agent-sources'
import { subagentTranscriptsDirFor } from './scanners/claude/session-scanner-subagent-transcripts'
import type { AiVaultScanOptions } from './session-scanner-types'
} from '../discovery/session-scanner-agent-sources'
import { isDiscoverableSessionFile } from '../discovery/session-file-discovery'
import { subagentTranscriptsDirFor } from '../scanners/claude/session-scanner-subagent-transcripts'
import type { AiVaultScanOptions } from '../session-scanner-types'
// These sessions own their containing directory, including companion files.
const AI_VAULT_WHOLE_DIRECTORY_DELETE_AGENTS = new Set<AiVaultDeletableAgent>([
@@ -2,14 +2,14 @@ import { lstat, realpath } from 'node:fs/promises'
import type {
AiVaultDeleteSessionResult,
AiVaultSessionDeleteRemoval
} from '../../shared/ai-vault/contracts/ai-vault-session-deletion'
import { isPathInsideOrEqual } from '../../shared/cross-platform-path'
} from '../../../shared/ai-vault/contracts/ai-vault-session-deletion'
import { isPathInsideOrEqual } from '../../../shared/cross-platform-path'
import {
validateAiVaultSessionDeleteTarget,
type ValidateAiVaultSessionDeleteTargetArgs
} from './session-delete-target'
import { tryDeleteWslUncPath, WslDeleteValidationError } from '../wsl/filesystem/wsl-unc-delete'
import { isENOENT } from '../ipc/filesystem/access/filesystem-path-containment'
import { tryDeleteWslUncPath, WslDeleteValidationError } from '../../wsl/filesystem/wsl-unc-delete'
import { isENOENT } from '../../ipc/filesystem/access/filesystem-path-containment'
/** Desktop moves to Trash; a plain-Node host has none, so it removes permanently after the user confirmed. */
export type AiVaultSessionPathRemover = (removal: AiVaultSessionDeleteRemoval) => Promise<void>
@@ -0,0 +1,54 @@
import { homedir } from 'node:os'
import { basename, join } from 'node:path'
import { resolveAbsoluteDirOverride } from '../../../shared/absolute-dir-override'
// Accept Pi/OMP home, agent, or sessions paths.
export function normalizeAgentSessionsDir(
rawValue: string,
agentHomeDirName: '.pi' | '.omp'
): string {
const trimmed = rawValue.trim()
if (!trimmed) {
return join(homedir(), agentHomeDirName, 'agent', 'sessions')
}
const normalized = trimmed.replace(/[\\/]+$/, '')
const leaf = basename(normalized)
if (leaf === 'sessions') {
return normalized
}
if (leaf === 'agent') {
return join(normalized, 'sessions')
}
if (leaf === agentHomeDirName) {
return join(normalized, 'agent', 'sessions')
}
return normalized
}
function defaultPrimeAgentSessionsDir(): string {
return join(homedir(), '.prime', 'agent', 'sessions')
}
// Pi/Prime expand leading ~ themselves; other CLIs such as Grok treat it literally.
function absoluteConfiguredDir(rawValue: string): string | null {
const expanded = rawValue === '~' ? homedir() : rawValue.replace(/^~(?=[\\/])/, homedir())
const normalized = expanded.replace(/[\\/]+$/, '')
return resolveAbsoluteDirOverride(normalized, '') || null
}
// Prime always appends sessions, even when the configured agent directory is named sessions.
export function normalizePrimeAgentSessionsDir(rawAgentDir: string): string {
const agentDir = absoluteConfiguredDir(rawAgentDir.trim())
return agentDir ? join(agentDir, 'sessions') : defaultPrimeAgentSessionsDir()
}
// Explicit session-root overrides outrank the agent directory and are used verbatim.
export function primeAgentSessionsDirFromEnv(env: NodeJS.ProcessEnv = process.env): string {
const sessionDir =
env.PRIME_AGENT_SESSION_DIR?.trim() || env.PRIME_AGENT_CODING_AGENT_SESSION_DIR?.trim()
if (sessionDir) {
return absoluteConfiguredDir(sessionDir) ?? defaultPrimeAgentSessionsDir()
}
const agentDir = env.PRIME_AGENT_CODING_AGENT_DIR?.trim()
return agentDir ? normalizePrimeAgentSessionsDir(agentDir) : defaultPrimeAgentSessionsDir()
}
@@ -1,18 +1,18 @@
import { join } from 'node:path'
import { isWslUncPath } from '../../shared/wsl-paths'
import { LOCAL_EXECUTION_HOST_ID } from '../../shared/execution-host'
import { claudeProfileHistoryDirs } from '../claude-accounts/profiles/routing/claude-profile-installed-router'
import { getCachedWslDistros, hasCachedWslDistros } from '../wsl/discovery/distro-catalog'
import { isWslUncPath } from '../../../shared/wsl-paths'
import { LOCAL_EXECUTION_HOST_ID } from '../../../shared/execution-host'
import { claudeProfileHistoryDirs } from '../../claude-accounts/profiles/routing/claude-profile-installed-router'
import { getCachedWslDistros, hasCachedWslDistros } from '../../wsl/discovery/distro-catalog'
import {
listLastKnownRunningWslHomeDirs,
readRunningWslHomeDirsUnlessStopped
} from '../wsl/discovery/wsl-home-unless-stopped'
import { filterPathsToRunningWslDistrosAsync } from '../wsl/filesystem/wsl-running-path-filter'
import type { AiVaultScanOptions } from './session-scanner-types'
import { managedOpenCodeAccountDataDirs } from '../opencode/accounts/opencode-managed-account-data-dirs'
import { antigravityChatBrainDir } from '../antigravity/antigravity-chat-home'
import { getProfileUserDataPath } from '../orca-profiles/profile-storage-paths'
import { prepareOpenCodeWslReaders } from './scanners/opencode/reader-transport/opencode-wsl-runtime-preparation'
} from '../../wsl/discovery/wsl-home-unless-stopped'
import { filterPathsToRunningWslDistrosAsync } from '../../wsl/filesystem/wsl-running-path-filter'
import type { AiVaultScanOptions } from '../session-scanner-types'
import { managedOpenCodeAccountDataDirs } from '../../opencode/accounts/opencode-managed-account-data-dirs'
import { antigravityChatBrainDir } from '../../antigravity/antigravity-chat-home'
import { getProfileUserDataPath } from '../../orca-profiles/profile-storage-paths'
import { prepareOpenCodeWslReaders } from '../scanners/opencode/reader-transport/opencode-wsl-runtime-preparation'
// Configure sources through the runtime service; headless serve never runs window-only IPC registration.
export type AiVaultSessionSources = {
@@ -0,0 +1,22 @@
import { wslGatedReadFile } from '../../native-chat/wsl-transcript-fs-access'
import { WslTranscriptFsError } from '../../native-chat/wsl-transcript-fs-error'
import { asRecord } from '../parsing/session-record-fields'
import { throwIfAiVaultScanCancelled } from '../scan-lifecycle/ai-vault-scan-cancellation'
export async function readJsonObjectIfExists(
filePath: string,
signal?: AbortSignal
): Promise<Record<string, unknown> | null> {
try {
const parsed: unknown = JSON.parse(await wslGatedReadFile(filePath, 'utf-8', 'scan', signal))
return asRecord(parsed)
} catch (error) {
// Propagate cancellation so it cannot be cached as absent enrichment.
throwIfAiVaultScanCancelled(signal)
// Propagate WSL refusal as an issue; caching null can prevent retries for unchanged files.
if (error instanceof WslTranscriptFsError) {
throw error
}
return null
}
}
@@ -1,4 +1,4 @@
import type { FileWithMtime } from './session-scanner-types'
import type { FileWithMtime } from '../session-scanner-types'
/** Retain only the requested newest files, preserving traversal order on ties. */
export class SessionNewestFiles {
@@ -0,0 +1,13 @@
import { WslTranscriptFsError } from '../../native-chat/wsl-transcript-fs-error'
/** A missing file or folder is absence, not a refusal; WSL gate errors are always refusals. */
export function isMissingTranscriptPathError(error: unknown): boolean {
if (error instanceof WslTranscriptFsError) {
return false
}
const code =
error && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
? error.code
: null
return code === 'ENOENT' || code === 'ENOTDIR'
}
@@ -0,0 +1,56 @@
import { homedir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it, vi } from 'vitest'
import type { AiVaultScanOptions } from '../session-scanner-types'
/** Exercise root consumers: module-time constants can bypass an otherwise correct override validator (#13082). */
const NO_OPTIONS: AiVaultScanOptions = {}
const NO_WSL: readonly string[] = []
async function rootDirsFor(
agent: 'codex' | 'copilot' | 'devin' | 'openclaw' | 'kimi' | 'grok',
env: Record<string, string>
): Promise<string[]> {
vi.resetModules()
for (const [key, value] of Object.entries(env)) {
vi.stubEnv(key, value)
}
const sources = await import('./session-scanner-agent-sources.js')
const source = sources.AI_VAULT_AGENT_SOURCES[agent]
if (!source) {
throw new Error(`no source table entry for ${agent}`)
}
return source.rootDirs(NO_OPTIONS, NO_WSL)
}
describe('agent scan roots from environment overrides', () => {
afterEach(() => {
vi.unstubAllEnvs()
vi.resetModules()
})
it('finds Devin transcripts in a relocated platform data directory', async () => {
const dataDir = join(homedir(), 'relocated-agent-data')
const roots = await rootDirsFor('devin', {
DEVIN_HOME: '',
[process.platform === 'win32' ? 'APPDATA' : 'XDG_DATA_HOME']: dataDir
})
expect(roots).toEqual(
['transcripts', 'agent_logs'].map((dir) => join(dataDir, 'devin', 'cli', dir))
)
})
it('keeps an explicit transcript root isolated and discovers both WSL layouts', async () => {
const { AI_VAULT_AGENT_SOURCES } = await import('./session-scanner-agent-sources')
const custom = join(homedir(), 'custom-devin')
const wslHome = join(homedir(), 'wsl-home')
expect(
AI_VAULT_AGENT_SOURCES.devin?.rootDirs({ devinTranscriptsDir: custom }, [wslHome])
).toEqual([
custom,
join(wslHome, '.local', 'share', 'devin', 'cli', 'transcripts'),
join(wslHome, '.local', 'share', 'devin', 'cli', 'agent_logs')
])
})
})
@@ -1,25 +1,25 @@
import { homedir } from 'node:os'
import { basename, dirname, join } from 'node:path'
import { pathSegments } from './session-file-discovery'
import { resolveAbsoluteDirOverride } from '../../shared/absolute-dir-override'
import type { AiVaultAgent } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultDeletableAgent } from '../../shared/ai-vault/contracts/ai-vault-session-deletion'
import { resolveGrokSessionsDir } from '../../shared/grok-session-paths'
import { resolveKiroHomeDir } from '../../shared/kiro-home'
import { uniqueCodexSessionsDirs } from './scanners/codex/session-scanner-codex-paths'
import { resolveAbsoluteDirOverride } from '../../../shared/absolute-dir-override'
import type { AiVaultAgent } from '../../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultDeletableAgent } from '../../../shared/ai-vault/contracts/ai-vault-session-deletion'
import { resolveGrokSessionsDir } from '../../../shared/grok-session-paths'
import { resolveKiroHomeDir } from '../../../shared/kiro-home'
import { uniqueCodexSessionsDirs } from '../scanners/codex/session-scanner-codex-paths'
import {
clineMessagesPathForMetadata,
kiroTranscriptPathForMetadata
} from '../../shared/ai-vault/session-display/ai-vault-session-log-resource'
import { isClineSessionMetadataPath } from './scanners/cline/session-scanner-cline-parser'
import { cursorChatMetaPath } from './scanners/cursor/session-scanner-cursor-chat-meta'
import { devinSessionsDbDependencyPath } from './scanners/devin/session-scanner-devin-db'
import { resolveKimiSessionsDir } from './scanners/kimi/session-scanner-kimi-paths'
import { resolveMuseSessionsDir } from '../../shared/muse-session-log'
import { isKiroSessionMetadataPath } from './scanners/kiro/session-scanner-kiro-parser'
} from '../../../shared/ai-vault/session-display/ai-vault-session-log-resource'
import { isClineSessionMetadataPath } from '../scanners/cline/session-scanner-cline-parser'
import { cursorChatMetaPath } from '../scanners/cursor/session-scanner-cursor-chat-meta'
import { devinSessionsDbDependencyPath } from '../scanners/devin/session-scanner-devin-db'
import { resolveKimiSessionsDir } from '../scanners/kimi/session-scanner-kimi-paths'
import { resolveMuseSessionsDir } from '../../../shared/muse-session-log'
import { isKiroSessionMetadataPath } from '../scanners/kiro/session-scanner-kiro-parser'
import { OPENCLAW_AGENT_SOURCE } from './scanners/openclaw/openclaw-session-layout'
import { isOmpConversationDirectory } from './scanners/omp/session-scanner-omp-subagent-transcripts'
import { OPENCLAW_AGENT_SOURCE } from '../scanners/openclaw/openclaw-session-layout'
import { isOmpConversationDirectory } from '../scanners/omp/session-scanner-omp-subagent-transcripts'
import {
claudeProjectsRootDirs,
codexHomeSessionsDir,
@@ -27,11 +27,14 @@ import {
sessionRootDirs,
wslHomeSessionDirs
} from './session-scanner-roots'
import { getHermesHome } from '../hermes/hermes-default-home'
import { isClaudeProjectBucketDirectory } from './scanners/claude/claude-project-dir-encoding'
import { SUBAGENT_DIR_NAME } from './scanners/claude/session-scanner-subagent-transcripts'
import type { AiVaultScanOptions } from './session-scanner-types'
import { normalizeAgentSessionsDir, primeAgentSessionsDirFromEnv } from './session-scanner-values'
import { getHermesHome } from '../../hermes/hermes-default-home'
import { isClaudeProjectBucketDirectory } from '../scanners/claude/claude-project-dir-encoding'
import { SUBAGENT_DIR_NAME } from '../scanners/claude/session-scanner-subagent-transcripts'
import type { AiVaultScanOptions } from '../session-scanner-types'
import {
normalizeAgentSessionsDir,
primeAgentSessionsDirFromEnv
} from './agent-session-directories'
export const DEFAULT_CODEX_HOME_DIR = join(homedir(), '.codex')
const GEMINI_SESSIONS_DIR = join(homedir(), '.gemini', 'tmp')
@@ -317,5 +320,3 @@ export function sessionRowRootDirs(
? [...roots, ...AI_VAULT_AGENT_SOURCES.pi.rootDirs(options, wslHomeDirs)]
: roots
}
export { isDiscoverableSessionFile } from './session-file-discovery'
@@ -1,19 +1,19 @@
import { prioritizeAntigravityTranscriptCandidates } from './scanners/antigravity/antigravity-transcript-candidates'
import { readCodexRolloutSessionMetaId } from '../codex/history/rollouts/codex-rollout-session-meta'
import { prioritizeAntigravityTranscriptCandidates } from '../scanners/antigravity/antigravity-transcript-candidates'
import { readCodexRolloutSessionMetaId } from '../../codex/history/rollouts/codex-rollout-session-meta'
import {
codexRolloutHardlinkIdentity,
dedupeCodexRolloutAliases,
dedupeCodexRolloutFileAliases
} from './scanners/codex/codex-session-root-dedup'
import { antigravityHistoryPathForBrainDir } from './scanners/antigravity/session-scanner-antigravity-paths'
import { codexHomeForSessionsDir } from './scanners/codex/session-scanner-codex-paths'
import { DEFAULT_CODEX_HOME_DIR } from './session-scanner-source-discovery'
} from '../scanners/codex/codex-session-root-dedup'
import { antigravityHistoryPathForBrainDir } from '../scanners/antigravity/session-scanner-antigravity-paths'
import { codexHomeForSessionsDir } from '../scanners/codex/session-scanner-codex-paths'
import { DEFAULT_CODEX_HOME_DIR } from './session-scanner-agent-sources'
import type {
AiVaultScanOptions,
FileWithMtime,
SessionFileCandidate,
SessionFileDiscovery
} from './session-scanner-types'
} from '../session-scanner-types'
export function discoveryFileCandidates(
discovery: SessionFileDiscovery,
@@ -5,7 +5,7 @@ import { tmpdir } from 'node:os'
import {
isAiVaultScanCancelledError,
type AiVaultScanIssue
} from '../../shared/ai-vault/contracts/ai-vault-types'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
const fsMocks = vi.hoisted(() => ({ readdir: vi.fn(), stat: vi.fn() }))
vi.mock('node:fs/promises', async (importOriginal) => ({
@@ -110,33 +110,6 @@ describe('fresh discovery pipeline', () => {
expect(fsMocks.stat).toHaveBeenCalledTimes(paths.length)
})
it('bounds directory and metadata reads across simultaneous roots', async () => {
const roots = Array.from({ length: 8 }, (_, index) => join(root, `root-${index}`))
await Promise.all(roots.map((directory) => createFiles(directory, 70)))
let active = 0
let peak = 0
async function tracked<T>(read: () => Promise<T>): Promise<T> {
active++
peak = Math.max(peak, active)
try {
await new Promise<void>((resolve) => setImmediate(resolve))
return await read()
} finally {
active--
}
}
fsMocks.readdir.mockImplementation((path: string, options: { withFileTypes: true }) =>
tracked(() => fs.readdir(path, options))
)
fsMocks.stat.mockImplementation((path: string) => tracked(() => fs.stat(path)))
const results = await Promise.all(roots.map((directory) => scan(directory, [], 3)))
expect(results.every((result) => result.files.length === 3)).toBe(true)
expect(peak).toBeGreaterThan(1)
expect(peak).toBeLessThanOrEqual(8)
expect(active).toBe(0)
})
it('sees file, sidecar, and nested membership changes on the next scan without notifications', async () => {
const [file] = await createFiles(root, 1)
if (!file) {
@@ -1,27 +1,31 @@
import type { Dirent } from 'node:fs'
import { extname, join } from 'node:path'
import { mapWithConcurrency } from '../../shared/map-with-concurrency'
import { PrioritySemaphore } from '../../shared/priority-semaphore'
import { isWslUncPath } from '../../shared/wsl-paths'
import { mapWithConcurrency } from '../../../shared/map-with-concurrency'
import { PrioritySemaphore } from '../../../shared/priority-semaphore'
import { isWslUncPath } from '../../../shared/wsl-paths'
import { SessionNewestFiles } from './session-newest-files'
import type { SessionSidecarObservation } from './parse-cache/session-sidecar-stat'
import type { AiVaultAgent, AiVaultScanIssue } from '../../shared/ai-vault/contracts/ai-vault-types'
import { wslGatedReaddir, wslGatedStat } from '../native-chat/wsl-transcript-fs-access'
import { WslTranscriptFsError } from '../native-chat/wsl-transcript-fs-gate'
import { recordSessionScanIssue, scanIssueTextFromError } from './session-scan-issues'
import { aiVaultScanIssueText } from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import type { SessionSidecarObservation } from '../parse-cache/session-sidecar-stat'
import type {
AiVaultAgent,
AiVaultScanIssue
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { wslGatedReaddir, wslGatedStat } from '../../native-chat/wsl-transcript-fs-access'
import { WslTranscriptFsError } from '../../native-chat/wsl-transcript-fs-error'
import { recordSessionScanIssue, scanIssueTextFromError } from '../parsing/session-scan-issues'
import { aiVaultScanIssueText } from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import type {
FileWithMtime,
SessionFileDiscovery,
SessionFileWalkOptions
} from './session-scanner-types'
import { errorMessage } from './session-scanner-values'
import { throwIfAiVaultScanCancelled } from './ai-vault-scan-cancellation'
} from '../session-scanner-types'
import { errorMessage } from '../../../shared/error-message'
import { throwIfAiVaultScanCancelled } from '../scan-lifecycle/ai-vault-scan-cancellation'
import {
noteAiVaultScanFileFound,
noteAiVaultScanWorkChanged,
openAiVaultScanSource
} from './ai-vault-scan-progress'
} from '../scan-lifecycle/ai-vault-scan-progress'
import { isMissingTranscriptPathError } from './session-path-absence'
const NATIVE_DISCOVERY_CONCURRENCY = 4
const NATIVE_DISCOVERY_BATCH_SIZE = 16
@@ -250,18 +254,6 @@ async function observeSessionSidecar(
}
}
/** A missing file or folder is absence, not a refusal; WSL gate errors are always refusals. */
export function isMissingTranscriptPathError(error: unknown): boolean {
if (error instanceof WslTranscriptFsError) {
return false
}
const code =
error && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
? error.code
: null
return code === 'ENOENT' || code === 'ENOTDIR'
}
/** Collecting form for callers that want every match; bounded scans stream. */
export async function walkSessionFiles(
dirPath: string,
@@ -1,9 +1,9 @@
import { claudeProfileHistoryDirs } from '../claude-accounts/profiles/routing/claude-profile-installed-router'
import { claudeProfileHistoryDirs } from '../../claude-accounts/profiles/routing/claude-profile-installed-router'
import { homedir } from 'node:os'
import { join } from 'node:path'
import { resolveAbsoluteDirOverride } from '../../shared/absolute-dir-override'
import { WSL_CODEX_RUNTIME_HOME_SEGMENTS } from '../pty/shell-startup/codex-home-wsl-env'
import { ompProfileSessionsDirs, resolveOmpSessionsDir } from './scanners/omp/omp-session-root'
import { resolveAbsoluteDirOverride } from '../../../shared/absolute-dir-override'
import { WSL_CODEX_RUNTIME_HOME_SEGMENTS } from '../../pty/shell-startup/codex-home-wsl-env'
import { ompProfileSessionsDirs, resolveOmpSessionsDir } from '../scanners/omp/omp-session-root'
/** Where each transcript agent's session tree sits under a home dir (host or WSL guest). */
export const AGENT_SESSION_HOME_SEGMENTS = {
@@ -1,16 +1,17 @@
import { delimiter } from 'node:path'
import type { AiVaultAgent, AiVaultScanIssue } from '../../shared/ai-vault/contracts/ai-vault-types'
import type {
AiVaultAgent,
AiVaultScanIssue
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { discoverFiles } from './session-scanner-discovery'
import { opencodeDiscoveries } from './scanners/opencode/session-scanner-opencode-sources'
import { zcodeDiscoveries } from './scanners/zcode/session-scanner-zcode-sources'
import { antigravityDiscoveries } from './scanners/antigravity/session-scanner-antigravity-sources'
import { opencodeDiscoveries } from '../scanners/opencode/session-scanner-opencode-sources'
import { zcodeDiscoveries } from '../scanners/zcode/session-scanner-zcode-sources'
import { antigravityDiscoveries } from '../scanners/antigravity/session-scanner-antigravity-sources'
import { AI_VAULT_AGENT_SOURCES, type AiVaultAgentSource } from './session-scanner-agent-sources'
import { normalizedWslHomeDirs } from './session-scanner-roots'
import { configureOpenCodeWslReaders } from './scanners/opencode/reader-transport/session-scanner-opencode-wsl-client'
import { scopeOnlyScan, scopeWalksAgentFiles } from './session-scope-cwd'
import type { AiVaultScanOptions, SessionFileDiscovery } from './session-scanner-types'
export { DEFAULT_CODEX_HOME_DIR } from './session-scanner-agent-sources'
import { configureOpenCodeWslReaders } from '../scanners/opencode/reader-transport/session-scanner-opencode-wsl-client'
import { scopeOnlyScan, scopeWalksAgentFiles } from '../scope/session-scope-cwd'
import type { AiVaultScanOptions, SessionFileDiscovery } from '../session-scanner-types'
export async function discoverAiVaultSessionSources(args: {
options: AiVaultScanOptions
@@ -2,7 +2,7 @@ import { beforeEach, describe, expect, it } from 'vitest'
import type {
AiVaultListResult,
AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import {
carryOverUnconfirmedWslSessions,
resetAiVaultWslSessionCarryover
@@ -1,9 +1,9 @@
import type {
AiVaultListResult,
AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { aiVaultScanIssueText } from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { isWslUncPath } from '../../shared/wsl-paths'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { aiVaultScanIssueText } from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { isWslUncPath } from '../../../shared/wsl-paths'
// The WSL rows of the last scan whose WSL roots a confirmed running list named, per scope key.
// Map order is recency: the oldest scope is evicted past the cap, so retired scopes don't pile up.
@@ -1,4 +1,3 @@
import { join } from 'node:path'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import type { ProcessResult } from '@orca/process-host/process-spec'
@@ -11,26 +10,20 @@ vi.mock('@orca/process-host', async (importOriginal) => ({
...(await importOriginal<object>()),
runProcess: runProcessMock
}))
vi.mock('./scan-service/session-scanner-service-spawn', async (importOriginal) => ({
vi.mock('../scan-service/session-scanner-service-spawn', async (importOriginal) => ({
...(await importOriginal<object>()),
scanAiVaultSessionsInService
}))
vi.mock('./scanners/opencode/reader-transport/opencode-wsl-runtime-preparation', () => ({
vi.mock('../scanners/opencode/reader-transport/opencode-wsl-runtime-preparation', () => ({
prepareOpenCodeWslReaders: vi.fn(async () => [])
}))
import {
_resetWslCachesForTests,
_setWslCachesForTests,
listWslDistrosAsync
} from '../wsl/discovery/distro-catalog'
import { filterPathsToRunningWslDistrosAsync } from '../wsl/filesystem/wsl-running-path-filter'
import { _resetWslCachesForTests, listWslDistrosAsync } from '../../wsl/discovery/distro-catalog'
import {
configureAiVaultSessionSources,
getAiVaultWslHomeDirs,
listAiVaultSessions,
resetAiVaultSessionListCacheForTests
} from './cached-session-list'
getAiVaultWslHomeDirs
} from '../discovery/ai-vault-scan-roots'
import { resetAiVaultSessionListCacheForTests } from './cached-session-list'
const NATIVE_CODEX_HOME = 'C:\\Users\\ada\\.codex'
const WSL_HOME = '\\\\wsl.localhost\\Ubuntu\\home\\ada'
@@ -62,57 +55,6 @@ describe('AI Vault listing wsl.exe probes', () => {
vi.restoreAllMocks()
})
it('spawns no wsl.exe for native-only codex homes when no distro is installed', async () => {
_setWslCachesForTests({ distros: [] })
await listAiVaultSessions()
expect(wslSpawns()).toEqual([])
expect(scanAiVaultSessionsInService).toHaveBeenCalledWith(
expect.objectContaining({
additionalCodexSessionsDirs: [join(NATIVE_CODEX_HOME, 'sessions')],
wslHomeDirs: []
}),
expect.anything(),
expect.objectContaining({
work: expect.any(Function),
finish: expect.any(Function),
fail: expect.any(Function)
})
)
})
it('still probes running distros when one is installed, so a later outage keeps the last-known-good list', async () => {
_setWslCachesForTests({ distros: ['Ubuntu'] })
runProcessMock.mockImplementation(
({ args }: { args: string[] }) =>
new Promise<ProcessResult>((resolve) => {
resolve(exited(args.includes('--running') ? 'Ubuntu\n' : '/home/ada\n'))
})
)
await listAiVaultSessions()
expect(wslSpawns()).toEqual([
['--list', '--running', '--quiet'],
['-d', 'Ubuntu', '--exec', 'bash', '-c', 'echo $HOME']
])
expect(scanAiVaultSessionsInService).toHaveBeenCalledWith(
expect.objectContaining({ wslHomeDirs: [WSL_HOME] }),
expect.anything(),
expect.objectContaining({
work: expect.any(Function),
finish: expect.any(Function),
fail: expect.any(Function)
})
)
runProcessMock.mockResolvedValue(FAILED)
await expect(filterPathsToRunningWslDistrosAsync([`${WSL_HOME}\\.codex`])).resolves.toEqual([
`${WSL_HOME}\\.codex`
])
})
// A failed distro probe cannot narrow the roots trusted by deletion or subagent validation.
it('still discovers WSL homes after the installed-distro probe was rejected', async () => {
runProcessMock.mockImplementation(
@@ -2,7 +2,7 @@ import {
clearAiVaultBackgroundRestartCircuit,
resetAiVaultScannerBackgroundForTests,
scanAiVaultSessionsInBackground
} from './scan-service/session-scanner-background'
} from '../scan-service/session-scanner-background'
import {
carryOverUnconfirmedWslSessions,
resetAiVaultWslSessionCarryover
@@ -11,39 +11,30 @@ import {
isAiVaultScanCancelledError,
type AiVaultListArgs,
type AiVaultListResult
} from '../../shared/ai-vault/contracts/ai-vault-types'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import {
aiVaultLocalScanKey,
aiVaultLocalScanScopeKey
} from '../../shared/ai-vault/scanning/ai-vault-local-scan-key'
import { AiVaultScanCoordinator } from './ai-vault-scan-coordinator'
} from '../../../shared/ai-vault/scanning/ai-vault-local-scan-key'
import { AiVaultScanCoordinator } from '../scan-lifecycle/ai-vault-scan-coordinator'
import {
resetAiVaultSessionSourcesForTests,
resolveLocalAiVaultScanRoots
} from './ai-vault-scan-roots'
} from '../discovery/ai-vault-scan-roots'
import {
attachAiVaultScopeCwdAliases,
resolveAiVaultScopeRealPaths
} from './session-scope-real-paths'
} from '../scope/session-scope-real-paths'
import {
startLocalAiVaultScanProgress,
type LocalAiVaultScanProgressHandle
} from './ai-vault-local-scan-progress'
} from '../scan-lifecycle/ai-vault-local-scan-progress'
import {
aiVaultCachedDepthServes,
requestedAiVaultSessionDepth,
truncateAiVaultListResult,
type AiVaultSessionDepth
} from '../../shared/ai-vault/scanning/ai-vault-session-depth'
export {
configureAiVaultSessionSources,
configuredAdditionalCodexHomePaths,
getAiVaultWslHomeDirs,
getAiVaultWslScanHomeDirs,
localAiVaultScanRoots,
type AiVaultSessionSources
} from './ai-vault-scan-roots'
} from '../../../shared/ai-vault/scanning/ai-vault-session-depth'
// Desktop and runtime RPC share this cache to avoid duplicate scans when mobile and desktop open together.
const AI_VAULT_CACHE_TTL_MS = 60_000
@@ -1,5 +1,5 @@
import { createHash } from 'node:crypto'
import type { AiVaultListResult } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultListResult } from '../../../shared/ai-vault/contracts/ai-vault-types'
export function conditionalAiVaultListResult(
result: AiVaultListResult,
@@ -58,22 +58,6 @@ describe('parseAiVaultListResult', () => {
expect(parsed.issues).toEqual([validScanIssue()])
})
it('reports malformed scan issues without counting unknown-agent issues as invalid', () => {
const parsed = parseAiVaultListResult({
sessions: [],
issues: [validScanIssue(), { agent: 'future-agent' }, validScanIssue('newer-agent')],
scannedAt: '2026-07-27T00:00:00.000Z'
})
expect(parsed.issues).toEqual([
validScanIssue(),
expect.objectContaining({
path: 'aiVault.listSessions',
message: expect.stringContaining('Skipped 1 invalid')
})
])
})
it('does not throw when malformed rows are mixed with well-formed unknown sessions', () => {
const parsed = parseAiVaultListResult({
sessions: [
@@ -129,20 +113,6 @@ describe('parseAiVaultListResult', () => {
expect(parsed.issues).toEqual([coded, { agent: 'codex', path: coded.path, message: 'English' }])
})
it('rejects a malformed result envelope', () => {
expect(() => parseAiVaultListResult({ sessions: [] })).toThrow()
})
it('rejects a nonempty sessions array when every row is invalid', () => {
expect(() =>
parseAiVaultListResult({
sessions: [{ id: 42 }, null],
issues: [],
scannedAt: '2026-07-27T00:00:00.000Z'
})
).toThrow('all supplied Agent Session History sessions were invalid')
})
})
function validSession(sessionId = 'session-1'): Record<string, unknown> {
@@ -1,5 +1,5 @@
import { z } from 'zod'
import { AiVaultSessionAccountHomeSchema } from '../../shared/ai-vault/contracts/ai-vault-session-account-home'
import { AiVaultSessionAccountHomeSchema } from '../../../shared/ai-vault/contracts/ai-vault-session-account-home'
import {
AI_VAULT_AGENTS,
AI_VAULT_SCOPE_PATHS_MAX_COUNT,
@@ -7,9 +7,9 @@ import {
type AiVaultListResult,
type AiVaultScanIssue,
type AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { normalizeExecutionHostId } from '../../shared/execution-host'
import { aiVaultScanIssueText } from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { normalizeExecutionHostId } from '../../../shared/execution-host'
import { aiVaultScanIssueText } from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
const aiVaultAgentSet = new Set<string>(AI_VAULT_AGENTS)
@@ -3,8 +3,8 @@ import type {
AiVaultListResult,
AiVaultScanIssue,
AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { truncateAiVaultListResult } from '../../shared/ai-vault/scanning/ai-vault-session-depth'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { truncateAiVaultListResult } from '../../../shared/ai-vault/scanning/ai-vault-session-depth'
import { mergeAiVaultListResults } from './session-list-results'
function listResult(issues: AiVaultScanIssue[]): AiVaultListResult {
@@ -2,14 +2,14 @@ import type {
AiVaultListResult,
AiVaultScanIssue,
AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
import type { ExecutionHostId } from '../../shared/execution-host'
import type { AiVaultScanIssueText } from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { sessionSortTime } from './session-scanner-accumulator'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import type { ExecutionHostId } from '../../../shared/execution-host'
import type { AiVaultScanIssueText } from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { sessionSortTime } from '../parsing/session-scanner-accumulator'
import {
requestedAiVaultSessionDepth,
truncateAiVaultListResult
} from '../../shared/ai-vault/scanning/ai-vault-session-depth'
} from '../../../shared/ai-vault/scanning/ai-vault-session-depth'
export function aiVaultScanIssueResult({
executionHostId,
@@ -10,7 +10,7 @@ import {
import { createSessionParseStats, parseAgentSessionFileCached } from './session-scanner-parse-cache'
import { resetSessionParseCacheForTests } from './session-parse-cache-store'
import { writeAntigravityTranscript } from '../session-scanner-test-fixtures'
import { writeAntigravityTranscript } from '../scanner-fixtures/session-scanner-test-fixtures'
import type { SessionFileCandidate } from '../session-scanner-types'
let root: string | undefined
@@ -1,8 +1,8 @@
import { existsSync } from 'node:fs'
import { appendFile, mkdir, mkdtemp, readdir, rm, stat, utimes, writeFile } from 'node:fs/promises'
import { mkdtemp, readdir, rm, stat, writeFile } from 'node:fs/promises'
import * as fsPromises from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { dirname, join } from 'node:path'
import { join } from 'node:path'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import SyncDatabase from '../../sqlite/sync-database'
import {
@@ -11,11 +11,7 @@ import {
initSessionParseCachePersistence,
resetSessionParseCachePersistenceForTests
} from './session-parse-cache-persistence'
import {
SESSION_PARSE_CACHE_SCHEMA_VERSION,
SessionParseCacheDatabase
} from './session-parse-cache-database'
import { scanAiVaultSessions } from '../session-scanner'
import { SESSION_PARSE_CACHE_SCHEMA_VERSION } from './session-parse-cache-database'
import {
createSessionParseStats,
parseAgentSessionFileCached,
@@ -23,14 +19,10 @@ import {
} from './session-scanner-parse-cache'
import {
invalidateSessionParseCacheEntry,
resetSessionParseCacheForTests,
storeSessionScopeCwd,
type SessionScopeCwdStamp
resetSessionParseCacheForTests
} from './session-parse-cache-store'
import type * as ParseCacheModule from './session-scanner-parse-cache'
import { isolatedScanRoots } from '../session-scanner-test-fixtures'
import { parseClaudeSessionFile } from '../scanners/claude/session-scanner-primary-parsers'
import { parseSessionCandidate } from '../session-scanner-candidate-parse'
import { parseSessionCandidate } from '../parsing/session-scanner-candidate-parse'
import { MAX_SESSION_TRANSCRIPT_RECORD_BYTES } from '../transcripts/session-transcript-record-budget'
import type { FileWithMtime, SessionFileCandidate } from '../session-scanner-types'
@@ -53,7 +45,6 @@ vi.mock('./session-scanner-parse-cache', async (importOriginal) => {
})
const APP_VERSION = '1.2.3-test'
const DAY_MS = 24 * 60 * 60_000
let tempRoots: string[] = []
@@ -134,108 +125,7 @@ function simulateRestart(cacheFile: string): void {
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
}
function databaseRows(cacheFile: string): { path: string; seen_at: number }[] {
const db = new SyncDatabase(join(dirname(cacheFile), 'session-parse-cache.sqlite'))
try {
return db
.prepare('SELECT path, seen_at FROM rows ORDER BY path')
.all()
.map((row) => ({ path: String(row.path), seen_at: Number(row.seen_at) }))
} finally {
db.close()
}
}
function setSeenAt(cacheFile: string, path: string, seenAt: number): void {
const db = new SyncDatabase(join(dirname(cacheFile), 'session-parse-cache.sqlite'))
db.prepare('UPDATE rows SET seen_at = ? WHERE path = ?').run(seenAt, path)
db.close()
}
describe('session parse cache persistence', () => {
it('persists scope rows across chunks and keeps replacements queued during a yield', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const paths = Array.from({ length: 1_001 }, (_, index) => join(root, `session-${index}`))
const stamp: SessionScopeCwdStamp = {
mtimeMs: 1,
sizeBytes: 10,
platform: 'linux',
cwd: '/original'
}
for (const path of paths) {
storeSessionScopeCwd(path, stamp)
}
const flushing = flushSessionParseCachePersist()
const replacement = { ...stamp, mtimeMs: 2, cwd: '/updated' }
storeSessionScopeCwd(paths[0]!, replacement)
storeSessionScopeCwd(paths[750]!, replacement)
await flushing
resetSessionParseCachePersistenceForTests()
resetSessionParseCacheForTests()
const database = new SessionParseCacheDatabase(join(root, 'session-parse-cache.sqlite'))
try {
const stored = database.readScopeCwds(paths).found
expect(stored.size).toBe(paths.length)
for (const [index, path] of paths.entries()) {
expect(stored.get(path)?.read).toEqual(index === 0 || index === 750 ? replacement : stamp)
}
} finally {
database.close()
}
})
it('round-trips: a persisted entry is a reused hit after a restart, without reading the transcript', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'vault-state', 'session-parse-cache.json')
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const transcript = await writeTranscript(root)
const candidate = await claudeCandidate(transcript)
const stats = createSessionParseStats()
const first = await parseAgentSessionFileCached(candidate, process.platform, stats)
expect(stats.fullParses).toBe(1)
await flushSessionParseCachePersist()
simulateRestart(cacheFile)
// Removing the transcript proves the restored hit needs no transcript read.
await rm(transcript)
const reusedStats = createSessionParseStats()
const reused = await parseAgentSessionFileCached(candidate, process.platform, reusedStats)
expect(reusedStats).toMatchObject({ reused: 1, fullParses: 0, incremental: 0, bytesRead: 0 })
expect(reused).toEqual(first)
})
it('scanAiVaultSessions reads the database and writes after parsing', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const roots = isolatedScanRoots(root)
const transcript = join(roots.claudeProjectsDir, 'project', 'scan-session.jsonl')
await mkdir(join(roots.claudeProjectsDir, 'project'), { recursive: true })
await writeFile(
transcript,
`${userRecord(0, 'persisted-scan-marker-AAAA')}\n${assistantRecord(1, 'answer')}\n`
)
const pinnedMtime = new Date(1740000000000)
await utimes(transcript, pinnedMtime, pinnedMtime)
const first = await scanAiVaultSessions(roots)
expect(JSON.stringify(first.sessions[0])).toContain('persisted-scan-marker-AAAA')
await flushSessionParseCachePersist()
simulateRestart(cacheFile)
// Same size and mtime but different content distinguishes a persisted hit from a cold parse.
await writeFile(
transcript,
`${userRecord(0, 'persisted-scan-marker-BBBB')}\n${assistantRecord(1, 'answer')}\n`
)
await utimes(transcript, pinnedMtime, pinnedMtime)
const second = await scanAiVaultSessions(roots)
expect(second.sessions[0]).toEqual(first.sessions[0])
})
it('reconstructs unreadable diagnostics from a version 8 row before reusing it', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
@@ -287,27 +177,6 @@ describe('session parse cache persistence', () => {
expect(reusedStats).toMatchObject({ reused: 1, fullParses: 0, bytesRead: 0 })
})
it('falls through to a full parse when a file changed while the app was closed', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const transcript = await writeTranscript(root)
await parse(transcript)
await flushSessionParseCachePersist()
simulateRestart(cacheFile)
// Restored rows lack incremental state; changed transcripts need a full parse.
await appendFile(transcript, `${userRecord(2, 'follow-up')}\n${assistantRecord(3, 'more')}\n`)
const stats = createSessionParseStats()
const reparsed = await parseAgentSessionFileCached(
await claudeCandidate(transcript),
process.platform,
stats
)
expect(stats).toMatchObject({ fullParses: 1, incremental: 0, reused: 0 })
expect(reparsed).toEqual(await parseClaudeSessionFile((await claudeCandidate(transcript)).file))
})
it('imports the old JSON file even when a title lookup reaches the database first', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
@@ -371,58 +240,6 @@ describe('session parse cache persistence', () => {
expect(existsSync(cacheFile)).toBe(false)
})
it('rebuilds a corrupt database instead of failing the scan', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
await writeFile(join(root, 'session-parse-cache.sqlite'), 'not a database at all'.repeat(512))
vi.spyOn(console, 'debug').mockImplementation(() => {})
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const transcript = await writeTranscript(root)
expect((await parse(transcript)).fullParses).toBe(1)
await flushSessionParseCachePersist()
simulateRestart(cacheFile)
expect((await parse(transcript)).reused).toBe(1)
})
it('drops rows whose transcript is gone and keeps old rows whose transcript is still there', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const kept = await writeTranscript(root, 'kaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee')
const deletedOutsideOrca = await writeTranscript(root, 'daaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee')
await parse(kept)
await parse(deletedOutsideOrca)
await flushSessionParseCachePersist()
resetSessionParseCachePersistenceForTests()
// ast-grep-ignore: test-no-wall-clock -- Real database expiry uses current time for persisted row ages.
setSeenAt(cacheFile, kept, Date.now() - 31 * DAY_MS)
// ast-grep-ignore: test-no-wall-clock -- Real database expiry uses current time for persisted row ages.
setSeenAt(cacheFile, deletedOutsideOrca, Date.now() - 31 * DAY_MS)
await rm(deletedOutsideOrca)
simulateRestart(cacheFile)
expect((await parse(kept)).reused).toBe(1)
await vi.waitFor(() => expect(databaseRows(cacheFile).map((row) => row.path)).toEqual([kept]))
await vi.waitFor(() =>
// ast-grep-ignore: test-no-wall-clock -- Real database expiry uses current time for persisted row ages.
expect(databaseRows(cacheFile)[0]!.seen_at).toBeGreaterThan(Date.now() - DAY_MS)
)
})
it('invalidating before the first lookup does not bring the row back', async () => {
const root = await makeTempDir()
const cacheFile = join(root, 'session-parse-cache.json')
initSessionParseCachePersistence({ filePath: cacheFile, appVersion: APP_VERSION })
const transcript = await writeTranscript(root)
await parse(transcript)
await flushSessionParseCachePersist()
simulateRestart(cacheFile)
invalidateSessionParseCacheEntry(transcript)
expect((await parse(transcript)).fullParses).toBe(1)
})
it('performs zero disk IO when only configured, as Electron main is', async () => {
const root = await makeTempDir()
configureSessionParseCachePersistence({
@@ -436,21 +253,4 @@ describe('session parse cache persistence', () => {
expect(fsPromises.readdir).not.toHaveBeenCalled()
expect(await readdir(root)).toEqual([])
})
it('swallows database failures and leaves scan results unaffected', async () => {
const root = await makeTempDir()
// A file blocking the cache directory fails on Windows and as root, unlike chmod-based fixtures.
const blocker = join(root, 'blocker')
await writeFile(blocker, 'a file, not a directory')
initSessionParseCachePersistence({
filePath: join(blocker, 'session-parse-cache.json'),
appVersion: APP_VERSION
})
const debugSpy = vi.spyOn(console, 'debug').mockImplementation(() => {})
const transcript = await writeTranscript(root)
expect((await parse(transcript)).fullParses).toBe(1)
await expect(flushSessionParseCachePersist()).resolves.toBeUndefined()
expect(debugSpy).toHaveBeenCalled()
expect((await parse(transcript)).reused).toBe(1)
})
})
@@ -1,7 +1,7 @@
import {
abandonRemoteSessionScanOnCancel,
throwIfAiVaultScanCancelled
} from '../ai-vault-scan-cancellation'
} from '../scan-lifecycle/ai-vault-scan-cancellation'
const pending = new Map<string, Promise<unknown>>()
@@ -2,7 +2,7 @@ import { mkdir, mkdtemp, rm, stat, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, beforeEach, describe, expect, it } from 'vitest'
import { parseAgentSessionFile } from '../session-scanner-agent-parser'
import { parseAgentSessionFile } from '../parsing/session-scanner-agent-parser'
import {
CODEX_FIXTURE_SESSION_ID,
codexFixture
@@ -1,4 +1,7 @@
import { throwIfAiVaultScanCancelled, waitForAiVaultScan } from '../ai-vault-scan-cancellation'
import {
throwIfAiVaultScanCancelled,
waitForAiVaultScan
} from '../scan-lifecycle/ai-vault-scan-cancellation'
import { createQoderSessionResumeState } from '../scanners/qoder/session-scanner-qoder-parser'
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { inSessionParseFileLane } from './session-parse-file-lane'
@@ -1,6 +1,6 @@
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { buildAiVaultResumeCommand } from '../../../shared/ai-vault/resume/ai-vault-resume-command'
import { generatedSessionTitle } from '../session-scanner-accumulator'
import { generatedSessionTitle } from '../parsing/session-scanner-accumulator'
import {
readCursorChatMeta,
wasCursorChatMetaRefused
@@ -1,5 +1,5 @@
import type { AiVaultSession } from '../../shared/ai-vault/contracts/ai-vault-types'
import { CONVERSATION_NAME_PROMPT_OPENING } from '../../shared/source-control/ai/generation/conversation-name-generation'
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { CONVERSATION_NAME_PROMPT_OPENING } from '../../../shared/source-control/ai/generation/conversation-name-generation'
const MAX_NAME_REQUEST_MESSAGES = 6
@@ -0,0 +1,13 @@
import { asRecord } from './session-record-fields'
export function parseJsonObject(line: string): Record<string, unknown> | null {
if (!line.trim()) {
return null
}
try {
const parsed = JSON.parse(line) as unknown
return asRecord(parsed)
} catch {
return null
}
}
@@ -0,0 +1,42 @@
import { extractString } from '../../../shared/trimmed-string'
export function asRecord(value: unknown): Record<string, unknown> | null {
return value && typeof value === 'object' && !Array.isArray(value)
? (value as Record<string, unknown>)
: null
}
export function extractModel(value: unknown): string | null {
const record = asRecord(value)
if (!record) {
return null
}
return (
extractString(record.model) ||
extractString(record.model_name) ||
extractString(asRecord(record.metadata)?.model) ||
extractString(asRecord(record.info)?.model) ||
null
)
}
export function extractGitBranch(value: unknown): string | null {
const git = asRecord(value)
if (!git) {
return null
}
return extractString(git.branch) || extractString(git.current_branch)
}
export function arrayValue(value: unknown): unknown[] {
return Array.isArray(value) ? value : []
}
export function firstString(record: Record<string, unknown>, keys: string[]): string | null {
for (const key of keys) {
const value = extractString(record[key])
if (value) {
return value
}
}
return null
}
@@ -0,0 +1,28 @@
import { asRecord } from './session-record-fields'
export function timestampMs(value: unknown): number {
if (typeof value === 'string') {
const parsed = Date.parse(value)
return Number.isFinite(parsed) ? parsed : Number.NaN
}
if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
return Number.NaN
}
return value > 1_000_000_000_000 ? value : value * 1000
}
export function timeObjectValue(value: unknown, key: string): string | null {
const record = asRecord(value)
if (!record) {
return null
}
const rawValue = record[key]
if (typeof rawValue === 'string') {
return rawValue
}
const parsed = timestampMs(rawValue)
if (!Number.isFinite(parsed)) {
return null
}
return new Date(parsed).toISOString()
}
@@ -1,9 +1,9 @@
import { antigravitySessionOrigin } from '../../shared/antigravity-session-origin'
import type { AiVaultSession } from '../../shared/ai-vault/contracts/ai-vault-types'
import { antigravitySessionOrigin } from '../../../shared/antigravity-session-origin'
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
import {
codexSessionAliasKey,
codexSessionAliasBeats
} from './scanners/codex/codex-session-root-dedup'
} from '../scanners/codex/codex-session-root-dedup'
import { sessionSortTime } from './session-scanner-accumulator'
function sessionAliasKey(session: AiVaultSession): string | null {
@@ -1,5 +1,5 @@
import { describe, expect, it } from 'vitest'
import type { AiVaultSession } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { ScannedSessionCollection } from './session-root-dedup'
import { canStopParsingSessions } from './session-scan-cutoff'
import { createAccumulator, finalizeSession } from './session-scanner-accumulator'
@@ -1,10 +1,10 @@
import type { AiVaultScanIssue } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanIssue } from '../../../shared/ai-vault/contracts/ai-vault-types'
import {
aiVaultScanIssueText,
type AiVaultScanIssueText
} from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { WslTranscriptFsError } from '../native-chat/wsl-transcript-fs-error'
import { errorMessage } from './session-scanner-values'
} from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { WslTranscriptFsError } from '../../native-chat/wsl-transcript-fs-error'
import { errorMessage } from '../../../shared/error-message'
// Bound IPC payloads when an unreachable host produces one issue per transcript.
export const SCAN_ISSUE_LIMIT = 500
@@ -4,20 +4,21 @@ import {
type AiVaultAgent,
type AiVaultSession,
type AiVaultSessionTitleKind
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { buildAiVaultResumeCommand } from '../../shared/ai-vault/resume/ai-vault-resume-command'
import { LOCAL_EXECUTION_HOST_ID, type ExecutionHostId } from '../../shared/execution-host'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { buildAiVaultResumeCommand } from '../../../shared/ai-vault/resume/ai-vault-resume-command'
import { LOCAL_EXECUTION_HOST_ID, type ExecutionHostId } from '../../../shared/execution-host'
import type {
FileWithMtime,
ResumableSessionParseState,
SessionAccumulator
} from './session-scanner-types'
import { extractString, timestampMs } from './session-scanner-values'
} from '../session-scanner-types'
import { extractString } from '../../../shared/trimmed-string'
import { timestampMs } from './session-record-time'
import {
NO_TRANSCRIPT_MESSAGES,
type TranscriptMessageSink,
type TranscriptSessionIdentity
} from './transcripts/session-transcript-consumers'
} from '../transcripts/session-transcript-consumers'
export function createAccumulator(args: {
agent: AiVaultAgent
@@ -1,21 +1,24 @@
import { throwIfAiVaultScanCancelled, waitForAiVaultScan } from './ai-vault-scan-cancellation'
import { parseQoderSessionFile } from './scanners/qoder/session-scanner-qoder-parser'
import { parseCodebuddySessionFile } from './scanners/codebuddy/session-scanner-codebuddy-parser'
import type { AiVaultSession } from '../../shared/ai-vault/contracts/ai-vault-types'
import { parseDevinSessionFile } from './scanners/devin/session-scanner-devin-parser'
import { parseAntigravitySessionFile } from './scanners/antigravity/session-scanner-antigravity-parser'
import { parseDroidSessionFile } from './scanners/droid/session-scanner-droid-parser'
import { parseClineSessionFile } from './scanners/cline/session-scanner-cline-parser'
import { parseGrokSessionFile } from './scanners/grok/session-scanner-grok-parser'
import {
throwIfAiVaultScanCancelled,
waitForAiVaultScan
} from '../scan-lifecycle/ai-vault-scan-cancellation'
import { parseQoderSessionFile } from '../scanners/qoder/session-scanner-qoder-parser'
import { parseCodebuddySessionFile } from '../scanners/codebuddy/session-scanner-codebuddy-parser'
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { parseDevinSessionFile } from '../scanners/devin/session-scanner-devin-parser'
import { parseAntigravitySessionFile } from '../scanners/antigravity/session-scanner-antigravity-parser'
import { parseDroidSessionFile } from '../scanners/droid/session-scanner-droid-parser'
import { parseClineSessionFile } from '../scanners/cline/session-scanner-cline-parser'
import { parseGrokSessionFile } from '../scanners/grok/session-scanner-grok-parser'
import {
parseMessageGraphSessionFile,
parseRovoSessionFile
} from './scanners/session-scanner-graph-parsers'
import { parseKimiSessionFile } from './scanners/kimi/session-scanner-kimi-parser'
import { parseMuseSessionFile } from './scanners/muse/session-scanner-muse-parser'
import { splitOpenCodeSqliteCandidate } from '../../shared/opencode-sqlite-session-path'
import { parseJcodeSessionFile } from './scanners/jcode/session-scanner-jcode-parser'
import { parseKiroSessionFile } from './scanners/kiro/session-scanner-kiro-parser'
} from '../scanners/session-scanner-graph-parsers'
import { parseKimiSessionFile } from '../scanners/kimi/session-scanner-kimi-parser'
import { parseMuseSessionFile } from '../scanners/muse/session-scanner-muse-parser'
import { splitOpenCodeSqliteCandidate } from '../../../shared/opencode-sqlite-session-path'
import { parseJcodeSessionFile } from '../scanners/jcode/session-scanner-jcode-parser'
import { parseKiroSessionFile } from '../scanners/kiro/session-scanner-kiro-parser'
import {
captureOpenCodeSqliteSessionViaWorker,
captureOpenCode2SqliteSessionViaWorker,
@@ -23,17 +26,17 @@ import {
parseOpenCode2SqliteSessionViaWorker,
parseOpenCodeSqliteSessionViaWorker,
parseZcodeSqliteSessionViaWorker
} from './scanners/opencode/reader-transport/session-scanner-opencode-sqlite-worker-spawn'
import { parseClaudeSessionFile } from './scanners/claude/session-scanner-primary-parsers'
import { parseGeminiSessionFile } from './scanners/gemini/session-scanner-gemini-parsers'
import { parseCodexSessionFile } from './scanners/codex/session-scanner-codex-parser'
import { parseCopilotSessionFile } from './scanners/copilot/session-scanner-copilot-parser'
import { parseCursorSessionFile } from './scanners/cursor/session-scanner-cursor-parser'
import { parseHermesSessionFile } from './scanners/hermes/session-scanner-hermes-parser'
import { parseOpenCodeSessionFile } from './scanners/opencode/session-scanner-opencode-parser'
import type { SessionFileCandidate } from './session-scanner-types'
import type { TranscriptMessageSink } from './transcripts/session-transcript-consumers'
import type { SkippedTranscriptRecord } from './transcripts/session-transcript-record-budget'
} from '../scanners/opencode/reader-transport/session-scanner-opencode-sqlite-worker-spawn'
import { parseClaudeSessionFile } from '../scanners/claude/session-scanner-primary-parsers'
import { parseGeminiSessionFile } from '../scanners/gemini/session-scanner-gemini-parsers'
import { parseCodexSessionFile } from '../scanners/codex/session-scanner-codex-parser'
import { parseCopilotSessionFile } from '../scanners/copilot/session-scanner-copilot-parser'
import { parseCursorSessionFile } from '../scanners/cursor/session-scanner-cursor-parser'
import { parseHermesSessionFile } from '../scanners/hermes/session-scanner-hermes-parser'
import { parseOpenCodeSessionFile } from '../scanners/opencode/session-scanner-opencode-parser'
import type { SessionFileCandidate } from '../session-scanner-types'
import type { TranscriptMessageSink } from '../transcripts/session-transcript-consumers'
import type { SkippedTranscriptRecord } from '../transcripts/session-transcript-record-budget'
/** Listing needs only a preview; active message sinks require the full transcript. */
async function readOpenCodeSqliteCandidate(
@@ -1,32 +1,32 @@
import { yieldToEventLoop } from '../../shared/event-loop-yield'
import { yieldToEventLoop } from '../../../shared/event-loop-yield'
import { isConversationNameRequestSession } from './conversation-name-request-sessions'
import { candidateFileTime } from './scanners/antigravity/antigravity-transcript-candidates'
import { candidateFileTime } from '../scanners/antigravity/antigravity-transcript-candidates'
import {
aiVaultAgentLabel,
isAiVaultSessionResumableContent,
isAiVaultSessionRecoverableEmpty,
type AiVaultScanIssue,
type AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { aiVaultScanIssueText } from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import type { ExecutionHostId } from '../../shared/execution-host'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { aiVaultScanIssueText } from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import type { ExecutionHostId } from '../../../shared/execution-host'
import { ScannedSessionCollection } from './session-root-dedup'
import type { AntigravityWorkspaceResolver } from './scanners/antigravity/session-scanner-antigravity-history'
import type { AntigravityWorkspaceResolver } from '../scanners/antigravity/session-scanner-antigravity-history'
import {
parseAgentSessionFileCached,
parseListedSessionFile,
type SessionParseStats
} from './parse-cache/session-scanner-parse-cache'
} from '../parse-cache/session-scanner-parse-cache'
import { recordSessionScanIssue, scanIssueTextFromError } from './session-scan-issues'
import {
getSessionParseCacheEntry,
noteSessionParseCacheListed,
sessionParseCacheKey
} from './parse-cache/session-parse-cache-store'
} from '../parse-cache/session-parse-cache-store'
import { canStopParsingSessions } from './session-scan-cutoff'
import type { SessionFileCandidate, SessionParseResult } from './session-scanner-types'
import { throwIfAiVaultScanCancelled } from './ai-vault-scan-cancellation'
import { noteAiVaultScanWorkChanged } from './ai-vault-scan-progress'
import type { SessionFileCandidate, SessionParseResult } from '../session-scanner-types'
import { throwIfAiVaultScanCancelled } from '../scan-lifecycle/ai-vault-scan-cancellation'
import { noteAiVaultScanWorkChanged } from '../scan-lifecycle/ai-vault-scan-progress'
const SESSION_PARSE_CONCURRENCY = 8
@@ -2,9 +2,12 @@ import { mkdtemp, rm } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it } from 'vitest'
import { buildConversationNamePrompt } from '../../shared/source-control/ai/generation/conversation-name-generation'
import { scanAiVaultSessions } from './session-scanner'
import { isolatedScanRoots, writeJsonlFile } from './session-scanner-test-fixtures'
import { buildConversationNamePrompt } from '../../../shared/source-control/ai/generation/conversation-name-generation'
import { scanAiVaultSessions } from '../session-scanner'
import {
isolatedScanRoots,
writeJsonlFile
} from '../scanner-fixtures/session-scanner-test-fixtures'
let tempRoots: string[] = []
@@ -1,7 +1,7 @@
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import type * as NodeFsPromisesModule from 'node:fs/promises'
import type * as NodePathModule from 'node:path'
import type { SessionFileCandidate } from './session-scanner-types'
import type { SessionFileCandidate } from '../session-scanner-types'
const mocks = vi.hoisted(() => ({
open: vi.fn(),
@@ -24,14 +24,14 @@ vi.mock('node:path', async (importOriginal) => {
return { ...actual.win32, default: actual.win32 }
})
import { parseAgentSessionFileCached } from './parse-cache/session-scanner-parse-cache'
import { resetSessionParseCacheForTests } from './parse-cache/session-parse-cache-store'
import { parseAgentSessionFileCached } from '../parse-cache/session-scanner-parse-cache'
import { resetSessionParseCacheForTests } from '../parse-cache/session-parse-cache-store'
import {
resetWslTranscriptFsGateForTests,
WSL_TRANSCRIPT_FS_ROUTE_QUARANTINE_BASE_MS,
WSL_TRANSCRIPT_FS_SCAN_TIMEOUT_MS,
WslTranscriptFsError
} from '../native-chat/wsl-transcript-fs-gate'
WSL_TRANSCRIPT_FS_SCAN_TIMEOUT_MS
} from '../../native-chat/wsl-transcript-fs-gate'
import { WslTranscriptFsError } from '../../native-chat/wsl-transcript-fs-error'
function uncPath(distro: string, ...segments: string[]): string {
return `\\\\wsl.localhost\\${distro}\\home\\ada\\${segments.join('\\')}`
@@ -2,9 +2,9 @@ import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it, vi } from 'vitest'
import { scanAiVaultSessions } from './session-scanner'
import { withFullFirstUserPromptCapture } from './session-scanner-first-user-prompt-capture'
import { isolatedScanRoots, jsonLines } from './session-scanner-test-fixtures'
import { scanAiVaultSessions } from '../session-scanner'
import { withFullFirstUserPromptCapture } from '../prompts/session-scanner-first-user-prompt-capture'
import { isolatedScanRoots, jsonLines } from '../scanner-fixtures/session-scanner-test-fixtures'
let tempRoots: string[] = []
@@ -1,7 +1,7 @@
import { afterEach, expect, it, vi } from 'vitest'
import { isAiVaultScanCancelledError } from '../../shared/ai-vault/contracts/ai-vault-types'
import { isAiVaultScanCancelledError } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { consumeCompleteJsonlLines } from './session-scanner-jsonl-reader'
import { MAX_SESSION_TRANSCRIPT_RECORD_BYTES } from './transcripts/session-transcript-record-budget'
import { MAX_SESSION_TRANSCRIPT_RECORD_BYTES } from '../transcripts/session-transcript-record-budget'
type ChunkSource = {
chunks: Buffer[]
@@ -11,7 +11,7 @@ type ChunkSource = {
}
const source = vi.hoisted((): ChunkSource => ({ chunks: [], closed: false, opens: 0 }))
vi.mock('../native-chat/wsl-transcript-fs-access', () => ({
vi.mock('../../native-chat/wsl-transcript-fs-access', () => ({
openTranscriptReadStream: async function* () {
source.opens += 1
source.closed = false
@@ -1,14 +1,17 @@
import { throwIfAiVaultScanCancelled, waitForAiVaultScan } from './ai-vault-scan-cancellation'
import {
throwIfAiVaultScanCancelled,
waitForAiVaultScan
} from '../scan-lifecycle/ai-vault-scan-cancellation'
import type { Hash } from 'node:crypto'
import { openTranscriptReadStream } from '../native-chat/wsl-transcript-fs-access'
import { openTranscriptReadStream } from '../../native-chat/wsl-transcript-fs-access'
import {
isZstdTranscriptPath,
zstdTranscriptStream
} from '../native-chat/transcript-zstd-decompression'
} from '../../native-chat/transcript-zstd-decompression'
import {
MAX_SESSION_TRANSCRIPT_RECORD_BYTES,
type SkippedTranscriptRecord
} from './transcripts/session-transcript-record-budget'
} from '../transcripts/session-transcript-record-budget'
const NEWLINE_BYTE = 0x0a
const CARRIAGE_RETURN_BYTE = 0x0d
@@ -1,13 +1,13 @@
import { expect, it } from 'vitest'
import { createAccumulator } from './session-scanner-accumulator'
import { decodeSessionMessage } from './transcripts/session-decoded-message'
import { withFullFirstUserPromptCapture } from './session-scanner-first-user-prompt-capture'
import { decodeSessionMessage } from '../transcripts/session-decoded-message'
import { withFullFirstUserPromptCapture } from '../prompts/session-scanner-first-user-prompt-capture'
import {
addDecodedSessionMessage,
addPreviewMessage,
addSessionContent
} from './session-scanner-messages'
import type { TranscriptMessage } from './transcripts/session-transcript-consumers'
import type { TranscriptMessage } from '../transcripts/session-transcript-consumers'
const AT = '2026-05-01T00:00:00.000Z'
@@ -1,20 +1,20 @@
import type { AiVaultSessionPreviewMessage } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultSessionPreviewMessage } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { timestampIso } from './session-scanner-accumulator'
import {
extractFullFirstUserPromptText,
shouldCaptureFullFirstUserPrompt
} from './session-scanner-first-user-prompt'
} from '../prompts/session-scanner-first-user-prompt'
import {
extractPreviewContentText,
normalizePreviewText,
sliceAtCodeUnitLimit
normalizePreviewText
} from './session-scanner-text-normalization'
import type { SessionAccumulator } from './session-scanner-types'
import { transcriptMessagesFromDecodedMessage } from './transcripts/session-transcript-message-content'
import { sliceAtCodeUnitLimit } from '../../../shared/surrogate-safe-text-slice'
import type { SessionAccumulator } from '../session-scanner-types'
import { transcriptMessagesFromDecodedMessage } from '../transcripts/session-transcript-message-content'
import {
decodeSessionMessage,
type DecodedSessionMessage
} from './transcripts/session-decoded-message'
} from '../transcripts/session-decoded-message'
const SESSION_PREVIEW_MESSAGE_LIMIT = 5
@@ -1,6 +1,6 @@
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import type * as NodeFsPromisesModule from 'node:fs/promises'
import type { SessionFileCandidate } from './session-scanner-types'
import type { SessionFileCandidate } from '../session-scanner-types'
const STALLED_PATH = '\\\\wsl.localhost\\Ubuntu\\home\\ada\\.claude\\projects\\p\\a.jsonl'
@@ -13,19 +13,19 @@ vi.mock('node:fs/promises', async (importOriginal) => ({
readdir: mocks.readdir
}))
import * as transcriptFs from '../native-chat/wsl-transcript-fs-access'
import { parseAgentSessionFileCached } from './parse-cache/session-scanner-parse-cache'
import * as transcriptFs from '../../native-chat/wsl-transcript-fs-access'
import { parseAgentSessionFileCached } from '../parse-cache/session-scanner-parse-cache'
import {
registerTranscriptConsumer,
resetTranscriptConsumersForTests
} from './transcripts/session-transcript-consumers'
import { resetSessionParseCacheForTests } from './parse-cache/session-parse-cache-store'
} from '../transcripts/session-transcript-consumers'
import { resetSessionParseCacheForTests } from '../parse-cache/session-parse-cache-store'
import {
resetWslTranscriptFsGateForTests,
WSL_TRANSCRIPT_FS_ROUTE_QUARANTINE_BASE_MS,
WSL_TRANSCRIPT_FS_SCAN_TIMEOUT_MS,
WslTranscriptFsError
} from '../native-chat/wsl-transcript-fs-gate'
WSL_TRANSCRIPT_FS_SCAN_TIMEOUT_MS
} from '../../native-chat/wsl-transcript-fs-gate'
import { WslTranscriptFsError } from '../../native-chat/wsl-transcript-fs-error'
type ReadResult = { bytesRead: number; buffer: Buffer }
@@ -1,8 +1,8 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
import { Readable } from 'node:stream'
import type * as NodeReadlineModule from 'node:readline'
import type * as WslFsAccessModule from '../native-chat/wsl-transcript-fs-access'
import type { FileWithMtime } from './session-scanner-types'
import type * as WslFsAccessModule from '../../native-chat/wsl-transcript-fs-access'
import type { FileWithMtime } from '../session-scanner-types'
// readline.close() leaves its input open; parser exits must destroy streams to release gated handles.
const mocks = vi.hoisted(() => ({
@@ -12,7 +12,7 @@ const mocks = vi.hoisted(() => ({
createInterface: vi.fn()
}))
vi.mock('../native-chat/wsl-transcript-fs-access', async (importOriginal) => ({
vi.mock('../../native-chat/wsl-transcript-fs-access', async (importOriginal) => ({
...(await importOriginal<typeof WslFsAccessModule>()),
openTranscriptReadStream: mocks.openStream,
wslGatedReadFile: mocks.readFile,
@@ -24,12 +24,12 @@ vi.mock('node:readline', async (importOriginal) => ({
createInterface: mocks.createInterface
}))
import { parseAntigravitySessionFile } from './scanners/antigravity/session-scanner-antigravity-parser'
import { parseDroidSessionFile } from './scanners/droid/session-scanner-droid-parser'
import { parseMessageGraphSessionFile } from './scanners/session-scanner-graph-parsers'
import { parseGrokSessionFile } from './scanners/grok/session-scanner-grok-parser'
import { parseKimiSessionFile } from './scanners/kimi/session-scanner-kimi-parser'
import { clearKimiSessionIndexCache } from './scanners/kimi/session-scanner-kimi-paths'
import { parseAntigravitySessionFile } from '../scanners/antigravity/session-scanner-antigravity-parser'
import { parseDroidSessionFile } from '../scanners/droid/session-scanner-droid-parser'
import { parseMessageGraphSessionFile } from '../scanners/session-scanner-graph-parsers'
import { parseGrokSessionFile } from '../scanners/grok/session-scanner-grok-parser'
import { parseKimiSessionFile } from '../scanners/kimi/session-scanner-kimi-parser'
import { clearKimiSessionIndexCache } from '../scanners/kimi/session-scanner-kimi-paths'
const PARSE_FAILURE = 'parser failed mid-transcript'
@@ -0,0 +1,55 @@
import { appendFile, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, expect, it } from 'vitest'
import { resetSessionParseCacheForTests } from '../parse-cache/session-parse-cache-store'
import { codexFixture } from '../scanners/codex/session-scanner-codex-fixtures'
import { scanAiVaultSessions } from '../session-scanner'
import { isolatedScanRoots } from '../scanner-fixtures/session-scanner-test-fixtures'
import { MAX_SESSION_TRANSCRIPT_RECORD_BYTES } from '../transcripts/session-transcript-record-budget'
import { resetSessionParseCachePersistenceForTests } from '../parse-cache/session-parse-cache-persistence'
// One record past the budget, terminated separately so tests control the newline.
const OVERSIZED = Buffer.alloc(MAX_SESSION_TRANSCRIPT_RECORD_BYTES + 1, 'x')
let tempRoots: string[] = []
afterEach(async () => {
resetSessionParseCachePersistenceForTests()
resetSessionParseCacheForTests()
await Promise.all(tempRoots.map((root) => rm(root, { recursive: true, force: true })))
tempRoots = []
})
async function tempRoot(prefix: string): Promise<string> {
const root = await mkdtemp(join(tmpdir(), prefix))
tempRoots.push(root)
return root
}
it('lists a recovered session without an issue on fresh and cached scans', async () => {
const root = await tempRoot('orca-record-budget-scan-')
const roots = isolatedScanRoots(root)
const fixture = codexFixture()
const dir = roots.codexSessionsDir
const path = join(dir, fixture.fileName)
await mkdir(dir, { recursive: true })
await writeFile(path, `${fixture.seedLines.join('\n')}\n`)
await appendFile(path, '{"type":"compacted","payload":{"message":"')
await appendFile(path, OVERSIZED)
await appendFile(path, `"}}\n${fixture.appendLines.join('\n')}\n`)
for (let scan = 0; scan < 2; scan++) {
const result = await scanAiVaultSessions(roots)
const session = result.sessions.find((entry) => entry.filePath === path)
expect(session?.previewMessages.map((message) => message.text)).toEqual([
'codex seed question',
'codex seed answer',
'codex follow-up',
'codex incremental answer'
])
expect(result.issues).toEqual([])
}
})
@@ -2,10 +2,13 @@ import { mkdtemp, rm, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it } from 'vitest'
import { isAiVaultSessionRecoverableEmpty } from '../../shared/ai-vault/contracts/ai-vault-types'
import { scanAiVaultSessions } from './session-scanner'
import { parseClaudeSessionContent } from './scanners/claude/session-scanner-primary-parsers'
import { isolatedScanRoots, writeJsonlFile } from './session-scanner-test-fixtures'
import { isAiVaultSessionRecoverableEmpty } from '../../../shared/ai-vault/contracts/ai-vault-types'
import { scanAiVaultSessions } from '../session-scanner'
import { parseClaudeSessionContent } from '../scanners/claude/session-scanner-primary-parsers'
import {
isolatedScanRoots,
writeJsonlFile
} from '../scanner-fixtures/session-scanner-test-fixtures'
let tempRoots: string[] = []
@@ -1,14 +1,13 @@
import { homedir } from 'node:os'
import { join } from 'node:path'
import { describe, expect, it } from 'vitest'
import { extractFullFirstUserPromptText } from '../prompts/session-scanner-first-user-prompt'
import {
extractFullFirstUserPromptText,
extractPreviewContentText,
normalizePrimeAgentSessionsDir,
primeAgentSessionsDirFromEnv,
normalizePreviewText,
normalizeTitleText
} from './session-scanner-values'
} from './session-scanner-text-normalization'
import { primeAgentSessionsDirFromEnv } from '../discovery/agent-session-directories'
describe('AI Vault session scanner text values', () => {
it('normalizes compact title text without surfacing hidden context blocks', () => {
@@ -57,24 +56,6 @@ describe('AI Vault session scanner text values', () => {
})
// Drive-relative paths are invalid on POSIX too; native Windows semantics need a Windows runner.
it('falls back to the default root for every non-absolute agent dir', () => {
const fallback = join(homedir(), '.prime', 'agent', 'sessions')
for (const value of [
'/',
'//',
' ',
'',
'.',
'..',
'sessions',
'rel/path',
'C:\\',
'C:/',
'C:foo'
]) {
expect(normalizePrimeAgentSessionsDir(value)).toBe(fallback)
}
})
describe('primeAgentSessionsDirFromEnv', () => {
const defaultDir = join(homedir(), '.prime', 'agent', 'sessions')
@@ -1,7 +1,5 @@
import { sliceAtCodeUnitLimit } from '../../shared/surrogate-safe-text-slice'
import { withoutNativeChatVisualDirectiveLines } from '../../shared/native-chat/native-chat-visual-directive'
export { sliceAtCodeUnitLimit }
import { sliceAtCodeUnitLimit } from '../../../shared/surrogate-safe-text-slice'
import { withoutNativeChatVisualDirectiveLines } from '../../../shared/native-chat/native-chat-visual-directive'
const SESSION_TITLE_TEXT_LIMIT = 96
const SESSION_PREVIEW_TEXT_LIMIT = 220
@@ -27,16 +27,4 @@ describe('session timeline bounds', () => {
})
expect(state.latestTimestampMs).toBe(Date.parse('2026-01-04T00:00:00Z'))
})
it('compares fractional numeric timestamps against the rounded ISO bound', () => {
const state = accumulator()
const base = 1_700_000_000_000
updateTimeline(state, base + 0.9)
updateTimeline(state, base + 0.1)
expect(state.latestTimestampMs).toBe(base + 0.1)
expect(state.createdAt).toBe(new Date(base).toISOString())
updateTimeline(state, base - 0.1)
expect(state.createdAt).toBe(new Date(base - 1).toISOString())
expect(state.latestTimestampMs).toBe(base + 0.1)
})
})
@@ -1,5 +1,5 @@
import type { CodexUsageSnapshot } from './session-scanner-types'
import { asRecord } from './session-scanner-record-value'
import type { CodexUsageSnapshot } from '../session-scanner-types'
import { asRecord } from './session-record-fields'
export function tokenTotal(value: unknown): number {
const usage = asRecord(value)
@@ -1,17 +1,17 @@
import { beforeEach, expect, it, vi } from 'vitest'
import type { AiVaultSession } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultSession } from '../../../shared/ai-vault/contracts/ai-vault-types'
const fixture = vi.hoisted((): { sessions: AiVaultSession[] } => ({
sessions: []
}))
vi.mock('./session-scanner-source-discovery', () => ({
vi.mock('../discovery/session-scanner-source-discovery', () => ({
discoverAiVaultSessionSources: async () => [],
DEFAULT_CODEX_HOME_DIR: '/fixture'
}))
vi.mock('./session-scanner-candidates', () => ({
vi.mock('../discovery/session-scanner-candidates', () => ({
sessionCandidatesFromDiscoveries: async () => candidates()
}))
vi.mock('./parse-cache/session-scanner-parse-cache', () => ({
vi.mock('../parse-cache/session-scanner-parse-cache', () => ({
createSessionParseStats: () => ({
reused: 0,
incremental: 0,
@@ -22,7 +22,7 @@ vi.mock('./parse-cache/session-scanner-parse-cache', () => ({
parseListedSessionFile: async (candidate: { session: AiVaultSession }) => candidate.session
}))
import { scanAiVaultSessions } from './session-scanner'
import { scanAiVaultSessions } from '../session-scanner'
import { ScannedSessionCollection } from './session-root-dedup'
function candidates() {
@@ -1,8 +1,8 @@
import type {
AiVaultFirstUserPromptArgs,
AiVaultFirstUserPromptResult
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { readAiVaultFirstUserPromptInBackground } from './scan-service/session-scanner-background'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { readAiVaultFirstUserPromptInBackground } from '../scan-service/session-scanner-background'
export function handleAiVaultGetFirstUserPrompt(
args?: AiVaultFirstUserPromptArgs
@@ -2,20 +2,20 @@ import type {
AiVaultAgent,
AiVaultSession,
AiVaultFirstUserPromptResult as ReadAiVaultFirstUserPromptResult
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { LOCAL_EXECUTION_HOST_ID, type ExecutionHostId } from '../../shared/execution-host'
import { wslGatedStat } from '../native-chat/wsl-transcript-fs-access'
import { parseAgentSessionFile } from './session-scanner-agent-parser'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { LOCAL_EXECUTION_HOST_ID, type ExecutionHostId } from '../../../shared/execution-host'
import { wslGatedStat } from '../../native-chat/wsl-transcript-fs-access'
import { parseAgentSessionFile } from '../parsing/session-scanner-agent-parser'
import { withFullFirstUserPromptCapture } from './session-scanner-first-user-prompt-capture'
import {
parseOpenCodeSqliteSessionViaWorker,
parseOpenCode2SqliteSessionViaWorker,
parseZcodeSqliteSessionViaWorker
} from './scanners/opencode/reader-transport/session-scanner-opencode-sqlite-worker-spawn'
import { splitOpenCodeSqliteCandidate } from '../../shared/opencode-sqlite-session-path'
import type { FileWithMtime } from './session-scanner-types'
import type { OpenCodeWslRuntime } from './scanners/opencode/reader-transport/session-scanner-opencode-wsl-runtime'
import { configureOpenCodeWslReaders } from './scanners/opencode/reader-transport/session-scanner-opencode-wsl-client'
} from '../scanners/opencode/reader-transport/session-scanner-opencode-sqlite-worker-spawn'
import { splitOpenCodeSqliteCandidate } from '../../../shared/opencode-sqlite-session-path'
import type { FileWithMtime } from '../session-scanner-types'
import type { OpenCodeWslRuntime } from '../scanners/opencode/reader-transport/session-scanner-opencode-wsl-runtime'
import { configureOpenCodeWslReaders } from '../scanners/opencode/reader-transport/session-scanner-opencode-wsl-client'
export type ReadAiVaultFirstUserPromptArgs = {
agent: AiVaultAgent
@@ -1,8 +1,8 @@
import { isKnownHarnessInjectedUserTurnText } from '../../shared/harness-injected-user-turns'
import { isKnownHarnessInjectedUserTurnText } from '../../../shared/harness-injected-user-turns'
import { getFirstUserPromptCaptureMode } from './session-scanner-first-user-prompt-capture'
import { stripGrokUserQueryEnvelope } from './scanners/grok/session-scanner-grok-user-text'
import { stripGrokUserQueryEnvelope } from '../scanners/grok/session-scanner-grok-user-text'
// Import directly to avoid a cycle through the session-scanner-values re-export.
import { sliceAtCodeUnitLimit } from './session-scanner-text-normalization'
import { sliceAtCodeUnitLimit } from '../../../shared/surrogate-safe-text-slice'
// Bound pathological pastes without applying the much smaller list-preview cap.
const FULL_FIRST_USER_PROMPT_SAFETY_LIMIT = 256 * 1024
@@ -2,12 +2,12 @@ import {
isAiVaultScanCancelledError,
type AiVaultListArgs,
type AiVaultListResult
} from '../../shared/ai-vault/contracts/ai-vault-types'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import {
abandonRemoteSessionScanOnCancel,
throwIfAiVaultScanCancelled
} from './ai-vault-scan-cancellation'
import { aiVaultScanIssueResult } from './session-list-results'
} from '../scan-lifecycle/ai-vault-scan-cancellation'
import { aiVaultScanIssueResult } from '../listing/session-list-results'
export type RuntimeAiVaultHostInfo = {
environmentId: string
@@ -1,5 +1,5 @@
import { aiVaultScanIssueText } from '../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { AiVaultChatForkSourceSchema } from '../../shared/ai-vault/contracts/ai-vault-chat-fork-contract'
import { aiVaultScanIssueText } from '../../../shared/ai-vault/scanning/ai-vault-scan-issue-copy'
import { AiVaultChatForkSourceSchema } from '../../../shared/ai-vault/contracts/ai-vault-chat-fork-contract'
import { z } from 'zod'
import {
AI_VAULT_AGENTS,
@@ -8,32 +8,32 @@ import {
type AiVaultListArgs,
type AiVaultListResult,
type AiVaultSession
} from '../../shared/ai-vault/contracts/ai-vault-types'
import { toRuntimeExecutionHostId } from '../../shared/execution-host'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import { toRuntimeExecutionHostId } from '../../../shared/execution-host'
import {
listEnvironments,
resolveEnvironment
} from '../../shared/remote-runtime/host-store/runtime-environment-store'
import { callRuntimeEnvironment } from '../ipc/runtime-environments/runtime-environment-transport-routing'
} from '../../../shared/remote-runtime/host-store/runtime-environment-store'
import { callRuntimeEnvironment } from '../../ipc/runtime-environments/runtime-environment-transport-routing'
import type {
AiVaultPrepareSessionResumeRequest,
AiVaultPrepareSessionResumeResult
} from '../../shared/ai-vault/resume/ai-vault-resume-preparation'
} from '../../../shared/ai-vault/resume/ai-vault-resume-preparation'
import type {
AiVaultSessionTitlesArgs,
AiVaultSessionTitlesResult
} from '../../shared/ai-vault/contracts/ai-vault-session-title'
import { parseAiVaultListResult } from './session-list-result-validation'
import { parseAiVaultSessionTitlesResult } from './session-titles/session-title-result-validation'
import { isGatedOffWslHost } from '../wsl/host-lifecycle/wsl-host-gate'
} from '../../../shared/ai-vault/contracts/ai-vault-session-title'
import { parseAiVaultListResult } from '../listing/session-list-result-validation'
import { parseAiVaultSessionTitlesResult } from '../session-titles/session-title-result-validation'
import { isGatedOffWslHost } from '../../wsl/host-lifecycle/wsl-host-gate'
import type {
AiVaultDeleteSessionArgs,
AiVaultDeleteSessionResult
} from '../../shared/ai-vault/contracts/ai-vault-session-deletion'
} from '../../../shared/ai-vault/contracts/ai-vault-session-deletion'
import {
readRuntimeAiVaultDeleteSessionResponse,
runtimeAiVaultDeleteSessionParams
} from '../../shared/ai-vault/contracts/ai-vault-runtime-session-delete'
} from '../../../shared/ai-vault/contracts/ai-vault-runtime-session-delete'
import type { RuntimeAiVaultHostInfo } from './ai-vault-runtime-scan'
export type RuntimeAiVaultScanOptions = {
@@ -1,7 +1,7 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
const callRuntimeEnvironment = vi.hoisted(() => vi.fn())
vi.mock('../ipc/runtime-environments/runtime-environment-transport-routing', () => ({
vi.mock('../../ipc/runtime-environments/runtime-environment-transport-routing', () => ({
callRuntimeEnvironment
}))
@@ -1,4 +1,4 @@
import { callRuntimeEnvironment } from '../ipc/runtime-environments/runtime-environment-transport-routing'
import { callRuntimeEnvironment } from '../../ipc/runtime-environments/runtime-environment-transport-routing'
// Preserve RPC refusal codes so search recognizes older hosts that lack the method.
export async function callRuntimeSessionSearch(
@@ -2,8 +2,8 @@ import type {
AiVaultScanProgress,
AiVaultScanProgressUpdate,
AiVaultScanWork
} from '../../shared/ai-vault/scanning/ai-vault-scan-progress'
import type { AiVaultServiceScanListener } from './scan-service/session-scanner-service-request-deadline'
} from '../../../shared/ai-vault/scanning/ai-vault-scan-progress'
import type { AiVaultServiceScanListener } from '../scan-service/session-scanner-service-request-deadline'
type Listener = (update: AiVaultScanProgressUpdate) => void
@@ -1,5 +1,5 @@
import { waitForPromiseWithSignal } from '../../shared/abort-signal-reason'
import { AI_VAULT_SCAN_CANCELLED_MESSAGE } from '../../shared/ai-vault/contracts/ai-vault-types'
import { waitForPromiseWithSignal } from '../../../shared/abort-signal-reason'
import { AI_VAULT_SCAN_CANCELLED_MESSAGE } from '../../../shared/ai-vault/contracts/ai-vault-types'
export function throwIfAiVaultScanCancelled(signal?: AbortSignal): void {
if (!signal?.aborted) {
@@ -112,32 +112,6 @@ describe('AiVaultScanCoordinator', () => {
])
})
it('keeps coalescing forced callers onto a forced scan that is still fresh', async () => {
vi.useFakeTimers()
try {
const coordinator = new AiVaultScanCoordinator()
let resolveScan: ((result: typeof EMPTY_RESULT) => void) | undefined
const start = vi.fn(
() =>
new Promise<typeof EMPTY_RESULT>((resolve) => {
resolveScan = resolve
})
)
const first = coordinator.run({ key: 'scope', force: true, start })
await Promise.resolve()
vi.advanceTimersByTime(4_999)
const second = coordinator.run({ key: 'scope', force: true, start })
await Promise.resolve()
expect(start).toHaveBeenCalledTimes(1)
resolveScan?.(EMPTY_RESULT)
await expect(Promise.all([first, second])).resolves.toEqual([EMPTY_RESULT, EMPTY_RESULT])
} finally {
vi.useRealTimers()
}
})
it('lets a forced refresh preempt a forced scan that hung past the coalescing window', async () => {
vi.useFakeTimers()
try {
@@ -2,7 +2,7 @@ import { randomUUID } from 'node:crypto'
import {
AI_VAULT_SCAN_CANCELLED_MESSAGE,
type AiVaultListResult
} from '../../shared/ai-vault/contracts/ai-vault-types'
} from '../../../shared/ai-vault/contracts/ai-vault-types'
// Match the renderer throttle: forced requests share this window before they can preempt a hung scan.
const FORCED_SCAN_PREEMPT_AFTER_MS = 5_000
@@ -0,0 +1,70 @@
import { mkdtemp, rm } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, expect, it, vi } from 'vitest'
import { resetLocalAiVaultScanProgressForTests } from './ai-vault-local-scan-progress'
import * as parseCache from '../parse-cache/session-scanner-parse-cache'
import { aiVaultScanWork, trackAiVaultScanProgress } from './ai-vault-scan-progress'
import { scanAiVaultSessions } from '../session-scanner'
import { resetSessionParseCacheForTests } from '../parse-cache/session-parse-cache-store'
import {
isolatedScanRoots,
writeJsonlFile
} from '../scanner-fixtures/session-scanner-test-fixtures'
// Source fixtures exercise the real SQLite readers without a packaged worker bundle.
vi.mock(
'../scanners/opencode/reader-transport/session-scanner-opencode-sqlite-worker-spawn',
async () => {
const { listOpenCodeSqliteSessions } =
await import('../scanners/opencode/sqlite/session-scanner-opencode-sqlite-list')
const { listOpenCode2SqliteSessions } =
await import('../scanners/opencode2/session-scanner-opencode2-sqlite-list')
const { parseOpenCodeSqliteSession } =
await import('../scanners/opencode/sqlite/session-scanner-opencode-sqlite')
return {
listOpenCode2SqliteSessionsViaWorker: listOpenCode2SqliteSessions,
listOpenCodeSqliteSessionsViaWorker: listOpenCodeSqliteSessions,
listZcodeSqliteSessionsViaWorker: (args: Parameters<typeof listOpenCodeSqliteSessions>[0]) =>
listOpenCodeSqliteSessions({ ...args, agent: 'zcode' }),
parseOpenCodeSqliteSessionViaWorker: parseOpenCodeSqliteSession
}
}
)
let tempRoot: string | null = null
afterEach(async () => {
vi.useRealTimers()
vi.restoreAllMocks()
resetSessionParseCacheForTests()
resetLocalAiVaultScanProgressForTests()
if (tempRoot) {
await rm(tempRoot, { recursive: true, force: true })
tempRoot = null
}
})
it('does not settle a batch interrupted during its real parser invocation', async () => {
tempRoot = await mkdtemp(join(tmpdir(), 'orca-scan-abort-'))
const roots = isolatedScanRoots(tempRoot)
await writeJsonlFile(join(roots.claudeProjectsDir, 'project', 'a.jsonl'), [
{ type: 'user', sessionId: 'a', message: { role: 'user', content: 'Generated' } }
])
const controller = new AbortController()
const original = parseCache.parseListedSessionFile
vi.spyOn(parseCache, 'parseListedSessionFile').mockImplementation(async (...args) => {
const result = await original(...args)
controller.abort()
return result
})
const stop = trackAiVaultScanProgress(controller.signal, () => undefined)
try {
await expect(
scanAiVaultSessions({ ...roots, signal: controller.signal })
).rejects.toMatchObject({ name: 'AbortError' })
expect(aiVaultScanWork(controller.signal)?.read).toEqual({ done: 0, total: 1, skipped: 0 })
} finally {
stop()
}
})
@@ -1,5 +1,5 @@
import type { AiVaultAgent } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanWork } from '../../shared/ai-vault/scanning/ai-vault-scan-progress'
import type { AiVaultAgent } from '../../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanWork } from '../../../shared/ai-vault/scanning/ai-vault-scan-progress'
import { AiVaultScanTally } from './ai-vault-scan-tally'
// Request signals distinguish scans from index-loop and interactive reads through the same readers.
@@ -1,7 +1,10 @@
import { AI_VAULT_AGENTS, type AiVaultAgent } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanWork } from '../../shared/ai-vault/scanning/ai-vault-scan-progress'
import {
AI_VAULT_AGENTS,
type AiVaultAgent
} from '../../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanWork } from '../../../shared/ai-vault/scanning/ai-vault-scan-progress'
import { AiVaultScanWorkload } from './ai-vault-scan-workload'
import { sessionFileExecutionNamespace } from '../../shared/ai-vault/scanning/ai-vault-scope-cwd-match'
import { sessionFileExecutionNamespace } from '../../../shared/ai-vault/scanning/ai-vault-scope-cwd-match'
type AgentTally = {
files: Set<string>
@@ -1,6 +1,6 @@
import type { AiVaultAgent } from '../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanReadingProgress } from '../../shared/ai-vault/scanning/ai-vault-scan-progress'
import type { SessionFileCandidate } from './session-scanner-types'
import type { AiVaultAgent } from '../../../shared/ai-vault/contracts/ai-vault-types'
import type { AiVaultScanReadingProgress } from '../../../shared/ai-vault/scanning/ai-vault-scan-progress'
import type { SessionFileCandidate } from '../session-scanner-types'
type Ownership = { globalRemaining: number; owners: number; parsed: boolean }
export type ScanReadPass = 'global' | 'walk' | 'bucket'
@@ -7,7 +7,7 @@ import type {
AiVaultSessionTitleRequest,
AiVaultSessionTitlesResult
} from '../../../shared/ai-vault/contracts/ai-vault-session-title'
import type { ReadAiVaultFirstUserPromptArgs } from '../session-first-user-prompt-read'
import type { ReadAiVaultFirstUserPromptArgs } from '../prompts/session-first-user-prompt-read'
import {
clearAiVaultServiceRestartCircuit,
@@ -23,7 +23,7 @@ import type {
AiVaultServiceSubagentRequest
} from './session-scanner-service-protocol'
import { isWslUncPath } from '../../../shared/wsl-paths'
import type { LocalAiVaultScanProgressHandle } from '../ai-vault-local-scan-progress'
import type { LocalAiVaultScanProgressHandle } from '../scan-lifecycle/ai-vault-local-scan-progress'
// Let forced refreshes retry after a local service circuit opens.
export function clearAiVaultBackgroundRestartCircuit(): void {
@@ -55,7 +55,7 @@ export async function readAiVaultFirstUserPromptInBackground(
request: ReadAiVaultFirstUserPromptArgs
): Promise<ReadAiVaultFirstUserPromptResult> {
if (process.platform === 'win32' && isWslUncPath(request.filePath)) {
const { localAiVaultScanRoots } = await import('../cached-session-list')
const { localAiVaultScanRoots } = await import('../discovery/ai-vault-scan-roots')
const roots = await localAiVaultScanRoots()
request = { ...request, wslOpenCodeReaders: roots.wslOpenCodeReaders ?? [] }
}
@@ -1,7 +1,7 @@
import { recordRelayedSpan } from '../../observability/tracer'
import type { SessionSearchScanRoots } from '../../ai-vault-search/discovery/session-search-scan-roots'
import type { ChildProcess } from 'node:child_process'
import { createAiVaultScanCancelledError } from '../ai-vault-scan-cancellation'
import { createAiVaultScanCancelledError } from '../scan-lifecycle/ai-vault-scan-cancellation'
import type { AiVaultServiceScanListener } from './session-scanner-service-request-deadline'
import {
AI_VAULT_SERVICE_PROTOCOL_VERSION,

Some files were not shown because too many files have changed in this diff Show More