claude-flow-novice 2.18.6 → 2.18.8

package/claude-assets/skills/cfn-loop-orchestration-v2/lib/output/INDEX.md

@@ -1,531 +0,0 @@
-# CFN Loop Output Processing - Complete Index
-
-**Version:** 1.0.0
-**Status:** Production Ready
-**Last Updated:** November 19, 2025
-
----
-
-## Quick Navigation
-
-### Getting Started
-- **[README.md](README.md)** - Quick start guide and installation
-- **[SKILL.md](SKILL.md)** - Complete API reference and integration guide
-
-### Implementation Details
-- **[IMPLEMENTATION_SUMMARY.md](IMPLEMENTATION_SUMMARY.md)** - What was built and why
-- **[src/output-processor.ts](src/output-processor.ts)** - Core TypeScript module (600 lines)
-
-### Learning & Examples
-- **[EXAMPLES.md](EXAMPLES.md)** - Real-world usage examples for all features
-- **[tests/output-processor.test.ts](tests/output-processor.test.ts)** - 48 test cases showing expected behavior
-
-### Migration & Deprecation
-- **[MIGRATION.md](MIGRATION.md)** - Step-by-step migration guide from bash
-- **[DEPRECATION_NOTICE.md](DEPRECATION_NOTICE.md)** - Timeline and support information
-
----
-
-## Directory Structure
-
-```
-cfn-loop-output-processing/
-│
-├── Core Implementation
-│   ├── src/
-│   │   ├── output-processor.ts        # Main module (600 lines)
-│   │   └── cli/
-│   │       ├── process-loop3.ts       # Loop 3 CLI tool (100 lines)
-│   │       └── process-loop2.ts       # Loop 2 CLI tool (120 lines)
-│   └── tests/
-│       └── output-processor.test.ts   # Test suite (48 tests, 700 lines)
-│
-├── Documentation
-│   ├── README.md                      # Quick start (100 lines)
-│   ├── SKILL.md                       # Complete reference (500 lines)
-│   ├── MIGRATION.md                   # Migration guide (300 lines)
-│   ├── DEPRECATION_NOTICE.md          # Deprecation notice (200 lines)
-│   ├── EXAMPLES.md                    # Usage examples (400 lines)
-│   ├── IMPLEMENTATION_SUMMARY.md      # Implementation details (400 lines)
-│   └── INDEX.md                       # This file
-│
-└── Configuration
-    ├── package.json                   # Dependencies and scripts
-    ├── tsconfig.json                  # TypeScript configuration
-    ├── jest.config.js                 # Jest test configuration
-    └── .eslintrc.json                 # ESLint configuration
-```
-
-**Total: 10 files, 2700+ lines (code + documentation)**
-
----
-
-## What Was Consolidated
-
-### Three Bash Skills Merged Into One TypeScript Module
-
-| Original Skill | Files Consolidated | Replaced By |
-|---|---|---|
-| `cfn-loop2-output-processing` | 4 files, 450 lines | `output-processor.ts` functions |
-| `cfn-loop3-output-processing` | 4 files, 140 lines | `output-processor.ts` functions |
-| `cfn-agent-output-processing` (partial) | Concept reused | `ParsingConfig` interface |
-
-**Result:** Single module with zero duplication, 90%+ test coverage, full type safety.
-
----
-
-## Key Features
-
-### 1. Confidence Extraction (5+ Patterns)
-```typescript
-parseConfidence(output)
-```
-- Explicit header: `## Validation Confidence: 0.85`
-- Generic field: `confidence: 0.92`
-- Score field: `Score: 0.78`
-- Percentage: `92%`
-- Parentheses: `(0.87)`
-- Qualitative: `high confidence` → 0.90
-
-### 2. Feedback Extraction (Categorized)
-```typescript
-extractFeedback(output)
-```
-- Severity levels: CRITICAL, WARNING, SUGGESTION
-- Markdown sections: `### CRITICAL Issues`
-- Inline format: `CRITICAL: issue text`
-- Multiple bullet styles: `-`, `*`, `•`
-
-### 3. Recommendations Extraction
-```typescript
-extractRecommendations(output)
-```
-- Find "Recommendations:", "Suggestion:", etc.
-- Extract and deduplicate
-- Filter empty items
-
-### 4. Consensus Calculation
-```typescript
-calculateConsensus(results[], threshold?)
-```
-- Average score from multiple validators
-- Min/max score tracking
-- Issue aggregation
-- Pass/fail determination
-
-### 5. Loop-Specific Parsers
-```typescript
-parseLoop3Output(agentOutput, agentId, iteration, gitStatus?)
-parseLoop2Output(validatorOutput, validatorId, iteration?)
-```
-- Complete processing pipelines
-- Type-safe results
-- All features in one call
-
----
-
-## Type Definitions
-
-### Loop 3 Result
-```typescript
-interface Loop3Result {
-  agentId: string;
-  confidence: number;
-  confidenceSource: 'explicit' | 'calculated' | 'fallback';
-  filesChanged: number;
-  deliverables: string[];
-  testsPassedCount?: number;
-  testsFailed?: number;
-  passRate?: number;
-  output: string;
-  iteration: number;
-  timestamp: string;
-}
-```
-
-### Loop 2 Result
-```typescript
-interface Loop2Result {
-  validatorId: string;
-  score: number;
-  scoreSource: 'explicit' | 'calculated' | 'qualitative';
-  issues: FeedbackItem[];
-  criticalCount: number;
-  warningCount: number;
-  suggestionCount: number;
-  recommendations: string[];
-  output: string;
-  iteration: number;
-  timestamp: string;
-}
-```
-
-### Consensus Result
-```typescript
-interface ConsensusResult {
-  averageScore: number;
-  threshold: number;
-  passed: boolean;
-  validatorCount: number;
-  scoredCount: number;
-  minScore: number;
-  maxScore: number;
-  summary: string;
-  details: {
-    criticalIssuesTotal: number;
-    warningIssuesTotal: number;
-    suggestionsTotal: number;
-  };
-}
-```
-
----
-
-## CLI Tools
-
-### Process Loop 3 Output
-```bash
-npx ts-node src/cli/process-loop3.ts \
-  --agent-id "coder-1" \
-  --output "Implementation text..." \
-  --iteration 1
-```
-
-**Options:**
-- `--agent-id` (required) - Agent identifier
-- `--output` or `--output-file` (required) - Output text or file path
-- `--iteration` - Iteration number (default: 1)
-- `--files-changed` - Manual file count
-- `--deliverables` - Comma-separated files
-
-**Returns:** JSON `Loop3Result`
-
-### Process Loop 2 Output (Single)
-```bash
-npx ts-node src/cli/process-loop2.ts \
-  --validator-id "reviewer-1" \
-  --output "Validation text..."
-```
-
-**Options:**
-- `--validator-id` (required) - Validator identifier
-- `--output` or `--output-file` (required) - Output text or file path
-- `--iteration` - Iteration number (default: 1)
-
-**Returns:** JSON `Loop2Result`
-
-### Calculate Consensus
-```bash
-npx ts-node src/cli/process-loop2.ts \
-  --consensus \
-  --results-file ./validator-results.json \
-  --threshold 0.75
-```
-
-**Options:**
-- `--consensus` - Enable consensus mode
-- `--results-file` (required) - JSON file with Loop2Result array
-- `--threshold` - Minimum score to pass (default: 0.70)
-
-**Returns:** JSON `ConsensusResult`
-
----
-
-## Integration Guide
-
-### For Orchestrators (Bash)
-
-**Loop 3 Integration:**
-```bash
-RESULT=$(npx ts-node ./.claude/skills/cfn-loop-output-processing/src/cli/process-loop3.ts \
-  --agent-id "$AGENT_ID" \
-  --output "$AGENT_OUTPUT" \
-  --iteration "$ITERATION")
-
-CONFIDENCE=$(echo "$RESULT" | jq -r '.confidence')
-redis-cli LPUSH "swarm:${TASK_ID}:${AGENT_ID}:confidence" "$CONFIDENCE"
-```
-
-**Loop 2 Integration:**
-```bash
-RESULT=$(npx ts-node ./.claude/skills/cfn-loop-output-processing/src/cli/process-loop2.ts \
-  --validator-id "$VALIDATOR_ID" \
-  --output "$VALIDATOR_OUTPUT")
-
-echo "$RESULT" >> ./validator-results.json
-```
-
-**Consensus:**
-```bash
-CONSENSUS=$(npx ts-node ./.claude/skills/cfn-loop-output-processing/src/cli/process-loop2.ts \
-  --consensus \
-  --results-file ./validator-results.json \
-  --threshold "$THRESHOLD")
-
-PASSED=$(echo "$CONSENSUS" | jq -r '.passed')
-```
-
-### For TypeScript Code (Direct Import)
-
-```typescript
-import {
-  parseConfidence,
-  parseLoop3Output,
-  parseLoop2Output,
-  calculateConsensus,
-} from '@cfn/loop-output-processing';
-
-const result = parseLoop3Output(output, agentId);
-const consensus = calculateConsensus([v1, v2, v3], 0.75);
-```
-
----
-
-## Test Coverage
-
-### Test Suite
-- **File:** `tests/output-processor.test.ts`
-- **Tests:** 48 comprehensive test cases
-- **Coverage:** 90%+ (lines, functions, branches)
-- **Runtime:** ~2.3 seconds
-
-### Test Categories
-1. **Confidence Extraction** (8 tests)
-   - All 5 parsing patterns
-   - Qualitative mappings
-   - Edge cases
-
-2. **Feedback Extraction** (5 tests)
-   - Markdown sections
-   - Inline format
-   - Severity categorization
-
-3. **Recommendations** (4 tests)
-   - Multiple header formats
-   - Deduplication
-   - Empty cases
-
-4. **Fallback Calculation** (6 tests)
-   - File count thresholds
-   - Test integration
-   - Confidence boosts
-
-5. **Validation** (4 tests)
-   - Range checking
-   - NaN handling
-   - Custom ranges
-
-6. **Loop 3 Parsing** (4 tests)
-   - Complete workflow
-   - Git integration
-   - Test result parsing
-
-7. **Loop 2 Parsing** (3 tests)
-   - Feedback extraction
-   - Score parsing
-   - Categorization
-
-8. **Consensus** (6 tests)
-   - Multi-validator aggregation
-   - Threshold checking
-   - Issue counting
-
-9. **Default Detection** (3 tests)
-   - Default output identification
-   - Variation handling
-
-10. **Serialization** (3 tests)
-    - JSON formatting
-    - JSON parsing
-    - Error handling
-
-11. **Integration** (2 tests)
-    - Complete Loop 3 workflow
-    - Complete Loop 2 workflow
-
----
-
-## Performance
-
-### Speed
-- **Confidence extraction:** <1ms
-- **Feedback parsing:** <2ms
-- **Consensus calculation:** <5ms (10 validators)
-- **Full CLI execution:** <100ms
-- **Complete test suite:** ~2.3 seconds
-
-### Memory
-- **Small outputs:** <1MB
-- **Large outputs (100KB):** <5MB
-- **Efficient regex compilation:** Single pass
-
-### Scalability
-- **Single output:** Optimized
-- **Batch processing:** Linear O(n)
-- **No external dependencies:** Fast startup
-
----
-
-## Documentation Map
-
-### For New Users
-1. Start with **README.md** (5 min)
-2. Read **EXAMPLES.md** for your use case (10 min)
-3. Try CLI tools with `--help` (2 min)
-
-### For Developers
-1. Review **SKILL.md** API reference (20 min)
-2. Study **IMPLEMENTATION_SUMMARY.md** (10 min)
-3. Explore test cases in `tests/` (15 min)
-4. Read source code in `src/` (15 min)
-
-### For Migration
-1. Review **MIGRATION.md** step by step (30 min)
-2. Test with your outputs (30 min)
-3. Validate against old system (30 min)
-4. Update orchestrator code (30 min)
-
-### For Support
-1. Check **DEPRECATION_NOTICE.md** FAQ
-2. Review **EXAMPLES.md** for similar cases
-3. Run `npm test` to verify environment
-4. Check CLI `--help` output
-
----
-
-## Quality Metrics
-
-### Code Quality
-- ✅ TypeScript strict mode
-- ✅ ESLint with strict rules
-- ✅ 90%+ test coverage
-- ✅ Zero warnings/errors
-- ✅ Complete type definitions
-
-### Documentation
-- ✅ API reference (SKILL.md)
-- ✅ Usage examples (EXAMPLES.md)
-- ✅ Migration guide (MIGRATION.md)
-- ✅ Implementation details (IMPLEMENTATION_SUMMARY.md)
-- ✅ Deprecation timeline (DEPRECATION_NOTICE.md)
-
-### Testing
-- ✅ 48 comprehensive tests
-- ✅ 90%+ code coverage
-- ✅ Edge case coverage
-- ✅ Integration tests
-- ✅ Performance benchmarks
-
-### Compatibility
-- ✅ Identical CLI interface
-- ✅ Identical JSON output
-- ✅ Same confidence values
-- ✅ Same feedback parsing
-- ✅ No breaking changes
-
----
-
-## What to Read First
-
-### Just Want to Use It?
-→ Read: **README.md** + **EXAMPLES.md**
-
-### Implementing Integration?
-→ Read: **SKILL.md** (API reference)
-
-### Migrating from Bash?
-→ Read: **MIGRATION.md** (step-by-step)
-
-### Need Complete Understanding?
-→ Read: Everything in this order:
-1. README.md
-2. EXAMPLES.md
-3. SKILL.md
-4. IMPLEMENTATION_SUMMARY.md
-5. Source code in src/
-
-### Troubleshooting?
-→ Check:
-1. EXAMPLES.md for similar cases
-2. MIGRATION.md troubleshooting section
-3. Test cases in tests/
-4. CLI --help output
-
----
-
-## Support Resources
-
-### Documentation Files
-| File | Purpose | Time |
-|------|---------|------|
-| README.md | Quick start | 5 min |
-| SKILL.md | Complete reference | 30 min |
-| EXAMPLES.md | Usage patterns | 15 min |
-| MIGRATION.md | Migration guide | 30 min |
-| DEPRECATION_NOTICE.md | Timeline & FAQ | 10 min |
-| IMPLEMENTATION_SUMMARY.md | Design details | 15 min |
-
-### Code Resources
-| File | Purpose | Lines |
-|------|---------|-------|
-| src/output-processor.ts | Core logic | 600 |
-| src/cli/process-loop3.ts | Loop 3 tool | 100 |
-| src/cli/process-loop2.ts | Loop 2 tool | 120 |
-| tests/output-processor.test.ts | Tests & examples | 700 |
-
-### Configuration
-| File | Purpose |
-|------|---------|
-| package.json | Dependencies & scripts |
-| tsconfig.json | TypeScript configuration |
-| jest.config.js | Test configuration |
-| .eslintrc.json | Linting rules |
-
----
-
-## Version Information
-
-**Current Version:** 1.0.0
-**Released:** November 19, 2025
-**Status:** Production Ready
-**Support Timeline:** 90 days (until legacy bash scripts removed)
-
-### What's Included
-- Type-safe output processing module
-- 5+ confidence extraction patterns
-- Robust feedback parsing
-- Consensus calculation
-- CLI tools for orchestrator integration
-- 90%+ test coverage
-- Comprehensive documentation
-- Migration guide
-
-### What's New vs Bash Version
-- ✅ Full type safety
-- ✅ 90%+ test coverage (was <30%)
-- ✅ Zero code duplication
-- ✅ Better performance
-- ✅ IDE autocomplete support
-- ✅ Comprehensive documentation
-- ✅ Easy to extend
-
----
-
-## Summary
-
-This is a **production-ready TypeScript module** that consolidates output processing for CFN Loop agents with:
-
-- **Quality:** 90%+ test coverage, zero errors
-- **Safety:** Full TypeScript strict mode
-- **Performance:** <100ms CLI execution
-- **Documentation:** 2000+ lines of docs
-- **Compatibility:** Identical to bash predecessors
-- **Support:** 90-day deprecation period
-
-**Status:** Ready for immediate use in orchestrators.
-
----
-
-**For questions, refer to the appropriate documentation file above.**
-**For migration, follow MIGRATION.md step by step.**
-**For examples, check EXAMPLES.md for your use case.**

package/claude-assets/skills/cfn-loop-orchestration-v2/lib/output/README.md

@@ -1,114 +0,0 @@
-# CFN Loop Output Processing - TypeScript Module
-
-Type-safe, consolidated output processing for CFN Loop agents.
-
-## Quick Start
-
-### Installation
-
-```bash
-npm install
-npm run build
-```
-
-### Usage
-
-#### Process Loop 3 (Implementer) Output
-
-```bash
-npx ts-node src/cli/process-loop3.ts \
-  --agent-id "coder-1" \
-  --output "Implementation complete. Confidence: 0.85"
-```
-
-#### Process Loop 2 (Validator) Output
-
-```bash
-npx ts-node src/cli/process-loop2.ts \
-  --validator-id "reviewer-1" \
-  --output "Validation passed. Confidence: 0.92"
-```
-
-#### Calculate Consensus
-
-```bash
-npx ts-node src/cli/process-loop2.ts \
-  --consensus \
-  --results-file ./validator-results.json \
-  --threshold 0.75
-```
-
-### Programmatic Usage
-
-```typescript
-import {
-  parseConfidence,
-  extractFeedback,
-  parseLoop3Output,
-  parseLoop2Output,
-  calculateConsensus,
-} from './src/output-processor';
-
-// Extract confidence score
-const { score, source } = parseConfidence('Confidence: 0.85');
-
-// Parse validator feedback
-const result = parseLoop2Output(validatorOutput, 'reviewer-1');
-
-// Calculate consensus from multiple validators
-const consensus = calculateConsensus([result1, result2, result3], 0.75);
-```
-
-## Features
-
-- **5+ Confidence Patterns**: Explicit numeric, percentage, qualitative, parentheses, etc.
-- **Robust Feedback Parsing**: Markdown sections, inline format, multiple severity levels
-- **Consensus Calculation**: Aggregate results from multiple validators
-- **Type-Safe Interfaces**: Full TypeScript support with strict mode
-- **90%+ Test Coverage**: Comprehensive test suite with edge cases
-- **CLI Tools**: Process agent outputs directly
-- **Zero Dependencies**: Uses Node.js standard library only
-
-## Testing
-
-```bash
-# Run all tests with coverage
-npm test
-
-# Run specific test suite
-npm test -- --testNamePattern="parseConfidence"
-
-# Watch mode
-npm test -- --watch
-
-# Check type coverage
-npm run type-check
-```
-
-## Documentation
-
-See `SKILL.md` for complete documentation including:
-- Architecture and design patterns
-- Type definitions and interfaces
-- Function reference with examples
-- CLI tool documentation
-- Integration guide
-- Migration guide from bash scripts
-
-## Related Skills
-
-- [Agent Output Processing](../cfn-agent-output-processing/SKILL.md)
-- [Loop Orchestration](../cfn-loop-orchestration/SKILL.md)
-
-## What's New
-
-This module consolidates three separate bash skills:
-- `cfn-loop2-output-processing/parse-feedback.sh`
-- `cfn-loop3-output-processing/parse-confidence.sh`
-- `cfn-loop3-output-processing/calculate-confidence.sh`
-
-Into a single, type-safe TypeScript module with 90%+ test coverage.
-
-## License
-
-MIT