claude-flow-novice 1.3.0 → 1.3.2

package/.claude-flow-novice/templates/claude-md-templates/README.md

@@ -0,0 +1,263 @@
+# Claude.md Language Templates
+
+This directory contains language-specific CLAUDE.md template files for different programming ecosystems. Each template is based on the main CLAUDE.md structure but customized for specific languages, frameworks, and toolchains.
+
+## Available Templates
+
+### 📦 CLAUDE-RUST.md
+**For Rust projects with Cargo, Clippy, and testing**
+- Cargo build system integration
+- Rust-specific agent coordination patterns
+- Clippy linting and rustfmt formatting
+- Comprehensive testing with `cargo test`
+- Memory safety and ownership patterns
+- Performance optimization techniques
+- Crate development and publishing
+
+### 🟨 CLAUDE-JAVASCRIPT.md
+**For JavaScript/Node.js projects with npm and modern tooling**
+- NPM package management and scripts
+- ES6+ modern JavaScript patterns
+- Jest/Mocha testing frameworks
+- ESLint and Prettier configuration
+- Express/Fastify backend development
+- Frontend framework integration
+- Async/await error handling
+
+### 🔷 CLAUDE-TYPESCRIPT.md
+**For TypeScript projects with strong typing and build tools**
+- TypeScript compiler configuration
+- Strict type checking and safety
+- Advanced type patterns and generics
+- Jest with TypeScript testing
+- Build pipelines (Webpack, Vite, TSC)
+- TSDoc documentation standards
+- Type-safe agent coordination
+
+### 🐍 CLAUDE-PYTHON.md
+**For Python projects with pip, pytest, and quality tools**
+- Virtual environment management
+- Modern Python packaging (pyproject.toml)
+- Comprehensive pytest testing strategies
+- Type hints and mypy checking
+- PEP 8 compliance and formatting
+- Sphinx documentation generation
+- Data science and ML patterns
+
+## Template Structure
+
+Each template follows the same core structure but with language-specific customizations:
+
+### 🚨 Universal Rules (All Languages)
+1. **Concurrent execution** - All operations in single messages
+2. **Proper file organization** - Never save to root folder
+3. **Claude Code Task tool** - Primary agent execution method
+4. **Batch operations** - TodoWrite, file ops, bash commands together
+
+### 🎯 Language-Specific Sections
+
+#### Build Commands
+- Language-specific build tools and commands
+- Package management (Cargo, npm, pip, etc.)
+- Testing framework integration
+- Linting and formatting tools
+
+#### Agent Coordination
+- Language-specific agent types
+- Ecosystem-aware coordination patterns
+- Framework specialists (React, Django, etc.)
+- Tool experts (webpack, mypy, clippy, etc.)
+
+#### Configuration Files
+- Language build configuration templates
+- Testing framework setup
+- Linting and formatting rules
+- CI/CD pipeline configurations
+
+#### Best Practices
+- Language idioms and patterns
+- Performance optimization techniques
+- Error handling strategies
+- Documentation standards
+
+## Usage Instructions
+
+### 1. Choose Your Template
+Select the appropriate template for your project's primary language:
+
+```bash
+# For Rust projects
+cp claude-md-templates/CLAUDE-RUST.md ./CLAUDE.md
+
+# For JavaScript projects
+cp claude-md-templates/CLAUDE-JAVASCRIPT.md ./CLAUDE.md
+
+# For TypeScript projects
+cp claude-md-templates/CLAUDE-TYPESCRIPT.md ./CLAUDE.md
+
+# For Python projects
+cp claude-md-templates/CLAUDE-PYTHON.md ./CLAUDE.md
+```
+
+### 2. Customize for Your Project
+After copying, customize the template:
+
+- Update project name and description
+- Modify dependency lists
+- Adjust build commands for your setup
+- Add project-specific agent types
+- Configure tool versions and settings
+
+### 3. Initialize Language Environment
+Each template includes setup commands:
+
+```bash
+# Rust
+cargo init
+cargo add [dependencies]
+
+# JavaScript/Node.js
+npm init
+npm install [dependencies]
+
+# TypeScript
+npm init
+npm install typescript @types/node
+
+# Python
+python -m venv venv
+source venv/bin/activate  # or venv\Scripts\activate on Windows
+pip install -r requirements.txt
+```
+
+## Agent Coordination Patterns
+
+### Language-Specific Agents
+Each template includes specialized agents:
+
+#### Rust Agents
+- `rust-coder`, `cargo-expert`, `clippy-specialist`
+- `async-rust-dev`, `unsafe-rust-auditor`
+- `memory-safety-auditor`, `benchmark-engineer`
+
+#### JavaScript Agents
+- `js-coder`, `node-developer`, `frontend-dev`
+- `express-dev`, `react-dev`, `vue-dev`
+- `jest-expert`, `webpack-expert`
+
+#### TypeScript Agents
+- `ts-coder`, `type-designer`, `interface-designer`
+- `generic-specialist`, `tsc-expert`
+- `jest-ts-expert`, `webpack-ts-config`
+
+#### Python Agents
+- `python-coder`, `pytest-expert`, `pep8-expert`
+- `django-dev`, `fastapi-dev`, `data-scientist`
+- `mypy-expert`, `sphinx-documenter`
+
+### Coordination Protocol
+All templates follow the same coordination protocol:
+
+```bash
+# Before work
+npx claude-flow@alpha hooks pre-task --description "[task]"
+
+# During work
+[language-specific-lint-check]
+npx claude-flow@alpha hooks post-edit --file "[file]"
+
+# After work
+[language-specific-test-command]
+npx claude-flow@alpha hooks post-task --task-id "[task]"
+```
+
+## Framework Extensions
+
+### Web Frameworks
+- **React/Vue/Angular** - Extended TypeScript/JavaScript templates
+- **Django/Flask/FastAPI** - Extended Python templates
+- **Actix/Rocket/Warp** - Extended Rust templates
+- **Express/Fastify/Koa** - Extended JavaScript templates
+
+### Testing Frameworks
+- **Jest/Vitest/Mocha** - JavaScript/TypeScript testing
+- **Pytest/Unittest** - Python testing
+- **Cargo test/Proptest** - Rust testing
+- **Cypress/Playwright** - E2E testing across languages
+
+### Build Tools
+- **Webpack/Vite/Rollup** - JavaScript/TypeScript bundling
+- **Cargo** - Rust build system
+- **Poetry/Pip** - Python package management
+- **Docker** - Containerization across all languages
+
+## Quality Assurance
+
+### Linting and Formatting
+Each template includes appropriate tools:
+
+- **Rust**: `clippy`, `rustfmt`
+- **JavaScript**: `eslint`, `prettier`
+- **TypeScript**: `@typescript-eslint`, `prettier`
+- **Python**: `flake8`, `black`, `isort`, `mypy`
+
+### Testing Standards
+- **Unit tests**: 80%+ coverage requirement
+- **Integration tests**: API and system testing
+- **Type testing**: Static analysis and type safety
+- **Property testing**: Hypothesis/QuickCheck patterns
+
+### Documentation
+- **API docs**: Language-specific documentation tools
+- **Type annotations**: Comprehensive type documentation
+- **Examples**: Working code examples in docs
+- **Architecture**: System design documentation
+
+## Migration Guide
+
+### From Generic CLAUDE.md
+1. Backup existing `CLAUDE.md`
+2. Copy appropriate language template
+3. Migrate custom configurations
+4. Update agent spawn patterns
+5. Test coordination with language tools
+
+### Between Language Templates
+1. Extract language-agnostic configurations
+2. Copy to new language template
+3. Update language-specific sections
+4. Migrate build and test commands
+5. Update agent coordination patterns
+
+## Contributing
+
+### Adding New Language Templates
+1. Follow existing template structure
+2. Include comprehensive language ecosystem
+3. Add specialized agent types
+4. Provide complete configuration examples
+5. Document language-specific best practices
+
+### Template Improvements
+1. Test with real projects
+2. Gather community feedback
+3. Update based on ecosystem changes
+4. Maintain compatibility with SPARC methodology
+5. Ensure agent coordination consistency
+
+## Support and Resources
+
+### General Support
+- **Main Documentation**: `/CLAUDE.md`
+- **SPARC Methodology**: Project root documentation
+- **Agent Coordination**: MCP and Claude Flow docs
+
+### Language-Specific Resources
+- **Rust**: https://doc.rust-lang.org/
+- **JavaScript**: https://developer.mozilla.org/en-US/docs/Web/JavaScript
+- **TypeScript**: https://www.typescriptlang.org/docs/
+- **Python**: https://docs.python.org/3/
+
+---
+
+**Remember**: Choose the right template for your language, customize for your project, and let Claude Flow coordinate while Claude Code creates!

package/CLAUDE.md

@@ -0,0 +1,81 @@
+# Claude Flow Novice - AI Agent Orchestration
+
+## Core Orchestration Patterns
+
+### Parallel Execution Protocol
+ALL related operations MUST execute concurrently in single messages:
+- **TodoWrite**: Batch 5-10+ todos in one call
+- **File Operations**: Batch reads/writes/edits together
+- **Agent Spawning**: Use Task tool for concurrent agent execution
+- **Memory Operations**: Batch store/retrieve operations
+
+### Agent Coordination Framework
+
+#### Pre-Task Hooks (Setup & Validation)
+```bash
+# Validate safety and prepare resources
+npx claude-flow-novice hooks pre-command --command "[command]" --validate-safety true --prepare-resources true
+
+# Auto-assign agents and load context
+npx claude-flow-novice hooks pre-edit --file "[file]" --auto-assign-agents true --load-context true
+```
+
+#### Post-Task Hooks (Validation & Quality)
+```bash
+# Track metrics and store results
+npx claude-flow-novice hooks post-command --command "[command]" --track-metrics true --store-results true
+
+# Comprehensive validation pipeline (runs automatically on file edits)
+node config/hooks/post-edit-pipeline.js "[file]"
+
+# Validates: formatting, linting, type checking, dependencies, security, tests
+# Progressive validation: skips tests if dependencies missing (beginner-friendly)
+```
+
+**Post-Edit Pipeline Features:**
+- **Multi-Language**: JS/TS, Python, Rust, Go, Java, C++, PHP, Ruby, C#
+- **Formatting**: Prettier, Black, RustFmt, GoFmt (auto-formats code)
+- **Linting**: ESLint, Flake8, Clippy, GoLint (finds code issues)
+- **Type Checking**: TSC, MyPy, Cargo Check, Go Vet (catches type errors)
+- **Dependency Analysis**: Checks imports/requires, suggests missing deps
+- **Security Scanning**: NPM Audit, Bandit, Cargo Audit, GoSec
+- **Test Execution**: NPM Test, PyTest, Cargo Test, Go Test (if deps satisfied)
+- **Progressive Validation**: 4 tiers (syntax→interface→integration→full)
+- **Smart Agent Spawning**: Auto-suggests agents for missing dependencies/tests
+
+#### Session Management
+```bash
+# Generate summaries and persist state
+npx claude-flow-novice hooks session-end --generate-summary true --persist-state true --export-metrics true
+```
+**Claude Code's Task tool is the PRIMARY way to spawn agents:**
+```javascript
+// ✅ CORRECT: Use Claude Code's Task tool for parallel agent execution
+[Single Message]:
+  Task("Research agent", "Analyze requirements and patterns...", "researcher")
+  Task("Coder agent", "Implement core features...", "coder")
+  Task("Tester agent", "Create comprehensive tests...", "tester")
+  Task("Reviewer agent", "Review code quality...", "reviewer")
+  Task("Architect agent", "Design system architecture...", "system-architect")
+```
+
+**MCP tools are ONLY for coordination setup:**
+### MCP Integration
+- **Coordination**: `mcp__claude-flow-novice__swarm_init`, `agent_spawn`, `task_orchestrate`
+- **Monitoring**: `swarm_status`, `agent_metrics`, `task_results`
+- **Memory**: `memory_usage`, `memory_search`
+
+## File Organization
+- `/src` - Source code
+- `/tests` - Test files
+- `/docs` - Documentation
+- **Never save working files to root**
+
+# Add MCP server
+claude mcp add claude-flow-novice npx claude-flow-novice mcp start
+
+
+## Essential Commands
+- `npx claude-flow-novice status` - System health
+- `npx claude-flow-novice --help` - Available commands
+- `/swarm`, `/sparc`, `/hooks` - Slash commands (auto-discovered)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Standalone Claude Flow for beginners - AI agent orchestration made easy. Enhanced init command creates complete agent system, MCP configuration with 30 essential tools, and automated hooks. Fully standalone with zero external dependencies, all memory leaks eliminated, complete project setup in one command.",
   "mcpName": "io.github.ruvnet/claude-flow",
   "main": ".claude-flow-novice/dist/index.js",
@@ -145,7 +145,8 @@
     "dev:monitor": "python scripts/dev/claude-monitor.py",
     "utils:fix-imports": "node scripts/utils/fix-import-paths.js",
     "utils:cleanup": "bash scripts/utils/clean-build-artifacts.sh",
-    "hooks:session-start": "node src/cli/simple-commands/hooks.js session-start"
+    "hooks:session-start": "node src/cli/simple-commands/hooks.js session-start",
+    "postinstall": "node scripts/post-install-claude-md.js"
   },
   "keywords": [
     "ai",
@@ -190,18 +191,21 @@
     "npm": ">=9.0.0"
   },
   "files": [
-    ".claude-flow-novice/dist/",
+    ".claude-flow-novice/",
+    ".claude/",
+    "config/",
+    "scripts/",
     "src/commands/",
     "src/slash-commands/",
-    "src/cli/simple-commands/hooks/",
+    "src/cli/simple-commands/",
     "src/swarm-fullstack/",
     "src/npx/",
+    "src/language/",
     "examples/",
     "wiki/",
-    ".claude/",
-    "config/",
-    "scripts/post-install-claude-md.js",
+    "CLAUDE.md",
     "README.md",
+    "README-NPM.md",
     "LICENSE",
     "CHANGELOG.md"
   ],

package/scripts/build/README.md

@@ -0,0 +1,167 @@
+# Build Scripts
+
+This directory contains all build-related scripts for the Claude Flow project.
+
+## Scripts
+
+### Core Build Scripts
+
+#### `unified-builder.sh` - Universal Build Script
+**Primary build script** consolidating all build operations into a single, powerful tool.
+
+```bash
+# Available modes
+scripts/build/unified-builder.sh [mode] [options]
+
+# Modes:
+# workaround  - Build with deprecation warning workarounds
+# filter      - Build with filtered output (removes warnings)
+# safe        - Build with automatic backup and rollback (default)
+# force       - Force build ignoring errors
+# migration   - Build with migration compatibility
+# clean       - Clean build artifacts before building
+# monitor     - Build with continuous monitoring
+
+# Examples
+scripts/build/unified-builder.sh safe --verbose
+scripts/build/unified-builder.sh clean filter
+npm run build                    # Uses safe mode
+npm run build:workaround         # Uses workaround mode
+```
+
+#### `typescript-fixer.js` - Universal TypeScript Error Fixer
+**Comprehensive TypeScript error resolution** with multiple fix strategies.
+
+```bash
+# Available strategies
+node scripts/build/typescript-fixer.js [strategy] [options]
+
+# Strategies:
+# basic       - Standard TypeScript error patterns
+# advanced    - Complex TypeScript error patterns
+# targeted    - File-specific targeted fixes
+# quick       - Fast common pattern fixes
+# batch       - Bulk operation fixes
+# all         - Apply all fix strategies (default)
+
+# Examples
+node scripts/build/typescript-fixer.js --dry-run
+npm run fix:typescript           # Uses default strategy
+npm run fix:typescript:quick     # Quick fixes only
+```
+
+#### `performance-monitor.js` - Build Performance Testing
+**Performance testing and monitoring** during build processes.
+
+```bash
+# Available commands
+node scripts/build/performance-monitor.js [command] [options]
+
+# Commands:
+# test [type]      - Run performance tests (basic|load|stress|endurance)
+# monitor          - Start build monitoring
+# report [format]  - Generate performance report (summary|detailed|json)
+# metrics          - Show current metrics
+
+# Examples
+npm run test:performance:basic   # Basic performance tests
+npm run performance:monitor      # Start continuous monitoring
+```
+
+### Build Configuration
+
+#### `build-config.js`
+Build configuration settings and environment setup.
+
+#### `build-prompt-copier.sh`
+Copies build prompts and templates for consistent build messaging.
+
+### Publishing & Release
+
+#### `prepare-publish.js`
+Prepares the package for publishing to NPM registry.
+
+#### `update-bin-version.js`
+Updates binary version numbers across the project.
+
+## Package.json Integration
+
+All build scripts are integrated into package.json for easy access:
+
+```json
+{
+  "scripts": {
+    "build": "scripts/build/unified-builder.sh safe",
+    "build:workaround": "scripts/build/unified-builder.sh workaround",
+    "build:force": "scripts/build/unified-builder.sh force",
+    "build:monitor": "scripts/build/unified-builder.sh monitor",
+    "fix:typescript": "node scripts/build/typescript-fixer.js",
+    "fix:typescript:basic": "node scripts/build/typescript-fixer.js basic",
+    "fix:typescript:advanced": "node scripts/build/typescript-fixer.js advanced",
+    "test:performance:basic": "node scripts/build/performance-monitor.js test basic",
+    "performance:monitor": "node scripts/build/performance-monitor.js monitor"
+  }
+}
+```
+
+## Features
+
+### Coordination Integration
+All build scripts include Claude Flow coordination hooks:
+- Pre-task initialization
+- Post-edit reporting
+- Task completion tracking
+- Session state management
+
+### Error Recovery
+- Automatic backup and rollback capabilities
+- Comprehensive error logging
+- Recovery strategies for build failures
+- Safe mode operations
+
+### Performance Optimization
+- Build time monitoring
+- Resource usage tracking
+- Performance regression detection
+- Optimization recommendations
+
+## Usage Guidelines
+
+1. **Prefer npm scripts** over direct script execution
+2. **Use safe mode** for production builds
+3. **Run performance tests** before major releases
+4. **Check TypeScript errors** with the fixer before commits
+5. **Monitor builds** during CI/CD operations
+
+## Troubleshooting
+
+### Common Issues
+
+**Build Failures:**
+```bash
+# Try safe mode with verbose output
+npm run build -- --verbose
+
+# Force build if necessary
+npm run build:force
+```
+
+**TypeScript Errors:**
+```bash
+# Quick fix common issues
+npm run fix:typescript:quick
+
+# Comprehensive fix
+npm run fix:typescript
+```
+
+**Performance Issues:**
+```bash
+# Check performance metrics
+npm run performance:monitor
+
+# Run performance tests
+npm run test:performance:basic
+```
+
+For legacy build scripts, see `../legacy/` directory.

package/scripts/build/build-config.js

@@ -0,0 +1,27 @@
+/**
+ * Build Configuration for Claude Flow
+ * 
+ * This configuration handles module resolution for dual Node.js/Deno support
+ */
+
+export const buildConfig = {
+  // Module aliases for Node.js build
+  moduleAliases: {
+    '@cliffy/ansi/colors': './src/adapters/cliffy-node.ts',
+    '@cliffy/prompt': './src/adapters/cliffy-node.ts',
+    '@cliffy/table': './src/adapters/cliffy-node.ts',
+  },
+  
+  // Modules to exclude from Node.js build
+  excludeModules: [
+    'vscode', // VS Code extension API
+  ],
+  
+  // External modules that should not be bundled
+  externals: [
+    '@modelcontextprotocol/sdk',
+    'better-sqlite3',
+    'node-pty',
+    'blessed',
+  ],
+};

package/scripts/build/build-prompt-copier.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Build script for prompt copier CLI
+set -e
+
+echo "Building prompt copier CLI..."
+
+# Ensure bin directory exists
+mkdir -p bin
+
+# Check if Deno is available
+if ! command -v deno &> /dev/null; then
+    echo "Error: Deno is required but not installed"
+    echo "Please install Deno: https://deno.land/manual/getting_started/installation"
+    exit 1
+fi
+
+# Compile the prompt CLI
+echo "Compiling prompt-copier..."
+PATH="/home/codespace/.deno/bin:$PATH" deno compile \
+    --allow-all \
+    --no-check \
+    --output=bin/prompt-copier \
+    src/swarm/prompt-cli.ts
+
+# Make executable
+chmod +x bin/prompt-copier
+
+echo "✅ prompt-copier CLI built successfully"
+echo "Usage: ./bin/prompt-copier --help"