Skip to content

release: prepare v3.0.0 core stability and architecture refresh#16

Merged
bryan-shea merged 14 commits intomainfrom
feat/v3.0.0/core-stability-and-architecture-refresh
Mar 24, 2026
Merged

release: prepare v3.0.0 core stability and architecture refresh#16
bryan-shea merged 14 commits intomainfrom
feat/v3.0.0/core-stability-and-architecture-refresh

Conversation

@bryan-shea
Copy link
Copy Markdown
Owner

Summary

Prepares Annotative v3.0.0 for release by landing the core stability and architecture refresh work and aligning the repository docs and release metadata with the current product state.

Included in v3.0.0

  • hardens project-scoped storage and schema handling
  • adds anchored annotation reattachment for source edits and movement
  • cleans up export flows and multi-root workspace handling
  • expands regression coverage across storage, CRUD, exports, manager behavior, anchoring, and sidebar flows
  • keeps the project-based .annotative/ storage model introduced in v2
  • aligns README, migration guidance, contributing docs, testing docs, and release docs with the actual v3 behavior
  • updates release guidance to match the manual main-based Marketplace publish workflow

Upgrade Notes

  • upgrading from v2.x to v3.0.0 does not require a manual storage migration
  • upgrading from pre-v2 versions still requires manual recreation or migration of legacy global-state annotations
  • release metadata is prepared in git for v3.0.0

Validation

  • npm run compile
  • npm run lint
  • npm test
  • node scripts/check-extension-compliance.js --verbose

Known Non-Blocking Warning

  • compliance still reports existing console statements in media/sidebar-webview.js

bryan-shea and others added 14 commits March 24, 2026 13:48
Implements a unified filter state management system by introducing two-way communication of filter updates between the sidebar webview and the extension. Updates commands and UI to use the new filter state, enabling consistent filtering, grouping, and searching across the sidebar and command palette. Removes obsolete context menu configuration and refactors command registration for clarity.

Improves user experience by ensuring filter changes remain in sync regardless of where they are triggered.
…state-consolidation

refactor: consolidate sidebar webview state & branch-aware local hooks
- Removed redundant tag conversion functions and streamlined tag handling in annotations.
- Updated bulk command registration to use new tag structure.
- Enhanced filter commands to utilize resolved tag labels.
- Simplified sidebar initialization by removing migration choice.
- Improved annotation export functionality to include resolved tag labels.
- Refactored annotation storage to support schema versioning and improved error handling.
- Updated UI components to reflect changes in tag management and filtering.
- Removed priority grouping from UI and related logic.
- Enhanced type definitions for better clarity and maintainability.
…rity-hardening

refactor: harden annotation storage, canonicalize tag handling
…ion-coverage

test: repair VS Code test harness and add regression coverage
- Removed deprecated settings from package.json related to Copilot export.
- Introduced AnnotationExportService to handle export logic and settings.
- Updated annotation commands to utilize the new export service for Copilot integration.
- Enhanced export functionality to support different formats and settings.
- Improved workspace folder detection for annotation storage.
- Added utility functions for workspace context management.
- Updated tests to validate new export service behavior and settings.
…workspace-cleanup

refactor: centralize export settings, workspace-aware export flows
…ring-and-reattachment

feat: improve annotation anchoring and conservative reattachment
- Added a new quality check script to run compile, lint, tests, and compliance check.
- Renamed the publish script for clarity.
- Updated devDependencies:
  - @types/node to ^22.19.15
  - @typescript-eslint/eslint-plugin and parser to ^8.57.2
  - @vscode/vsce to ^3.7.1
  - eslint to ^9.39.4
  - webpack to ^5.105.4

fix: improve cleanup in changeset-enhanced script

- Moved file cleanup to a finally block to ensure temp file is deleted.
- Updated commit message prompt to clarify release process.
…ency-hygiene

chore: tighten release flow and align docs
## Summary

Prepares Annotative `v3.0.0` for release by landing the core stability and architecture refresh work and aligning the repository docs and release metadata with the current product state.

## Included in v3.0.0

- hardens project-scoped storage and schema handling
- adds anchored annotation reattachment for source edits and movement
- cleans up export flows and multi-root workspace handling
- expands regression coverage across storage, CRUD, exports, manager behavior, anchoring, and sidebar flows
- keeps the project-based `.annotative/` storage model introduced in `v2`
- aligns README, migration guidance, contributing docs, testing docs, and release docs with the actual `v3` behavior
- updates release guidance to match the manual `main`-based Marketplace publish workflow

## Upgrade Notes

- upgrading from `v2.x` to `v3.0.0` does not require a manual storage migration
- upgrading from pre-`v2` versions still requires manual recreation or migration of legacy global-state annotations
- release metadata is prepared in git for `v3.0.0`

## Validation

- `npm run compile`
- `npm run lint`
- `npm test`
- `node scripts/check-extension-compliance.js --verbose`

## Known Non-Blocking Warning

- compliance still reports existing console statements in `media/sidebar-webview.js`
@bryan-shea bryan-shea merged commit 05c4b14 into main Mar 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant