popeye-cli 1.1.0 → 1.2.0

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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"}