@compilr-dev/cli 0.4.0

package/dist/templates/config-json.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Config JSON Template Generator
+ *
+ * Generates the .compilr/config.json file for workflow versioning and settings.
+ */
+import type { ProjectConfig } from './types.js';
+export interface CompilrConfig {
+    version: string;
+    project: {
+        name: string;
+        description: string;
+        createdAt: string;
+    };
+    paths: {
+        /** Absolute path to the project/code repository */
+        project: string;
+        /** Absolute path to the docs repository (two-repo pattern only) */
+        docs: string | null;
+        /** Directory where .compilr/config.json lives (for reference) */
+        workflowRoot: string;
+    };
+    settings: {
+        repoPattern: 'single' | 'two-repo';
+        techStack: string;
+        codingStandards: string;
+    };
+    sessions: {
+        count: number;
+        lastSession: string | null;
+    };
+}
+/**
+ * Generate config.json content
+ * @param config Project configuration
+ * @param projectPath Absolute path to the project folder
+ * @param docsPath Absolute path to the docs folder (for two-repo pattern)
+ */
+export declare function generateConfigJson(config: ProjectConfig, projectPath?: string, docsPath?: string): string;

package/dist/templates/config-json.js

@@ -0,0 +1,39 @@
+/**
+ * Config JSON Template Generator
+ *
+ * Generates the .compilr/config.json file for workflow versioning and settings.
+ */
+import { WORKFLOW_VERSION } from './types.js';
+/**
+ * Generate config.json content
+ * @param config Project configuration
+ * @param projectPath Absolute path to the project folder
+ * @param docsPath Absolute path to the docs folder (for two-repo pattern)
+ */
+export function generateConfigJson(config, projectPath, docsPath) {
+    // Determine workflow root (where config.json lives)
+    const workflowRoot = config.repoPattern === 'two-repo' ? docsPath : projectPath;
+    const compilrConfig = {
+        version: WORKFLOW_VERSION,
+        project: {
+            name: config.name,
+            description: config.description,
+            createdAt: new Date().toISOString(),
+        },
+        paths: {
+            project: projectPath ?? '',
+            docs: config.repoPattern === 'two-repo' ? (docsPath ?? null) : null,
+            workflowRoot: workflowRoot ?? '',
+        },
+        settings: {
+            repoPattern: config.repoPattern,
+            techStack: config.techStack,
+            codingStandards: config.codingStandards,
+        },
+        sessions: {
+            count: 0,
+            lastSession: null,
+        },
+    };
+    return JSON.stringify(compilrConfig, null, 2) + '\n';
+}

package/dist/templates/gitignore.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gitignore Template Generator
+ *
+ * Generates a .gitignore file based on tech stack.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateGitignore(config: ProjectConfig): string;

package/dist/templates/gitignore.js

@@ -0,0 +1,85 @@
+/**
+ * Gitignore Template Generator
+ *
+ * Generates a .gitignore file based on tech stack.
+ */
+export function generateGitignore(config) {
+    const common = `# Dependencies
+node_modules/
+.pnp/
+.pnp.js
+
+# Build outputs
+dist/
+build/
+*.tsbuildinfo
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+
+# Testing
+coverage/
+.nyc_output/
+
+# Cache
+.cache/
+.parcel-cache/
+`;
+    const techSpecific = getTechSpecificIgnore(config.techStack);
+    return common + '\n' + techSpecific;
+}
+function getTechSpecificIgnore(techStack) {
+    switch (techStack) {
+        case 'react-node-pg':
+        case 'vue-node-pg':
+            return `# Vite
+.vite/
+
+# Prisma
+prisma/*.db
+prisma/*.db-journal
+`;
+        case 'react-python-pg':
+            return `# Vite
+.vite/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+.venv/
+ENV/
+env/
+.eggs/
+*.egg-info/
+*.egg
+.mypy_cache/
+.pytest_cache/
+`;
+        case 'custom':
+        default:
+            return `# Add tech-specific ignores here
+`;
+    }
+}

package/dist/templates/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Project Generator
+ *
+ * Main module for generating project scaffolding.
+ */
+import type { ProjectConfig, GenerationResult } from './types.js';
+export * from './types.js';
+/**
+ * Generate a new project from configuration
+ */
+export declare function generateProject(config: ProjectConfig, basePath?: string): Promise<GenerationResult>;
+/**
+ * Validate project name
+ */
+export declare function isValidProjectName(name: string): boolean;
+/**
+ * Check if project directory already exists
+ */
+export declare function projectExists(name: string, basePath?: string): boolean;

package/dist/templates/index.js

@@ -0,0 +1,302 @@
+/**
+ * Project Generator
+ *
+ * Main module for generating project scaffolding.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+export * from './types.js';
+import { generateCompilrMd } from './compilr-md.js';
+import { generateBacklogMd } from './backlog-md.js';
+import { generateCodingStandardsMd } from './coding-standards.js';
+import { generateConfigJson } from './config-json.js';
+import { generateReadmeMd } from './readme-md.js';
+import { generatePackageJson } from './package-json.js';
+import { generateGitignore } from './gitignore.js';
+import { generateTsconfig } from './tsconfig.js';
+// =============================================================================
+// Main Generator
+// =============================================================================
+/**
+ * Generate a new project from configuration
+ */
+export function generateProject(config, basePath = process.cwd()) {
+    const filesCreated = [];
+    try {
+        if (config.repoPattern === 'single') {
+            return Promise.resolve(generateSingleRepoProject(config, basePath, filesCreated));
+        }
+        else {
+            return Promise.resolve(generateTwoRepoProject(config, basePath, filesCreated));
+        }
+    }
+    catch (error) {
+        return Promise.resolve({
+            success: false,
+            projectPath: path.join(basePath, config.name),
+            filesCreated,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+// =============================================================================
+// Single Repo Pattern
+// =============================================================================
+function generateSingleRepoProject(config, basePath, filesCreated) {
+    const projectPath = path.join(basePath, config.name);
+    // Create directory structure
+    const dirs = [
+        projectPath,
+        path.join(projectPath, 'src'),
+        path.join(projectPath, '.compilr'),
+        path.join(projectPath, '.compilr', 'requirements'),
+        path.join(projectPath, '.compilr', 'architecture'),
+        path.join(projectPath, '.compilr', 'architecture', 'decisions'),
+        path.join(projectPath, '.compilr', 'docs'),
+        path.join(projectPath, '.compilr', 'sessions'),
+    ];
+    for (const dir of dirs) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Generate and write files
+    const files = [
+        // Root files
+        { path: path.join(projectPath, 'COMPILR.md'), content: generateCompilrMd(config) },
+        { path: path.join(projectPath, 'README.md'), content: generateReadmeMd(config) },
+        { path: path.join(projectPath, 'package.json'), content: generatePackageJson(config) },
+        { path: path.join(projectPath, '.gitignore'), content: generateGitignore(config) },
+        { path: path.join(projectPath, 'tsconfig.json'), content: generateTsconfig(config) },
+        // .compilr files
+        { path: path.join(projectPath, '.compilr', 'config.json'), content: generateConfigJson(config, projectPath) },
+        { path: path.join(projectPath, '.compilr', 'backlog.md'), content: generateBacklogMd(config) },
+        { path: path.join(projectPath, '.compilr', 'roadmap.md'), content: generateRoadmapMd(config) },
+        {
+            path: path.join(projectPath, '.compilr', 'architecture', 'coding-standards.md'),
+            content: generateCodingStandardsMd(config),
+        },
+        {
+            path: path.join(projectPath, '.compilr', 'requirements', 'PRD.md'),
+            content: generatePrdMd(config),
+        },
+        {
+            path: path.join(projectPath, '.compilr', 'docs', 'README.md'),
+            content: '# Documentation\n\n*Add your documentation here*\n',
+        },
+        {
+            path: path.join(projectPath, '.compilr', 'sessions', 'README.md'),
+            content: '# Session Notes\n\n*Session notes will be auto-generated here*\n',
+        },
+    ];
+    for (const file of files) {
+        fs.writeFileSync(file.path, file.content, 'utf-8');
+        filesCreated.push(file.path);
+    }
+    // Initialize git if requested
+    if (config.initGit) {
+        initGit(projectPath);
+    }
+    return {
+        success: true,
+        projectPath,
+        filesCreated,
+    };
+}
+// =============================================================================
+// Two Repo Pattern
+// =============================================================================
+function generateTwoRepoProject(config, basePath, filesCreated) {
+    const projectPath = path.join(basePath, config.name);
+    const docsPath = path.join(basePath, `${config.name}-docs`);
+    // Create code repo structure
+    const codeDirs = [projectPath, path.join(projectPath, 'src')];
+    for (const dir of codeDirs) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Create docs repo structure
+    const docsDirs = [
+        docsPath,
+        path.join(docsPath, '.compilr'),
+        path.join(docsPath, '00-requirements'),
+        path.join(docsPath, '01-planning'),
+        path.join(docsPath, '02-architecture'),
+        path.join(docsPath, '02-architecture', 'decisions'),
+        path.join(docsPath, '03-documentation'),
+        path.join(docsPath, '04-session-notes'),
+    ];
+    for (const dir of docsDirs) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Generate code repo files
+    const codeFiles = [
+        { path: path.join(projectPath, 'README.md'), content: generateReadmeMd(config) },
+        { path: path.join(projectPath, 'package.json'), content: generatePackageJson(config) },
+        { path: path.join(projectPath, '.gitignore'), content: generateGitignore(config) },
+        { path: path.join(projectPath, 'tsconfig.json'), content: generateTsconfig(config) },
+    ];
+    for (const file of codeFiles) {
+        fs.writeFileSync(file.path, file.content, 'utf-8');
+        filesCreated.push(file.path);
+    }
+    // Generate docs repo files
+    const docsFiles = [
+        { path: path.join(docsPath, 'COMPILR.md'), content: generateCompilrMd(config) },
+        { path: path.join(docsPath, '.compilr', 'config.json'), content: generateConfigJson(config, projectPath, docsPath) },
+        { path: path.join(docsPath, '00-requirements', 'PRD.md'), content: generatePrdMd(config) },
+        { path: path.join(docsPath, '01-planning', 'backlog.md'), content: generateBacklogMd(config) },
+        { path: path.join(docsPath, '01-planning', 'roadmap.md'), content: generateRoadmapMd(config) },
+        {
+            path: path.join(docsPath, '02-architecture', 'coding-standards.md'),
+            content: generateCodingStandardsMd(config),
+        },
+        {
+            path: path.join(docsPath, '03-documentation', 'README.md'),
+            content: '# Documentation\n\n*Add your documentation here*\n',
+        },
+        {
+            path: path.join(docsPath, '04-session-notes', 'README.md'),
+            content: '# Session Notes\n\n*Session notes will be auto-generated here*\n',
+        },
+    ];
+    for (const file of docsFiles) {
+        fs.writeFileSync(file.path, file.content, 'utf-8');
+        filesCreated.push(file.path);
+    }
+    // Initialize git if requested
+    if (config.initGit) {
+        initGit(projectPath);
+        initGit(docsPath);
+    }
+    return {
+        success: true,
+        projectPath,
+        docsPath,
+        filesCreated,
+    };
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+function initGit(projectPath) {
+    try {
+        execSync('git init', { cwd: projectPath, stdio: 'ignore' });
+        execSync('git add .', { cwd: projectPath, stdio: 'ignore' });
+        execSync('git commit -m "Initial commit from compilr init"', {
+            cwd: projectPath,
+            stdio: 'ignore',
+        });
+    }
+    catch {
+        // Git init failed - not critical
+    }
+}
+function generateRoadmapMd(config) {
+    return `# Roadmap - ${config.name}
+
+## Vision
+
+${config.description}
+
+---
+
+## Milestones
+
+### Milestone 1: Foundation
+- [ ] Project setup
+- [ ] Development environment
+- [ ] CI/CD pipeline
+
+### Milestone 2: Core Features
+- [ ] *Define your core features*
+
+### Milestone 3: Launch
+- [ ] Testing
+- [ ] Documentation
+- [ ] Deploy to production
+
+---
+
+## Timeline
+
+*Add your timeline here*
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}
+function generatePrdMd(config) {
+    return `# Product Requirements Document - ${config.name}
+
+## Overview
+
+${config.description}
+
+---
+
+## Problem Statement
+
+*What problem does this project solve?*
+
+---
+
+## Goals
+
+1. *Primary goal*
+2. *Secondary goal*
+3. *Success metrics*
+
+---
+
+## User Stories
+
+### As a user, I want to...
+
+1. *User story 1*
+2. *User story 2*
+3. *User story 3*
+
+---
+
+## Requirements
+
+### Functional Requirements
+
+| ID | Requirement | Priority |
+|----|-------------|----------|
+| FR-1 | | High |
+| FR-2 | | Medium |
+| FR-3 | | Low |
+
+### Non-Functional Requirements
+
+- Performance: *Specify targets*
+- Security: *Specify requirements*
+- Accessibility: *Specify standards*
+
+---
+
+## Out of Scope
+
+*What is NOT included in this version*
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}
+// =============================================================================
+// Validation
+// =============================================================================
+/**
+ * Validate project name
+ */
+export function isValidProjectName(name) {
+    return /^[a-z][a-z0-9-]{1,49}$/.test(name);
+}
+/**
+ * Check if project directory already exists
+ */
+export function projectExists(name, basePath = process.cwd()) {
+    return fs.existsSync(path.join(basePath, name));
+}

package/dist/templates/package-json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Package JSON Template Generator
+ *
+ * Generates a basic package.json for the project.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generatePackageJson(config: ProjectConfig): string;

package/dist/templates/package-json.js

@@ -0,0 +1,111 @@
+/**
+ * Package JSON Template Generator
+ *
+ * Generates a basic package.json for the project.
+ */
+export function generatePackageJson(config) {
+    const pkg = getPackageTemplate(config);
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+function getPackageTemplate(config) {
+    const base = {
+        name: config.name,
+        version: '0.0.1',
+        description: config.description,
+        type: 'module',
+        scripts: {},
+        dependencies: {},
+        devDependencies: {},
+    };
+    switch (config.techStack) {
+        case 'react-node-pg':
+            return {
+                ...base,
+                scripts: {
+                    dev: 'vite',
+                    build: 'tsc && vite build',
+                    lint: 'eslint src/',
+                    preview: 'vite preview',
+                },
+                dependencies: {
+                    react: '^18.2.0',
+                    'react-dom': '^18.2.0',
+                },
+                devDependencies: {
+                    '@types/react': '^18.2.0',
+                    '@types/react-dom': '^18.2.0',
+                    '@vitejs/plugin-react': '^4.2.0',
+                    typescript: '^5.3.0',
+                    vite: '^5.0.0',
+                    ...(config.codingStandards !== 'custom'
+                        ? {
+                            eslint: '^9.0.0',
+                            '@eslint/js': '^9.0.0',
+                            'typescript-eslint': '^8.0.0',
+                            prettier: '^3.2.0',
+                        }
+                        : {}),
+                },
+            };
+        case 'vue-node-pg':
+            return {
+                ...base,
+                scripts: {
+                    dev: 'vite',
+                    build: 'vue-tsc && vite build',
+                    lint: 'eslint src/',
+                    preview: 'vite preview',
+                },
+                dependencies: {
+                    vue: '^3.4.0',
+                },
+                devDependencies: {
+                    '@vitejs/plugin-vue': '^5.0.0',
+                    typescript: '^5.3.0',
+                    'vue-tsc': '^1.8.0',
+                    vite: '^5.0.0',
+                    ...(config.codingStandards !== 'custom'
+                        ? {
+                            eslint: '^9.0.0',
+                            '@eslint/js': '^9.0.0',
+                            'typescript-eslint': '^8.0.0',
+                            prettier: '^3.2.0',
+                        }
+                        : {}),
+                },
+            };
+        case 'react-python-pg':
+            // Frontend only - Python backend has its own requirements.txt
+            return {
+                ...base,
+                scripts: {
+                    dev: 'vite',
+                    build: 'tsc && vite build',
+                    lint: 'eslint src/',
+                    preview: 'vite preview',
+                },
+                dependencies: {
+                    react: '^18.2.0',
+                    'react-dom': '^18.2.0',
+                },
+                devDependencies: {
+                    '@types/react': '^18.2.0',
+                    '@types/react-dom': '^18.2.0',
+                    '@vitejs/plugin-react': '^4.2.0',
+                    typescript: '^5.3.0',
+                    vite: '^5.0.0',
+                },
+            };
+        case 'custom':
+        default:
+            return {
+                ...base,
+                scripts: {
+                    dev: 'echo "Add your dev command"',
+                    build: 'echo "Add your build command"',
+                    lint: 'echo "Add your lint command"',
+                    test: 'echo "Add your test command"',
+                },
+            };
+    }
+}

package/dist/templates/readme-md.d.ts

@@ -0,0 +1,7 @@
+/**
+ * README.md Template Generator
+ *
+ * Generates the project README with next steps.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateReadmeMd(config: ProjectConfig): string;