@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/games/tetris/pieces.js

@@ -0,0 +1,271 @@
+/**
+ * Tetromino Pieces
+ *
+ * Standard 7 Tetris pieces with rotation states.
+ */
+// =============================================================================
+// Piece Definitions
+// =============================================================================
+// Each piece has 4 rotation states
+// Rotation follows SRS (Super Rotation System)
+const PIECES = {
+    // I-piece (cyan) - 4x4 bounding box
+    I: [
+        [
+            [0, 0, 0, 0],
+            [1, 1, 1, 1],
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+        ],
+        [
+            [0, 0, 1, 0],
+            [0, 0, 1, 0],
+            [0, 0, 1, 0],
+            [0, 0, 1, 0],
+        ],
+        [
+            [0, 0, 0, 0],
+            [0, 0, 0, 0],
+            [1, 1, 1, 1],
+            [0, 0, 0, 0],
+        ],
+        [
+            [0, 1, 0, 0],
+            [0, 1, 0, 0],
+            [0, 1, 0, 0],
+            [0, 1, 0, 0],
+        ],
+    ],
+    // O-piece (yellow) - 2x2, no rotation needed but we keep 4 states for consistency
+    O: [
+        [
+            [1, 1],
+            [1, 1],
+        ],
+        [
+            [1, 1],
+            [1, 1],
+        ],
+        [
+            [1, 1],
+            [1, 1],
+        ],
+        [
+            [1, 1],
+            [1, 1],
+        ],
+    ],
+    // T-piece (purple)
+    T: [
+        [
+            [0, 1, 0],
+            [1, 1, 1],
+            [0, 0, 0],
+        ],
+        [
+            [0, 1, 0],
+            [0, 1, 1],
+            [0, 1, 0],
+        ],
+        [
+            [0, 0, 0],
+            [1, 1, 1],
+            [0, 1, 0],
+        ],
+        [
+            [0, 1, 0],
+            [1, 1, 0],
+            [0, 1, 0],
+        ],
+    ],
+    // S-piece (green)
+    S: [
+        [
+            [0, 1, 1],
+            [1, 1, 0],
+            [0, 0, 0],
+        ],
+        [
+            [0, 1, 0],
+            [0, 1, 1],
+            [0, 0, 1],
+        ],
+        [
+            [0, 0, 0],
+            [0, 1, 1],
+            [1, 1, 0],
+        ],
+        [
+            [1, 0, 0],
+            [1, 1, 0],
+            [0, 1, 0],
+        ],
+    ],
+    // Z-piece (red)
+    Z: [
+        [
+            [1, 1, 0],
+            [0, 1, 1],
+            [0, 0, 0],
+        ],
+        [
+            [0, 0, 1],
+            [0, 1, 1],
+            [0, 1, 0],
+        ],
+        [
+            [0, 0, 0],
+            [1, 1, 0],
+            [0, 1, 1],
+        ],
+        [
+            [0, 1, 0],
+            [1, 1, 0],
+            [1, 0, 0],
+        ],
+    ],
+    // J-piece (blue)
+    J: [
+        [
+            [1, 0, 0],
+            [1, 1, 1],
+            [0, 0, 0],
+        ],
+        [
+            [0, 1, 1],
+            [0, 1, 0],
+            [0, 1, 0],
+        ],
+        [
+            [0, 0, 0],
+            [1, 1, 1],
+            [0, 0, 1],
+        ],
+        [
+            [0, 1, 0],
+            [0, 1, 0],
+            [1, 1, 0],
+        ],
+    ],
+    // L-piece (orange)
+    L: [
+        [
+            [0, 0, 1],
+            [1, 1, 1],
+            [0, 0, 0],
+        ],
+        [
+            [0, 1, 0],
+            [0, 1, 0],
+            [0, 1, 1],
+        ],
+        [
+            [0, 0, 0],
+            [1, 1, 1],
+            [1, 0, 0],
+        ],
+        [
+            [1, 1, 0],
+            [0, 1, 0],
+            [0, 1, 0],
+        ],
+    ],
+};
+// Color mapping (1-7)
+const PIECE_COLORS = {
+    I: 1, // Cyan
+    O: 2, // Yellow
+    T: 3, // Purple
+    S: 4, // Green
+    Z: 5, // Red
+    J: 6, // Blue
+    L: 7, // Orange
+};
+// All piece types for random selection
+const PIECE_TYPES = ['I', 'O', 'T', 'S', 'Z', 'J', 'L'];
+// =============================================================================
+// Piece Functions
+// =============================================================================
+/**
+ * Get a piece shape at a specific rotation
+ */
+export function getPieceShape(type, rotation) {
+    const rotations = PIECES[type];
+    return rotations[rotation % rotations.length];
+}
+/**
+ * Get piece color
+ */
+export function getPieceColor(type) {
+    return PIECE_COLORS[type];
+}
+/**
+ * Create a new piece
+ */
+export function createPiece(type, rotation = 0) {
+    return {
+        type,
+        shape: getPieceShape(type, rotation),
+        color: getPieceColor(type),
+    };
+}
+/**
+ * Rotate a piece clockwise
+ */
+export function rotatePiece(piece, rotation) {
+    return {
+        ...piece,
+        shape: getPieceShape(piece.type, rotation),
+    };
+}
+/**
+ * Get a random piece type
+ */
+export function getRandomPieceType() {
+    return PIECE_TYPES[Math.floor(Math.random() * PIECE_TYPES.length)];
+}
+/**
+ * Generate a bag of 7 pieces (one of each type, shuffled)
+ * This is the "7-bag" randomizer used in modern Tetris
+ */
+export function generatePieceBag() {
+    const bag = [...PIECE_TYPES];
+    // Fisher-Yates shuffle
+    for (let i = bag.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [bag[i], bag[j]] = [bag[j], bag[i]];
+    }
+    return bag;
+}
+/**
+ * Get piece width (for centering)
+ */
+export function getPieceWidth(piece) {
+    let minCol = piece.shape[0].length;
+    let maxCol = 0;
+    for (const row of piece.shape) {
+        for (let col = 0; col < row.length; col++) {
+            if (row[col]) {
+                minCol = Math.min(minCol, col);
+                maxCol = Math.max(maxCol, col);
+            }
+        }
+    }
+    return maxCol - minCol + 1;
+}
+/**
+ * Get piece height (for preview)
+ */
+export function getPieceHeight(piece) {
+    let minRow = piece.shape.length;
+    let maxRow = 0;
+    for (let row = 0; row < piece.shape.length; row++) {
+        for (let col = 0; col < piece.shape[row].length; col++) {
+            if (piece.shape[row][col]) {
+                minRow = Math.min(minRow, row);
+                maxRow = Math.max(maxRow, row);
+            }
+        }
+    }
+    return maxRow - minRow + 1;
+}

package/dist/games/tetris/renderer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tetris Renderer
+ *
+ * Color handling and theme integration for Tetris.
+ */
+export interface GameColors {
+    title: (text: string) => string;
+    label: (text: string) => string;
+    value: (text: string) => string;
+    score: (text: string) => string;
+    muted: (text: string) => string;
+    piece: (color: number, text: string) => string;
+    ghost: (text: string) => string;
+    overlay: (text: string) => string;
+    gameOver: (text: string) => string;
+    highScore: (text: string) => string;
+    cursor: (text: string) => string;
+}
+/**
+ * Get theme-aware colors for the game
+ */
+export declare function getGameColors(): GameColors;
+/**
+ * Get simple ANSI colors (fallback if theme not available)
+ */
+export declare function getDefaultColors(): GameColors;

package/dist/games/tetris/renderer.js

@@ -0,0 +1,77 @@
+/**
+ * Tetris Renderer
+ *
+ * Color handling and theme integration for Tetris.
+ */
+import chalk from 'chalk';
+import { getThemeColors as getThemeColorsFromTheme, getStyles } from '../../themes/index.js';
+// =============================================================================
+// Color Functions
+// =============================================================================
+/**
+ * Get theme-aware colors for the game
+ */
+export function getGameColors() {
+    const colors = getThemeColorsFromTheme();
+    const s = getStyles();
+    // Semantic colors (same as in themes/colors.ts)
+    const SEMANTIC_SUCCESS = '#50fa7b';
+    const SEMANTIC_WARNING = '#f1fa8c';
+    const SEMANTIC_ERROR = '#ff5555';
+    // Map piece numbers to theme colors
+    const pieceColorFns = {
+        1: (text) => chalk.hex(colors.primary)(text), // I - cyan/primary
+        2: (text) => chalk.hex(SEMANTIC_WARNING)(text), // O - yellow/warning
+        3: (text) => chalk.hex(colors.secondary ?? colors.primary)(text), // T - purple/secondary
+        4: (text) => chalk.hex(SEMANTIC_SUCCESS)(text), // S - green/success
+        5: (text) => chalk.hex(SEMANTIC_ERROR)(text), // Z - red/error
+        6: (text) => chalk.hex(colors.primary).bold(text), // J - blue/primary bold
+        7: (text) => chalk.hex(SEMANTIC_WARNING).bold(text), // L - orange/warning bold
+    };
+    return {
+        title: (text) => s.primaryBold(text),
+        label: (text) => s.secondary(text),
+        value: (text) => text,
+        score: (text) => s.primaryBold(text),
+        muted: (text) => s.muted(text),
+        piece: (color, text) => {
+            const colorFn = pieceColorFns[color];
+            return colorFn ? colorFn(text) : text;
+        },
+        ghost: (text) => s.muted(text),
+        overlay: (text) => chalk.inverse(text),
+        gameOver: (text) => s.error(text),
+        highScore: (text) => s.warning(text),
+        cursor: (text) => chalk.inverse(text),
+    };
+}
+/**
+ * Get simple ANSI colors (fallback if theme not available)
+ */
+export function getDefaultColors() {
+    return {
+        title: (text) => chalk.cyan.bold(text),
+        label: (text) => chalk.white(text),
+        value: (text) => chalk.white(text),
+        score: (text) => chalk.yellow.bold(text),
+        muted: (text) => chalk.gray(text),
+        piece: (color, text) => {
+            const colorFns = {
+                1: (t) => chalk.cyan(t),
+                2: (t) => chalk.yellow(t),
+                3: (t) => chalk.magenta(t),
+                4: (t) => chalk.green(t),
+                5: (t) => chalk.red(t),
+                6: (t) => chalk.blue(t),
+                7: (t) => chalk.rgb(255, 165, 0)(t), // Orange
+            };
+            const fn = colorFns[color];
+            return fn ? fn(text) : text;
+        },
+        ghost: (text) => chalk.gray(text),
+        overlay: (text) => chalk.inverse(text),
+        gameOver: (text) => chalk.red.bold(text),
+        highScore: (text) => chalk.yellow.bold(text),
+        cursor: (text) => chalk.inverse(text),
+    };
+}

package/dist/guide/guide-content.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Guide Content
+ *
+ * Documentation for the compilr_guide tool.
+ * Uses shared content from shared-content.ts for topics that overlap with tutorials.
+ */
+import { searchContentTopics, getAllTopicIds } from './shared-content.js';
+export interface GuideEntry {
+    id: string;
+    title: string;
+    keywords: string[];
+    content: string;
+}
+export declare const guideEntries: GuideEntry[];
+/**
+ * Search guide entries by keyword or topic.
+ */
+export declare function searchGuide(query: string): GuideEntry[];
+/**
+ * Get all available topics for listing.
+ */
+export declare function getGuideTopics(): string[];
+export { searchContentTopics, getAllTopicIds };

package/dist/guide/guide-content.js

@@ -0,0 +1,196 @@
+/**
+ * Guide Content
+ *
+ * Documentation for the compilr_guide tool.
+ * Uses shared content from shared-content.ts for topics that overlap with tutorials.
+ */
+import { CONTENT_TOPICS, topicToPlainText, searchContentTopics, getAllTopicIds, } from './shared-content.js';
+// =============================================================================
+// Guide-Only Entries (not in tutorials)
+// =============================================================================
+const GUIDE_ONLY_ENTRIES = [
+    {
+        id: 'overview',
+        title: 'Compilr Dev CLI Overview',
+        keywords: ['overview', 'what is', 'introduction', 'about', 'compilr'],
+        content: `
+Compilr Dev CLI is an AI-powered coding assistant that helps you build software projects.
+
+Key features:
+- Multi-LLM support (Claude, OpenAI, Gemini, Ollama)
+- Project management with structured workflows
+- Requirements gathering with /design command
+- Backlog tracking with /backlog command
+- Team agents for specialized assistance ($arch, $pm, $qa, etc.)
+- Session persistence and context management
+
+The CLI has two main interfaces:
+1. Dashboard - A menu-based interface for project management
+2. REPL - A command-line interface for chatting with the AI
+
+Run "compilr" to start. Use /help to see all commands.
+`.trim(),
+    },
+    {
+        id: 'workflow-modes',
+        title: 'Workflow Modes',
+        keywords: ['workflow', 'flexible', 'guided', 'mode'],
+        content: `
+Two workflow modes are available:
+
+Flexible (recommended):
+- Work at your own pace
+- AI responds to your requests
+- No enforced structure
+- Best for experienced developers
+
+Guided:
+- AI suggests next steps
+- Tracks work item progress
+- More structured approach
+- Best for learning the workflow
+
+Switch modes with /workflow command.
+
+The footer shows current mode: "mode: Normal" or "mode: Guided"
+`.trim(),
+    },
+    {
+        id: 'workflow-recommended',
+        title: 'Recommended Workflow',
+        keywords: ['workflow', 'how to', 'best practice', 'process'],
+        content: `
+Recommended workflow for new projects:
+
+1. Create project with /new
+   - Choose your tech stack
+   - Set up git repository
+
+2. Plan with /design
+   - Describe what you want to build
+   - AI asks clarifying questions
+   - Generates PRD and backlog items
+
+3. Review backlog with /backlog
+   - See all work items
+   - Prioritize tasks
+   - Pick one to start
+
+4. Build features
+   - Ask AI to implement from backlog
+   - "Build REQ-001: User authentication"
+   - Review and iterate
+
+5. Manage context
+   - Use /compact when context fills up
+   - Add /anchors for important decisions
+   - Use /resume to continue later
+`.trim(),
+    },
+    {
+        id: 'command-resume',
+        title: '/resume Command',
+        keywords: ['/resume', 'resume', 'session', 'continue', 'previous'],
+        content: `
+/resume - Continue a previous session.
+
+Sessions are auto-saved after each AI response.
+
+The overlay shows:
+- Recent: Sessions from current project
+- All: Sessions from all projects
+- Session date, message count, and preview
+
+Actions:
+  j/k      Navigate sessions
+  /        Search sessions
+  Enter    Resume selected session
+  d        Delete session
+  q/Esc    Close
+
+What's saved in a session:
+- Conversation history (all messages)
+- Todo list items
+- Workflow state (mode, current work item)
+- Token usage
+
+What's NOT in sessions (per-project instead):
+- Anchors (persistent across sessions)
+- Team agent configurations
+- Documents (PRD, backlog, etc.)
+
+Cross-project sessions show a warning before resuming.
+`.trim(),
+    },
+    {
+        id: 'command-team',
+        title: '/team Command',
+        keywords: ['/team', 'team', 'agents', 'manage'],
+        content: `
+/team - View and manage team agents.
+
+The overlay shows:
+- All available agents
+- Current agent (marked with ★)
+- Agent status and context usage
+
+Tabs:
+  Agents     List of all agents
+  Context    Per-agent token usage
+
+Switch agents by selecting one and pressing Enter.
+Or use $ prefix in REPL: $arch, $pm, $qa, etc.
+`.trim(),
+    },
+];
+// =============================================================================
+// Combined Guide Entries
+// =============================================================================
+/**
+ * Build guide entries from shared content and guide-only entries.
+ */
+function buildGuideEntries() {
+    const entries = [...GUIDE_ONLY_ENTRIES];
+    // Convert shared content topics to guide entries
+    for (const topic of CONTENT_TOPICS) {
+        entries.push({
+            id: topic.id,
+            title: topic.title,
+            keywords: topic.keywords,
+            content: topicToPlainText(topic),
+        });
+    }
+    return entries;
+}
+export const guideEntries = buildGuideEntries();
+// =============================================================================
+// Search Functions
+// =============================================================================
+/**
+ * Search guide entries by keyword or topic.
+ */
+export function searchGuide(query) {
+    const q = query.toLowerCase().trim();
+    // Exact ID match
+    const exactMatch = guideEntries.find((e) => e.id === q);
+    if (exactMatch)
+        return [exactMatch];
+    // Command match (e.g., "/design" or "design")
+    const cmdQuery = q.startsWith('/') ? q : `/${q}`;
+    const cmdMatch = guideEntries.find((e) => e.keywords.includes(cmdQuery) || e.keywords.includes(q));
+    if (cmdMatch)
+        return [cmdMatch];
+    // Keyword search
+    const matches = guideEntries.filter((e) => e.keywords.some((k) => k.includes(q) || q.includes(k)) ||
+        e.title.toLowerCase().includes(q) ||
+        e.content.toLowerCase().includes(q));
+    return matches.slice(0, 3); // Return top 3 matches
+}
+/**
+ * Get all available topics for listing.
+ */
+export function getGuideTopics() {
+    return guideEntries.map((e) => e.id);
+}
+// Re-export shared content helpers for use elsewhere
+export { searchContentTopics, getAllTopicIds };

package/dist/guide/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compilr Guide Module
+ *
+ * Provides documentation for the AI agent to answer user questions
+ * about how to use the CLI.
+ */
+export { searchGuide, getGuideTopics, guideEntries } from './guide-content.js';
+export type { GuideEntry } from './guide-content.js';

package/dist/guide/index.js

@@ -0,0 +1,7 @@
+/**
+ * Compilr Guide Module
+ *
+ * Provides documentation for the AI agent to answer user questions
+ * about how to use the CLI.
+ */
+export { searchGuide, getGuideTopics, guideEntries } from './guide-content.js';

package/dist/guide/shared-content.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared Content - Single Source of Truth
+ *
+ * Raw text content used by both:
+ * - compilr_guide tool (for AI agent)
+ * - /tutorial overlay (for user)
+ *
+ * Content is stored as plain text with simple structure.
+ * Styling is applied at render time by each consumer.
+ */
+export interface ContentSection {
+    title?: string;
+    items: string[];
+}
+export interface ContentTopic {
+    id: string;
+    title: string;
+    keywords: string[];
+    sections: ContentSection[];
+}
+export declare const CONTENT_TOPICS: ContentTopic[];
+/**
+ * Find a content topic by ID.
+ */
+export declare function getContentTopic(id: string): ContentTopic | undefined;
+/**
+ * Find content topics by keyword.
+ */
+export declare function searchContentTopics(query: string): ContentTopic[];
+/**
+ * Convert a content topic to plain text (for guide tool).
+ */
+export declare function topicToPlainText(topic: ContentTopic): string;
+/**
+ * Get all topic IDs.
+ */
+export declare function getAllTopicIds(): string[];