@compilr-dev/cli 0.4.0

package/dist/templates/readme-md.js

@@ -0,0 +1,161 @@
+/**
+ * README.md Template Generator
+ *
+ * Generates the project README with next steps.
+ */
+import { TECH_STACK_LABELS } from './types.js';
+export function generateReadmeMd(config) {
+    const techStackSetup = getTechStackSetup(config.techStack);
+    return `# ${config.name}
+
+${config.description}
+
+---
+
+## Getting Started
+
+### Prerequisites
+
+${getPrerequisites(config.techStack)}
+
+### Installation
+
+\`\`\`bash
+cd ${config.name}
+${techStackSetup.install}
+\`\`\`
+
+### Development
+
+\`\`\`bash
+${techStackSetup.dev}
+\`\`\`
+
+---
+
+## Project Structure
+
+\`\`\`
+${config.name}/
+├── src/                   # Source code
+${config.repoPattern === 'single' ? `├── .compilr/              # Workflow files (backlog, sessions, etc.)
+├── COMPILR.md             # AI assistant context` : ''}
+├── package.json
+└── README.md
+\`\`\`
+${config.repoPattern === 'two-repo' ? `
+**Documentation repo:** \`${config.name}-docs/\`
+` : ''}
+
+---
+
+## Next Steps
+
+1. ${techStackSetup.nextSteps[0]}
+2. ${techStackSetup.nextSteps[1]}
+3. ${techStackSetup.nextSteps[2]}
+4. Start coding with \`compilr start\`
+
+---
+
+## Workflow Commands
+
+\`\`\`bash
+compilr start       # Begin coding session with context loaded
+compilr save        # Save session progress and generate notes
+compilr backlog     # View and manage tasks
+compilr resume      # Restore context after interruption
+\`\`\`
+
+---
+
+## Tech Stack
+
+**${TECH_STACK_LABELS[config.techStack]}**
+
+${techStackSetup.description}
+
+---
+
+## License
+
+*Add your license here*
+
+---
+
+*Created with [compilr-dev-cli](https://github.com/scozzola/compilr-dev-cli)*
+`;
+}
+function getPrerequisites(techStack) {
+    const common = '- Node.js 20+\n- npm or yarn';
+    if (techStack === 'react-python-pg') {
+        return `${common}\n- Python 3.11+\n- PostgreSQL 15+`;
+    }
+    return `${common}\n- PostgreSQL 15+ (for database)`;
+}
+function getTechStackSetup(techStack) {
+    const setups = {
+        'react-node-pg': {
+            install: 'npm install',
+            dev: 'npm run dev',
+            description: `
+| Layer | Technology |
+|-------|------------|
+| Frontend | React 18, Vite, TypeScript |
+| Backend | Node.js, Express, TypeScript |
+| Database | PostgreSQL |
+| ORM | Prisma |
+`,
+            nextSteps: [
+                'Install dependencies: `npm install`',
+                'Set up PostgreSQL and configure `.env`',
+                'Run database migrations: `npx prisma migrate dev`',
+            ],
+        },
+        'react-python-pg': {
+            install: 'npm install  # Frontend\npip install -r requirements.txt  # Backend',
+            dev: 'npm run dev     # Frontend\nuvicorn main:app --reload  # Backend',
+            description: `
+| Layer | Technology |
+|-------|------------|
+| Frontend | React 18, Vite, TypeScript |
+| Backend | Python, FastAPI |
+| Database | PostgreSQL |
+| ORM | SQLAlchemy |
+`,
+            nextSteps: [
+                'Install frontend deps: `npm install`',
+                'Install backend deps: `pip install -r requirements.txt`',
+                'Set up PostgreSQL and configure environment',
+            ],
+        },
+        'vue-node-pg': {
+            install: 'npm install',
+            dev: 'npm run dev',
+            description: `
+| Layer | Technology |
+|-------|------------|
+| Frontend | Vue 3, Vite, TypeScript |
+| Backend | Node.js, Express, TypeScript |
+| Database | PostgreSQL |
+| ORM | Prisma |
+`,
+            nextSteps: [
+                'Install dependencies: `npm install`',
+                'Set up PostgreSQL and configure `.env`',
+                'Run database migrations: `npx prisma migrate dev`',
+            ],
+        },
+        custom: {
+            install: '# Add your installation command',
+            dev: '# Add your development command',
+            description: '*Configure your tech stack*',
+            nextSteps: [
+                'Choose and set up your tech stack',
+                'Configure development environment',
+                'Update this README with your stack details',
+            ],
+        },
+    };
+    return setups[techStack] ?? setups.custom;
+}

package/dist/templates/tsconfig.d.ts

@@ -0,0 +1,7 @@
+/**
+ * TSConfig Template Generator
+ *
+ * Generates a tsconfig.json file based on coding standards.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateTsconfig(config: ProjectConfig): string;

package/dist/templates/tsconfig.js

@@ -0,0 +1,61 @@
+/**
+ * TSConfig Template Generator
+ *
+ * Generates a tsconfig.json file based on coding standards.
+ */
+export function generateTsconfig(config) {
+    const tsconfig = getTsconfigTemplate(config);
+    return JSON.stringify(tsconfig, null, 2) + '\n';
+}
+function getTsconfigTemplate(config) {
+    // Base config for all presets
+    const base = {
+        compilerOptions: {
+            target: 'ES2022',
+            useDefineForClassFields: true,
+            module: 'ESNext',
+            lib: ['ES2022', 'DOM', 'DOM.Iterable'],
+            skipLibCheck: true,
+            // Bundler mode
+            moduleResolution: 'bundler',
+            allowImportingTsExtensions: true,
+            resolveJsonModule: true,
+            isolatedModules: true,
+            noEmit: true,
+            // JSX for React/Vue
+            jsx: config.techStack === 'vue-node-pg' ? 'preserve' : 'react-jsx',
+            // Common strict settings
+            esModuleInterop: true,
+            forceConsistentCasingInFileNames: true,
+        },
+        include: ['src'],
+        exclude: ['node_modules'],
+    };
+    // Apply coding standards
+    if (config.codingStandards === 'strict') {
+        return {
+            ...base,
+            compilerOptions: {
+                ...base.compilerOptions,
+                strict: true,
+                noUncheckedIndexedAccess: true,
+                noImplicitReturns: true,
+                noFallthroughCasesInSwitch: true,
+                noUnusedLocals: true,
+                noUnusedParameters: true,
+                exactOptionalPropertyTypes: true,
+            },
+        };
+    }
+    if (config.codingStandards === 'relaxed') {
+        return {
+            ...base,
+            compilerOptions: {
+                ...base.compilerOptions,
+                strict: true,
+            },
+        };
+    }
+    // Custom - minimal config
+    return base;
+}

package/dist/templates/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Project Configuration Types
+ *
+ * Shared types for project initialization templates.
+ */
+export type TechStack = 'react-node-pg' | 'react-python-pg' | 'vue-node-pg' | 'custom';
+export declare const TECH_STACK_LABELS: Record<TechStack, string>;
+export type CodingStandards = 'strict' | 'relaxed' | 'custom';
+export declare const CODING_STANDARDS_LABELS: Record<CodingStandards, string>;
+export type RepoPattern = 'single' | 'two-repo';
+export declare const REPO_PATTERN_LABELS: Record<RepoPattern, string>;
+export interface ProjectConfig {
+    /** Project name (lowercase, alphanumeric + hyphens) */
+    name: string;
+    /** Project description (1-2 sentences) */
+    description: string;
+    /** Repository pattern */
+    repoPattern: RepoPattern;
+    /** Selected tech stack */
+    techStack: TechStack;
+    /** Coding standards preset */
+    codingStandards: CodingStandards;
+    /** Whether to initialize git */
+    initGit: boolean;
+}
+export interface GenerationResult {
+    success: boolean;
+    projectPath: string;
+    docsPath?: string;
+    filesCreated: string[];
+    error?: string;
+}
+export declare const WORKFLOW_VERSION = "1.0.0";

package/dist/templates/types.js

@@ -0,0 +1,24 @@
+/**
+ * Project Configuration Types
+ *
+ * Shared types for project initialization templates.
+ */
+export const TECH_STACK_LABELS = {
+    'react-node-pg': 'React + Node.js + PostgreSQL',
+    'react-python-pg': 'React + Python + PostgreSQL',
+    'vue-node-pg': 'Vue + Node.js + PostgreSQL',
+    custom: 'Custom (configure later)',
+};
+export const CODING_STANDARDS_LABELS = {
+    strict: 'TypeScript Strict (recommended)',
+    relaxed: 'TypeScript Relaxed',
+    custom: 'Custom (configure later)',
+};
+export const REPO_PATTERN_LABELS = {
+    single: 'Single repo (.compilr/ folder + COMPILR.md in project root)',
+    'two-repo': 'Two repos (project/ + project-docs/ separate repositories)',
+};
+// =============================================================================
+// Workflow Version
+// =============================================================================
+export const WORKFLOW_VERSION = '1.0.0';

package/dist/test-autocomplete.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Test script for slash command autocomplete
+ *
+ * Run with: npx tsx src/test-autocomplete.ts
+ */
+export {};

package/dist/test-autocomplete.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Test script for slash command autocomplete
+ *
+ * Run with: npx tsx src/test-autocomplete.ts
+ */
+import pc from 'picocolors';
+import { createInteractiveInput, SLASH_COMMANDS } from './slash-autocomplete.js';
+console.log(pc.bold(pc.cyan('Slash Command Autocomplete Test')));
+console.log(pc.dim('─'.repeat(40)));
+console.log('');
+console.log(pc.dim('Available commands:'));
+for (const cmd of SLASH_COMMANDS) {
+    console.log(pc.dim(`  ${cmd.name.padEnd(12)} ${cmd.description}`));
+}
+console.log('');
+console.log(pc.dim('Instructions:'));
+console.log(pc.dim('  • Type "/" to see autocomplete dropdown'));
+console.log(pc.dim('  • Use ↑↓ arrows to navigate'));
+console.log(pc.dim('  • Press Tab to autocomplete selected'));
+console.log(pc.dim('  • Press Enter to execute'));
+console.log(pc.dim('  • Press Esc to close dropdown'));
+console.log(pc.dim('  • Type "quit" to exit'));
+console.log('');
+const prompt = pc.bold(pc.blue('Test> '));
+const handleSubmit = (input) => {
+    if (input.trim().toLowerCase() === 'quit') {
+        console.log(pc.dim('Goodbye!'));
+        inputHandler.stop();
+        process.exit(0);
+    }
+    if (input.trim()) {
+        console.log(pc.green('Received: ') + pc.cyan(input));
+        // Handle the command
+        if (input.startsWith('/')) {
+            const cmd = input.slice(1).toLowerCase();
+            switch (cmd) {
+                case 'exit':
+                case 'quit':
+                case 'q':
+                    console.log(pc.dim('Goodbye!'));
+                    inputHandler.stop();
+                    process.exit(0);
+                    break;
+                case 'help':
+                case '?':
+                    console.log(pc.bold('\nAvailable commands:'));
+                    for (const c of SLASH_COMMANDS) {
+                        console.log(`  ${pc.cyan(c.name.padEnd(12))} ${c.description}`);
+                    }
+                    break;
+                case 'clear':
+                    console.log(pc.green('✓') + ' History cleared');
+                    break;
+                case 'tools':
+                    console.log(pc.green('✓') + ' Would list tools here');
+                    break;
+                case 'tokens':
+                    console.log(pc.green('✓') + ' Would show token usage here');
+                    break;
+                case 'context':
+                    console.log(pc.green('✓') + ' Would show context info here');
+                    break;
+                case 'compact':
+                    console.log(pc.green('✓') + ' Would compact context here');
+                    break;
+                default:
+                    console.log(pc.yellow(`Unknown command: ${input}`));
+            }
+        }
+    }
+    console.log('');
+    // Show prompt for next input (handler stays running)
+    process.stdout.write(prompt);
+};
+// Don't show separator for test - simpler continuous REPL
+const inputHandler = createInteractiveInput(prompt, handleSubmit, false);
+// Handle Ctrl+C
+process.on('SIGINT', () => {
+    console.log('\n' + pc.dim('Interrupted.'));
+    inputHandler.stop();
+    process.exit(0);
+});
+// Start
+inputHandler.start();

package/dist/test-tabbed-menu.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Test script for tabbed help menu (Claude Code-style)
+ *
+ * Run with: npx tsx src/test-tabbed-menu.ts
+ */
+export {};

package/dist/test-tabbed-menu.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * Test script for tabbed help menu (Claude Code-style)
+ *
+ * Run with: npx tsx src/test-tabbed-menu.ts
+ */
+import { showHelpMenu } from './tabbed-menu.js';
+import pc from 'picocolors';
+console.log(pc.bold(pc.cyan('Tabbed Help Menu Test')));
+console.log(pc.dim('─'.repeat(40)));
+console.log('');
+console.log(pc.dim('This is some terminal history that should remain visible.'));
+console.log(pc.dim('The help menu will appear below without clearing this.'));
+console.log('');
+console.log(pc.dim('Instructions:'));
+console.log(pc.dim('  • Press Tab to cycle through tabs'));
+console.log(pc.dim('  • Press ↑/↓ to navigate commands list'));
+console.log(pc.dim('  • Press Esc to close the menu'));
+console.log('');
+// Show the help menu
+showHelpMenu().then(() => {
+    console.log(pc.green('✓') + ' Help menu closed');
+    console.log(pc.dim('Notice how the history above is preserved!'));
+    process.exit(0);
+});

package/dist/themes/colors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Theme Colors
+ *
+ * Creates style functions from a theme's color palette.
+ * Uses chalk for hex color support.
+ *
+ * Usage:
+ *   import { getStyles } from './themes/colors.js';
+ *   const s = getStyles();
+ *   console.log(s.primary('Hello'));  // Colored with theme's primary
+ *   console.log(s.muted('dim text')); // Colored with theme's muted
+ */
+import type { Theme, ThemeStyleFunctions } from './types.js';
+/**
+ * Create style functions from a theme
+ */
+export declare function createThemeStyles(theme: Theme): ThemeStyleFunctions;
+/**
+ * Get style functions for the current theme
+ *
+ * This is the main entry point for using theme colors throughout the app.
+ * Styles are cached and automatically updated when the theme changes.
+ *
+ * Usage:
+ *   import { getStyles } from './themes/colors.js';
+ *   const s = getStyles();
+ *   console.log(s.primary('Hello'));
+ */
+export declare function getStyles(): ThemeStyleFunctions;
+/**
+ * Clear style cache (call after theme change)
+ */
+export declare function clearStyleCache(): void;
+/**
+ * Get the current theme's raw colors
+ */
+export declare function getThemeColors(): Theme['colors'];
+/**
+ * Check if current theme is dark
+ */
+export declare function isDarkTheme(): boolean;
+/**
+ * Check if current theme is light
+ */
+export declare function isLightTheme(): boolean;
+/**
+ * Plain style functions (no colors, for testing or non-TTY)
+ */
+export declare const plainStyles: ThemeStyleFunctions;

package/dist/themes/colors.js

@@ -0,0 +1,135 @@
+/**
+ * Theme Colors
+ *
+ * Creates style functions from a theme's color palette.
+ * Uses chalk for hex color support.
+ *
+ * Usage:
+ *   import { getStyles } from './themes/colors.js';
+ *   const s = getStyles();
+ *   console.log(s.primary('Hello'));  // Colored with theme's primary
+ *   console.log(s.muted('dim text')); // Colored with theme's muted
+ */
+import chalk from 'chalk';
+import { getCurrentTheme } from './registry.js';
+// =============================================================================
+// Style Creation
+// =============================================================================
+/**
+ * Create style functions from a theme
+ */
+export function createThemeStyles(theme) {
+    const colors = theme.colors;
+    return {
+        // ==========================================================================
+        // Theme colors (from palette)
+        // ==========================================================================
+        primary: (text) => chalk.hex(colors.primary)(text),
+        secondary: (text) => chalk.hex(colors.secondary || colors.primary)(text),
+        foreground: (text) => chalk.hex(colors.foreground)(text),
+        muted: (text) => chalk.hex(colors.muted)(text),
+        border: (text) => chalk.hex(colors.border)(text),
+        background: (text) => chalk.bgHex(colors.background)(text),
+        card: (text) => chalk.bgHex(colors.card || colors.background)(text),
+        selection: (text) => chalk.hex(colors.selection)(text),
+        cursor: (text) => chalk.hex(colors.cursor)(text),
+        // ==========================================================================
+        // Semantic colors (fixed for consistency across themes)
+        // ==========================================================================
+        success: (text) => chalk.hex('#50fa7b')(text), // Green
+        warning: (text) => chalk.hex('#f1fa8c')(text), // Yellow
+        error: (text) => chalk.hex('#ff5555')(text), // Red
+        info: (text) => chalk.hex('#8be9fd')(text), // Cyan
+        // ==========================================================================
+        // Compound styles
+        // ==========================================================================
+        primaryBold: (text) => chalk.hex(colors.primary).bold(text),
+        inverse: (text) => chalk.inverse(text),
+        selected: (text) => chalk.bgHex(colors.secondary || colors.primary).hex(colors.background)(text),
+        onCard: (text) => chalk.bgHex(colors.card || colors.background).hex(colors.foreground)(text),
+    };
+}
+// =============================================================================
+// Global Style Access
+// =============================================================================
+// Cached styles for current theme
+let cachedStyles = null;
+let cachedThemeId = null;
+/**
+ * Get style functions for the current theme
+ *
+ * This is the main entry point for using theme colors throughout the app.
+ * Styles are cached and automatically updated when the theme changes.
+ *
+ * Usage:
+ *   import { getStyles } from './themes/colors.js';
+ *   const s = getStyles();
+ *   console.log(s.primary('Hello'));
+ */
+export function getStyles() {
+    const theme = getCurrentTheme();
+    // Return cached if theme hasn't changed
+    if (cachedStyles && cachedThemeId === theme.id) {
+        return cachedStyles;
+    }
+    // Create new styles for current theme
+    cachedStyles = createThemeStyles(theme);
+    cachedThemeId = theme.id;
+    return cachedStyles;
+}
+/**
+ * Clear style cache (call after theme change)
+ */
+export function clearStyleCache() {
+    cachedStyles = null;
+    cachedThemeId = null;
+}
+// =============================================================================
+// Convenience Exports
+// =============================================================================
+/**
+ * Get the current theme's raw colors
+ */
+export function getThemeColors() {
+    return getCurrentTheme().colors;
+}
+/**
+ * Check if current theme is dark
+ */
+export function isDarkTheme() {
+    return getCurrentTheme().type === 'dark';
+}
+/**
+ * Check if current theme is light
+ */
+export function isLightTheme() {
+    return getCurrentTheme().type === 'light';
+}
+// =============================================================================
+// Fallback/Plain Styles (no colors)
+// =============================================================================
+/**
+ * Plain style functions (no colors, for testing or non-TTY)
+ */
+export const plainStyles = {
+    // Theme colors
+    primary: (text) => text,
+    secondary: (text) => text,
+    foreground: (text) => text,
+    muted: (text) => text,
+    border: (text) => text,
+    background: (text) => text,
+    card: (text) => text,
+    selection: (text) => text,
+    cursor: (text) => text,
+    // Semantic colors
+    success: (text) => text,
+    warning: (text) => text,
+    error: (text) => text,
+    info: (text) => text,
+    // Compound styles
+    primaryBold: (text) => text,
+    inverse: (text) => text,
+    selected: (text) => text,
+    onCard: (text) => text,
+};

package/dist/themes/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Theme System
+ *
+ * 418 terminal themes with style functions for the CLI.
+ *
+ * Usage:
+ *   import { getStyles, getCurrentTheme, setCurrentTheme } from './themes/index.js';
+ *
+ *   // Get style functions for current theme
+ *   const s = getStyles();
+ *   console.log(s.primary('Hello'));
+ *   console.log(s.muted('dim text'));
+ *
+ *   // Change theme
+ *   setCurrentTheme('dracula');
+ *
+ *   // Get current theme info
+ *   const theme = getCurrentTheme();
+ *   console.log(theme.name, theme.type);
+ */
+export type { Theme, ThemeColors, ThemeConfig, ThemeStyleFunctions } from './types.js';
+export { getAllThemes, getCuratedThemes, getThemeById, searchThemes, filterThemesByType, searchAndFilterThemes, getThemeCount, loadThemeConfig, saveThemeConfig, getCurrentTheme, setCurrentTheme, clearThemeCache, } from './registry.js';
+export { createThemeStyles, getStyles, clearStyleCache, getThemeColors, isDarkTheme, isLightTheme, plainStyles, } from './colors.js';

package/dist/themes/index.js

@@ -0,0 +1,24 @@
+/**
+ * Theme System
+ *
+ * 418 terminal themes with style functions for the CLI.
+ *
+ * Usage:
+ *   import { getStyles, getCurrentTheme, setCurrentTheme } from './themes/index.js';
+ *
+ *   // Get style functions for current theme
+ *   const s = getStyles();
+ *   console.log(s.primary('Hello'));
+ *   console.log(s.muted('dim text'));
+ *
+ *   // Change theme
+ *   setCurrentTheme('dracula');
+ *
+ *   // Get current theme info
+ *   const theme = getCurrentTheme();
+ *   console.log(theme.name, theme.type);
+ */
+// Registry functions
+export { getAllThemes, getCuratedThemes, getThemeById, searchThemes, filterThemesByType, searchAndFilterThemes, getThemeCount, loadThemeConfig, saveThemeConfig, getCurrentTheme, setCurrentTheme, clearThemeCache, } from './registry.js';
+// Style functions
+export { createThemeStyles, getStyles, clearStyleCache, getThemeColors, isDarkTheme, isLightTheme, plainStyles, } from './colors.js';