# Changelog

All notable changes to ArcheFlow are documented in this file.

## [0.6.0] -- 2026-04-04

### Added
- Expanded attention-filters skill with prompt templates, token budgets, cycle-back filtering, and verification checklist
- Explorer skip heuristic in plan-phase with decision table for when to skip/require research
- Runnable quickstart example (`examples/runnable-quickstart.md`)

### Fixed
- Normalized agent persona frontmatter: added examples, moved isolation note to Rules, documented model choices

## [0.5.0] -- 2026-04-04

### Added
- Lib script validation at run initialization — fail fast if required scripts or `jq` are missing
- Hook points documentation with 6 lifecycle events (run-start, phase-complete, agent-complete, pre-merge, post-merge, run-complete) and config template
- Phase rollback support in `archeflow-rollback.sh` via `--to <phase>` flag
- Per-workflow model assignment configuration with fallback chain (per-workflow per-archetype > per-workflow default > per-archetype > global default)
- Cross-run finding regression detection in `archeflow-memory.sh` — compares current findings against previously resolved fixes
- Check-phase parallel reviewer spawning protocol with Guardian-first sequence, A2 fast-path evaluation, timeout handling, and re-check protocol

## [0.4.0] -- 2026-04-04

### Added
- Confidence gate parsing with bash snippets for extracting scores from `plan-creator.md`
- Mini-Explorer spawning when risk coverage < 0.5
- Worktree merge flow with explicit pre-merge hooks and post-merge test validation
- `archeflow-rollback.sh` for post-merge test failure auto-revert
- Test-first validation gate in Do phase
- Memory injection audit trail with `--audit` flag and `audit-check` command

### Fixed
- Unified feedback routing tables across orchestration, act-phase, artifact-routing

## [0.3.0] -- 2026-04-03

### Added
- Automated PDCA execution loop (`archeflow:run`) with `--start-from` and `--dry-run` support
- Event-sourced process logging (`archeflow:process-log`) with DAG parent relationships
- ASCII DAG renderer (`archeflow-dag.sh`) with color output
- Markdown process report generator (`archeflow-report.sh`) with summary and DAG modes
- Live progress file (`archeflow:progress`) watchable from a second terminal
- Domain adapter system (`archeflow:domains`) for writing, research, and custom domains
- Cost tracking skill (`archeflow:cost-tracking`) with budget enforcement and model tier recommendations
- Cross-run memory system (`archeflow:memory`) that learns recurring findings and injects lessons
- Convergence detection (`archeflow:convergence`) to prevent wasted cycles from stalling or oscillation
- Colette bridge (`archeflow:colette-bridge`) for automatic writing platform integration
- Template gallery (`archeflow:templates`) with init, save, clone, and list operations
- Archetype effectiveness scoring (`archeflow:effectiveness`) across signal-to-noise, fix rate, cost efficiency
- Git-per-phase commit strategy (`archeflow:git-integration`) with branch-per-run and rollback
- Multi-project orchestration (`archeflow:multi-project`) with dependency DAG and shared budget
- Act phase skill (`archeflow:act-phase`) for post-Check decision logic and fix routing
- Artifact routing skill (`archeflow:artifact-routing`) for inter-phase artifact management
- `archeflow-event.sh` -- structured JSONL event appender
- `archeflow-git.sh` -- per-phase commits, branch creation, merge, and rollback
- `archeflow-init.sh` -- template gallery script (init, save, clone, list)
- `archeflow-memory.sh` -- cross-run memory management (add, list, decay, forget)
- `archeflow-progress.sh` -- live progress file generator
- `archeflow-score.sh` -- archetype effectiveness scoring from completed runs
- Short fiction workflow example (`kurzgeschichte.yaml`) with custom archetypes and Colette integration
- Story-explorer and story-sage custom archetype examples

## [0.2.0] -- 2026-04-03

### Added
- Plugin consolidation into single shareable `archeflow/` directory
- Workflow intelligence with conditional escalation, fast-path, and confidence triggers
- Quality loop with self-review, convergence detection, dedup, and completion promises
- Parallel teams with auto-resume and budget scheduling
- Extensibility: archetype composition, team presets, hook points, workflow templates
- Mini-reflect fallback for non-ArcheFlow single-file changes (Ralph Loop integration)
- Comprehensive README with install, usage, debugging, and examples
- DX improvements: structured confidence, alternatives surfacing

### Fixed
- Redesigned adaptation rules per Guardian review to resolve race conditions
- Synced Creator agent definition with orchestration skill expectations
- Wired hooks correctly and added cost table documentation

## [0.1.0] -- 2026-04-02

### Added
- Initial release: 7 Jungian archetypes (Explorer, Creator, Maker, Guardian, Skeptic, Trickster, Sage)
- PDCA orchestration engine with fast, standard, and thorough workflows
- Shadow detection with quantitative heuristics per archetype
- Cross-cycle structured feedback with routing and resolution tracking
- Attention filters for per-archetype context optimization
- Autonomous mode for unattended overnight sessions
- Custom archetypes and workflow design skills
- SessionStart hook for automatic activation
- `archeflow-dag.sh` and `archeflow-report.sh` process visualization scripts

### Changed
- Removed ArcheHelix branding, adopted plain PDCA language
- Trimmed phase skills to reduce token waste
- Simplified to one shadow per archetype for clearer detection

### Fixed
- Rewrote SessionStart hook in pure Node for portability (no bash/awk/sed dependencies)
- Made hook robust with graceful fallbacks (no `set -e`)
- Corrected repository URLs