Priivacy-ai/spec-kitty v0.12.0 on GitHub

Config-Driven Agent Management (Feature 022):

Single source of truth: .kittify/config.yaml now controls which agents are configured
New CLI commands: spec-kitty agent config list|add|remove|status|sync
- list: Show configured agents
- add <agents...>: Add agents to configuration
- remove <agents...>: Remove agents from configuration
- status: Show configured vs orphaned agents
- sync: Synchronize filesystem with configuration
Migrations respect config: get_agent_dirs_for_project() helper only processes configured agents
Orphan detection: Identifies agent directories not in config (from manual deletions)
ADR #6: Documents architectural decision for config-driven approach

Smarter Feature Merge with Pre-flight (Feature 017):

Pre-flight validation: Checks all WP worktrees for uncommitted changes, missing worktrees, and target branch divergence before any merge starts
Conflict forecasting: --dry-run predicts which files will conflict and classifies them as auto-resolvable (status files) or manual
Smart merge order: WPs merged in dependency order based on frontmatter dependencies field
Status file auto-resolution: Conflicts in WP prompt files (kitty-specs/*/tasks/*.md) automatically resolved by taking advanced lane status
Merge state persistence: Progress saved to .kittify/merge-state.json for recovery
Resume/abort flags: --resume continues interrupted merges, --abort clears state and starts fresh
Auto-cleanup: Worktrees and branches removed after successful merge (configurable with --keep-worktree, --keep-branch)

Merge Preflight Documentation (Feature 018):

Added docs/how-to/merge-feature.md - Complete merge workflow guide with pre-flight, dry-run, strategies, and cleanup options
Added docs/how-to/troubleshoot-merge.md - Comprehensive troubleshooting guide with error reference table
Updated CLAUDE.md with Merge & Preflight Patterns section documenting MergeState dataclass and public API

Agent Management Documentation Sprint (Feature 023):

Added docs/how-to/manage-agents.md - Complete guide to adding, removing, and managing AI agent integrations
Added docs/how-to/upgrade-to-0-12-0.md - Migration guide for config-driven agent management
Updated docs/reference/cli-commands.md with comprehensive agent config subcommand documentation
Updated docs/reference/agent-subcommands.md, docs/reference/configuration.md, docs/reference/supported-agents.md with accurate cross-references
Cleaned up outdated Jujutsu (jj) references throughout documentation (git-only VCS for now)
Updated docs/how-to/install-spec-kitty.md with agent configuration guidance

Merge Resume Bug:

Fixed merge_workspace_per_wp() missing resume_state parameter causing TypeError when using --resume

Agent Workflow Output Truncation (GitHub Codex compatibility):

Fixed workflow commands (implement, review) outputting 300+ lines which got truncated by agents like GitHub Codex
Prompts now written to temp file with concise 15-line summary to stdout
Added directive language (▶▶▶ NEXT STEP: Read the full prompt file now:) so agents automatically read the file
Agents no longer miss work package requirements due to output truncation

False Staleness for Newly-Created Worktrees:

Fixed stale detection flagging new worktrees as stale immediately
Previously, git log -1 returned parent branch's commit time (could be hours old)
Now checks if branch has commits since diverging from main
Worktrees with no new commits are NOT flagged as stale (agent just started)