@getvibeguard/cli 1.0.0

package/dist/librarian/initializer.js

@@ -0,0 +1,202 @@
+import { GitUtils } from '../utils/git.js';
+import { Summarizer } from './summarizer.js';
+import { MemoryManager } from './memory-manager.js';
+import * as path from 'path';
+export class Initializer {
+    repoPath;
+    gitUtils;
+    summarizer;
+    memoryManager;
+    constructor(repoPath = process.cwd()) {
+        this.repoPath = repoPath;
+        this.gitUtils = new GitUtils(repoPath);
+        this.summarizer = new Summarizer();
+        this.memoryManager = new MemoryManager(repoPath);
+    }
+    /**
+     * Ensure PROJECT_MEMORY.md is tracked in Git
+     */
+    async ensureMemoryTrackedInGit() {
+        const memoryPath = path.join(this.repoPath, 'PROJECT_MEMORY.md');
+        const isIgnored = await this.gitUtils.isInGitignore(memoryPath);
+        if (isIgnored) {
+            console.log('Removing PROJECT_MEMORY.md from .gitignore...');
+            await this.gitUtils.removeFromGitignore(memoryPath);
+        }
+        // Stage the file if it exists
+        try {
+            await this.gitUtils.stageFile(memoryPath);
+        }
+        catch (error) {
+            // File doesn't exist yet - that's fine
+        }
+    }
+    /**
+     * Tier 1: Oneline Sweep (0 tokens)
+     * Parse git log locally to identify milestone commits
+     */
+    async tier1OnelineSweep() {
+        console.log('Tier 1: Analyzing commit history (oneline sweep)...');
+        try {
+            // Get last 100 commits or last 6 months
+            const sixMonthsAgo = new Date();
+            sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
+            const since = sixMonthsAgo.toISOString().split('T')[0];
+            const commits = await this.gitUtils.getOnelineLog(100, since);
+            if (commits.length === 0) {
+                console.log('No commit history found. This appears to be a brand new repository.');
+                return {
+                    milestones: [],
+                    totalCommits: 0,
+                };
+            }
+            const milestones = [];
+            // Keywords that indicate significant changes
+            const significantKeywords = [
+                'refactor',
+                'architecture',
+                'init',
+                'migration',
+                'restructure',
+                'redesign',
+                'major',
+                'breaking',
+            ];
+            for (const commit of commits) {
+                let type = 'other';
+                const message = commit.message.toLowerCase();
+                // Check for tags (we'd need to check git tags separately)
+                // For now, we'll focus on merge commits and keywords
+                // Check for merge commits
+                if (message.includes('merge') || commit.hash.includes('merge')) {
+                    type = 'merge';
+                    milestones.push({
+                        hash: commit.hash,
+                        message: commit.message,
+                        date: commit.date,
+                        type,
+                    });
+                    continue;
+                }
+                // Check for significant keywords
+                for (const keyword of significantKeywords) {
+                    if (message.includes(keyword)) {
+                        type = 'keyword';
+                        milestones.push({
+                            hash: commit.hash,
+                            message: commit.message,
+                            date: commit.date,
+                            type,
+                        });
+                        break;
+                    }
+                }
+            }
+            console.log(`Found ${milestones.length} milestone commits out of ${commits.length} total`);
+            return {
+                milestones,
+                totalCommits: commits.length,
+            };
+        }
+        catch (error) {
+            // Fallback for brand new repositories or Git errors
+            console.warn('Could not analyze commit history:', error.message || error);
+            console.log('Continuing with empty history...');
+            return {
+                milestones: [],
+                totalCommits: 0,
+            };
+        }
+    }
+    /**
+     * Tier 2: Deep Context (Mid-cost)
+     * Process last 5-10 commits with Gemini
+     */
+    async tier2DeepContext() {
+        console.log('Tier 2: Processing recent commits (deep context)...');
+        const commitCount = 10; // Process last 10 commits
+        const commits = await this.gitUtils.getLatestCommits(commitCount);
+        if (commits.length === 0) {
+            return '';
+        }
+        // Get diffs for all commits
+        const diffs = [];
+        for (const commit of commits) {
+            try {
+                const diff = await this.gitUtils.getCommitDiff(commit.hash);
+                diffs.push(`## Commit: ${commit.message}\n\n${diff}`);
+            }
+            catch (error) {
+                console.warn(`Failed to get diff for commit ${commit.hash}:`, error);
+            }
+        }
+        const combinedDiff = diffs.join('\n\n---\n\n');
+        // Read current memory if it exists
+        const currentMemory = await this.memoryManager.readMemory();
+        // Summarize with Gemini
+        const updatedMemory = await this.summarizer.summarizeDiff(combinedDiff, currentMemory, 'flash' // OPTIMIZATION: Use Flash for diff summarization (faster/cheaper)
+        );
+        return updatedMemory;
+    }
+    /**
+     * Tier 3: Skeleton Scan (High value)
+     * Infer architecture from file structure and README
+     */
+    async tier3SkeletonScan() {
+        console.log('Tier 3: Analyzing project structure (skeleton scan)...');
+        // Get file structure
+        const fileStructure = await this.gitUtils.getFileStructure();
+        // Read README if it exists
+        const readme = await this.gitUtils.readReadme();
+        // Infer architecture with high thinking level
+        const memory = await this.summarizer.inferArchitecture(fileStructure, readme || undefined, 'pro' // OPTIMIZATION: Use Pro for "Big Picture" architecture work
+        );
+        return memory;
+    }
+    /**
+     * Main initialization orchestrator
+     */
+    async initialize() {
+        console.log('Starting three-tier initialization...\n');
+        // Ensure memory is tracked in Git
+        await this.ensureMemoryTrackedInGit();
+        // Tier 1: Oneline sweep (0 tokens, local only)
+        const timeline = await this.tier1OnelineSweep();
+        console.log(`Tier 1 complete: ${timeline.milestones.length} milestones identified\n`);
+        // Tier 2: Deep context (process recent commits)
+        let tier2Memory = '';
+        try {
+            tier2Memory = await this.tier2DeepContext();
+            console.log('Tier 2 complete: Recent commits processed\n');
+        }
+        catch (error) {
+            console.error('Tier 2 error:', error);
+            // Continue with Tier 3 even if Tier 2 fails
+        }
+        // Tier 3: Skeleton scan (infer architecture)
+        let tier3Memory = '';
+        try {
+            tier3Memory = await this.tier3SkeletonScan();
+            console.log('Tier 3 complete: Architecture inferred\n');
+        }
+        catch (error) {
+            console.error('Tier 3 error:', error);
+            throw error; // Tier 3 is critical
+        }
+        // Merge Tier 2 and Tier 3 results
+        // If we have Tier 2 results, use them as base and enhance with Tier 3
+        // Otherwise, use Tier 3 as the base
+        let finalMemory = tier2Memory || tier3Memory;
+        // If we have both, merge them intelligently
+        if (tier2Memory && tier3Memory && tier2Memory !== tier3Memory) {
+            // Use Tier 3 as base (architecture) and merge Tier 2 (recent decisions)
+            // The summarizer can handle this by using Tier 2 as "current memory" and Tier 3 as "new diff"
+            finalMemory = await this.summarizer.summarizeDiff(`# Architecture Update\n\n${tier3Memory}`, tier2Memory, 'pro' // OPTIMIZATION: Use Pro for "Big Picture" architecture work
+            );
+        }
+        // Write the final memory
+        await this.memoryManager.writeMemory(finalMemory);
+        console.log('Initialization complete! PROJECT_MEMORY.md has been created/updated.');
+    }
+}
+//# sourceMappingURL=initializer.js.map

package/dist/librarian/initializer.js.map

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

package/dist/librarian/memory-manager.d.ts

@@ -0,0 +1,37 @@
+export declare class MemoryManager {
+    private repoPath;
+    private gitUtils;
+    constructor(repoPath?: string);
+    /**
+     * Get the full path to PROJECT_MEMORY.md
+     */
+    private getMemoryPath;
+    /**
+     * Read existing PROJECT_MEMORY.md
+     */
+    readMemory(): Promise<string>;
+    /**
+     * Validate memory file structure
+     */
+    validateMemoryStructure(content: string): boolean;
+    /**
+     * Write memory file atomically
+     */
+    writeMemory(content: string): Promise<void>;
+    /**
+     * Stage PROJECT_MEMORY.md in Git
+     */
+    stageMemoryFile(): Promise<void>;
+    /**
+     * Append content to a specific section in PROJECT_MEMORY.md
+     * If the section exists, appends the content under that header.
+     * If not, appends to the end of the file.
+     * Uses atomic writes for safety.
+     */
+    appendToSection(section: string, content: string): Promise<void>;
+    /**
+     * Resolve Git conflicts using Gemini
+     */
+    resolveConflicts(conflictedContent: string): Promise<string>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/librarian/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/librarian/memory-manager.ts"],"names":[],"mappings":"AAgBA,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,GAAE,MAAsB;IAK5C;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBnC;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAejD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgFtE;;OAEG;IACG,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA4CnE"}

package/dist/librarian/memory-manager.js

@@ -0,0 +1,205 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import writeFileAtomic from 'write-file-atomic';
+import { GitUtils } from '../utils/git.js';
+import { generateSummary } from '../utils/llm.js';
+const MEMORY_FILE = 'PROJECT_MEMORY.md';
+const REQUIRED_SECTIONS = [
+    '## Project Soul',
+    '## Tech Stack',
+    '## Architecture',
+    '## Core Rules',
+    '## Recent Decisions',
+    '## Active Tech Debt',
+];
+export class MemoryManager {
+    repoPath;
+    gitUtils;
+    constructor(repoPath = process.cwd()) {
+        this.repoPath = repoPath;
+        this.gitUtils = new GitUtils(repoPath);
+    }
+    /**
+     * Get the full path to PROJECT_MEMORY.md
+     */
+    getMemoryPath() {
+        return path.join(this.repoPath, MEMORY_FILE);
+    }
+    /**
+     * Read existing PROJECT_MEMORY.md
+     */
+    async readMemory() {
+        const memoryPath = this.getMemoryPath();
+        try {
+            const content = await fs.readFile(memoryPath, 'utf-8');
+            // Check for conflict markers
+            if (this.gitUtils.hasConflictMarkers(content)) {
+                // Resolve conflicts using Gemini
+                return await this.resolveConflicts(content);
+            }
+            return content;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - return empty string
+                return '';
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate memory file structure
+     */
+    validateMemoryStructure(content) {
+        if (!content || content.trim().length === 0) {
+            return false; // Empty file is invalid
+        }
+        // Check for all required sections
+        for (const section of REQUIRED_SECTIONS) {
+            if (!content.includes(section)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Write memory file atomically
+     */
+    async writeMemory(content) {
+        // Validate structure
+        if (!this.validateMemoryStructure(content)) {
+            throw new Error('Invalid PROJECT_MEMORY.md structure: missing required sections');
+        }
+        // Write atomically
+        const memoryPath = this.getMemoryPath();
+        await writeFileAtomic(memoryPath, content, 'utf-8');
+        // Auto-stage the file
+        await this.stageMemoryFile();
+    }
+    /**
+     * Stage PROJECT_MEMORY.md in Git
+     */
+    async stageMemoryFile() {
+        const memoryPath = this.getMemoryPath();
+        await this.gitUtils.stageFile(memoryPath);
+    }
+    /**
+     * Append content to a specific section in PROJECT_MEMORY.md
+     * If the section exists, appends the content under that header.
+     * If not, appends to the end of the file.
+     * Uses atomic writes for safety.
+     */
+    async appendToSection(section, content) {
+        // Normalize section name to match markdown header format (## Section Name)
+        let sectionHeader = section.trim();
+        if (!sectionHeader.startsWith('##')) {
+            sectionHeader = `## ${sectionHeader}`;
+        }
+        // Read current memory
+        let currentContent = await this.readMemory();
+        // If file is empty, create basic structure
+        if (!currentContent || currentContent.trim().length === 0) {
+            currentContent = `# PROJECT_MEMORY.md\n\n${sectionHeader}\n\n`;
+        }
+        const lines = currentContent.split('\n');
+        const updatedLines = [];
+        let sectionFound = false;
+        let sectionIndex = -1;
+        // Find the section header (handle variations like "## Recent Decisions (The "Why")")
+        const normalizedSectionHeader = sectionHeader.replace(/^##\s+/, ''); // Remove ## prefix for comparison
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Match exact header or header with additional text in parentheses
+            if (line === sectionHeader ||
+                (line.startsWith('## ') && line.replace(/^##\s+/, '').split('(')[0].trim() === normalizedSectionHeader)) {
+                sectionFound = true;
+                sectionIndex = i;
+                break;
+            }
+        }
+        if (sectionFound && sectionIndex >= 0) {
+            // Section exists - append content after the header
+            for (let i = 0; i <= sectionIndex; i++) {
+                updatedLines.push(lines[i]);
+            }
+            // Find the end of the section (next ## header or end of file)
+            let insertIndex = sectionIndex + 1;
+            // Skip blank lines after header
+            while (insertIndex < lines.length && lines[insertIndex].trim() === '') {
+                updatedLines.push(lines[insertIndex]);
+                insertIndex++;
+            }
+            // Add the new content with proper formatting
+            const formattedContent = content.trim();
+            if (formattedContent) {
+                updatedLines.push(formattedContent);
+                updatedLines.push(''); // Add blank line after content
+            }
+            // Add remaining lines
+            for (let i = insertIndex; i < lines.length; i++) {
+                updatedLines.push(lines[i]);
+            }
+        }
+        else {
+            // Section doesn't exist - append to end
+            updatedLines.push(...lines);
+            if (lines[lines.length - 1] !== '') {
+                updatedLines.push(''); // Ensure blank line before new section
+            }
+            updatedLines.push(sectionHeader);
+            updatedLines.push(''); // Blank line after header
+            updatedLines.push(content.trim());
+        }
+        const updatedContent = updatedLines.join('\n');
+        // Write atomically
+        const memoryPath = this.getMemoryPath();
+        await writeFileAtomic(memoryPath, updatedContent, 'utf-8');
+        // Auto-stage the file
+        await this.stageMemoryFile();
+    }
+    /**
+     * Resolve Git conflicts using Gemini
+     */
+    async resolveConflicts(conflictedContent) {
+        const conflictPrompt = `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
+${conflictedContent}
+
+# 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.`;
+        try {
+            const merged = await generateSummary(conflictPrompt, systemPrompt, {
+                thinkingLevel: 'flash',
+                temperature: 0.2, // Lower temperature for more consistent merging
+                feature: 'Librarian',
+            });
+            // Validate the merged result
+            if (this.gitUtils.hasConflictMarkers(merged)) {
+                throw new Error('Conflict resolution failed: merged content still contains conflict markers');
+            }
+            return merged;
+        }
+        catch (error) {
+            throw new Error(`Failed to resolve conflicts: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/librarian/memory-manager.js.map

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

package/dist/librarian/oracle.d.ts

@@ -0,0 +1,51 @@
+export interface Prophecy {
+    id: string;
+    type: 'Refactor' | 'RuleViolation' | 'Optimization';
+    title: string;
+    description: string;
+    suggestedAction: string;
+    priority: 'High' | 'Medium' | 'Low';
+    createdAt: string;
+}
+export declare class OracleService {
+    private repoPath;
+    private statePath;
+    constructor(repoPath?: string);
+    /**
+     * Load oracle state from file
+     */
+    private loadState;
+    /**
+     * Save oracle state to file
+     */
+    private saveState;
+    /**
+     * Scan the project directory and return file tree structure
+     */
+    private scanProjectTree;
+    /**
+     * Read PROJECT_MEMORY.md
+     */
+    private readProjectMemory;
+    /**
+     * Read DIAGRAM.md
+     */
+    private readDiagram;
+    /**
+     * Seek prophecy - Compare Project Soul/Rules with actual file structure
+     */
+    seekProphecy(): Promise<Prophecy[]>;
+    /**
+     * Get all prophecies
+     */
+    getProphecies(): Promise<Prophecy[]>;
+    /**
+     * Get prophecies by priority
+     */
+    getPropheciesByPriority(priority: 'High' | 'Medium' | 'Low'): Promise<Prophecy[]>;
+    /**
+     * Clear all prophecies
+     */
+    clearProphecies(): Promise<void>;
+}
+//# sourceMappingURL=oracle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/librarian/oracle.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,cAAc,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,GAAE,MAAsB;IAK5C;;OAEG;YACW,SAAS;IAavB;;OAEG;YACW,SAAS;IAQvB;;OAEG;YACW,eAAe;IAoD7B;;OAEG;YACW,iBAAiB;IAS/B;;OAEG;YACW,WAAW;IASzB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkHzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK1C;;OAEG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKvF;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAMvC"}