Skip to content

Changelog

All notable changes to nspec are documented in CHANGELOG.md.

Recent Releases

3.6.0 - 2026-05-22

Bug Fixes

  • Fix dashboard CLI epic filter using membership DAO for correct scope
  • Fix supersede reversal and cross-directory spec lookup via find_spec_files
  • Fix review commit discovery using IMPL File: annotations instead of Refs: convention
  • Fix review atomic output persistence — raw output saved before verdict parsing
  • Fix bare newline sanitization in JSON verdicts from codex terminal wrapping
  • Fix review bypass for S350 terse detection on structured JSON verdicts
  • Bump urllib3 to >=2.7.0 for CVE-2026-44431/44432

3.5.3 - 2026-05-13

Enhancements

  • Mutation testing with mutmut (CI weekly, make test-mutation)
  • /nqa quality analysis skill with docs/qa/status.md tracking
  • Enable ruff rule sets: N (PEP 8 naming), RSE (unnecessary raise parens), G (logging format strings)

Bug Fixes

  • Fix CI: drop container job for mutation testing, generate poetry.lock in CI image build
  • Fix CI: exclude mcp_server.py from vulture, ignore pip-audit py vuln

3.5.2 - 2026-05-10

Bug Fixes

  • Fix TUI: align PICKUP sort with next_spec by adding Ready to STATUS_RANK
  • Fix write_review_verdict to allow valid verdict_token for external agents
  • Remove subagent/Agent tool usage from all skills

3.5.1 - 2026-05-10

Bug Fixes

  • Fix review: accept double-terse APPROVED on confirmation re-review

3.5.0 - 2026-05-10

Enhancements

  • Unified session audit trail and handoff (audit_record tool)
  • Review prompt uses stdin passthrough instead of inline diff
  • Gap-fill ID allocator scans from range start upward

Bug Fixes

  • Fix next_spec to use DatasetLoader for branch-only spec visibility
  • Fix /nloop to run specs inline instead of spawning subagents

3.4.3 - 2026-05-10

Bug Fixes

  • Fix spec_root='.' config resolution to project root
  • Remove dangling refs to superseded specs from E001 and S905

3.4.2 - 2026-05-10

Enhancements

  • User-defined spec types with custom templates
  • context-audit CLI command for CLAUDE.md budget analysis
  • preflight state-introspection tool for /ngo pipeline
  • epic_specs starting_spec_id parameter for backlog slicing
  • Generic markdown renderer for FR/IMPL sections in TUI detail view
  • Bidirectional GitHub tracker sync with auto back-comments
  • Auto-select epic with user validation in /nspec skill
  • E2E tests for epic management lifecycle

Bug Fixes

  • Fix datasets gracefully skipping invalid FR/IMPL files instead of aborting
  • Fix review detecting pre-implementation specs for spec-quality review
  • Fix config spec_root='.' resolving to config dir, not project root
  • Fix validator Layer 7 false-positives on FR-Completed + IMPL-in-progress
  • Fix orphaned specs missing epic_id in MainDatasetLoader parse

3.4.1 - 2026-05-09

Bug Fixes

  • Fix TUI epic membership using DAO instead of fr.deps

3.4.0 - 2026-05-04

Enhancements

  • /ngo always pushes after spec completion for async CI feedback
  • DatasetLoader TTL cache to avoid redundant re-parsing
  • Consolidate inline imports to top-level where safe
  • Migrate fr.type == Epic to is_epic field

Bug Fixes

  • Fix cache invalidation in set_loe and renumber_spec

3.3.0 - 2026-05-02

Enhancements

  • Policy-as-code hooks for credentials and destructive operations (guard-credentials.sh, guard-destructive.sh)
  • Auto-extend ID range ceiling on exhaustion

Bug Fixes

  • Fix atomic active-symlink swap to eliminate concurrent-write race
  • Fix cross-dir spec ID collisions no longer hard-blocking all MCP tools
  • Fix empty-diff rubber-stamp pipeline in review
  • Fix approve_review() decoupled from status transitions
  • Fix Implementer/Reviewer field reconciliation after verdict write
  • Fix git-diff check skip for cross-repo File: annotations
  • Fix large agent output persistence and structured collision errors
  • Fix codex review behavior: model list, diff scope, verdict-severity

3.2.0 - 2026-03-23

Bug Fixes

  • Fix get_epic crash when no active epic set (return type mismatch)
  • Fix create_spec leaving orphan FR/IMPL files on validation failure — now rolls back
  • Fix TUI race condition: task mutations now use atomic writes (spec_write)
  • Fix review_spec(uncommitted=true) returning empty diff — added git diff --cached
  • Fix review diff excluding root-level files (Makefile, pyproject.toml, .github/)

Enhancements

  • Configurable review diff paths via [review].diff_include / diff_exclude in config.toml
  • CI runners scaled to 4 parallel workers

3.1.0 - 2026-03-19

Bug Fixes

  • Fix task_complete greedy backtick regex for File: annotations with multiple backtick pairs
  • Fix self-review bypass when review agent is configured
  • Fix NEEDS_WORK verdict not reverting FR/IMPL status to Active
  • Fix LOE auto-generation writing invalid format in IMPL files
  • Fix TUI epic spec list not sorted by priority in detail view
  • Fix TUI hiding epics with zero specs from dashboard
  • Fix TUI follow mode false "no active spec" warning

Enhancements

  • Epic priority auto-assign and swap_priority tool
  • Auto-compute LOE after write_refinement when agent omits it
  • Detect HTML comment placeholders as skeleton content in refine_impl
  • TUI: hide superseded/rejected specs with 'c' toggle
  • /nreview-epic batch review skill with convergence protocol
  • CI watch hook for automatic post-push monitoring

3.0.0 - 2026-03-16

Major Changes

  • Package reorganization: domain/, runtime/, workflow/, validation/, analysis/ packages
  • Spec type registry with custom FR/IMPL types
  • GitHub issue import via issue_import tool and /ntriage skill
  • FR skeleton detection and auto-authoring via refine_fr / write_fr_refinement
  • IMPL skeleton detection and auto-refinement via refine_impl / write_refinement
  • Agent execution framework with execute_agent (Codex, Claude, Gemini backends)
  • Review token anti-rubber-stamping (single-use tokens from review_spec)
  • Spec test targeting via spec_tests and spec_test_files tools
  • Swarm orchestration: swarm_launch, swarm_status, swarm_teardown
  • Checkout/reservation system with TTL leases
  • Template profiles: quick, standard, full, formal
  • Skills management: skills_install, skills_sync, skills_update

2.3.0 - 2026-03-10

  • Safe template substitution with SafeFormatMap
  • Pluggable DAO layer with protocols, factory, registry, and markdown backends
  • TerminusDB E2E test coverage (acceptance criteria, edge cardinality, connection resilience, migration edge cases, MCP tools)
  • Docker-compose hardening for E2E tests
  • Review prompt improvements (filtered pathspecs, test result receipts)
  • BackendConfig for persistence engine selection

2.2.0 - 2026-02-15

  • Multi-agent queue system with atomic claim/release
  • Codex code review integration
  • Session management with per-session files
  • Fuzzy ID resolution across all MCP tools
  • ADR support (FR-900–999 range)

2.1.0 - 2026-01-20

  • Interactive TUI with Textual
  • Engineering metrics dashboard
  • 6-layer validation engine
  • Dependency graph with circular reference detection

2.0.0 - 2025-12-01

  • MCP server with stdio, SSE, and HTTP transports
  • FR/IMPL pairing with auto-assigned IDs
  • nspec init with stack auto-detection
  • Skills system for Claude Code integration