rafcode 1.0.0

package/dist/utils/paths.js

@@ -0,0 +1,412 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export const RAF_DIR = 'RAF';
+// Base36 constants
+const BASE36_CHARS = '0123456789abcdefghijklmnopqrstuvwxyz';
+const BASE36_START = 1000; // First base36 project number
+const MAX_NUMERIC = 999; // Last numeric project number
+/**
+ * Encode a project number >= 1000 to a 3-character base36 string.
+ * The encoding offsets by 1000, so:
+ * - 1000 -> 'a00'
+ * - 1001 -> 'a01'
+ * - 1035 -> 'a0z'
+ * - 1036 -> 'a10'
+ * - etc.
+ *
+ * First character uses a-z (10-35 in base36, letters only).
+ * Second and third characters use 0-9a-z (0-35 in base36).
+ */
+export function encodeBase36(num) {
+    if (num < BASE36_START) {
+        throw new Error(`encodeBase36 only accepts numbers >= ${BASE36_START}, got ${num}`);
+    }
+    // Offset to get the base36 representation starting at 'a00' for 1000
+    const offset = num - BASE36_START;
+    // First character: 'a' + (offset / 36^2), uses only letters a-z
+    // This gives us 26 possible first characters (a-z)
+    const firstCharIndex = Math.floor(offset / (36 * 36));
+    if (firstCharIndex >= 26) {
+        throw new Error(`Project number ${num} exceeds maximum base36 capacity (max: ${BASE36_START + 26 * 36 * 36 - 1})`);
+    }
+    const firstChar = BASE36_CHARS[10 + firstCharIndex]; // Start from 'a' (index 10)
+    // Second and third characters: remaining value in base36
+    const remainder = offset % (36 * 36);
+    const secondCharIndex = Math.floor(remainder / 36);
+    const thirdCharIndex = remainder % 36;
+    const secondChar = BASE36_CHARS[secondCharIndex];
+    const thirdChar = BASE36_CHARS[thirdCharIndex];
+    return `${firstChar}${secondChar}${thirdChar}`;
+}
+/**
+ * Decode a 3-character base36 string to a project number.
+ * Returns the decoded number >= 1000, or null if invalid format.
+ */
+export function decodeBase36(str) {
+    if (str.length !== 3) {
+        return null;
+    }
+    const lower = str.toLowerCase();
+    const firstChar = lower.charAt(0);
+    const secondChar = lower.charAt(1);
+    const thirdChar = lower.charAt(2);
+    // First character must be a letter (a-z)
+    const firstIndex = BASE36_CHARS.indexOf(firstChar);
+    if (firstIndex < 10 || firstIndex > 35) {
+        return null; // Not a letter
+    }
+    // Second and third characters can be 0-9 or a-z
+    const secondIndex = BASE36_CHARS.indexOf(secondChar);
+    const thirdIndex = BASE36_CHARS.indexOf(thirdChar);
+    if (secondIndex === -1 || thirdIndex === -1) {
+        return null;
+    }
+    // Calculate the offset from 1000
+    const letterOffset = firstIndex - 10; // 'a' = 0, 'b' = 1, etc.
+    const offset = letterOffset * 36 * 36 + secondIndex * 36 + thirdIndex;
+    return BASE36_START + offset;
+}
+/**
+ * Check if a string is a valid base36 project prefix.
+ * Valid format: starts with a-z, followed by two base36 chars (0-9, a-z).
+ */
+export function isBase36Prefix(str) {
+    if (str.length !== 3) {
+        return false;
+    }
+    return /^[a-z][0-9a-z]{2}$/.test(str.toLowerCase());
+}
+export function getRafDir() {
+    return path.resolve(process.cwd(), RAF_DIR);
+}
+export function ensureRafDir() {
+    const rafDir = getRafDir();
+    if (!fs.existsSync(rafDir)) {
+        fs.mkdirSync(rafDir, { recursive: true });
+    }
+    return rafDir;
+}
+export function getNextProjectNumber(rafDir) {
+    if (!fs.existsSync(rafDir)) {
+        return 1;
+    }
+    const entries = fs.readdirSync(rafDir, { withFileTypes: true });
+    const numbers = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            // Try numeric format first (2-3 digits)
+            const numericMatch = entry.name.match(/^(\d{2,3})-/);
+            if (numericMatch && numericMatch[1]) {
+                numbers.push(parseInt(numericMatch[1], 10));
+                continue;
+            }
+            // Try base36 format
+            const base36Match = entry.name.match(/^([a-z][0-9a-z]{2})-/i);
+            if (base36Match && base36Match[1]) {
+                const decoded = decodeBase36(base36Match[1].toLowerCase());
+                if (decoded !== null) {
+                    numbers.push(decoded);
+                }
+            }
+        }
+    }
+    if (numbers.length === 0) {
+        return 1;
+    }
+    return Math.max(...numbers) + 1;
+}
+export function formatProjectNumber(num) {
+    if (num <= MAX_NUMERIC) {
+        return num.toString().padStart(3, '0');
+    }
+    return encodeBase36(num);
+}
+export function getProjectDir(rafDir, projectName) {
+    if (!fs.existsSync(rafDir)) {
+        return null;
+    }
+    const entries = fs.readdirSync(rafDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            // Try numeric format first
+            const numericMatch = entry.name.match(/^\d{2,3}-(.+)$/);
+            if (numericMatch && numericMatch[1] === projectName) {
+                return path.join(rafDir, entry.name);
+            }
+            // Try base36 format
+            const base36Match = entry.name.match(/^[a-z][0-9a-z]{2}-(.+)$/i);
+            if (base36Match && base36Match[1] === projectName) {
+                return path.join(rafDir, entry.name);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract project number prefix from a project path.
+ * Supports both numeric (001-999) and base36 (a00-zzz) formats.
+ * E.g., "/Users/foo/RAF/001-my-project" -> "001"
+ * E.g., "/Users/foo/RAF/a00-my-project" -> "a00"
+ * Returns the prefix string (e.g., "001" or "a00") or null if not found.
+ */
+export function extractProjectNumber(projectPath) {
+    const folderName = path.basename(projectPath);
+    // Try numeric format first (2-3 digits)
+    const numericMatch = folderName.match(/^(\d{2,3})-/);
+    if (numericMatch && numericMatch[1]) {
+        return numericMatch[1];
+    }
+    // Try base36 format (letter followed by two alphanumeric chars)
+    const base36Match = folderName.match(/^([a-z][0-9a-z]{2})-/i);
+    if (base36Match && base36Match[1]) {
+        return base36Match[1].toLowerCase();
+    }
+    return null;
+}
+/**
+ * Parse a project prefix string to its numeric value.
+ * Handles both numeric (001-999) and base36 (a00-zzz) formats.
+ * Returns the numeric project number or null if invalid.
+ */
+export function parseProjectPrefix(prefix) {
+    // Try numeric first
+    if (/^\d{2,3}$/.test(prefix)) {
+        return parseInt(prefix, 10);
+    }
+    // Try base36
+    if (isBase36Prefix(prefix)) {
+        return decodeBase36(prefix);
+    }
+    return null;
+}
+/**
+ * Extract project name from a project path (without number prefix).
+ * Supports both numeric (001-999) and base36 (a00-zzz) formats.
+ * E.g., "/Users/foo/RAF/001-my-project" -> "my-project"
+ * E.g., "/Users/foo/RAF/a00-my-project" -> "my-project"
+ * Returns the project name or null if not found.
+ */
+export function extractProjectName(projectPath) {
+    const folderName = path.basename(projectPath);
+    // Try numeric format first
+    const numericMatch = folderName.match(/^\d{2,3}-(.+)$/);
+    if (numericMatch && numericMatch[1]) {
+        return numericMatch[1];
+    }
+    // Try base36 format
+    const base36Match = folderName.match(/^[a-z][0-9a-z]{2}-(.+)$/i);
+    if (base36Match && base36Match[1]) {
+        return base36Match[1];
+    }
+    return null;
+}
+/**
+ * Extract task name from a plan filename (without number prefix and extension).
+ * E.g., "002-fix-login-bug.md" -> "fix-login-bug"
+ * Returns the task name or null if not found.
+ */
+export function extractTaskNameFromPlanFile(planFilename) {
+    const basename = path.basename(planFilename, '.md');
+    const match = basename.match(/^\d{2,3}-(.+)$/);
+    return match && match[1] ? match[1] : null;
+}
+export function listProjects(rafDir) {
+    if (!fs.existsSync(rafDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(rafDir, { withFileTypes: true });
+    const projects = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            // Try numeric format first
+            const numericMatch = entry.name.match(/^(\d{2,3})-(.+)$/);
+            if (numericMatch && numericMatch[1] && numericMatch[2]) {
+                projects.push({
+                    number: parseInt(numericMatch[1], 10),
+                    name: numericMatch[2],
+                    path: path.join(rafDir, entry.name),
+                });
+                continue;
+            }
+            // Try base36 format
+            const base36Match = entry.name.match(/^([a-z][0-9a-z]{2})-(.+)$/i);
+            if (base36Match && base36Match[1] && base36Match[2]) {
+                const decoded = decodeBase36(base36Match[1].toLowerCase());
+                if (decoded !== null) {
+                    projects.push({
+                        number: decoded,
+                        name: base36Match[2],
+                        path: path.join(rafDir, entry.name),
+                    });
+                }
+            }
+        }
+    }
+    return projects.sort((a, b) => a.number - b.number);
+}
+export function getPlansDir(projectPath) {
+    return path.join(projectPath, 'plans');
+}
+export function getOutcomesDir(projectPath) {
+    return path.join(projectPath, 'outcomes');
+}
+export function getOutcomeFilePath(projectPath, taskId, taskName) {
+    return path.join(projectPath, 'outcomes', `${taskId}-${taskName}.md`);
+}
+export function getDecisionsPath(projectPath) {
+    return path.join(projectPath, 'decisions.md');
+}
+export function getLogsDir(projectPath) {
+    return path.join(projectPath, 'logs');
+}
+export function getInputPath(projectPath) {
+    return path.join(projectPath, 'input.md');
+}
+/**
+ * Parse project information from a folder name.
+ * Returns null if the folder name doesn't match expected project format.
+ */
+function parseProjectFolder(rafDir, folderName) {
+    // Try numeric format first
+    const numericMatch = folderName.match(/^(\d{2,3})-(.+)$/);
+    if (numericMatch && numericMatch[1] && numericMatch[2]) {
+        return {
+            number: parseInt(numericMatch[1], 10),
+            name: numericMatch[2],
+            path: path.join(rafDir, folderName),
+            folder: folderName,
+        };
+    }
+    // Try base36 format
+    const base36Match = folderName.match(/^([a-z][0-9a-z]{2})-(.+)$/i);
+    if (base36Match && base36Match[1] && base36Match[2]) {
+        const decoded = decodeBase36(base36Match[1].toLowerCase());
+        if (decoded !== null) {
+            return {
+                number: decoded,
+                name: base36Match[2],
+                path: path.join(rafDir, folderName),
+                folder: folderName,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a project identifier with detailed result including ambiguity detection.
+ *
+ * Supported identifier formats (checked in this order):
+ * 1. Full folder name (e.g., "001-fix-stuff", "a01-important-project")
+ *    - Must be an exact match to an existing folder
+ *    - Pattern: numeric prefix (2-3 digits) or base36 prefix, followed by hyphen and name
+ * 2. Numeric ID (e.g., "003", "3", "1000")
+ *    - Looks up by project number
+ * 3. Base36 prefix (e.g., "a00", "a01")
+ *    - Looks up by base36 project number (for projects >= 1000)
+ * 4. Project name (e.g., "my-project", "fix-stuff")
+ *    - Looks up by the name portion of the folder (after the prefix)
+ *    - Case-insensitive matching
+ *    - Returns error if multiple projects have the same name
+ *
+ * @param rafDir - The RAF directory containing project folders
+ * @param identifier - The identifier to resolve
+ * @returns Resolution result with path, error type, and matches for ambiguous cases
+ */
+export function resolveProjectIdentifierWithDetails(rafDir, identifier) {
+    if (!fs.existsSync(rafDir)) {
+        return { path: null, error: 'not_found' };
+    }
+    // Pattern to match full folder names: NNN-name or XXX-name (base36)
+    // Supports 2-3 digit numeric prefixes or 3-char base36 prefixes
+    const fullFolderPattern = /^(\d{2,3}|[a-z][0-9a-z]{2})-(.+)$/i;
+    const fullFolderMatch = identifier.match(fullFolderPattern);
+    // Check if identifier is a full folder name (exact match required)
+    if (fullFolderMatch) {
+        // Check for exact case-insensitive match by listing directory
+        const entries = fs.readdirSync(rafDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && entry.name.toLowerCase() === identifier.toLowerCase()) {
+                return { path: path.join(rafDir, entry.name) };
+            }
+        }
+        // Full folder name format but doesn't exist as a folder.
+        // Fall through to name-based matching - the entire identifier might be a project name
+        // (e.g., "fix-double-summary-headers" looks like "fix-xxx" but is actually a name).
+    }
+    // Check if it's a numeric identifier (e.g., "003", "3", "1000")
+    const isNumeric = /^\d+$/.test(identifier);
+    // Check if it's a base36 identifier (e.g., "a00", "a01")
+    const isBase36 = isBase36Prefix(identifier);
+    // Convert base36 to numeric for matching
+    let targetNumber = null;
+    if (isNumeric) {
+        targetNumber = parseInt(identifier, 10);
+    }
+    else if (isBase36) {
+        targetNumber = decodeBase36(identifier);
+    }
+    const entries = fs.readdirSync(rafDir, { withFileTypes: true });
+    const nameMatches = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const project = parseProjectFolder(rafDir, entry.name);
+            if (project) {
+                if (targetNumber !== null) {
+                    // Match by number (either numeric or base36 identifier)
+                    if (project.number === targetNumber) {
+                        return { path: project.path };
+                    }
+                }
+                else {
+                    // Match by name (case-insensitive)
+                    if (project.name.toLowerCase() === identifier.toLowerCase()) {
+                        nameMatches.push(project);
+                    }
+                }
+            }
+        }
+    }
+    // Handle name matches
+    if (nameMatches.length === 1) {
+        return { path: nameMatches[0].path };
+    }
+    else if (nameMatches.length > 1) {
+        // Multiple projects with the same name - ambiguous
+        return {
+            path: null,
+            error: 'ambiguous',
+            matches: nameMatches.sort((a, b) => a.number - b.number),
+        };
+    }
+    return { path: null, error: 'not_found' };
+}
+/**
+ * Resolve a project identifier to a full project path.
+ *
+ * Supported identifier formats (checked in this order):
+ * 1. Full folder name (e.g., "001-fix-stuff", "a01-important-project")
+ *    - Must be an exact match to an existing folder
+ *    - Pattern: numeric prefix (2-3 digits) or base36 prefix, followed by hyphen and name
+ * 2. Numeric ID (e.g., "003", "3", "1000")
+ *    - Looks up by project number
+ * 3. Base36 prefix (e.g., "a00", "a01")
+ *    - Looks up by base36 project number (for projects >= 1000)
+ * 4. Project name (e.g., "my-project", "fix-stuff")
+ *    - Looks up by the name portion of the folder (after the prefix)
+ *    - Case-insensitive matching
+ *
+ * Note: For ambiguity detection (multiple projects with same name), use
+ * resolveProjectIdentifierWithDetails instead.
+ *
+ * This function is designed to be extensible for future task-level references
+ * like "001-project/002-task".
+ *
+ * @param rafDir - The RAF directory containing project folders
+ * @param identifier - The identifier to resolve
+ * @returns The full project path or null if not found (or ambiguous)
+ */
+export function resolveProjectIdentifier(rafDir, identifier) {
+    const result = resolveProjectIdentifierWithDetails(rafDir, identifier);
+    return result.path;
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

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

package/dist/utils/status-line.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Status line utility for displaying in-place updates during task execution.
+ * Uses carriage return to update the line without scrolling.
+ */
+export interface StatusLine {
+    update: (text: string) => void;
+    clear: () => void;
+}
+/**
+ * Creates a status line that can be updated in-place.
+ * The status line is cleared before any new content is written.
+ */
+export declare function createStatusLine(): StatusLine;
+//# sourceMappingURL=status-line.d.ts.map

package/dist/utils/status-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line.d.ts","sourceRoot":"","sources":["../../src/utils/status-line.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CA8B7C"}

package/dist/utils/status-line.js

@@ -0,0 +1,36 @@
+/**
+ * Status line utility for displaying in-place updates during task execution.
+ * Uses carriage return to update the line without scrolling.
+ */
+/**
+ * Creates a status line that can be updated in-place.
+ * The status line is cleared before any new content is written.
+ */
+export function createStatusLine() {
+    let lastLength = 0;
+    let isActive = false;
+    return {
+        update(text) {
+            // Only write to TTY
+            if (!process.stdout.isTTY) {
+                return;
+            }
+            isActive = true;
+            // Clear the previous line content and write new content
+            const clearStr = ' '.repeat(lastLength);
+            process.stdout.write(`\r${clearStr}\r${text}`);
+            lastLength = text.length;
+        },
+        clear() {
+            if (!process.stdout.isTTY || !isActive) {
+                return;
+            }
+            // Clear the line and reset cursor
+            const clearStr = ' '.repeat(lastLength);
+            process.stdout.write(`\r${clearStr}\r`);
+            lastLength = 0;
+            isActive = false;
+        },
+    };
+}
+//# sourceMappingURL=status-line.js.map

package/dist/utils/status-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line.js","sourceRoot":"","sources":["../../src/utils/status-line.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO;QACL,MAAM,CAAC,IAAY;YACjB,oBAAoB;YACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC1B,OAAO;YACT,CAAC;YAED,QAAQ,GAAG,IAAI,CAAC;YAChB,wDAAwD;YACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/C,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,KAAK;YACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACvC,OAAO;YACT,CAAC;YAED,kCAAkC;YAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;YACxC,UAAU,GAAG,CAAC,CAAC;YACf,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/terminal-symbols.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Terminal symbols and formatting helpers for beautiful terminal output.
+ * All functions are pure and testable - no side effects.
+ */
+/**
+ * Visual symbols for terminal output using dots/symbols style.
+ */
+export declare const SYMBOLS: {
+    readonly running: "●";
+    readonly completed: "✓";
+    readonly failed: "✗";
+    readonly pending: "○";
+    readonly blocked: "⊘";
+    readonly project: "▶";
+};
+export type TaskStatus = 'running' | 'completed' | 'failed' | 'pending' | 'blocked';
+/**
+ * Formats a single task progress line.
+ * @param current - Current task number (1-indexed)
+ * @param total - Total number of tasks
+ * @param status - Task status
+ * @param name - Task name
+ * @param elapsedMs - Optional elapsed time in milliseconds
+ * @returns Formatted string like "● auth-login 1:23" or "✓ auth-login 1/5"
+ */
+export declare function formatTaskProgress(current: number, total: number, status: TaskStatus, name: string, elapsedMs?: number): string;
+/**
+ * Formats a project header line.
+ * @param name - Project name
+ * @param taskCount - Number of tasks in the project
+ * @returns Formatted string like "▶ my-project (5 tasks)"
+ */
+export declare function formatProjectHeader(name: string, taskCount: number): string;
+/**
+ * Formats a summary line showing completion status.
+ * @param completed - Number of completed tasks
+ * @param failed - Number of failed tasks
+ * @param pending - Number of pending tasks
+ * @param elapsedMs - Optional total elapsed time in milliseconds
+ * @param blocked - Number of blocked tasks (default 0)
+ * @returns Formatted string like "✓ 5/5 completed in 12:34" or "✗ 3/5 (2 failed, 1 blocked)"
+ */
+export declare function formatSummary(completed: number, failed: number, pending: number, elapsedMs?: number, blocked?: number): string;
+/**
+ * Formats a compact progress bar showing task status as a sequence of symbols.
+ * @param tasks - Array of task statuses
+ * @returns Formatted string like "✓✓●○○"
+ */
+export declare function formatProgressBar(tasks: TaskStatus[]): string;
+//# sourceMappingURL=terminal-symbols.d.ts.map

package/dist/utils/terminal-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-symbols.d.ts","sourceRoot":"","sources":["../../src/utils/terminal-symbols.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAYpF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,MAAU,GAClB,MAAM,CAwBR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAM7D"}

package/dist/utils/terminal-symbols.js

@@ -0,0 +1,97 @@
+/**
+ * Terminal symbols and formatting helpers for beautiful terminal output.
+ * All functions are pure and testable - no side effects.
+ */
+import { formatElapsedTime } from './timer.js';
+/**
+ * Visual symbols for terminal output using dots/symbols style.
+ */
+export const SYMBOLS = {
+    running: '●',
+    completed: '✓',
+    failed: '✗',
+    pending: '○',
+    blocked: '⊘',
+    project: '▶',
+};
+/**
+ * Truncates a string to the specified length, adding ellipsis if needed.
+ */
+function truncate(str, maxLength) {
+    if (str.length <= maxLength) {
+        return str;
+    }
+    return str.slice(0, maxLength - 1) + '…';
+}
+/**
+ * Formats a single task progress line.
+ * @param current - Current task number (1-indexed)
+ * @param total - Total number of tasks
+ * @param status - Task status
+ * @param name - Task name
+ * @param elapsedMs - Optional elapsed time in milliseconds
+ * @returns Formatted string like "● auth-login 1:23" or "✓ auth-login 1/5"
+ */
+export function formatTaskProgress(current, total, status, name, elapsedMs) {
+    const symbol = SYMBOLS[status];
+    const displayName = truncate(name || 'task', 40);
+    // Show elapsed time for running tasks, completed tasks, and failed tasks
+    if (elapsedMs !== undefined) {
+        const timeStr = formatElapsedTime(elapsedMs);
+        return `${symbol} ${displayName} ${timeStr}`;
+    }
+    return `${symbol} ${displayName} ${current}/${total}`;
+}
+/**
+ * Formats a project header line.
+ * @param name - Project name
+ * @param taskCount - Number of tasks in the project
+ * @returns Formatted string like "▶ my-project (5 tasks)"
+ */
+export function formatProjectHeader(name, taskCount) {
+    const displayName = truncate(name || 'project', 50);
+    const taskWord = taskCount === 1 ? 'task' : 'tasks';
+    return `${SYMBOLS.project} ${displayName} (${taskCount} ${taskWord})`;
+}
+/**
+ * Formats a summary line showing completion status.
+ * @param completed - Number of completed tasks
+ * @param failed - Number of failed tasks
+ * @param pending - Number of pending tasks
+ * @param elapsedMs - Optional total elapsed time in milliseconds
+ * @param blocked - Number of blocked tasks (default 0)
+ * @returns Formatted string like "✓ 5/5 completed in 12:34" or "✗ 3/5 (2 failed, 1 blocked)"
+ */
+export function formatSummary(completed, failed, pending, elapsedMs, blocked = 0) {
+    const total = completed + failed + pending + blocked;
+    if (total === 0) {
+        return `${SYMBOLS.pending} no tasks`;
+    }
+    const hasFailures = failed > 0;
+    const hasBlocked = blocked > 0;
+    const symbol = hasFailures || hasBlocked ? SYMBOLS.failed : SYMBOLS.completed;
+    if (hasFailures || hasBlocked) {
+        const parts = [];
+        if (hasFailures) {
+            parts.push(failed === 1 ? '1 failed' : `${failed} failed`);
+        }
+        if (hasBlocked) {
+            parts.push(blocked === 1 ? '1 blocked' : `${blocked} blocked`);
+        }
+        return `${symbol} ${completed}/${total} (${parts.join(', ')})`;
+    }
+    const timeStr = elapsedMs !== undefined ? ` in ${formatElapsedTime(elapsedMs)}` : '';
+    return `${symbol} ${completed}/${total} completed${timeStr}`;
+}
+/**
+ * Formats a compact progress bar showing task status as a sequence of symbols.
+ * @param tasks - Array of task statuses
+ * @returns Formatted string like "✓✓●○○"
+ */
+export function formatProgressBar(tasks) {
+    if (tasks.length === 0) {
+        return '';
+    }
+    return tasks.map((status) => SYMBOLS[status]).join('');
+}
+//# sourceMappingURL=terminal-symbols.js.map

package/dist/utils/terminal-symbols.js.map

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

package/dist/utils/timer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Format elapsed time in human-readable format.
+ * - Under 1 minute: "Xs"
+ * - Under 1 hour: "Xm Ys"
+ * - 1 hour or more: "Xh Ym"
+ */
+export declare function formatElapsedTime(ms: number): string;
+export interface TaskTimer {
+    start: () => void;
+    stop: () => number;
+    getElapsed: () => number;
+}
+/**
+ * Creates a task timer that tracks elapsed time and can display a status line.
+ */
+export declare function createTaskTimer(onTick?: (elapsed: number) => void): TaskTimer;
+//# sourceMappingURL=timer.d.ts.map