beads/internal/storage/sqlite/migrations
Peter Chanthamynavong d371baf2ca
feat(dates): add --due and --defer timestamp options with natural language parsing (#847)
* feat(dates): add due date schema and --due flag

- Add due_at and defer_until columns to issues table via migration 035
- Implement --due flag on create command with ISO date parsing
- Extend RPC protocol and daemon to pass DueAt from CLI to storage
- Display DueAt and DeferUntil in show command output
- Update Issue type with new date fields

Users can now set due dates when creating issues, enabling deadline-based
task management.

* feat(dates): add compact duration parser (+6h, +1d, +2w)

- Create internal/timeparsing package with layered parser architecture
- Implement parseCompactDuration with regex pattern [+-]?\d+[hdwmy]
- Add comprehensive test suite (22 cases) for duration parsing
- Integrate into create.go with fallback to ISO format

Supports hours (h), days (d), weeks (w), months (m), and years (y).
Negative values allowed for past dates.

* feat(dates): add NLP parsing for natural language dates

Integrate olebedev/when library for natural language time expressions.
The layered parser now handles: compact duration → absolute formats → NLP.

Changes:
- Add olebedev/when dependency for NLP parsing
- Implement ParseNaturalLanguage and ParseRelativeTime functions
- Reorder layers: absolute formats before NLP to avoid misinterpretation
- Simplify create.go to use unified ParseRelativeTime
- Add comprehensive NLP test coverage (22 test cases)

Supports: tomorrow, next monday, in 3 days, 3 days ago

* feat(dates): add --defer flag to create/update/defer commands

Add time-based deferral support alongside existing status-based defer.
Issues can now be hidden from bd ready until a specific time.

Changes:
- Add --defer flag to bd create (sets defer_until on creation)
- Add --due and --defer flags to bd update (modify existing issues)
- Add --until flag to bd defer (combines status=deferred with defer_until)
- Add DueAt/DeferUntil fields to UpdateArgs in protocol.go

Supports: +1h, tomorrow, next monday, 2025-01-15

* feat(dates): add defer_until filtering to ready command

Add time-based deferral support to bd ready:

- Add --include-deferred flag to show issues with future defer_until
- Filter out issues where defer_until > now by default
- Update undefer to clear defer_until alongside status change
- Add IncludeDeferred to WorkFilter and RPC ReadyArgs

Part of GH#820: Relative Date Parsing (Phase 5)

* feat(dates): add polish and tests for relative date parsing

Add user-facing warnings when defer date is in the past to help catch
common mistakes. Expand help text with format examples and document
the olebedev/when September parsing quirk.

Tests:
- TestCreateSuite/WithDueAt, WithDeferUntil, WithBothDueAndDefer
- TestReadyWorkDeferUntil (ExcludesFutureDeferredByDefault, IncludeDeferredShowsAll)

Docs:
- CLAUDE.md quick reference updated with new flags
- Help text examples for --due, --defer on create/update

Closes: Phase 6 of beads-820-relative-dates spec

* feat(list): add time-based query filters for defer/due dates

Add --deferred, --defer-before, --defer-after, --due-before, --due-after,
and --overdue flags to bd list command. All date filters now support
relative time expressions (+6h, tomorrow, next monday) via the
timeparsing package.

Filters:
- --deferred: issues with defer_until set
- --defer-before/after: filter by defer_until date range
- --due-before/after: filter by due_at date range
- --overdue: due_at in past AND status != closed

Existing date filters (--created-after, etc.) now also support relative
time expressions through updated parseTimeFlag().

* build(nix): update vendorHash for olebedev/when dependency

The olebedev/when library was added for natural language date parsing
(GH#820). This changes go.sum, requiring an updated vendorHash in the
Nix flake configuration.
2026-01-01 20:06:13 -08:00
..
001_dirty_issues_table.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
002_external_ref_column.go Fix CI regressions and stabilize tests 2025-11-17 10:06:35 -07:00
003_composite_indexes.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
004_closed_at_constraint.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
005_compaction_columns.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
006_snapshots_table.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
007_compaction_config.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
008_compacted_at_commit_column.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
009_export_hashes_table.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
010_content_hash_column.go fix: prevent parallel execution migration race conditions (GH#720) 2025-12-23 00:55:05 -08:00
011_external_ref_unique.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
012_source_repo_column.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
013_repo_mtimes_table.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
014_child_counters_table.go Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
015_blocked_issues_cache.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
016_orphan_detection.go fix: Exclude closed issues from orphan detection warnings 2025-12-17 23:32:37 -08:00
017_close_reason_column.go fix(db): add close_reason column to issues table (bd-uyu) 2025-12-01 21:56:41 -08:00
018_tombstone_columns.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
019_messaging_fields.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
020_edge_consolidation.go Phase 1: Edge schema consolidation infrastructure (Decision 004) 2025-12-18 01:17:57 -08:00
021_migrate_edge_fields.go refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
022_drop_edge_columns.go feat: add FreeBSD release builds (#832) 2026-01-01 10:51:51 -08:00
022_drop_edge_columns_test.go fix: migration 022 fails with SQL syntax error on v0.30.3 upgrade 2025-12-30 16:45:01 -08:00
023_pinned_column.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
024_is_template_column.go refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
025_remove_depends_on_fk.go fix: prevent parallel execution migration race conditions (GH#720) 2025-12-23 00:55:05 -08:00
026_additional_indexes.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
027_gate_columns.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
028_tombstone_closed_at.go fix: resolve golangci-lint errors (errcheck, gosec, unparam) 2025-12-28 20:50:54 -08:00
029_created_by_column.go refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
030_agent_fields.go chore: remove issue ID references from comments and changelogs 2025-12-28 10:05:16 -08:00
031_mol_type_column.go feat: Add mol_type schema field for molecule type classification (bd-oxgi) 2025-12-28 19:52:51 -08:00
032_hooked_status_migration.go feat: Add 'hooked' status for GUPP work assignment (bd-s00m) 2025-12-28 22:37:04 -08:00
033_event_fields.go feat: add type: event for operational state changes (bd-ecmd) 2025-12-30 15:54:51 -08:00
034_closed_by_session_column.go feat: add session_id field to issue close/update mutations (bd-tksk) 2025-12-31 13:14:15 -08:00
035_due_defer_columns.go feat(dates): add --due and --defer timestamp options with natural language parsing (#847) 2026-01-01 20:06:13 -08:00