Skip to content

Release Notes - v0.9.0

Release Date: 2026-06-20

Highlights

  • GraphQL Sync with release_id - Features now sync with release_id via GraphQL API
  • Progress Bars - Visual progress reporting for sync and query operations
  • Release Field Support - Query features by release_id, release_date, and position

What's New

GraphQL Sync with release_id

Features are now synced using the GraphQL API which provides release_id information. This enables querying features by their release assignment:

-- Query features by release
SELECT reference_num, name, status FROM features
WHERE release_id = 'PROD-R-123'
ORDER BY position ASC

-- Query features by release date range
SELECT reference_num, name, release_date FROM features
WHERE release_date >= '2024-10-01' AND release_date <= '2024-12-31'
ORDER BY release_date ASC

The features table now includes:

  • release_id - Internal release ID for joins
  • release_date - Release date for date-based queries
  • position - Feature rank within release
  • workspace - Workspace/project reference
  • tag_list - Comma-separated tags

Progress Bars

Sync and query operations now display visual progress:

# Progress shown during sync
aha-studio sync --product PROD
[████████████████████░░░░░░░░░░] 70% Syncing features page 7/10...

# Progress shown during paginated queries
aha-studio query "FROM features"
[████████████░░░░░░░░░░░░░░░░░░] 40% Fetching features page 4/10...

Schema Enhancements

New fields available for feature queries:

Field Type Description
release_id string Internal release ID
release_date date Release date
position int Feature rank/position
workspace string Workspace/project
tag_list string Comma-separated tags

Planner Improvements

The query planner now recognizes release_id, release_date, and release.* fields as requiring full feature details, similar to custom.* fields. This ensures accurate query results when filtering or sorting by release information.

Bug Fixes

  • MCP DoRaw path: Fixed URL construction (no longer doubles /api/v1 prefix)
  • Graph sync: Updated to use new WithProductsPage/WithProductsPerPage options

Dependencies

  • Upgraded github.com/grokify/aha-go to v0.5.0 (product CRUD, ListFeatures GraphQL)
  • Added github.com/grokify/mogo as direct dependency (progress rendering)
  • Updated indirect dependencies

Database Migration

Existing SQLite databases are automatically migrated:

-- Applied automatically on first sync
ALTER TABLE features ADD COLUMN release_id TEXT;
CREATE INDEX idx_features_release_id ON features(release_id);

Installation

# Install AQL CLI
go install github.com/grokify/aha-studio/cmd/aha-studio@v0.9.0

# Install MCP Server
go install github.com/grokify/aha-studio/cmd/aha-mcp-server@v0.9.0

Full Changelog

See the CHANGELOG for complete version history.