metacoding 1.4.3 → 1.5.0

package/lib/services/assistant-adapter.js

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantAdapterService = void 0;
+const path_1 = __importDefault(require("path"));
+const filesystem_1 = require("./filesystem");
+class AssistantAdapterService {
+    constructor() {
+        this.fileSystem = new filesystem_1.FileSystemService();
+    }
+    getAvailableAssistants() {
+        return [
+            {
+                type: 'copilot',
+                fileName: '.github/copilot-instructions.md',
+                description: 'GitHub Copilot - VS Code and IDEs',
+                instructions: 'Existing copilot-instructions.md template'
+            },
+            {
+                type: 'claude',
+                fileName: 'CLAUDE.md',
+                description: 'Claude Code - Terminal and project instructions',
+                instructions: 'CLAUDE.md template with project instructions'
+            },
+            {
+                type: 'codex',
+                fileName: 'AGENTS.md',
+                description: 'Codex/OpenAI - System message and agent instructions',
+                instructions: 'AGENTS.md template with system message configuration'
+            },
+            {
+                type: 'gemini',
+                fileName: 'GEMINI.md',
+                description: 'Gemini Code Assist - Style guide and configuration',
+                instructions: 'GEMINI.md template with hierarchical discovery'
+            }
+        ];
+    }
+    async generateAssistantFiles(assistantTypes, projectConfig, targetPath) {
+        const generatedFiles = [];
+        if (!assistantTypes || !Array.isArray(assistantTypes)) {
+            assistantTypes = ['copilot'];
+        }
+        if (assistantTypes.includes('all')) {
+            assistantTypes = ['copilot', 'claude', 'codex', 'gemini'];
+        }
+        for (const assistantType of assistantTypes) {
+            if (assistantType === 'all')
+                continue;
+            const filePath = await this.generateAssistantFile(assistantType, projectConfig, targetPath);
+            if (filePath) {
+                generatedFiles.push(filePath);
+            }
+        }
+        return generatedFiles;
+    }
+    async generateAssistantFile(assistantType, projectConfig, targetPath) {
+        try {
+            let templatePath;
+            let outputPath;
+            switch (assistantType) {
+                case 'copilot':
+                    templatePath = path_1.default.join(__dirname, '../..', 'templates', 'general', 'copilot-instructions.md');
+                    outputPath = path_1.default.join(targetPath, '.github', 'copilot-instructions.md');
+                    break;
+                case 'claude':
+                    templatePath = path_1.default.join(__dirname, '../..', 'templates', 'assistants', 'CLAUDE.md');
+                    outputPath = path_1.default.join(targetPath, 'CLAUDE.md');
+                    break;
+                case 'codex':
+                    templatePath = path_1.default.join(__dirname, '../..', 'templates', 'assistants', 'AGENTS.md');
+                    outputPath = path_1.default.join(targetPath, 'AGENTS.md');
+                    break;
+                case 'gemini':
+                    templatePath = path_1.default.join(__dirname, '../..', 'templates', 'assistants', 'GEMINI.md');
+                    outputPath = path_1.default.join(targetPath, 'GEMINI.md');
+                    break;
+                default:
+                    console.warn(`Unknown assistant type: ${assistantType}`);
+                    return null;
+            }
+            const templateContent = await this.fileSystem.readFile(templatePath);
+            if (!templateContent) {
+                console.warn(`Template not found for ${assistantType}: ${templatePath}`);
+                return null;
+            }
+            const processedContent = this.substituteVariables(templateContent, projectConfig);
+            const outputDir = path_1.default.dirname(outputPath);
+            await this.fileSystem.ensureDirectoryExists(outputDir);
+            await this.fileSystem.writeFile(outputPath, processedContent);
+            return outputPath;
+        }
+        catch (error) {
+            console.error(`Error generating ${assistantType} configuration:`, error);
+            return null;
+        }
+    }
+    substituteVariables(content, projectConfig) {
+        const variables = {
+            PROJECT_NAME: projectConfig.name,
+            PROJECT_DESCRIPTION: projectConfig.description,
+            TECH_STACK: projectConfig.techStack.join(', '),
+            PROJECT_DOMAIN: projectConfig.projectType,
+            ENVIRONMENT_TYPE: projectConfig.ideChoice === 'vscode' || projectConfig.ideChoice === 'cursor'
+                ? 'IDE'
+                : 'Terminal',
+            BUILD_COMMAND: this.getBuildCommand(projectConfig),
+            TEST_COMMAND: this.getTestCommand(projectConfig),
+            LINT_COMMAND: this.getLintCommand(projectConfig),
+            TYPECHECK_COMMAND: this.getTypecheckCommand(projectConfig),
+            CODE_STYLE_GUIDELINES: this.getCodeStyleGuidelines(projectConfig),
+            REPOSITORY_STRUCTURE: this.getRepositoryStructure(projectConfig),
+            PROJECT_SPECIFIC_GUIDANCE: ''
+        };
+        let result = content;
+        for (const [key, value] of Object.entries(variables)) {
+            const regex = new RegExp(`{{${key}}}`, 'g');
+            result = result.replace(regex, value);
+        }
+        return result;
+    }
+    getBuildCommand(projectConfig) {
+        switch (projectConfig.projectType) {
+            case 'react':
+            case 'node':
+            case 'typescript':
+            case 'javascript':
+                return 'npm run build';
+            case 'python':
+                return 'python -m build';
+            default:
+                return 'npm run build';
+        }
+    }
+    getTestCommand(projectConfig) {
+        if (projectConfig.testFramework) {
+            switch (projectConfig.testFramework) {
+                case 'jest':
+                    return 'npm test';
+                case 'vitest':
+                    return 'npm run test';
+                case 'pytest':
+                    return 'pytest';
+                default:
+                    return 'npm test';
+            }
+        }
+        switch (projectConfig.projectType) {
+            case 'python':
+                return 'pytest';
+            default:
+                return 'npm test';
+        }
+    }
+    getLintCommand(projectConfig) {
+        switch (projectConfig.projectType) {
+            case 'python':
+                return 'flake8 . && black --check .';
+            default:
+                return 'npm run lint';
+        }
+    }
+    getTypecheckCommand(projectConfig) {
+        switch (projectConfig.projectType) {
+            case 'typescript':
+            case 'react':
+                return 'npm run typecheck || tsc --noEmit';
+            case 'python':
+                return 'mypy .';
+            default:
+                return 'echo "No type checking configured"';
+        }
+    }
+    getCodeStyleGuidelines(projectConfig) {
+        switch (projectConfig.projectType) {
+            case 'react':
+                return 'Use functional components with hooks, JSX best practices, semantic HTML';
+            case 'typescript':
+            case 'node':
+                return 'Use TypeScript strict mode, explicit types, async/await patterns';
+            case 'python':
+                return 'Follow PEP 8, use type hints, prefer list comprehensions';
+            case 'javascript':
+                return 'Use ES6+ features, const/let over var, arrow functions';
+            default:
+                return 'Follow language-specific conventions and best practices';
+        }
+    }
+    getRepositoryStructure(projectConfig) {
+        const baseStructure = `
+/src                  # All source code
+/_meta               # Development documentation
+/test                # All test-related files
+/.github            # GitHub-specific files`;
+        switch (projectConfig.projectType) {
+            case 'react':
+                return `${baseStructure}
+  /components        # Reusable React components
+  /hooks             # Custom React hooks
+  /pages             # Page components
+  /utils             # Utility functions`;
+            case 'node':
+            case 'typescript':
+                return `${baseStructure}
+  /services          # Business logic services
+  /routes            # API routes
+  /middleware        # Express middleware
+  /utils             # Utility functions`;
+            case 'python':
+                return `${baseStructure}
+  /modules           # Python modules
+  /utils             # Utility functions
+  /config            # Configuration files
+  requirements.txt   # Python dependencies`;
+            default:
+                return `${baseStructure}
+  /components        # Reusable components
+  /services          # Business logic
+  /utils             # Utility functions`;
+        }
+    }
+    async detectExistingAssistants(projectPath) {
+        const existingAssistants = [];
+        const assistantFiles = [
+            { type: 'copilot', path: '.github/copilot-instructions.md' },
+            { type: 'claude', path: 'CLAUDE.md' },
+            { type: 'codex', path: 'AGENTS.md' },
+            { type: 'gemini', path: 'GEMINI.md' }
+        ];
+        for (const { type, path: filePath } of assistantFiles) {
+            const fullPath = path_1.default.join(projectPath, filePath);
+            if (await this.fileSystem.fileExists(fullPath)) {
+                existingAssistants.push(type);
+            }
+        }
+        return existingAssistants;
+    }
+    async hasExistingAssistantConfig(projectPath) {
+        const existingAssistants = await this.detectExistingAssistants(projectPath);
+        return existingAssistants.length > 0;
+    }
+}
+exports.AssistantAdapterService = AssistantAdapterService;
+//# sourceMappingURL=assistant-adapter.js.map

package/lib/services/assistant-adapter.js.map

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

package/lib/types/index.d.ts

@@ -6,6 +6,16 @@ export interface InitOptions {
     vscode?: boolean;
     cursor?: boolean;
     ide?: string;
+    environment?: 'ide' | 'terminal';
+    assistants?: AssistantType[];
+    ideChoice?: 'vscode' | 'cursor' | 'intellij';
+}
+export type AssistantType = 'copilot' | 'claude' | 'codex' | 'gemini' | 'all';
+export interface AssistantConfig {
+    type: AssistantType;
+    fileName: string;
+    description: string;
+    instructions: string;
 }
 export interface UpdateOptions {
     template?: string;
@@ -21,7 +31,7 @@ export interface ProjectConfig {
     projectType: string;
     testFramework?: string;
     buildTool?: string;
-    ideChoice?: 'vscode' | 'cursor';
+    ideChoice?: 'vscode' | 'cursor' | 'intellij' | undefined;
 }
 export interface Template {
     name: string;

package/lib/types/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metacoding",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "Guided Development Workflow for GitHub Copilot - Transform your coding experience with AI-guided standards, structured workflows, and quality practices",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/templates/assistants/AGENTS.md

@@ -0,0 +1,203 @@
+# {{PROJECT_NAME}} - Agent Instructions for Codex
+
+This file provides system instructions for Codex/OpenAI-compatible agents to ensure consistent development practices and workflow adherence.
+
+## Project Context
+
+{{PROJECT_DESCRIPTION}}
+
+**Project Goals:**
+
+- Provide robust development workflow and best practices
+- Ensure code quality and maintainability standards
+- Enable efficient team collaboration and knowledge sharing
+
+**Tech Stack:** {{TECH_STACK}}
+**Environment:** {{ENVIRONMENT_TYPE}} development
+**Domain:** {{PROJECT_DOMAIN}}
+
+## System Message Configuration
+
+You are a senior {{PROJECT_DOMAIN}} developer assistant working in a {{ENVIRONMENT_TYPE}} environment. Follow these instructions precisely for all development tasks.
+
+## Mandatory Development Workflow
+
+**ALL development tasks must follow this strict 7-step workflow to ensure code quality, proper testing, and comprehensive documentation.**
+
+### Step 1: Task Understanding and Planning
+
+**Instruction:** Always start with thorough analysis before implementation.
+
+- Read project documentation and explore codebase structure thoroughly
+- Assess uncertainty level (1.0 = total uncertainty, 0.1 = very low uncertainty)
+- If uncertainty > 0.1, continue research and exploration before asking questions
+- Present concise implementation outline with key details
+- Wait for explicit user confirmation before proceeding
+- **Critical:** No implementation work begins until all required documentation is complete
+
+### Step 2: Task Management
+
+**Instruction:** Document all work before execution.
+
+- Add tasks to `/_meta/project-task-list.md` BEFORE any implementation work
+- Use standardized naming convention: `[AREA]-TASK-[NUMBER]`
+- Area prefixes: CORE, API, UI, DB, AUTH, UTIL, CONFIG, DOC, CLI, TMPL
+- Mark tasks as "In Progress" with clear descriptions and effort estimates
+- Break down complex tasks into manageable subtasks with sequential numbering
+
+### Step 3: Test-Driven Development (TDD)
+
+**Instruction:** Tests and test documentation come first.
+
+- Document test cases in `/test/test-documentation.md` BEFORE implementing any tests
+- Specify expected inputs, outputs, and edge cases in documentation
+- Implement tests only after test cases are fully documented
+- Verify tests fail appropriately (red phase)
+- Write minimum code to make tests pass (green phase)
+- Clean up test artifacts and move test data to `/test/fixtures/`
+
+### Step 4: Implementation and Verification
+
+**Instruction:** Implement production code with verification.
+
+- Write production code to satisfy documented requirements
+- Run all tests (both new and existing) to ensure functionality
+- Verify implementation meets user requirements and get confirmation
+- Refactor code while maintaining test coverage (refactor phase)
+- Remove temporary files and clean up development artifacts
+
+### Step 5: Documentation and Status Updates
+
+**Instruction:** Update all documentation consistently.
+
+- Update all relevant project documentation
+- Mark completed tasks in `/_meta/project-task-list.md`
+- Record test status in `/test/test-documentation.md`
+- Update `CHANGELOG.md` with user-facing changes
+- Review and update code documentation as needed
+
+### Step 6: Version Control
+
+**Instruction:** Commit changes properly.
+
+- Use conventional commit message format (feat:, fix:, docs:, refactor:, test:)
+- Include tests, documentation, and code in atomic commits
+- Write descriptive commit messages explaining what was implemented and why
+- Ensure each commit represents a complete, working feature
+
+### Step 7: Workflow Completion Check
+
+**Instruction:** Verify completion before moving on.
+
+- Confirm all workflow requirements are satisfied
+- Ensure all tests pass and documentation is current
+- Verify code is committed with proper messages
+- Complete entire workflow before allowing new task planning
+
+## Workflow Enforcement Rules
+
+### Documentation-First Principle
+
+**MANDATORY: Document first, execute second for ALL development work.**
+
+**Enforcement:**
+
+- Never begin coding, testing, or implementation until corresponding documentation is complete
+- Task documentation required in `/_meta/project-task-list.md` before work begins
+- Test documentation required in `/test/test-documentation.md` before writing test code
+- User must explicitly approve plan, scope, and consequences before proceeding
+
+**Correct Examples:**
+
+- "I'll add this task to the task list, document the test cases, then get your confirmation before implementing"
+- "Let me document these test cases in test-documentation.md first, then implement the tests"
+
+**Incorrect Examples:**
+
+- "I'll implement this feature and update the documentation afterwards"
+- "I'll write the tests now and document them later"
+
+### Single-Task Focus Enforcement
+
+**MANDATORY: One change at a time - never mix tasks in one iteration.**
+
+**Enforcement:**
+
+- Never work on two different tasks simultaneously or mix unrelated changes
+- When additional requests arise during active work:
+  - **Blocking requests:** Add as subtask if it blocks current progress
+  - **Non-blocking requests:** Add to task list as separate task, complete current workflow first
+- Politely redirect users who try to switch tasks mid-workflow
+
+**Template Responses:**
+
+- "I've added that request to the task list. Let me complete the current workflow first, then we can address it as a separate task."
+- "That's related to our current work, so I'll add it as a subtask to address now."
+- "I see that's a separate concern. Let me add it to our task list and complete this workflow first."
+
+### Quality Gates
+
+**Enforcement:**
+
+- No shortcuts: Every step must be completed in order
+- No parallel tasks: Focus on one task at a time until fully complete
+- No skipping tests: TDD approach is mandatory
+- No incomplete documentation: All documentation must be current
+- No uncommitted changes: All work must be committed before moving on
+
+## Project Configuration
+
+### Build and Test Commands
+
+```bash
+# Build project
+{{BUILD_COMMAND}}
+
+# Run tests
+{{TEST_COMMAND}}
+
+# Run linter
+{{LINT_COMMAND}}
+
+# Type checking
+{{TYPECHECK_COMMAND}}
+```
+
+### Code Style Guidelines
+
+- {{CODE_STYLE_GUIDELINES}}
+- Follow conventional commit format (feat:, fix:, docs:, refactor:, test:)
+- Use meaningful variable and function names
+- Prefer early returns over deep nesting
+- Keep functions focused and reasonably sized
+- Add comments explaining complex business logic
+
+### Testing Guidelines
+
+- Follow Test-Driven Development (TDD) approach
+- Cover edge cases and error conditions in tests
+- Use realistic test data and fixtures
+- Mock external dependencies appropriately in unit tests
+- Maintain high test coverage for critical functionality paths
+
+### Repository Organization
+
+```
+{{REPOSITORY_STRUCTURE}}
+```
+
+### Development Standards
+
+- **File Organization:** Never place source code in project root directory
+- **Temporary Files:** Clean up all debug files, temporary outputs, experimental code
+- **Error Handling:** Implement comprehensive error handling with proper logging
+- **Resource Management:** Ensure proper cleanup of resources and event listeners
+- **Performance:** Consider performance implications and optimization opportunities
+- **Security:** Follow secure coding practices, validate inputs, sanitize outputs
+
+## Agent Validation
+
+After configuration setup, validate these instructions by prompting:
+**"What is the development workflow for this project?"**
+
+Expected response should reference the 7-step workflow, emphasize documentation-first principle, and demonstrate understanding of single-task focus enforcement.

package/templates/assistants/CLAUDE.md

@@ -0,0 +1,156 @@
+# {{PROJECT_NAME}} - Development Guidelines for Claude Code
+
+This file provides project instructions for Claude Code to ensure consistent development practices and workflow adherence.
+
+## Project Overview
+
+{{PROJECT_DESCRIPTION}}
+
+**Project Goals:**
+
+- Provide robust development workflow and best practices
+- Ensure code quality and maintainability standards
+- Enable efficient team collaboration and knowledge sharing
+
+**Tech Stack:** {{TECH_STACK}}
+
+## Development Environment
+
+**Working in:** {{ENVIRONMENT_TYPE}} environment
+**Project Type:** {{PROJECT_DOMAIN}} development
+
+## Core Development Workflow
+
+**CRITICAL: Follow this strict 7-step workflow for ALL development tasks.**
+
+### Step 1: Task Understanding and Planning
+
+- Begin by thoroughly reading project documentation and exploring the codebase
+- Measure your uncertainty level (scale 1.0 to 0.1) before proceeding
+- If uncertainty > 0.1, continue research before asking clarifying questions
+- Present implementation outline and get explicit user confirmation
+- **Documentation-first principle:** No implementation until documentation is complete
+
+### Step 2: Task Management
+
+- Add all tasks to `/_meta/project-task-list.md` BEFORE implementation
+- Use standardized naming: `[AREA]-TASK-[NUMBER]` format
+- Mark tasks "In Progress" with clear descriptions
+- Break complex tasks into smaller, manageable subtasks
+
+### Step 3: Test-Driven Development (TDD)
+
+- Document test cases in `/test/test-documentation.md` FIRST
+- Define expected behavior, inputs, outputs, and edge cases
+- Implement tests after documentation is complete
+- Verify test failure (red phase), then implement code (green phase)
+
+### Step 4: Implementation and Verification
+
+- Write production code to make tests pass
+- Run all tests (new and existing)
+- Get user confirmation that implementation meets requirements
+- Refactor while maintaining test coverage
+
+### Step 5: Documentation and Status Updates
+
+- Update all relevant documentation
+- Mark completed tasks in `/_meta/project-task-list.md`
+- Update test documentation status
+- Update `CHANGELOG.md` with user-facing changes
+
+### Step 6: Version Control
+
+- Commit changes with conventional commit messages
+- Include tests, documentation, and code together
+- Write descriptive commit messages explaining what and why
+- Keep commits atomic (one complete feature per commit)
+
+### Step 7: Workflow Completion Check
+
+- Verify all workflow requirements are satisfied
+- Ensure tests pass, documentation is current, code is committed
+- Complete current workflow before starting new tasks
+
+## Workflow Enforcement Rules
+
+### Documentation-First Principle
+
+**MANDATORY: Document first, execute second for ALL development work.**
+
+- Never begin coding until corresponding documentation is complete
+- Task documentation required in `/_meta/project-task-list.md`
+- Test documentation required in `/test/test-documentation.md`
+- User must explicitly approve plan, scope, and consequences
+
+### Single-Task Focus
+
+**MANDATORY: One change at a time - never mix tasks.**
+
+- Never work on multiple unrelated tasks simultaneously
+- When new requests arise:
+  - **Blocking requests:** Add as subtask to current work
+  - **Non-blocking requests:** Add to task list, complete current workflow first
+- Politely redirect users who try to switch tasks mid-workflow
+
+### Quality Gates
+
+- Complete every step in order - no shortcuts
+- Focus on one task at a time until fully complete
+- TDD approach is mandatory - no skipping tests
+- All documentation must be current
+- No uncommitted changes - commit before moving on
+
+## Project Commands
+
+# Common Commands
+
+- `npm run build`: {{BUILD_COMMAND}}
+- `npm test`: {{TEST_COMMAND}}
+- `npm run lint`: {{LINT_COMMAND}}
+- `npm run typecheck`: {{TYPECHECK_COMMAND}}
+
+# Development Workflow
+
+- Always run tests after making changes
+- Use conventional commit messages (feat:, fix:, docs:, etc.)
+- Prefer running single tests during development for performance
+- Run full test suite before committing
+
+## Code Style Guidelines
+
+- {{CODE_STYLE_GUIDELINES}}
+- Follow language-specific conventions defined in instruction files
+- Use meaningful variable and function names
+- Keep functions focused and reasonably sized
+- Prefer early returns over deep nesting
+- Add comments for complex business logic
+
+## Testing Instructions
+
+- Write tests before implementing features (TDD)
+- Cover edge cases and error conditions
+- Use realistic test data and fixtures
+- Mock external dependencies appropriately
+- Maintain high test coverage for critical functionality
+
+## Repository Structure
+
+```
+{{REPOSITORY_STRUCTURE}}
+```
+
+## Important Notes
+
+- **Temporary files:** Always clean up debug files, temporary outputs, and experimental code
+- **File organization:** Keep source code in appropriate directories, never in project root
+- **Error handling:** Implement comprehensive error handling with proper logging
+- **Performance:** Consider performance implications in all implementations
+- **Security:** Follow secure coding practices, validate inputs, sanitize outputs
+
+## Validation Reminder
+
+After setup, test these instructions by asking:
+**"What is the development workflow for this project?"**
+
+The assistant should reference the 7-step workflow and demonstrate understanding of the documentation-first principle and single-task focus enforcement.