workspacedb

package

v0.0.2 Latest Latest Go to latest Published: May 27, 2026 License: MIT Imports: 9 Imported by: 0

Details

Package workspacedb owns per-workspace SQLite database lifecycle helpers.

This section is empty.

This section is empty.

This section is empty.

type DB struct {
	// contains filtered or unexported fields
}

DB is an open per-workspace AGH database handle.

func Open(ctx context.Context, opts Options) (*DB, error)

Open resolves the workspace identity and opens <workspace>/.agh/agh.db.

func OpenWorkspace(ctx context.Context, workspaceRoot string, migrations []store.Migration) (*DB, error)

OpenWorkspace opens a workspace database with the default migration table.

func (d *DB) Close(ctx context.Context) error

Close checkpoints the WAL and closes the database.

func (d *DB) DB() *sql.DB

DB exposes the underlying SQL handle for storage packages.

func (d *DB) Path() string

Path reports the database path.

func (d *DB) WorkspaceID() string

WorkspaceID reports the resolved workspace identity.

func (d *DB) WorkspaceRoot() string

WorkspaceRoot reports the workspace root used to open the database.

type Options struct {
	WorkspaceRoot   string
	Migrations      []store.Migration
	MigrationsTable string
}

Options configures a per-workspace database open.