fraim-framework 1.0.12 → 2.0.2

package/.windsurf/workflows/start-impl.md

@@ -0,0 +1,6 @@
+---
+description: Implement issue
+auto_execution_mode: 3
+---
+
+Follow instructions in `.ai-agents/workflows/implement.md`

package/.windsurf/workflows/start-spec.md

@@ -0,0 +1,6 @@
+---
+description: Spec Issue
+auto_execution_mode: 3
+---
+
+Follow instructions in `.ai-agents/workflows/spec.md`

package/.windsurf/workflows/start-tests.md

@@ -0,0 +1,6 @@
+---
+description: Start writing tests
+auto_execution_mode: 3
+---
+
+Follow instructions in `.ai-agents/workflows/test.md`

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [2.0.0] - 2024-12-19
+
+### 🚀 Major Release: FRAIM v2 - The Future of AI-Assisted Development
+
+#### ✨ New Features
+- **Complete Generic Framework**: Removed all Ashley-specific IP, making FRAIM truly universal
+- **Enhanced Rule System**: 13 comprehensive rule files covering all aspects of AI agent management
+- **Simplified Label System**: Streamlined to 9 essential labels matching real-world usage
+- **Spec Workflow**: Added specification phase for requirements and user experience definition
+- **Timeout Management**: Advanced timeout scripts with output visibility for long-running tasks
+- **Evidence-Based Validation**: Mandatory test evidence collection and validation
+- **Systematic Debugging**: Structured debugging patterns with learning capture
+
+#### 🔧 Improvements
+- **Single Install Method**: Simplified to `npm install -g fraim-framework`
+- **Better Documentation**: Comprehensive README with marketing-style positioning
+- **Example Test Cases**: Complete example with tagging system and documentation
+- **TypeScript Support**: Full TypeScript compilation and type safety
+- **Git Safety**: Safe Git commands preventing agent hangs
+- **Merge Requirements**: Advanced branch management with conflict resolution
+
+#### 🛡️ Security & Reliability
+- **Agent Integrity Rules**: Prevents "fake it till you make it" behavior
+- **Test Ethics**: Mandatory evidence collection and validation
+- **Communication Standards**: Clear accountability and progress reporting
+- **Architecture Discipline**: Clean separation of concerns and technical debt prevention
+
+#### 📚 Documentation
+- **Marketing README**: Compelling documentation positioning FRAIM as the future
+- **Problem-Solution Mapping**: Each rule clearly mapped to specific problems
+- **Human-Agent Parallels**: Clear comparison between human and AI development
+- **Success Stories**: Realistic testimonials and quantified benefits
+
+#### 🎯 Workflow Enhancements
+- **RIGOR Methodology**: Reviews, Isolation, GitOps, Observability, Retrospectives
+- **Phase-Based Development**: Spec → Design → Implementation → Testing → Resolution
+- **Agent Coordination**: Seamless handoffs between multiple AI agents
+- **Continuous Learning**: Retrospective-driven improvement system
+
+#### 🔄 Breaking Changes
+- **Simplified Labels**: Reduced from 15 to 9 essential labels
+- **Install Method**: Single npm install method (removed curl, Python options)
+- **Generic Examples**: All Ashley-specific examples replaced with universal patterns
+
+#### 🐛 Bug Fixes
+- **TypeScript Compilation**: Fixed all compilation issues
+- **Import Dependencies**: Resolved missing dependencies
+- **Test Utilities**: Made generic and framework-agnostic
+- **Repository References**: Updated all URLs to point to FRAIM repository
+
+#### 📦 Dependencies
+- Added TypeScript support with proper type definitions
+- Added tsx for TypeScript execution
+- Added dotenv for environment management
+- Updated Node.js engine requirement to >=16.0.0
+
+---
+
+## [1.0.12] - Previous Release
+- Initial FRAIM framework with Ashley-specific implementations
+- Basic rule system and workflows
+- GitHub integration and automation

package/CODEOWNERS

@@ -0,0 +1,24 @@
+# This file defines the code owners for the FRAIM repository
+# Code owners are automatically requested for review when someone opens a PR that modifies code they own
+# See: https://docs.github.com/en/repositories/managing-your-codebase-in-github/about-code-owners
+
+# Default owners for everything in the repo
+*       @mathursrus
+
+# Specific ownership for different parts of the codebase
+/agents/         @mathursrus
+/rules/          @mathursrus
+/workflows/      @mathursrus
+/templates/      @mathursrus
+/scripts/        @mathursrus
+/.github/        @mathursrus
+
+# Documentation
+/docs/           @mathursrus
+*.md             @mathursrus
+
+# Configuration files
+*.json           @mathursrus
+*.jsonc          @mathursrus
+*.yml            @mathursrus
+*.yaml           @mathursrus

package/DISTRIBUTION.md

@@ -160,17 +160,17 @@ npx @fraim/framework init
 ### Primary
 - **NPX**: `npx @fraim/framework`
 - **Python**: `pip install fraim-framework`
-- **GitHub**: `https://github.com/mathursrus/Ashley-Calendar-AI/tree/master/FRAIM`
+- **GitHub**: `https://github.com/mathursrus/FRAIM`
 
 ### Documentation
 - **Main Docs**: `https://fraim.dev`
-- **GitHub Wiki**: `https://github.com/mathursrus/Ashley-Calendar-AI/wiki`
-- **Examples**: `https://github.com/mathursrus/Ashley-Calendar-AI/tree/master/FRAIM/examples`
+- **GitHub Wiki**: `https://github.com/mathursrus/FRAIM/wiki`
+- **Examples**: `https://github.com/mathursrus/FRAIM/tree/master/examples`
 
 ### Support
-- **Issues**: `https://github.com/mathursrus/Ashley-Calendar-AI/issues`
-- **Discussions**: `https://github.com/mathursrus/Ashley-Calendar-AI/discussions`
-- **Community**: `https://github.com/mathursrus/Ashley-Calendar-AI/community`
+- **Issues**: `https://github.com/mathursrus/FRAIM/issues`
+- **Discussions**: `https://github.com/mathursrus/FRAIM/discussions`
+- **Community**: `https://github.com/mathursrus/FRAIM/community`
 
 ## 🎯 Next Steps
 

package/PUBLISH_INSTRUCTIONS.md

@@ -0,0 +1,93 @@
+# Publishing FRAIM v2 to npm
+
+## Prerequisites
+1. **npm account**: You need an npm account to publish packages
+2. **npm CLI**: Make sure you have npm installed and updated
+
+## Step 1: Login to npm
+```bash
+npm login
+```
+Enter your npm username, password, and email when prompted.
+
+## Step 2: Verify Login
+```bash
+npm whoami
+```
+Should display your npm username.
+
+## Step 3: Test the Package (Optional but Recommended)
+```bash
+# Test the package locally
+npm pack
+# This creates a .tgz file you can inspect
+
+# Test installation locally
+npm install -g ./fraim-framework-2.0.0.tgz
+fraim --help
+```
+
+## Step 4: Publish to npm
+```bash
+npm publish
+```
+
+## Step 5: Verify Publication
+```bash
+# Check the package on npm
+npm view fraim-framework
+
+# Test installation from npm
+npm install -g fraim-framework@2.0.0
+fraim --help
+```
+
+## What's Included in v2.0.0
+
+### 🚀 Major Features
+- **Complete Generic Framework**: No Ashley-specific IP
+- **13 Comprehensive Rule Files**: Full AI agent management
+- **Simplified Label System**: 9 essential labels
+- **Spec Workflow**: Requirements and UX definition
+- **Timeout Management**: Advanced script execution with visibility
+- **Evidence-Based Validation**: Mandatory test evidence
+- **Systematic Debugging**: Structured debugging patterns
+
+### 📦 Package Contents
+- `bin/fraim.js` - Main CLI executable
+- `index.js` - Main entry point
+- `setup.js` - Setup script for new projects
+- `package.json` - Package configuration (v2.0.0)
+- `.ai-agents/` - Complete rule system
+- `examples/` - Example test cases with documentation
+- `CHANGELOG.md` - Detailed changelog
+- `README.md` - Marketing-style documentation
+
+### 🎯 Installation
+```bash
+npm install -g fraim-framework
+fraim init
+```
+
+## Post-Publication Tasks
+
+1. **Update README**: Ensure all installation instructions use the new v2 commands
+2. **GitHub Release**: Create a GitHub release for v2.0.0
+3. **Documentation**: Update any external documentation
+4. **Social Media**: Share the LinkedIn post about v2
+
+## Rollback Plan (if needed)
+```bash
+# If you need to unpublish (only works within 24 hours)
+npm unpublish fraim-framework@2.0.0
+
+# Or deprecate the version
+npm deprecate fraim-framework@2.0.0 "Use latest version instead"
+```
+
+## Success Metrics
+- Package successfully published to npm
+- Installation works: `npm install -g fraim-framework`
+- CLI works: `fraim --help`
+- Setup works: `fraim init`
+- All examples and documentation updated