clavix 2.7.0 → 2.8.0

package/dist/core/question-engine.d 2.ts

@@ -1,167 +0,0 @@
-/**
- * QuestionEngine - Manages Socratic questioning flows for PRD generation
- *
- * This class handles:
- * - Loading question templates
- * - Sequential and conditional question flows
- * - Answer collection and validation
- * - Progress tracking
- */
-/**
- * Type of question input
- */
-export type QuestionType = 'text' | 'list' | 'confirm';
-/**
- * A single question in the flow
- */
-export interface Question {
-    id: string;
-    text: string;
-    type: QuestionType;
-    required: boolean;
-    choices?: string[];
-    default?: string | boolean;
-    validate?: (answer: string) => boolean | string;
-    condition?: (answers: Record<string, Answer>) => boolean;
-}
-/**
- * Answer to a question
- */
-export type Answer = string | boolean | string[];
-/**
- * Collection of answers keyed by question ID
- */
-export interface Answers {
-    [questionId: string]: Answer;
-}
-/**
- * Question flow configuration
- */
-export interface QuestionFlow {
-    name: string;
-    description: string;
-    questions: Question[];
-}
-/**
- * Progress information for multi-question flows
- */
-export interface QuestionProgress {
-    current: number;
-    total: number;
-    percentage: number;
-}
-/**
- * QuestionEngine class
- *
- * Manages the flow of questions, answer collection, and validation
- */
-export declare class QuestionEngine {
-    private currentFlow;
-    private answers;
-    private currentQuestionIndex;
-    /**
-     * Load a question flow from a template file
-     *
-     * @param templatePath - Path to the question template
-     * @returns The loaded question flow
-     */
-    loadFlow(templatePath: string): Promise<QuestionFlow>;
-    /**
-     * Parse a question template into a QuestionFlow
-     *
-     * Template format:
-     * ```markdown
-     * # Flow Name
-     *
-     * Flow description
-     *
-     * ## Question 1
-     *
-     * **text:** What problem are you solving?
-     * **type:** text
-     * **required:** true
-     * **validation:** minLength:10
-     *
-     * ## Question 2
-     *
-     * **text:** Select your technology stack
-     * **type:** list
-     * **choices:** React, Vue, Angular, Other
-     * ```
-     *
-     * @param template - Template content
-     * @returns Parsed QuestionFlow
-     */
-    private parseTemplate;
-    /**
-     * Parse a single metadata field for a question
-     */
-    private parseQuestionMetadata;
-    /**
-     * Finalize a question by setting defaults and generating ID
-     */
-    private finalizeQuestion;
-    /**
-     * Create a validation function from a validation string
-     *
-     * Supported formats:
-     * - minLength:10 - Minimum length
-     * - maxLength:100 - Maximum length
-     * - pattern:^[a-z]+$ - Regex pattern
-     * - email - Email validation
-     * - url - URL validation
-     */
-    private createValidator;
-    /**
-     * Create a condition function from a condition string
-     *
-     * Supported formats:
-     * - q1=true - Question 1 answer equals true
-     * - q2=JWT - Question 2 answer equals "JWT"
-     * - q3!=None - Question 3 answer not equals "None"
-     */
-    private createCondition;
-    /**
-     * Get the next question in the flow
-     *
-     * @returns The next question, or null if flow is complete
-     */
-    getNextQuestion(): Question | null;
-    /**
-     * Submit an answer to the current question
-     *
-     * @param questionId - ID of the question being answered
-     * @param answer - The answer
-     * @returns Validation result (true if valid, error message if invalid)
-     */
-    submitAnswer(questionId: string, answer: Answer): boolean | string;
-    /**
-     * Get all collected answers
-     *
-     * @returns All answers collected so far
-     */
-    getAnswers(): Answers;
-    /**
-     * Get current progress through the question flow
-     *
-     * @returns Progress information
-     */
-    getProgress(): QuestionProgress;
-    /**
-     * Check if the question flow is complete
-     *
-     * @returns True if all required questions are answered
-     */
-    isComplete(): boolean;
-    /**
-     * Reset the question flow
-     */
-    reset(): void;
-    /**
-     * Get the current question flow
-     *
-     * @returns The loaded question flow, or null if none loaded
-     */
-    getCurrentFlow(): QuestionFlow | null;
-}
-//# sourceMappingURL=question-engine.d.ts.map

package/dist/core/session-manager 2.js

@@ -1,403 +0,0 @@
-"use strict";
-/**
- * SessionManager - Manages conversational sessions for clavix start/summarize
- *
- * This class handles:
- * - Session creation with unique IDs
- * - Message tracking and storage
- * - Session file persistence (JSON format)
- * - Session listing, filtering, and search
- * - CRUD operations for sessions
- *
- * Sessions are stored in `.clavix/sessions/` as JSON files:
- * `.clavix/sessions/{session-id}.json`
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionManager = void 0;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-const file_system_1 = require("../utils/file-system");
-// Use require for uuid to avoid Jest ESM issues
-// eslint-disable-next-line @typescript-eslint/no-require-imports
-const { v4: uuidv4 } = require('uuid');
-/**
- * SessionManager class
- *
- * Manages all session-related operations including creation, storage,
- * retrieval, listing, and search functionality.
- */
-class SessionManager {
-    constructor(sessionsDir) {
-        this.defaultSessionsDir = '.clavix/sessions';
-        this.sessionsDir = sessionsDir || this.defaultSessionsDir;
-    }
-    /**
-     * Create a new session
-     *
-     * @param options - Session creation options
-     * @returns The created session
-     */
-    async createSession(options = {}) {
-        const now = new Date();
-        const session = {
-            id: uuidv4(),
-            projectName: options.projectName || this.generateDefaultProjectName(),
-            agent: options.agent || 'Claude Code',
-            created: now,
-            updated: now,
-            status: 'active',
-            messages: [],
-            tags: options.tags,
-            description: options.description,
-        };
-        await this.saveSession(session);
-        return session;
-    }
-    /**
-     * Get a session by ID
-     *
-     * @param sessionId - The session ID
-     * @returns The session, or null if not found
-     */
-    async getSession(sessionId) {
-        try {
-            const sessionPath = this.getSessionPath(sessionId);
-            const exists = await fs.pathExists(sessionPath);
-            if (!exists) {
-                return null;
-            }
-            const serialized = await fs.readJSON(sessionPath);
-            return this.deserializeSession(serialized);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Save a session to disk
-     *
-     * @param session - The session to save
-     */
-    async saveSession(session) {
-        await file_system_1.FileSystem.ensureDir(this.sessionsDir);
-        const sessionPath = this.getSessionPath(session.id);
-        const serialized = this.serializeSession(session);
-        // Use atomic write to prevent corruption
-        await file_system_1.FileSystem.writeFileAtomic(sessionPath, JSON.stringify(serialized, null, 2));
-    }
-    /**
-     * Update a session
-     *
-     * @param sessionId - The session ID
-     * @param updates - Partial session updates
-     * @returns The updated session, or null if not found
-     */
-    async updateSession(sessionId, updates) {
-        const session = await this.getSession(sessionId);
-        if (!session) {
-            return null;
-        }
-        const updatedSession = {
-            ...session,
-            ...updates,
-            id: session.id,
-            created: session.created,
-            updated: new Date(),
-        };
-        await this.saveSession(updatedSession);
-        return updatedSession;
-    }
-    /**
-     * Delete a session
-     *
-     * @param sessionId - The session ID
-     * @returns True if deleted, false if not found
-     */
-    async deleteSession(sessionId) {
-        const sessionPath = this.getSessionPath(sessionId);
-        const exists = await fs.pathExists(sessionPath);
-        if (!exists) {
-            return false;
-        }
-        await fs.remove(sessionPath);
-        return true;
-    }
-    /**
-     * Add a message to a session
-     *
-     * @param sessionId - The session ID
-     * @param role - Message role (user or assistant)
-     * @param content - Message content
-     * @returns The updated session, or null if session not found
-     */
-    async addMessage(sessionId, role, content) {
-        const session = await this.getSession(sessionId);
-        if (!session) {
-            return null;
-        }
-        const message = {
-            role,
-            content,
-            timestamp: new Date(),
-        };
-        session.messages.push(message);
-        session.updated = new Date();
-        await this.saveSession(session);
-        return session;
-    }
-    /**
-     * List all sessions with optional filtering
-     *
-     * @param filter - Optional filter criteria
-     * @returns Array of session metadata
-     */
-    async listSessions(filter) {
-        await file_system_1.FileSystem.ensureDir(this.sessionsDir);
-        const files = await fs.readdir(this.sessionsDir);
-        const sessionFiles = files.filter((f) => f.endsWith('.json'));
-        const sessions = [];
-        for (const file of sessionFiles) {
-            try {
-                const sessionPath = path.join(this.sessionsDir, file);
-                const serialized = await fs.readJSON(sessionPath);
-                const metadata = this.extractMetadata(serialized);
-                // Apply filters
-                if (filter && !this.matchesFilter(metadata, filter)) {
-                    continue;
-                }
-                sessions.push(metadata);
-            }
-            catch {
-                // Skip corrupted session files
-                continue;
-            }
-        }
-        // Sort by updated date (most recent first)
-        sessions.sort((a, b) => {
-            return new Date(b.updated).getTime() - new Date(a.updated).getTime();
-        });
-        return sessions;
-    }
-    /**
-     * Search sessions by keyword
-     *
-     * Searches in project name, description, tags, and message content
-     *
-     * @param keyword - Search keyword
-     * @returns Array of matching session metadata
-     */
-    async searchSessions(keyword) {
-        await file_system_1.FileSystem.ensureDir(this.sessionsDir);
-        const files = await fs.readdir(this.sessionsDir);
-        const sessionFiles = files.filter((f) => f.endsWith('.json'));
-        const matches = [];
-        const lowerKeyword = keyword.toLowerCase();
-        for (const file of sessionFiles) {
-            try {
-                const sessionPath = path.join(this.sessionsDir, file);
-                const serialized = await fs.readJSON(sessionPath);
-                // Search in project name
-                if (serialized.projectName.toLowerCase().includes(lowerKeyword)) {
-                    matches.push(this.extractMetadata(serialized));
-                    continue;
-                }
-                // Search in description
-                if (serialized.description?.toLowerCase().includes(lowerKeyword)) {
-                    matches.push(this.extractMetadata(serialized));
-                    continue;
-                }
-                // Search in tags
-                if (serialized.tags?.some((tag) => tag.toLowerCase().includes(lowerKeyword))) {
-                    matches.push(this.extractMetadata(serialized));
-                    continue;
-                }
-                // Search in message content
-                const hasMessageMatch = serialized.messages.some((msg) => msg.content.toLowerCase().includes(lowerKeyword));
-                if (hasMessageMatch) {
-                    matches.push(this.extractMetadata(serialized));
-                }
-            }
-            catch {
-                // Skip corrupted session files
-                continue;
-            }
-        }
-        // Sort by updated date (most recent first)
-        matches.sort((a, b) => {
-            return new Date(b.updated).getTime() - new Date(a.updated).getTime();
-        });
-        return matches;
-    }
-    /**
-     * Get the most recent active session
-     *
-     * @returns The active session, or null if none exists
-     */
-    async getActiveSession() {
-        const activeSessions = await this.listSessions({ status: 'active' });
-        if (activeSessions.length === 0) {
-            return null;
-        }
-        // Return the most recently updated active session
-        return this.getSession(activeSessions[0].id);
-    }
-    /**
-     * Mark a session as completed
-     *
-     * @param sessionId - The session ID
-     * @returns The updated session, or null if not found
-     */
-    async completeSession(sessionId) {
-        return this.updateSession(sessionId, { status: 'completed' });
-    }
-    /**
-     * Mark a session as archived
-     *
-     * @param sessionId - The session ID
-     * @returns The updated session, or null if not found
-     */
-    async archiveSession(sessionId) {
-        return this.updateSession(sessionId, { status: 'archived' });
-    }
-    /**
-     * Get the path to a session file
-     */
-    getSessionPath(sessionId) {
-        return path.join(this.sessionsDir, `${sessionId}.json`);
-    }
-    /**
-     * Generate a default project name based on timestamp
-     */
-    generateDefaultProjectName() {
-        const date = new Date();
-        const timestamp = date.toISOString().split('T')[0]; // YYYY-MM-DD
-        return `session-${timestamp}`;
-    }
-    /**
-     * Serialize a session for file storage
-     */
-    serializeSession(session) {
-        return {
-            id: session.id,
-            projectName: session.projectName,
-            agent: session.agent,
-            created: session.created.toISOString(),
-            updated: session.updated.toISOString(),
-            status: session.status,
-            messages: session.messages.map((msg) => ({
-                role: msg.role,
-                content: msg.content,
-                timestamp: msg.timestamp.toISOString(),
-            })),
-            tags: session.tags,
-            description: session.description,
-        };
-    }
-    /**
-     * Deserialize a session from file storage
-     */
-    deserializeSession(serialized) {
-        return {
-            id: serialized.id,
-            projectName: serialized.projectName,
-            agent: serialized.agent,
-            created: new Date(serialized.created),
-            updated: new Date(serialized.updated),
-            status: serialized.status,
-            messages: serialized.messages.map((msg) => ({
-                role: msg.role,
-                content: msg.content,
-                timestamp: new Date(msg.timestamp),
-            })),
-            tags: serialized.tags,
-            description: serialized.description,
-        };
-    }
-    /**
-     * Extract metadata from a serialized session
-     */
-    extractMetadata(serialized) {
-        return {
-            id: serialized.id,
-            projectName: serialized.projectName,
-            agent: serialized.agent,
-            created: serialized.created,
-            updated: serialized.updated,
-            status: serialized.status,
-            messageCount: serialized.messages.length,
-            tags: serialized.tags,
-            description: serialized.description,
-        };
-    }
-    /**
-     * Check if session metadata matches filter criteria
-     */
-    matchesFilter(metadata, filter) {
-        // Status filter
-        if (filter.status && metadata.status !== filter.status) {
-            return false;
-        }
-        // Project name filter
-        if (filter.projectName && metadata.projectName !== filter.projectName) {
-            return false;
-        }
-        // Agent filter
-        if (filter.agent && metadata.agent !== filter.agent) {
-            return false;
-        }
-        // Tags filter (session must have ALL specified tags)
-        if (filter.tags && filter.tags.length > 0) {
-            if (!metadata.tags || metadata.tags.length === 0) {
-                return false;
-            }
-            const hasAllTags = filter.tags.every((tag) => metadata.tags.includes(tag));
-            if (!hasAllTags) {
-                return false;
-            }
-        }
-        // Date range filters
-        const updatedDate = new Date(metadata.updated);
-        if (filter.startDate && updatedDate < filter.startDate) {
-            return false;
-        }
-        if (filter.endDate && updatedDate > filter.endDate) {
-            return false;
-        }
-        return true;
-    }
-}
-exports.SessionManager = SessionManager;
-//# sourceMappingURL=session-manager.js.map

package/dist/core/session-manager.d 2.ts

@@ -1,139 +0,0 @@
-/**
- * SessionManager - Manages conversational sessions for clavix start/summarize
- *
- * This class handles:
- * - Session creation with unique IDs
- * - Message tracking and storage
- * - Session file persistence (JSON format)
- * - Session listing, filtering, and search
- * - CRUD operations for sessions
- *
- * Sessions are stored in `.clavix/sessions/` as JSON files:
- * `.clavix/sessions/{session-id}.json`
- */
-import { Session, SessionMetadata, SessionFilter } from '../types/session';
-/**
- * Options for creating a new session
- */
-export interface CreateSessionOptions {
-    projectName?: string;
-    agent?: string;
-    description?: string;
-    tags?: string[];
-}
-/**
- * SessionManager class
- *
- * Manages all session-related operations including creation, storage,
- * retrieval, listing, and search functionality.
- */
-export declare class SessionManager {
-    private readonly sessionsDir;
-    private readonly defaultSessionsDir;
-    constructor(sessionsDir?: string);
-    /**
-     * Create a new session
-     *
-     * @param options - Session creation options
-     * @returns The created session
-     */
-    createSession(options?: CreateSessionOptions): Promise<Session>;
-    /**
-     * Get a session by ID
-     *
-     * @param sessionId - The session ID
-     * @returns The session, or null if not found
-     */
-    getSession(sessionId: string): Promise<Session | null>;
-    /**
-     * Save a session to disk
-     *
-     * @param session - The session to save
-     */
-    saveSession(session: Session): Promise<void>;
-    /**
-     * Update a session
-     *
-     * @param sessionId - The session ID
-     * @param updates - Partial session updates
-     * @returns The updated session, or null if not found
-     */
-    updateSession(sessionId: string, updates: Partial<Omit<Session, 'id' | 'created'>>): Promise<Session | null>;
-    /**
-     * Delete a session
-     *
-     * @param sessionId - The session ID
-     * @returns True if deleted, false if not found
-     */
-    deleteSession(sessionId: string): Promise<boolean>;
-    /**
-     * Add a message to a session
-     *
-     * @param sessionId - The session ID
-     * @param role - Message role (user or assistant)
-     * @param content - Message content
-     * @returns The updated session, or null if session not found
-     */
-    addMessage(sessionId: string, role: 'user' | 'assistant', content: string): Promise<Session | null>;
-    /**
-     * List all sessions with optional filtering
-     *
-     * @param filter - Optional filter criteria
-     * @returns Array of session metadata
-     */
-    listSessions(filter?: SessionFilter): Promise<SessionMetadata[]>;
-    /**
-     * Search sessions by keyword
-     *
-     * Searches in project name, description, tags, and message content
-     *
-     * @param keyword - Search keyword
-     * @returns Array of matching session metadata
-     */
-    searchSessions(keyword: string): Promise<SessionMetadata[]>;
-    /**
-     * Get the most recent active session
-     *
-     * @returns The active session, or null if none exists
-     */
-    getActiveSession(): Promise<Session | null>;
-    /**
-     * Mark a session as completed
-     *
-     * @param sessionId - The session ID
-     * @returns The updated session, or null if not found
-     */
-    completeSession(sessionId: string): Promise<Session | null>;
-    /**
-     * Mark a session as archived
-     *
-     * @param sessionId - The session ID
-     * @returns The updated session, or null if not found
-     */
-    archiveSession(sessionId: string): Promise<Session | null>;
-    /**
-     * Get the path to a session file
-     */
-    private getSessionPath;
-    /**
-     * Generate a default project name based on timestamp
-     */
-    private generateDefaultProjectName;
-    /**
-     * Serialize a session for file storage
-     */
-    private serializeSession;
-    /**
-     * Deserialize a session from file storage
-     */
-    private deserializeSession;
-    /**
-     * Extract metadata from a serialized session
-     */
-    private extractMetadata;
-    /**
-     * Check if session metadata matches filter criteria
-     */
-    private matchesFilter;
-}
-//# sourceMappingURL=session-manager.d.ts.map