patterns

name	patterns
description	Learned Patterns Management methodology and workflow
agent	architect
subtask	false

Learned Patterns Management

Purpose

View, manage, and review learned workflow patterns captured by the Workflow Intelligence System (WIS). Patterns are learned from successful workflow executions and boost suggestion confidence.

Step 1: Check Help Flag

if (args.help) {
  displayHelp();
  return;
}

Step 2: Load Learning Module

const learning = require('learning');
const store = learning.getDefaultStore();

Step 3: Execute Subcommand

List Patterns

if (args.subcommand === 'list' || !args.subcommand) {
  const data = store.load();
  let patterns = data.patterns;

  // Filter by status if provided
  if (args.status) {
    patterns = patterns.filter(p => p.status === args.status);
  }

  // Sort by occurrences (descending)
  patterns.sort((a, b) => (b.occurrences || 1) - (a.occurrences || 1));

  // Limit results
  patterns = patterns.slice(0, args.limit || 10);

  displayPatternList(patterns);
}

Show Stats

if (args.subcommand === 'stats') {
  const stats = store.getStats();
  displayStats(stats);
}

Prune Patterns

if (args.subcommand === 'prune') {
  const result = store.prune();
  console.log(`✓ Pruned ${result.pruned} patterns. ${result.remaining} remaining.`);
}

Review Patterns

if (args.subcommand === 'review') {
  const pendingPatterns = store.getByStatus('pending');

  if (pendingPatterns.length === 0) {
    console.log('No patterns pending review.');
    return;
  }

  // Interactive review (uses elicitation)
  for (const pattern of pendingPatterns) {
    const action = await promptReviewAction(pattern);
    if (action === 'quit') break;

    store.updateStatus(pattern.id, action === 'promote' ? 'active' : action);
    console.log(`✓ Pattern ${action}d.`);
  }
}

---

Help Text

Usage: patterns [subcommand] [options]

Manage learned workflow patterns.

Subcommands:
  list     List all learned patterns (default)
  stats    Show pattern statistics
  prune    Remove stale/low-value patterns
  review   Interactive review of pending patterns

Options:
  --status <status>  Filter by status (pending, active, promoted, deprecated)
  --limit <n>        Limit results (default: 10)
  --help             Show this help message

Examples:
  patterns                          # List top 10 patterns
  patterns list --status active     # List active patterns only
  patterns stats                    # Show statistics
  patterns prune                    # Remove stale patterns
  patterns review                   # Review pending patterns

Pattern Lifecycle:
  1. pending  - Newly captured, awaiting review
  2. active   - Validated, used in suggestions
  3. promoted - High-value, prioritized in suggestions
  4. deprecated - Marked for removal

---

List Output

Learned Patterns (15 total)
═══════════════════════════

Top Patterns by Occurrence:
1. validate-story-draft → develop → review-qa
   Occurrences: 12 | Success: 95% | Status: promoted
   Workflow: story_development | Last seen: 2h ago

2. develop → review-qa → apply-qa-fixes
   Occurrences: 8 | Success: 88% | Status: active
   Workflow: story_development | Last seen: 1d ago

3. create-story → validate-story-draft → develop
   Occurrences: 6 | Success: 100% | Status: active
   Workflow: story_creation | Last seen: 3d ago

Showing 3 of 15 patterns. Use --limit to see more.

Stats Output

Pattern Learning Statistics
═══════════════════════════

Storage:
  Total patterns: 15
  Max patterns: 100
  Utilization: 15%

By Status:
  Pending: 3
  Active: 9
  Promoted: 2
  Deprecated: 1

Quality:
  Avg success rate: 92%
  Total occurrences: 45

Storage file: learned-patterns.yaml
Last updated: 2025-12-26T10:30:00Z

Review Output

patterns review

Patterns Pending Review (3)
═══════════════════════════

Pattern #1: develop → run-tests → review-qa
Occurrences: 4 | Success Rate: 100% | First Seen: 2 days ago
[P]romote  [S]kip  [D]eprecate  [Q]uit

> p

✓ Pattern promoted to active status

Pattern #2: create-story → develop
Occurrences: 2 | Success Rate: 50% | First Seen: 5 days ago
[P]romote  [S]kip  [D]eprecate  [Q]uit

> d

✓ Pattern deprecated

Review complete. 1 promoted, 0 skipped, 1 deprecated.

---

Error Handling

Error	Cause	Resolution
Learning module not found	Missing dependency	Show error message
Storage file corrupt	Invalid YAML	Reset to empty, show warning
No patterns found	Empty storage	Show "no patterns" message
Review cancelled	User quit	Save any changes made

Error Recovery Strategy:*

try {
  const stats = store.getStats();
  displayStats(stats);
} catch (error) {
  console.error(`⚠️ Error reading patterns: ${error.message}`);
  console.log('Try running: rm learned-patterns.yaml');
}

---