@compilr-dev/cli 0.4.0

package/dist/templates/claude-md.js

@@ -0,0 +1,189 @@
+/**
+ * CLAUDE.md Template Generator
+ *
+ * Generates the AI assistant context file.
+ */
+export function generateClaudeMd(config) {
+    const techStackSection = generateTechStackSection(config);
+    const codingStandardsSection = generateCodingStandardsSection(config);
+    return `# CLAUDE.md
+
+This file provides guidance to AI coding assistants when working with this project.
+
+---
+
+## Project Overview
+
+**Project:** ${config.name}
+**Description:** ${config.description}
+
+---
+
+${techStackSection}
+
+---
+
+${codingStandardsSection}
+
+---
+
+## Project Structure
+
+${config.repoPattern === 'single' ? generateSingleRepoStructure() : generateTwoRepoStructure(config.name)}
+
+---
+
+## Architecture Decisions
+
+Key architectural decisions are documented in:
+- ${config.repoPattern === 'single' ? '`.compilr/architecture/decisions/`' : '`02-architecture/decisions/`'}
+
+When making significant technical choices, create an ADR (Architecture Decision Record).
+
+---
+
+## Current Focus
+
+*Updated by session management - tracks current sprint/milestone*
+
+---
+
+## Key Files
+
+*Auto-populated based on usage - frequently referenced files appear here*
+
+---
+
+## Development Commands
+
+\`\`\`bash
+# Development
+npm run dev         # Start development server
+npm run build       # Production build
+npm run lint        # Lint code
+npm run test        # Run tests
+
+# Project workflow
+compilr start       # Begin coding session with context
+compilr save        # Save session progress
+compilr backlog     # View/manage tasks
+\`\`\`
+
+---
+
+## Notes for AI Assistants
+
+1. **Always read this file first** when starting a session
+2. **Check the backlog** before starting new work
+3. **Follow coding standards** defined in this project
+4. **Document decisions** when making architectural choices
+5. **Update session notes** at the end of each session
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}
+function generateTechStackSection(config) {
+    if (config.techStack === 'custom') {
+        return `## Tech Stack
+
+*To be configured - update this section with your chosen technologies*
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | TBD        |       |
+| Backend   | TBD        |       |
+| Database  | TBD        |       |
+| Hosting   | TBD        |       |`;
+    }
+    const stacks = {
+        'react-node-pg': `## Tech Stack
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | React 18 + Vite | TypeScript, modern React |
+| Backend   | Node.js + Express | TypeScript, REST API |
+| Database  | PostgreSQL | Relational, ACID compliant |
+| ORM       | Prisma | Type-safe database access |`,
+        'react-python-pg': `## Tech Stack
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | React 18 + Vite | TypeScript, modern React |
+| Backend   | Python + FastAPI | Async, auto-docs |
+| Database  | PostgreSQL | Relational, ACID compliant |
+| ORM       | SQLAlchemy | Python ORM |`,
+        'vue-node-pg': `## Tech Stack
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | Vue 3 + Vite | TypeScript, Composition API |
+| Backend   | Node.js + Express | TypeScript, REST API |
+| Database  | PostgreSQL | Relational, ACID compliant |
+| ORM       | Prisma | Type-safe database access |`,
+    };
+    return stacks[config.techStack] ?? stacks['react-node-pg'];
+}
+function generateCodingStandardsSection(config) {
+    if (config.codingStandards === 'custom') {
+        return `## Coding Standards
+
+*To be configured - update this section with your coding standards*
+
+See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for details.`;
+    }
+    const standards = config.codingStandards === 'strict'
+        ? `## Coding Standards
+
+**Preset:** TypeScript Strict
+
+- TypeScript strict mode enabled
+- ESLint + Prettier configured
+- Conventional commits required
+- No \`any\` types allowed
+- Explicit return types required
+- Comprehensive error handling
+
+See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for full details.`
+        : `## Coding Standards
+
+**Preset:** TypeScript Relaxed
+
+- TypeScript with relaxed settings
+- ESLint + Prettier configured
+- Conventional commits encouraged
+- \`any\` types discouraged but allowed
+- Implicit return types allowed
+
+See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for full details.`;
+    return standards;
+}
+function generateSingleRepoStructure() {
+    return `\`\`\`
+{project}/
+├── .compilr/              # Workflow files
+│   ├── backlog.md         # Task tracking
+│   ├── architecture/      # ADRs, coding standards
+│   └── sessions/          # Session notes
+├── src/                   # Source code
+├── CLAUDE.md              # This file
+├── package.json
+└── README.md
+\`\`\``;
+}
+function generateTwoRepoStructure(name) {
+    return `\`\`\`
+${name}/                   # Code repository
+├── src/
+├── package.json
+└── README.md
+
+${name}-docs/              # Documentation repository
+├── .compilr/
+├── CLAUDE.md              # This file
+├── 01-planning/           # Backlog, roadmap
+├── 02-architecture/       # ADRs, standards
+└── 04-session-notes/      # Session history
+\`\`\``;
+}

package/dist/templates/coding-standards.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Coding Standards Template Generator
+ *
+ * Generates the coding standards documentation.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateCodingStandardsMd(config: ProjectConfig): string;

package/dist/templates/coding-standards.js

@@ -0,0 +1,299 @@
+/**
+ * Coding Standards Template Generator
+ *
+ * Generates the coding standards documentation.
+ */
+export function generateCodingStandardsMd(config) {
+    if (config.codingStandards === 'custom') {
+        return generateCustomTemplate(config);
+    }
+    return config.codingStandards === 'strict'
+        ? generateStrictTemplate(config)
+        : generateRelaxedTemplate(config);
+}
+function generateCustomTemplate(config) {
+    return `# Coding Standards - ${config.name}
+
+*Configure your coding standards here*
+
+---
+
+## TypeScript Configuration
+
+\`\`\`json
+// tsconfig.json - customize as needed
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "strict": true,  // Adjust based on preference
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  }
+}
+\`\`\`
+
+---
+
+## Linting
+
+*Add your ESLint configuration*
+
+---
+
+## Formatting
+
+*Add your Prettier configuration*
+
+---
+
+## Git Workflow
+
+*Define your branching strategy and commit conventions*
+
+---
+
+## Code Review
+
+*Define your code review process*
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}
+function generateStrictTemplate(config) {
+    return `# Coding Standards - ${config.name}
+
+**Preset:** TypeScript Strict
+
+---
+
+## TypeScript Configuration
+
+\`\`\`json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "exactOptionalPropertyTypes": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  }
+}
+\`\`\`
+
+---
+
+## ESLint Configuration
+
+\`\`\`javascript
+// eslint.config.js
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.strictTypeChecked,
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      '@typescript-eslint/explicit-function-return-type': 'error',
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/prefer-readonly': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+    },
+  }
+);
+\`\`\`
+
+---
+
+## Prettier Configuration
+
+\`\`\`json
+// .prettierrc
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100
+}
+\`\`\`
+
+---
+
+## Git Workflow
+
+### Branch Naming
+
+\`\`\`
+feat/feature-name     # New features
+fix/bug-description   # Bug fixes
+docs/update-area      # Documentation
+refactor/area         # Code refactoring
+\`\`\`
+
+### Commit Messages (Conventional Commits)
+
+\`\`\`
+feat: add user authentication
+fix: resolve login redirect issue
+docs: update API documentation
+refactor: simplify database queries
+test: add unit tests for auth module
+chore: update dependencies
+\`\`\`
+
+---
+
+## Code Review Checklist
+
+Before merging, verify:
+
+- [ ] All tests pass
+- [ ] No TypeScript errors
+- [ ] ESLint passes with no errors
+- [ ] Code follows project patterns
+- [ ] Documentation updated if needed
+- [ ] No sensitive data in commits
+
+---
+
+## File Organization
+
+\`\`\`
+src/
+├── components/      # UI components
+├── features/        # Feature modules
+├── lib/             # Shared utilities
+├── hooks/           # Custom hooks
+├── types/           # TypeScript types
+└── index.ts         # Entry point
+\`\`\`
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}
+function generateRelaxedTemplate(config) {
+    return `# Coding Standards - ${config.name}
+
+**Preset:** TypeScript Relaxed
+
+---
+
+## TypeScript Configuration
+
+\`\`\`json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "sourceMap": true
+  }
+}
+\`\`\`
+
+---
+
+## ESLint Configuration
+
+\`\`\`javascript
+// eslint.config.js
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  }
+);
+\`\`\`
+
+---
+
+## Prettier Configuration
+
+\`\`\`json
+// .prettierrc
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100
+}
+\`\`\`
+
+---
+
+## Git Workflow
+
+### Commit Messages
+
+Use descriptive commit messages. Conventional commits encouraged but not required:
+
+\`\`\`
+feat: add user authentication
+fix: resolve login redirect issue
+Update README
+\`\`\`
+
+---
+
+## Code Review
+
+- Tests should pass before merging
+- No TypeScript errors
+- Code should be readable
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * COMPILR.md Template Generator
+ *
+ * Generates the AI assistant context file.
+ */
+import type { ProjectConfig } from './types.js';
+export declare function generateCompilrMd(config: ProjectConfig): string;

package/dist/templates/compilr-md.js

@@ -0,0 +1,189 @@
+/**
+ * COMPILR.md Template Generator
+ *
+ * Generates the AI assistant context file.
+ */
+export function generateCompilrMd(config) {
+    const techStackSection = generateTechStackSection(config);
+    const codingStandardsSection = generateCodingStandardsSection(config);
+    return `# COMPILR.md
+
+This file provides guidance to AI coding assistants when working with this project.
+
+---
+
+## Project Overview
+
+**Project:** ${config.name}
+**Description:** ${config.description}
+
+---
+
+${techStackSection}
+
+---
+
+${codingStandardsSection}
+
+---
+
+## Project Structure
+
+${config.repoPattern === 'single' ? generateSingleRepoStructure() : generateTwoRepoStructure(config.name)}
+
+---
+
+## Architecture Decisions
+
+Key architectural decisions are documented in:
+- ${config.repoPattern === 'single' ? '`.compilr/architecture/decisions/`' : '`02-architecture/decisions/`'}
+
+When making significant technical choices, create an ADR (Architecture Decision Record).
+
+---
+
+## Current Focus
+
+*Updated by session management - tracks current sprint/milestone*
+
+---
+
+## Key Files
+
+*Auto-populated based on usage - frequently referenced files appear here*
+
+---
+
+## Development Commands
+
+\`\`\`bash
+# Development
+npm run dev         # Start development server
+npm run build       # Production build
+npm run lint        # Lint code
+npm run test        # Run tests
+
+# Project workflow
+compilr start       # Begin coding session with context
+compilr save        # Save session progress
+compilr backlog     # View/manage tasks
+\`\`\`
+
+---
+
+## Notes for AI Assistants
+
+1. **Always read this file first** when starting a session
+2. **Check the backlog** before starting new work
+3. **Follow coding standards** defined in this project
+4. **Document decisions** when making architectural choices
+5. **Update session notes** at the end of each session
+
+---
+
+*Last Updated: ${new Date().toISOString().split('T')[0]}*
+`;
+}
+function generateTechStackSection(config) {
+    if (config.techStack === 'custom') {
+        return `## Tech Stack
+
+*To be configured - update this section with your chosen technologies*
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | TBD        |       |
+| Backend   | TBD        |       |
+| Database  | TBD        |       |
+| Hosting   | TBD        |       |`;
+    }
+    const stacks = {
+        'react-node-pg': `## Tech Stack
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | React 18 + Vite | TypeScript, modern React |
+| Backend   | Node.js + Express | TypeScript, REST API |
+| Database  | PostgreSQL | Relational, ACID compliant |
+| ORM       | Prisma | Type-safe database access |`,
+        'react-python-pg': `## Tech Stack
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | React 18 + Vite | TypeScript, modern React |
+| Backend   | Python + FastAPI | Async, auto-docs |
+| Database  | PostgreSQL | Relational, ACID compliant |
+| ORM       | SQLAlchemy | Python ORM |`,
+        'vue-node-pg': `## Tech Stack
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Frontend  | Vue 3 + Vite | TypeScript, Composition API |
+| Backend   | Node.js + Express | TypeScript, REST API |
+| Database  | PostgreSQL | Relational, ACID compliant |
+| ORM       | Prisma | Type-safe database access |`,
+    };
+    return stacks[config.techStack] ?? stacks['react-node-pg'];
+}
+function generateCodingStandardsSection(config) {
+    if (config.codingStandards === 'custom') {
+        return `## Coding Standards
+
+*To be configured - update this section with your coding standards*
+
+See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for details.`;
+    }
+    const standards = config.codingStandards === 'strict'
+        ? `## Coding Standards
+
+**Preset:** TypeScript Strict
+
+- TypeScript strict mode enabled
+- ESLint + Prettier configured
+- Conventional commits required
+- No \`any\` types allowed
+- Explicit return types required
+- Comprehensive error handling
+
+See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for full details.`
+        : `## Coding Standards
+
+**Preset:** TypeScript Relaxed
+
+- TypeScript with relaxed settings
+- ESLint + Prettier configured
+- Conventional commits encouraged
+- \`any\` types discouraged but allowed
+- Implicit return types allowed
+
+See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for full details.`;
+    return standards;
+}
+function generateSingleRepoStructure() {
+    return `\`\`\`
+{project}/
+├── .compilr/              # Workflow files
+│   ├── backlog.md         # Task tracking
+│   ├── architecture/      # ADRs, coding standards
+│   └── sessions/          # Session notes
+├── src/                   # Source code
+├── COMPILR.md             # This file
+├── package.json
+└── README.md
+\`\`\``;
+}
+function generateTwoRepoStructure(name) {
+    return `\`\`\`
+${name}/                   # Code repository
+├── src/
+├── package.json
+└── README.md
+
+${name}-docs/              # Documentation repository
+├── .compilr/
+├── COMPILR.md             # This file
+├── 01-planning/           # Backlog, roadmap
+├── 02-architecture/       # ADRs, standards
+└── 04-session-notes/      # Session history
+\`\`\``;
+}