clavix 4.11.2 → 5.0.0

package/dist/core/prd-generator.js

@@ -1,173 +0,0 @@
-/**
- * PrdGenerator - Generates Product Requirements Documents from collected answers
- *
- * This class handles:
- * - Template loading and rendering with Handlebars
- * - Project name extraction
- * - File generation (full PRD and quick PRD)
- * - Output organization and timestamps
- */
-import fs from 'fs-extra';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
-import Handlebars from 'handlebars';
-import { FileSystem } from '../utils/file-system.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-/**
- * PrdGenerator class
- *
- * Generates comprehensive and quick-reference PRD documents
- * from collected question answers
- */
-export class PrdGenerator {
-    templatesDir;
-    defaultOutputDir = '.clavix/outputs';
-    constructor() {
-        // Templates are in src/templates (or dist/templates when built)
-        this.templatesDir = path.join(__dirname, '../templates');
-    }
-    /**
-     * Generate PRD documents from answers
-     *
-     * @param answers - Collected answers from QuestionEngine
-     * @param options - Generation options
-     * @returns Path to the output directory
-     */
-    async generate(answers, options = {}) {
-        const projectName = options.projectName || this.extractProjectName(answers);
-        const outputDir = options.outputDir || this.defaultOutputDir;
-        const timestamp = options.timestamp || new Date();
-        // Create output directory
-        const projectDir = path.join(outputDir, this.sanitizeProjectName(projectName));
-        await FileSystem.ensureDir(projectDir);
-        // Prepare template data
-        const metadata = {
-            generatedAt: timestamp.toISOString(),
-            generatedBy: 'Clavix PRD Generator',
-            projectName,
-            version: '1.0.0',
-        };
-        const templateData = {
-            ...this.prepareAnswersForTemplate(answers),
-            metadata,
-            timestamp: this.formatTimestamp(timestamp),
-        };
-        // Generate full PRD
-        const fullPrdPath = path.join(projectDir, 'full-prd.md');
-        await this.generateFullPrd(templateData, fullPrdPath);
-        // Generate quick PRD
-        const quickPrdPath = path.join(projectDir, 'quick-prd.md');
-        await this.generateQuickPrd(templateData, quickPrdPath);
-        return projectDir;
-    }
-    /**
-     * Extract project name from answers
-     *
-     * Tries to infer a project name from the problem statement or user responses
-     */
-    extractProjectName(answers) {
-        // Try to find a project name in the answers
-        // Look in common question answers like "problem", "name", "title"
-        const possibleNameFields = ['projectName', 'name', 'title', 'q1', 'problem'];
-        for (const field of possibleNameFields) {
-            if (answers[field] && typeof answers[field] === 'string') {
-                const extracted = this.extractNameFromText(answers[field]);
-                if (extracted) {
-                    return extracted;
-                }
-            }
-        }
-        // Default to timestamp-based name
-        return `project-${Date.now()}`;
-    }
-    /**
-     * Extract a concise name from text (e.g., from problem statement)
-     */
-    extractNameFromText(text) {
-        // Take first few words, clean up, and create a name
-        const words = text
-            .split(/\s+/)
-            .slice(0, 4)
-            .map((w) => w.toLowerCase())
-            .filter((w) => w.length > 2);
-        if (words.length === 0) {
-            return null;
-        }
-        return words.join('-').replace(/[^a-z0-9-]/g, '');
-    }
-    /**
-     * Sanitize project name for use as directory name
-     */
-    sanitizeProjectName(name) {
-        return name
-            .toLowerCase()
-            .replace(/[^a-z0-9-]/g, '-')
-            .replace(/-+/g, '-')
-            .replace(/^-|-$/g, '')
-            .substring(0, 50);
-    }
-    /**
-     * Prepare answers for template rendering
-     */
-    prepareAnswersForTemplate(answers) {
-        const prepared = {};
-        // Map question IDs to friendly names (updated for CLEAR-optimized 5-question flow)
-        const questionMap = {
-            q1: 'problem', // What are we building and why?
-            q2: 'features', // Core features
-            q3: 'technical', // Tech stack (optional, smart-detected)
-            q4: 'outOfScope', // Out of scope
-            q5: 'additional', // Additional context (optional)
-        };
-        for (const [questionId, value] of Object.entries(answers)) {
-            const friendlyName = questionMap[questionId] || questionId;
-            prepared[friendlyName] = value;
-        }
-        return prepared;
-    }
-    /**
-     * Generate full PRD document
-     */
-    async generateFullPrd(data, outputPath) {
-        const templatePath = path.join(this.templatesDir, 'full-prd-template.hbs');
-        // Check if custom template exists
-        const customTemplatePath = '.clavix/templates/full-prd-template.hbs';
-        const templateToUse = await fs.pathExists(customTemplatePath)
-            ? customTemplatePath
-            : templatePath;
-        const template = await fs.readFile(templateToUse, 'utf-8');
-        const compiled = Handlebars.compile(template);
-        const rendered = compiled(data);
-        await FileSystem.writeFileAtomic(outputPath, rendered);
-    }
-    /**
-     * Generate quick PRD document
-     */
-    async generateQuickPrd(data, outputPath) {
-        const templatePath = path.join(this.templatesDir, 'quick-prd-template.hbs');
-        // Check if custom template exists
-        const customTemplatePath = '.clavix/templates/quick-prd-template.hbs';
-        const templateToUse = await fs.pathExists(customTemplatePath)
-            ? customTemplatePath
-            : templatePath;
-        const template = await fs.readFile(templateToUse, 'utf-8');
-        const compiled = Handlebars.compile(template);
-        const rendered = compiled(data);
-        await FileSystem.writeFileAtomic(outputPath, rendered);
-    }
-    /**
-     * Format timestamp for display
-     */
-    formatTimestamp(date) {
-        return date.toLocaleString('en-US', {
-            year: 'numeric',
-            month: 'long',
-            day: 'numeric',
-            hour: '2-digit',
-            minute: '2-digit',
-        });
-    }
-}
-//# sourceMappingURL=prd-generator.js.map

package/dist/core/prompt-manager.d.ts

@@ -1,110 +0,0 @@
-import { DepthLevel } from './intelligence/types.js';
-/**
- * v4.11: Unified prompt metadata
- * Replaces separate fast/deep storage with single directory and depthUsed field
- */
-export interface PromptMetadata {
-    id: string;
-    filename: string;
-    depthUsed: DepthLevel;
-    timestamp: string;
-    createdAt: Date;
-    path: string;
-    originalPrompt: string;
-    executed: boolean;
-    executedAt: string | null;
-    ageInDays?: number;
-    linkedProject?: string;
-    verificationRequired: boolean;
-    verified: boolean;
-    verifiedAt: string | null;
-}
-export interface PromptsIndex {
-    version: string;
-    prompts: PromptMetadata[];
-}
-export interface PromptData {
-    metadata: PromptMetadata;
-    content: string;
-}
-export interface PromptFilters {
-    depthUsed?: DepthLevel;
-    executed?: boolean;
-    stale?: boolean;
-    old?: boolean;
-}
-export interface StorageStats {
-    totalPrompts: number;
-    standardPrompts: number;
-    comprehensivePrompts: number;
-    executedPrompts: number;
-    pendingPrompts: number;
-    stalePrompts: number;
-    oldPrompts: number;
-    oldestPromptAge: number;
-}
-export declare class PromptManager {
-    private readonly promptsDir;
-    constructor(baseDir?: string);
-    /**
-     * v4.11: Get unified index file path
-     */
-    private getIndexPath;
-    /**
-     * v4.11: Ensure prompts directory exists (single directory)
-     */
-    ensurePromptsDir(): Promise<void>;
-    /**
-     * v4.11: Generate unique prompt ID with depth and timestamp
-     */
-    generatePromptId(depthLevel: DepthLevel, _originalPrompt: string): string;
-    /**
-     * v4.11: Save optimized prompt to file system
-     */
-    savePrompt(content: string, depthUsed: DepthLevel, originalPrompt: string, linkedProject?: string): Promise<PromptMetadata>;
-    /**
-     * v4.11: Load prompt by ID
-     */
-    loadPrompt(id: string): Promise<PromptData | null>;
-    /**
-     * v4.11: List prompts with optional filtering
-     */
-    listPrompts(filters?: PromptFilters): Promise<PromptMetadata[]>;
-    /**
-     * v4.11: Mark prompt as executed
-     */
-    markExecuted(id: string): Promise<void>;
-    /**
-     * v4.11: Mark prompt as verified (v4.8)
-     */
-    markVerified(id: string): Promise<void>;
-    /**
-     * v4.11: Delete prompts by filter
-     */
-    deletePrompts(filters: PromptFilters): Promise<number>;
-    /**
-     * Get age of prompt in days
-     */
-    getPromptAge(prompt: PromptMetadata): number;
-    /**
-     * Get stale prompts (>30 days old)
-     */
-    getStalePrompts(_daysOld?: number): Promise<PromptMetadata[]>;
-    /**
-     * v4.11: Get storage statistics
-     */
-    getStorageStats(): Promise<StorageStats>;
-    /**
-     * v4.11: Load unified index from file
-     */
-    private loadIndex;
-    /**
-     * v4.11: Save unified index to file
-     */
-    private saveIndex;
-    /**
-     * v4.11: Add prompt to unified index
-     */
-    private addToIndex;
-}
-//# sourceMappingURL=prompt-manager.d.ts.map

package/dist/core/prompt-manager.js

@@ -1,274 +0,0 @@
-import fs from 'fs-extra';
-import * as path from 'path';
-import { v4 as uuidv4 } from 'uuid';
-export class PromptManager {
-    promptsDir;
-    constructor(baseDir) {
-        // v4.11: Single prompts directory (no fast/deep subdirs)
-        if (baseDir) {
-            this.promptsDir = baseDir.endsWith('prompts') ? baseDir : path.join(baseDir, 'prompts');
-        }
-        else {
-            this.promptsDir = path.join(process.cwd(), '.clavix', 'outputs', 'prompts');
-        }
-    }
-    /**
-     * v4.11: Get unified index file path
-     */
-    getIndexPath() {
-        return path.join(this.promptsDir, '.index.json');
-    }
-    /**
-     * v4.11: Ensure prompts directory exists (single directory)
-     */
-    async ensurePromptsDir() {
-        await fs.ensureDir(this.promptsDir);
-    }
-    /**
-     * v4.11: Generate unique prompt ID with depth and timestamp
-     */
-    generatePromptId(depthLevel, _originalPrompt) {
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('T');
-        const date = timestamp[0].replace(/-/g, '');
-        const time = timestamp[1].split('-').slice(0, 3).join('');
-        // Use UUID for uniqueness (mockable for tests - first 13 chars for readability)
-        const hash = uuidv4().substring(0, 13);
-        // v4.11: Use depth level abbreviation in ID
-        const depthAbbrev = depthLevel === 'comprehensive' ? 'comp' : 'std';
-        return `${depthAbbrev}-${date}-${time}-${hash}`;
-    }
-    /**
-     * v4.11: Save optimized prompt to file system
-     */
-    async savePrompt(content, depthUsed, originalPrompt, linkedProject) {
-        await this.ensurePromptsDir();
-        const id = this.generatePromptId(depthUsed, originalPrompt);
-        const filename = `${id}.md`;
-        // v4.11: Single directory, no subdirs
-        const filePath = path.join(this.promptsDir, filename);
-        const now = new Date();
-        const metadata = {
-            id,
-            filename,
-            depthUsed, // v4.11: Replaces 'source'
-            timestamp: now.toISOString(),
-            createdAt: now,
-            path: filePath,
-            originalPrompt,
-            executed: false,
-            executedAt: null,
-            linkedProject,
-            // Verification tracking (v4.8)
-            verificationRequired: true,
-            verified: false,
-            verifiedAt: null,
-        };
-        // Create file with frontmatter
-        const frontmatter = [
-            '---',
-            `id: ${id}`,
-            `depthUsed: ${depthUsed}`,
-            `timestamp: ${metadata.timestamp}`,
-            `executed: ${metadata.executed}`,
-            `originalPrompt: ${originalPrompt}`,
-            linkedProject ? `linkedProject: ${linkedProject}` : '',
-            `verificationRequired: ${metadata.verificationRequired}`,
-            `verified: ${metadata.verified}`,
-            '---',
-            '',
-        ]
-            .filter(Boolean)
-            .join('\n');
-        const fileContent = frontmatter + content;
-        await fs.writeFile(filePath, fileContent, 'utf-8');
-        // Update index
-        await this.addToIndex(metadata);
-        return metadata;
-    }
-    /**
-     * v4.11: Load prompt by ID
-     */
-    async loadPrompt(id) {
-        const index = await this.loadIndex();
-        const metadata = index.prompts.find((p) => p.id === id);
-        if (!metadata) {
-            return null;
-        }
-        // v4.11: Single directory - no subdirs
-        const filePath = path.join(this.promptsDir, metadata.filename);
-        if (!(await fs.pathExists(filePath))) {
-            return null;
-        }
-        const content = await fs.readFile(filePath, 'utf-8');
-        // Strip frontmatter for clean content
-        const contentWithoutFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n*/, '');
-        return {
-            metadata,
-            content: contentWithoutFrontmatter,
-        };
-    }
-    /**
-     * v4.11: List prompts with optional filtering
-     */
-    async listPrompts(filters) {
-        const index = await this.loadIndex();
-        let prompts = index.prompts;
-        // Apply filters
-        if (filters) {
-            // v4.11: Filter by depth level
-            if (filters.depthUsed) {
-                prompts = prompts.filter((p) => p.depthUsed === filters.depthUsed);
-            }
-            if (filters.executed !== undefined) {
-                prompts = prompts.filter((p) => p.executed === filters.executed);
-            }
-            if (filters.stale) {
-                prompts = prompts.filter((p) => this.getPromptAge(p) > 30);
-            }
-            if (filters.old) {
-                prompts = prompts.filter((p) => this.getPromptAge(p) > 7);
-            }
-        }
-        // Add age calculation
-        prompts = prompts.map((p) => ({
-            ...p,
-            createdAt: new Date(p.timestamp),
-            ageInDays: this.getPromptAge(p),
-        }));
-        // Sort by timestamp (newest first)
-        prompts.sort((a, b) => {
-            return new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime();
-        });
-        return prompts;
-    }
-    /**
-     * v4.11: Mark prompt as executed
-     */
-    async markExecuted(id) {
-        const index = await this.loadIndex();
-        const indexPrompt = index.prompts.find((p) => p.id === id);
-        if (!indexPrompt) {
-            throw new Error(`Prompt not found: ${id}`);
-        }
-        indexPrompt.executed = true;
-        indexPrompt.executedAt = new Date().toISOString();
-        await this.saveIndex(index);
-    }
-    /**
-     * v4.11: Mark prompt as verified (v4.8)
-     */
-    async markVerified(id) {
-        const index = await this.loadIndex();
-        const indexPrompt = index.prompts.find((p) => p.id === id);
-        if (!indexPrompt) {
-            throw new Error(`Prompt not found: ${id}`);
-        }
-        indexPrompt.verified = true;
-        indexPrompt.verifiedAt = new Date().toISOString();
-        await this.saveIndex(index);
-    }
-    /**
-     * v4.11: Delete prompts by filter
-     */
-    async deletePrompts(filters) {
-        const toDelete = await this.listPrompts(filters);
-        let deleteCount = 0;
-        const deletedIds = new Set();
-        for (const prompt of toDelete) {
-            // v4.11: Single directory - no subdirs
-            const filePath = path.join(this.promptsDir, prompt.filename);
-            if (await fs.pathExists(filePath)) {
-                await fs.remove(filePath);
-                deleteCount++;
-                deletedIds.add(prompt.id);
-            }
-        }
-        // Update unified index
-        if (deletedIds.size > 0) {
-            const index = await this.loadIndex();
-            index.prompts = index.prompts.filter((p) => !deletedIds.has(p.id));
-            await this.saveIndex(index);
-        }
-        return deleteCount;
-    }
-    /**
-     * Get age of prompt in days
-     */
-    getPromptAge(prompt) {
-        const created = new Date(prompt.timestamp);
-        const now = new Date();
-        const diffMs = now.getTime() - created.getTime();
-        return Math.floor(diffMs / (1000 * 60 * 60 * 24));
-    }
-    /**
-     * Get stale prompts (>30 days old)
-     */
-    async getStalePrompts(_daysOld = 30) {
-        return this.listPrompts({ stale: true });
-    }
-    /**
-     * v4.11: Get storage statistics
-     */
-    async getStorageStats() {
-        const allPrompts = await this.listPrompts();
-        const stats = {
-            totalPrompts: allPrompts.length,
-            standardPrompts: allPrompts.filter((p) => p.depthUsed === 'standard').length,
-            comprehensivePrompts: allPrompts.filter((p) => p.depthUsed === 'comprehensive').length,
-            executedPrompts: allPrompts.filter((p) => p.executed).length,
-            pendingPrompts: allPrompts.filter((p) => !p.executed).length,
-            stalePrompts: allPrompts.filter((p) => (p.ageInDays || 0) > 30).length,
-            oldPrompts: allPrompts.filter((p) => (p.ageInDays || 0) > 7).length,
-            oldestPromptAge: allPrompts.length > 0 ? Math.max(...allPrompts.map((p) => p.ageInDays || 0)) : 0,
-        };
-        return stats;
-    }
-    /**
-     * v4.11: Load unified index from file
-     */
-    async loadIndex() {
-        const indexPath = this.getIndexPath();
-        if (!(await fs.pathExists(indexPath))) {
-            return {
-                version: '2.0', // v4.11: New version for unified index
-                prompts: [],
-            };
-        }
-        try {
-            const content = await fs.readFile(indexPath, 'utf-8');
-            const parsed = JSON.parse(content);
-            // Ensure prompts array exists
-            return {
-                version: parsed.version || '2.0',
-                prompts: Array.isArray(parsed.prompts) ? parsed.prompts : [],
-            };
-        }
-        catch {
-            // Corrupt index, return empty
-            return {
-                version: '2.0',
-                prompts: [],
-            };
-        }
-    }
-    /**
-     * v4.11: Save unified index to file
-     */
-    async saveIndex(index) {
-        const indexPath = this.getIndexPath();
-        await fs.ensureDir(path.dirname(indexPath));
-        await fs.writeFile(indexPath, JSON.stringify(index, null, 2), 'utf-8');
-    }
-    /**
-     * v4.11: Add prompt to unified index
-     */
-    async addToIndex(metadata) {
-        const index = await this.loadIndex();
-        // Remove any existing entry with same ID (shouldn't happen, but be safe)
-        index.prompts = index.prompts.filter((p) => p.id !== metadata.id);
-        // Add new entry
-        index.prompts.push(metadata);
-        await this.saveIndex(index);
-    }
-}
-//# sourceMappingURL=prompt-manager.js.map