* fix: enable auto-export by default with canonical issues.jsonl name (GH#2973) Users expected JSONL export to refresh automatically but export.auto defaulted to false, requiring explicit opt-in. Also the default filename (export.jsonl) didn't match the canonical issues.jsonl used in docs and git hooks. Change defaults: export.auto=true, export.path=issues.jsonl, export.git-add=true so viewers (bv) and git workflows see fresh data without extra configuration. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(init): add auto-export prompt and document export.* config (GH#2973) Interactive bd init now asks whether to enable auto-export (default: yes). Users can opt out during setup instead of discovering the setting later. Also documents the export.* config namespace in bd config --help with all four keys (export.auto, export.path, export.interval, export.git-add) and adds export examples. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(issues): add started_at timestamp (GH#2796) Adds a `started_at` field to issues that is auto-populated when an issue transitions to in_progress status. Preserved across subsequent status changes. - Migration 0027 adds started_at column to issues and wisps tables - ManageStartedAt() in issueops mirrors ManageClosedAt() pattern - Query filter support: `started>2026-01-01`, `started<...` - Displayed in `bd show` between Created and Updated - Exposed in --json output via struct tag Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: gofmt alignment in update.go and types.go Amp-Thread-ID: https://ampcode.com/threads/T-019d887d-4eb1-7648-96be-8d906797c382 Co-authored-by: Amp <amp@ampcode.com> * fix(claim): set started_at when claiming via --claim (GH#2796) ClaimIssueInTx had its own bespoke UPDATE that only wrote assignee, status, and updated_at. Since `bd update --claim` is the canonical way agents transition issues to in_progress, started_at was left NULL in the common case. Set it on first transition, mirroring ManageStartedAt's guard (preserve existing value on re-claim). Also document the `started` field in `bd query --help`. --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Amp <amp@ampcode.com>
206 lines
6.1 KiB
Go
206 lines
6.1 KiB
Go
package issueops
|
|
|
|
import (
|
|
"database/sql"
|
|
"encoding/json"
|
|
"time"
|
|
|
|
"github.com/steveyegge/beads/internal/types"
|
|
)
|
|
|
|
// IssueSelectColumns is the canonical column list for full issue hydration.
|
|
// Every query that reads a complete types.Issue from the issues table should
|
|
// use this constant to avoid column-list drift between scan sites.
|
|
const IssueSelectColumns = `id, content_hash, title, description, design, acceptance_criteria, notes,
|
|
status, priority, issue_type, assignee, estimated_minutes,
|
|
created_at, created_by, owner, updated_at, started_at, closed_at, external_ref, spec_id,
|
|
compaction_level, compacted_at, compacted_at_commit, original_size, source_repo, close_reason,
|
|
sender, ephemeral, no_history, wisp_type, pinned, is_template,
|
|
await_type, await_id, timeout_ns, waiters,
|
|
mol_type,
|
|
event_kind, actor, target, payload,
|
|
due_at, defer_until,
|
|
work_type, source_system, metadata`
|
|
|
|
// IssueScanner is the common interface between *sql.Row and *sql.Rows,
|
|
// allowing a single scan function to work with both single-row and
|
|
// multi-row query results.
|
|
type IssueScanner interface {
|
|
Scan(dest ...any) error
|
|
}
|
|
|
|
// ScanIssueFrom scans a full issue from any source implementing IssueScanner.
|
|
// The caller must ensure the query selected exactly IssueSelectColumns in order.
|
|
func ScanIssueFrom(s IssueScanner) (*types.Issue, error) {
|
|
var issue types.Issue
|
|
var createdAtStr, updatedAtStr sql.NullString // TEXT columns - must parse manually
|
|
var startedAt, closedAt, compactedAt, dueAt, deferUntil sql.NullTime
|
|
var estimatedMinutes, originalSize, timeoutNs sql.NullInt64
|
|
var createdBy sql.NullString
|
|
var assignee, externalRef, specID, compactedAtCommit, owner sql.NullString
|
|
var contentHash, sourceRepo, closeReason sql.NullString
|
|
var workType, sourceSystem sql.NullString
|
|
var sender, wispType, molType, eventKind, actor, target, payload sql.NullString
|
|
var awaitType, awaitID, waiters sql.NullString
|
|
var ephemeral, noHistory, pinned, isTemplate sql.NullInt64
|
|
var metadata sql.NullString
|
|
|
|
if err := s.Scan(
|
|
&issue.ID, &contentHash, &issue.Title, &issue.Description, &issue.Design,
|
|
&issue.AcceptanceCriteria, &issue.Notes, &issue.Status,
|
|
&issue.Priority, &issue.IssueType, &assignee, &estimatedMinutes,
|
|
&createdAtStr, &createdBy, &owner, &updatedAtStr, &startedAt, &closedAt, &externalRef, &specID,
|
|
&issue.CompactionLevel, &compactedAt, &compactedAtCommit, &originalSize, &sourceRepo, &closeReason,
|
|
&sender, &ephemeral, &noHistory, &wispType, &pinned, &isTemplate,
|
|
&awaitType, &awaitID, &timeoutNs, &waiters,
|
|
&molType,
|
|
&eventKind, &actor, &target, &payload,
|
|
&dueAt, &deferUntil,
|
|
&workType, &sourceSystem, &metadata,
|
|
); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// Parse timestamp strings (TEXT columns require manual parsing)
|
|
if createdAtStr.Valid {
|
|
issue.CreatedAt = ParseTimeString(createdAtStr.String)
|
|
}
|
|
if updatedAtStr.Valid {
|
|
issue.UpdatedAt = ParseTimeString(updatedAtStr.String)
|
|
}
|
|
|
|
// Map nullable fields
|
|
if contentHash.Valid {
|
|
issue.ContentHash = contentHash.String
|
|
}
|
|
if startedAt.Valid {
|
|
issue.StartedAt = &startedAt.Time
|
|
}
|
|
if closedAt.Valid {
|
|
issue.ClosedAt = &closedAt.Time
|
|
}
|
|
if estimatedMinutes.Valid {
|
|
mins := int(estimatedMinutes.Int64)
|
|
issue.EstimatedMinutes = &mins
|
|
}
|
|
if assignee.Valid {
|
|
issue.Assignee = assignee.String
|
|
}
|
|
if createdBy.Valid {
|
|
issue.CreatedBy = createdBy.String
|
|
}
|
|
if owner.Valid {
|
|
issue.Owner = owner.String
|
|
}
|
|
if externalRef.Valid {
|
|
issue.ExternalRef = &externalRef.String
|
|
}
|
|
if specID.Valid {
|
|
issue.SpecID = specID.String
|
|
}
|
|
if compactedAt.Valid {
|
|
issue.CompactedAt = &compactedAt.Time
|
|
}
|
|
if compactedAtCommit.Valid {
|
|
issue.CompactedAtCommit = &compactedAtCommit.String
|
|
}
|
|
if originalSize.Valid {
|
|
issue.OriginalSize = int(originalSize.Int64)
|
|
}
|
|
if sourceRepo.Valid {
|
|
issue.SourceRepo = sourceRepo.String
|
|
}
|
|
if closeReason.Valid {
|
|
issue.CloseReason = closeReason.String
|
|
}
|
|
if sender.Valid {
|
|
issue.Sender = sender.String
|
|
}
|
|
if ephemeral.Valid && ephemeral.Int64 != 0 {
|
|
issue.Ephemeral = true
|
|
}
|
|
if noHistory.Valid && noHistory.Int64 != 0 {
|
|
issue.NoHistory = true
|
|
}
|
|
if wispType.Valid {
|
|
issue.WispType = types.WispType(wispType.String)
|
|
}
|
|
if pinned.Valid && pinned.Int64 != 0 {
|
|
issue.Pinned = true
|
|
}
|
|
if isTemplate.Valid && isTemplate.Int64 != 0 {
|
|
issue.IsTemplate = true
|
|
}
|
|
if awaitType.Valid {
|
|
issue.AwaitType = awaitType.String
|
|
}
|
|
if awaitID.Valid {
|
|
issue.AwaitID = awaitID.String
|
|
}
|
|
if timeoutNs.Valid {
|
|
issue.Timeout = time.Duration(timeoutNs.Int64)
|
|
}
|
|
if waiters.Valid && waiters.String != "" {
|
|
issue.Waiters = ParseJSONStringArray(waiters.String)
|
|
}
|
|
if molType.Valid {
|
|
issue.MolType = types.MolType(molType.String)
|
|
}
|
|
if eventKind.Valid {
|
|
issue.EventKind = eventKind.String
|
|
}
|
|
if actor.Valid {
|
|
issue.Actor = actor.String
|
|
}
|
|
if target.Valid {
|
|
issue.Target = target.String
|
|
}
|
|
if payload.Valid {
|
|
issue.Payload = payload.String
|
|
}
|
|
if dueAt.Valid {
|
|
issue.DueAt = &dueAt.Time
|
|
}
|
|
if deferUntil.Valid {
|
|
issue.DeferUntil = &deferUntil.Time
|
|
}
|
|
if workType.Valid {
|
|
issue.WorkType = types.WorkType(workType.String)
|
|
}
|
|
if sourceSystem.Valid {
|
|
issue.SourceSystem = sourceSystem.String
|
|
}
|
|
// Custom metadata field (GH#1406)
|
|
if metadata.Valid && metadata.String != "" && metadata.String != "{}" {
|
|
issue.Metadata = []byte(metadata.String)
|
|
}
|
|
|
|
return &issue, nil
|
|
}
|
|
|
|
// ParseTimeString parses a time string from database TEXT columns (non-nullable).
|
|
// Supports RFC3339Nano, RFC3339, and MySQL DATETIME format.
|
|
func ParseTimeString(s string) time.Time {
|
|
if s == "" {
|
|
return time.Time{}
|
|
}
|
|
// Try RFC3339Nano first (more precise), then RFC3339, then DATETIME format
|
|
for _, layout := range []string{time.RFC3339Nano, time.RFC3339, "2006-01-02 15:04:05"} {
|
|
if t, err := time.Parse(layout, s); err == nil {
|
|
return t
|
|
}
|
|
}
|
|
return time.Time{} // Unparseable - shouldn't happen with valid data
|
|
}
|
|
|
|
// ParseJSONStringArray unmarshals a JSON string array. Returns nil on error or empty input.
|
|
func ParseJSONStringArray(s string) []string {
|
|
if s == "" {
|
|
return nil
|
|
}
|
|
var result []string
|
|
if err := json.Unmarshal([]byte(s), &result); err != nil {
|
|
return nil
|
|
}
|
|
return result
|
|
}
|