edsger 0.2.3 → 0.2.5

package/dist/workflow-runner/executors/phase-executor.js

@@ -4,10 +4,13 @@
 import { updateFeatureStatusForPhase } from '../../api/features/index.js';
 import { phaseConfigs } from '../config/phase-configs.js';
 import { getChecklistsForPhase, validateChecklistsForPhase, validateRequiredChecklistResults, processChecklistResultsFromResponse, processChecklistItemResultsFromResponse, } from '../../services/checklist.js';
+import { logFeaturePhaseEvent } from '../../services/audit-logs.js';
 // Higher-order function for phase execution
 export const createPhaseRunner = (phaseConfig) => async (options, config) => {
     const { featureId, mcpServerUrl, mcpToken, verbose } = options;
     const { name, checkRequirements, execute, requirementsError } = phaseConfig;
+    // Track phase duration for logging
+    const phaseStartTime = Date.now();
     try {
         // Check requirements
         const hasRequirements = await checkRequirements();
@@ -24,6 +27,16 @@ export const createPhaseRunner = (phaseConfig) => async (options, config) => {
         if (verbose) {
             console.log(`🎯 Starting ${name} for: ${featureId}`);
         }
+        // Log phase start
+        await logFeaturePhaseEvent(mcpServerUrl, mcpToken, {
+            featureId,
+            eventType: 'phase_started',
+            phase: name.replace(/-/g, '_'),
+            result: 'info',
+            metadata: {
+                timestamp: new Date().toISOString(),
+            },
+        }, verbose);
         // Fetch checklists for this phase as context
         let checklistContext = null;
         try {
@@ -42,18 +55,6 @@ export const createPhaseRunner = (phaseConfig) => async (options, config) => {
         }
         // Execute the phase with checklist context
         const result = await execute(options, config, checklistContext);
-        console.log({
-            result,
-        });
-        console.log({
-            status: result.status,
-        });
-        console.log({
-            data: result.data,
-        });
-        console.log({
-            checklist_item_results: result.data?.checklist_item_results,
-        });
         // Process checklist results from phase response if phase was successful
         if (result.status === 'success') {
             try {
@@ -154,6 +155,35 @@ export const createPhaseRunner = (phaseConfig) => async (options, config) => {
                 };
             }
         }
+        // Log phase completion
+        const phaseEndTime = Date.now();
+        const phaseDuration = phaseEndTime - phaseStartTime;
+        if (result.status === 'success') {
+            await logFeaturePhaseEvent(mcpServerUrl, mcpToken, {
+                featureId,
+                eventType: 'phase_completed',
+                phase: name.replace(/-/g, '_'),
+                result: 'success',
+                metadata: {
+                    duration_ms: phaseDuration,
+                    iterations: result.data?.iterations,
+                    artifacts: result.data,
+                    checklist_validation: checklistValidation,
+                },
+            }, verbose);
+        }
+        else {
+            await logFeaturePhaseEvent(mcpServerUrl, mcpToken, {
+                featureId,
+                eventType: 'phase_failed',
+                phase: name.replace(/-/g, '_'),
+                result: 'error',
+                metadata: {
+                    duration_ms: phaseDuration,
+                },
+                errorMessage: result.summary || 'Phase execution failed',
+            }, verbose);
+        }
         return {
             featureId,
             phase: name,
@@ -169,6 +199,20 @@ export const createPhaseRunner = (phaseConfig) => async (options, config) => {
         };
     }
     catch (error) {
+        // Log phase failure for exceptions
+        const phaseEndTime = Date.now();
+        const phaseDuration = phaseEndTime - phaseStartTime;
+        await logFeaturePhaseEvent(mcpServerUrl, mcpToken, {
+            featureId,
+            eventType: 'phase_failed',
+            phase: name.replace(/-/g, '_'),
+            result: 'error',
+            metadata: {
+                duration_ms: phaseDuration,
+                error_type: 'exception',
+            },
+            errorMessage: error instanceof Error ? error.message : String(error),
+        }, verbose);
         return {
             featureId,
             phase: name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edsger",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/dist/api/features.d.ts

@@ -1,100 +0,0 @@
-export interface FeatureInfo {
-    id: string;
-    name: string;
-    description?: string;
-    technical_design?: string;
-    status: string;
-    product_id: string;
-    created_at?: string;
-    updated_at?: string;
-}
-/**
- * Get feature details by ID
- */
-export declare function getFeature(mcpServerUrl: string, mcpToken: string, featureId: string, verbose?: boolean): Promise<FeatureInfo>;
-/**
- * Update feature with new data
- */
-export declare function updateFeature(mcpServerUrl: string, mcpToken: string, featureId: string, updates: {
-    technical_design?: string;
-    status?: string;
-    pull_request_url?: string;
-}, verbose?: boolean): Promise<boolean>;
-/**
- * Update technical design for a feature
- */
-export declare function updateTechnicalDesign(mcpServerUrl: string, mcpToken: string, featureId: string, technicalDesign: string, verbose?: boolean): Promise<boolean>;
-/**
- * Update feature status
- */
-export declare function updateFeatureStatus(mcpServerUrl: string, mcpToken: string, featureId: string, status: string, verbose?: boolean): Promise<boolean>;
-export interface UserStory {
-    id: string;
-    title: string;
-    description: string;
-    status: string;
-    created_at?: string;
-    updated_at?: string;
-    [key: string]: any;
-}
-/**
- * Get user stories for a feature
- */
-export declare function getUserStories(mcpServerUrl: string, mcpToken: string, featureId: string, verbose?: boolean): Promise<UserStory[]>;
-/**
- * Create a new user story for a feature
- */
-export declare function createUserStory(mcpServerUrl: string, mcpToken: string, featureId: string, userStory: {
-    title: string;
-    description: string;
-    status?: string;
-}, verbose?: boolean): Promise<boolean>;
-/**
- * Create multiple user stories for a feature
- */
-export declare function createUserStories(mcpServerUrl: string, mcpToken: string, featureId: string, userStories: Array<{
-    title: string;
-    description: string;
-    status?: string;
-}>, verbose?: boolean): Promise<boolean>;
-export interface TestCase {
-    id: string;
-    name: string;
-    description: string;
-    is_critical: boolean;
-    created_at?: string;
-    updated_at?: string;
-    [key: string]: any;
-}
-/**
- * Get test cases for a feature
- */
-export declare function getTestCases(mcpServerUrl: string, mcpToken: string, featureId: string, verbose?: boolean): Promise<TestCase[]>;
-/**
- * Create a new test case for a feature
- */
-export declare function createTestCase(mcpServerUrl: string, mcpToken: string, featureId: string, testCase: {
-    name: string;
-    description: string;
-    is_critical?: boolean;
-}, verbose?: boolean): Promise<boolean>;
-/**
- * Create multiple test cases for a feature
- */
-export declare function createTestCases(mcpServerUrl: string, mcpToken: string, featureId: string, testCases: Array<{
-    name: string;
-    description: string;
-    is_critical?: boolean;
-}>, verbose?: boolean): Promise<boolean>;
-/**
- * Filter features by status
- */
-export declare function filterFeaturesByStatus(features: FeatureInfo[], status: string): FeatureInfo[];
-/**
- * Sort features by updated_at (most recent first)
- */
-export declare function sortFeaturesByUpdatedAt(features: FeatureInfo[]): FeatureInfo[];
-/**
- * Get features with ready_for_dev status for a product
- */
-export declare function getReadyForDevFeatures(mcpServerUrl: string, mcpToken: string, productId: string, verbose?: boolean): Promise<FeatureInfo[]>;

package/dist/api/features.js

@@ -1,219 +0,0 @@
-import { logInfo, logError } from '../logger.js';
-import { callMcpEndpoint } from './mcp-client.js';
-/**
- * Get feature details by ID
- */
-export async function getFeature(mcpServerUrl, mcpToken, featureId, verbose) {
-    if (verbose) {
-        logInfo(`Fetching feature details for: ${featureId}`);
-    }
-    const result = (await callMcpEndpoint(mcpServerUrl, mcpToken, 'features/get', { feature_id: featureId }));
-    if (!result.features || result.features.length === 0) {
-        throw new Error(`Feature not found: ${featureId}`);
-    }
-    return result.features[0];
-}
-/**
- * Update feature with new data
- */
-export async function updateFeature(mcpServerUrl, mcpToken, featureId, updates, verbose) {
-    try {
-        if (verbose) {
-            logInfo(`Updating feature: ${featureId}`);
-        }
-        await callMcpEndpoint(mcpServerUrl, mcpToken, 'features/update', {
-            feature_id: featureId,
-            ...updates,
-        });
-        if (verbose) {
-            logInfo('✅ Feature updated successfully');
-        }
-        return true;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to update feature: ${errorMessage}`);
-        return false;
-    }
-}
-/**
- * Update technical design for a feature
- */
-export async function updateTechnicalDesign(mcpServerUrl, mcpToken, featureId, technicalDesign, verbose) {
-    return updateFeature(mcpServerUrl, mcpToken, featureId, { technical_design: technicalDesign }, verbose);
-}
-/**
- * Update feature status
- */
-export async function updateFeatureStatus(mcpServerUrl, mcpToken, featureId, status, verbose) {
-    return updateFeature(mcpServerUrl, mcpToken, featureId, { status }, verbose);
-}
-/**
- * Get user stories for a feature
- */
-export async function getUserStories(mcpServerUrl, mcpToken, featureId, verbose) {
-    if (verbose) {
-        logInfo(`Fetching user stories for feature: ${featureId}`);
-    }
-    const result = (await callMcpEndpoint(mcpServerUrl, mcpToken, 'user_stories/list', { feature_id: featureId }));
-    return (result.user_stories || []);
-}
-/**
- * Create a new user story for a feature
- */
-export async function createUserStory(mcpServerUrl, mcpToken, featureId, userStory, verbose) {
-    try {
-        if (verbose) {
-            logInfo(`Creating user story for feature: ${featureId}`);
-        }
-        await callMcpEndpoint(mcpServerUrl, mcpToken, 'user_stories/create', {
-            feature_id: featureId,
-            user_stories: [
-                {
-                    title: userStory.title,
-                    description: userStory.description,
-                    status: userStory.status || 'draft',
-                },
-            ],
-        });
-        if (verbose) {
-            logInfo('✅ User story created successfully');
-        }
-        return true;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to create user story: ${errorMessage}`);
-        return false;
-    }
-}
-/**
- * Create multiple user stories for a feature
- */
-export async function createUserStories(mcpServerUrl, mcpToken, featureId, userStories, verbose) {
-    try {
-        if (verbose) {
-            logInfo(`Creating ${userStories.length} user stories for feature: ${featureId}`);
-        }
-        for (const story of userStories) {
-            await createUserStory(mcpServerUrl, mcpToken, featureId, story, false);
-        }
-        if (verbose) {
-            logInfo('✅ All user stories created successfully');
-        }
-        return true;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to create user stories: ${errorMessage}`);
-        return false;
-    }
-}
-/**
- * Get test cases for a feature
- */
-export async function getTestCases(mcpServerUrl, mcpToken, featureId, verbose) {
-    if (verbose) {
-        logInfo(`Fetching test cases for feature: ${featureId}`);
-    }
-    const result = (await callMcpEndpoint(mcpServerUrl, mcpToken, 'test_cases/list', { feature_id: featureId }));
-    return (result.test_cases || []);
-}
-/**
- * Create a new test case for a feature
- */
-export async function createTestCase(mcpServerUrl, mcpToken, featureId, testCase, verbose) {
-    try {
-        if (verbose) {
-            logInfo(`Creating test case for feature: ${featureId}`);
-        }
-        await callMcpEndpoint(mcpServerUrl, mcpToken, 'test_cases/create', {
-            feature_id: featureId,
-            test_cases: [
-                {
-                    name: testCase.name,
-                    description: testCase.description,
-                    is_critical: testCase.is_critical || false,
-                },
-            ],
-        });
-        if (verbose) {
-            logInfo('✅ Test case created successfully');
-        }
-        return true;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to create test case: ${errorMessage}`);
-        return false;
-    }
-}
-/**
- * Create multiple test cases for a feature
- */
-export async function createTestCases(mcpServerUrl, mcpToken, featureId, testCases, verbose) {
-    try {
-        if (verbose) {
-            logInfo(`Creating ${testCases.length} test cases for feature: ${featureId}`);
-        }
-        for (const testCase of testCases) {
-            await createTestCase(mcpServerUrl, mcpToken, featureId, testCase, false);
-        }
-        if (verbose) {
-            logInfo('✅ All test cases created successfully');
-        }
-        return true;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to create test cases: ${errorMessage}`);
-        return false;
-    }
-}
-// ============================================================================
-// FEATURE UTILITY FUNCTIONS
-// ============================================================================
-/**
- * Filter features by status
- */
-export function filterFeaturesByStatus(features, status) {
-    return features.filter(feature => feature.status === status);
-}
-/**
- * Sort features by updated_at (most recent first)
- */
-export function sortFeaturesByUpdatedAt(features) {
-    return [...features].sort((a, b) => {
-        const dateA = new Date(a.updated_at || 0).getTime();
-        const dateB = new Date(b.updated_at || 0).getTime();
-        return dateB - dateA;
-    });
-}
-/**
- * Get features with ready_for_dev status for a product
- */
-export async function getReadyForDevFeatures(mcpServerUrl, mcpToken, productId, verbose) {
-    if (verbose) {
-        logInfo(`Fetching ready_for_dev features for product: ${productId}`);
-    }
-    try {
-        const result = await callMcpEndpoint(mcpServerUrl, mcpToken, 'features/list', {
-            product_id: productId,
-            status: 'ready_for_dev',
-        });
-        const features = result.features || [];
-        const sortedFeatures = sortFeaturesByUpdatedAt(features);
-        if (verbose) {
-            logInfo(`✅ Found ${sortedFeatures.length} ready_for_dev features`);
-            sortedFeatures.forEach((feature, index) => {
-                logInfo(`   ${index + 1}. ${feature.name} (updated: ${feature.updated_at})`);
-            });
-        }
-        return sortedFeatures;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logError(`Failed to fetch ready_for_dev features: ${errorMessage}`);
-        throw error;
-    }
-}

package/dist/logger.d.ts

@@ -1,19 +0,0 @@
-import { ReviewResult } from './types.js';
-export declare const colors: {
-    reset: string;
-    bright: string;
-    red: string;
-    green: string;
-    yellow: string;
-    blue: string;
-    magenta: string;
-    cyan: string;
-    gray: string;
-};
-export declare const colorize: (text: string, color: keyof typeof colors) => string;
-export declare const logInfo: (message: string) => void;
-export declare const logSuccess: (message: string) => void;
-export declare const logWarning: (message: string) => void;
-export declare const logError: (message: string) => void;
-export declare const logProgress: (current: number, total: number, file: string) => void;
-export declare const logResults: (results: ReviewResult[], verbose?: boolean) => void;

package/dist/logger.js

@@ -1,52 +0,0 @@
-export const colors = {
-    reset: '\x1b[0m',
-    bright: '\x1b[1m',
-    red: '\x1b[31m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    cyan: '\x1b[36m',
-    gray: '\x1b[90m'
-};
-export const colorize = (text, color) => {
-    return `${colors[color]}${text}${colors.reset}`;
-};
-export const logInfo = (message) => {
-    console.log(colorize(`ℹ ${message}`, 'blue'));
-};
-export const logSuccess = (message) => {
-    console.log(colorize(`✓ ${message}`, 'green'));
-};
-export const logWarning = (message) => {
-    console.log(colorize(`⚠ ${message}`, 'yellow'));
-};
-export const logError = (message) => {
-    console.error(colorize(`✗ ${message}`, 'red'));
-};
-export const logProgress = (current, total, file) => {
-    const percentage = Math.round((current / total) * 100);
-    const progress = `[${current}/${total}] ${percentage}%`;
-    console.log(colorize(`${progress} Reviewing ${file}`, 'gray'));
-};
-export const logResults = (results, verbose = false) => {
-    const okCount = results.filter(r => r.status === 'OK').length;
-    const warnCount = results.filter(r => r.status === 'WARN').length;
-    const blockCount = results.filter(r => r.status === 'BLOCK').length;
-    console.log('\n' + colorize('='.repeat(60), 'gray'));
-    console.log(colorize('Review Results', 'bright'));
-    console.log(colorize('='.repeat(60), 'gray'));
-    results.forEach(result => {
-        const icon = result.status === 'OK' ? '✓' : result.status === 'WARN' ? '⚠' : '✗';
-        const color = result.status === 'OK' ? 'green' : result.status === 'WARN' ? 'yellow' : 'red';
-        console.log(colorize(`${icon} ${result.file}: ${result.message}`, color));
-        if (verbose && result.details && result.status !== 'OK') {
-            console.log(colorize(`   Details: ${result.details}`, 'gray'));
-        }
-    });
-    console.log('\n' + colorize('Summary:', 'bright'));
-    console.log(colorize(`  ✓ Passed: ${okCount}`, 'green'));
-    console.log(colorize(`  ⚠ Warnings: ${warnCount}`, 'yellow'));
-    console.log(colorize(`  ✗ Blocked: ${blockCount}`, 'red'));
-    console.log(colorize(`  Total: ${results.length} files reviewed`, 'gray'));
-};

package/dist/types.d.ts

@@ -1,99 +0,0 @@
-export interface EdsgerConfig {
-    patterns: string[];
-    exclude: string[];
-    severity: 'error' | 'warning';
-    maxFiles: number;
-    claude: {
-        model?: string;
-        timeout?: number;
-    };
-}
-export interface GitFile {
-    path: string;
-    content: string;
-    status: 'modified' | 'added' | 'deleted' | 'renamed';
-}
-export interface ReviewResult {
-    file: string;
-    status: 'OK' | 'WARN' | 'BLOCK';
-    message: string;
-    details?: string;
-}
-export interface CliOptions {
-    review?: boolean;
-    staged?: boolean;
-    files?: string[];
-    config?: string;
-    verbose?: boolean;
-    featureAnalysis?: string;
-    technicalDesign?: string;
-    implement?: string;
-    test?: string;
-    workflow?: boolean;
-}
-export type ReviewSeverity = 'error' | 'warning';
-export type ExitCode = 0 | 1;
-export interface FeatureAnalysisResult {
-    featureId: string;
-    productInfo: unknown;
-    featureInfo: unknown;
-    existingUserStories: UserStory[];
-    existingTestCases: TestCase[];
-    createdUserStories: UserStory[];
-    createdTestCases: TestCase[];
-    summary: string;
-    status: 'pending' | 'success' | 'error';
-}
-export interface FeatureData {
-    feature: {
-        id: string;
-        name: string;
-        description: string;
-        status: string;
-        product_id: string;
-        created_at: string;
-        updated_at: string;
-    };
-    product: {
-        id: string;
-        name: string;
-        description: string;
-        status: string;
-        features: unknown[];
-        metadata: {
-            created_at: string;
-            updated_at: string;
-        };
-    };
-}
-export interface UserStory {
-    id: string;
-    title: string;
-    description: string;
-    status: 'draft' | 'ready' | 'in_progress' | 'done' | 'cancelled';
-    created_at: string;
-    updated_at: string;
-}
-export interface TestCase {
-    id: string;
-    name: string;
-    description: string;
-    is_critical: boolean;
-    created_at: string;
-    updated_at: string;
-}
-export interface DisplayUserStory {
-    title: string;
-}
-export interface DisplayTestCase {
-    name: string;
-    is_critical?: boolean;
-}
-export interface FeatureAnalysisDisplayResult {
-    featureId: string;
-    status: string;
-    summary?: string;
-    createdUserStories?: DisplayUserStory[];
-    createdTestCases?: DisplayTestCase[];
-}
-export type FeatureStatus = 'backlog' | 'ready_for_dev' | 'feature_analysis' | 'technical_design' | 'code_implementation' | 'code_review' | 'ready_for_review' | 'shipped' | 'testing_in_progress' | 'testing_passed' | 'testing_failed';

package/dist/types.js

@@ -1 +0,0 @@
-export {};

package/dist/utils/image-processor.d.ts

@@ -1,5 +0,0 @@
-/**
- * Convert HTML description to Markdown format
- * Preserves image URLs so Claude Code can view them
- */
-export declare function htmlToMarkdown(html: string): string;

package/dist/utils/image-processor.js

@@ -1,55 +0,0 @@
-/**
- * Convert HTML description to Markdown format
- * Preserves image URLs so Claude Code can view them
- */
-export function htmlToMarkdown(html) {
-    if (!html)
-        return '';
-    return (html
-        // Convert images to markdown format with original URL
-        .replace(/<img[^>]+src="([^">]+)"[^>]*alt="([^">]*)"[^>]*>/gi, '![$2]($1)')
-        .replace(/<img[^>]+src="([^">]+)"[^>]*>/gi, '![]($1)')
-        // Convert links
-        .replace(/<a[^>]+href="([^">]+)"[^>]*>(.*?)<\/a>/gi, '[$2]($1)')
-        // Convert headings
-        .replace(/<h1[^>]*>(.*?)<\/h1>/gi, '\n# $1\n')
-        .replace(/<h2[^>]*>(.*?)<\/h2>/gi, '\n## $1\n')
-        .replace(/<h3[^>]*>(.*?)<\/h3>/gi, '\n### $1\n')
-        .replace(/<h4[^>]*>(.*?)<\/h4>/gi, '\n#### $1\n')
-        .replace(/<h5[^>]*>(.*?)<\/h5>/gi, '\n##### $1\n')
-        .replace(/<h6[^>]*>(.*?)<\/h6>/gi, '\n###### $1\n')
-        // Convert lists
-        .replace(/<ul[^>]*>/gi, '\n')
-        .replace(/<\/ul>/gi, '\n')
-        .replace(/<ol[^>]*>/gi, '\n')
-        .replace(/<\/ol>/gi, '\n')
-        .replace(/<li[^>]*>(.*?)<\/li>/gi, '- $1\n')
-        // Convert paragraphs
-        .replace(/<\/p>/gi, '\n\n')
-        .replace(/<p[^>]*>/gi, '')
-        // Convert line breaks
-        .replace(/<br\s*\/?>/gi, '\n')
-        // Convert text formatting
-        .replace(/<strong[^>]*>(.*?)<\/strong>/gi, '**$1**')
-        .replace(/<b[^>]*>(.*?)<\/b>/gi, '**$1**')
-        .replace(/<em[^>]*>(.*?)<\/em>/gi, '*$1*')
-        .replace(/<i[^>]*>(.*?)<\/i>/gi, '*$1*')
-        .replace(/<u[^>]*>(.*?)<\/u>/gi, '__$1__')
-        // Convert code
-        .replace(/<code[^>]*>(.*?)<\/code>/gi, '`$1`')
-        .replace(/<pre[^>]*>(.*?)<\/pre>/gi, '\n```\n$1\n```\n')
-        // Convert blockquotes
-        .replace(/<blockquote[^>]*>(.*?)<\/blockquote>/gi, '\n> $1\n')
-        // Remove remaining HTML tags
-        .replace(/<[^>]+>/g, '')
-        // Decode HTML entities
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&amp;/g, '&')
-        .replace(/&quot;/g, '"')
-        .replace(/&#39;/g, "'")
-        .replace(/&nbsp;/g, ' ')
-        // Clean up extra whitespace
-        .replace(/\n{3,}/g, '\n\n')
-        .trim());
-}

package/dist/workflow-runner/config/stage-configs.d.ts

@@ -1,5 +0,0 @@
-/**
- * Stage configurations for the pipeline runner
- */
-import { StageConfig } from '../../types/pipeline.js';
-export declare const stageConfigs: readonly StageConfig[];