pi-harness-runtime 0.10.13 → 0.10.15

package/IMPLEMENTATION/RFC-0035/AI_BRIEF.md

@@ -1,55 +0,0 @@
-# RFC-0035 AI Brief: Roadmap V1
-
-## Summary
-
-Implementation roadmap for RFCs 0031-0040 with phases, dependencies, and milestones.
-
-## Phases Overview
-
-### Phase 1: Foundation (Weeks 1-2)
-
-- RFC-0031: Provider Adapter SDK
-- RFC-0034: Observability
-
-### Phase 2: Core Systems (Weeks 3-5)
-
-- RFC-0032: Checkpoint Engine
-- RFC-0033: Session Manager
-- Integration testing
-
-### Phase 3: Advanced Features (Weeks 6-10)
-
-- RFC-0036: Code Review Engine
-- RFC-0037: Code Generation Pipeline
-- RFC-0038: Framework Detector
-- RFC-0039: Test Data Generator
-- RFC-0040: Framework Plugin SDK
-
-## Key Dependencies
-
-```
-RFC-0031 (Adapter SDK) --+--► RFC-0036 (Code Review Engine)
-                          |
-RFC-0032 (Checkpoint) ◄--+
-                          |
-RFC-0033 (Session) ◄-----+--► RFC-0034 (Observability)
-                          |
-RFC-0034 (Observability) ◄+
-
-RFC-0038 (Framework Detector) --+--► RFC-0039 (Test Data Generator)
-                                 |
-RFC-0037 (Code Generation) ◄-----+
-                                 |
-RFC-0040 (Plugin SDK) ◄----------+
-```
-
-## Success Metrics
-
-- Checkpoint storage reduction: >60%
-- Recovery time: <100ms
-- Session restore success rate: >99%
-- Framework detection accuracy: >90%
-
-## Files to Create
-
-This RFC is documentation-only - no implementation files needed.

package/IMPLEMENTATION/RFC-0035/TASKS.md

@@ -1,75 +0,0 @@
-# RFC-0035 Implementation Tasks
-
-## Phase 1: Foundation (Weeks 1-2)
-
-### Week 1: RFC-0031 Provider Adapter SDK
-
-- [ ] Complete RFC-0031 implementation (see RFC-0031 TASKS.md)
-- [ ] Migration of existing adapters
-- [ ] SDK documentation
-
-### Week 2: RFC-0034 Observability
-
-- [ ] Complete RFC-0034 implementation (see RFC-0034 TASKS.md)
-- [ ] Structured logging integration
-- [ ] Metrics endpoint
-- [ ] Health check endpoints
-
-## Phase 2: Core Systems (Weeks 3-5)
-
-### Week 3: RFC-0032 Checkpoint Engine
-
-- [ ] Complete RFC-0032 implementation (see RFC-0032 TASKS.md)
-- [ ] Incremental storage
-- [ ] Compression
-- [ ] Recovery strategies
-
-### Week 4: RFC-0033 Session Manager
-
-- [ ] Complete RFC-0033 implementation (see RFC-0033 TASKS.md)
-- [ ] Session persistence
-- [ ] Policy engine
-- [ ] Metrics collection
-
-### Week 5: Integration Testing
-
-- [ ] Integration tests for all Phase 1-2 components
-- [ ] Performance benchmarks
-- [ ] Documentation updates
-- [ ] Bug fixes
-
-## Phase 3: Advanced Features (Weeks 6-10)
-
-### Week 6-7: RFC-0036 Code Review Engine
-
-- [ ] Complete RFC-0036 implementation (see RFC-0036 TASKS.md)
-- [ ] Integration with AgentWorker
-- [ ] CI/CD examples
-
-### Week 7-8: RFC-0037 Code Generation Pipeline
-
-- [ ] Complete RFC-0037 implementation (see RFC-0037 TASKS.md)
-- [ ] Template system
-- [ ] Validation pipeline
-- [ ] Rollback mechanism
-
-### Week 8-9: RFC-0038 Framework Detector
-
-- [ ] Complete RFC-0038 implementation (see RFC-0038 TASKS.md)
-- [ ] Detection signatures
-- [ ] Version detection
-- [ ] Real-time watching
-
-### Week 9-10: RFC-0039 & RFC-0040
-
-- [ ] Complete RFC-0039 Test Data Generator
-- [ ] Complete RFC-0040 Framework Plugin SDK
-- [ ] Plugin examples
-- [ ] Final integration testing
-
-## Ongoing Tasks
-
-- [ ] Update CHANGELOG.md with each release
-- [ ] Maintain README.md with progress
-- [ ] Performance monitoring
-- [ ] User feedback integration

package/IMPLEMENTATION/RFC-0036/AI_BRIEF.md

@@ -1,62 +0,0 @@
-# RFC-0036 AI Brief: Code Review Engine
-
-## Summary
-
-An automated code review engine that performs static analysis, runs linters, and integrates AI-powered review suggestions.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **CodeReviewEngine** (`engine.ts`)
-   - Pattern-based rule matching
-   - Multi-file review
-   - Git diff review
-   - Report generation
-
-2. **Review DSL Parser** (`dsl/parser.ts`)
-   - Parse review-rules.config.ts
-   - Validate rule definitions
-   - Load ESLint/TypeScript configs
-
-3. **Linter Adapters** (`linters/`)
-   - ESLint adapter
-   - TypeScript adapter
-   - Prettier adapter
-   - Custom linter support
-
-4. **AIReviewer** (`ai-reviewer/`)
-   - OpenAI integration
-   - Anthropic/Claude integration
-   - Security, performance, best-practices focus areas
-
-5. **Report Generator** (`reports/`)
-   - Text format
-   - JSON format
-   - HTML format
-   - Markdown format
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- `packages/provider-adapter-sdk` - for AI provider integration
-- `eslint` - optional, for ESLint integration
-- `typescript` - optional, for TS checking
-
-### Files to Create
-
-- `packages/code-review/src/engine.ts`
-- `packages/code-review/src/dsl/parser.ts`
-- `packages/code-review/src/dsl/validator.ts`
-- `packages/code-review/src/linters/base.ts`
-- `packages/code-review/src/linters/eslint.ts`
-- `packages/code-review/src/linters/typescript.ts`
-- `packages/code-review/src/linters/prettier.ts`
-- `packages/code-review/src/linters/registry.ts`
-- `packages/code-review/src/ai-reviewer/index.ts`
-- `packages/code-review/src/reports/text.ts`
-- `packages/code-review/src/reports/html.ts`
-- `packages/code-review/src/reports/markdown.ts`
-- `packages/code-review/src/history/tracker.ts`
-- `packages/code-review/src/types.ts`
-- `packages/code-review/src/index.ts`

package/IMPLEMENTATION/RFC-0036/TASKS.md

@@ -1,60 +0,0 @@
-# RFC-0036 Implementation Tasks
-
-## Phase 1: Engine Core
-
-- [ ] Create `packages/code-review/` directory
-- [ ] Define types (`Finding`, `ReviewResult`, `ReviewRule`)
-- [ ] Create `CodeReviewEngine` class
-- [ ] Implement `reviewFiles()` method
-- [ ] Implement `reviewDiff()` method
-- [ ] Implement pattern matching engine
-
-## Phase 2: DSL & Rules
-
-- [ ] Create `dsl/parser.ts`
-- [ ] Implement rules configuration parsing
-- [ ] Implement pattern validation
-- [ ] Create default rules:
-  - [ ] no-console-log
-  - [ ] no-any-type
-  - [ ] security-no-eval
-- [ ] Add support for external config files
-
-## Phase 3: Linter Integration
-
-- [ ] Create `LinterAdapter` interface
-- [ ] Implement `ESLintAdapter`
-- [ ] Implement `TypeScriptAdapter`
-- [ ] Implement `PrettierAdapter`
-- [ ] Create `LinterRegistry`
-- [ ] Add support for custom linters
-
-## Phase 4: AI Reviewer
-
-- [ ] Create `AIReviewer` class
-- [ ] Implement `AIReviewerConfig`
-- [ ] Implement OpenAI integration
-- [ ] Implement Anthropic/Claude integration
-- [ ] Add focus areas (security, performance, etc.)
-
-## Phase 5: Reporting
-
-- [ ] Create `ReviewReportGenerator`
-- [ ] Implement text report format
-- [ ] Implement JSON report format
-- [ ] Implement HTML report format
-- [ ] Implement Markdown report format
-
-## Phase 6: History & Trends
-
-- [ ] Create `ReviewHistoryTracker`
-- [ ] Implement `getTrends()`
-- [ ] Add comparison between reviews
-- [ ] Create trend visualization data
-
-## Phase 7: Integration
-
-- [ ] Integrate with AgentWorker
-- [ ] Add CI/CD examples (GitHub Actions, GitLab CI)
-- [ ] Create review-rules.config.ts examples
-- [ ] Write unit tests

package/IMPLEMENTATION/RFC-0037/AI_BRIEF.md

@@ -1,59 +0,0 @@
-# RFC-0037 AI Brief: Code Generation Pipeline
-
-## Summary
-
-A comprehensive code generation system with template management, validation pipeline, and automatic rollback capabilities.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **CodeGenerator** (`generator.ts`)
-   - Template loading and management
-   - Variable resolution
-   - File generation
-   - Dry run/preview mode
-
-2. **TemplateManager** (`templates/manager.ts`)
-   - Template registry
-   - Template loading from filesystem
-   - EJS-based rendering
-
-3. **ValidationPipeline** (`validation/pipeline.ts`)
-   - Rule-based validation
-   - TypeScript checking
-   - ESLint validation
-   - Security scanning
-
-4. **RollbackManager** (`rollback/manager.ts`)
-   - Checkpoint creation
-   - File restoration
-   - Automatic rollback on failure
-
-5. **ChangeTracker** (`changes/tracker.ts`)
-   - Change set recording
-   - Diff generation
-   - History management
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- `ejs` - template rendering
-- `diff` - for generating file diffs
-- `fast-glob` - for file pattern matching
-
-### Files to Create
-
-- `packages/code-generation/src/generator.ts`
-- `packages/code-generation/src/templates/manager.ts`
-- `packages/code-generation/src/templates/loader.ts`
-- `packages/code-generation/src/templates/registry.ts`
-- `packages/code-generation/src/validation/pipeline.ts`
-- `packages/code-generation/src/validation/rules/`
-- `packages/code-generation/src/validation/validators/`
-- `packages/code-generation/src/rollback/manager.ts`
-- `packages/code-generation/src/rollback/snapshot.ts`
-- `packages/code-generation/src/changes/tracker.ts`
-- `packages/code-generation/src/engine/renderer.ts`
-- `packages/code-generation/src/types.ts`
-- `packages/code-generation/src/index.ts`

package/IMPLEMENTATION/RFC-0037/TASKS.md

@@ -1,63 +0,0 @@
-# RFC-0037 Implementation Tasks
-
-## Phase 1: Generator Core
-
-- [ ] Create `packages/code-generation/` directory
-- [ ] Define types (`CodeTemplate`, `GeneratedFile`, `GenerationResult`)
-- [ ] Create `CodeGenerator` class
-- [ ] Implement `generate()` method
-- [ ] Implement `preview()` (dry run) method
-
-## Phase 2: Template System
-
-- [ ] Create `TemplateManager` class
-- [ ] Implement EJS-based rendering
-- [ ] Implement `TemplateRegistry`
-- [ ] Add variable resolution
-- [ ] Create built-in templates:
-  - [ ] React component template
-  - [ ] Next.js page template
-  - [ ] API endpoint template
-
-## Phase 3: Validation Pipeline
-
-- [ ] Create `ValidationPipeline` class
-- [ ] Define `ValidationRule` interface
-- [ ] Implement built-in rules:
-  - [ ] no-typescript-errors
-  - [ ] no-unused-imports
-  - [ ] security-no-hardcoded-secrets
-- [ ] Implement TypeScript validation
-- [ ] Implement ESLint validation
-
-## Phase 4: Rollback System
-
-- [ ] Create `RollbackManager` class
-- [ ] Implement checkpoint creation
-- [ ] Implement file restoration
-- [ ] Implement `rollback()` method
-- [ ] Implement `listCheckpoints()`
-- [ ] Implement `prune()`
-
-## Phase 5: Change Tracking
-
-- [ ] Create `ChangeTracker` class
-- [ ] Implement `recordGeneration()`
-- [ ] Implement `recordRollback()`
-- [ ] Implement `getRecentChanges()`
-- [ ] Implement diff generation
-
-## Phase 6: Framework Integration
-
-- [ ] Create framework-specific templates
-- [ ] Integrate with FrameworkDetector (RFC-0038)
-- [ ] Add Frappe/ERPNext templates
-- [ ] Add Next.js templates
-- [ ] Add Django templates
-
-## Phase 7: Testing & Documentation
-
-- [ ] Write unit tests for all components
-- [ ] Create usage examples
-- [ ] Write documentation
-- [ ] Performance testing with large templates

package/IMPLEMENTATION/RFC-0038/AI_BRIEF.md

@@ -1,67 +0,0 @@
-# RFC-0038 AI Brief: Framework Detector
-
-## Summary
-
-An intelligent framework detection system that identifies project frameworks, libraries, and architectures with confidence scoring.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **FrameworkDetector** (`detector.ts`)
-   - Signal-based detection
-   - Confidence scoring
-   - File scanning
-   - Package analysis
-
-2. **FrameworkSignature Registry** (`signatures/registry.ts`)
-   - Detection pattern definitions
-   - Pattern weighting
-   - Framework metadata
-
-3. **VersionDetector** (`version-detector/`)
-   - Frappe version detection
-   - Next.js version detection
-   - Django version detection
-   - Framework-specific version parsing
-
-4. **FileScanner** (`scanners/file-scanner.ts`)
-   - Directory traversal
-   - Pattern matching
-   - Caching
-
-### Supported Frameworks
-
-- Frappe/ERPNext
-- Frappe SPA
-- Next.js
-- React with Vite
-- React with CRA
-- Django
-- Laravel
-- Spring Boot
-- And more...
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- `fast-glob` - for file pattern matching
-- `chokidar` - for file watching
-
-### Files to Create
-
-- `packages/framework-detector/src/detector.ts`
-- `packages/framework-detector/src/signatures/registry.ts`
-- `packages/framework-detector/src/signatures/patterns.ts`
-- `packages/framework-detector/src/signatures/weights.ts`
-- `packages/framework-detector/src/scanners/file-scanner.ts`
-- `packages/framework-detector/src/scanners/package-scanner.ts`
-- `packages/framework-detector/src/scanners/config-scanner.ts`
-- `packages/framework-detector/src/version-detector/index.ts`
-- `packages/framework-detector/src/version-detector/frappe.ts`
-- `packages/framework-detector/src/version-detector/nextjs.ts`
-- `packages/framework-detector/src/version-detector/django.ts`
-- `packages/framework-detector/src/cache/detector-cache.ts`
-- `packages/framework-detector/src/watcher/file-watcher.ts`
-- `packages/framework-detector/src/types.ts`
-- `packages/framework-detector/src/index.ts`

package/IMPLEMENTATION/RFC-0038/TASKS.md

@@ -1,65 +0,0 @@
-# RFC-0038 Implementation Tasks
-
-## Phase 1: Detector Core
-
-- [ ] Create `packages/framework-detector/` directory
-- [ ] Define types (`FrameworkDetection`, `DetectionSignal`, etc.)
-- [ ] Create `FrameworkDetector` class
-- [ ] Implement `detect()` method
-- [ ] Implement `quickDetect()` method
-
-## Phase 2: Signatures
-
-- [ ] Create `FrameworkSignatureRegistry`
-- [ ] Define detection patterns for:
-  - [ ] Frappe/ERPNext
-  - [ ] Frappe SPA
-  - [ ] Next.js
-  - [ ] React (Vite)
-  - [ ] React (CRA)
-  - [ ] Vue.js
-  - [ ] Django
-  - [ ] Laravel
-  - [ ] Spring Boot
-  - [ ] Ruby on Rails
-- [ ] Implement pattern weighting
-
-## Phase 3: Scanners
-
-- [ ] Create `FileScanner` class
-- [ ] Implement directory traversal
-- [ ] Implement pattern matching
-- [ ] Create `PackageScanner` for package.json analysis
-- [ ] Create `ConfigScanner` for config file parsing
-- [ ] Add parallel scanning support
-
-## Phase 4: Version Detection
-
-- [ ] Create `VersionDetector` class
-- [ ] Implement Frappe version detection
-- [ ] Implement Next.js version detection
-- [ ] Implement Django version detection
-- [ ] Implement Laravel version detection
-- [ ] Add version caching
-
-## Phase 5: Caching & Watching
-
-- [ ] Create detection cache
-- [ ] Implement cache invalidation
-- [ ] Create `FileWatcher` for real-time updates
-- [ ] Implement callback-based notifications
-
-## Phase 6: Capabilities & Recommendations
-
-- [ ] Implement `FrameworkCapability` detection
-- [ ] Create `StrategyRecommendation` engine
-- [ ] Add recommended seed strategies
-- [ ] Add recommended E2E strategies
-
-## Phase 7: Testing & Documentation
-
-- [ ] Create test fixtures for each framework
-- [ ] Test detection accuracy
-- [ ] Test version detection
-- [ ] Performance testing
-- [ ] Write documentation

package/IMPLEMENTATION/RFC-0039/AI_BRIEF.md

@@ -1,68 +0,0 @@
-# RFC-0039 AI Brief: Test Data Generator
-
-## Summary
-
-A comprehensive test data generation system that creates realistic, framework-aware test data with Faker.js integration and multiple export formats.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **TestDataGenerator** (`generator.ts`)
-   - Schema-based generation
-   - Bulk data creation
-   - Multiple export formats
-   - Seed support for reproducibility
-
-2. **SchemaManager** (`schema/validator.ts`)
-   - Schema validation
-   - Field type definitions
-   - Custom generator support
-
-3. **FactoryRegistry** (`factories/registry.ts`)
-   - Factory pattern for test data
-   - Default values
-   - Sequences
-   - Post-creation hooks
-
-4. **RelationHandler** (`relations/handler.ts`)
-   - Foreign key relationships
-   - One-to-many, many-to-many
-   - Referential integrity
-
-5. **FrameworkAdapters** (`adapters/`)
-   - Frappe adapter
-   - Next.js adapter
-   - Django adapter
-   - Laravel adapter
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- `@faker-js/faker` - data generation
-- `yaml` - YAML export
-- `csv-stringify` - CSV export
-
-### Files to Create
-
-- `packages/test-data-generator/src/generator.ts`
-- `packages/test-data-generator/src/schema/validator.ts`
-- `packages/test-data-generator/src/schema/parser.ts`
-- `packages/test-data-generator/src/faker/faker-adapter.ts`
-- `packages/test-data-generator/src/faker/generators.ts`
-- `packages/test-data-generator/src/factories/registry.ts`
-- `packages/test-data-generator/src/factories/builder.ts`
-- `packages/test-data-generator/src/relations/handler.ts`
-- `packages/test-data-generator/src/relations/integrity.ts`
-- `packages/test-data-generator/src/exporters/json.ts`
-- `packages/test-data-generator/src/exporters/csv.ts`
-- `packages/test-data-generator/src/exporters/sql.ts`
-- `packages/test-data-generator/src/exporters/yaml.ts`
-- `packages/test-data-generator/src/exporters/fixtures/django.ts`
-- `packages/test-data-generator/src/exporters/fixtures/laravel.ts`
-- `packages/test-data-generator/src/adapters/frappe.ts`
-- `packages/test-data-generator/src/adapters/nextjs.ts`
-- `packages/test-data-generator/src/adapters/django.ts`
-- `packages/test-data-generator/src/adapters/laravel.ts`
-- `packages/test-data-generator/src/types.ts`
-- `packages/test-data-generator/src/index.ts`

package/IMPLEMENTATION/RFC-0039/TASKS.md

@@ -1,74 +0,0 @@
-# RFC-0039 Implementation Tasks
-
-## Phase 1: Generator Core
-
-- [ ] Create `packages/test-data-generator/` directory
-- [ ] Define types (`DataSchema`, `FieldDefinition`, `GeneratedData`)
-- [ ] Create `TestDataGenerator` class
-- [ ] Implement `generate()` method
-- [ ] Implement `generateOne()` method
-
-## Phase 2: Schema System
-
-- [ ] Create `SchemaValidator` class
-- [ ] Define built-in field types
-- [ ] Implement schema parsing
-- [ ] Add validation rules
-- [ ] Create default schemas:
-  - [ ] user schema
-  - [ ] product schema
-  - [ ] order schema
-
-## Phase 3: Faker Integration
-
-- [ ] Create `FakerAdapter` class
-- [ ] Implement Faker method mapping
-- [ ] Add locale support
-- [ ] Add seed support
-- [ ] Create custom generators
-
-## Phase 4: Factory Pattern
-
-- [ ] Create `FactoryRegistry` class
-- [ ] Implement `registerFactory()`
-- [ ] Implement `create()` method
-- [ ] Implement `createMany()` method
-- [ ] Add `sequences` support
-- [ ] Add `afterCreate` hooks
-
-## Phase 5: Relations
-
-- [ ] Create `RelationHandler` class
-- [ ] Implement relation types:
-  - [ ] one-to-one
-  - [ ] one-to-many
-  - [ ] many-to-many
-- [ ] Implement referential integrity
-- [ ] Implement `generateWithRelations()`
-
-## Phase 6: Exporters
-
-- [ ] Create JSON exporter
-- [ ] Create JSONL exporter
-- [ ] Create CSV exporter
-- [ ] Create SQL exporter (INSERT statements)
-- [ ] Create YAML exporter
-- [ ] Create fixture exporters:
-  - [ ] Django fixtures
-  - [ ] Laravel factories
-  - [ ] FactoryBot (Ruby)
-
-## Phase 7: Framework Adapters
-
-- [ ] Create `FrameworkAdapter` interface
-- [ ] Implement Frappe adapter
-- [ ] Implement Next.js adapter
-- [ ] Implement Django adapter
-- [ ] Implement Laravel adapter
-
-## Phase 8: Testing & Documentation
-
-- [ ] Write unit tests
-- [ ] Create usage examples
-- [ ] Performance testing with large datasets
-- [ ] Write documentation