@compilr-dev/cli 0.5.17 → 0.6.1

package/dist/commands-v2/handlers/project.d.ts

@@ -19,4 +19,5 @@ export declare const scaffoldCommand: CommandHandlerV2;
 export declare const archCommand: CommandHandlerV2;
 export declare const docsCommand: CommandHandlerV2;
 export declare const projectsCommand: CommandHandlerV2;
+export declare const appCommand: CommandHandlerV2;
 export declare const projectCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/project.js

@@ -4,7 +4,7 @@
  * Commands for project management: init, backlog, workflow, anchors, design, sketch, refine
  */
 import { executeCommand } from '../registry.js';
-import { BacklogOverlayV2, WorkflowOverlayV2, DocsOverlayV2, DocumentDetailOverlayV2, AnchorsOverlayV2, ProjectsOverlayV2, NewProjectOverlayV2, OnboardingWizardOverlayV2, KeysOverlayV2, ArchTypeOverlayV2, ModelWarningOverlayV2 } from '../../ui/overlay/index.js';
+import { BacklogOverlayV2, WorkflowOverlayV2, DocsOverlayV2, DocumentDetailOverlayV2, AnchorsOverlayV2, ProjectsOverlayV2, NewProjectOverlayV2, OnboardingWizardOverlayV2, KeysOverlayV2, ArchTypeOverlayV2, ModelWarningOverlayV2, AppModelOverlayV2 } from '../../ui/overlay/index.js';
 import { projectRepository, workItemRepository, documentRepository } from '../../db/repositories/index.js';
 import { setCurrentProject, getCurrentProject } from '../../tools/project-db.js';
 import { getSkillPrompt } from '../../repl-helpers.js';
@@ -85,7 +85,7 @@ export const newCommand = {
                     display_name: displayName,
                     description: result.description,
                     path: result.projectPath,
-                    type: 'general',
+                    type: 'general', // TODO: wizard should let user pick project type (web/cli/library/api/research/etc.)
                     workflow_mode: result.workflowMode ?? 'flexible',
                     git_remote: result.gitRemote,
                     // For imports, include detected language and framework
@@ -1120,6 +1120,39 @@ export const projectsCommand = {
     },
 };
 // =============================================================================
+// App Model Command
+// =============================================================================
+export const appCommand = {
+    name: 'app',
+    description: 'View the application model (entities, relationships, features)',
+    details: 'Opens an interactive overlay showing the ApplicationModel for the current project. Browse entities with their fields and relationships, see the relationship map, and review model summary stats.',
+    examples: [{ code: '/app' }],
+    interactions: [
+        'Tab cycles: Entities → Relationships → Summary',
+        '↑/↓ to navigate, Enter for entity detail',
+        '/ to search, q/Esc to close',
+    ],
+    async execute(_args, ctx) {
+        const currentProject = getCurrentProject();
+        if (!currentProject) {
+            ctx.ui.print({ type: 'warning', message: 'No active project. Use /new or /projects first.' });
+            return true;
+        }
+        // Load app model from document store
+        const appModelDoc = documentRepository.getByType(currentProject.id, 'app-model');
+        if (!appModelDoc) {
+            ctx.ui.print({ type: 'warning', message: 'No application model found for this project.' });
+            return true;
+        }
+        const overlay = new AppModelOverlayV2({
+            modelJson: appModelDoc.content,
+            projectName: currentProject.displayName,
+        });
+        await ctx.ui.showOverlay(overlay);
+        return true;
+    },
+};
+// =============================================================================
 // Export All Project Commands
 // =============================================================================
 export const projectCommands = [
@@ -1138,4 +1171,5 @@ export const projectCommands = [
     archCommand,
     docsCommand,
     projectsCommand,
+    appCommand,
 ];

package/dist/commands-v2/handlers/team.js

@@ -10,6 +10,7 @@ import { ArtifactOverlayV2, ArtifactDetailOverlayV2 } from '../../ui/overlay/ind
 import { ROLE_METADATA, PREDEFINED_ROLE_IDS } from '../../multi-agent/index.js';
 import { loadCustomAgents, createCustomAgentDefinition, addCustomAgent, removeCustomAgent, } from '../../multi-agent/custom-agents.js';
 import { getCurrentProject } from '../../tools/project-db.js';
+import { listTemplates, saveTemplate } from '@compilr-dev/sdk';
 import { getSessionRegistry } from '../../multi-agent/session-registry.js';
 import { saveCurrentTeam, saveCurrentSession } from './session.js';
 // =============================================================================
@@ -291,19 +292,38 @@ async function handleCreateCustomAgent(ctx, team) {
     // Load existing custom agents for duplicate check
     const existingCustomAgents = loadCustomAgents(projectPath);
     const teamAgentIds = team.getAgentIds();
-    // Show custom agent form
+    // Load templates for pre-population
+    const templates = listTemplates();
+    // Show custom agent form (with template support)
     const formOverlay = new CustomAgentFormOverlayV2({
         existingCustomAgents,
         teamAgentIds,
+        templates: templates.length > 0 ? templates : undefined,
     });
     const formResult = await ctx.ui.showOverlay(formOverlay);
     // User cancelled
     if (!formResult || formResult.cancelled || !formResult.agent) {
         return;
     }
-    // Create the custom agent definition
+    // Save as template if user chose to
     const agentData = formResult.agent;
-    const agentDef = createCustomAgentDefinition(agentData.id, agentData.displayName, agentData.specialty, agentData.personality, existingCustomAgents, agentData.toolConfig, agentData.enabledSkills, agentData.modelTier);
+    if (formResult.saveAsTemplate) {
+        saveTemplate(formResult.saveAsTemplate, {
+            id: agentData.id,
+            displayName: agentData.displayName,
+            specialty: agentData.specialty,
+            personality: agentData.personality,
+            systemPromptAddition: agentData.systemPromptAddition,
+            mascot: '',
+            createdAt: new Date().toISOString(),
+            toolConfig: agentData.toolConfig,
+            enabledSkills: agentData.enabledSkills,
+            modelTier: agentData.modelTier,
+        });
+        ctx.ui.print({ type: 'success', message: `Template "${formResult.saveAsTemplate}" saved.` });
+    }
+    // Create the custom agent definition
+    const agentDef = createCustomAgentDefinition(agentData.id, agentData.displayName, agentData.specialty, agentData.personality, existingCustomAgents, agentData.toolConfig, agentData.enabledSkills, agentData.modelTier, agentData.systemPromptAddition);
     // Save to project
     try {
         addCustomAgent(projectPath, agentDef);

package/dist/entitlements/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * EntitlementService — Server-driven tier management for the CLI.
+ *
+ * Wraps the SDK's EntitlementCache with CLI-specific concerns:
+ * - Fetches from compilr.dev backend using the user's API token
+ * - Uses encrypted file for offline backup
+ * - Warms cache on startup
+ */
+import { EntitlementCache } from '@compilr-dev/sdk';
+import { DailyCounter } from '@compilr-dev/sdk';
+/** Daily message counter — tracks agent LLM calls per day */
+export declare const dailyMessageCounter: DailyCounter;
+/** Daily conversation counter */
+export declare const dailyConversationCounter: DailyCounter;
+/**
+ * Get or create the entitlement cache singleton.
+ * @param getToken — async function that returns the current auth token
+ */
+export declare function getEntitlementCache(getToken: () => Promise<string>): EntitlementCache;
+/**
+ * Warm the cache on startup. Non-blocking — logs but doesn't throw.
+ */
+export declare function warmEntitlementCache(getToken: () => Promise<string>): Promise<void>;

package/dist/entitlements/index.js

@@ -0,0 +1,110 @@
+/**
+ * EntitlementService — Server-driven tier management for the CLI.
+ *
+ * Wraps the SDK's EntitlementCache with CLI-specific concerns:
+ * - Fetches from compilr.dev backend using the user's API token
+ * - Uses encrypted file for offline backup
+ * - Warms cache on startup
+ */
+import { EntitlementCache } from '@compilr-dev/sdk';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { createCipheriv, createDecipheriv, randomBytes, createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+// ─── Encrypted File Store ───────────────────────────────────────────────────
+function getEntitlementPath() {
+    return join(homedir(), '.compilr-dev', 'entitlements.enc');
+}
+/**
+ * Derive a machine-specific encryption key from hostname + username.
+ * Not cryptographically strong against targeted attacks, but prevents
+ * casual file copying between machines.
+ */
+function deriveKey() {
+    const material = `compilr-entitlements:${homedir()}:${String(process.pid)}`;
+    return createHash('sha256').update(material).digest();
+}
+const cliStore = {
+    save(data) {
+        try {
+            const dir = join(homedir(), '.compilr-dev');
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            const key = deriveKey();
+            const iv = randomBytes(16);
+            const cipher = createCipheriv('aes-256-cbc', key, iv);
+            const encrypted = Buffer.concat([cipher.update(data, 'utf-8'), cipher.final()]);
+            const payload = Buffer.concat([iv, encrypted]);
+            writeFileSync(getEntitlementPath(), payload);
+        }
+        catch {
+            // Best effort — don't crash on write failure
+        }
+        return Promise.resolve();
+    },
+    load() {
+        const path = getEntitlementPath();
+        if (!existsSync(path))
+            return Promise.resolve(null);
+        try {
+            const payload = readFileSync(path);
+            const iv = payload.subarray(0, 16);
+            const encrypted = payload.subarray(16);
+            const key = deriveKey();
+            const decipher = createDecipheriv('aes-256-cbc', key, iv);
+            const decrypted = Buffer.concat([decipher.update(encrypted), decipher.final()]);
+            return Promise.resolve(decrypted.toString('utf-8'));
+        }
+        catch {
+            return Promise.resolve(null);
+        }
+    },
+};
+// ─── Fetch Function ─────────────────────────────────────────────────────────
+async function fetchEntitlements(getToken) {
+    const token = await getToken();
+    const apiUrl = process.env['COMPILR_API_URL'] ?? 'https://compilr.dev/.netlify/functions';
+    const resp = await fetch(`${apiUrl}/cli-entitlements`, {
+        method: 'GET',
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!resp.ok) {
+        throw new Error(`Entitlements fetch failed: ${String(resp.status)}`);
+    }
+    return await resp.json();
+}
+// ─── Singleton ──────────────────────────────────────────────────────────────
+import { DailyCounter } from '@compilr-dev/sdk';
+let cacheInstance = null;
+/** Daily message counter — tracks agent LLM calls per day */
+export const dailyMessageCounter = new DailyCounter();
+/** Daily conversation counter */
+export const dailyConversationCounter = new DailyCounter();
+/**
+ * Get or create the entitlement cache singleton.
+ * @param getToken — async function that returns the current auth token
+ */
+export function getEntitlementCache(getToken) {
+    if (!cacheInstance) {
+        cacheInstance = new EntitlementCache({
+            fetchFn: () => fetchEntitlements(getToken),
+            store: cliStore,
+        });
+    }
+    return cacheInstance;
+}
+/**
+ * Warm the cache on startup. Non-blocking — logs but doesn't throw.
+ */
+export async function warmEntitlementCache(getToken) {
+    try {
+        const cache = getEntitlementCache(getToken);
+        await cache.get();
+    }
+    catch {
+        // Not critical — will retry on next access
+    }
+}

package/dist/guide/cli-guide-entries.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI-Specific Guide Entries
+ *
+ * These entries are only relevant for the CLI environment.
+ * Combined with SDK shared content via createGuideTool({ additionalEntries }).
+ *
+ * The shared-content.ts file is still used by the /tutorial overlay (CLI UI).
+ * This file converts those topics + CLI-only entries for the SDK guide tool.
+ */
+import type { GuideEntry } from '@compilr-dev/sdk';
+/**
+ * All CLI-specific guide entries.
+ * Includes CLI-only topics + converted shared-content topics (used by /tutorial).
+ */
+export declare const CLI_GUIDE_ENTRIES: GuideEntry[];

package/dist/guide/cli-guide-entries.js

@@ -0,0 +1,99 @@
+/**
+ * CLI-Specific Guide Entries
+ *
+ * These entries are only relevant for the CLI environment.
+ * Combined with SDK shared content via createGuideTool({ additionalEntries }).
+ *
+ * The shared-content.ts file is still used by the /tutorial overlay (CLI UI).
+ * This file converts those topics + CLI-only entries for the SDK guide tool.
+ */
+import { topicToGuideEntry } from '@compilr-dev/sdk';
+import { CONTENT_TOPICS } from './shared-content.js';
+// =============================================================================
+// CLI-Only Entries (not in shared SDK content, not in tutorials)
+// =============================================================================
+const CLI_ONLY_ENTRIES = [
+    {
+        id: 'cli-overview',
+        title: 'Compilr Dev CLI Overview',
+        keywords: ['overview', 'what is', 'introduction', 'about', 'compilr', 'cli'],
+        content: `Compilr Dev CLI is an AI-powered coding assistant for your terminal.
+
+Key features:
+- Multi-LLM support (Claude, OpenAI, Gemini, Ollama)
+- Project management with structured workflows
+- Requirements gathering with /design command
+- Backlog tracking with /backlog command
+- Team agents for specialized assistance ($arch, $pm, $qa, etc.)
+- Session persistence and context management
+- Image support (paste screenshots into chat)
+
+The CLI has two main interfaces:
+1. Dashboard — A menu-based interface for project management
+2. REPL — A command-line interface for chatting with the AI
+
+Run "compilr" to start. Use /help to see all commands.`,
+    },
+    {
+        id: 'workflow-modes',
+        title: 'Workflow',
+        keywords: ['workflow', 'flexible', 'mode'],
+        content: `The agent works in flexible mode — it responds to your requests and adapts to your workflow.
+
+The agent checks your project state and suggests next steps:
+- Does the project have a PRD? If not, suggests /design
+- Are there backlog items? Suggests /build
+- Is architecture documented? Suggests /arch
+
+Use /workflow to see project status and recommended next actions.`,
+    },
+    {
+        id: 'workflow-recommended',
+        title: 'Recommended Workflow',
+        keywords: ['workflow', 'how to', 'best practice', 'process'],
+        content: `Recommended workflow for new projects:
+
+1. Create project with /new — choose tech stack, set up git
+2. Plan with /design — describe what you want, AI generates PRD + backlog
+3. Review backlog with /backlog — prioritize tasks
+4. Build features — "Build REQ-001: User authentication"
+5. Manage context — /compact when context fills up, /anchors for decisions, /resume to continue later`,
+    },
+    {
+        id: 'command-resume',
+        title: '/resume Command',
+        keywords: ['/resume', 'resume', 'session', 'continue', 'previous'],
+        content: `/resume — Continue a previous session.
+
+Sessions are auto-saved after each AI response.
+
+Navigation: j/k (up/down), / (search), Enter (resume), d (delete), q/Esc (close)
+
+Saved per session: conversation history, todo list, workflow state, token usage.
+Saved per project (not session): anchors, team agents, documents.`,
+    },
+    {
+        id: 'command-team',
+        title: '/team Command',
+        keywords: ['/team', 'team', 'agents', 'manage'],
+        content: `/team — View and manage team agents.
+
+Shows all available agents with status and context usage.
+Tabs: Agents (list) | Context (token usage per agent)
+
+Switch agents: select + Enter, or use $ prefix in REPL ($arch, $pm, $qa).`,
+    },
+];
+// =============================================================================
+// Combined CLI Entries (CLI-only + shared-content topics)
+// =============================================================================
+/**
+ * All CLI-specific guide entries.
+ * Includes CLI-only topics + converted shared-content topics (used by /tutorial).
+ */
+export const CLI_GUIDE_ENTRIES = [
+    ...CLI_ONLY_ENTRIES,
+    // Convert shared ContentTopics to GuideEntries (these are CLI-specific
+    // topics like overlay navigation, REPL, dashboard, /commands)
+    ...CONTENT_TOPICS.map(topicToGuideEntry),
+];

package/dist/guide/index.d.ts

@@ -1,8 +1,9 @@
 /**
  * Compilr Guide Module
  *
- * Provides documentation for the AI agent to answer user questions
- * about how to use the CLI.
+ * CLI-specific guide entries for the SDK's compilr_guide tool.
+ * shared-content.ts is still used by the /tutorial overlay.
  */
-export { searchGuide, getGuideTopics, guideEntries } from './guide-content.js';
-export type { GuideEntry } from './guide-content.js';
+export { CLI_GUIDE_ENTRIES } from './cli-guide-entries.js';
+export { CONTENT_TOPICS, topicToPlainText, searchContentTopics, getAllTopicIds } from './shared-content.js';
+export type { ContentTopic, ContentSection } from './shared-content.js';

package/dist/guide/index.js

@@ -1,7 +1,8 @@
 /**
  * Compilr Guide Module
  *
- * Provides documentation for the AI agent to answer user questions
- * about how to use the CLI.
+ * CLI-specific guide entries for the SDK's compilr_guide tool.
+ * shared-content.ts is still used by the /tutorial overlay.
  */
-export { searchGuide, getGuideTopics, guideEntries } from './guide-content.js';
+export { CLI_GUIDE_ENTRIES } from './cli-guide-entries.js';
+export { CONTENT_TOPICS, topicToPlainText, searchContentTopics, getAllTopicIds } from './shared-content.js';

package/dist/guide/shared-content.js

@@ -258,9 +258,10 @@ export const CONTENT_TOPICS = [
             {
                 title: 'After /design completes:',
                 items: [
-                    'PRD is saved to the project database (via project_document_add)',
+                    'PRD is saved to the project database',
+                    'Application Model is created (entities, fields, relationships)',
                     'Work items are added to your backlog',
-                    'Use /backlog to view and prioritize items',
+                    'Use /backlog to view items, /app to view the model',
                 ],
             },
             {
@@ -429,35 +430,41 @@ export const CONTENT_TOPICS = [
     {
         id: 'command-scaffold',
         title: '/scaffold Command',
-        keywords: ['/scaffold', 'scaffold', 'project setup', 'foundation', 'boilerplate'],
+        keywords: ['/scaffold', 'scaffold', 'project setup', 'foundation', 'boilerplate', 'factory', 'generate'],
         sections: [
             {
-                items: ['/scaffold - Create the base project structure (folders, config, dependencies, initial code).'],
+                items: ['/scaffold - Generate a full project from the Application Model or create a base structure.'],
             },
             {
-                title: 'When to use:',
+                title: 'Two modes:',
                 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',
+                    'Factory mode: If an Application Model exists (from /design), scaffolds using the factory',
+                    'Manual mode: If no model, the agent creates structure from scratch',
                 ],
             },
             {
-                title: 'What it produces:',
+                title: 'Factory toolkits:',
                 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',
+                    'react-node - React 18 + Vite + Tailwind + Express + PostgreSQL',
+                    'next-prisma - Next.js 14 App Router + Prisma ORM + Tailwind',
+                    'static-landing - HTML + Tailwind CSS landing page',
+                    'react-fastapi - React 18 + Vite + Tailwind + FastAPI (Python)',
+                    'react-go - React 18 + Vite + Tailwind + Go (net/http)',
                 ],
             },
             {
+                title: 'What factory mode produces:',
                 items: [
-                    'Requires a large model tier (Sonnet/Opus recommended).',
-                    'After scaffolding, use /build to implement features.',
+                    'Full CRUD pages for each entity (list, create, edit, detail)',
+                    'API routes and data layer',
+                    'Seed data from the model',
+                    'Navigation, dashboard, theme, auth (if enabled)',
+                    'Ready to run: npm install && npm run dev',
                 ],
             },
+            {
+                items: ['Use /app to view the Application Model before scaffolding.'],
+            },
         ],
     },
     // ===========================================================================
@@ -509,15 +516,19 @@ export const CONTENT_TOPICS = [
                 items: ['Team agents are specialized AI assistants with different expertise, tools, and model tiers.'],
             },
             {
-                title: 'Predefined roles (7):',
+                title: 'Predefined roles (11):',
                 items: [
+                    '$dev - Developer: Implementation, coding, debugging',
                     '$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',
+                    '$writer - Technical Writer: Documentation, guides',
+                    '$researcher - Researcher: Literature review, analysis',
+                    '$reviewer - Reviewer: Code and content review',
+                    '$editor - Editor: Content editing, prose, structure',
+                    '$analyst - Analyst: Data and business analysis',
+                    '$strategist - Strategist: Strategy and planning',
+                    '$instructor - Instructor: Teaching, course design',
                 ],
             },
             {
@@ -1225,6 +1236,162 @@ export const CONTENT_TOPICS = [
             },
         ],
     },
+    // ===========================================================================
+    // /app Command (Application Model Viewer)
+    // ===========================================================================
+    {
+        id: 'command-app',
+        title: '/app Command',
+        keywords: ['/app', 'app', 'model', 'entities', 'fields', 'relationships', 'application model'],
+        sections: [
+            {
+                items: ['/app - View the Application Model for the current project.'],
+            },
+            {
+                title: 'Three tabs:',
+                items: [
+                    'Entities - List of all entities with field and relationship counts',
+                    'Relationships - Map of all entity relationships (hasMany/belongsTo)',
+                    'Summary - App identity, data model stats, configuration (layout, toolkit, features)',
+                ],
+            },
+            {
+                title: 'Navigation:',
+                items: [
+                    '↑/↓ - Navigate items',
+                    'Enter - View entity detail (full field table + relationship map)',
+                    'Tab or 1-3 - Switch tabs',
+                    '/ - Search',
+                    'q/Esc - Close',
+                ],
+            },
+            {
+                items: [
+                    'The Application Model is created by /design and used by /scaffold to generate code.',
+                    'The agent can also modify the model via app_model_update tool.',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Image Support
+    // ===========================================================================
+    {
+        id: 'image-support',
+        title: 'Image Support',
+        keywords: ['image', 'screenshot', 'picture', 'paste', 'attach', 'vision', 'view_image'],
+        sections: [
+            {
+                items: ['You can send images to the agent for visual analysis (screenshots, diagrams, mockups).'],
+            },
+            {
+                title: 'Supported formats:',
+                items: [
+                    'PNG, JPEG, GIF, WebP',
+                ],
+            },
+            {
+                title: 'How it works:',
+                items: [
+                    'Images are resized to max 1568px to save tokens',
+                    'After a few turns, old images are replaced with text placeholders',
+                    'The agent can also view image files on disk via the view_image tool',
+                    'All major providers support vision: Claude, GPT-4o, Gemini',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Context Management (Compressors, Observation Masking)
+    // ===========================================================================
+    {
+        id: 'context-management',
+        title: 'Context Management',
+        keywords: ['context', 'tokens', 'compressor', 'observation', 'masking', 'token saving'],
+        sections: [
+            {
+                items: ['The agent automatically manages its context window to stay within limits.'],
+            },
+            {
+                title: 'Automatic optimizations:',
+                items: [
+                    'Observation masking - Old tool results replaced with compact summaries after a few turns',
+                    'Image masking - Old images replaced with text placeholders (saves 1000+ tokens per image)',
+                    'Tool output compression - Large outputs compressed 60-90% (git, npm, file listings)',
+                    'Smart windowing - Oldest messages compacted when context fills up',
+                    'Dead message pruning - Removed permission exchanges and superseded errors',
+                ],
+            },
+            {
+                title: 'Manual controls:',
+                items: [
+                    '/context - View current token usage and breakdown',
+                    '/compact - Force summarization of old messages',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Knowledge Base
+    // ===========================================================================
+    {
+        id: 'knowledge-base',
+        title: 'Knowledge Base',
+        keywords: ['knowledge', 'kb', 'reference', 'documents', 'pin'],
+        sections: [
+            {
+                items: ['The knowledge base stores reference documents and images for your project.'],
+            },
+            {
+                title: 'Adding content:',
+                items: [
+                    'Files are added via the project_document_add tool or the desktop KB panel',
+                    'Supported: markdown, text, PDF, code files, images (PNG/JPEG/GIF/WebP)',
+                    'URLs can be imported (web page content fetched and stored)',
+                ],
+            },
+            {
+                title: 'Pinning:',
+                items: [
+                    'Pinned files are included in every agent conversation',
+                    'Unpinned files are available on-demand (agent reads them when needed)',
+                    'Pin important reference docs to keep the agent informed',
+                ],
+            },
+        ],
+    },
+    // ===========================================================================
+    // Capability Packs
+    // ===========================================================================
+    {
+        id: 'capability-packs',
+        title: 'Capability Packs',
+        keywords: ['capability', 'pack', 'tools', 'auto-load', 'dynamic', 'loading'],
+        sections: [
+            {
+                items: ['Tools are organized into capability packs that load on demand.'],
+            },
+            {
+                title: 'How it works:',
+                items: [
+                    'Only essential tools are loaded upfront (file read, shell, interaction)',
+                    'Additional packs load automatically when the agent needs them',
+                    'Reduces token cost by ~60% compared to loading all tools at once',
+                ],
+            },
+            {
+                title: 'Tool profiles control which packs are available:',
+                items: [
+                    'full - All packs (default for primary agent)',
+                    'developer - Coding-focused packs',
+                    'read-only - Safe exploration only',
+                    'planner - Planning and documentation packs',
+                    'analyst - Analysis and research packs',
+                    'docs - Documentation packs',
+                ],
+            },
+        ],
+    },
 ];
 // =============================================================================
 // Helper Functions