@aaac/runtime 0.1.51 → 0.1.52

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -177,7 +177,8 @@ function createUserPromptSubmitHandler(config) {
177
177
  const navigationIndex = navResult.navigationIndex;
178
178
  const navigationSummary = renderNavigationIndexPrompt(navigationIndex);
179
179
  const sections = [
180
- "## Project Navigation Index",
180
+ // renderNavigationIndexPrompt already emits the "## Project Navigation
181
+ // Index" heading — don't duplicate it here.
181
182
  navigationSummary,
182
183
  "",
183
184
  "> Use `analyzer.getContextMap` with candidate paths/artifacts from the index",
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../src/lib/claude-native/ensure-navigation-index.ts","../../../src/lib/claude-native/file-suggestion.ts","../../../src/lib/claude-native/session-start.ts","../../../src/lib/claude-native/user-prompt-submit.ts","../../../src/lib/claude-native/workspace-session-start.ts"],"sourcesContent":["/**\n * Ensure Navigation Index — cache warm / invalidation.\n *\n * Checks cache freshness via source file mtime comparison. If stale,\n * calls buildNavigationContext() and writes to .claude/cache/.\n * If fresh, returns cached data immediately.\n *\n * This is the performance-critical path for SessionStart hooks.\n */\n\nimport { stat } from \"node:fs/promises\";\nimport { buildNavigationContext, type NavigationContextOptions } from \"../navigation-context.js\";\nimport {\n createCacheStore,\n computeSourceHash,\n type CacheStore,\n} from \"./cache-store.js\";\nimport { createExclusiveLock } from \"./latency.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface EnsureNavigationIndexOptions {\n /** Absolute path to .claude/cache/ directory. */\n cacheDir: string;\n /** Paths to source files whose mtime drives cache invalidation. */\n sourceFiles: string[];\n /** Options for buildNavigationContext() when cache is stale. */\n navigationOptions: NavigationContextOptions;\n /**\n * Cache key for the stored JSON file (default: `\"navigation-index\"`).\n *\n * In workspace mode each member uses its own key, e.g.\n * `\"navigation-index.aaac\"`, so their caches remain isolated.\n * Single-component callers omit this field and the default preserves\n * byte-identical behaviour with previous versions.\n */\n cacheKey?: string;\n}\n\nexport interface NavigationIndexResult {\n navigationIndex: Record<string, unknown>;\n /** Whether the result was loaded from cache (true) or freshly built (false). */\n fromCache: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_CACHE_KEY = \"navigation-index\";\n\n/**\n * Per-key exclusive locks so concurrent session-start calls for distinct\n * workspace members can build their indices in parallel, while duplicate calls\n * for the same key are deduplicated (share the in-flight promise).\n */\nconst buildLocks = new Map<string, ReturnType<typeof createExclusiveLock<NavigationIndexResult>>>();\n\nfunction getBuildLock(key: string): ReturnType<typeof createExclusiveLock<NavigationIndexResult>> {\n let lock = buildLocks.get(key);\n if (!lock) {\n lock = createExclusiveLock<NavigationIndexResult>();\n buildLocks.set(key, lock);\n }\n return lock;\n}\n\n/**\n * Collect mtimes for source files and produce a cache hash.\n */\nasync function computeCurrentHash(sourceFiles: string[]): Promise<string> {\n const mtimes: Array<string | number> = [];\n for (const file of sourceFiles) {\n try {\n const s = await stat(file);\n mtimes.push(s.mtimeMs);\n } catch {\n // File not found — include a sentinel so hash changes if file appears\n mtimes.push(`missing:${file}`);\n }\n }\n return computeSourceHash(mtimes);\n}\n\n/**\n * Ensure the navigation index is available and fresh. Returns the index\n * data, building + caching if necessary.\n *\n * In workspace mode, pass a unique `cacheKey` per member (e.g.\n * `\"navigation-index.aaac\"`) so each member's index is stored and\n * invalidated independently.\n */\nexport async function ensureNavigationIndex(\n options: EnsureNavigationIndexOptions,\n): Promise<NavigationIndexResult> {\n const cacheKey = options.cacheKey ?? DEFAULT_CACHE_KEY;\n\n return getBuildLock(cacheKey).run(async () => {\n const store: CacheStore = createCacheStore({ cacheDir: options.cacheDir });\n const currentHash = await computeCurrentHash(options.sourceFiles);\n\n // Try cache first\n const cached = await store.readIfFresh<Record<string, unknown>>(\n cacheKey,\n currentHash,\n );\n if (cached) {\n return { navigationIndex: cached, fromCache: true };\n }\n\n // Cache miss or stale — rebuild\n const context = await buildNavigationContext(options.navigationOptions);\n const navigationIndex = context.navigationIndex;\n\n // Write to cache (non-blocking error handling)\n try {\n await store.write(cacheKey, navigationIndex, currentHash);\n } catch {\n // Cache write failure is non-fatal\n }\n\n return { navigationIndex, fromCache: false };\n });\n}\n","/**\n * File Suggestion Handler — artifact-aware @ completion for Claude Code.\n *\n * Reads stdin prefix, filters navigation-index artifacts, and emits NDJSON\n * candidates sorted by relevance score.\n */\n\nimport { listArtifacts, type NavigationArtifact } from \"./artifact-resolver.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface FileSuggestionCandidate {\n label: string;\n path: string;\n kind: \"artifact\" | \"file\";\n /** Artifact ID this file/pattern belongs to. */\n artifact?: string;\n /** Authority of the artifact (canonical, generated, etc.). */\n authority?: string;\n /** Manual edit policy for the artifact. */\n manual_edit?: string;\n /** Relevance score (higher = more relevant). */\n score: number;\n}\n\nexport interface FileSuggestionOptions {\n /** The navigation index to search. */\n navigationIndex: Record<string, unknown>;\n /** Maximum number of candidates to return. */\n maxCandidates?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_MAX_CANDIDATES = 100;\n\n/**\n * Generate file suggestion candidates from the navigation index.\n * Filters by prefix if provided, then returns NDJSON-formatted candidates.\n */\nexport function generateCandidates(\n prefix: string,\n options: FileSuggestionOptions,\n): FileSuggestionCandidate[] {\n const { navigationIndex, maxCandidates = DEFAULT_MAX_CANDIDATES } = options;\n const artifacts = listArtifacts(navigationIndex);\n const candidates: FileSuggestionCandidate[] = [];\n const lowerPrefix = prefix.toLowerCase();\n\n for (const { id, artifact } of artifacts) {\n const props = artifact.properties ?? {};\n const patterns = artifact.files?.path_patterns ?? [];\n\n // Artifact-level candidate\n if (!prefix || id.toLowerCase().includes(lowerPrefix)) {\n candidates.push({\n label: id,\n path: patterns.length > 0 ? String(patterns[0]) : id,\n kind: \"artifact\",\n authority: props.authority as string | undefined,\n manual_edit: props.manual_edit as string | undefined,\n score: computeArtifactScore(id, artifact, prefix),\n });\n }\n\n // File-level candidates from path patterns\n for (const pattern of patterns) {\n if (typeof pattern !== \"string\") continue;\n // Skip pure glob patterns for file-level suggestions (they're covered by artifact-level)\n if (pattern.includes(\"*\") || pattern.includes(\"?\")) continue;\n\n if (!prefix || pattern.toLowerCase().includes(lowerPrefix)) {\n candidates.push({\n label: pattern,\n path: pattern,\n kind: \"file\",\n artifact: id,\n authority: props.authority as string | undefined,\n manual_edit: props.manual_edit as string | undefined,\n score: computeFileScore(pattern, prefix),\n });\n }\n }\n }\n\n // Sort by score descending, then by label\n candidates.sort((a, b) => {\n if (b.score !== a.score) return b.score - a.score;\n return a.label.localeCompare(b.label);\n });\n\n return candidates.slice(0, maxCandidates);\n}\n\n/**\n * Format candidates as NDJSON (one JSON object per line).\n */\nexport function formatNdjson(candidates: FileSuggestionCandidate[]): string {\n return candidates.map((c) => JSON.stringify(c)).join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// Scoring helpers\n// ---------------------------------------------------------------------------\n\nfunction computeArtifactScore(\n id: string,\n artifact: NavigationArtifact,\n prefix: string,\n): number {\n let score = 50;\n const props = artifact.properties ?? {};\n\n // Boost canonical, editable artifacts\n if (props.authority === \"canonical\") score += 20;\n if (props.manual_edit === \"allowed\") score += 10;\n\n // Boost source artifacts\n if (props.type === \"source\") score += 15;\n\n // Penalize generated artifacts\n if (props.authority === \"generated\") score -= 20;\n if (props.manual_edit === \"forbidden\") score -= 10;\n\n // Boost exact prefix match\n if (prefix && id.toLowerCase().startsWith(prefix.toLowerCase())) {\n score += 20;\n }\n\n return score;\n}\n\nfunction computeFileScore(path: string, prefix: string): number {\n let score = 40;\n\n // Boost exact prefix match\n if (prefix && path.toLowerCase().startsWith(prefix.toLowerCase())) {\n score += 30;\n }\n\n // Boost shorter paths (more specific)\n score += Math.max(0, 20 - path.split(\"/\").length * 2);\n\n return score;\n}\n\n/**\n * Main handler for file-suggestion bin script.\n * Reads prefix from stdin, returns NDJSON candidates to stdout.\n */\nexport async function handleFileSuggestion(\n navigationIndex: Record<string, unknown>,\n stdinData: string,\n): Promise<string> {\n const prefix = stdinData.trim();\n const candidates = generateCandidates(prefix, { navigationIndex });\n return formatNdjson(candidates);\n}\n","/**\n * SessionStart Hook Handler — cache warm + navigation-index summary injection.\n *\n * Executed on session new/resume/clear/compact events. Warms the navigation-index\n * cache and returns a rendered summary as additionalContext.\n *\n * Latency constraint: NO AST analysis or ContextPack generation.\n */\n\nimport { renderNavigationIndexPrompt } from \"../task-runner.js\";\nimport {\n ensureNavigationIndex,\n type EnsureNavigationIndexOptions,\n} from \"./ensure-navigation-index.js\";\nimport {\n buildContextResponse,\n type HookOutput,\n type SessionStartInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface SessionStartHandlerConfig {\n /** Absolute path to .claude/cache/ directory. */\n cacheDir: string;\n /** Source files for cache invalidation (component.yaml, agent-contracts.yaml, etc.). */\n sourceFiles: string[];\n /** Options for buildNavigationContext(). */\n navigationOptions: EnsureNavigationIndexOptions[\"navigationOptions\"];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a SessionStart hook handler.\n */\nexport function createSessionStartHandler(config: SessionStartHandlerConfig) {\n return async function handleSessionStart(\n _input: SessionStartInput,\n ): Promise<HookOutput> {\n const result = await ensureNavigationIndex({\n cacheDir: config.cacheDir,\n sourceFiles: config.sourceFiles,\n navigationOptions: config.navigationOptions,\n });\n\n const summary = renderNavigationIndexPrompt(result.navigationIndex);\n const cacheNote = result.fromCache\n ? \"(loaded from cache)\"\n : \"(freshly built)\";\n\n const additionalContext = [\n summary,\n \"\",\n `Navigation index ${cacheNote}. Use analyzer MCP tools for deep investigation.`,\n ].join(\"\\n\");\n\n return buildContextResponse(\"SessionStart\", additionalContext);\n };\n}\n","/**\n * UserPromptSubmit Hook Handler — navigation-index summary injection.\n *\n * Executed after prompt submission, before Claude processes it. Provides a\n * compact navigation-index summary so the LLM can pick candidates and delegate\n * deep exploration to `analyzer.getContextMap` (Level 2).\n *\n * ContextPack is NOT pre-injected by default (#206 Phase D).\n */\n\nimport { renderNavigationIndexPrompt } from \"../task-runner.js\";\nimport {\n ensureNavigationIndex,\n type EnsureNavigationIndexOptions,\n} from \"./ensure-navigation-index.js\";\nimport {\n listArtifacts,\n} from \"./artifact-resolver.js\";\nimport {\n buildContextResponse,\n type HookOutput,\n type UserPromptSubmitInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface UserPromptSubmitHandlerConfig {\n /** Absolute path to the project root. */\n projectRoot: string;\n /** Absolute path to .claude/cache/ directory. */\n cacheDir: string;\n /** Source files for cache invalidation. */\n sourceFiles: string[];\n /** Options for buildNavigationContext(). */\n navigationOptions: EnsureNavigationIndexOptions[\"navigationOptions\"];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a UserPromptSubmit hook handler.\n */\nexport function createUserPromptSubmitHandler(\n config: UserPromptSubmitHandlerConfig,\n) {\n return async function handleUserPromptSubmit(\n input: UserPromptSubmitInput,\n ): Promise<HookOutput> {\n const prompt = input.prompt ?? \"\";\n\n const navResult = await ensureNavigationIndex({\n cacheDir: config.cacheDir,\n sourceFiles: config.sourceFiles,\n navigationOptions: config.navigationOptions,\n });\n const navigationIndex = navResult.navigationIndex;\n const navigationSummary = renderNavigationIndexPrompt(navigationIndex);\n\n const sections: string[] = [\n \"## Project Navigation Index\",\n navigationSummary,\n \"\",\n \"> Use `analyzer.getContextMap` with candidate paths/artifacts from the index\",\n \"> when you need structured dependency and read-target guidance.\",\n ];\n\n const candidates = extractCandidateArtifacts(prompt, navigationIndex);\n if (candidates.length > 0) {\n const candidateLines = candidates.map((c) => {\n const props = c.artifact.properties ?? {};\n const tags = [props.type, props.authority, props.manual_edit ? `edit:${props.manual_edit}` : \"\"]\n .filter(Boolean)\n .join(\", \");\n return `- ${c.artifactId} [${tags}]`;\n });\n sections.push(\n \"## Candidate Artifacts (from prompt keywords)\\n\" + candidateLines.join(\"\\n\"),\n );\n }\n\n const additionalContext = sections.join(\"\\n\");\n return buildContextResponse(\"UserPromptSubmit\", additionalContext);\n };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\ninterface CandidateArtifact {\n artifactId: string;\n artifact: ReturnType<typeof listArtifacts>[number][\"artifact\"];\n}\n\nfunction extractCandidateArtifacts(\n prompt: string,\n navigationIndex: Record<string, unknown>,\n): CandidateArtifact[] {\n if (!prompt.trim()) return [];\n\n const artifacts = listArtifacts(navigationIndex);\n const lowerPrompt = prompt.toLowerCase();\n const matches: CandidateArtifact[] = [];\n const seen = new Set<string>();\n\n for (const { id, artifact } of artifacts) {\n if (lowerPrompt.includes(id.toLowerCase()) && !seen.has(id)) {\n seen.add(id);\n matches.push({ artifactId: id, artifact });\n continue;\n }\n\n const patterns = artifact.files?.path_patterns ?? [];\n for (const pattern of patterns) {\n if (typeof pattern !== \"string\") continue;\n const literal = pattern.replace(/[*?]/g, \"\").replace(/\\{.*\\}/g, \"\");\n if (literal.length > 3 && lowerPrompt.includes(literal.toLowerCase()) && !seen.has(id)) {\n seen.add(id);\n matches.push({ artifactId: id, artifact });\n break;\n }\n }\n }\n\n return matches;\n}\n","/**\n * Workspace SessionStart Hook Handler — per-member navigation-index warm-up.\n *\n * Builds (or validates) a cached navigation-index for each declared workspace\n * member in parallel, then returns a combined summary as `additionalContext`.\n *\n * This module is in the **heavy** path (imports ensureNavigationIndex →\n * navigation-context → agent-contracts) and is therefore NOT included in the\n * lean hooks-lite entry point. SessionStart fires only once per session, so\n * the higher import cost is acceptable.\n */\n\nimport { renderNavigationIndexPrompt } from \"../task-runner.js\";\nimport {\n ensureNavigationIndex,\n type EnsureNavigationIndexOptions,\n} from \"./ensure-navigation-index.js\";\nimport {\n buildContextResponse,\n type HookOutput,\n type SessionStartInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface WorkspaceMemberSessionConfig {\n /** Human-readable member name (e.g. `\"aaac\"`). */\n name: string;\n /** Absolute path to member root directory. */\n root: string;\n /**\n * Unique cache key for this member's navigation-index JSON.\n * Format: `navigation-index.<name>`.\n */\n cacheKey: string;\n /** Source files for mtime-based cache invalidation. */\n sourceFiles: string[];\n /** Options passed to `buildNavigationContext()` on cache miss. */\n navigationOptions: EnsureNavigationIndexOptions[\"navigationOptions\"];\n}\n\nexport interface WorkspaceSessionStartConfig {\n /** Absolute path to the shared `.claude/cache/` directory. */\n cacheDir: string;\n /** Workspace members to build/validate indices for. */\n members: WorkspaceMemberSessionConfig[];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a workspace-aware SessionStart hook handler.\n *\n * All member navigation-indices are built in **parallel** (each key has its\n * own exclusive lock so concurrent calls for the same member deduplicate\n * rather than queue behind other members).\n */\nexport function createWorkspaceSessionStartHandler(\n config: WorkspaceSessionStartConfig,\n) {\n return async function handleWorkspaceSessionStart(\n _input: SessionStartInput,\n ): Promise<HookOutput> {\n // Build all member indices concurrently\n const results = await Promise.all(\n config.members.map(async (member) => {\n const result = await ensureNavigationIndex({\n cacheDir: config.cacheDir,\n sourceFiles: member.sourceFiles,\n navigationOptions: member.navigationOptions,\n cacheKey: member.cacheKey,\n });\n return { member, result };\n }),\n );\n\n // Aggregate summaries\n const sections: string[] = [];\n for (const { member, result } of results) {\n const summary = renderNavigationIndexPrompt(result.navigationIndex);\n const cacheNote = result.fromCache ? \"(loaded from cache)\" : \"(freshly built)\";\n sections.push(\n `### Member: ${member.name} ${cacheNote}\\n${summary}`,\n );\n }\n\n const additionalContext = [\n sections.join(\"\\n\\n\"),\n \"\",\n \"Workspace navigation indices ready. Use analyzer MCP tools for deep investigation.\",\n ].join(\"\\n\");\n\n return buildContextResponse(\"SessionStart\", additionalContext);\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,SAAS,YAAY;AAyCrB,IAAM,oBAAoB;AAO1B,IAAM,aAAa,oBAAI,IAA2E;AAElG,SAAS,aAAa,KAA4E;AAChG,MAAI,OAAO,WAAW,IAAI,GAAG;AAC7B,MAAI,CAAC,MAAM;AACT,WAAO,oBAA2C;AAClD,eAAW,IAAI,KAAK,IAAI;AAAA,EAC1B;AACA,SAAO;AACT;AAKA,eAAe,mBAAmB,aAAwC;AACxE,QAAM,SAAiC,CAAC;AACxC,aAAW,QAAQ,aAAa;AAC9B,QAAI;AACF,YAAM,IAAI,MAAM,KAAK,IAAI;AACzB,aAAO,KAAK,EAAE,OAAO;AAAA,IACvB,QAAQ;AAEN,aAAO,KAAK,WAAW,IAAI,EAAE;AAAA,IAC/B;AAAA,EACF;AACA,SAAO,kBAAkB,MAAM;AACjC;AAUA,eAAsB,sBACpB,SACgC;AAChC,QAAM,WAAW,QAAQ,YAAY;AAErC,SAAO,aAAa,QAAQ,EAAE,IAAI,YAAY;AAC5C,UAAM,QAAoB,iBAAiB,EAAE,UAAU,QAAQ,SAAS,CAAC;AACzE,UAAM,cAAc,MAAM,mBAAmB,QAAQ,WAAW;AAGhE,UAAM,SAAS,MAAM,MAAM;AAAA,MACzB;AAAA,MACA;AAAA,IACF;AACA,QAAI,QAAQ;AACV,aAAO,EAAE,iBAAiB,QAAQ,WAAW,KAAK;AAAA,IACpD;AAGA,UAAM,UAAU,MAAM,uBAAuB,QAAQ,iBAAiB;AACtE,UAAM,kBAAkB,QAAQ;AAGhC,QAAI;AACF,YAAM,MAAM,MAAM,UAAU,iBAAiB,WAAW;AAAA,IAC1D,QAAQ;AAAA,IAER;AAEA,WAAO,EAAE,iBAAiB,WAAW,MAAM;AAAA,EAC7C,CAAC;AACH;;;ACvFA,IAAM,yBAAyB;AAMxB,SAAS,mBACd,QACA,SAC2B;AAC3B,QAAM,EAAE,iBAAiB,gBAAgB,uBAAuB,IAAI;AACpE,QAAM,YAAY,cAAc,eAAe;AAC/C,QAAM,aAAwC,CAAC;AAC/C,QAAM,cAAc,OAAO,YAAY;AAEvC,aAAW,EAAE,IAAI,SAAS,KAAK,WAAW;AACxC,UAAM,QAAQ,SAAS,cAAc,CAAC;AACtC,UAAM,WAAW,SAAS,OAAO,iBAAiB,CAAC;AAGnD,QAAI,CAAC,UAAU,GAAG,YAAY,EAAE,SAAS,WAAW,GAAG;AACrD,iBAAW,KAAK;AAAA,QACd,OAAO;AAAA,QACP,MAAM,SAAS,SAAS,IAAI,OAAO,SAAS,CAAC,CAAC,IAAI;AAAA,QAClD,MAAM;AAAA,QACN,WAAW,MAAM;AAAA,QACjB,aAAa,MAAM;AAAA,QACnB,OAAO,qBAAqB,IAAI,UAAU,MAAM;AAAA,MAClD,CAAC;AAAA,IACH;AAGA,eAAW,WAAW,UAAU;AAC9B,UAAI,OAAO,YAAY,SAAU;AAEjC,UAAI,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,GAAG,EAAG;AAEpD,UAAI,CAAC,UAAU,QAAQ,YAAY,EAAE,SAAS,WAAW,GAAG;AAC1D,mBAAW,KAAK;AAAA,UACd,OAAO;AAAA,UACP,MAAM;AAAA,UACN,MAAM;AAAA,UACN,UAAU;AAAA,UACV,WAAW,MAAM;AAAA,UACjB,aAAa,MAAM;AAAA,UACnB,OAAO,iBAAiB,SAAS,MAAM;AAAA,QACzC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,KAAK,CAAC,GAAG,MAAM;AACxB,QAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,WAAO,EAAE,MAAM,cAAc,EAAE,KAAK;AAAA,EACtC,CAAC;AAED,SAAO,WAAW,MAAM,GAAG,aAAa;AAC1C;AAKO,SAAS,aAAa,YAA+C;AAC1E,SAAO,WAAW,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,EAAE,KAAK,IAAI;AAC3D;AAMA,SAAS,qBACP,IACA,UACA,QACQ;AACR,MAAI,QAAQ;AACZ,QAAM,QAAQ,SAAS,cAAc,CAAC;AAGtC,MAAI,MAAM,cAAc,YAAa,UAAS;AAC9C,MAAI,MAAM,gBAAgB,UAAW,UAAS;AAG9C,MAAI,MAAM,SAAS,SAAU,UAAS;AAGtC,MAAI,MAAM,cAAc,YAAa,UAAS;AAC9C,MAAI,MAAM,gBAAgB,YAAa,UAAS;AAGhD,MAAI,UAAU,GAAG,YAAY,EAAE,WAAW,OAAO,YAAY,CAAC,GAAG;AAC/D,aAAS;AAAA,EACX;AAEA,SAAO;AACT;AAEA,SAAS,iBAAiB,MAAc,QAAwB;AAC9D,MAAI,QAAQ;AAGZ,MAAI,UAAU,KAAK,YAAY,EAAE,WAAW,OAAO,YAAY,CAAC,GAAG;AACjE,aAAS;AAAA,EACX;AAGA,WAAS,KAAK,IAAI,GAAG,KAAK,KAAK,MAAM,GAAG,EAAE,SAAS,CAAC;AAEpD,SAAO;AACT;AAMA,eAAsB,qBACpB,iBACA,WACiB;AACjB,QAAM,SAAS,UAAU,KAAK;AAC9B,QAAM,aAAa,mBAAmB,QAAQ,EAAE,gBAAgB,CAAC;AACjE,SAAO,aAAa,UAAU;AAChC;;;ACzHO,SAAS,0BAA0B,QAAmC;AAC3E,SAAO,eAAe,mBACpB,QACqB;AACrB,UAAM,SAAS,MAAM,sBAAsB;AAAA,MACzC,UAAU,OAAO;AAAA,MACjB,aAAa,OAAO;AAAA,MACpB,mBAAmB,OAAO;AAAA,IAC5B,CAAC;AAED,UAAM,UAAU,4BAA4B,OAAO,eAAe;AAClE,UAAM,YAAY,OAAO,YACrB,wBACA;AAEJ,UAAM,oBAAoB;AAAA,MACxB;AAAA,MACA;AAAA,MACA,oBAAoB,SAAS;AAAA,IAC/B,EAAE,KAAK,IAAI;AAEX,WAAO,qBAAqB,gBAAgB,iBAAiB;AAAA,EAC/D;AACF;;;ACjBO,SAAS,8BACd,QACA;AACA,SAAO,eAAe,uBACpB,OACqB;AACrB,UAAM,SAAS,MAAM,UAAU;AAE/B,UAAM,YAAY,MAAM,sBAAsB;AAAA,MAC5C,UAAU,OAAO;AAAA,MACjB,aAAa,OAAO;AAAA,MACpB,mBAAmB,OAAO;AAAA,IAC5B,CAAC;AACD,UAAM,kBAAkB,UAAU;AAClC,UAAM,oBAAoB,4BAA4B,eAAe;AAErE,UAAM,WAAqB;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,UAAM,aAAa,0BAA0B,QAAQ,eAAe;AACpE,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,iBAAiB,WAAW,IAAI,CAAC,MAAM;AAC3C,cAAM,QAAQ,EAAE,SAAS,cAAc,CAAC;AACxC,cAAM,OAAO,CAAC,MAAM,MAAM,MAAM,WAAW,MAAM,cAAc,QAAQ,MAAM,WAAW,KAAK,EAAE,EAC5F,OAAO,OAAO,EACd,KAAK,IAAI;AACZ,eAAO,KAAK,EAAE,UAAU,KAAK,IAAI;AAAA,MACnC,CAAC;AACD,eAAS;AAAA,QACP,oDAAoD,eAAe,KAAK,IAAI;AAAA,MAC9E;AAAA,IACF;AAEA,UAAM,oBAAoB,SAAS,KAAK,IAAI;AAC5C,WAAO,qBAAqB,oBAAoB,iBAAiB;AAAA,EACnE;AACF;AAWA,SAAS,0BACP,QACA,iBACqB;AACrB,MAAI,CAAC,OAAO,KAAK,EAAG,QAAO,CAAC;AAE5B,QAAM,YAAY,cAAc,eAAe;AAC/C,QAAM,cAAc,OAAO,YAAY;AACvC,QAAM,UAA+B,CAAC;AACtC,QAAM,OAAO,oBAAI,IAAY;AAE7B,aAAW,EAAE,IAAI,SAAS,KAAK,WAAW;AACxC,QAAI,YAAY,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,GAAG;AAC3D,WAAK,IAAI,EAAE;AACX,cAAQ,KAAK,EAAE,YAAY,IAAI,SAAS,CAAC;AACzC;AAAA,IACF;AAEA,UAAM,WAAW,SAAS,OAAO,iBAAiB,CAAC;AACnD,eAAW,WAAW,UAAU;AAC9B,UAAI,OAAO,YAAY,SAAU;AACjC,YAAM,UAAU,QAAQ,QAAQ,SAAS,EAAE,EAAE,QAAQ,WAAW,EAAE;AAClE,UAAI,QAAQ,SAAS,KAAK,YAAY,SAAS,QAAQ,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,GAAG;AACtF,aAAK,IAAI,EAAE;AACX,gBAAQ,KAAK,EAAE,YAAY,IAAI,SAAS,CAAC;AACzC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;ACpEO,SAAS,mCACd,QACA;AACA,SAAO,eAAe,4BACpB,QACqB;AAErB,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,OAAO,QAAQ,IAAI,OAAO,WAAW;AACnC,cAAM,SAAS,MAAM,sBAAsB;AAAA,UACzC,UAAU,OAAO;AAAA,UACjB,aAAa,OAAO;AAAA,UACpB,mBAAmB,OAAO;AAAA,UAC1B,UAAU,OAAO;AAAA,QACnB,CAAC;AACD,eAAO,EAAE,QAAQ,OAAO;AAAA,MAC1B,CAAC;AAAA,IACH;AAGA,UAAM,WAAqB,CAAC;AAC5B,eAAW,EAAE,QAAQ,OAAO,KAAK,SAAS;AACxC,YAAM,UAAU,4BAA4B,OAAO,eAAe;AAClE,YAAM,YAAY,OAAO,YAAY,wBAAwB;AAC7D,eAAS;AAAA,QACP,eAAe,OAAO,IAAI,IAAI,SAAS;AAAA,EAAK,OAAO;AAAA,MACrD;AAAA,IACF;AAEA,UAAM,oBAAoB;AAAA,MACxB,SAAS,KAAK,MAAM;AAAA,MACpB;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAEX,WAAO,qBAAqB,gBAAgB,iBAAiB;AAAA,EAC/D;AACF;","names":[]}
1
+ {"version":3,"sources":["../../../src/lib/claude-native/ensure-navigation-index.ts","../../../src/lib/claude-native/file-suggestion.ts","../../../src/lib/claude-native/session-start.ts","../../../src/lib/claude-native/user-prompt-submit.ts","../../../src/lib/claude-native/workspace-session-start.ts"],"sourcesContent":["/**\n * Ensure Navigation Index — cache warm / invalidation.\n *\n * Checks cache freshness via source file mtime comparison. If stale,\n * calls buildNavigationContext() and writes to .claude/cache/.\n * If fresh, returns cached data immediately.\n *\n * This is the performance-critical path for SessionStart hooks.\n */\n\nimport { stat } from \"node:fs/promises\";\nimport { buildNavigationContext, type NavigationContextOptions } from \"../navigation-context.js\";\nimport {\n createCacheStore,\n computeSourceHash,\n type CacheStore,\n} from \"./cache-store.js\";\nimport { createExclusiveLock } from \"./latency.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface EnsureNavigationIndexOptions {\n /** Absolute path to .claude/cache/ directory. */\n cacheDir: string;\n /** Paths to source files whose mtime drives cache invalidation. */\n sourceFiles: string[];\n /** Options for buildNavigationContext() when cache is stale. */\n navigationOptions: NavigationContextOptions;\n /**\n * Cache key for the stored JSON file (default: `\"navigation-index\"`).\n *\n * In workspace mode each member uses its own key, e.g.\n * `\"navigation-index.aaac\"`, so their caches remain isolated.\n * Single-component callers omit this field and the default preserves\n * byte-identical behaviour with previous versions.\n */\n cacheKey?: string;\n}\n\nexport interface NavigationIndexResult {\n navigationIndex: Record<string, unknown>;\n /** Whether the result was loaded from cache (true) or freshly built (false). */\n fromCache: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_CACHE_KEY = \"navigation-index\";\n\n/**\n * Per-key exclusive locks so concurrent session-start calls for distinct\n * workspace members can build their indices in parallel, while duplicate calls\n * for the same key are deduplicated (share the in-flight promise).\n */\nconst buildLocks = new Map<string, ReturnType<typeof createExclusiveLock<NavigationIndexResult>>>();\n\nfunction getBuildLock(key: string): ReturnType<typeof createExclusiveLock<NavigationIndexResult>> {\n let lock = buildLocks.get(key);\n if (!lock) {\n lock = createExclusiveLock<NavigationIndexResult>();\n buildLocks.set(key, lock);\n }\n return lock;\n}\n\n/**\n * Collect mtimes for source files and produce a cache hash.\n */\nasync function computeCurrentHash(sourceFiles: string[]): Promise<string> {\n const mtimes: Array<string | number> = [];\n for (const file of sourceFiles) {\n try {\n const s = await stat(file);\n mtimes.push(s.mtimeMs);\n } catch {\n // File not found — include a sentinel so hash changes if file appears\n mtimes.push(`missing:${file}`);\n }\n }\n return computeSourceHash(mtimes);\n}\n\n/**\n * Ensure the navigation index is available and fresh. Returns the index\n * data, building + caching if necessary.\n *\n * In workspace mode, pass a unique `cacheKey` per member (e.g.\n * `\"navigation-index.aaac\"`) so each member's index is stored and\n * invalidated independently.\n */\nexport async function ensureNavigationIndex(\n options: EnsureNavigationIndexOptions,\n): Promise<NavigationIndexResult> {\n const cacheKey = options.cacheKey ?? DEFAULT_CACHE_KEY;\n\n return getBuildLock(cacheKey).run(async () => {\n const store: CacheStore = createCacheStore({ cacheDir: options.cacheDir });\n const currentHash = await computeCurrentHash(options.sourceFiles);\n\n // Try cache first\n const cached = await store.readIfFresh<Record<string, unknown>>(\n cacheKey,\n currentHash,\n );\n if (cached) {\n return { navigationIndex: cached, fromCache: true };\n }\n\n // Cache miss or stale — rebuild\n const context = await buildNavigationContext(options.navigationOptions);\n const navigationIndex = context.navigationIndex;\n\n // Write to cache (non-blocking error handling)\n try {\n await store.write(cacheKey, navigationIndex, currentHash);\n } catch {\n // Cache write failure is non-fatal\n }\n\n return { navigationIndex, fromCache: false };\n });\n}\n","/**\n * File Suggestion Handler — artifact-aware @ completion for Claude Code.\n *\n * Reads stdin prefix, filters navigation-index artifacts, and emits NDJSON\n * candidates sorted by relevance score.\n */\n\nimport { listArtifacts, type NavigationArtifact } from \"./artifact-resolver.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface FileSuggestionCandidate {\n label: string;\n path: string;\n kind: \"artifact\" | \"file\";\n /** Artifact ID this file/pattern belongs to. */\n artifact?: string;\n /** Authority of the artifact (canonical, generated, etc.). */\n authority?: string;\n /** Manual edit policy for the artifact. */\n manual_edit?: string;\n /** Relevance score (higher = more relevant). */\n score: number;\n}\n\nexport interface FileSuggestionOptions {\n /** The navigation index to search. */\n navigationIndex: Record<string, unknown>;\n /** Maximum number of candidates to return. */\n maxCandidates?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_MAX_CANDIDATES = 100;\n\n/**\n * Generate file suggestion candidates from the navigation index.\n * Filters by prefix if provided, then returns NDJSON-formatted candidates.\n */\nexport function generateCandidates(\n prefix: string,\n options: FileSuggestionOptions,\n): FileSuggestionCandidate[] {\n const { navigationIndex, maxCandidates = DEFAULT_MAX_CANDIDATES } = options;\n const artifacts = listArtifacts(navigationIndex);\n const candidates: FileSuggestionCandidate[] = [];\n const lowerPrefix = prefix.toLowerCase();\n\n for (const { id, artifact } of artifacts) {\n const props = artifact.properties ?? {};\n const patterns = artifact.files?.path_patterns ?? [];\n\n // Artifact-level candidate\n if (!prefix || id.toLowerCase().includes(lowerPrefix)) {\n candidates.push({\n label: id,\n path: patterns.length > 0 ? String(patterns[0]) : id,\n kind: \"artifact\",\n authority: props.authority as string | undefined,\n manual_edit: props.manual_edit as string | undefined,\n score: computeArtifactScore(id, artifact, prefix),\n });\n }\n\n // File-level candidates from path patterns\n for (const pattern of patterns) {\n if (typeof pattern !== \"string\") continue;\n // Skip pure glob patterns for file-level suggestions (they're covered by artifact-level)\n if (pattern.includes(\"*\") || pattern.includes(\"?\")) continue;\n\n if (!prefix || pattern.toLowerCase().includes(lowerPrefix)) {\n candidates.push({\n label: pattern,\n path: pattern,\n kind: \"file\",\n artifact: id,\n authority: props.authority as string | undefined,\n manual_edit: props.manual_edit as string | undefined,\n score: computeFileScore(pattern, prefix),\n });\n }\n }\n }\n\n // Sort by score descending, then by label\n candidates.sort((a, b) => {\n if (b.score !== a.score) return b.score - a.score;\n return a.label.localeCompare(b.label);\n });\n\n return candidates.slice(0, maxCandidates);\n}\n\n/**\n * Format candidates as NDJSON (one JSON object per line).\n */\nexport function formatNdjson(candidates: FileSuggestionCandidate[]): string {\n return candidates.map((c) => JSON.stringify(c)).join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// Scoring helpers\n// ---------------------------------------------------------------------------\n\nfunction computeArtifactScore(\n id: string,\n artifact: NavigationArtifact,\n prefix: string,\n): number {\n let score = 50;\n const props = artifact.properties ?? {};\n\n // Boost canonical, editable artifacts\n if (props.authority === \"canonical\") score += 20;\n if (props.manual_edit === \"allowed\") score += 10;\n\n // Boost source artifacts\n if (props.type === \"source\") score += 15;\n\n // Penalize generated artifacts\n if (props.authority === \"generated\") score -= 20;\n if (props.manual_edit === \"forbidden\") score -= 10;\n\n // Boost exact prefix match\n if (prefix && id.toLowerCase().startsWith(prefix.toLowerCase())) {\n score += 20;\n }\n\n return score;\n}\n\nfunction computeFileScore(path: string, prefix: string): number {\n let score = 40;\n\n // Boost exact prefix match\n if (prefix && path.toLowerCase().startsWith(prefix.toLowerCase())) {\n score += 30;\n }\n\n // Boost shorter paths (more specific)\n score += Math.max(0, 20 - path.split(\"/\").length * 2);\n\n return score;\n}\n\n/**\n * Main handler for file-suggestion bin script.\n * Reads prefix from stdin, returns NDJSON candidates to stdout.\n */\nexport async function handleFileSuggestion(\n navigationIndex: Record<string, unknown>,\n stdinData: string,\n): Promise<string> {\n const prefix = stdinData.trim();\n const candidates = generateCandidates(prefix, { navigationIndex });\n return formatNdjson(candidates);\n}\n","/**\n * SessionStart Hook Handler — cache warm + navigation-index summary injection.\n *\n * Executed on session new/resume/clear/compact events. Warms the navigation-index\n * cache and returns a rendered summary as additionalContext.\n *\n * Latency constraint: NO AST analysis or ContextPack generation.\n */\n\nimport { renderNavigationIndexPrompt } from \"../task-runner.js\";\nimport {\n ensureNavigationIndex,\n type EnsureNavigationIndexOptions,\n} from \"./ensure-navigation-index.js\";\nimport {\n buildContextResponse,\n type HookOutput,\n type SessionStartInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface SessionStartHandlerConfig {\n /** Absolute path to .claude/cache/ directory. */\n cacheDir: string;\n /** Source files for cache invalidation (component.yaml, agent-contracts.yaml, etc.). */\n sourceFiles: string[];\n /** Options for buildNavigationContext(). */\n navigationOptions: EnsureNavigationIndexOptions[\"navigationOptions\"];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a SessionStart hook handler.\n */\nexport function createSessionStartHandler(config: SessionStartHandlerConfig) {\n return async function handleSessionStart(\n _input: SessionStartInput,\n ): Promise<HookOutput> {\n const result = await ensureNavigationIndex({\n cacheDir: config.cacheDir,\n sourceFiles: config.sourceFiles,\n navigationOptions: config.navigationOptions,\n });\n\n const summary = renderNavigationIndexPrompt(result.navigationIndex);\n const cacheNote = result.fromCache\n ? \"(loaded from cache)\"\n : \"(freshly built)\";\n\n const additionalContext = [\n summary,\n \"\",\n `Navigation index ${cacheNote}. Use analyzer MCP tools for deep investigation.`,\n ].join(\"\\n\");\n\n return buildContextResponse(\"SessionStart\", additionalContext);\n };\n}\n","/**\n * UserPromptSubmit Hook Handler — navigation-index summary injection.\n *\n * Executed after prompt submission, before Claude processes it. Provides a\n * compact navigation-index summary so the LLM can pick candidates and delegate\n * deep exploration to `analyzer.getContextMap` (Level 2).\n *\n * ContextPack is NOT pre-injected by default (#206 Phase D).\n */\n\nimport { renderNavigationIndexPrompt } from \"../task-runner.js\";\nimport {\n ensureNavigationIndex,\n type EnsureNavigationIndexOptions,\n} from \"./ensure-navigation-index.js\";\nimport {\n listArtifacts,\n} from \"./artifact-resolver.js\";\nimport {\n buildContextResponse,\n type HookOutput,\n type UserPromptSubmitInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface UserPromptSubmitHandlerConfig {\n /** Absolute path to the project root. */\n projectRoot: string;\n /** Absolute path to .claude/cache/ directory. */\n cacheDir: string;\n /** Source files for cache invalidation. */\n sourceFiles: string[];\n /** Options for buildNavigationContext(). */\n navigationOptions: EnsureNavigationIndexOptions[\"navigationOptions\"];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a UserPromptSubmit hook handler.\n */\nexport function createUserPromptSubmitHandler(\n config: UserPromptSubmitHandlerConfig,\n) {\n return async function handleUserPromptSubmit(\n input: UserPromptSubmitInput,\n ): Promise<HookOutput> {\n const prompt = input.prompt ?? \"\";\n\n const navResult = await ensureNavigationIndex({\n cacheDir: config.cacheDir,\n sourceFiles: config.sourceFiles,\n navigationOptions: config.navigationOptions,\n });\n const navigationIndex = navResult.navigationIndex;\n const navigationSummary = renderNavigationIndexPrompt(navigationIndex);\n\n const sections: string[] = [\n // renderNavigationIndexPrompt already emits the \"## Project Navigation\n // Index\" heading — don't duplicate it here.\n navigationSummary,\n \"\",\n \"> Use `analyzer.getContextMap` with candidate paths/artifacts from the index\",\n \"> when you need structured dependency and read-target guidance.\",\n ];\n\n const candidates = extractCandidateArtifacts(prompt, navigationIndex);\n if (candidates.length > 0) {\n const candidateLines = candidates.map((c) => {\n const props = c.artifact.properties ?? {};\n const tags = [props.type, props.authority, props.manual_edit ? `edit:${props.manual_edit}` : \"\"]\n .filter(Boolean)\n .join(\", \");\n return `- ${c.artifactId} [${tags}]`;\n });\n sections.push(\n \"## Candidate Artifacts (from prompt keywords)\\n\" + candidateLines.join(\"\\n\"),\n );\n }\n\n const additionalContext = sections.join(\"\\n\");\n return buildContextResponse(\"UserPromptSubmit\", additionalContext);\n };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\ninterface CandidateArtifact {\n artifactId: string;\n artifact: ReturnType<typeof listArtifacts>[number][\"artifact\"];\n}\n\nfunction extractCandidateArtifacts(\n prompt: string,\n navigationIndex: Record<string, unknown>,\n): CandidateArtifact[] {\n if (!prompt.trim()) return [];\n\n const artifacts = listArtifacts(navigationIndex);\n const lowerPrompt = prompt.toLowerCase();\n const matches: CandidateArtifact[] = [];\n const seen = new Set<string>();\n\n for (const { id, artifact } of artifacts) {\n if (lowerPrompt.includes(id.toLowerCase()) && !seen.has(id)) {\n seen.add(id);\n matches.push({ artifactId: id, artifact });\n continue;\n }\n\n const patterns = artifact.files?.path_patterns ?? [];\n for (const pattern of patterns) {\n if (typeof pattern !== \"string\") continue;\n const literal = pattern.replace(/[*?]/g, \"\").replace(/\\{.*\\}/g, \"\");\n if (literal.length > 3 && lowerPrompt.includes(literal.toLowerCase()) && !seen.has(id)) {\n seen.add(id);\n matches.push({ artifactId: id, artifact });\n break;\n }\n }\n }\n\n return matches;\n}\n","/**\n * Workspace SessionStart Hook Handler — per-member navigation-index warm-up.\n *\n * Builds (or validates) a cached navigation-index for each declared workspace\n * member in parallel, then returns a combined summary as `additionalContext`.\n *\n * This module is in the **heavy** path (imports ensureNavigationIndex →\n * navigation-context → agent-contracts) and is therefore NOT included in the\n * lean hooks-lite entry point. SessionStart fires only once per session, so\n * the higher import cost is acceptable.\n */\n\nimport { renderNavigationIndexPrompt } from \"../task-runner.js\";\nimport {\n ensureNavigationIndex,\n type EnsureNavigationIndexOptions,\n} from \"./ensure-navigation-index.js\";\nimport {\n buildContextResponse,\n type HookOutput,\n type SessionStartInput,\n} from \"./hook-protocol.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface WorkspaceMemberSessionConfig {\n /** Human-readable member name (e.g. `\"aaac\"`). */\n name: string;\n /** Absolute path to member root directory. */\n root: string;\n /**\n * Unique cache key for this member's navigation-index JSON.\n * Format: `navigation-index.<name>`.\n */\n cacheKey: string;\n /** Source files for mtime-based cache invalidation. */\n sourceFiles: string[];\n /** Options passed to `buildNavigationContext()` on cache miss. */\n navigationOptions: EnsureNavigationIndexOptions[\"navigationOptions\"];\n}\n\nexport interface WorkspaceSessionStartConfig {\n /** Absolute path to the shared `.claude/cache/` directory. */\n cacheDir: string;\n /** Workspace members to build/validate indices for. */\n members: WorkspaceMemberSessionConfig[];\n}\n\n// ---------------------------------------------------------------------------\n// Handler\n// ---------------------------------------------------------------------------\n\n/**\n * Create a workspace-aware SessionStart hook handler.\n *\n * All member navigation-indices are built in **parallel** (each key has its\n * own exclusive lock so concurrent calls for the same member deduplicate\n * rather than queue behind other members).\n */\nexport function createWorkspaceSessionStartHandler(\n config: WorkspaceSessionStartConfig,\n) {\n return async function handleWorkspaceSessionStart(\n _input: SessionStartInput,\n ): Promise<HookOutput> {\n // Build all member indices concurrently\n const results = await Promise.all(\n config.members.map(async (member) => {\n const result = await ensureNavigationIndex({\n cacheDir: config.cacheDir,\n sourceFiles: member.sourceFiles,\n navigationOptions: member.navigationOptions,\n cacheKey: member.cacheKey,\n });\n return { member, result };\n }),\n );\n\n // Aggregate summaries\n const sections: string[] = [];\n for (const { member, result } of results) {\n const summary = renderNavigationIndexPrompt(result.navigationIndex);\n const cacheNote = result.fromCache ? \"(loaded from cache)\" : \"(freshly built)\";\n sections.push(\n `### Member: ${member.name} ${cacheNote}\\n${summary}`,\n );\n }\n\n const additionalContext = [\n sections.join(\"\\n\\n\"),\n \"\",\n \"Workspace navigation indices ready. Use analyzer MCP tools for deep investigation.\",\n ].join(\"\\n\");\n\n return buildContextResponse(\"SessionStart\", additionalContext);\n };\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aaac/runtime",
3
- "version": "0.1.51",
3
+ "version": "0.1.52",
4
4
  "description": "Runtime SDK for the AaaC toolchain",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",