// Don't list ALL routes:
❌ api/users/profile.ts
❌ api/users/settings.ts
❌ api/users/posts.ts
... (50 more routes)

// Sample by DEPTH:
✅ api/users/profile.ts (depth: 3)
✅ api/users/engagement/likes.ts (depth: 4)
✅ api/users/engagement/shares/public.ts (depth: 5) ← Deep route captured!

Budget: 3000 tokens
Used: 2847 tokens (95%)
Files: 156/892 selected (17%)

// High Priority (20-30 points)
package.json           → 30 pts  // Tech stack
page.tsx               → 25 pts  // Next.js pages
README.md              → 25 pts  // Documentation
route.ts               → 20 pts  // API routes

// Medium Priority (10-15 points)
components/            → 12 pts
hooks/use-*.ts         → 13 pts
lib/utils.ts           → 10 pts
config files           → 10 pts

// Low Priority (negative points)
*.test.ts              → -10 pts
*.d.ts                 → -5 pts
package-lock.json      → -20 pts
node_modules/          → IGNORED

Top scored files:
1. package.json (score: 30)
2. src/app/page.tsx (score: 25)
3. README.md (score: 25)
4. src/components/editor/bubble-menu.tsx (score: 22)
5. src/lib/tiptap/extensions/index.ts (score: 18)
...

Bottom scored files:
889. test/__mocks__/something.ts (score: -5)
890. dist/bundle.min.js (score: -15)
891. package-lock.json (score: -20)
892. node_modules/... (IGNORED)

#!/usr/bin/env node
/**
 * REPO-MAP: Zero-config repository structure analyzer
 * 
 * Purpose: Generate AI-friendly context for feature migration
 * Strategy: Auto-detect patterns, sample deep routes, stay within token budget
 */

const fs = require('fs');
const path = require('path');

// ============================================
// CONFIGURATION (edit if needed)
// ============================================
const CONFIG = {
  tokenBudget: 3000,          // AI context limit
  deepRouteSampleSize: 3,     // Number of deep route examples
  autoIgnore: ['node_modules', '.git', 'dist', 'build', '.next'],
};

// ============================================
// FRAMEWORK AUTO-DETECTION
// ============================================
function detectFramework() {
  const indicators = {
    nextjs: () => fs.existsSync('next.config.js') || fs.existsSync('next.config.ts'),
    react: () => {
      if (!fs.existsSync('package.json')) return false;
      const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
      return pkg.dependencies?.react || pkg.devDependencies?.react;
    },
    vue: () => {
      if (!fs.existsSync('package.json')) return false;
      const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
      return pkg.dependencies?.vue || pkg.devDependencies?.vue;
    }
  };

  for (const [framework, detect] of Object.entries(indicators)) {
    if (detect()) return framework;
  }
  return 'unknown';
}

// ============================================
// FILE SCORING
// ============================================
function scoreFile(filePath, fileName, framework) {
  let score = 0;
  const normalized = filePath.replace(/\\/g, '/');
  
  // Framework-specific
  if (framework === 'nextjs') {
    if (fileName.includes('page.')) score += 25;
    if (fileName.includes('layout.')) score += 22;
    if (fileName.includes('route.')) score += 20;
  }
  
  // Universal patterns
  if (fileName === 'package.json') score += 30;
  if (fileName === 'README.md') score += 25;
  if (fileName.startsWith('use-')) score += 13;
  if (normalized.includes('/components/')) score += 12;
  if (normalized.includes('/lib/')) score += 10;
  
  // Penalties
  if (fileName.includes('.test.')) score -= 10;
  if (fileName.endsWith('.d.ts')) score -= 5;
  if (fileName.includes('lock.json')) score -= 20;
  
  // Deep nesting penalty
  const depth = normalized.split('/').length;
  if (depth > 6) score -= (depth - 6) * 2;
  
  return Math.max(0, score);
}

// ============================================
// FILE COLLECTION
// ============================================
function collectFiles(dir = '.', relativePath = '', depth = 0) {
  if (depth > 15) return [];
  const files = [];
  
  try {
    const items = fs.readdirSync(dir);
    
    for (const item of items) {
      if (CONFIG.autoIgnore.includes(item)) continue;
      if (item.startsWith('.') && item !== '.env.example') continue;
      
      const fullPath = path.join(dir, item);
      const relPath = path.join(relativePath, item);
      const stats = fs.statSync(fullPath);
      
      if (stats.isDirectory()) {
        files.push(...collectFiles(fullPath, relPath, depth + 1));
      } else if (stats.isFile()) {
        files.push({
          path: relPath.replace(/\\/g, '/'),
          name: item,
          size: stats.size,
          depth: relPath.split(path.sep).length - 1
        });
      }
    }
  } catch (error) {
    // Skip unreadable directories
  }
  
  return files;
}

// ============================================
// DEEP ROUTE SAMPLING
// ============================================
function sampleDeepRoutes(files) {
  const deepRoutes = files.filter(f => 
    f.depth >= 4 && 
    (f.name.includes('page.') || f.name.includes('route.'))
  );
  
  deepRoutes.sort((a, b) => b.depth - a.depth);
  
  const samples = [];
  const depthsSeen = new Set();
  
  for (const route of deepRoutes) {
    if (!depthsSeen.has(route.depth)) {
      samples.push(route);
      depthsSeen.add(route.depth);
      if (samples.length >= CONFIG.deepRouteSampleSize) break;
    }
  }
  
  return samples;
}

// ============================================
// MAIN ANALYSIS
// ============================================
function analyzeRepo() {
  console.log('🔍 Analyzing repository...\n');
  
  const framework = detectFramework();
  console.log(`📦 Framework: ${framework}`);
  
  const allFiles = collectFiles();
  console.log(`📂 Found ${allFiles.length} files`);
  
  // Score files
  allFiles.forEach(file => {
    file.score = scoreFile(file.path, file.name, framework);
  });
  
  allFiles.sort((a, b) => b.score - a.score);
  
  // Sample deep routes
  const deepRouteSamples = sampleDeepRoutes(allFiles);
  
  // Select within budget
  let tokenEstimate = 0;
  const selectedFiles = [];
  
  // Include deep routes first
  deepRouteSamples.forEach(route => {
    selectedFiles.push(route);
    tokenEstimate += route.path.length / 3;
  });
  
  // Add other files
  for (const file of allFiles) {
    if (selectedFiles.includes(file)) continue;
    const fileTokens = file.path.length / 3 + 10;
    if (tokenEstimate + fileTokens > CONFIG.tokenBudget) break;
    
    selectedFiles.push(file);
    tokenEstimate += fileTokens;
  }
  
  console.log(`✅ Selected ${selectedFiles.length}/${allFiles.length} files`);
  console.log(`📊 Tokens: ${Math.round(tokenEstimate)}/${CONFIG.tokenBudget}\n`);
  
  // Categorize
  const categories = {};
  selectedFiles.forEach(file => {
    let category = 'other';
    if (file.name.includes('page.')) category = 'pages';
    else if (file.name.includes('route.')) category = 'api';
    else if (file.path.includes('/components/')) category = 'components';
    else if (file.path.includes('/hooks/')) category = 'hooks';
    
    if (!categories[category]) categories[category] = [];
    categories[category].push(file.path);
  });
  
  return {
    meta: { framework, budget: { used: Math.round(tokenEstimate), target: CONFIG.tokenBudget } },
    summary: { total: allFiles.length, selected: selectedFiles.length, byCategory: Object.keys(categories).reduce((acc, cat) => { acc[cat] = categories[cat].length; return acc; }, {}) },
    deepRoutes: deepRouteSamples.map(r => r.path),
    categories,
    topFiles: selectedFiles.slice(0, 30).map(f => ({ path: f.path, score: f.score }))
  };
}

// Run analysis
const result = analyzeRepo();
fs.writeFileSync('repo-map.json', JSON.stringify(result, null, 2));

console.log('✨ Generated: repo-map.json\n');

# Create scripts folder if it doesn't exist
mkdir -p scripts

# Add the script
# [paste the script above into scripts/repo-map.js]

# Make it executable (optional)
chmod +x scripts/repo-map.js

// package.json
{
  "scripts": {
    "repo-map": "node scripts/repo-map.js"
  }
}

npm run repo-map

🔍 Analyzing repository...

📦 Framework: nextjs
📂 Found 892 files
✅ Selected 156/892 files (17%)
📊 Tokens: 2847/3000

✨ Generated: repo-map.json

cd ~/repos/novel
node scripts/repo-map.js

{
  "meta": {
    "framework": "nextjs",
    "budget": { "used": 2847, "target": 3000 }
  },
  "summary": {
    "total": 892,
    "selected": 156,
    "byCategory": {
      "pages": 23,
      "components": 45,
      "api": 12,
      "hooks": 8
    }
  },
  "deepRoutes": [
    "src/app/api/users/engagement/super-likes/route.ts",
    "src/app/dashboard/analytics/reports/[id]/page.tsx"
  ],
  "categories": {
    "components": [
      "src/components/editor/bubble-menu.tsx",
      "src/components/editor/bubble-menu/menu-bar.tsx",
      "src/components/editor/bubble-menu/use-bubble-menu.ts",
      ...
    ]
  },
  "topFiles": [
    { "path": "package.json", "score": 30 },
    { "path": "src/components/editor/bubble-menu.tsx", "score": 22 },
    ...
  ]
}

I'm migrating Novel.sh's bubble menu feature to my project. 
Here's Novel's structure:

[paste repo-map.json]

Tasks:
1. Identify all bubble-menu related files
2. Understand dependencies (hooks, utilities, types)
3. Suggest how to organize in my Next.js project
4. Maintain their patterns but adapt to my structure

My project uses: Next.js 15, TypeScript, TipTap, Tailwind

Based on Novel.sh's structure, the bubble menu feature consists of:

## Core Files to Migrate
1. `src/components/editor/bubble-menu.tsx` - Main component
2. `src/components/editor/bubble-menu/menu-bar.tsx` - UI layer
3. `src/hooks/use-bubble-menu.ts` - Logic hook
4. `src/lib/tiptap/extensions/bubble-menu-extension.ts` - TipTap integration

## Dependencies Detected
- `@tiptap/react` - Already in your project ✅
- `@floating-ui/react` - For positioning (need to install)
- `class-variance-authority` - For styling variants ✅

## Suggested Organization in Your Project
your-project/
├── src/
│   ├── components/
│   │   └── editor/
│   │       └── bubble-menu/
│   │           ├── index.tsx           ← Main component
│   │           ├── menu-bar.tsx        ← UI
│   │           └── menu-items.tsx      ← Button configs
│   ├── hooks/
│   │   └── use-bubble-menu.ts          ← Custom hook
│   └── lib/
│       └── tiptap/
│           └── extensions/
│               └── bubble-menu-extension.ts

## Migration Steps
1. Install missing dependency: `@floating-ui/react`
2. Copy core files, adapt imports to your paths
3. Modify styling to use your Tailwind config
4. Test with your existing TipTap editor

Would you like me to start with step 1?

function sampleDeepRoutes(files) {
  // Find deeply nested (depth >= 4)
  const deepRoutes = files.filter(f => f.depth >= 4);
  
  // Sort by depth (deepest first)
  deepRoutes.sort((a, b) => b.depth - a.depth);
  
  // Take ONE example per depth level
  const samples = [];
  const depthsSeen = new Set();
  
  for (const route of deepRoutes) {
    if (!depthsSeen.has(route.depth)) {
      samples.push(route);
      depthsSeen.add(route.depth);
    }
  }
  
  return samples;
}

"deepRoutes": [
  "api/users/posts/engagement/shares/public.ts",  // Depth 5 example
  "api/users/posts/engagement/likes.ts",          // Depth 4 example
]