@getvibeguard/cli 1.0.0

package/dist/librarian/oracle.js

@@ -0,0 +1,235 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { generateSummary } from '../utils/llm.js';
+export class OracleService {
+    repoPath;
+    statePath;
+    constructor(repoPath = process.cwd()) {
+        this.repoPath = repoPath;
+        this.statePath = path.join(repoPath, '.vibeguard', 'oracle.json');
+    }
+    /**
+     * Load oracle state from file
+     */
+    async loadState() {
+        try {
+            const content = await fs.readFile(this.statePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            // State file doesn't exist - return default
+            return {
+                prophecies: [],
+                lastSeekTime: null,
+            };
+        }
+    }
+    /**
+     * Save oracle state to file
+     */
+    async saveState(state) {
+        // Ensure .vibeguard directory exists
+        const stateDir = path.dirname(this.statePath);
+        await fs.mkdir(stateDir, { recursive: true });
+        await fs.writeFile(this.statePath, JSON.stringify(state, null, 2), 'utf-8');
+    }
+    /**
+     * Scan the project directory and return file tree structure
+     */
+    async scanProjectTree() {
+        const files = [];
+        const repoPath = this.repoPath;
+        async function walkDir(dir, prefix = '', depth = 0) {
+            if (depth > 15)
+                return; // Limit depth to prevent excessive scanning
+            try {
+                const entries = await fs.readdir(dir, { withFileTypes: true });
+                const filtered = entries.filter(entry => {
+                    const name = entry.name;
+                    // Filter out common ignore patterns
+                    return (!name.startsWith('.') ||
+                        name === '.git' ||
+                        name === '.env' ||
+                        name === '.cursor') &&
+                        name !== 'node_modules' &&
+                        name !== 'dist' &&
+                        name !== 'build' &&
+                        name !== '.vibeguard'; // Don't scan oracle state itself
+                });
+                for (let i = 0; i < filtered.length; i++) {
+                    const entry = filtered[i];
+                    const isLast = i === filtered.length - 1;
+                    const currentPrefix = isLast ? '└── ' : '├── ';
+                    const nextPrefix = isLast ? '    ' : '│   ';
+                    files.push(prefix + currentPrefix + entry.name + (entry.isDirectory() ? '/' : ''));
+                    if (entry.isDirectory() && entry.name !== '.git' && entry.name !== 'node_modules') {
+                        const fullPath = path.join(dir, entry.name);
+                        await walkDir(fullPath, prefix + nextPrefix, depth + 1);
+                    }
+                }
+            }
+            catch (error) {
+                // Ignore permission errors or inaccessible directories
+            }
+        }
+        try {
+            await walkDir(repoPath);
+        }
+        catch (error) {
+            throw new Error(`Failed to scan project tree: ${error}`);
+        }
+        return files.join('\n');
+    }
+    /**
+     * Read PROJECT_MEMORY.md
+     */
+    async readProjectMemory() {
+        const memoryPath = path.join(this.repoPath, 'PROJECT_MEMORY.md');
+        try {
+            return await fs.readFile(memoryPath, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to read PROJECT_MEMORY.md: ${error}`);
+        }
+    }
+    /**
+     * Read DIAGRAM.md
+     */
+    async readDiagram() {
+        const diagramPath = path.join(this.repoPath, 'DIAGRAM.md');
+        try {
+            return await fs.readFile(diagramPath, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to read DIAGRAM.md: ${error}`);
+        }
+    }
+    /**
+     * Seek prophecy - Compare Project Soul/Rules with actual file structure
+     */
+    async seekProphecy() {
+        console.log('[Oracle] Seeking prophecy...');
+        try {
+            // Gather context
+            const [projectMemory, diagram, fileTree] = await Promise.all([
+                this.readProjectMemory(),
+                this.readDiagram(),
+                this.scanProjectTree(),
+            ]);
+            // Build the reasoning prompt
+            const systemPrompt = `You are an architectural oracle analyzing a codebase for "Architectural Drift" - places where the code has diverged from the intended architecture and rules defined in PROJECT_MEMORY.md.
+
+Your task is to identify 3 specific areas where the code is 'drifting' from the intended architecture. Look for:
+- Violated Core Rules (e.g., using barrel imports when forbidden, not following atomic updates, etc.)
+- Undocumented Tech Stack additions (new libraries/dependencies not mentioned in Tech Stack)
+- Structural deviations from DIAGRAM.md (new components/services not reflected in architecture)
+- Anti-patterns that contradict the Project Soul
+
+Output your findings as a JSON array with exactly 3 objects. Each object must have:
+- id: A unique identifier (e.g., "prophecy-001")
+- type: One of "Refactor", "RuleViolation", or "Optimization"
+- title: A concise title (max 60 characters)
+- description: Detailed description of the drift (2-4 sentences)
+- suggestedAction: Specific, actionable recommendation (1-2 sentences)
+- priority: "High", "Medium", or "Low" based on severity
+
+Format your response as a valid JSON array only. No markdown, no code blocks, just the JSON array.`;
+            const userPrompt = `PROJECT_MEMORY.md:
+${projectMemory}
+
+DIAGRAM.md:
+${diagram}
+
+Current File Tree:
+${fileTree}
+
+Analyze the above and identify 3 specific areas of architectural drift. Return a JSON array of prophecies.`;
+            // Use Gemini 3 Pro for architectural reasoning
+            const response = await generateSummary(userPrompt, systemPrompt, {
+                thinkingLevel: 'pro',
+                maxTokens: 50000,
+                temperature: 0.5,
+                feature: 'Oracle',
+            });
+            // Parse the JSON response
+            let prophecies = [];
+            try {
+                // Try to extract JSON from markdown code blocks if present
+                let jsonText = response.trim();
+                const jsonMatch = jsonText.match(/```(?:json)?\s*([\s\S]*?)\s*```/);
+                if (jsonMatch) {
+                    jsonText = jsonMatch[1];
+                }
+                // Parse the JSON array
+                const parsed = JSON.parse(jsonText);
+                prophecies = Array.isArray(parsed) ? parsed : [parsed];
+                // Validate and add timestamps
+                prophecies = prophecies.map((p) => ({
+                    id: p.id || `prophecy-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                    type: p.type || 'Optimization',
+                    title: p.title || 'Untitled Prophecy',
+                    description: p.description || '',
+                    suggestedAction: p.suggestedAction || '',
+                    priority: p.priority || 'Medium',
+                    createdAt: p.createdAt || new Date().toISOString(),
+                })).slice(0, 3); // Ensure max 3 prophecies
+            }
+            catch (parseError) {
+                console.error('[Oracle] Failed to parse prophecy response:', parseError);
+                console.error('[Oracle] Response was:', response);
+                // Fallback: Create a single prophecy about parsing failure
+                prophecies = [{
+                        id: `prophecy-error-${Date.now()}`,
+                        type: 'Optimization',
+                        title: 'Oracle Response Parsing Failed',
+                        description: `The oracle response could not be parsed. This may indicate an issue with the LLM response format. Response preview: ${response.substring(0, 200)}...`,
+                        suggestedAction: 'Review the oracle.ts implementation and ensure proper JSON response handling.',
+                        priority: 'Low',
+                        createdAt: new Date().toISOString(),
+                    }];
+            }
+            // Load existing state and merge prophecies
+            const state = await this.loadState();
+            // Remove duplicates based on id
+            const existingIds = new Set(state.prophecies.map(p => p.id));
+            const newProphecies = prophecies.filter(p => !existingIds.has(p.id));
+            // Merge: keep existing + add new (limit to 20 total)
+            const allProphecies = [...state.prophecies, ...newProphecies].slice(-20);
+            // Update state
+            await this.saveState({
+                prophecies: allProphecies,
+                lastSeekTime: new Date().toISOString(),
+            });
+            console.log(`[Oracle] Generated ${newProphecies.length} new prophecies`);
+            return prophecies;
+        }
+        catch (error) {
+            console.error('[Oracle] Error seeking prophecy:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get all prophecies
+     */
+    async getProphecies() {
+        const state = await this.loadState();
+        return state.prophecies;
+    }
+    /**
+     * Get prophecies by priority
+     */
+    async getPropheciesByPriority(priority) {
+        const prophecies = await this.getProphecies();
+        return prophecies.filter(p => p.priority === priority);
+    }
+    /**
+     * Clear all prophecies
+     */
+    async clearProphecies() {
+        await this.saveState({
+            prophecies: [],
+            lastSeekTime: null,
+        });
+    }
+}
+//# sourceMappingURL=oracle.js.map

package/dist/librarian/oracle.js.map

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

package/dist/librarian/summarizer.d.ts

@@ -0,0 +1,19 @@
+export declare class Summarizer {
+    /**
+     * Build incremental update prompt (current memory + new diff)
+     */
+    buildIncrementalPrompt(currentMemory: string, cleanDiff: string): string;
+    /**
+     * Summarize a diff and return complete updated PROJECT_MEMORY.md
+     */
+    summarizeDiff(diff: string, currentMemory?: string, thinkingLevel?: 'flash' | 'pro'): Promise<string>;
+    /**
+     * Infer architecture from file structure and README
+     */
+    inferArchitecture(fileStructure: string, readme?: string, thinkingLevel?: 'flash' | 'pro'): Promise<string>;
+    /**
+     * Merge Git conflicts in PROJECT_MEMORY.md
+     */
+    mergeConflicts(conflictedMemory: string): Promise<string>;
+}
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/librarian/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/librarian/summarizer.ts"],"names":[],"mappings":"AAwCA,qBAAa,UAAU;IACrB;;OAEG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAWxE;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,MAAW,EAC1B,aAAa,GAAE,OAAO,GAAG,KAAe,GACvC,OAAO,CAAC,MAAM,CAAC;IAuElB;;OAEG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,GAAE,OAAO,GAAG,KAAe,GACvC,OAAO,CAAC,MAAM,CAAC;IAwBlB;;OAEG;IACG,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAoChE"}

package/dist/librarian/summarizer.js

@@ -0,0 +1,175 @@
+import { generateSummary, estimateTokens } from '../utils/llm.js';
+import { cleanDiff } from '../utils/diff-cleaner.js';
+import { chunkDiff } from '../utils/chunker.js';
+import { getMaxTokens } from '../utils/config.js';
+/**
+ * Get the Librarian system prompt with current date
+ */
+function getLibrarianSystemPrompt() {
+    const today = new Date().toLocaleDateString();
+    return `# ROLE
+You are "The Librarian," an expert Software Architect and Context Manager. Your sole purpose is to maintain the \`PROJECT_MEMORY.md\` file, ensuring it serves as a high-density "Single Source of Truth" for AI coding assistants.
+
+Today's Date: ${today}
+
+# OBJECTIVE
+Analyze the provided [INPUT] (Git diffs, file structures, or current memory) and update the \`PROJECT_MEMORY.md\` to reflect the current "State of the World."
+
+# THE MEMORY SCHEMA (Strict Adherence)
+You must maintain the following sections in \`PROJECT_MEMORY.md\`:
+1. ## Project Soul: A 2-sentence description of what this app is and who it's for.
+2. ## Tech Stack: A list of core libraries, frameworks, and versions.
+3. ## Architecture: High-level overview of how data flows (e.g., "Next.js App Router -> Supabase -> Stripe").
+4. ## Core Rules: Critical "Vibe" rules (e.g., "Always use Tailwind arbitrary values," "No barrel imports").
+5. ## Recent Decisions (The "Why"): Maintain the existing list of decisions. Append the latest changes to the top of the list. Do not delete older entries; the system's Auto-Pruning logic will handle compaction separately.
+6. ## Active Tech Debt: Known bugs or "next steps" that the AI should be aware of.
+
+# PROCESSING LOGIC (The "Density" Rules)
+- NEVER list individual file changes (e.g., "Modified App.tsx").
+- ALWAYS describe the INTENT (e.g., "Refactored Auth flow to support Multi-tenancy").
+- SHRED THE BLOAT: If a change is purely cosmetic (linting, comments), ignore it.
+- CONFLICTS: If the new diff contradicts the current memory, prioritize the new diff but note the "superseded" decision.
+- TOKEN EFFICIENCY: Focus on maintaining high-density content. The system's Memory Compaction tool handles token efficiency automatically when needed.
+- DATE CORRECTION: If you see any dates in the existing PROJECT_MEMORY.md that are from 2024, update them to 2026 to reflect the current year. Use today's date (${today}) as a reference for new entries.
+
+# OUTPUT FORMAT
+Return the complete, updated Markdown for \`PROJECT_MEMORY.md\`. No conversational filler.`;
+}
+export class Summarizer {
+    /**
+     * Build incremental update prompt (current memory + new diff)
+     */
+    buildIncrementalPrompt(currentMemory, cleanDiff) {
+        const today = new Date().toLocaleDateString();
+        return `Current Memory:
+${currentMemory}
+
+New Diff:
+${cleanDiff}
+
+Task: Update the memory to reflect these changes. Ensure 'Recent Decisions' is updated and 'Active Tech Debt' is pruned if the bug was fixed. Also, if you see any dates in the existing memory that are from 2024, update them to 2026. Use today's date (${today}) as a reference for new entries.`;
+    }
+    /**
+     * Summarize a diff and return complete updated PROJECT_MEMORY.md
+     */
+    async summarizeDiff(diff, currentMemory = '', thinkingLevel = 'flash') {
+        // Clean the diff first (pre-shredder)
+        const cleaned = cleanDiff(diff);
+        // Check if we need chunking
+        const maxTokens = await getMaxTokens();
+        const diffTokens = estimateTokens(cleaned);
+        const memoryTokens = estimateTokens(currentMemory);
+        const totalTokens = diffTokens + memoryTokens;
+        // Build prompt
+        const today = new Date().toLocaleDateString();
+        const prompt = currentMemory
+            ? this.buildIncrementalPrompt(currentMemory, cleaned)
+            : `New Diff:\n${cleaned}\n\nTask: Create or update PROJECT_MEMORY.md based on this diff. If you see any dates in existing memory that are from 2024, update them to 2026. Use today's date (${today}) as a reference for new entries.`;
+        // If total is small enough, process directly
+        if (totalTokens < maxTokens * 0.7) {
+            return await generateSummary(prompt, getLibrarianSystemPrompt(), {
+                thinkingLevel,
+                maxTokens,
+                feature: 'Librarian',
+            });
+        }
+        // Need chunking - split the diff
+        const chunks = chunkDiff(cleaned, maxTokens);
+        const summaries = [];
+        // Process each chunk
+        for (let i = 0; i < chunks.length; i++) {
+            const chunk = chunks[i];
+            const chunkPrompt = currentMemory
+                ? this.buildIncrementalPrompt(currentMemory, chunk)
+                : `New Diff (Chunk ${i + 1}/${chunks.length}):\n${chunk}`;
+            const summary = await generateSummary(chunkPrompt, getLibrarianSystemPrompt(), {
+                thinkingLevel,
+                maxTokens,
+                feature: 'Librarian',
+            });
+            summaries.push(summary);
+            // Update current memory with first summary for context in subsequent chunks
+            if (i === 0 && !currentMemory) {
+                currentMemory = summary;
+            }
+        }
+        // Aggregate summaries
+        // Note: For multiple chunks, we might need to merge them intelligently
+        // For now, use the last summary as it should have the most complete context
+        if (summaries.length > 1) {
+            // Re-summarize all summaries together
+            const aggregatedPrompt = `Multiple summaries were generated from different parts of a large diff. Merge them into a single coherent PROJECT_MEMORY.md:
+
+${summaries.map((s, i) => `## Summary ${i + 1}\n${s}`).join('\n\n')}
+
+Task: Create a single, unified PROJECT_MEMORY.md that combines all the information from these summaries.`;
+            return await generateSummary(aggregatedPrompt, getLibrarianSystemPrompt(), {
+                thinkingLevel: 'flash', // Use flash for merging (routine task)
+                maxTokens,
+                feature: 'Librarian',
+            });
+        }
+        return summaries[0] || '';
+    }
+    /**
+     * Infer architecture from file structure and README
+     */
+    async inferArchitecture(fileStructure, readme, thinkingLevel = 'flash') {
+        const today = new Date().toLocaleDateString();
+        const prompt = `File Structure:
+\`\`\`
+${fileStructure}
+\`\`\`
+
+${readme ? `README.md:\n\`\`\`\n${readme}\n\`\`\`\n\n` : ''}Task: Analyze the file structure${readme ? ' and README' : ''} to infer:
+1. Project Soul (2 sentences: what this app is and who it's for)
+2. Tech Stack (core libraries, frameworks, versions - infer from structure)
+3. Architecture (high-level data flow description)
+4. Core Rules (if detectable from structure/README)
+
+Create a complete PROJECT_MEMORY.md with all required sections. Use today's date (${today}) for any date entries. If you see any dates from 2024 in existing memory, update them to 2026.`;
+        const maxTokens = await getMaxTokens();
+        return await generateSummary(prompt, getLibrarianSystemPrompt(), {
+            thinkingLevel,
+            maxTokens,
+            feature: 'Librarian',
+        });
+    }
+    /**
+     * Merge Git conflicts in PROJECT_MEMORY.md
+     */
+    async mergeConflicts(conflictedMemory) {
+        const prompt = `You are "The Librarian," an expert Software Architect and Context Manager.
+
+# TASK
+Merge the following conflicted PROJECT_MEMORY.md file. The file contains Git conflict markers (<<<<<<<, =======, >>>>>>>).
+
+# INSTRUCTIONS
+1. Remove all conflict markers (<<<<<<<, =======, >>>>>>>)
+2. Intelligently merge the conflicting sections, preserving important information from both versions
+3. Maintain the required structure:
+   - ## Project Soul
+   - ## Tech Stack
+   - ## Architecture
+   - ## Core Rules
+   - ## Recent Decisions (The "Why")
+   - ## Active Tech Debt
+4. Preserve all Recent Decisions entries; do not delete older entries during merge
+5. Return the complete, merged Markdown file with no conflict markers
+
+# CONFLICTED FILE
+${conflictedMemory}
+
+# OUTPUT
+Return only the merged Markdown content, no explanations.`;
+        const systemPrompt = `You are a Git conflict resolution expert specializing in Markdown files about software architecture.`;
+        const maxTokens = await getMaxTokens();
+        return await generateSummary(prompt, systemPrompt, {
+            thinkingLevel: 'flash',
+            temperature: 0.2, // Lower temperature for more consistent merging
+            maxTokens,
+            feature: 'Librarian',
+        });
+    }
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/librarian/summarizer.js.map

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

package/dist/librarian/watcher.d.ts

@@ -0,0 +1,51 @@
+export declare class Watcher {
+    private repoPath;
+    private gitUtils;
+    private statePath;
+    private watcher;
+    private onCommitCallback;
+    private debounceTimer;
+    private debounceDelay;
+    constructor(repoPath?: string);
+    /**
+     * Load state from file
+     */
+    private loadState;
+    /**
+     * Save state to file
+     */
+    private saveState;
+    /**
+     * Detect if there's a new commit
+     */
+    detectNewCommit(): Promise<string | null>;
+    /**
+     * Process a new commit (called by debounced handler)
+     */
+    private processNewCommit;
+    /**
+     * Debounced commit handler
+     */
+    private handleChange;
+    /**
+     * Start watching for Git changes
+     */
+    startWatching(): Promise<void>;
+    /**
+     * Register callback for when a commit is detected
+     */
+    onCommitDetected(callback: () => Promise<void>): void;
+    /**
+     * Stop watching
+     */
+    stopWatching(): Promise<void>;
+    /**
+     * Get last processed commit hash
+     */
+    getLastProcessedCommit(): Promise<string | null>;
+    /**
+     * Set last processed commit (useful for initialization)
+     */
+    setLastProcessedCommit(commitHash: string): Promise<void>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/librarian/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/librarian/watcher.ts"],"names":[],"mappings":"AAUA,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAAO;gBAEhB,QAAQ,GAAE,MAAsB;IAM5C;;OAEG;YACW,SAAS;IAavB;;OAEG;YACW,SAAS;IAQvB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgB/C;;OAEG;YACW,gBAAgB;IAqC9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA8CpC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKtD;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOhE"}