popeye-cli 1.0.1 → 1.2.0

package/dist/workflow/workflow-logger.js

@@ -0,0 +1,267 @@
+/**
+ * Workflow Logger
+ * Provides persistent logging of all workflow stages for transparency and debugging
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+/**
+ * Workflow logger class that persists logs to the project's docs folder
+ */
+export class WorkflowLogger {
+    projectDir;
+    logFile;
+    entries = [];
+    initialized = false;
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+        this.logFile = path.join(projectDir, 'docs', 'WORKFLOW_LOG.md');
+    }
+    /**
+     * Initialize the logger and load existing entries
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        const docsDir = path.join(this.projectDir, 'docs');
+        try {
+            await fs.mkdir(docsDir, { recursive: true });
+            // Check if log file exists
+            try {
+                const content = await fs.readFile(this.logFile, 'utf-8');
+                // Parse existing entries from the file
+                this.entries = this.parseExistingLog(content);
+            }
+            catch {
+                // File doesn't exist yet, start fresh
+                this.entries = [];
+            }
+            this.initialized = true;
+        }
+        catch (error) {
+            console.error('Failed to initialize workflow logger:', error);
+        }
+    }
+    /**
+     * Parse existing log entries from markdown file
+     */
+    parseExistingLog(content) {
+        const entries = [];
+        // Parse entries from the markdown format
+        const entryRegex = /### \[(\d{4}-\d{2}-\d{2}T[^\]]+)\] \[([^\]]+)\] \[([^\]]+)\] ([^\n]+)\n([\s\S]*?)(?=### \[|## Session|$)/g;
+        let match;
+        while ((match = entryRegex.exec(content)) !== null) {
+            try {
+                const entry = {
+                    timestamp: match[1],
+                    level: match[2],
+                    stage: match[3],
+                    event: '',
+                    message: match[4].trim(),
+                };
+                // Try to parse data if present
+                const dataMatch = match[5]?.match(/```json\n([\s\S]*?)\n```/);
+                if (dataMatch) {
+                    try {
+                        entry.data = JSON.parse(dataMatch[1]);
+                    }
+                    catch {
+                        // Ignore JSON parse errors
+                    }
+                }
+                entries.push(entry);
+            }
+            catch {
+                // Skip malformed entries
+            }
+        }
+        return entries;
+    }
+    /**
+     * Log an entry to the workflow log
+     */
+    async log(stage, event, message, data, level = 'info') {
+        await this.initialize();
+        const entry = {
+            timestamp: new Date().toISOString(),
+            stage,
+            event,
+            message,
+            data,
+            level,
+        };
+        this.entries.push(entry);
+        await this.persist();
+    }
+    /**
+     * Log info message
+     */
+    async info(stage, event, message, data) {
+        await this.log(stage, event, message, data, 'info');
+    }
+    /**
+     * Log warning message
+     */
+    async warn(stage, event, message, data) {
+        await this.log(stage, event, message, data, 'warn');
+    }
+    /**
+     * Log error message
+     */
+    async error(stage, event, message, data) {
+        await this.log(stage, event, message, data, 'error');
+    }
+    /**
+     * Log success message
+     */
+    async success(stage, event, message, data) {
+        await this.log(stage, event, message, data, 'success');
+    }
+    /**
+     * Log stage start
+     */
+    async stageStart(stage, description, data) {
+        await this.info(stage, 'stage_start', `Starting: ${description}`, data);
+    }
+    /**
+     * Log stage completion
+     */
+    async stageComplete(stage, description, data) {
+        await this.success(stage, 'stage_complete', `Completed: ${description}`, data);
+    }
+    /**
+     * Log stage failure
+     */
+    async stageFailed(stage, description, error, data) {
+        await this.error(stage, 'stage_failed', `Failed: ${description} - ${error}`, data);
+    }
+    /**
+     * Persist log entries to file
+     */
+    async persist() {
+        try {
+            const content = this.formatMarkdown();
+            await fs.writeFile(this.logFile, content, 'utf-8');
+        }
+        catch (error) {
+            console.error('Failed to persist workflow log:', error);
+        }
+    }
+    /**
+     * Format log entries as markdown
+     */
+    formatMarkdown() {
+        const lines = [
+            '# Workflow Execution Log',
+            '',
+            'This file tracks all stages of the Popeye workflow execution for transparency and debugging.',
+            '',
+            '---',
+            '',
+        ];
+        // Group entries by date
+        const entriesByDate = new Map();
+        for (const entry of this.entries) {
+            const date = entry.timestamp.split('T')[0];
+            if (!entriesByDate.has(date)) {
+                entriesByDate.set(date, []);
+            }
+            entriesByDate.get(date).push(entry);
+        }
+        // Write entries grouped by date
+        for (const [date, dateEntries] of entriesByDate) {
+            lines.push(`## Session: ${date}`);
+            lines.push('');
+            for (const entry of dateEntries) {
+                const levelIcon = this.getLevelIcon(entry.level);
+                const time = entry.timestamp.split('T')[1].split('.')[0];
+                lines.push(`### [${time}] ${levelIcon} **${entry.stage}** - ${entry.message}`);
+                if (entry.data && Object.keys(entry.data).length > 0) {
+                    lines.push('');
+                    lines.push('<details>');
+                    lines.push('<summary>Details</summary>');
+                    lines.push('');
+                    lines.push('```json');
+                    lines.push(JSON.stringify(entry.data, null, 2));
+                    lines.push('```');
+                    lines.push('</details>');
+                }
+                lines.push('');
+            }
+        }
+        // Add summary statistics
+        lines.push('---');
+        lines.push('');
+        lines.push('## Summary Statistics');
+        lines.push('');
+        lines.push(`- **Total Entries:** ${this.entries.length}`);
+        lines.push(`- **Errors:** ${this.entries.filter(e => e.level === 'error').length}`);
+        lines.push(`- **Warnings:** ${this.entries.filter(e => e.level === 'warn').length}`);
+        lines.push(`- **Successful Steps:** ${this.entries.filter(e => e.level === 'success').length}`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Get icon for log level
+     */
+    getLevelIcon(level) {
+        switch (level) {
+            case 'error':
+                return '[ERROR]';
+            case 'warn':
+                return '[WARN]';
+            case 'success':
+                return '[OK]';
+            case 'debug':
+                return '[DEBUG]';
+            default:
+                return '[INFO]';
+        }
+    }
+    /**
+     * Get all log entries
+     */
+    getEntries() {
+        return [...this.entries];
+    }
+    /**
+     * Get entries for a specific stage
+     */
+    getEntriesForStage(stage) {
+        return this.entries.filter(e => e.stage === stage);
+    }
+    /**
+     * Get error entries
+     */
+    getErrors() {
+        return this.entries.filter(e => e.level === 'error');
+    }
+    /**
+     * Clear the log (for testing or reset)
+     */
+    async clear() {
+        this.entries = [];
+        await this.persist();
+    }
+}
+/**
+ * Global logger instances cache
+ */
+const loggerCache = new Map();
+/**
+ * Get or create a workflow logger for a project
+ */
+export function getWorkflowLogger(projectDir) {
+    const normalizedPath = path.resolve(projectDir);
+    if (!loggerCache.has(normalizedPath)) {
+        loggerCache.set(normalizedPath, new WorkflowLogger(normalizedPath));
+    }
+    return loggerCache.get(normalizedPath);
+}
+/**
+ * Quick logging functions for common use cases
+ */
+export async function logWorkflowEvent(projectDir, stage, event, message, data, level = 'info') {
+    const logger = getWorkflowLogger(projectDir);
+    await logger.log(stage, event, message, data, level);
+}
+//# sourceMappingURL=workflow-logger.js.map

package/dist/workflow/workflow-logger.js.map

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

package/dist/workflow/workspace-manager.d.ts

@@ -0,0 +1,342 @@
+/**
+ * Workspace manager module
+ * Handles loading, saving, and querying workspace configuration for fullstack projects
+ * Also provides app-specific context for AI reviews
+ */
+import type { WorkspaceConfig, WorkspaceApp } from '../types/project.js';
+import type { ReviewAppTarget } from '../types/consensus.js';
+/**
+ * Context for AI review of a specific app
+ */
+export interface AppReviewContext {
+    appName: 'frontend' | 'backend';
+    language: 'python' | 'typescript';
+    path: string;
+    /** Key source files content for review */
+    sourceFiles: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** UI spec for frontend */
+    uiSpec?: string;
+    /** API contracts (OpenAPI) */
+    apiContracts?: string;
+    /** Test file content */
+    testFiles?: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Dependencies (package.json or pyproject.toml) */
+    dependencies?: string;
+}
+/**
+ * Combined review context for fullstack projects
+ */
+export interface FullstackReviewContext {
+    frontend?: AppReviewContext;
+    backend?: AppReviewContext;
+    /** Shared contracts (OpenAPI spec) */
+    contracts?: string;
+    /** Project-level context */
+    projectName: string;
+    projectIdea?: string;
+}
+/**
+ * Workspace manager class
+ */
+export declare class WorkspaceManager {
+    private projectDir;
+    private config;
+    constructor(projectDir: string);
+    /**
+     * Get the path to workspace.json
+     */
+    private getWorkspacePath;
+    /**
+     * Check if this is a workspace project
+     */
+    isWorkspaceProject(): Promise<boolean>;
+    /**
+     * Load workspace configuration
+     */
+    load(): Promise<WorkspaceConfig | null>;
+    /**
+     * Save workspace configuration
+     */
+    save(config: WorkspaceConfig): Promise<void>;
+    /**
+     * Get the loaded configuration
+     */
+    getConfig(): WorkspaceConfig | null;
+    /**
+     * Get a specific app configuration
+     */
+    getApp(appName: 'frontend' | 'backend'): WorkspaceApp | undefined;
+    /**
+     * Get the absolute path to an app
+     */
+    getAppPath(appName: 'frontend' | 'backend'): string | null;
+    /**
+     * Get all app names
+     */
+    getAppNames(): ('frontend' | 'backend')[];
+    /**
+     * Get test command for a specific app
+     */
+    getTestCommand(appName: 'frontend' | 'backend'): string | null;
+    /**
+     * Get all test commands (returns object with app names as keys)
+     */
+    getAllTestCommands(): Record<string, {
+        path: string;
+        command: string;
+    }>;
+    /**
+     * Get the combined test-all command
+     */
+    getTestAllCommand(): string | null;
+    /**
+     * Get lint command for a specific app
+     */
+    getLintCommand(appName: 'frontend' | 'backend'): string | null;
+    /**
+     * Get all lint commands
+     */
+    getAllLintCommands(): Record<string, {
+        path: string;
+        command: string;
+    }>;
+    /**
+     * Get the combined lint-all command
+     */
+    getLintAllCommand(): string | null;
+    /**
+     * Get build command for a specific app
+     */
+    getBuildCommand(appName: 'frontend' | 'backend'): string | null;
+    /**
+     * Get all build commands
+     */
+    getAllBuildCommands(): Record<string, {
+        path: string;
+        command: string;
+    }>;
+    /**
+     * Get the combined build-all command
+     */
+    getBuildAllCommand(): string | null;
+    /**
+     * Get dev command for a specific app
+     */
+    getDevCommand(appName: 'frontend' | 'backend'): string | null;
+    /**
+     * Get all dev commands
+     */
+    getAllDevCommands(): Record<string, {
+        path: string;
+        command: string;
+    }>;
+    /**
+     * Get the combined dev-all command (usually docker-compose up)
+     */
+    getDevAllCommand(): string | null;
+    /**
+     * Get docker-compose path
+     */
+    getDockerComposePath(): string | null;
+    /**
+     * Get context roots for an app (files to include in AI context)
+     */
+    getContextRoots(appName: 'frontend' | 'backend'): string[];
+    /**
+     * Get UI spec path (for frontend)
+     */
+    getUiSpecPath(): string | null;
+    /**
+     * Get contracts path (OpenAPI spec)
+     */
+    getContractsPath(): string | null;
+    /**
+     * Get app language
+     */
+    getAppLanguage(appName: 'frontend' | 'backend'): 'python' | 'typescript' | null;
+    /**
+     * Determine which app should handle a file based on path
+     */
+    getAppForFile(filePath: string): 'frontend' | 'backend' | null;
+    /**
+     * Get review context for a specific app
+     * Reads key files from contextRoots to provide to AI reviewers
+     */
+    getAppReviewContext(appName: 'frontend' | 'backend', options?: {
+        maxFiles?: number;
+        maxFileSize?: number;
+        includeTests?: boolean;
+    }): Promise<AppReviewContext | null>;
+    /**
+     * Get combined review context for fullstack project
+     */
+    getFullstackReviewContext(projectName: string, projectIdea?: string, options?: {
+        maxFilesPerApp?: number;
+        includeTests?: boolean;
+    }): Promise<FullstackReviewContext>;
+    /**
+     * Format app context for AI review prompt
+     */
+    formatContextForReview(context: AppReviewContext): string;
+    /**
+     * Format fullstack context for review prompt
+     */
+    formatFullstackContextForReview(context: FullstackReviewContext): string;
+    /**
+     * Determine review app target based on plan content
+     * Analyzes plan text to determine if it's frontend, backend, or unified
+     */
+    categorizeByPlanContent(planContent: string): ReviewAppTarget;
+    /**
+     * Read directory recursively and return file contents
+     */
+    private readDirectoryRecursive;
+    /**
+     * Find test files in a directory
+     */
+    private findTestFiles;
+    /**
+     * Get feedback document paths for workspace
+     */
+    getFeedbackPaths(): {
+        master: {
+            unified: string;
+            frontend: string;
+            backend: string;
+        };
+        getMilestonePaths: (milestoneId: string) => {
+            unified: string;
+            frontend: string;
+            backend: string;
+        };
+        getTaskPaths: (milestoneId: string, taskId: string) => {
+            unified: string;
+            frontend: string;
+            backend: string;
+        };
+    };
+}
+/**
+ * Load workspace configuration from a project directory
+ *
+ * @param projectDir - Project directory
+ * @returns WorkspaceConfig or null if not a workspace project
+ */
+export declare function loadWorkspace(projectDir: string): Promise<WorkspaceConfig | null>;
+/**
+ * Save workspace configuration to a project directory
+ *
+ * @param projectDir - Project directory
+ * @param config - Workspace configuration
+ */
+export declare function saveWorkspace(projectDir: string, config: WorkspaceConfig): Promise<void>;
+/**
+ * Check if a directory is a workspace project
+ *
+ * @param projectDir - Project directory
+ * @returns True if workspace project
+ */
+export declare function isWorkspaceProject(projectDir: string): Promise<boolean>;
+/**
+ * Get app context for AI code generation
+ *
+ * @param projectDir - Project directory
+ * @param appName - App name
+ * @returns Object with app info and context files
+ */
+export declare function getAppContext(projectDir: string, appName: 'frontend' | 'backend'): Promise<{
+    app: WorkspaceApp | undefined;
+    language: 'python' | 'typescript' | null;
+    contextRoots: string[];
+    path: string | null;
+} | null>;
+/**
+ * Get test commands for workspace
+ *
+ * @param projectDir - Project directory
+ * @returns Test commands per app and combined command
+ */
+export declare function getTestCommands(projectDir: string): Promise<{
+    perApp: Record<string, {
+        path: string;
+        command: string;
+    }>;
+    combined: string | null;
+} | null>;
+/**
+ * Get build commands for workspace
+ *
+ * @param projectDir - Project directory
+ * @returns Build commands per app and combined command
+ */
+export declare function getBuildCommands(projectDir: string): Promise<{
+    perApp: Record<string, {
+        path: string;
+        command: string;
+    }>;
+    combined: string | null;
+} | null>;
+/**
+ * Get app-specific review context
+ *
+ * @param projectDir - Project directory
+ * @param appName - App name (frontend or backend)
+ * @returns Review context with source files and metadata
+ */
+export declare function getAppReviewContext(projectDir: string, appName: 'frontend' | 'backend'): Promise<AppReviewContext | null>;
+/**
+ * Get fullstack review context for AI reviews
+ *
+ * @param projectDir - Project directory
+ * @param projectName - Project name
+ * @param projectIdea - Original project idea
+ * @returns Combined review context for both apps
+ */
+export declare function getFullstackReviewContext(projectDir: string, projectName: string, projectIdea?: string): Promise<FullstackReviewContext | null>;
+/**
+ * Format context for AI review prompt
+ *
+ * @param projectDir - Project directory
+ * @param projectName - Project name
+ * @param projectIdea - Original project idea
+ * @returns Formatted string for AI review
+ */
+export declare function formatContextForAIReview(projectDir: string, projectName: string, projectIdea?: string): Promise<string | null>;
+/**
+ * Categorize a task/plan as frontend, backend, or unified
+ *
+ * @param projectDir - Project directory
+ * @param planContent - Plan or task content to analyze
+ * @returns App target category
+ */
+export declare function categorizePlanContent(projectDir: string, planContent: string): Promise<ReviewAppTarget>;
+/**
+ * Get feedback paths for a workspace project
+ *
+ * @param projectDir - Project directory
+ * @returns Object with feedback path getters
+ */
+export declare function getWorkspaceFeedbackPaths(projectDir: string): Promise<{
+    master: {
+        unified: string;
+        frontend: string;
+        backend: string;
+    };
+    getMilestonePaths: (milestoneId: string) => {
+        unified: string;
+        frontend: string;
+        backend: string;
+    };
+    getTaskPaths: (milestoneId: string, taskId: string) => {
+        unified: string;
+        frontend: string;
+        backend: string;
+    };
+} | null>;
+//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/workflow/workspace-manager.d.ts.map

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