@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/guide/shared-content.js

@@ -0,0 +1,1272 @@
+/**
+ * Shared Content - Single Source of Truth
+ *
+ * Raw text content used by both:
+ * - compilr_guide tool (for AI agent)
+ * - /tutorial overlay (for user)
+ *
+ * Content is stored as plain text with simple structure.
+ * Styling is applied at render time by each consumer.
+ */
+// =============================================================================
+// Content Topics
+// =============================================================================
+export const CONTENT_TOPICS = [
+    // ===========================================================================
+    // Getting Help
+    // ===========================================================================
+    {
+        id: 'help',
+        title: 'Getting Help',
+        keywords: ['help', '/help', 'commands', 'assistance'],
+        sections: [
+            {
+                title: 'The /help command shows all available commands:',
+                items: ['compilr> /help'],
+            },
+            {
+                title: 'Other ways to get help:',
+                items: [
+                    '/commands - Detailed command reference',
+                    '/tutorial - Interactive guides',
+                ],
+            },
+            {
+                items: ['TIP: Type / and press Tab for autocomplete.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Overlay Navigation
+    // ===========================================================================
+    {
+        id: 'overlay-navigation',
+        title: 'Overlay Navigation',
+        keywords: ['overlay', 'navigation', 'keyboard', 'shortcuts'],
+        sections: [
+            {
+                title: 'When viewing overlays (like /tutorial, /backlog, /projects):',
+                items: [
+                    '↑/↓ or j/k - Move up/down in lists',
+                    '←/→ or h/l - Navigate pages or tabs',
+                    'Tab - Switch between tabs',
+                    '1-9 - Jump to tab by number',
+                    'Enter - Select/confirm',
+                    'q or Esc - Go back/close',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Dashboard Navigation
+    // ===========================================================================
+    {
+        id: 'dashboard',
+        title: 'Dashboard Navigation',
+        keywords: ['dashboard', 'menu', 'home', 'main screen', 'shortcuts'],
+        sections: [
+            {
+                title: 'Quick shortcuts from the Dashboard:',
+                items: [
+                    '[n] - Open /new wizard to create a project',
+                    '[p] - Open /projects to switch projects',
+                    '[c] - Start Quick Chat (chat without project context)',
+                    '[w] - Open /workflow settings',
+                ],
+            },
+            {
+                title: 'Tab switching:',
+                items: [
+                    'Tab - Switch between Dashboard and More tabs',
+                    '1-2 - Jump directly to tab',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // REPL Shortcuts
+    // ===========================================================================
+    {
+        id: 'repl',
+        title: 'REPL Interface',
+        keywords: ['repl', 'prompt', 'typing', 'shortcuts', 'input'],
+        sections: [
+            {
+                title: 'While typing in the REPL:',
+                items: [
+                    'Enter - Send message',
+                    'Esc Esc - Clear input (double tap)',
+                    'Tab - Autocomplete commands and files',
+                    'Down arrow - Navigate to status bar indicators (pending requests, background agents)',
+                ],
+            },
+            {
+                title: 'While the AI is working:',
+                items: ['Esc - Stop gracefully'],
+            },
+            {
+                title: 'Special prefixes:',
+                items: [
+                    '/ - Commands (e.g., /help, /design, /backlog)',
+                    '@ - File references (e.g., @src/index.ts)',
+                    '$ - Team agents (e.g., $arch, $pm, $qa)',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Useful Commands
+    // ===========================================================================
+    {
+        id: 'commands-quick',
+        title: 'Useful Commands',
+        keywords: ['commands', 'quick', 'reference'],
+        sections: [
+            {
+                title: 'Information:',
+                items: [
+                    '/help - All commands',
+                    '/commands - Command reference',
+                    '/tutorial - Interactive guides',
+                    '/status - Project and agent status',
+                ],
+            },
+            {
+                title: 'Navigation:',
+                items: [
+                    '/menu - Return to Dashboard',
+                    '/projects - Switch projects',
+                    '/clear - Clear the screen',
+                    '/exit - Exit the CLI',
+                ],
+            },
+            {
+                title: 'Context:',
+                items: [
+                    '/context - View token usage',
+                    '/compact - Summarize conversation',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Creating a Project
+    // ===========================================================================
+    {
+        id: 'creating-project',
+        title: 'Creating a New Project',
+        keywords: ['create', 'new', 'project', 'init', 'start', '/new'],
+        sections: [
+            {
+                title: 'Two ways to create a project:',
+                items: [
+                    'From the Dashboard: Press [n] or select "/new Project" and press Enter.',
+                    'From the REPL: Type /new and press Enter.',
+                ],
+            },
+            {
+                title: 'The wizard guides you through 8 steps:',
+                items: [
+                    '1. Choose "Start a new project"',
+                    '2. Enter project name (lowercase, hyphens allowed, e.g., my-app)',
+                    '3. Enter description (1-2 sentences about what you\'re building)',
+                    '4. Choose documentation structure (Single repo or Two repos)',
+                    '5. Choose tech stack (React+Node, React+Python, Vue+Node, or Custom)',
+                    '6. Choose coding standards (TypeScript Strict, Relaxed, or Custom)',
+                    '7. Initialize git repository (Yes/No, optionally add remote URL)',
+                    '8. Choose workflow mode (Flexible or Guided)',
+                ],
+            },
+            {
+                title: 'After creation, you get:',
+                items: [
+                    'Project folder with initial structure',
+                    'COMPILR.md file (AI reads this automatically)',
+                    '.compilr/ folder with project config',
+                    'Git repository with initial commit (if selected)',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Importing an Existing Project
+    // ===========================================================================
+    {
+        id: 'importing-project',
+        title: 'Importing an Existing Project',
+        keywords: ['import', 'existing', 'add', 'workflow', '/new', 'project'],
+        sections: [
+            {
+                title: 'Add compilr workflow to an existing codebase:',
+                items: [
+                    'Run /new and select "Add workflow to existing project".',
+                    'Your existing code is not modified — no files are changed, moved, or deleted.',
+                ],
+            },
+            {
+                title: 'The wizard guides you through 5 steps:',
+                items: [
+                    '1. Enter path to existing project (Tab for autocomplete)',
+                    '2. Review detection results (name, language, framework, git remote, COMPILR.md)',
+                    '3. Git repository setup (use detected remote, enter different, or skip)',
+                    '4. Choose workflow mode (Flexible or Guided)',
+                    '5. Confirm and import',
+                ],
+            },
+            {
+                title: 'After import, you get:',
+                items: [
+                    '.compilr/config.json added to your project directory',
+                    'Database entry for project tracking',
+                    'Project selected and ready to use on the Dashboard',
+                ],
+            },
+            {
+                items: ['TIP: Projects outside your projects folder are tracked at their current location.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /design Command
+    // ===========================================================================
+    {
+        id: 'command-design',
+        title: '/design Command',
+        keywords: ['/design', 'design', 'requirements', 'prd', 'planning'],
+        sections: [
+            {
+                items: ['/design - Start comprehensive requirements gathering.'],
+            },
+            {
+                title: 'This command initiates an AI-driven conversation to:',
+                items: [
+                    'Understand what you want to build',
+                    'Ask clarifying questions',
+                    'Generate a Product Requirements Document (PRD)',
+                    'Create backlog items from requirements',
+                ],
+            },
+            {
+                title: 'The AI will guide you through:',
+                items: [
+                    'Project goals and scope',
+                    'User stories and use cases',
+                    'Technical requirements',
+                    'Success criteria',
+                ],
+            },
+            {
+                title: 'After /design completes:',
+                items: [
+                    'PRD is saved to the project database (via project_document_add)',
+                    'Work items are added to your backlog',
+                    'Use /backlog to view and prioritize items',
+                ],
+            },
+            {
+                items: ['Alternative: /sketch for quick 6-question planning.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /backlog Command
+    // ===========================================================================
+    {
+        id: 'command-backlog',
+        title: '/backlog Command',
+        keywords: ['/backlog', 'backlog', 'tasks', 'work items', 'todo'],
+        sections: [
+            {
+                items: ['/backlog - View and manage your work items.'],
+            },
+            {
+                title: 'The overlay shows:',
+                items: [
+                    'Filtering by status (all, pending, in-progress, done)',
+                    'Search functionality',
+                    'Priority indicators',
+                    'Detail view for each item',
+                ],
+            },
+            {
+                title: 'Navigation:',
+                items: [
+                    '↑/↓ or j/k - Move between items',
+                    'Enter - View item details',
+                    'Tab - Switch filter tabs',
+                    '/ - Search items',
+                    'q/Esc - Close',
+                ],
+            },
+            {
+                title: 'Work item statuses:',
+                items: [
+                    'pending - Not started',
+                    'in-progress - Currently working on',
+                    'done - Completed',
+                    'blocked - Cannot proceed',
+                ],
+            },
+            {
+                items: ['To build a backlog item, ask the AI: "Build the user authentication from REQ-001"'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /prd Command
+    // ===========================================================================
+    {
+        id: 'command-prd',
+        title: '/prd Command',
+        keywords: ['/prd', 'prd', 'product requirements', 'requirements document'],
+        sections: [
+            {
+                items: ['/prd - Update the Product Requirements Document.'],
+            },
+            {
+                title: 'Usage:',
+                items: [
+                    '/prd - Choose which section to update',
+                    '/prd vision - Update the vision section',
+                    '/prd scope - Update the scope section',
+                    '/prd technical - Update technical requirements',
+                    '/prd success - Update success criteria',
+                ],
+            },
+            {
+                title: 'The AI will:',
+                items: [
+                    'Read the current PRD from the database',
+                    'Show you the existing content',
+                    'Ask targeted questions about what to change',
+                    'Save the updated PRD to the database',
+                ],
+            },
+            {
+                items: [
+                    'Documents are stored in the database, not the filesystem.',
+                    'Use /docs to browse all project documents.',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /arch Command
+    // ===========================================================================
+    {
+        id: 'command-arch',
+        title: '/arch Command',
+        keywords: ['/arch', 'architecture', 'adr', 'diagram', 'data model', 'api design'],
+        sections: [
+            {
+                items: ['/arch - Create architecture documentation.'],
+            },
+            {
+                title: 'Document types:',
+                items: [
+                    'Decision Record (ADR) - "Why we chose X over Y"',
+                    'System Diagram - Mermaid component diagram',
+                    'Data Model - Entities and relationships',
+                    'API Design - Endpoints and contracts',
+                    'Custom topic - Specify your own',
+                ],
+            },
+            {
+                title: 'The AI will:',
+                items: [
+                    'Read existing PRD and backlog for context',
+                    'Ask questions about your architecture',
+                    'Generate documentation with diagrams (Mermaid)',
+                    'Save to the database via project_document_add',
+                ],
+            },
+            {
+                items: ['You can create multiple architecture docs (e.g., one ADR per decision plus a system diagram).'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /docs Command
+    // ===========================================================================
+    {
+        id: 'command-docs',
+        title: '/docs Command',
+        keywords: ['/docs', 'documents', 'document browser', 'project documents'],
+        sections: [
+            {
+                items: ['/docs - Browse and view all project documents.'],
+            },
+            {
+                title: 'The overlay shows documents with tabbed filtering:',
+                items: [
+                    'All - All documents',
+                    'PRD - Product Requirements Documents',
+                    'ARCH - Architecture documentation',
+                    'DESIGN - Design documents',
+                    'NOTES - Session notes and general notes',
+                    'PLANS - Work plans (from Plan Mode)',
+                ],
+            },
+            {
+                title: 'Navigation:',
+                items: [
+                    '↑/↓ or j/k - Move between documents',
+                    'Tab or 1-6 - Switch filter tabs',
+                    '/ - Search documents',
+                    'Enter - Open document detail view',
+                    'e or i - Edit document (in detail view)',
+                    'q/Esc - Close',
+                ],
+            },
+            {
+                items: ['Documents are stored in the database and created by /design, /prd, /arch, and other commands.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /scaffold Command
+    // ===========================================================================
+    {
+        id: 'command-scaffold',
+        title: '/scaffold Command',
+        keywords: ['/scaffold', 'scaffold', 'project setup', 'foundation', 'boilerplate'],
+        sections: [
+            {
+                items: ['/scaffold - Create the base project structure (folders, config, dependencies, initial code).'],
+            },
+            {
+                title: 'When to use:',
+                items: [
+                    'After /design or /sketch has created your backlog',
+                    'When starting from scratch (empty project directory)',
+                    'When you need a working foundation before building features',
+                ],
+            },
+            {
+                title: 'What it produces:',
+                items: [
+                    'Folder structure (src, tests, config)',
+                    'Package manager setup (package.json, dependencies)',
+                    'Configuration files (TypeScript, ESLint, etc.)',
+                    'Initial code (entry points, basic routes)',
+                    'Git commit with the scaffolded project',
+                ],
+            },
+            {
+                items: [
+                    'Requires a large model tier (Sonnet/Opus recommended).',
+                    'After scaffolding, use /build to implement features.',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /build Command
+    // ===========================================================================
+    {
+        id: 'command-build',
+        title: '/build Command',
+        keywords: ['/build', 'build', 'implement', 'feature', 'backlog item'],
+        sections: [
+            {
+                items: ['/build - Implement a backlog item end-to-end.'],
+            },
+            {
+                title: 'Usage:',
+                items: [
+                    '/build REQ-003 - Build a specific item by ID',
+                    '/build - Pick from your backlog',
+                ],
+            },
+            {
+                title: 'What it does:',
+                items: [
+                    'Reads the backlog item and project context',
+                    'Creates a step-by-step todo plan (8-11 items)',
+                    'Implements backend (models, services, routes)',
+                    'Implements frontend (components, views)',
+                    'Runs build and lint, fixes any errors',
+                    'Creates a git commit and marks item completed',
+                ],
+            },
+            {
+                items: [
+                    'Works with medium tier models and above.',
+                    'Typical build takes 2-5 minutes and 15-40 tool calls.',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Team Agents
+    // ===========================================================================
+    {
+        id: 'team-agents',
+        title: 'Team Agents Overview',
+        keywords: ['team', 'agents', '$', 'arch', 'pm', 'qa', 'dev', 'ops', 'docs', '/team'],
+        sections: [
+            {
+                items: ['Team agents are specialized AI assistants with different expertise, tools, and model tiers.'],
+            },
+            {
+                title: 'Predefined roles (7):',
+                items: [
+                    '$pm - PM: Planning, task tracking, timeline estimation',
+                    '$arch - Architect: System design, patterns, tech decisions',
+                    '$qa - QA Engineer: Testing, quality, code review',
+                    '$dev - Developer: Implementation, coding, debugging',
+                    '$ops - DevOps: Deployment, CI/CD, infrastructure',
+                    '$docs - Technical Writer: Documentation, guides',
+                    '$ba - Business Analyst: Requirements, metrics',
+                ],
+            },
+            {
+                title: 'Using agents:',
+                items: [
+                    '$arch - Switch to the Architect agent',
+                    '$dev fix the bug - Switch to Dev and send message',
+                    'Type $ for autocomplete dropdown of your team',
+                    'message & - Run in background (add & at end)',
+                ],
+            },
+            {
+                title: 'Management commands:',
+                items: [
+                    '/team - Team management overlay (Members, Add Agent, Context)',
+                    '/team add dev - Add developer agent',
+                    '/team remove qa - Remove QA agent',
+                    '/bg - View background agents',
+                    '/pending - View pending requests from background agents',
+                    '/filter - Filter conversation by agent',
+                    '/artifact - Browse team artifacts',
+                    'Down arrow - Quick access to pending/bg indicators in the status bar',
+                ],
+            },
+            {
+                title: 'Custom agents:',
+                items: [
+                    'Select "Create Custom Agent..." in /team Add Agent tab',
+                    '4-step wizard: Basic Info, Tool Profile, Skills, Model Tier',
+                    'Custom agents are saved per-project and persist across sessions',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /context Command
+    // ===========================================================================
+    {
+        id: 'command-context',
+        title: '/context Command',
+        keywords: ['/context', 'context', 'tokens', 'memory', 'usage'],
+        sections: [
+            {
+                items: ['/context - View current context usage.'],
+            },
+            {
+                title: 'Shows:',
+                items: [
+                    'Total tokens used',
+                    'Token breakdown by category',
+                    'Context window utilization',
+                    'Per-agent token usage (if using team agents)',
+                ],
+            },
+            {
+                title: 'Related commands:',
+                items: [
+                    '/compact - Summarize old messages to free up space',
+                    '/tokens - Detailed token breakdown',
+                    '/anchors - View persistent context notes',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /anchors Command
+    // ===========================================================================
+    {
+        id: 'command-anchors',
+        title: '/anchors Command',
+        keywords: ['/anchors', 'anchors', 'notes', 'persistent', 'remember'],
+        sections: [
+            {
+                items: ['/anchors - View and manage persistent notes.'],
+            },
+            {
+                items: ['Anchors are notes that persist across sessions. The AI always sees them.'],
+            },
+            {
+                title: 'Use anchors for:',
+                items: [
+                    'Project conventions ("Always use async/await")',
+                    'Important decisions ("We chose PostgreSQL because...")',
+                    'Reminders ("Don\'t modify the auth module")',
+                ],
+            },
+            {
+                title: 'Adding anchors:',
+                items: [
+                    'In the REPL, ask: "Remember that we use tabs not spaces"',
+                    'The AI will create an anchor for you.',
+                ],
+            },
+            {
+                title: 'In the overlay:',
+                items: [
+                    'a - Add new anchor',
+                    'e - Edit selected anchor',
+                    'd - Delete anchor',
+                    '/ - Search anchors',
+                    'q/Esc - Close',
+                ],
+            },
+            {
+                title: 'Anchor properties:',
+                items: [
+                    'Priority: Critical, Safety, or Info',
+                    'Scope: Global (all projects) or Project (current only)',
+                    'Badges show priority [C/S/I] and scope [G/P]',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /compact Command
+    // ===========================================================================
+    {
+        id: 'command-compact',
+        title: '/compact Command',
+        keywords: ['/compact', 'compact', 'summarize', 'memory'],
+        sections: [
+            {
+                items: ['/compact - Summarize old messages to free up context space.'],
+            },
+            {
+                title: 'When your conversation gets long, context fills up. /compact:',
+                items: [
+                    'Summarizes older messages',
+                    'Preserves key information',
+                    'Frees up token space',
+                    'Keeps recent messages intact',
+                ],
+            },
+            {
+                title: 'Use /compact when:',
+                items: [
+                    '/context shows high usage',
+                    'AI starts forgetting earlier context',
+                    'You want to continue a long session',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // File References
+    // ===========================================================================
+    {
+        id: 'file-references',
+        title: 'File References with @',
+        keywords: ['@', 'file', 'reference', 'path', 'include'],
+        sections: [
+            {
+                title: 'Reference files in your messages with @ prefix:',
+                items: [
+                    'Fix the bug in @src/utils.ts',
+                    'Compare @src/old.ts with @src/new.ts',
+                    'Explain @package.json',
+                ],
+            },
+            {
+                title: 'Autocomplete:',
+                items: [
+                    'Type @ and press Tab to see file matches.',
+                    '@src/ [Tab] shows: src/index.ts, src/utils.ts, etc.',
+                ],
+            },
+            {
+                items: [
+                    'The AI reads referenced files and understands the context.',
+                    'Multiple files can be referenced in one message.',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // COMPILR.md File
+    // ===========================================================================
+    {
+        id: 'compilr-md',
+        title: 'COMPILR.md File',
+        keywords: ['compilr.md', 'context', 'project info', 'readme'],
+        sections: [
+            {
+                items: [
+                    'COMPILR.md is the project context file.',
+                    'Location: Project root (e.g., ./my-project/COMPILR.md)',
+                ],
+            },
+            {
+                title: 'The AI reads this automatically and learns:',
+                items: [
+                    'Project description and goals',
+                    'Tech stack and architecture',
+                    'Coding conventions',
+                    'Important decisions',
+                ],
+            },
+            {
+                items: ['Created by /new wizard with your project info.'],
+            },
+            {
+                title: 'You can edit COMPILR.md to:',
+                items: [
+                    'Add project details',
+                    'Update conventions',
+                    'Document decisions',
+                    'Guide AI behavior',
+                ],
+            },
+            {
+                title: 'The .compilr/ folder contains additional config:',
+                items: [
+                    'config.json - Project configuration',
+                    'architecture/ - Architecture docs and coding standards',
+                    'roadmap.md - Project roadmap',
+                ],
+            },
+            {
+                title: 'Project documents (PRD, architecture, design) are stored in the database:',
+                items: [
+                    'Use /docs to view and manage documents',
+                    'Use /prd to update the Product Requirements Document',
+                    'Use /arch to update the Architecture Document',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Switching Projects
+    // ===========================================================================
+    {
+        id: 'switching-projects',
+        title: 'Switching Projects',
+        keywords: ['switch', 'change', 'project', 'session', 'restore'],
+        sections: [
+            {
+                items: ['When you switch to a different project, your current session is saved automatically.'],
+            },
+            {
+                title: 'What happens when you switch:',
+                items: [
+                    'Current session is saved to the project',
+                    'New project context is loaded (COMPILR.md, anchors)',
+                    'Previous session may be restored based on settings',
+                ],
+            },
+            {
+                title: 'Session restore mode (in /config):',
+                items: [
+                    'Auto - Automatically restore the previous session',
+                    'Ask - Prompt whether to restore or start fresh',
+                    'Fresh - Always start with a clean session',
+                ],
+            },
+            {
+                title: 'Auto-open project (in /config):',
+                items: [
+                    'Last opened - Automatically opens your last project on startup',
+                    'Off - Start fresh, choose project manually',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /projects Command
+    // ===========================================================================
+    {
+        id: 'command-projects',
+        title: '/projects Command',
+        keywords: ['/projects', 'projects', 'list', 'switch', 'manage'],
+        sections: [
+            {
+                items: ['/projects - View and manage all your projects.'],
+            },
+            {
+                title: 'The overlay shows:',
+                items: [
+                    'Project name, type, status, and path',
+                    'Last activity timestamp',
+                    'Work items count',
+                ],
+            },
+            {
+                title: 'Filter by status using tabs:',
+                items: [
+                    'All - Show all projects',
+                    'Active - Currently being worked on',
+                    'Paused - Temporarily on hold',
+                    'Complete - Finished projects',
+                    'Archived - Hidden from main view',
+                ],
+            },
+            {
+                title: 'Actions:',
+                items: [
+                    'Enter - Open project in /workflow',
+                    'e - Edit project name/description',
+                    'x - Archive project',
+                    'd - Delete project (must archive first)',
+                    '/ - Search projects',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /workflow Command
+    // ===========================================================================
+    {
+        id: 'command-workflow',
+        title: '/workflow Command',
+        keywords: ['/workflow', 'workflow', 'status', 'actions', 'manage'],
+        sections: [
+            {
+                items: ['/workflow - View project status and take actions.'],
+            },
+            {
+                title: 'The overlay has 4 tabs:',
+                items: [
+                    'Actions - Quick actions (Design, Sketch, Documents, Anchors)',
+                    'Details - Project info (name, path, created, description)',
+                    'Dashboard - Project metrics (coming soon)',
+                    'Manage - Edit, set current, archive, delete',
+                ],
+            },
+            {
+                title: 'Progress bar shows:',
+                items: [
+                    'Current phase: Initialize → Design → Backlog → Scaffold → Build',
+                    'Work item completion percentage',
+                ],
+            },
+            {
+                title: 'From the Manage tab you can:',
+                items: [
+                    'Edit Project - Change name and description',
+                    'Set as Current - Switch to this project',
+                    'Archive Project - Hide from active list',
+                    'Delete Project - Permanently remove',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Archiving Projects
+    // ===========================================================================
+    {
+        id: 'archiving-projects',
+        title: 'Archiving Projects',
+        keywords: ['archive', 'delete', 'remove', 'hide'],
+        sections: [
+            {
+                items: ['Archiving hides a project from your active list without deleting it.'],
+            },
+            {
+                title: 'To archive a project:',
+                items: [
+                    'From /projects: Select project and press x',
+                    'From /workflow: Go to Manage tab → Archive Project',
+                    'Confirm in the dialog that appears',
+                ],
+            },
+            {
+                title: 'Archived projects:',
+                items: [
+                    'Are hidden from the main project list',
+                    'Can be found in the Archived tab',
+                    'Can be restored by unarchiving',
+                    'Keep all their data (sessions, work items, documents)',
+                ],
+            },
+            {
+                title: 'To delete a project:',
+                items: [
+                    'You must archive it first',
+                    'Then select it from Archived tab and press d',
+                    'Deletion is permanent and cannot be undone',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /model Command
+    // ===========================================================================
+    {
+        id: 'command-model',
+        title: '/model Command',
+        keywords: ['/model', 'model', 'provider', 'claude', 'openai', 'gemini', 'ollama', 'tier'],
+        sections: [
+            {
+                items: ['/model - Select your AI model and provider.'],
+            },
+            {
+                title: 'Provider tabs:',
+                items: [
+                    'Claude - Anthropic models (Haiku, Sonnet, Opus)',
+                    'OpenAI - GPT models',
+                    'Gemini - Google AI models',
+                    'Ollama (local) - Run models on your machine',
+                    'Others - Together AI, Groq, Perplexity, OpenRouter',
+                ],
+            },
+            {
+                title: 'Three tiers per provider:',
+                items: [
+                    'Fast - Quick responses, lower cost',
+                    'Balanced - Best mix of speed and capability',
+                    'Powerful - Best reasoning for complex tasks',
+                ],
+            },
+            {
+                title: 'Navigation:',
+                items: [
+                    'Tab/1-5 - Switch provider',
+                    'Enter - View tier details (cycle models, test, set active)',
+                    's - Set API key',
+                    'e - Enter custom model ID',
+                ],
+            },
+            {
+                items: ['API keys are stored encrypted in ~/.compilr-dev/credentials.enc'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /config Command
+    // ===========================================================================
+    {
+        id: 'command-config',
+        title: '/config Command',
+        keywords: ['/config', 'config', 'settings', 'preferences', 'theme', 'mascot'],
+        sections: [
+            {
+                items: ['/config - Open the settings overlay.'],
+            },
+            {
+                title: 'Four tabs:',
+                items: [
+                    'Status - Session info (version, model, tools, cwd)',
+                    'Config - Toggle preferences (auto-compact, verbose, theme, model, mascot)',
+                    'Environment - Paths, git config, safety settings',
+                    'Usage - Token statistics and context window progress bar',
+                ],
+            },
+            {
+                title: 'Key settings in the Config tab:',
+                items: [
+                    'Auto-compact - Automatically compress old messages',
+                    'Default permission mode - Normal / Plan / Accept edits / Don\'t ask',
+                    'Theme - 418 terminal themes with live preview',
+                    'Model - Opens full model selection',
+                    'Startup behavior - Show menu or direct to REPL',
+                    'Auto-open project - Last opened or Off',
+                    'Session restore mode - Auto / Ask / Fresh',
+                ],
+            },
+            {
+                title: 'Environment tab safety settings:',
+                items: [
+                    'Delete protection - Only allow deletion within projects path',
+                    'CWD mismatch warning - Warn when working outside active project',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /mcp Command
+    // ===========================================================================
+    {
+        id: 'command-mcp',
+        title: '/mcp Command',
+        keywords: ['/mcp', 'mcp', 'model context protocol', 'servers', 'tools', 'external'],
+        sections: [
+            {
+                items: ['/mcp - Manage MCP (Model Context Protocol) servers.'],
+            },
+            {
+                title: 'MCP servers extend the AI with external tools:',
+                items: [
+                    'Filesystem access, GitHub integration, databases, custom APIs',
+                    'Tools appear as mcp_{server}_{tool} in the tool list',
+                    'Shared with all team agents automatically',
+                ],
+            },
+            {
+                title: 'Configuration (mcp.json):',
+                items: [
+                    'Global: ~/.compilr-dev/mcp.json',
+                    'Per-project: <project>/.compilr-dev/mcp.json',
+                    'Project config overrides global by server name',
+                    'Format compatible with Claude Desktop and Gemini CLI',
+                ],
+            },
+            {
+                title: 'Transport types:',
+                items: [
+                    'stdio - Local command (spawns child process)',
+                    'HTTP - Remote server URL with optional headers',
+                ],
+            },
+            {
+                title: 'In the /mcp overlay:',
+                items: [
+                    'j/k - Navigate servers',
+                    '/ - Search servers or tools',
+                    'Enter - View server details and tool list',
+                    'a - Add new server (form wizard)',
+                    'r - Restart server',
+                    'd - Disconnect server',
+                ],
+            },
+            {
+                items: ['Servers connect in the background on startup. Add or restart servers at runtime without restarting the CLI.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Coordinator Mode
+    // ===========================================================================
+    {
+        id: 'coordinator-mode',
+        title: 'Coordinator Mode',
+        keywords: ['coordinator', 'delegate', 'delegation', 'delegate_background', 'orchestrate'],
+        sections: [
+            {
+                items: ['The default agent acts as coordinator and can delegate tasks to specialists running in the background.'],
+            },
+            {
+                title: 'How delegation works:',
+                items: [
+                    'Coordinator calls delegate_background tool with agentId and task',
+                    'Specialist runs the task in the background',
+                    'On completion, coordinator is automatically notified with results',
+                ],
+            },
+            {
+                title: 'delegate_background parameters:',
+                items: [
+                    'agentId - Target specialist (e.g., "dev", "qa", "arch")',
+                    'task - Detailed task description',
+                    'todoIndex - Optional: link to a todo item',
+                    'expectedOutput - Optional: what the specialist should produce',
+                ],
+            },
+            {
+                title: 'Completion delivery:',
+                items: [
+                    'Immediate: If coordinator is idle, auto-resumes with results',
+                    'Deferred: If coordinator is busy, events queue up for next interaction',
+                    'Completion includes: agent name, status, task, result summary, artifacts',
+                ],
+            },
+            {
+                items: ['Specialists are scoped to their delegated task and stop when done. Use /bg to monitor running delegations.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Status Bar Navigation
+    // ===========================================================================
+    {
+        id: 'status-bar-navigation',
+        title: 'Status Bar Navigation',
+        keywords: ['status bar', 'footer', 'indicators', 'pending', 'background', 'down arrow', 'navigation'],
+        sections: [
+            {
+                items: ['The status bar shows navigable indicators for pending requests, background agents, terminals, and notifications.'],
+            },
+            {
+                title: 'Entering status bar navigation:',
+                items: [
+                    'Press Down arrow from the input prompt',
+                    'First indicator is highlighted',
+                ],
+            },
+            {
+                title: 'Navigation keys:',
+                items: [
+                    'Left/Right - Move between indicators',
+                    'Enter - Open the overlay for that indicator',
+                    'Escape or Up - Exit back to input',
+                ],
+            },
+            {
+                title: 'Available indicators (shown when relevant):',
+                items: [
+                    'pending - Pending approval requests from agents',
+                    'bg-agents - Count of background agents running',
+                    'terminals - Multiple CLI sessions active on same project',
+                    'notifications - Unread cross-terminal notifications',
+                    'mcp - MCP servers connecting',
+                ],
+            },
+            {
+                items: ['Each indicator maps to a command: pending → /pending, bg-agents → /bg, terminals → /terminals.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /files Command
+    // ===========================================================================
+    {
+        id: 'command-files',
+        title: '/files Command',
+        keywords: ['/files', 'files', 'tracked', 'read', 'modified', 'referenced'],
+        sections: [
+            {
+                items: ['/files - View files tracked during the current session.'],
+            },
+            {
+                title: 'Filter modes:',
+                items: [
+                    '/files - Show all tracked files',
+                    '/files read - Files the AI has read',
+                    '/files modified - Files the AI has modified',
+                    '/files referenced - Files mentioned but not directly accessed',
+                ],
+            },
+            {
+                title: 'Each file shows:',
+                items: [
+                    '[R] Read, [M] Modified, [~] Referenced',
+                    'Relative file path and line count',
+                    '[cached] marker if content is stored in context',
+                ],
+            },
+            {
+                items: ['In team mode, files are grouped by agent so you can see what each specialist touched.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /changelog Command
+    // ===========================================================================
+    {
+        id: 'command-changelog',
+        title: '/changelog Command',
+        keywords: ['/changelog', 'changelog', 'release', "what's new", 'version', 'changes', 'whatsnew'],
+        sections: [
+            {
+                items: ['/changelog - View release notes and what changed in each version.'],
+            },
+            {
+                title: 'The overlay shows:',
+                items: [
+                    'All releases with version, date, and highlights',
+                    'Categorized changes: Added (+), Changed (~), Fixed (*)',
+                    'Search by version, date, or keywords',
+                ],
+            },
+            {
+                title: 'Navigation:',
+                items: [
+                    'j/k - Navigate releases',
+                    '/ - Search',
+                    'Enter - View release details',
+                    'q/Esc - Close',
+                ],
+            },
+            {
+                items: ['Aliases: /changes, /whatsnew. Startup screen shows highlights from the latest release.'],
+            },
+        ],
+    },
+    // ===========================================================================
+    // /permissions Command
+    // ===========================================================================
+    {
+        id: 'command-permissions',
+        title: '/permissions Command',
+        keywords: ['/permissions', 'permissions', 'safety', 'rules', 'allow', 'deny'],
+        sections: [
+            {
+                items: ['/permissions - Manage tool permissions and safety.'],
+            },
+            {
+                title: 'Three tabs:',
+                items: [
+                    'Rules - Per-tool permission levels (always, session, once, deny)',
+                    'Mode - Global permission mode (Normal, Plan, Auto-accept)',
+                    'Session - Grants given during this session',
+                ],
+            },
+            {
+                title: 'Permission levels:',
+                items: [
+                    'always - No prompt needed (e.g., read_file, glob, grep)',
+                    'session - Allowed for the rest of the session',
+                    'once - Ask every time (e.g., bash, write_file, edit)',
+                    'deny - Explicitly blocked',
+                ],
+            },
+            {
+                title: 'Rules tab shortcuts:',
+                items: [
+                    'a - Add new rule (supports wildcards like git_*)',
+                    'e - Edit selected rule',
+                    'd - Delete custom rule',
+                    'r - Reset all rules to defaults',
+                ],
+            },
+            {
+                items: [
+                    'TIP: Set run_tests and run_lint to "session" so the AI can iterate without asking each time.',
+                ],
+            },
+        ],
+    },
+];
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Find a content topic by ID.
+ */
+export function getContentTopic(id) {
+    return CONTENT_TOPICS.find((t) => t.id === id);
+}
+/**
+ * Find content topics by keyword.
+ */
+export function searchContentTopics(query) {
+    const q = query.toLowerCase().trim();
+    // Exact ID match
+    const exactMatch = CONTENT_TOPICS.find((t) => t.id === q);
+    if (exactMatch)
+        return [exactMatch];
+    // Keyword search
+    return CONTENT_TOPICS.filter((t) => t.keywords.some((k) => k.includes(q) || q.includes(k)) ||
+        t.title.toLowerCase().includes(q)).slice(0, 3);
+}
+/**
+ * Convert a content topic to plain text (for guide tool).
+ */
+export function topicToPlainText(topic) {
+    const lines = [];
+    for (const section of topic.sections) {
+        if (section.title) {
+            lines.push(section.title);
+        }
+        for (const item of section.items) {
+            lines.push(section.title ? `  ${item}` : item);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trim();
+}
+/**
+ * Get all topic IDs.
+ */
+export function getAllTopicIds() {
+    return CONTENT_TOPICS.map((t) => t.id);
+}