feat: add --fast mode with Sonnet, demo video

- Fast mode inlines file contents, no tool calls needed
- Schema-aligned JSON prompt for reliable parsing
- 52s analysis time with claude-sonnet-4 (vs 3m+ with opus)
- Added demo-sonnet.mp4 showing end-to-end run

Author: Arthur742Ramos

README.md

@@ -47,8 +47,7 @@ That's it. You get 12+ interconnected markdown files covering everything a new c
 
 <div align="center">
 
-<!-- Demo GIF: Generate with `vhs media/demo.tape` -->
-<!-- ![Repo Bootcamp Demo](https://raw.githubusercontent.com/Arthur742Ramos/repo-bootcamp/main/media/demo.gif) -->
+https://github.com/Arthur742Ramos/repo-bootcamp/raw/main/media/demo-sonnet.mp4
 
 *Generate comprehensive onboarding docs in under 60 seconds*
 

media/demo-sonnet.mp4

@@ -0,0 +1,39 @@
+# Demo: RepoBootcamp with Sonnet --fast mode
+Output media/demo-sonnet.mp4
+Set FontSize 14
+Set Width 1200
+Set Height 700
+Set Theme "Catppuccin Mocha"
+Set TypingSpeed 40ms
+Set Shell zsh
+
+# Start with clean slate
+Hide
+Type "cd /Users/arthur/Desktop/RepoBootcamp && rm -rf /tmp/demo-output"
+Enter
+Sleep 500ms
+Show
+
+# Title
+Type "# RepoBootcamp - Generate onboarding docs in under 1 minute"
+Enter
+Sleep 1.5s
+
+# Run the command
+Type "node dist/index.js https://github.com/sindresorhus/escape-string-regexp -o /tmp/demo-output --fast --model claude-sonnet-4"
+Enter
+Sleep 65s
+
+# Show generated files
+Type "ls -la /tmp/demo-output/"
+Enter
+Sleep 2s
+
+# Show the main bootcamp doc
+Type "head -60 /tmp/demo-output/BOOTCAMP.md"
+Enter
+Sleep 4s
+
+Type "# Done! Full onboarding kit in under 1 minute 🚀"
+Enter
+Sleep 2s

media/demo-sonnet.tape

@@ -5,6 +5,8 @@
 
 import { CopilotClient, SessionEvent } from "@github/copilot-sdk";
 import chalk from "chalk";
+import * as fs from "fs";
+import * as path from "path";
 import type { RepoFacts, ScanResult, RepoInfo, BootcampOptions } from "./types.js";
 import { getRepoTools, setToolContext, clearToolContext } from "./tools.js";
 import { validateRepoFacts, getMissingFieldsSummary, type ValidatedRepoFacts } from "./schema.js";
@@ -161,6 +163,185 @@ Include 2-4 codeExamples showing key patterns/usage (short snippets of 5-15 line
 REMEMBER: Limit tool calls. After reading key files, produce output immediately. Don't over-research.`;
 }
 
+/**
+ * Create a fast analysis prompt with inline file contents (no tools needed)
+ */
+function createFastAnalysisPrompt(
+  repoPath: string,
+  repoInfo: RepoInfo,
+  scanResult: ScanResult,
+  options: BootcampOptions
+): string {
+  // Read key files inline
+  const keyFiles = ["README.md", "readme.md", "package.json", "pyproject.toml", "Cargo.toml", "go.mod"];
+  const inlineContents: string[] = [];
+  
+  for (const filename of keyFiles) {
+    const filePath = path.join(repoPath, filename);
+    if (fs.existsSync(filePath)) {
+      try {
+        const content = fs.readFileSync(filePath, "utf-8").substring(0, 5000);
+        inlineContents.push(`### ${filename}\n\`\`\`\n${content}\n\`\`\``);
+      } catch (e) {
+        // Skip unreadable files
+      }
+    }
+  }
+  
+  // Also try to read main entry point
+  const entryPoints = ["index.ts", "index.js", "src/index.ts", "src/index.js", "main.py", "lib.rs", "main.go"];
+  for (const entry of entryPoints) {
+    const filePath = path.join(repoPath, entry);
+    if (fs.existsSync(filePath)) {
+      try {
+        const content = fs.readFileSync(filePath, "utf-8").substring(0, 3000);
+        inlineContents.push(`### ${entry}\n\`\`\`\n${content}\n\`\`\``);
+        break; // Only include first found entry point
+      } catch (e) {
+        // Skip
+      }
+    }
+  }
+
+  const fileList = scanResult.files
+    .filter((f) => !f.isDirectory)
+    .slice(0, 30)
+    .map((f) => f.path)
+    .join("\n");
+
+  const cmdList = scanResult.commands.map((c) => `- ${c.name}: ${c.command}`).join("\n");
+
+  return `Analyze this repository and produce a comprehensive onboarding kit.
+
+## Repository
+- Name: ${repoInfo.fullName}
+- URL: ${repoInfo.url}
+- Branch: ${repoInfo.branch}
+
+## Pre-detected Information
+Languages: ${scanResult.stack.languages.join(", ") || "Unknown"}
+Frameworks: ${scanResult.stack.frameworks.join(", ") || "None detected"}
+Build System: ${scanResult.stack.buildSystem || "Unknown"}
+Has CI: ${scanResult.stack.hasCi}
+
+## File Tree (first 30 files)
+${fileList}
+
+## Detected Commands
+${cmdList || "None detected"}
+
+## Key File Contents (READ THESE - no tools available)
+${inlineContents.join("\n\n")}
+
+---
+
+Based on the above information, produce a JSON object. Follow this EXACT structure with these EXACT field names and enum values:
+
+## CRITICAL SCHEMA REQUIREMENTS:
+
+### Enum Values (use EXACTLY these strings):
+- confidence: "high", "medium", or "low"
+- entrypoints[].type: "main", "binary", "server", "cli", "web", or "library"
+- firstTasks[].difficulty: "beginner", "intermediate", or "advanced"
+- firstTasks[].category: "bug-fix", "test", "docs", "refactor", or "feature"
+
+### Required Fields:
+- repoName, purpose, description (all strings)
+- stack.languages, stack.frameworks (arrays of strings)
+- stack.buildSystem (string), stack.packageManager (string or null)
+- stack.hasDocker, stack.hasCi (booleans)
+- quickstart.prerequisites, quickstart.steps (arrays of strings)
+- quickstart.commands (array of {name, command, source})
+- structure.keyDirs (array of {path, purpose})
+- structure.entrypoints (array of {path, type, description})
+- structure.testDirs, structure.docsDirs (arrays of strings)
+- ci.workflows (array of {name, file, triggers, mainSteps})
+- ci.mainChecks (array of strings)
+- contrib.howToAddFeature, contrib.howToAddTest (arrays of strings)
+- architecture.overview (string)
+- architecture.components (array of {name, description, directory})
+- firstTasks (array with title, description, difficulty, category, files, why)
+
+\`\`\`json
+{
+  "repoName": "${repoInfo.fullName}",
+  "purpose": "one-line description of what this repo does",
+  "description": "2-3 sentence detailed description",
+  "sources": ["README.md", "package.json"],
+  "confidence": "high",
+  "stack": {
+    "languages": ["TypeScript"],
+    "frameworks": ["Node.js"],
+    "buildSystem": "npm",
+    "packageManager": "npm",
+    "hasDocker": false,
+    "hasCi": true
+  },
+  "quickstart": {
+    "prerequisites": ["Node.js >= 18"],
+    "steps": ["Clone the repository", "Run npm install", "Run npm test"],
+    "commands": [{"name": "install", "command": "npm install", "source": "package.json"}],
+    "commonErrors": [{"error": "Missing dependencies", "fix": "Run npm install"}],
+    "sources": ["README.md"]
+  },
+  "structure": {
+    "keyDirs": [{"path": "src", "purpose": "Source code", "keyFiles": ["index.ts"]}],
+    "entrypoints": [{"path": "src/index.ts", "type": "library", "description": "Main export"}],
+    "testDirs": ["test"],
+    "docsDirs": [],
+    "sources": ["package.json"]
+  },
+  "ci": {
+    "workflows": [{"name": "CI", "file": ".github/workflows/main.yml", "triggers": ["push", "pull_request"], "mainSteps": ["test", "lint"]}],
+    "mainChecks": ["Tests must pass"],
+    "sources": [".github/workflows/main.yml"]
+  },
+  "contrib": {
+    "howToAddFeature": ["Create a new file in src/", "Export from index.ts", "Add tests"],
+    "howToAddTest": ["Add test file in test/ directory", "Run npm test"],
+    "codeStyle": "Standard JavaScript style",
+    "sources": ["README.md"]
+  },
+  "architecture": {
+    "overview": "Simple single-purpose utility library",
+    "components": [{"name": "Core", "description": "Main functionality", "directory": "src"}],
+    "dataFlow": "Input -> Process -> Output",
+    "keyAbstractions": [{"name": "Main function", "description": "Primary export"}],
+    "codeExamples": [{"title": "Basic usage", "file": "src/index.ts", "code": "import x from 'lib'", "explanation": "Import and use"}],
+    "sources": ["src/index.ts"]
+  },
+  "firstTasks": [
+    {
+      "title": "Add a test case",
+      "description": "Add a new test case for edge cases",
+      "difficulty": "beginner",
+      "category": "test",
+      "files": ["test/test.js"],
+      "why": "Good first contribution to understand the codebase"
+    }
+  ],
+  "runbook": {
+    "applicable": false,
+    "deploySteps": [],
+    "observability": [],
+    "incidents": [],
+    "sources": []
+  }
+}
+\`\`\`
+
+Focus: ${options.focus}
+Target audience: ${options.audience}
+
+INSTRUCTIONS:
+1. Replace the example values above with actual data from this repository
+2. Provide at least 3-5 firstTasks with varying difficulty levels
+3. Set runbook.applicable = false for libraries that aren't deployed as services
+4. Use ONLY the exact enum values listed in the CRITICAL SCHEMA REQUIREMENTS section
+
+IMPORTANT: Return ONLY the JSON object, no other text or markdown.`;
+}
+
 /**
  * Parse the JSON response from Copilot and validate against schema
  */
@@ -248,9 +429,13 @@ const PREFERRED_MODELS = [
 async function createSessionWithFallback(
   client: CopilotClient,
   config: Parameters<CopilotClient["createSession"]>[0],
-  verbose: boolean = false
+  verbose: boolean = false,
+  overrideModel?: string
 ): Promise<{ session: Awaited<ReturnType<CopilotClient["createSession"]>>; model: string }> {
-  for (const model of PREFERRED_MODELS) {
+  // If a specific model is requested, try it first
+  const modelsToTry = overrideModel ? [overrideModel, ...PREFERRED_MODELS] : PREFERRED_MODELS;
+  
+  for (const model of modelsToTry) {
     try {
       if (verbose) {
         console.log(chalk.gray(`Trying model: ${model}`));
@@ -304,7 +489,64 @@ export async function analyzeRepo(
     startTime: Date.now(),
   };
 
-  // Set up tool context
+  const client = new CopilotClient();
+
+  // Fast mode: no tools, inline file contents
+  if (options.fast) {
+    try {
+      const { session, model } = await createSessionWithFallback(
+        client,
+        {
+          streaming: true,
+          systemMessage: { content: "You are an expert software architect. Analyze repositories and produce JSON output." },
+          // No tools in fast mode
+        },
+        options.verbose,
+        options.model
+      );
+
+      stats.model = model;
+      console.log(chalk.blue(`\nUsing model: ${model}`));
+      console.log(chalk.yellow(`⚡ Fast mode: no tools, inline file contents\n`));
+
+      const prompt = createFastAnalysisPrompt(repoPath, repoInfo, scanResult, options);
+      let fullResponse = "";
+
+      session.on((event: SessionEvent) => {
+        stats.totalEvents++;
+        if (event.type === "assistant.message_delta") {
+          const delta = event.data.deltaContent;
+          if (delta) {
+            fullResponse += delta;
+            if (options.verbose) {
+              process.stdout.write(delta);
+            }
+          }
+        }
+      });
+
+      await session.sendAndWait({ prompt }, 300000);
+      stats.responseLength = fullResponse.length;
+      stats.endTime = Date.now();
+
+      const { facts, errors, warnings } = parseAndValidateRepoFacts(fullResponse, options.verbose);
+      
+      if (!facts) {
+        throw new Error(`Analysis failed: ${errors?.join(", ") || "Unknown error"}`);
+      }
+
+      if (warnings?.length) {
+        console.log(chalk.yellow("\n[Warnings]"));
+        warnings.forEach(w => console.log(chalk.yellow(`  - ${w}`)));
+      }
+
+      return { facts: facts as RepoFacts, stats };
+    } catch (error: any) {
+      throw new Error(`Fast analysis failed: ${error.message}`);
+    }
+  }
+
+  // Standard mode with tools
   setToolContext({
     repoPath,
     verbose: options.verbose,
@@ -324,8 +566,6 @@ export async function analyzeRepo(
     },
   });
 
-  const client = new CopilotClient();
-
   try {
     // Get tools for the session
     const tools = getRepoTools();
@@ -338,7 +578,8 @@ export async function analyzeRepo(
         systemMessage: { content: SYSTEM_PROMPT },
         tools,
       },
-      options.verbose
+      options.verbose,
+      options.model
     );
 
     stats.model = model;
@@ -432,7 +673,7 @@ No markdown, no explanations, just the JSON object starting with { and ending wi
 - firstTasks: [{ title, description, difficulty, category, files, why }]`;
 
       fullResponse = "";
-      await session.sendAndWait({ prompt: retryPrompt }, 120000);
+      await session.sendAndWait({ prompt: retryPrompt }, 300000);
       result = parseAndValidateRepoFacts(fullResponse, options.verbose);
     }
 

src/agent.ts

@@ -553,6 +553,7 @@ program
   .option("--dry-run", "Preview issues without creating (use with --create-issues)")
   .option("-s, --style <style>", "Output style: startup, enterprise, oss, devops", "oss")
   .option("--render-diagrams [format]", "Render diagrams.mmd to SVG/PNG (requires mermaid-cli)", "svg")
+  .option("--fast", "Fast mode: inline key files, skip tools, much faster (~15-30s)")
   .action(async (repoUrl: string, opts) => {
     const options: BootcampOptions = {
       branch: opts.branch,
@@ -566,6 +567,7 @@ program
       keepTemp: opts.keepTemp || false,
       jsonOnly: opts.jsonOnly || false,
       stats: opts.stats || false,
+      fast: opts.fast || false,
       // New options
       interactive: opts.interactive || false,
       transcript: opts.transcript || false,

src/index.ts

@@ -15,6 +15,7 @@ export interface BootcampOptions {
   keepTemp?: boolean;
   jsonOnly?: boolean;
   stats?: boolean;
+  fast?: boolean;
   // New features
   interactive?: boolean;
   transcript?: boolean;