@codeyam/codeyam-cli 0.1.0-staging.596f0eb → 0.1.0-staging.62d4615

package/codeyam-cli/templates/rule-reflection-hook.py

@@ -0,0 +1,428 @@
+#!/usr/bin/env python3
+"""
+Rule reflection hook for Claude Code.
+
+Two responsibilities, now split into independent agents:
+1. Check for stale rules (files changed since rule was last reviewed) and prompt review
+2. Review conversation for confusion signals (mistakes, corrections, interruptions)
+
+Each fires as a separate `claude -p` invocation so the LLM can focus on one task at a time.
+Stays silent if there's nothing to review.
+
+Prompt text lives in templates/prompts/*.txt (single source of truth shared with TypeScript tests).
+"""
+
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+MIN_USER_TURNS = 3  # Minimum user turns before checking for confusion
+
+# Signals that indicate confusion, mistakes, or user corrections
+CONFUSION_SIGNALS = [
+    'no,', 'no ', "that's not", "thats not", "that is not",
+    'wrong', 'incorrect', 'actually,', 'actually ',
+    "i meant", "i mean", "not what i", "stop", "wait",
+    "don't do", "dont do", "shouldn't", "should not",
+    "try again", "let me clarify", "to clarify",
+    "that broke", "that failed", "error", "bug",
+]
+
+# Prompt templates directory — installed alongside this hook in .codeyam/bin/prompts/
+PROMPTS_DIR = Path(__file__).parent / 'prompts'
+
+
+def load_prompt_template(name, **kwargs):
+    """
+    Load a prompt template from the prompts/ directory and substitute placeholders.
+    Placeholders use {{KEY}} syntax (e.g., {{CONTEXT_FILE}}, {{PROJECT_DIR}}).
+    """
+    template_path = PROMPTS_DIR / name
+    text = template_path.read_text()
+    for key, value in kwargs.items():
+        text = text.replace(f'{{{{{key}}}}}', str(value))
+    return text
+
+
+def has_confusion_signals(conversation_snippets):
+    """
+    Check if the conversation contains signals of confusion or user corrections.
+    Returns True if confusion signals are detected.
+    """
+    for snippet in conversation_snippets:
+        if snippet['role'] != 'user':
+            continue
+        content_lower = snippet['content'].lower()
+        for signal in CONFUSION_SIGNALS:
+            if signal in content_lower:
+                return True
+    return False
+
+
+def get_file_diff(file_path, max_lines=50):
+    """
+    Get git diff for a file. Tries staged diff first, then unstaged.
+    Returns truncated diff string or empty string.
+    """
+    for diff_cmd in [
+        ['git', 'diff', 'HEAD', '--', file_path],
+        ['git', 'diff', '--', file_path],
+    ]:
+        try:
+            result = subprocess.run(
+                diff_cmd, capture_output=True, text=True, timeout=10
+            )
+            if result.stdout.strip():
+                lines = result.stdout.strip().split('\n')
+                # Skip the diff header (--- a/, +++ b/, @@ lines)
+                content_lines = [l for l in lines if not l.startswith('diff ') and
+                                 not l.startswith('index ') and not l.startswith('--- ') and
+                                 not l.startswith('+++ ')]
+                if len(content_lines) > max_lines:
+                    content_lines = content_lines[:max_lines] + [f'... ({len(lines) - max_lines} more lines)']
+                return '\n'.join(content_lines)
+        except (subprocess.TimeoutExpired, FileNotFoundError):
+            continue
+    return ''
+
+
+def read_rule_content(rule_name):
+    """
+    Read a rule file and return its content after YAML frontmatter.
+    Searches in .claude/rules/ directory.
+    """
+    # Search for the rule file
+    rules_dir = Path('.claude/rules')
+    if not rules_dir.exists():
+        return ''
+
+    # Find the file - could be at any depth
+    matches = list(rules_dir.rglob(rule_name))
+    if not matches:
+        return ''
+
+    try:
+        text = matches[0].read_text()
+    except IOError:
+        return ''
+
+    # Strip YAML frontmatter
+    if text.startswith('---'):
+        end = text.find('---', 3)
+        if end != -1:
+            text = text[end + 3:].strip()
+
+    return text
+
+
+def get_stale_rules():
+    """
+    Run `codeyam memory status` and parse the output to find stale rules.
+    Returns a list of dicts with rule info, or empty list if none stale.
+    """
+    try:
+        # Use the local codeyam CLI via node to avoid PATH issues
+        project_dir = os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd())
+        codeyam_js = os.path.join(project_dir, 'codeyam-cli', 'dist', 'codeyam-cli', 'src', 'codeyam-cli.js')
+        if os.path.exists(codeyam_js):
+            cmd = ['node', '--no-warnings', codeyam_js, 'memory', 'status']
+        else:
+            cmd = ['codeyam', 'memory', 'status']
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=30
+        )
+        output = result.stdout
+
+        # Check if there are stale rules
+        if 'Found' not in output or 'stale rule' not in output:
+            return []
+
+        # Parse the output to extract stale rule information
+        stale_rules = []
+        lines = output.split('\n')
+        i = 0
+        while i < len(lines):
+            line = lines[i].strip()
+            # Look for rule filenames (lines that end with .md and aren't indented much)
+            if line.endswith('.md') and not line.startswith('Rule') and not line.startswith('Newest'):
+                rule_info = {'name': line}
+                # Look for the next few lines for details
+                for j in range(i + 1, min(i + 4, len(lines))):
+                    detail = lines[j].strip()
+                    if detail.startswith('Rule timestamp:'):
+                        rule_info['rule_timestamp'] = detail.replace('Rule timestamp:', '').strip()
+                    elif detail.startswith('Newest file:'):
+                        rule_info['newest_file'] = detail.replace('Newest file:', '').strip()
+                    elif detail.startswith('File modified:'):
+                        rule_info['file_modified'] = detail.replace('File modified:', '').strip()
+                # Get diff for the changed file
+                if rule_info.get('newest_file'):
+                    rule_info['diff'] = get_file_diff(rule_info['newest_file'])
+
+                # Get inline rule content
+                rule_info['rule_content'] = read_rule_content(rule_info['name'])
+
+                stale_rules.append(rule_info)
+            i += 1
+
+        return stale_rules
+    except (subprocess.TimeoutExpired, FileNotFoundError, Exception):
+        return []
+
+
+def get_conversation_context(transcript_path, last_line):
+    """
+    Extract conversation snippets and modified files from transcript for rule review.
+    Returns (user_turn_count, conversation_snippets, modified_files, current_line_count)
+    """
+    try:
+        with open(transcript_path, 'r') as f:
+            all_lines = f.readlines()
+    except IOError:
+        return 0, [], set(), 0
+
+    current_line_count = len(all_lines)
+    new_lines = all_lines[last_line:]
+
+    if not new_lines:
+        return 0, [], set(), current_line_count
+
+    user_turn_count = 0
+    conversation_snippets = []
+    modified_files = set()
+
+    for line in new_lines:
+        try:
+            obj = json.loads(line)
+            msg_type = obj.get('type')
+
+            if msg_type not in ('user', 'assistant'):
+                continue
+
+            message = obj.get('message', {})
+            content = message.get('content', '')
+            is_external_user = msg_type == 'user' and obj.get('userType') == 'external'
+
+            # Handle string content
+            if isinstance(content, str):
+                if obj.get('isMeta') or len(content) < 20:
+                    continue
+                if content.startswith('[{') or '<tool_result' in content:
+                    continue
+
+                if is_external_user and not content.startswith('<'):
+                    user_turn_count += 1
+
+                conversation_snippets.append({
+                    'role': message.get('role', msg_type),
+                    'content': content
+                })
+
+            elif isinstance(content, list):
+                for item in content:
+                    if not isinstance(item, dict):
+                        continue
+
+                    # Extract text snippets
+                    if item.get('type') == 'text':
+                        text = item.get('text', '')
+                        if len(text) > 20:
+                            conversation_snippets.append({
+                                'role': message.get('role', msg_type),
+                                'content': text
+                            })
+
+                    # Track file modifications from tool_use entries
+                    if item.get('type') == 'tool_use':
+                        tool_name = item.get('name', '')
+                        tool_input = item.get('input', {})
+                        if tool_name in ('Edit', 'Write') and tool_input.get('file_path'):
+                            modified_files.add((tool_input['file_path'], tool_name))
+
+        except (json.JSONDecodeError, KeyError):
+            continue
+
+    return user_turn_count, conversation_snippets, modified_files, current_line_count
+
+
+def build_stale_rules_context(stale_rules):
+    """Build context content for stale rules review."""
+    parts = []
+    parts.append("# Reflection Step\n")
+    parts.append("Please review the stale rules below to determine if any need updating based on recent code changes.\n")
+    parts.append("Please show your thinking regarding the stale rules.\n")
+    parts.append("## Stale Rules to Review\n")
+    parts.append("The following rules have files that changed since the rule was last reviewed.")
+    parts.append("For each rule, review the rule content and the diff of changes, then:")
+    parts.append("1. Determine if the rule content needs updating based on the code changes")
+    parts.append("2. Update the rule if needed")
+    parts.append("3. ALWAYS update the timestamp (run `codeyam memory touch`)\n")
+
+    for rule in stale_rules:
+        parts.append(f"### {rule['name']}")
+        if rule.get('rule_content'):
+            parts.append(f"  Rule content:")
+            for line in rule['rule_content'].split('\n'):
+                parts.append(f"    {line}")
+        if rule.get('newest_file'):
+            parts.append(f"  Changed file: {rule['newest_file']}")
+        if rule.get('file_modified'):
+            parts.append(f"  File modified: {rule['file_modified']}")
+        if rule.get('rule_timestamp'):
+            parts.append(f"  Rule timestamp: {rule['rule_timestamp']}")
+        if rule.get('diff'):
+            parts.append(f"  Changes:")
+            for line in rule['diff'].split('\n'):
+                parts.append(f"    {line}")
+        parts.append("")
+
+    return '\n'.join(parts)
+
+
+def build_conversation_context(conversation_snippets, modified_files):
+    """Build context content for conversation review."""
+    parts = []
+    parts.append("## Conversation Review\n")
+    parts.append(
+        "Review this session for rule-worthy learnings: architectural decisions, tribal knowledge, "
+        "confusion, mistakes, or corrections that future sessions would benefit from knowing.\n"
+    )
+
+    # Load guidance from shared template file
+    guidance = (PROMPTS_DIR / 'conversation-guidance.txt').read_text()
+    parts.append(guidance)
+
+    if modified_files:
+        parts.append("Files modified this session:")
+        for file_path, tool_name in sorted(modified_files):
+            parts.append(f"- {file_path} ({tool_name})")
+        parts.append("")
+
+    parts.append("### Session transcript\n")
+    summary_lines = []
+    for snippet in conversation_snippets:
+        role = snippet['role']
+        content = snippet['content'].replace('\n', ' ')
+        summary_lines.append(f"[{role}]: {content}")
+    parts.append('\n'.join(summary_lines))
+
+    return '\n'.join(parts)
+
+
+def spawn_claude_agent(prompt, log_file, project_dir):
+    """Spawn a detached claude -p agent as a background process."""
+    try:
+        log_fh = open(log_file, 'w')
+        env = os.environ.copy()
+        env['CODEYAM_RULE_AGENT'] = '1'
+        subprocess.Popen(
+            ['claude', '-p', prompt,
+             '--model', 'haiku',
+             '--output-format', 'stream-json', '--verbose',
+             '--allowedTools', 'Read,Edit,Write,Bash,Glob,Grep'],
+            cwd=project_dir,
+            stdout=log_fh,
+            stderr=log_fh,
+            env=env,
+            start_new_session=True,
+        )
+    except FileNotFoundError:
+        pass  # claude CLI not available, skip silently
+
+
+def main():
+    # Read hook input from stdin
+    try:
+        hook_input = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        return
+
+    session_id = hook_input.get('session_id', '')
+    transcript_path = hook_input.get('transcript_path', '')
+    stop_hook_active = hook_input.get('stop_hook_active', False)
+
+    # Prevent infinite loops — stop_hook_active covers same-process recursion,
+    # env var covers spawned subagent sessions triggering the hook on exit
+    if stop_hook_active or os.environ.get('CODEYAM_RULE_AGENT'):
+        return
+
+    if not session_id or not transcript_path:
+        return
+
+    marker_dir = Path('/tmp/claude-rule-markers')
+    marker_dir.mkdir(exist_ok=True)
+    marker_file = marker_dir / f'{session_id}.marker'
+
+    # Read last checked line
+    last_line = 0
+    if marker_file.exists():
+        try:
+            last_line = int(marker_file.read_text().strip())
+        except (ValueError, IOError):
+            last_line = 0
+
+    # Check for stale rules
+    stale_rules = get_stale_rules()
+
+    # Get conversation context
+    user_turn_count, conversation_snippets, modified_files, current_line_count = get_conversation_context(
+        transcript_path, last_line
+    )
+
+    # Determine what to include in review
+    has_stale_rules = len(stale_rules) > 0
+    has_conversation = len(conversation_snippets) > 0
+
+    # Only fire if there's something to review
+    if not has_stale_rules and not has_conversation:
+        return
+
+    # Update marker
+    marker_file.write_text(str(current_line_count))
+
+    project_dir = os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd())
+
+    # Unique suffix per invocation so each Stop produces a distinct transcript
+    from datetime import datetime
+    invocation_ts = datetime.now().strftime('%Y%m%d-%H%M%S')
+    invocation_id = f'{session_id}-{invocation_ts}'
+
+    # Spawn independent agent for stale rules review
+    if has_stale_rules:
+        stale_context = build_stale_rules_context(stale_rules)
+        stale_context_file = marker_dir / f'{invocation_id}-stale.context'
+        stale_context_file.write_text(stale_context)
+
+        stale_log_file = marker_dir / f'{invocation_id}-stale.log'
+        stale_notification_file = marker_dir / 'rule-notification-stale.md'
+        stale_prompt = load_prompt_template(
+            'stale-rules-prompt.txt',
+            CONTEXT_FILE=str(stale_context_file),
+            NOTIFICATION_FILE=str(stale_notification_file),
+            PROJECT_DIR=project_dir,
+        )
+        spawn_claude_agent(stale_prompt, stale_log_file, project_dir)
+
+    # Spawn independent agent for conversation review
+    if has_conversation:
+        conv_context = build_conversation_context(conversation_snippets, modified_files)
+        conv_context_file = marker_dir / f'{invocation_id}-conversation.context'
+        conv_context_file.write_text(conv_context)
+
+        conv_log_file = marker_dir / f'{invocation_id}-conversation.log'
+        conv_notification_file = marker_dir / 'rule-notification-conversation.md'
+        conv_prompt = load_prompt_template(
+            'conversation-prompt.txt',
+            CONTEXT_FILE=str(conv_context_file),
+            NOTIFICATION_FILE=str(conv_notification_file),
+            PROJECT_DIR=project_dir,
+        )
+        spawn_claude_agent(conv_prompt, conv_log_file, project_dir)
+
+if __name__ == '__main__':
+    main()

package/codeyam-cli/templates/rules-instructions.md

@@ -0,0 +1,123 @@
+# Claude Rules Guide
+
+Rules provide context-specific guidance when working in files matching their `paths` patterns.
+
+## Core Principles
+
+1. **One concept per rule** - Each rule should cover a single topic. If you're documenting two unrelated things, create two rules.
+2. **Paths must match content scope** - A rule about one specific file should have that file in `paths`, not a broad `**/*.ts` pattern.
+3. **Be concise** - Every word costs context. Use bullets and tables.
+
+## When to Create a New Rule
+
+Create a new rule when:
+
+- You learn something non-obvious about the codebase
+- You make a mistake and want to prevent it in the future
+- The user explains something that isn't clear from the code
+- An existing rule is covering multiple unrelated topics (split it)
+
+## Before Creating: The Confusion Test
+
+Only create rules that document genuinely confusing aspects—not things Claude can figure out by reading code and will likely come up again in future sessions.
+
+**Ask yourself:**
+
+1. **Could Claude figure this out by reading the code?**
+   - If YES → don't create the rule
+   - If NO → proceed
+
+2. **Does this explain "why" not just "what"?**
+   - Good: Historical context, gotchas, non-obvious behavior, non-obvious architectural decisions
+   - Bad: Bug fixes, Limitations (unless the user requests the limitation be noted), What functions do (unless providing a high-level architectural overview)
+
+3. **Would this have prevented a past mistake?**
+   - If you can point to a bug or confusion this would have prevented → create it
+   - If it's just "nice to know" → skip it
+
+### Examples
+
+**✅ Worth documenting:**
+
+- Where to add new functionality
+- An overview of all files, classes, functions, etc used in a particular part of the repo
+- Debugging strategies for a particular area of the repo
+- "Use `pnpm test` to run tests" (if there is more than one way to run tests and this way is preferred)
+
+**❌ Not worth documenting:**
+
+- "The auth module handles authentication" (obvious from reading code)
+- "This function takes X and returns Y" (Claude can read the signature)
+
+## Path Specificity
+
+The `paths` field controls when the rule is shown. Match the scope of your content:
+
+| Content Scope | Path Pattern            | Example                                                |
+| ------------- | ----------------------- | ------------------------------------------------------ |
+| Single file   | `'path/to/file.ts'`     | Rule about `processExpression.ts` specifically         |
+| Related files | `'path/to/feature*.ts'` | Rule about `generateExecutionFlows*.ts` files          |
+| Directory     | `'path/to/dir/**/*.ts'` | Rule about the queue system in `utils/queue/`          |
+| Cross-cutting | Multiple specific paths | Testing rule with paths to test configs and test files |
+
+**Anti-pattern**: Don't use `'**/*.ts'` for a rule about one specific feature.
+
+## File Structure
+
+Rules mirror the source code structure:
+
+| Source Location      | Rule Location                           |
+| -------------------- | --------------------------------------- |
+| `src/api/auth.ts`    | `.claude/rules/src/api/auth.md`         |
+| `src/utils/queue/**` | `.claude/rules/src/utils/queue.md`      |
+| Test configuration   | `.claude/rules/testing/jest-configs.md` |
+
+## Required Frontmatter
+
+```yaml
+---
+paths:
+  - 'specific/path/to/file.ts'
+  - 'another/specific/path/*.ts'
+timestamp: 2026-01-30T00:00:00Z
+---
+```
+
+| Field       | Purpose                                                          |
+| ----------- | ---------------------------------------------------------------- |
+| `paths`     | Glob patterns - be specific to avoid loading rules unnecessarily |
+| `timestamp` | ISO 8601 - update when rule is reviewed                          |
+
+## Content Guidelines
+
+### Be Actionable
+
+- Good: "Run `pnpm test:api` for API tests"
+- Bad: "Make sure to run the appropriate tests"
+
+### Focus on What, Not What Not
+
+- Good: "Auth tokens are stored in httpOnly cookies via `src/auth/cookies.ts`"
+- Bad: "WARNING: Don't store tokens in localStorage!"
+
+### Keep Rules Short
+
+- Target 30-50 lines
+- If a rule exceeds 60 lines, consider splitting it
+
+## Categories
+
+**architecture** - Design decisions, file relationships, data flow
+
+- "These three files must change together because..."
+- "Data flows from X → Y → Z"
+
+**testing** - Test commands, mock patterns, fixtures
+
+- "Run tests with: `pnpm test path/to/test.ts`"
+- "Must run `pnpm pretest` first because..."
+
+**faq** - Gotchas, workarounds, common questions
+
+- "If you see error X, it means Y"
+- "This looks wrong but is intentional because..."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeyam/codeyam-cli",
-  "version": "0.1.0-staging.596f0eb",
+  "version": "0.1.0-staging.62d4615",
   "description": "Local development CLI for CodeYam analysis",
   "type": "module",
   "bin": {
@@ -10,24 +10,24 @@
     "postinstall": "node ./scripts/finalize-analyzer.cjs"
   },
   "dependencies": {
-    "@anthropic-ai/claude-code": "^2.0.22",
+    "@anthropic-ai/claude-code": "^2.0.76",
     "@anthropic-ai/sdk": "^0.71.0",
-    "@aws-sdk/client-dynamodb": "^3.899.0",
-    "@aws-sdk/s3-request-presigner": "^3.899.0",
-    "@aws-sdk/util-dynamodb": "^3.902.0",
-    "@modelcontextprotocol/sdk": "^1.24.0",
+    "@aws-sdk/client-dynamodb": "^3.956.0",
+    "@aws-sdk/s3-request-presigner": "^3.940.0",
+    "@aws-sdk/util-dynamodb": "^3.971.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "@octokit/auth-app": "^8.1.0",
     "@octokit/request": "^10.0.3",
     "@octokit/rest": "^22.0.0",
-    "@react-router/express": "^7.10.1",
-    "@react-router/node": "^7.10.1",
-    "react-router": "^7.10.1",
+    "@react-router/express": "^7.11.0",
+    "@react-router/node": "^7.11.0",
+    "react-router": "^7.12.0",
     "@sendgrid/mail": "^8.1.4",
-    "@supabase/supabase-js": "2.52.1",
+    "@supabase/supabase-js": "2.88.0",
     "better-sqlite3": "^12.4.1",
     "chalk": "^5.6.2",
     "chokidar": "^4.0.3",
-    "cli-spinners": "^3.3.0",
+    "cli-spinners": "^3.4.0",
     "domhandler": "^5.0.3",
     "dotenv": "^17.2.3",
     "express": "^5.2.1",
@@ -35,26 +35,29 @@
     "get-port": "^7.1.0",
     "htmlparser2": "^10.0.0",
     "isbot": "^4",
-    "jsdom": "^27.3.0",
+    "jsdom": "^27.4.0",
     "json5": "^2.2.3",
     "jsonc-parser": "^3.2.1",
     "kysely": "^0.28.5",
     "lru-cache": "^11.2.4",
     "lucide-react": "^0.556.0",
-    "openai": "^6.9.0",
+    "minimatch": "^10.0.1",
+    "openai": "^6.16.0",
     "p-queue": "^8.1.0",
-    "p-retry": "^6.2.1",
+    "p-retry": "^7.1.1",
     "pg": "^8.16.3",
     "piscina": "^5.1.4",
     "pixelmatch": "^5.3.0",
-    "playwright": "^1.56.1",
+    "playwright": "1.58.0",
     "pluralize": "^8.0.0",
     "prompts": "^2.4.2",
-    "react": "~18.2.0",
-    "react-diff-viewer-continued": "^3.4.0",
-    "react-dom": "~18.2.0",
+    "react": "^19.2.3",
+    "react-diff-viewer-continued": "4.0.6",
+    "react-dom": "^19.2.3",
+    "react-markdown": "^10.1.0",
     "react-resizable": "^3.0.5",
-    "react-syntax-highlighter": "^15.5.13",
+    "react-syntax-highlighter": "^15.6.1",
+    "remark-gfm": "^4.0.1",
     "sharp": "^0.34.5",
     "simple-git": "^3.28.0",
     "typescript": "^5.9.3",

package/packages/ai/index.js

@@ -14,8 +14,7 @@ export { default as generateEntityScenarios } from "./src/lib/generateEntityScen
 export { default as generateEntityScenarioData, generateDataForScenario, } from "./src/lib/generateEntityScenarioData.js";
 export { default as generateChangesEntityScenarios } from "./src/lib/generateChangesEntityScenarios.js";
 export { default as generateChangesEntityScenarioData } from "./src/lib/generateChangesEntityScenarioData.js";
-export { default as generateEntityKeyAttributes } from "./src/lib/generateEntityKeyAttributes.js";
-export { default as generateChangesEntityKeyAttributes } from "./src/lib/generateChangesEntityKeyAttributes.js";
+export { default as generateExecutionFlows } from "./src/lib/generateExecutionFlows.js";
 export { default as guessScenarioDataFromName, } from "./src/lib/guessScenarioDataFromName.js";
 export { default as guessScenarioDataFromDescription, } from "./src/lib/guessScenarioDataFromDescription.js";
 export { default as generateBranchSummary } from "./src/lib/generateBranchSummary.js";
@@ -27,20 +26,23 @@ export { default as describeCodeChange } from "./src/lib/describeCodeChange.js";
 export { default as validateTypeStructure } from "./src/lib/validateTypeStructure.js";
 export { default as validateDataStructure } from "./src/lib/validateDataStructure.js";
 export { default as isolateScopes } from "./src/lib/isolateScopes.js";
-export { default as analyzeScope } from "./src/lib/analyzeScope.js";
+export { default as analyzeScope, destroyWorkerPool, } from "./src/lib/analyzeScope.js";
 export { default as logOrderedMap } from "./src/lib/logOrderedMap.js";
 export { default as splitOutsideParentheses, splitOutsideParenthesesAndArrays, joinParenthesesAndArrays, functionArguments, } from "./src/lib/splitOutsideParentheses.js";
 export { cleanKnownObjectFunctionsFromMapping } from "./src/lib/dataStructure/helpers/cleanKnownObjectFunctions.js";
 export { clearAttributesFromMapping, removeDuplicateFunctionCalls, } from "./src/lib/dataStructure/helpers/cleanNonObjectFunctions.js";
 export { default as convertDotNotation } from "./src/lib/dataStructure/helpers/convertDotNotation.js";
+export { default as convertTypeAnnotationsToValues } from "./src/lib/dataStructure/helpers/convertTypeAnnotationsToValues.js";
 export { default as cleanOutBoundary } from "./src/lib/cleanOutBoundary.js";
-export { fillInDirectSchemaGapsAndUnknowns } from "./src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js";
+export { fillInDirectSchemaGapsAndUnknowns, buildSchemaIndexes, } from "./src/lib/dataStructure/helpers/fillInSchemaGapsAndUnknowns.js";
 export { default as deduplicateFunctionSchemas } from "./src/lib/dataStructure/helpers/deduplicateFunctionSchemas.js";
-export { default as gatherRelevantDependentKeyAttributes } from "./src/lib/gatherRelevantDependentKeyAttributes.js";
 export { default as getConditionalUsagesFromCode } from "./src/lib/getConditionalUsagesFromCode.js";
-export { getExternalFunctionCallInfo, getFunctionSignature, getReturnValue, getUsageEquivalencies, getSourceEquivalencies, getEquivalentSignatureVariables, getConditionalUsages, } from "./src/lib/worker/SerializableDataStructure.js";
+export { getExternalFunctionCallInfo, getFunctionSignature, getReturnValue, getUsageEquivalencies, getSourceEquivalencies, getEquivalentSignatureVariables, getConditionalUsages, getConditionalEffects, getCompoundConditionals, getChildBoundaryGatingConditions, getJsxRenderingUsages, } from "./src/lib/worker/SerializableDataStructure.js";
 export { parseJsonSafe } from "./src/lib/parsers/parseJsonSafe.js";
 export { default as completionCall } from "./src/lib/completionCall.js";
+// NOTE: E2E data tracking utilities (e2eDataTracking.ts) are NOT exported here
+// because they use Node.js 'crypto' module which breaks browser builds.
+// Import directly from "../../packages/ai/src/lib/e2eDataTracking.js" when needed in Node.js tests.
 // Wrapper detection
 export { default as detectWrapperRequirements } from "./src/lib/wrapperDetection/detectWrapperRequirements.js";
 export { KNOWN_LIBRARY_HOOKS } from "./src/lib/wrapperDetection/knownLibraryHooks.js";