Changelog

Consolidate duplicate FIXABLE_DRIFT_TYPES into single isFixableDrift() source

Add step-based progress feedback for CLI commands

• Added StepProgress utility for multi-step progress tracking with timing
• Added ProgressBar utility for incremental progress with percentage/ETA display
• Updated spec command to show 5-step progress (resolve, config, generate, validate, write)
• Updated check command to show 5-6 step progress (includes optional example validation step)
• Removed ora dependency in favor of simpler carriage-return based progress that doesn't freeze during I/O blocking operations

refactor: replace scan architecture with plan/execute model

@doccov/sdk

• Add fetchGitHubContext() for fetching repository metadata via GitHub API
• Add BuildPlan types for describing build/analysis execution plans
• Export new scan types: BuildPlan, BuildPlanStep, BuildPlanExecutionResult, GitHubProjectContext
• Remove legacy scan orchestrator in favor of external execution

@doccov/cli

• Remove scan command (moved to API service)
• Update spec command with improved analysis

@openpkg-ts/spec

• Add BuildPlan and related types to schema
• Extend spec schema for plan-based analysis

diff command improvements

New features:

• Hash-based report caching - repeated diffs with same specs are instant
• --no-cache flag to bypass cache and force regeneration
• --strict presets (ci, release, quality) for streamlined CI configuration
• Support for both positional and explicit --base/--head arguments
• --min-coverage and --max-drift threshold flags (same as check command)
• Config file support for thresholds via doccov.config.ts
• Simplified terminal output with detailed reports written to .doccov/

SDK additions:

• calculateAggregateCoverage(spec) - lightweight coverage calculation from exports
• ensureSpecCoverage(spec) - ensures spec has top-level coverage score
• getDiffReportPath() - hash-based diff report path generation

Fixes:

• Coverage now correctly calculated for raw specs (was showing 0% → 0%)
• Shared validation utilities extracted to avoid duplication between check and diff

Version sync release