docs: add v0.10.0 release notes and update homepage callout

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: prosdev

.changeset/cli-ux-overhaul.md

@@ -13,25 +13,42 @@
 **Index (`dev index`)**
 - 7x faster: removed `buildCodeMetadata` (32s of N+1 git calls → 0s)
 - Auto-starts Antfly if not running — no more "fetch failed" errors
-- Ora spinners with file count during scanning, elapsed timer during embedding
+- Ora spinners with file count during scanning
 - Pre-flight model check: auto-pulls embedding model if missing
 - Resilient error messages with actionable guidance (OOM, port conflict, model missing)
 - Normalized `dev index .` → `dev index` (path defaults to cwd)
 - Improved next steps: MCP install, try-it-out commands, `dev --help`
-- Removed dead "Git history" line from indexing plan
+
+**Search (`dev search`)**
+- Removed misleading percentage scores (RRF scores are not similarity percentages)
+- Default threshold changed from 0.7 to 0 (RRF scores are much lower than cosine similarity)
+- Config no longer required — defaults to current directory
+
+**Map (`dev map`)**
+- Clean output: no markdown headers, no emojis, relative paths, proper tree connectors
+- Fixed `--focus` nesting bug (was showing redundant parent directories)
+- Next steps with usage examples
+- N+1 git fix: `calculateChangeFrequency` now uses single `git log` call with pure testable parser
 
 **Reset (`dev reset`)**
 - New command to tear down Antfly and clean all indexed data
 - Supports both Docker and native cleanup
-- Directs users to `dev setup` to start fresh
 
 **MCP Server**
 - Auto-starts Antfly on MCP server startup (no manual `dev setup` needed after reboot)
 - Auto-recovery: if Antfly crashes mid-session, MCP retries tool calls after restarting the server
 - Human-readable errors when Antfly is unreachable
 
-**Antfly Resilience**
+**Removed**
+- `dev init` — config is now optional, all commands default to current directory
+- `dev stats` and `dev dashboard` — metrics collection removed
+- Dead GitHub output functions (~200 lines)
+
+**Internal**
 - Native-first priority in `ensureAntfly` (better performance, no VM overhead)
 - Port conflict detection with `lsof` guidance
-- `linearMerge` now reports per-page progress via `onProgress` callback
+- `linearMerge` per-page progress via `onProgress` callback
+- `vectors.lance` → `vectors` (clean Antfly table names)
+- Extended scanner exclusions: `.env*`, `*.min.js`, `*.d.ts`, `generated/`, `.terraform/`, `.claude/`
+- Pure testable functions: `parseGitLogOutput`, `buildFrequencyMap`, `stripFocusPrefix`
 - Upgraded ora to 9.x

CLAUDE.md

@@ -82,6 +82,9 @@ dev setup                 # One-time: start Antfly search backend
 - **Changesets target published packages only.** Only `@prosdevlab/dev-agent`
   and `@prosdevlab/kero` are published to npm. All other packages are private
   and bundled into dev-agent via tsup. Never add private packages to changesets.
+- **Changesets include doc site updates.** When adding a changeset, also:
+  1. Add a release entry to `website/content/updates/index.mdx`
+  2. Update `website/content/latest-version.ts` to match the new version
 
 ---
 

packages/cli/README.md

@@ -10,16 +10,6 @@ npm install -g @prosdevlab/dev-agent-cli
 
 ## Usage
 
-### Initialize
-
-Initialize dev-agent in your repository:
-
-```bash
-dev init
-```
-
-This creates a `.dev-agent.json` configuration file.
-
 ### Index Repository
 
 Index your repository for semantic search:
@@ -141,13 +131,12 @@ The `.dev-agent.json` file configures the indexer:
 ### Basic Workflow
 
 ```bash
-# Initialize and index
-dev init
+# Setup and index
+dev setup
 dev index
 
 # View statistics
 dev stats
-# 📊 Files Indexed: 54, Vectors Stored: 566
 ```
 
 ### Semantic Search Examples

packages/cli/src/cli.ts

@@ -4,16 +4,13 @@ import chalk from 'chalk';
 import { Command } from 'commander';
 import { cleanCommand } from './commands/clean.js';
 import { compactCommand } from './commands/compact.js';
-import { dashboardCommand } from './commands/dashboard.js';
 import { exploreCommand } from './commands/explore.js';
 import { indexCommand } from './commands/index.js';
-import { initCommand } from './commands/init.js';
 import { mapCommand } from './commands/map.js';
 import { mcpCommand } from './commands/mcp.js';
 import { resetCommand } from './commands/reset.js';
 import { searchCommand } from './commands/search.js';
 import { setupCommand } from './commands/setup.js';
-import { statsCommand } from './commands/stats.js';
 import { storageCommand } from './commands/storage.js';
 
 // Injected at build time by tsup define
@@ -28,13 +25,10 @@ program
   .version(VERSION);
 
 // Register commands
-program.addCommand(initCommand);
 program.addCommand(indexCommand);
 program.addCommand(searchCommand);
 program.addCommand(exploreCommand);
 program.addCommand(mapCommand);
-program.addCommand(statsCommand);
-program.addCommand(dashboardCommand);
 program.addCommand(compactCommand);
 program.addCommand(cleanCommand);
 program.addCommand(storageCommand);

packages/cli/src/commands/clean.ts

@@ -19,14 +19,7 @@ export const cleanCommand = new Command('clean')
     try {
       // Load config
       const config = await loadConfig();
-      if (!config) {
-        logger.warn('No config found');
-        logger.log('Nothing to clean.');
-        return;
-      }
-
-      // Resolve repository path
-      const repositoryPath = config.repository?.path || config.repositoryPath || process.cwd();
+      const repositoryPath = config?.repository?.path || config?.repositoryPath || process.cwd();
       const resolvedRepoPath = path.resolve(repositoryPath);
 
       // Get centralized storage paths

packages/cli/src/commands/compact.ts

@@ -20,15 +20,7 @@ export const compactCommand = new Command('compact')
     try {
       // Load config
       const config = await loadConfig();
-      if (!config) {
-        spinner.fail('No config found');
-        logger.error('Run "dev init" first to initialize the repository');
-        process.exit(1);
-        return;
-      }
-
-      // Resolve repository path
-      const repositoryPath = config.repository?.path || config.repositoryPath || process.cwd();
+      const repositoryPath = config?.repository?.path || config?.repositoryPath || process.cwd();
       const resolvedRepoPath = path.resolve(repositoryPath);
 
       // Get centralized storage paths
@@ -40,8 +32,8 @@ export const compactCommand = new Command('compact')
       const indexer = new RepositoryIndexer({
         repositoryPath: resolvedRepoPath,
         vectorStorePath: filePaths.vectors,
-        excludePatterns: config.repository?.excludePatterns || config.excludePatterns,
-        languages: config.repository?.languages || config.languages,
+        excludePatterns: config?.repository?.excludePatterns || config?.excludePatterns,
+        languages: config?.repository?.languages || config?.languages,
       });
 
       await indexer.initialize();

packages/cli/src/commands/explore.ts

@@ -25,15 +25,7 @@ explore
 
     try {
       const config = await loadConfig();
-      if (!config) {
-        spinner.fail('No config found');
-        logger.error('Run "dev init" first');
-        process.exit(1);
-        return;
-      }
-
-      // Resolve repository path
-      const repositoryPath = config.repository?.path || config.repositoryPath || process.cwd();
+      const repositoryPath = config?.repository?.path || config?.repositoryPath || process.cwd();
       const resolvedRepoPath = path.resolve(repositoryPath);
 
       // Get centralized storage paths
@@ -44,8 +36,8 @@ explore
       const indexer = new RepositoryIndexer({
         repositoryPath: resolvedRepoPath,
         vectorStorePath: filePaths.vectors,
-        excludePatterns: config.repository?.excludePatterns || config.excludePatterns,
-        languages: config.repository?.languages || config.languages,
+        excludePatterns: config?.repository?.excludePatterns || config?.excludePatterns,
+        languages: config?.repository?.languages || config?.languages,
       });
 
       await indexer.initialize();
@@ -99,15 +91,7 @@ explore
 
     try {
       const config = await loadConfig();
-      if (!config) {
-        spinner.fail('No config found');
-        logger.error('Run "dev init" first');
-        process.exit(1);
-        return;
-      }
-
-      // Resolve repository path
-      const repositoryPath = config.repository?.path || config.repositoryPath || process.cwd();
+      const repositoryPath = config?.repository?.path || config?.repositoryPath || process.cwd();
       const resolvedRepoPath = path.resolve(repositoryPath);
 
       // Get centralized storage paths
@@ -131,8 +115,8 @@ explore
       const indexer = new RepositoryIndexer({
         repositoryPath: resolvedRepoPath,
         vectorStorePath: filePaths.vectors,
-        excludePatterns: config.repository?.excludePatterns || config.excludePatterns,
-        languages: config.repository?.languages || config.languages,
+        excludePatterns: config?.repository?.excludePatterns || config?.excludePatterns,
+        languages: config?.repository?.languages || config?.languages,
       });
 
       await indexer.initialize();

packages/cli/src/commands/index.ts

@@ -170,7 +170,6 @@ export const indexCommand = new Command('index')
       console.log('  Try it out:');
       console.log('    dev search "authentication"    Semantic code search');
       console.log('    dev map                        Explore codebase structure');
-      console.log('    dev status                     Check index health');
       console.log('    dev --help                     See all commands');
       console.log('');
 

packages/cli/src/commands/map.ts

@@ -57,21 +57,15 @@ Use Case:
 
     // Create logger with debug enabled if --verbose
     const mapLogger = createLogger({
-      level: options.verbose ? 'debug' : 'info',
+      level: options.verbose ? 'debug' : 'warn',
       format: 'pretty',
     });
 
     const spinner = ora('Loading configuration...').start();
 
     try {
       const config = await loadConfig();
-      if (!config) {
-        spinner.fail('No config found');
-        logger.error('Run "dev init" first to initialize dev-agent');
-        process.exit(1);
-      }
-
-      const repositoryPath = config.repository?.path || config.repositoryPath || process.cwd();
+      const repositoryPath = config?.repository?.path || config?.repositoryPath || process.cwd();
       const resolvedRepoPath = path.resolve(repositoryPath);
 
       spinner.text = 'Initializing indexer...';
@@ -98,7 +92,7 @@ Use Case:
       // Check if repository is indexed
       mapLogger.debug('Checking if repository is indexed');
       const stats = await indexer.getStats();
-      if (!stats || stats.filesScanned === 0) {
+      if (!stats) {
         spinner.fail('Repository not indexed');
         await indexer.close();
         logger.warn('No indexed data found.');
@@ -194,36 +188,25 @@ Use Case:
         'Map generation complete'
       );
 
-      spinner.succeed(
-        `Map generated in ${t4 - startTime}ms (init: ${t2 - t1}ms, map: ${t4 - t3}ms)`
-      );
+      const duration = ((t4 - startTime) / 1000).toFixed(1);
+      spinner.succeed(`Map generated (${duration}s)`);
 
-      // Format and display
-      mapLogger.debug('Formatting map output');
-      const t5 = Date.now();
       const formatted = formatCodebaseMap(map, {
         includeExports: options.exports,
         includeChangeFrequency: options.changeFrequency,
+        repositoryPath: resolvedRepoPath,
       });
-      const t6 = Date.now();
-      mapLogger.debug({ duration_ms: t6 - t5, outputLength: formatted.length }, 'Map formatted');
-
-      output.log('');
-      output.log(formatted);
-      output.log('');
 
-      // Show summary
-      output.log(
-        `📊 Total: ${map.totalComponents.toLocaleString()} components across ${map.totalDirectories.toLocaleString()} directories`
-      );
-      if (map.hotPaths.length > 0) {
-        output.log(`🔥 ${map.hotPaths.length} hot paths identified`);
-      }
-      output.log('');
+      console.log('');
+      console.log(formatted);
+      console.log('');
+      console.log('  Try:');
+      console.log('    dev search "<query>"            Search indexed code');
+      console.log('    dev map --depth 3               Show deeper structure');
+      console.log('    dev map --focus packages/core    Focus on a directory');
+      console.log('');
 
-      mapLogger.info('Closing indexer');
       await indexer.close();
-      mapLogger.debug('Indexer closed');
     } catch (error) {
       spinner.fail('Failed to generate map');
       logger.error(`Error: ${error instanceof Error ? error.message : String(error)}`);

packages/cli/src/commands/search.ts

@@ -16,24 +16,16 @@ export const searchCommand = new Command('search')
   .description('Search indexed code semantically')
   .argument('<query>', 'Search query')
   .option('-l, --limit <number>', 'Maximum number of results', '10')
-  .option('-t, --threshold <number>', 'Minimum similarity score (0-1)', '0.7')
+  .option('-t, --threshold <number>', 'Minimum similarity score', '0')
   .option('--json', 'Output results as JSON', false)
   .option('-v, --verbose', 'Show detailed results with signatures and docs', false)
   .action(async (query: string, options) => {
     const spinner = ora('Searching...').start();
 
     try {
-      // Load config
+      // Load config (optional — defaults to cwd)
       const config = await loadConfig();
-      if (!config) {
-        spinner.fail('No config found');
-        logger.error('Run "dev init" first to initialize dev-agent');
-        process.exit(1);
-        return; // TypeScript needs this
-      }
-
-      // Resolve repository path
-      const repositoryPath = config.repository?.path || config.repositoryPath || process.cwd();
+      const repositoryPath = config?.repository?.path || config?.repositoryPath || process.cwd();
       const resolvedRepoPath = path.resolve(repositoryPath);
 
       // Get centralized storage paths
@@ -45,8 +37,8 @@ export const searchCommand = new Command('search')
       const indexer = new RepositoryIndexer({
         repositoryPath: resolvedRepoPath,
         vectorStorePath: filePaths.vectors,
-        excludePatterns: config.repository?.excludePatterns || config.excludePatterns,
-        languages: config.repository?.languages || config.languages,
+        excludePatterns: config?.repository?.excludePatterns || config?.excludePatterns,
+        languages: config?.repository?.languages || config?.languages,
       });
 
       await indexer.initialize();
@@ -65,9 +57,9 @@ export const searchCommand = new Command('search')
       if (results.length === 0) {
         output.log('');
         output.warn('No results found. Try:');
-        output.log(`  • Lower threshold: ${chalk.cyan('--threshold 0.5')}`);
+        output.log(`  • Lower threshold: ${chalk.cyan('--threshold 0.3')}`);
         output.log(`  • Different keywords`);
-        output.log(`  • Refresh index: ${chalk.cyan('dev update')}`);
+        output.log(`  • Re-index: ${chalk.cyan('dev index --force')}`);
         output.log('');
         return;
       }