Documentation
¶
Index ¶
- Constants
- Variables
- type DB
- func (db *DB) AddComment(comment *models.Comment) error
- func (db *DB) AddDependency(issueID, dependsOnID, relationType string) error
- func (db *DB) AddGitSnapshot(snapshot *models.GitSnapshot) error
- func (db *DB) AddHandoff(handoff *models.Handoff) error
- func (db *DB) AddLog(log *models.Log) error
- func (db *DB) BaseDir() string
- func (db *DB) Close() error
- func (db *DB) CreateIssue(issue *models.Issue) error
- func (db *DB) CreateWorkSession(ws *models.WorkSession) error
- func (db *DB) DeleteIssue(id string) error
- func (db *DB) GetActiveSessions(since time.Time) ([]string, error)
- func (db *DB) GetBlockedBy(issueID string) ([]string, error)
- func (db *DB) GetComments(issueID string) ([]models.Comment, error)
- func (db *DB) GetDependencies(issueID string) ([]string, error)
- func (db *DB) GetIssue(id string) (*models.Issue, error)
- func (db *DB) GetIssueSessionLog(sessionID string) ([]string, error)
- func (db *DB) GetLastAction(sessionID string) (*models.ActionLog, error)
- func (db *DB) GetLatestHandoff(issueID string) (*models.Handoff, error)
- func (db *DB) GetLinkedFiles(issueID string) ([]models.IssueFile, error)
- func (db *DB) GetLogs(issueID string, limit int) ([]models.Log, error)
- func (db *DB) GetLogsByWorkSession(wsID string) ([]models.Log, error)
- func (db *DB) GetRecentActions(sessionID string, limit int) ([]models.ActionLog, error)
- func (db *DB) GetRecentActionsAll(limit int) ([]models.ActionLog, error)
- func (db *DB) GetRecentCommentsAll(limit int) ([]models.Comment, error)
- func (db *DB) GetRecentHandoffs(limit int, since time.Time) ([]models.Handoff, error)
- func (db *DB) GetRecentLogsAll(limit int) ([]models.Log, error)
- func (db *DB) GetSchemaVersion() (int, error)
- func (db *DB) GetStartSnapshot(issueID string) (*models.GitSnapshot, error)
- func (db *DB) GetStats() (map[string]int, error)
- func (db *DB) GetWorkSession(id string) (*models.WorkSession, error)
- func (db *DB) GetWorkSessionIssues(wsID string) ([]string, error)
- func (db *DB) LinkFile(issueID, filePath string, role models.FileRole, sha string) error
- func (db *DB) ListIssues(opts ListIssuesOptions) ([]models.Issue, error)
- func (db *DB) ListWorkSessions(limit int) ([]models.WorkSession, error)
- func (db *DB) LogAction(action *models.ActionLog) error
- func (db *DB) MarkActionUndone(actionID int64) error
- func (db *DB) RemoveDependency(issueID, dependsOnID string) error
- func (db *DB) RestoreIssue(id string) error
- func (db *DB) RunMigrations() (int, error)
- func (db *DB) SearchIssues(query string, opts ListIssuesOptions) ([]models.Issue, error)
- func (db *DB) SetSchemaVersion(version int) error
- func (db *DB) TagIssueToWorkSession(wsID, issueID string) error
- func (db *DB) UnlinkFile(issueID, filePath string) error
- func (db *DB) UntagIssueFromWorkSession(wsID, issueID string) error
- func (db *DB) UpdateIssue(issue *models.Issue) error
- func (db *DB) UpdateWorkSession(ws *models.WorkSession) error
- type ListIssuesOptions
- type Migration
Constants ¶
const SchemaVersion = 5
SchemaVersion is the current database schema version
Variables ¶
var Migrations = []Migration{
{
Version: 2,
Description: "Add action_log table for undo support",
SQL: `
CREATE TABLE IF NOT EXISTS action_log (
id INTEGER PRIMARY KEY AUTOINCREMENT,
session_id TEXT NOT NULL,
action_type TEXT NOT NULL,
entity_type TEXT NOT NULL,
entity_id TEXT NOT NULL,
previous_data TEXT DEFAULT '',
new_data TEXT DEFAULT '',
timestamp DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
undone INTEGER DEFAULT 0
);
CREATE INDEX IF NOT EXISTS idx_action_log_session ON action_log(session_id);
CREATE INDEX IF NOT EXISTS idx_action_log_timestamp ON action_log(timestamp);
`,
},
{
Version: 3,
Description: "Allow work session logs without issue_id",
SQL: `
-- SQLite doesn't support ALTER COLUMN, so we need to recreate the table
CREATE TABLE logs_new (
id INTEGER PRIMARY KEY AUTOINCREMENT,
issue_id TEXT DEFAULT '',
session_id TEXT NOT NULL,
work_session_id TEXT DEFAULT '',
message TEXT NOT NULL,
type TEXT NOT NULL DEFAULT 'progress',
timestamp DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
INSERT INTO logs_new SELECT * FROM logs;
DROP TABLE logs;
ALTER TABLE logs_new RENAME TO logs;
CREATE INDEX IF NOT EXISTS idx_logs_issue ON logs(issue_id);
CREATE INDEX IF NOT EXISTS idx_logs_work_session ON logs(work_session_id);
`,
},
{
Version: 4,
Description: "Add minor flag to issues for self-reviewable tasks",
SQL: `ALTER TABLE issues ADD COLUMN minor INTEGER DEFAULT 0;`,
},
{
Version: 5,
Description: "Add created_branch to issues",
SQL: `ALTER TABLE issues ADD COLUMN created_branch TEXT DEFAULT '';`,
},
}
Migrations is the list of all database migrations in order
Functions ¶
This section is empty.
Types ¶
type DB ¶
type DB struct {
// contains filtered or unexported fields
}
DB wraps the database connection
func Initialize ¶
Initialize creates the database and runs migrations
func (*DB) AddComment ¶
AddComment adds a comment to an issue
func (*DB) AddDependency ¶
AddDependency adds a dependency between issues
func (*DB) AddGitSnapshot ¶
func (db *DB) AddGitSnapshot(snapshot *models.GitSnapshot) error
AddGitSnapshot records a git state snapshot
func (*DB) AddHandoff ¶
AddHandoff adds a handoff entry
func (*DB) CreateIssue ¶
CreateIssue creates a new issue
func (*DB) CreateWorkSession ¶
func (db *DB) CreateWorkSession(ws *models.WorkSession) error
CreateWorkSession creates a new work session
func (*DB) DeleteIssue ¶
DeleteIssue soft-deletes an issue
func (*DB) GetActiveSessions ¶
GetActiveSessions returns distinct session IDs with activity since the given time
func (*DB) GetBlockedBy ¶
GetBlockedBy returns what issues are blocked by this issue
func (*DB) GetComments ¶
GetComments retrieves comments for an issue
func (*DB) GetDependencies ¶
GetDependencies returns what an issue depends on
func (*DB) GetIssueSessionLog ¶
GetIssueSessionLog returns issues touched by a session
func (*DB) GetLastAction ¶
GetLastAction returns the most recent undoable action for a session
func (*DB) GetLatestHandoff ¶
GetLatestHandoff retrieves the latest handoff for an issue
func (*DB) GetLinkedFiles ¶
GetLinkedFiles returns files linked to an issue
func (*DB) GetLogsByWorkSession ¶
GetLogsByWorkSession retrieves logs for a specific work session
func (*DB) GetRecentActions ¶
GetRecentActions returns recent actions for a session
func (*DB) GetRecentActionsAll ¶
GetRecentActionsAll returns recent action_log entries across all sessions
func (*DB) GetRecentCommentsAll ¶
GetRecentCommentsAll returns recent comments across all issues
func (*DB) GetRecentHandoffs ¶
GetRecentHandoffs retrieves recent handoffs across all issues
func (*DB) GetRecentLogsAll ¶
GetRecentLogsAll returns recent logs across all issues
func (*DB) GetSchemaVersion ¶
GetSchemaVersion returns the current schema version from the database
func (*DB) GetStartSnapshot ¶
func (db *DB) GetStartSnapshot(issueID string) (*models.GitSnapshot, error)
GetStartSnapshot returns the start snapshot for an issue
func (*DB) GetWorkSession ¶
func (db *DB) GetWorkSession(id string) (*models.WorkSession, error)
GetWorkSession retrieves a work session
func (*DB) GetWorkSessionIssues ¶
GetWorkSessionIssues returns issues tagged to a work session
func (*DB) ListIssues ¶
func (db *DB) ListIssues(opts ListIssuesOptions) ([]models.Issue, error)
ListIssues returns issues matching the filter
func (*DB) ListWorkSessions ¶
func (db *DB) ListWorkSessions(limit int) ([]models.WorkSession, error)
ListWorkSessions returns recent work sessions
func (*DB) MarkActionUndone ¶
MarkActionUndone marks an action as undone
func (*DB) RemoveDependency ¶
RemoveDependency removes a dependency
func (*DB) RestoreIssue ¶
RestoreIssue restores a soft-deleted issue
func (*DB) RunMigrations ¶
RunMigrations runs any pending database migrations
func (*DB) SearchIssues ¶
SearchIssues performs full-text search across issues
func (*DB) SetSchemaVersion ¶
SetSchemaVersion sets the schema version in the database
func (*DB) TagIssueToWorkSession ¶
TagIssueToWorkSession links an issue to a work session
func (*DB) UnlinkFile ¶
UnlinkFile removes a file link
func (*DB) UntagIssueFromWorkSession ¶
UntagIssueFromWorkSession removes an issue from a work session
func (*DB) UpdateIssue ¶
UpdateIssue updates an issue
func (*DB) UpdateWorkSession ¶
func (db *DB) UpdateWorkSession(ws *models.WorkSession) error
UpdateWorkSession updates a work session
type ListIssuesOptions ¶
type ListIssuesOptions struct {
Status []models.Status
Type []models.Type
Priority string
Labels []string
IncludeDeleted bool
OnlyDeleted bool
Search string
Implementer string
Reviewer string
ReviewableBy string // Issues that this session can review
ParentID string
PointsMin int
PointsMax int
CreatedAfter time.Time
CreatedBefore time.Time
UpdatedAfter time.Time
UpdatedBefore time.Time
ClosedAfter time.Time
ClosedBefore time.Time
SortBy string
SortDesc bool
Limit int
IDs []string
}
ListIssuesOptions contains filter options for listing issues