decision-history

# Decision History Dashboard

Visualize how OrchestKit evolved with Claude Code versions, understand WHY decisions were made, and track best practices adoption.

## Overview

- View architecture decisions chronologically
- Track Claude Code version evolution (2.1.0 → 2.1.16+)
- Understand rationale behind each decision
- Generate Mermaid timeline diagrams for docs
- Query decisions by category, CC version, or date range

## Quick Start

```bash
# List recent decisions
node hooks/bin/decision-history.mjs list

# Show decisions for specific CC version
node hooks/bin/decision-history.mjs list --cc-version 2.1.16

# Generate Mermaid timeline
node hooks/bin/decision-history.mjs mermaid --output timeline.md

# Filter by category
node hooks/bin/decision-history.mjs list --category security

# Show last 30 days
node hooks/bin/decision-history.mjs list --days 30

# View statistics
node hooks/bin/decision-history.mjs stats

# Search decisions
node hooks/bin/decision-history.mjs search "typescript hooks"
```

## Data Sources

Decisions are aggregated from multiple sources (priority order):

| Source | Location | Description |
|--------|----------|-------------|
| Session | `.claude/context/knowledge/decisions/active.json` | Recent in-session decisions |
| CHANGELOG | `CHANGELOG.md` | Parsed version history |
| Coordination | `.claude/coordination/decision-log.json` | Multi-instance decisions |

## CLI Commands

```bash
# List decisions with filters
decision-history list [--cc-version VER] [--category CAT] [--days N] [--limit N]

# Show decision details
decision-history show <decision-id>

# Display timeline view
decision-history timeline [--group-by cc_version|category|month]

# Show statistics
decision-history stats

# Generate Mermaid diagram
decision-history mermaid [--output FILE] [--full] [--group-by FIELD]

# Sync from all sources (refresh cache)
decision-history sync

# Search decisions
decision-history search <query>
```

## Output Formats

### ASCII Table (Default)

`