ai-sdlc 0.1.0-alpha.1

package/dist/core/story.d.ts

@@ -0,0 +1,91 @@
+import { Story, StoryFrontmatter, ReviewAttempt, Config } from '../types/index.js';
+/**
+ * Parse a story markdown file into a Story object
+ */
+export declare function parseStory(filePath: string): Story;
+/**
+ * Write a story back to disk
+ */
+export declare function writeStory(story: Story): void;
+/**
+ * Move a story to a different kanban folder
+ */
+export declare function moveStory(story: Story, toFolder: string, sdlcRoot: string): Story;
+/**
+ * Generate a unique story ID
+ */
+export declare function generateStoryId(): string;
+/**
+ * Create a slug from a title
+ */
+export declare function slugify(title: string): string;
+/**
+ * Create a new story in the backlog
+ */
+export declare function createStory(title: string, sdlcRoot: string, options?: Partial<StoryFrontmatter>): Story;
+/**
+ * Update story frontmatter field
+ */
+export declare function updateStoryField<K extends keyof StoryFrontmatter>(story: Story, field: K, value: StoryFrontmatter[K]): Story;
+/**
+ * Append content to a section in the story
+ */
+export declare function appendToSection(story: Story, section: string, content: string): Story;
+/**
+ * Record a refinement attempt in the story's frontmatter
+ */
+export declare function recordRefinementAttempt(story: Story, agentType: string, reviewFeedback: string): Story;
+/**
+ * Get the current refinement count for a story
+ */
+export declare function getRefinementCount(story: Story): number;
+/**
+ * Check if a story can retry refinement based on iteration limit
+ */
+export declare function canRetryRefinement(story: Story, maxAttempts: number): boolean;
+/**
+ * Reset phase completion flags for rework
+ */
+export declare function resetPhaseCompletion(story: Story, phase: 'research' | 'plan' | 'implement'): Story;
+/**
+ * Get the latest review feedback from the story content
+ */
+export declare function getLatestReviewFeedback(story: Story): string | null;
+/**
+ * Append refinement feedback to the story content
+ */
+export declare function appendRefinementNote(story: Story, iteration: number, feedback: string): Story;
+/**
+ * Get the effective maximum retries for a story (story-specific or config default)
+ */
+export declare function getEffectiveMaxRetries(story: Story, config: Config): number;
+/**
+ * Check if a story has reached its maximum retry limit
+ * @param maxIterationsOverride Optional CLI override for max iterations (takes precedence)
+ */
+export declare function isAtMaxRetries(story: Story, config: Config, maxIterationsOverride?: number): boolean;
+/**
+ * Increment the retry count for a story
+ */
+export declare function incrementRetryCount(story: Story): Story;
+/**
+ * Reset RPIV cycle for a story (keep research, reset plan/implementation/reviews)
+ */
+export declare function resetRPIVCycle(story: Story, reason: string): Story;
+/**
+ * Append a review attempt to the story's review history
+ */
+export declare function appendReviewHistory(story: Story, attempt: ReviewAttempt): Story;
+/**
+ * Get the latest review attempt from a story's history
+ */
+export declare function getLatestReviewAttempt(story: Story): ReviewAttempt | null;
+/**
+ * Mark a story as complete (all workflow flags set to true)
+ */
+export declare function markStoryComplete(story: Story): Story;
+/**
+ * Snapshot max_retries from config to story frontmatter (for mid-cycle config change protection)
+ */
+export declare function snapshotMaxRetries(story: Story, config: Config): Story;
+//# sourceMappingURL=story.d.ts.map

package/dist/core/story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../src/core/story.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAiC,aAAa,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAElH;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAclD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAG7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAgCjF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,KAAK,CA8DP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC/D,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACzB,KAAK,CAKP;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CA2BrF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,KAAK,CAsBP;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAK7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,WAAW,GACvC,KAAK,CAgBP;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CASnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,KAAK,CAGP;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,CAWpG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAOvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAelE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAgB/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,IAAI,CAKzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAQrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAOtE"}

package/dist/core/story.js

@@ -0,0 +1,349 @@
+import fs from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import { FOLDER_TO_STATUS } from '../types/index.js';
+/**
+ * Parse a story markdown file into a Story object
+ */
+export function parseStory(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const { data, content: body } = matter(content);
+    // Extract slug from filename (remove priority prefix and .md extension)
+    const filename = path.basename(filePath, '.md');
+    const slug = filename.replace(/^\d+-/, '');
+    return {
+        path: filePath,
+        slug,
+        frontmatter: data,
+        content: body.trim(),
+    };
+}
+/**
+ * Write a story back to disk
+ */
+export function writeStory(story) {
+    const content = matter.stringify(story.content, story.frontmatter);
+    fs.writeFileSync(story.path, content);
+}
+/**
+ * Move a story to a different kanban folder
+ */
+export function moveStory(story, toFolder, sdlcRoot) {
+    const targetFolder = path.join(sdlcRoot, toFolder);
+    // Ensure target folder exists
+    if (!fs.existsSync(targetFolder)) {
+        fs.mkdirSync(targetFolder, { recursive: true });
+    }
+    // Get existing stories in target folder to determine priority
+    const existingFiles = fs.readdirSync(targetFolder).filter(f => f.endsWith('.md'));
+    const newPriority = existingFiles.length + 1;
+    // Create new filename with priority
+    const newFilename = `${String(newPriority).padStart(2, '0')}-${story.slug}.md`;
+    const newPath = path.join(targetFolder, newFilename);
+    // Update frontmatter
+    story.frontmatter.priority = newPriority;
+    story.frontmatter.status = FOLDER_TO_STATUS[toFolder];
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    // Write to new location
+    const oldPath = story.path;
+    story.path = newPath;
+    writeStory(story);
+    // Remove old file
+    if (fs.existsSync(oldPath) && oldPath !== newPath) {
+        fs.unlinkSync(oldPath);
+    }
+    return story;
+}
+/**
+ * Generate a unique story ID
+ */
+export function generateStoryId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 6);
+    return `story-${timestamp}-${random}`;
+}
+/**
+ * Create a slug from a title
+ */
+export function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 50);
+}
+/**
+ * Create a new story in the backlog
+ */
+export function createStory(title, sdlcRoot, options = {}) {
+    const backlogFolder = path.join(sdlcRoot, 'backlog');
+    // Ensure backlog folder exists
+    if (!fs.existsSync(backlogFolder)) {
+        fs.mkdirSync(backlogFolder, { recursive: true });
+    }
+    // Get existing stories to determine priority
+    const existingFiles = fs.readdirSync(backlogFolder).filter(f => f.endsWith('.md'));
+    const priority = existingFiles.length + 1;
+    const slug = slugify(title);
+    const filename = `${String(priority).padStart(2, '0')}-${slug}.md`;
+    const filePath = path.join(backlogFolder, filename);
+    const frontmatter = {
+        id: generateStoryId(),
+        title,
+        priority,
+        status: 'backlog',
+        type: options.type || 'feature',
+        created: new Date().toISOString().split('T')[0],
+        labels: options.labels || [],
+        research_complete: false,
+        plan_complete: false,
+        implementation_complete: false,
+        reviews_complete: false,
+        ...options,
+    };
+    const content = `# ${title}
+
+## Summary
+
+(Describe the feature, bug, or task here)
+
+## Acceptance Criteria
+
+- [ ] (Define acceptance criteria)
+
+## Research
+
+<!-- Populated by research agent -->
+
+## Implementation Plan
+
+<!-- Populated by planning agent -->
+
+## Review Notes
+
+<!-- Populated by review agents -->`;
+    const story = {
+        path: filePath,
+        slug,
+        frontmatter,
+        content,
+    };
+    writeStory(story);
+    return story;
+}
+/**
+ * Update story frontmatter field
+ */
+export function updateStoryField(story, field, value) {
+    story.frontmatter[field] = value;
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Append content to a section in the story
+ */
+export function appendToSection(story, section, content) {
+    const sectionHeader = `## ${section}`;
+    const sectionIndex = story.content.indexOf(sectionHeader);
+    if (sectionIndex === -1) {
+        // Section doesn't exist, add it at the end
+        story.content += `\n\n${sectionHeader}\n\n${content}`;
+    }
+    else {
+        // Find the next section or end of content
+        const afterHeader = sectionIndex + sectionHeader.length;
+        const nextSectionMatch = story.content.substring(afterHeader).match(/\n## /);
+        const insertPoint = nextSectionMatch
+            ? afterHeader + nextSectionMatch.index
+            : story.content.length;
+        // Insert content before next section
+        story.content =
+            story.content.substring(0, insertPoint).trimEnd() +
+                '\n\n' +
+                content +
+                '\n' +
+                story.content.substring(insertPoint);
+    }
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Record a refinement attempt in the story's frontmatter
+ */
+export function recordRefinementAttempt(story, agentType, reviewFeedback) {
+    // Initialize refinement tracking if not present
+    if (!story.frontmatter.refinement_iterations) {
+        story.frontmatter.refinement_iterations = [];
+        story.frontmatter.refinement_count = 0;
+    }
+    const iteration = (story.frontmatter.refinement_count || 0) + 1;
+    const refinementRecord = {
+        iteration,
+        agentType,
+        startedAt: new Date().toISOString(),
+        reviewFeedback,
+        result: 'in_progress',
+    };
+    story.frontmatter.refinement_iterations.push(refinementRecord);
+    story.frontmatter.refinement_count = iteration;
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Get the current refinement count for a story
+ */
+export function getRefinementCount(story) {
+    return story.frontmatter.refinement_count || 0;
+}
+/**
+ * Check if a story can retry refinement based on iteration limit
+ */
+export function canRetryRefinement(story, maxAttempts) {
+    const currentCount = getRefinementCount(story);
+    const storyMax = story.frontmatter.max_refinement_attempts;
+    const effectiveMax = storyMax !== undefined ? storyMax : maxAttempts;
+    return currentCount < effectiveMax;
+}
+/**
+ * Reset phase completion flags for rework
+ */
+export function resetPhaseCompletion(story, phase) {
+    switch (phase) {
+        case 'research':
+            story.frontmatter.research_complete = false;
+            break;
+        case 'plan':
+            story.frontmatter.plan_complete = false;
+            break;
+        case 'implement':
+            story.frontmatter.implementation_complete = false;
+            break;
+    }
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Get the latest review feedback from the story content
+ */
+export function getLatestReviewFeedback(story) {
+    const reviewSection = story.content.match(/## Review Notes\n\n([\s\S]*?)(?=\n## |$)/);
+    if (!reviewSection) {
+        return null;
+    }
+    // Extract the most recent review (look for latest "### Review" or similar heading)
+    const reviews = reviewSection[1].split(/### /);
+    return reviews.length > 1 ? reviews[reviews.length - 1].trim() : null;
+}
+/**
+ * Append refinement feedback to the story content
+ */
+export function appendRefinementNote(story, iteration, feedback) {
+    const refinementNote = `### Refinement Iteration ${iteration}\n\n${feedback}`;
+    return appendToSection(story, 'Review Notes', refinementNote);
+}
+/**
+ * Get the effective maximum retries for a story (story-specific or config default)
+ */
+export function getEffectiveMaxRetries(story, config) {
+    return story.frontmatter.max_retries !== undefined
+        ? story.frontmatter.max_retries
+        : config.reviewConfig.maxRetries;
+}
+/**
+ * Check if a story has reached its maximum retry limit
+ * @param maxIterationsOverride Optional CLI override for max iterations (takes precedence)
+ */
+export function isAtMaxRetries(story, config, maxIterationsOverride) {
+    const currentRetryCount = story.frontmatter.retry_count || 0;
+    // CLI override takes precedence, then story-specific, then config default
+    const maxRetries = maxIterationsOverride !== undefined
+        ? maxIterationsOverride
+        : getEffectiveMaxRetries(story, config);
+    // Infinity means no limit
+    if (!Number.isFinite(maxRetries)) {
+        return false;
+    }
+    return currentRetryCount >= maxRetries;
+}
+/**
+ * Increment the retry count for a story
+ */
+export function incrementRetryCount(story) {
+    const currentCount = story.frontmatter.retry_count || 0;
+    story.frontmatter.retry_count = currentCount + 1;
+    story.frontmatter.last_restart_timestamp = new Date().toISOString();
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Reset RPIV cycle for a story (keep research, reset plan/implementation/reviews)
+ */
+export function resetRPIVCycle(story, reason) {
+    // Keep research_complete as true, reset other flags
+    story.frontmatter.plan_complete = false;
+    story.frontmatter.implementation_complete = false;
+    story.frontmatter.reviews_complete = false;
+    story.frontmatter.last_restart_reason = reason;
+    story.frontmatter.last_restart_timestamp = new Date().toISOString();
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    // Increment retry count
+    const currentCount = story.frontmatter.retry_count || 0;
+    story.frontmatter.retry_count = currentCount + 1;
+    writeStory(story);
+    return story;
+}
+/**
+ * Append a review attempt to the story's review history
+ */
+export function appendReviewHistory(story, attempt) {
+    if (!story.frontmatter.review_history) {
+        story.frontmatter.review_history = [];
+    }
+    // Add new attempt
+    story.frontmatter.review_history.push(attempt);
+    // Keep only the last 10 attempts to prevent unbounded growth
+    if (story.frontmatter.review_history.length > 10) {
+        story.frontmatter.review_history = story.frontmatter.review_history.slice(-10);
+    }
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Get the latest review attempt from a story's history
+ */
+export function getLatestReviewAttempt(story) {
+    if (!story.frontmatter.review_history || story.frontmatter.review_history.length === 0) {
+        return null;
+    }
+    return story.frontmatter.review_history[story.frontmatter.review_history.length - 1];
+}
+/**
+ * Mark a story as complete (all workflow flags set to true)
+ */
+export function markStoryComplete(story) {
+    story.frontmatter.research_complete = true;
+    story.frontmatter.plan_complete = true;
+    story.frontmatter.implementation_complete = true;
+    story.frontmatter.reviews_complete = true;
+    story.frontmatter.updated = new Date().toISOString().split('T')[0];
+    writeStory(story);
+    return story;
+}
+/**
+ * Snapshot max_retries from config to story frontmatter (for mid-cycle config change protection)
+ */
+export function snapshotMaxRetries(story, config) {
+    if (story.frontmatter.max_retries === undefined) {
+        story.frontmatter.max_retries = config.reviewConfig.maxRetries;
+        story.frontmatter.updated = new Date().toISOString().split('T')[0];
+        writeStory(story);
+    }
+    return story;
+}
+//# sourceMappingURL=story.js.map

package/dist/core/story.js.map

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

package/dist/core/theme.d.ts

@@ -0,0 +1,17 @@
+import { Config, ThemePreference, ThemeColors } from '../types/index.js';
+/**
+ * Detect terminal background theme by checking environment variables
+ * Returns 'light' or 'dark' based on terminal settings
+ */
+export declare function detectTerminalTheme(): 'light' | 'dark';
+/**
+ * Get color scheme for a specific theme preference
+ * Returns an object with semantic color methods
+ */
+export declare function getThemeColors(preference: ThemePreference): ThemeColors;
+/**
+ * Get themed chalk instance based on configuration
+ * This is the main function to use in CLI commands
+ */
+export declare function getThemedChalk(config?: Config): ThemeColors;
+//# sourceMappingURL=theme.d.ts.map

package/dist/core/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGzE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,GAAG,MAAM,CAwCtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CA8EvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAG3D"}

package/dist/core/theme.js

@@ -0,0 +1,136 @@
+import chalk from 'chalk';
+import { loadConfig } from './config.js';
+/**
+ * Detect terminal background theme by checking environment variables
+ * Returns 'light' or 'dark' based on terminal settings
+ */
+export function detectTerminalTheme() {
+    // Check COLORFGBG environment variable
+    // Format: "foreground;background" where high values (>7) = light background
+    const colorFgBg = process.env.COLORFGBG;
+    if (colorFgBg) {
+        const parts = colorFgBg.split(';');
+        if (parts.length >= 2) {
+            const bg = parseInt(parts[1], 10);
+            // Background values 0-7 are dark, 8-15 are light (standard ANSI)
+            // Security: validate range to prevent unexpected behavior
+            if (!isNaN(bg) && bg >= 0 && bg <= 15) {
+                // Standard 16-color ANSI palette
+                return bg > 7 ? 'light' : 'dark';
+            }
+            else if (!isNaN(bg) && bg >= 16 && bg <= 231) {
+                // 256-color palette: RGB cube (16-231)
+                // Calculate luminance approximation from 6x6x6 RGB cube
+                const colorIndex = bg - 16;
+                const r = Math.floor(colorIndex / 36);
+                const g = Math.floor((colorIndex % 36) / 6);
+                const b = colorIndex % 6;
+                // Simple luminance: if sum > 9 (out of 15), it's light
+                return (r + g + b) > 9 ? 'light' : 'dark';
+            }
+            else if (!isNaN(bg) && bg >= 232 && bg <= 255) {
+                // 256-color palette: grayscale ramp (232-255)
+                // Values above 243 (midpoint) are light
+                return bg > 243 ? 'light' : 'dark';
+            }
+        }
+    }
+    // Check TERM_PROGRAM for known terminal types
+    const termProgram = process.env.TERM_PROGRAM;
+    if (termProgram === 'Apple_Terminal') {
+        // macOS Terminal.app defaults to light
+        return 'light';
+    }
+    // Default to dark (safer - bright colors work better on dark backgrounds)
+    return 'dark';
+}
+/**
+ * Get color scheme for a specific theme preference
+ * Returns an object with semantic color methods
+ */
+export function getThemeColors(preference) {
+    // Handle NO_COLOR environment variable (standard)
+    if (process.env.NO_COLOR !== undefined || preference === 'none') {
+        return {
+            success: (str) => str,
+            error: (str) => str,
+            warning: (str) => str,
+            info: (str) => str,
+            dim: (str) => str,
+            bold: (str) => str,
+            backlog: (str) => str,
+            ready: (str) => str,
+            inProgress: (str) => str,
+            done: (str) => str,
+            // RPIV phase colors (no color)
+            phaseRefine: (str) => str,
+            phaseResearch: (str) => str,
+            phasePlan: (str) => str,
+            phaseImplement: (str) => str,
+            phaseVerify: (str) => str,
+            reviewAction: (str) => str,
+            phaseComplete: (str) => str,
+        };
+    }
+    // Determine actual theme to use
+    let actualTheme;
+    if (preference === 'auto') {
+        actualTheme = detectTerminalTheme();
+    }
+    else {
+        actualTheme = preference;
+    }
+    // Light terminal optimized colors (darker, bolder colors)
+    if (actualTheme === 'light') {
+        return {
+            success: chalk.green.bold,
+            error: chalk.red.bold,
+            warning: chalk.hex('#CC6600'), // Darker orange
+            info: chalk.blue.bold,
+            dim: chalk.gray,
+            bold: chalk.bold,
+            backlog: chalk.gray.bold,
+            ready: chalk.blue.bold,
+            inProgress: chalk.hex('#CC6600'), // Darker orange instead of yellow
+            done: chalk.green.bold,
+            // RPIV phase colors (darker for light backgrounds)
+            phaseRefine: chalk.hex('#9932CC').bold, // Dark purple/magenta
+            phaseResearch: chalk.blue.bold, // Blue
+            phasePlan: chalk.hex('#008B8B').bold, // Dark cyan
+            phaseImplement: chalk.hex('#CC6600').bold, // Dark orange
+            phaseVerify: chalk.green.bold, // Green
+            reviewAction: chalk.hex('#008B8B').bold, // Distinct cyan with bold
+            phaseComplete: chalk.green.bold, // Success green
+        };
+    }
+    // Dark terminal optimized colors (bright, vibrant colors)
+    return {
+        success: chalk.green,
+        error: chalk.red,
+        warning: chalk.yellow,
+        info: chalk.cyan,
+        dim: chalk.dim,
+        bold: chalk.bold,
+        backlog: chalk.gray,
+        ready: chalk.blue,
+        inProgress: chalk.yellow,
+        done: chalk.green,
+        // RPIV phase colors (bright for dark backgrounds)
+        phaseRefine: chalk.magenta, // Magenta/purple
+        phaseResearch: chalk.blue, // Blue
+        phasePlan: chalk.cyan, // Cyan
+        phaseImplement: chalk.yellow, // Yellow
+        phaseVerify: chalk.green, // Green
+        reviewAction: chalk.cyan.bold, // Distinct cyan with bold
+        phaseComplete: chalk.green, // Success green
+    };
+}
+/**
+ * Get themed chalk instance based on configuration
+ * This is the main function to use in CLI commands
+ */
+export function getThemedChalk(config) {
+    const actualConfig = config || loadConfig();
+    return getThemeColors(actualConfig.theme);
+}
+//# sourceMappingURL=theme.js.map

package/dist/core/theme.js.map

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