chore(release): 1.2.0 [skip ci]

## [1.2.0](v1.1.1...v1.2.0) (2026-02-02)

### 🎯 Highlights
#### ✨ Features

* **analysis:** add usage_events recording on analysis completion ([0593683](0593683))
* **analysis:** store parser_version in analysis records ([aa47dab](aa47dab))
* **autorefresh:** add parser_version comparison to auto-refresh conditions ([4cc6cc4](4cc6cc4))
* **batch:** implement automatic chunking for large test sets ([cf7c691](cf7c691))
* **bootstrap:** add multi-queue subscription support ([dc4c254](dc4c254))
* **bootstrap:** register parser version to system_config on Worker startup ([290a5ef](290a5ef))
* **config:** add feature flag infrastructure for Phase 1 V2 architecture ([9c1c4c9](9c1c4c9))
* **db:** add SQLc queries and domain model for test_files table ([ca530c4](ca530c4))
* **deploy:** add retention-cleanup service Railway configuration ([876c3f3](876c3f3))
* **deploy:** migrate to Railway IaC with GitHub Actions deployment ([b842318](b842318))
* **gemini:** add auto-recovery for missing test indices from AI output ([c3173e8](c3173e8))
* **gemini:** add domain description field to v3BatchResult ([62d5b8d](62d5b8d))
* **gemini:** add Phase 1 V3 sequential batch architecture feature flag ([71fc07e](71fc07e))
* **gemini:** add Stage 1 Taxonomy cache ([7ccea47](7ccea47))
* **gemini:** add V3 prompt templates for order-based batch classification ([b186601](b186601))
* **gemini:** implement Batch API polling and result parsing ([66d7ddf](66d7ddf))
* **gemini:** implement Batch API Provider base structure ([7214cbd](7214cbd))
* **gemini:** implement Phase 1 V2 Orchestrator ([f2f453b](f2f453b))
* **gemini:** implement Phase1 quality metrics collector ([5aef0df](5aef0df))
* **gemini:** implement Phase1PostProcessor for classification validation and normalization ([c7fee4e](c7fee4e))
* **gemini:** implement Stage 1 Taxonomy extraction logic ([be9bf50](be9bf50))
* **gemini:** implement Stage 2 Test Assignment logic ([531962b](531962b))
* **gemini:** implement V3 batch processing core logic with response validation ([c528346](c528346))
* **gemini:** implement V3 batch retry logic with split and individual fallback ([0945156](0945156))
* **gemini:** implement V3 orchestrator for sequential batch processing ([1df43b2](1df43b2))
* **gemini:** integrate Phase 1 V2 feature flag router ([cf72f02](cf72f02))
* **gemini:** integrate quality components into V3 orchestrator ([513232b](513232b))
* **mapping:** add Core DomainHints to Domain model conversion ([570e07a](570e07a))
* **mock:** add response delay simulation to mock AI provider ([78aa6c4](78aa6c4))
* **prompt:** implement Stage 1 Taxonomy extraction prompt ([eb316c3](eb316c3))
* **prompt:** implement Stage 2 Assignment prompt ([c9775d1](c9775d1))
* **queue:** add fairness middleware for per-user job limiting ([620849f](620849f))
* **queue:** add multi-queue configuration support for River server ([71274b4](71274b4))
* **queue:** add per-user concurrent job limiting ([421904c](421904c))
* **queue:** add priority queue name constants and environment config ([9a6df10](9a6df10))
* **queue:** implement userID and tier extraction from River jobs ([b14baf5](b14baf5))
* **queue:** integrate Batch mode into SpecView Worker ([5cb5155](5cb5155))
* **queue:** integrate fairness middleware into River server ([2206b19](2206b19))
* **quota:** release quota reservation on job completion/failure in Worker ([8c69599](8c69599))
* **repository:** add system_config repository and parser version extraction ([72bd468](72bd468))
* **retention:** add bootstrap and entry point for retention cleanup ([6e03a7f](6e03a7f))
* **retention:** add domain and usecase layer for retention cleanup ([5e8c05a](5e8c05a))
* **retention:** add repository layer for retention-based cleanup ([792f106](792f106))
* **retention:** store retention_days_at_creation snapshot on record creation ([878d87c](878d87c))
* **scheduler:** add dedicated queue support for auto-refresh jobs ([ba91bd9](ba91bd9))
* **specgen:** add MOCK_MODE env var for spec document generation without AI calls ([364dfda](364dfda))
* **specview:** add analysis_id and ETA to Phase 2 logs ([f568df6](f568df6))
* **specview:** add Batch API routing logic to UseCase ([36560f3](36560f3))
* **specview:** add behavior cache stats to SpecViewResult ([a70fa07](a70fa07))
* **specview:** add behavior cache types and interfaces ([a871845](a871845))
* **specview:** add domain layer foundation for SPEC-VIEW Level 2 ([3644739](3644739))
* **specview:** add domain types for Phase 1 V2 two-stage architecture ([cc75bb5](cc75bb5))
* **specview:** add force regenerate option ([09821f9](09821f9))
* **specview:** add Phase 1 chunking for large test repositories ([8831021](8831021))
* **specview:** add Phase 1 classification cache foundation types ([42a2a47](42a2a47))
* **specview:** add Phase 2 progress logging for job monitoring ([bfbb938](bfbb938))
* **specview:** add Phase 3 executive summary generation ([8ed1d84](8ed1d84))
* **specview:** add phase timing logs for performance monitoring ([a04dc43](a04dc43))
* **specview:** add placement AI adapter for incremental cache ([1cbefd6](1cbefd6))
* **specview:** add real-time Gemini API token usage tracking ([109d572](109d572))
* **specview:** add repository context (owner/repo) to logs ([ef57a38](ef57a38))
* **specview:** add retry info and phase context to failure logs ([87a1993](87a1993))
* **specview:** add test diff calculation for incremental cache ([b61b78b](b61b78b))
* **specview:** add uncategorized handling for incremental cache ([b6b3ea5](b6b3ea5))
* **specview:** add user_specview_history recording ([abc148b](abc148b))
* **specview:** add version management support for spec_documents ([a547803](a547803))
* **specview:** implement behavior cache repository ([bea9a93](bea9a93))
* **specview:** implement classification cache repository ([ae3a8ba](ae3a8ba))
* **specview:** implement Gemini-based AI Provider adapter ([fe5ea7d](fe5ea7d))
* **specview:** implement GenerateSpecViewUseCase for pipeline orchestration ([080978c](080978c))
* **specview:** implement PostgreSQL repository for 4-table hierarchy ([e897bbf](e897bbf))
* **specview:** implement SpecViewWorker and integrate with AnalyzerContainer ([f87e638](f87e638))
* **specview:** implement usage_events-based quota tracking ([94105c6](94105c6))
* **specview:** integrate Phase 1 cache for incremental classification ([26a373b](26a373b))
* **specview:** integrate Phase 2 behavior cache ([1799394](1799394))
* **specview:** store user_id on spec_documents INSERT ([2ddac0d](2ddac0d))

#### 🐛 Bug Fixes

* **batch:** add debugging info for Batch API response parsing failures ([e9a6342](e9a6342))
* **batch:** fix batch job repeatedly submitting instead of polling ([411e9bf](411e9bf))
* **batch:** fix JSON corruption when parsing Batch API response ([93bbefb](93bbefb))
* **batch:** fix JSON parsing failure due to trailing commas in Gemini response ([cb6db9b](cb6db9b))
* **batch:** fix parsing for Batch API split responses ([46e2302](46e2302))
* **gemini:** handle out-of-range test indices from AI without failing ([7d9382a](7d9382a))
* **gemini:** prevent AI hallucination causing invalid domain/feature pairs in Stage 2 assignment ([365f595](365f595))
* **gemini:** prevent context cancellation from truncating API responses in wave processing ([4dc421e](4dc421e))
* **gemini:** resolve taxonomy response truncation for large file sets ([0e71100](0e71100))
* **prompt:** resolve Phase 2 output language mismatch with requested language ([ccea96e](ccea96e))
* **queue:** isolate dedicated queues per worker to resolve Unhandled job kind error ([3cfee6f](3cfee6f))
* **queue:** replace colons with underscores in queue names ([0a43619](0a43619))
* **specview:** charge quota only for AI-generated behaviors ([1cddcaa](1cddcaa))
* **specview:** chunk cache not restoring on Phase 1 retry ([f4ef62d](f4ef62d))
* **specview:** extend Phase 1 timeout for V3 sequential batch processing ([58bba48](58bba48))
* **specview:** fix Batch API config not propagating to worker ([1c465c2](1c465c2))
* **specview:** isolate Phase 2 semaphore per job to prevent cross-job interference ([7668a98](7668a98))
* **specview:** prevent behavior cache loss on Phase 2 failure ([0ec770b](0ec770b))
* **specview:** propagate Gemini env vars to AnalyzerContainer ([7485f08](7485f08))
* **specview:** raise Phase/Job timeouts to allow large repo completion ([85089ad](85089ad))
* **specview:** resolve Phase 1 response JSON truncation ([ac7d381](ac7d381))
* **specview:** resolve Phase 2 output validation failures ([6c3ad64](6c3ad64))

#### ⚡ Performance

* **gemini:** implement wave parallel processing to improve Phase 1 throughput ([cc33442](cc33442))
* **gemini:** reduce chunk size and enhance retry settings to minimize timeout risk ([e78ef82](e78ef82))
* **gemini:** remove redundant inter-chunk delay to improve processing speed ([33a0d4d](33a0d4d))
* **specview:** disable Gemini thinking mode to reduce Phase 1 timeout ([b47a4e9](b47a4e9))
* **specview:** optimize prompts and timeouts to reduce Gemini 504 errors ([8857b90](8857b90))
* **specview:** reduce Phase 1 chunk size and add progress caching for large repositories ([7a08e01](7a08e01))
* **specview:** reduce Phase 1 chunk size to 500 and add JSON parse error retry ([c4edea8](c4edea8))

### 🔧 Maintenance
#### 📚 Documentation

* add build artifacts cleanup rule ([05e7b70](05e7b70))
* add specvital-specialist agent ([9dded5d](9dded5d))
* document Batch API environment variables and operation guide ([257e59b](257e59b))
* update spec-view docs ([e463e10](e463e10))

#### ♻️ Refactoring

* **app:** separate DI containers for analyzer and scheduler ([e3b1eae](e3b1eae))
* **gemini:** allow many-to-many file-feature relationship in Stage 1 taxonomy ([70bfa8f](70bfa8f))
* **prompt:** redesign V3 classification prompt with principle-based approach ([ade4afc](ade4afc))
* **queue:** remove legacy queue support code ([e352f96](e352f96))
* remove Scheduler service ([c163239](c163239))
* **repository:** implement normalized storage using test_files table ([47cad88](47cad88))
* separate queue adapter into analyze subpackage ([cf868bf](cf868bf))
* separate worker binary into analyzer/spec-generator ([bd7f17f](bd7f17f))
* **specview:** improve Phase 2 prompt with Specification Notation style ([dbfc46d](dbfc46d))
* **specview:** improve Phase 3 prompt for user-friendly tone ([15f7e62](15f7e62))
* **specview:** remove language constants and improve default handling ([31c1d40](31c1d40))
* update module path and references for repository rename ([0629c97](0629c97))
* **worker:** separate AnalyzeWorker and SpecViewWorker into independent binaries ([f3fae45](f3fae45))

#### ✅ Tests

* **gemini:** add integration tests for V3 sequential batch architecture ([30a23bc](30a23bc))
* **gemini:** implement V3 quality assurance integration tests ([79cd139](79cd139))
* **gemini:** update V3 tests to expect path-based fallback instead of Uncategorized ([1964917](1964917))
* **queue:** add integration tests for fairness middleware ([da41eea](da41eea))
* **repository:** add integration tests for DomainHints and file_id FK relationship ([ddee5f6](ddee5f6))
* **specview:** add E2E integration tests for SPEC-VIEW pipeline ([b803ca7](b803ca7))

#### 🔨 Chore

* add air hot reload support for spec-generator ([c6697b2](c6697b2))
* add clean-containers command ([6a0d006](6a0d006))
* change license from MIT to Apache 2.0 ([393356c](393356c))
* dumb schema ([9345080](9345080))
* dump schema ([641394d](641394d))
* dump schema ([ac3dd77](ac3dd77))
* dump schema ([5103aeb](5103aeb))
* dump schema ([33d8a46](33d8a46))
* dump schema ([a61b1bb](a61b1bb))
* dump schema ([4450751](4450751))
* dump schema ([cd3df33](cd3df33))
* dump schema ([ea92b45](ea92b45))
* dump schema ([a5e6d73](a5e6d73))
* sync ai-config-toolkit ([ec52a6f](ec52a6f))
* sync docs ([8f9553b](8f9553b))
* sync docs ([852cbfe](852cbfe))
* sync-docs ([e4e8810](e4e8810))
* update core ([8020c3b](8020c3b))
* update core ([dfd8e26](dfd8e26))
* update core ([a094e8d](a094e8d))
* update core ([54ae38a](54ae38a))
* update core ([ea3b03e](ea3b03e))
* update dev tool configs for worker→analyzer refactoring ([f1c4637](f1c4637))

Author: github-actions[bot]