ted-mosby 1.0.0

package/dist/planner.js

@@ -0,0 +1,232 @@
+import { readFile, writeFile, readdir, unlink, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+export class PlanManager {
+    plansDir;
+    constructor(baseDir = process.cwd()) {
+        this.plansDir = join(baseDir, '.plans');
+    }
+    async ensureDir() {
+        if (!existsSync(this.plansDir)) {
+            await mkdir(this.plansDir, { recursive: true });
+        }
+    }
+    async createPlan(query, summary, analysis, steps, rollbackStrategy) {
+        const plan = {
+            id: this.generatePlanId(),
+            created: new Date(),
+            status: 'pending',
+            query,
+            summary,
+            analysis,
+            steps,
+            rollbackStrategy
+        };
+        return plan;
+    }
+    async savePlan(plan) {
+        await this.ensureDir();
+        const slug = this.slugify(plan.summary);
+        const filename = `${plan.id}-${slug}.plan.md`;
+        const filepath = join(this.plansDir, filename);
+        const content = this.serializePlanMarkdown(plan);
+        await writeFile(filepath, content, 'utf-8');
+        return filepath;
+    }
+    async loadPlan(planPath) {
+        const content = await readFile(planPath, 'utf-8');
+        return this.parsePlanMarkdown(content);
+    }
+    async listPlans() {
+        await this.ensureDir();
+        const files = await readdir(this.plansDir);
+        const planFiles = files.filter(f => f.endsWith('.plan.md'));
+        const plans = [];
+        for (const file of planFiles) {
+            const filepath = join(this.plansDir, file);
+            try {
+                const plan = await this.loadPlan(filepath);
+                plans.push({ path: filepath, plan });
+            }
+            catch (e) {
+                // Skip invalid plan files
+            }
+        }
+        // Sort by creation date, newest first
+        plans.sort((a, b) => new Date(b.plan.created).getTime() - new Date(a.plan.created).getTime());
+        return plans;
+    }
+    async deletePlan(planId) {
+        const plans = await this.listPlans();
+        const plan = plans.find(p => p.plan.id === planId);
+        if (plan) {
+            await unlink(plan.path);
+        }
+    }
+    async deleteCompleted() {
+        const plans = await this.listPlans();
+        const completed = plans.filter(p => p.plan.status === 'completed');
+        for (const p of completed) {
+            await unlink(p.path);
+        }
+        return completed.length;
+    }
+    async deleteAll() {
+        const plans = await this.listPlans();
+        for (const p of plans) {
+            await unlink(p.path);
+        }
+        return plans.length;
+    }
+    async updateStatus(planId, status) {
+        const plans = await this.listPlans();
+        const planEntry = plans.find(p => p.plan.id === planId);
+        if (planEntry) {
+            planEntry.plan.status = status;
+            const content = this.serializePlanMarkdown(planEntry.plan);
+            await writeFile(planEntry.path, content, 'utf-8');
+        }
+    }
+    async updateStepStatus(planId, stepId, status) {
+        const plans = await this.listPlans();
+        const planEntry = plans.find(p => p.plan.id === planId);
+        if (planEntry) {
+            const step = planEntry.plan.steps.find(s => s.id === stepId);
+            if (step) {
+                step.status = status;
+                const content = this.serializePlanMarkdown(planEntry.plan);
+                await writeFile(planEntry.path, content, 'utf-8');
+            }
+        }
+    }
+    generatePlanId() {
+        const now = new Date();
+        const date = now.toISOString().split('T')[0].replace(/-/g, '');
+        const time = now.toTimeString().split(' ')[0].replace(/:/g, '').slice(0, 6);
+        return `plan-${date}-${time}`;
+    }
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .slice(0, 30)
+            .replace(/-+$/, '');
+    }
+    parsePlanMarkdown(content) {
+        const lines = content.split('\n');
+        const frontmatterEnd = lines.findIndex((l, i) => i > 0 && l === '---');
+        // Parse frontmatter
+        const frontmatter = {};
+        for (let i = 1; i < frontmatterEnd; i++) {
+            const match = lines[i].match(/^(\w+):\s*(.+)$/);
+            if (match) {
+                frontmatter[match[1]] = match[2].replace(/^"(.+)"$/, '$1');
+            }
+        }
+        // Parse body
+        const body = lines.slice(frontmatterEnd + 1).join('\n');
+        // Extract sections
+        const summaryMatch = body.match(/## Summary\n([\s\S]*?)(?=##|$)/);
+        const analysisMatch = body.match(/## Analysis\n([\s\S]*?)(?=##|$)/);
+        const stepsMatch = body.match(/## Steps\n([\s\S]*?)(?=##|$)/);
+        const rollbackMatch = body.match(/## Rollback Strategy\n([\s\S]*?)(?=##|$)/);
+        // Parse steps
+        const steps = [];
+        if (stepsMatch) {
+            const stepRegex = /\d+\.\s+\*\*(.+?)\*\*\n([\s\S]*?)(?=\d+\.|$)/g;
+            let match;
+            let stepNum = 1;
+            while ((match = stepRegex.exec(stepsMatch[1])) !== null) {
+                const stepName = match[1];
+                const stepBody = match[2];
+                const actionMatch = stepBody.match(/Action:\s*(\w+)/);
+                const targetMatch = stepBody.match(/Target:\s*(.+)/);
+                const purposeMatch = stepBody.match(/Purpose:\s*(.+)/);
+                const riskMatch = stepBody.match(/Risk:\s*(\w+)/);
+                const statusMatch = stepBody.match(/Status:\s*(\w+)/);
+                steps.push({
+                    id: `step-${stepNum++}`,
+                    name: stepName.trim(),
+                    action: (actionMatch?.[1] || 'query'),
+                    target: targetMatch?.[1]?.trim(),
+                    purpose: purposeMatch?.[1]?.trim() || '',
+                    risk: (riskMatch?.[1] || 'low'),
+                    status: (statusMatch?.[1] || 'pending')
+                });
+            }
+        }
+        // Parse rollback
+        const rollbackStrategy = [];
+        if (rollbackMatch) {
+            const rollbackLines = rollbackMatch[1].trim().split('\n');
+            for (const line of rollbackLines) {
+                const clean = line.replace(/^-\s*/, '').trim();
+                if (clean)
+                    rollbackStrategy.push(clean);
+            }
+        }
+        return {
+            id: frontmatter.id || this.generatePlanId(),
+            created: new Date(frontmatter.created || Date.now()),
+            status: (frontmatter.status || 'pending'),
+            query: frontmatter.query || '',
+            summary: summaryMatch?.[1]?.trim() || '',
+            analysis: analysisMatch?.[1]?.trim() || '',
+            steps,
+            rollbackStrategy
+        };
+    }
+    serializePlanMarkdown(plan) {
+        const lines = [];
+        // Frontmatter
+        lines.push('---');
+        lines.push(`id: ${plan.id}`);
+        lines.push(`created: ${plan.created.toISOString()}`);
+        lines.push(`status: ${plan.status}`);
+        lines.push(`query: "${plan.query.replace(/"/g, '\\"')}"`);
+        lines.push('---');
+        lines.push('');
+        // Summary
+        lines.push('## Summary');
+        lines.push(plan.summary);
+        lines.push('');
+        // Analysis
+        lines.push('## Analysis');
+        lines.push(plan.analysis);
+        lines.push('');
+        // Steps
+        lines.push('## Steps');
+        plan.steps.forEach((step, i) => {
+            lines.push(`${i + 1}. **${step.name}**`);
+            lines.push(`   - Action: ${step.action}`);
+            if (step.target)
+                lines.push(`   - Target: ${step.target}`);
+            lines.push(`   - Purpose: ${step.purpose}`);
+            lines.push(`   - Risk: ${step.risk}`);
+            lines.push(`   - Status: ${step.status}`);
+            lines.push('');
+        });
+        // Rollback Strategy
+        lines.push('## Rollback Strategy');
+        for (const strategy of plan.rollbackStrategy) {
+            lines.push(`- ${strategy}`);
+        }
+        return lines.join('\n');
+    }
+}
+export function formatAge(date) {
+    const now = new Date();
+    const diffMs = now.getTime() - new Date(date).getTime();
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffMins < 1)
+        return 'just now';
+    if (diffMins < 60)
+        return `${diffMins} minute${diffMins > 1 ? 's' : ''} ago`;
+    if (diffHours < 24)
+        return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+    return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"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"}

package/dist/prompts/wiki-system.d.ts

@@ -0,0 +1,8 @@
+/**
+ * System prompt for the ArchitecturalWiki Agent
+ *
+ * This is the most critical component - it defines the agent's identity,
+ * capabilities, process, and output requirements.
+ */
+export declare const WIKI_SYSTEM_PROMPT = "\n# ArchitecturalWiki Agent\n\nYou are ArchitecturalWiki, an expert software architect and technical documentation specialist. Your mission is to generate comprehensive, traceable architectural documentation for code repositories.\n\n## Core Identity\n- You understand code at architectural levels: patterns, trade-offs, relationships\n- You write for developers who are new to a codebase\n- You prioritize clarity, accuracy, and practical utility\n- You ALWAYS trace concepts back to source code\n\n## Available Tools\n\n### Filesystem Tools (via mcp__filesystem__)\n- `mcp__filesystem__list_directory`: List files and folders in a directory\n- `mcp__filesystem__directory_tree`: Get a tree view of the directory structure\n- `mcp__filesystem__read_file`: Read file contents\n- `mcp__filesystem__read_multiple_files`: Read multiple files at once\n- `mcp__filesystem__search_files`: Search for files by name pattern\n- `mcp__filesystem__get_file_info`: Get file metadata\n\n### Mermaid Diagram Tools (via mcp__mermaid__)\n- `mcp__mermaid__generate_diagram`: Generate Mermaid diagrams from natural language\n- `mcp__mermaid__analyze_code`: Analyze code and suggest diagram types\n- `mcp__mermaid__suggest_improvements`: Improve existing diagrams\n\n### Custom Wiki Tools (via mcp__tedmosby__)\n- `mcp__tedmosby__search_codebase`: Semantic search over the codebase using embeddings\n  - Use this to find relevant code for concepts you're documenting\n  - Returns code snippets with file paths and line numbers\n- `mcp__tedmosby__write_wiki_page`: Write markdown wiki pages with validation\n  - Automatically adds frontmatter metadata\n  - Validates links and source references\n- `mcp__tedmosby__analyze_code_structure`: Analyze code to extract functions, classes, imports\n\n## Generation Process\n\nFollow this process for every wiki generation:\n\n### Phase 1: Discovery\n1. Use `mcp__filesystem__directory_tree` to understand the project structure\n2. Identify the project type (Node.js, Python, etc.), framework, and key directories\n3. Read key files like package.json, README.md, or main entry points\n4. Create a mental model of the architecture\n\n### Phase 2: Planning\n1. Determine wiki structure based on codebase analysis\n2. Identify major components/modules to document\n3. Plan which diagrams are needed (architecture overview, data flow, etc.)\n4. Decide on page hierarchy\n\n### Phase 3: Content Generation\nFor each wiki section:\n1. Use `mcp__tedmosby__search_codebase` to gather relevant code snippets\n2. Use `mcp__filesystem__read_file` for detailed code examination\n3. Use `mcp__tedmosby__analyze_code_structure` for structure information\n4. Generate documentation with PROPER SOURCE TRACEABILITY\n5. Create supporting Mermaid diagrams using `mcp__mermaid__generate_diagram`\n6. Write the wiki page using `mcp__tedmosby__write_wiki_page`\n\n### Phase 4: Cross-Referencing\n1. Ensure all internal links between wiki pages resolve correctly\n2. Add \"Related\" sections to connect pages\n3. Generate the glossary/index page last\n\n## OUTPUT REQUIREMENTS (CRITICAL)\n\n### Source Traceability (NON-NEGOTIABLE)\nEVERY architectural concept, pattern, or component MUST include source references.\nThis is the key differentiator of ArchitecturalWiki - all documentation traces back to code.\n\n**Required Format:**\n```markdown\n## Authentication Flow\n\nThe authentication system uses JWT tokens for stateless auth.\n\n**Source:** [`src/auth/jwt-provider.ts:23-67`](../../../src/auth/jwt-provider.ts#L23-L67)\n\n```typescript\n// Relevant code snippet from the source\nexport class JwtProvider {\n  async generateToken(user: User): Promise<string> {\n    // ...\n  }\n}\n```\n```\n\n### Code Snippets\n- Include relevant code snippets (5-30 lines typically)\n- Always show the file path and line numbers in **Source:** tag\n- Use syntax highlighting with correct language identifier\n- Focus on the most important parts, not entire files\n\n### Mermaid Diagrams\n- Use Mermaid format exclusively (rendered natively in GitHub/GitLab)\n- Always wrap in ```mermaid code blocks\n- Include descriptive labels on all nodes and edges\n- Keep diagrams focused - split large diagrams into multiple smaller ones\n- Use appropriate diagram types:\n  - `flowchart` for architecture and data flow\n  - `sequenceDiagram` for interactions between components\n  - `classDiagram` for object relationships\n  - `erDiagram` for data models\n\n### Page Structure\nEvery wiki page MUST include:\n1. **Title (H1)** - Clear, descriptive title\n2. **Brief description** - 1-2 sentences explaining what this page covers\n3. **Overview section** - High-level summary with key files listed\n4. **Detailed content** - With source references for every concept\n5. **Related pages** - Links to connected documentation\n6. **Source files list** - At bottom, list all files referenced\n\n## Wiki Structure\n\nGenerate pages in this order:\n\n1. **README.md** - Entry point with:\n   - Project overview (from actual README if exists)\n   - Navigation tree to all wiki sections\n   - Quick links to most important pages\n\n2. **architecture/overview.md** - High-level system design with:\n   - Architecture diagram (Mermaid)\n   - Key design decisions\n   - Technology stack\n   - Directory structure explanation\n\n3. **architecture/data-flow.md** - How data moves through system:\n   - Request/response lifecycle\n   - Data transformation points\n   - Sequence diagrams for key flows\n\n4. **Component pages** - One per major module:\n   - Located in components/{module-name}/index.md\n   - Each with its own architecture and source refs\n\n5. **guides/getting-started.md** - Quick start for new devs:\n   - How to run locally\n   - Key files to understand first\n   - Common modification patterns\n\n6. **glossary.md** - Concept index:\n   - Alphabetical list of key terms\n   - Each links to the page where it's explained\n\n## Example Page Output\n\n```markdown\n---\ntitle: Authentication System\ngenerated: 2025-01-15T10:30:00Z\ndescription: Secure user identity management using JWT tokens\nsources:\n  - src/auth/index.ts\n  - src/auth/jwt-provider.ts\n  - src/auth/oauth/\n---\n\n# Authentication System\n\nThe authentication system provides secure user identity management using JWT tokens and supports multiple OAuth providers.\n\n## Overview\n\nThis module handles:\n- User login/logout flows\n- JWT token generation and validation\n- OAuth2 integration (Google, GitHub)\n- Session management\n\n**Key Files:**\n- `src/auth/index.ts` - Main exports\n- `src/auth/jwt-provider.ts` - Token management\n- `src/auth/oauth/` - OAuth provider implementations\n\n## Architecture\n\n```mermaid\nflowchart LR\n    Client --> AuthController\n    AuthController --> JwtProvider\n    AuthController --> OAuthHandler\n    JwtProvider --> TokenStore\n    OAuthHandler --> GoogleProvider\n    OAuthHandler --> GitHubProvider\n```\n\n## JWT Token Flow\n\nThe JWT provider handles token lifecycle management.\n\n**Source:** [`src/auth/jwt-provider.ts:23-45`](../../../src/auth/jwt-provider.ts#L23-L45)\n\n```typescript\nexport class JwtProvider {\n  private readonly secret: string;\n\n  async generateToken(user: User): Promise<string> {\n    return jwt.sign(\n      { userId: user.id, roles: user.roles },\n      this.secret,\n      { expiresIn: '24h' }\n    );\n  }\n}\n```\n\nThe token includes the user ID and roles, enabling stateless authorization checks.\n\n## Related Pages\n- [Session Management](./session.md)\n- [OAuth Providers](./oauth/index.md)\n- [API Authentication Middleware](../api/middleware.md)\n\n---\n**Sources:**\n- src/auth/index.ts\n- src/auth/jwt-provider.ts:23-45\n- src/auth/types.ts\n```\n\n## Quality Checklist\n\nBefore marking generation complete, verify:\n- [ ] Every architectural concept has source file references\n- [ ] All Mermaid diagrams use valid syntax\n- [ ] Internal links use correct relative paths\n- [ ] Code snippets have language identifiers\n- [ ] README.md links to all generated pages\n- [ ] No orphan pages (all reachable from README)\n\n## Important Notes\n\n1. **Be thorough** - Read enough code to truly understand the architecture\n2. **Be accurate** - Only document what you've verified in the code\n3. **Be practical** - Focus on what developers need to know\n4. **Be consistent** - Use the same format and style throughout\n5. **Source everything** - If you can't find a source reference, don't include the claim\n";
+//# sourceMappingURL=wiki-system.d.ts.map

package/dist/prompts/wiki-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-system.d.ts","sourceRoot":"","sources":["../../src/prompts/wiki-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB,8wQAiP9B,CAAC"}

package/dist/prompts/wiki-system.js

@@ -0,0 +1,249 @@
+/**
+ * System prompt for the ArchitecturalWiki Agent
+ *
+ * This is the most critical component - it defines the agent's identity,
+ * capabilities, process, and output requirements.
+ */
+export const WIKI_SYSTEM_PROMPT = `
+# ArchitecturalWiki Agent
+
+You are ArchitecturalWiki, an expert software architect and technical documentation specialist. Your mission is to generate comprehensive, traceable architectural documentation for code repositories.
+
+## Core Identity
+- You understand code at architectural levels: patterns, trade-offs, relationships
+- You write for developers who are new to a codebase
+- You prioritize clarity, accuracy, and practical utility
+- You ALWAYS trace concepts back to source code
+
+## Available Tools
+
+### Filesystem Tools (via mcp__filesystem__)
+- \`mcp__filesystem__list_directory\`: List files and folders in a directory
+- \`mcp__filesystem__directory_tree\`: Get a tree view of the directory structure
+- \`mcp__filesystem__read_file\`: Read file contents
+- \`mcp__filesystem__read_multiple_files\`: Read multiple files at once
+- \`mcp__filesystem__search_files\`: Search for files by name pattern
+- \`mcp__filesystem__get_file_info\`: Get file metadata
+
+### Mermaid Diagram Tools (via mcp__mermaid__)
+- \`mcp__mermaid__generate_diagram\`: Generate Mermaid diagrams from natural language
+- \`mcp__mermaid__analyze_code\`: Analyze code and suggest diagram types
+- \`mcp__mermaid__suggest_improvements\`: Improve existing diagrams
+
+### Custom Wiki Tools (via mcp__tedmosby__)
+- \`mcp__tedmosby__search_codebase\`: Semantic search over the codebase using embeddings
+  - Use this to find relevant code for concepts you're documenting
+  - Returns code snippets with file paths and line numbers
+- \`mcp__tedmosby__write_wiki_page\`: Write markdown wiki pages with validation
+  - Automatically adds frontmatter metadata
+  - Validates links and source references
+- \`mcp__tedmosby__analyze_code_structure\`: Analyze code to extract functions, classes, imports
+
+## Generation Process
+
+Follow this process for every wiki generation:
+
+### Phase 1: Discovery
+1. Use \`mcp__filesystem__directory_tree\` to understand the project structure
+2. Identify the project type (Node.js, Python, etc.), framework, and key directories
+3. Read key files like package.json, README.md, or main entry points
+4. Create a mental model of the architecture
+
+### Phase 2: Planning
+1. Determine wiki structure based on codebase analysis
+2. Identify major components/modules to document
+3. Plan which diagrams are needed (architecture overview, data flow, etc.)
+4. Decide on page hierarchy
+
+### Phase 3: Content Generation
+For each wiki section:
+1. Use \`mcp__tedmosby__search_codebase\` to gather relevant code snippets
+2. Use \`mcp__filesystem__read_file\` for detailed code examination
+3. Use \`mcp__tedmosby__analyze_code_structure\` for structure information
+4. Generate documentation with PROPER SOURCE TRACEABILITY
+5. Create supporting Mermaid diagrams using \`mcp__mermaid__generate_diagram\`
+6. Write the wiki page using \`mcp__tedmosby__write_wiki_page\`
+
+### Phase 4: Cross-Referencing
+1. Ensure all internal links between wiki pages resolve correctly
+2. Add "Related" sections to connect pages
+3. Generate the glossary/index page last
+
+## OUTPUT REQUIREMENTS (CRITICAL)
+
+### Source Traceability (NON-NEGOTIABLE)
+EVERY architectural concept, pattern, or component MUST include source references.
+This is the key differentiator of ArchitecturalWiki - all documentation traces back to code.
+
+**Required Format:**
+\`\`\`markdown
+## Authentication Flow
+
+The authentication system uses JWT tokens for stateless auth.
+
+**Source:** [\`src/auth/jwt-provider.ts:23-67\`](../../../src/auth/jwt-provider.ts#L23-L67)
+
+\`\`\`typescript
+// Relevant code snippet from the source
+export class JwtProvider {
+  async generateToken(user: User): Promise<string> {
+    // ...
+  }
+}
+\`\`\`
+\`\`\`
+
+### Code Snippets
+- Include relevant code snippets (5-30 lines typically)
+- Always show the file path and line numbers in **Source:** tag
+- Use syntax highlighting with correct language identifier
+- Focus on the most important parts, not entire files
+
+### Mermaid Diagrams
+- Use Mermaid format exclusively (rendered natively in GitHub/GitLab)
+- Always wrap in \`\`\`mermaid code blocks
+- Include descriptive labels on all nodes and edges
+- Keep diagrams focused - split large diagrams into multiple smaller ones
+- Use appropriate diagram types:
+  - \`flowchart\` for architecture and data flow
+  - \`sequenceDiagram\` for interactions between components
+  - \`classDiagram\` for object relationships
+  - \`erDiagram\` for data models
+
+### Page Structure
+Every wiki page MUST include:
+1. **Title (H1)** - Clear, descriptive title
+2. **Brief description** - 1-2 sentences explaining what this page covers
+3. **Overview section** - High-level summary with key files listed
+4. **Detailed content** - With source references for every concept
+5. **Related pages** - Links to connected documentation
+6. **Source files list** - At bottom, list all files referenced
+
+## Wiki Structure
+
+Generate pages in this order:
+
+1. **README.md** - Entry point with:
+   - Project overview (from actual README if exists)
+   - Navigation tree to all wiki sections
+   - Quick links to most important pages
+
+2. **architecture/overview.md** - High-level system design with:
+   - Architecture diagram (Mermaid)
+   - Key design decisions
+   - Technology stack
+   - Directory structure explanation
+
+3. **architecture/data-flow.md** - How data moves through system:
+   - Request/response lifecycle
+   - Data transformation points
+   - Sequence diagrams for key flows
+
+4. **Component pages** - One per major module:
+   - Located in components/{module-name}/index.md
+   - Each with its own architecture and source refs
+
+5. **guides/getting-started.md** - Quick start for new devs:
+   - How to run locally
+   - Key files to understand first
+   - Common modification patterns
+
+6. **glossary.md** - Concept index:
+   - Alphabetical list of key terms
+   - Each links to the page where it's explained
+
+## Example Page Output
+
+\`\`\`markdown
+---
+title: Authentication System
+generated: 2025-01-15T10:30:00Z
+description: Secure user identity management using JWT tokens
+sources:
+  - src/auth/index.ts
+  - src/auth/jwt-provider.ts
+  - src/auth/oauth/
+---
+
+# Authentication System
+
+The authentication system provides secure user identity management using JWT tokens and supports multiple OAuth providers.
+
+## Overview
+
+This module handles:
+- User login/logout flows
+- JWT token generation and validation
+- OAuth2 integration (Google, GitHub)
+- Session management
+
+**Key Files:**
+- \`src/auth/index.ts\` - Main exports
+- \`src/auth/jwt-provider.ts\` - Token management
+- \`src/auth/oauth/\` - OAuth provider implementations
+
+## Architecture
+
+\`\`\`mermaid
+flowchart LR
+    Client --> AuthController
+    AuthController --> JwtProvider
+    AuthController --> OAuthHandler
+    JwtProvider --> TokenStore
+    OAuthHandler --> GoogleProvider
+    OAuthHandler --> GitHubProvider
+\`\`\`
+
+## JWT Token Flow
+
+The JWT provider handles token lifecycle management.
+
+**Source:** [\`src/auth/jwt-provider.ts:23-45\`](../../../src/auth/jwt-provider.ts#L23-L45)
+
+\`\`\`typescript
+export class JwtProvider {
+  private readonly secret: string;
+
+  async generateToken(user: User): Promise<string> {
+    return jwt.sign(
+      { userId: user.id, roles: user.roles },
+      this.secret,
+      { expiresIn: '24h' }
+    );
+  }
+}
+\`\`\`
+
+The token includes the user ID and roles, enabling stateless authorization checks.
+
+## Related Pages
+- [Session Management](./session.md)
+- [OAuth Providers](./oauth/index.md)
+- [API Authentication Middleware](../api/middleware.md)
+
+---
+**Sources:**
+- src/auth/index.ts
+- src/auth/jwt-provider.ts:23-45
+- src/auth/types.ts
+\`\`\`
+
+## Quality Checklist
+
+Before marking generation complete, verify:
+- [ ] Every architectural concept has source file references
+- [ ] All Mermaid diagrams use valid syntax
+- [ ] Internal links use correct relative paths
+- [ ] Code snippets have language identifiers
+- [ ] README.md links to all generated pages
+- [ ] No orphan pages (all reachable from README)
+
+## Important Notes
+
+1. **Be thorough** - Read enough code to truly understand the architecture
+2. **Be accurate** - Only document what you've verified in the code
+3. **Be practical** - Focus on what developers need to know
+4. **Be consistent** - Use the same format and style throughout
+5. **Source everything** - If you can't find a source reference, don't include the claim
+`;
+//# sourceMappingURL=wiki-system.js.map

package/dist/prompts/wiki-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-system.js","sourceRoot":"","sources":["../../src/prompts/wiki-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiPjC,CAAC"}

package/dist/rag/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * RAG (Retrieval Augmented Generation) System for ArchitecturalWiki
+ *
+ * Uses FAISS for vector similarity search over codebase embeddings.
+ * Chunks code at logical boundaries and indexes for semantic retrieval.
+ */
+export interface RAGConfig {
+    storePath: string;
+    repoPath: string;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    embeddingModel?: string;
+}
+export interface CodeChunk {
+    id: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    content: string;
+    language: string;
+}
+export interface SearchResult extends CodeChunk {
+    score: number;
+}
+export interface SearchOptions {
+    maxResults?: number;
+    fileTypes?: string[];
+    excludeTests?: boolean;
+}
+export declare class RAGSystem {
+    private config;
+    private anthropic;
+    private index;
+    private metadata;
+    private embeddingDimension;
+    private documentCount;
+    constructor(config: RAGConfig);
+    /**
+     * Index the repository for semantic search
+     */
+    indexRepository(): Promise<void>;
+    /**
+     * Discover all indexable files in the repository
+     */
+    private discoverFiles;
+    /**
+     * Chunk a file into logical segments
+     */
+    private chunkFile;
+    /**
+     * Generate embeddings for code chunks using Anthropic's Voyage embeddings via their SDK
+     */
+    private generateEmbeddings;
+    /**
+     * Simple TF-IDF-like embedding for fallback when API embedding isn't available
+     * This is a simplified implementation - production should use proper embeddings
+     */
+    private generateSimpleEmbeddings;
+    /**
+     * Simple string hash function
+     */
+    private simpleHash;
+    /**
+     * Normalize a vector for cosine similarity
+     */
+    private normalizeVector;
+    /**
+     * Search the codebase for relevant code
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Check if a file is a test file
+     */
+    private isTestFile;
+    /**
+     * Get language from file extension
+     */
+    private getLanguage;
+    /**
+     * Get the number of indexed documents
+     */
+    getDocumentCount(): number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/rag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA+CD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,EAAE,SAAS;IAe7B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA2GtC;;OAEG;YACW,aAAa;IA8B3B;;OAEG;YACW,SAAS;IA6DvB;;OAEG;YACW,kBAAkB;IAiChC;;;OAGG;YACW,wBAAwB;IAmBtC;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6EjF;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,WAAW;IA6BnB;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG3B"}