@proletariat/cli 0.3.87 → 0.3.88

package/dist/lib/database/driver.js

@@ -0,0 +1,109 @@
+/**
+ * Database Driver Abstraction Layer
+ *
+ * Defines a driver-agnostic interface for SQLite database access.
+ * This allows swapping the underlying implementation (better-sqlite3, sql.js, etc.)
+ * without changing consumer code.
+ *
+ * All database access in the codebase should go through this interface
+ * rather than importing better-sqlite3 directly.
+ */
+import Database from 'better-sqlite3';
+// =============================================================================
+// BetterSqlite3 Driver Implementation
+// =============================================================================
+/**
+ * DatabaseDriver implementation backed by better-sqlite3.
+ *
+ * This is the primary driver used in production. It wraps a better-sqlite3
+ * Database instance behind the DatabaseDriver interface.
+ */
+export class BetterSqlite3Driver {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    prepare(sql) {
+        const stmt = this.db.prepare(sql);
+        return {
+            run: (...params) => {
+                const result = stmt.run(...params);
+                return { changes: result.changes, lastInsertRowid: result.lastInsertRowid };
+            },
+            get: (...params) => {
+                return stmt.get(...params);
+            },
+            all: (...params) => {
+                return stmt.all(...params);
+            },
+        };
+    }
+    exec(sql) {
+        this.db.exec(sql);
+    }
+    pragma(source, options) {
+        return this.db.pragma(source, options);
+    }
+    transaction(fn) {
+        return this.db.transaction(fn);
+    }
+    close() {
+        this.db.close();
+    }
+    get open() {
+        return this.db.open;
+    }
+    /**
+     * Access the underlying better-sqlite3 Database instance.
+     * @internal Use for Drizzle ORM interop only.
+     */
+    get raw() {
+        return this.db;
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create a DatabaseDriver from an existing better-sqlite3 Database instance.
+ * Useful when migrating existing code that already has a Database object.
+ */
+export function wrapDatabase(db) {
+    return new BetterSqlite3Driver(db);
+}
+/**
+ * Create a DatabaseDriver by opening a new better-sqlite3 connection.
+ * Configures standard pragmas (foreign keys, busy timeout).
+ */
+export function openDriver(dbPath, options) {
+    const db = new Database(dbPath);
+    if (options?.foreignKeys !== false) {
+        db.pragma('foreign_keys = ON');
+    }
+    if (options?.busyTimeout !== undefined) {
+        db.pragma(`busy_timeout = ${options.busyTimeout}`);
+    }
+    else {
+        db.pragma('busy_timeout = 5000');
+    }
+    return new BetterSqlite3Driver(db);
+}
+/**
+ * Extract the raw better-sqlite3 Database from a driver.
+ * Throws if the driver is not a BetterSqlite3Driver.
+ *
+ * Use this for interop with code that still requires the raw connection
+ * (e.g., Drizzle ORM, legacy code being migrated).
+ */
+export function getRawDatabase(driver) {
+    if (driver instanceof BetterSqlite3Driver) {
+        return driver.raw;
+    }
+    // For other driver implementations, check the raw property
+    const raw = driver.raw;
+    if (raw && typeof raw === 'object' && 'prepare' in raw) {
+        return raw;
+    }
+    throw new Error('Cannot extract raw database from this driver implementation');
+}
+//# sourceMappingURL=driver.js.map

package/dist/lib/database/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/lib/database/driver.ts"],"names":[],"mappings":"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"}

package/dist/lib/database/index.d.ts

@@ -1,289 +1,27 @@
-import Database from 'better-sqlite3';
-export { CREATE_TABLES_SQL } from './workspace-schema.js';
-export interface WorkspaceConfig {
-    id: number;
-    type: 'hq' | 'workspace';
-    workspace_name: string;
-    has_pmo: boolean;
-    active_theme_id: string | null;
-    created_at: string;
-}
-export interface Repository {
-    name: string;
-    path: string;
-    type: 'main' | 'dependency';
-    source_url?: string;
-    action?: 'clone' | 'move' | 'link';
-    added_at: string;
-}
-export type AgentType = 'persistent' | 'ephemeral';
-export type AgentStatus = 'active' | 'cleaned';
-export type MountMode = 'worktree' | 'clone';
-export interface Agent {
-    name: string;
-    type: AgentType;
-    status: AgentStatus;
-    base_name: string | null;
-    theme_id: string | null;
-    worktree_path: string | null;
-    mount_mode: MountMode;
-    created_at: string;
-    cleaned_at: string | null;
-}
-export interface AgentTheme {
-    id: string;
-    name: string;
-    display_name: string;
-    description: string | null;
-    builtin: boolean;
-    created_at: string;
-}
-export interface AgentThemeName {
-    theme_id: string;
-    name: string;
-}
-export interface AgentWorktree {
-    agent_name: string;
-    repo_name: string;
-    worktree_path: string;
-    branch: string;
-    created_at: string;
-    last_commit_hash?: string;
-    commits_ahead: number;
-    is_clean: boolean;
-    last_checked?: string;
-}
-/**
- * Get the database path for a workspace
- */
-export declare function getDatabasePath(workspacePath: string): string;
-/**
- * Get the config path for a workspace
- */
-export declare function getConfigPath(workspacePath: string): string;
-/**
- * Open workspace database connection
- */
-export declare function openWorkspaceDatabase(workspacePath: string): Database.Database;
-/**
- * Create and initialize workspace database
- */
-export declare function createWorkspaceDatabase(workspacePath: string, type: 'hq' | 'workspace', workspaceName: string, hasPMO?: boolean): Database.Database;
-/**
- * Get workspace configuration
- */
-export declare function getWorkspaceConfig(workspacePath: string): WorkspaceConfig | null;
-/**
- * Get the active theme for a workspace
- * Auto-detects theme from existing agents if not explicitly set
- */
-export declare function getActiveTheme(workspacePath: string): AgentTheme | null;
-/**
- * Set the active theme for a workspace
- */
-export declare function setActiveTheme(workspacePath: string, themeId: string | null): void;
-/**
- * Add repositories to database
- */
-export declare function addRepositoriesToDatabase(workspacePath: string, repos: {
-    name: string;
-    path: string;
-    source_url?: string;
-    action?: 'clone' | 'move' | 'link';
-}[]): void;
-/**
- * Add agents to database (case-insensitive uniqueness)
- */
-export declare function addAgentsToDatabase(workspacePath: string, agentNames: string[], themeId?: string, mountMode?: MountMode): void;
-/**
- * Add an ephemeral agent to the database.
- * Throws on name collision — use tryAddEphemeralAgentToDatabase for
- * concurrency-safe insertion with conflict detection.
- */
-export declare function addEphemeralAgentToDatabase(workspacePath: string, agentName: string, baseName: string, themeId?: string, mountMode?: MountMode): Agent;
-/**
- * Try to add an ephemeral agent to the database.
- * Returns the Agent on success, or null if the name already exists
- * (SQLITE_CONSTRAINT_PRIMARYKEY). This is concurrency-safe: parallel
- * processes that generate the same name will not crash — the loser
- * simply gets null and can retry with a different name.
- */
-export declare function tryAddEphemeralAgentToDatabase(workspacePath: string, agentName: string, baseName: string, themeId?: string, mountMode?: MountMode): Agent | null;
-/**
- * Get all ephemeral agent names from the database
- */
-export declare function getEphemeralAgentNames(workspacePath: string): Set<string>;
-/**
- * Remove an ephemeral agent from the database
- */
-export declare function removeEphemeralAgent(workspacePath: string, agentName: string): void;
-/**
- * Get all agents in workspace
- */
-export declare function getWorkspaceAgents(workspacePath: string, includeCleanedUp?: boolean): Agent[];
-/**
- * Get an agent by directory path.
- * Looks up agent where the given absolute path is inside the agent's worktree.
- * Returns null if no matching agent found.
- */
-export declare function getAgentByPath(workspacePath: string, absolutePath: string): Agent | null;
-/**
- * Mark an agent as cleaned up (keeps the record for history)
- */
-export declare function markAgentCleaned(workspacePath: string, agentName: string): void;
-/**
- * Sync agents in database with what exists on disk.
- * Marks agents as 'cleaned' if their directory no longer exists.
- * Returns list of agents that were cleaned up.
- */
-export declare function syncAgentsWithDisk(workspacePath: string): string[];
-export interface DiscoverResult {
-    discovered: {
-        name: string;
-        type: AgentType;
-        path: string;
-    }[];
-    cleaned: string[];
-}
-/**
- * Discover agents on disk that aren't in the database and register them.
- * Also cleans up agents in DB whose directories no longer exist.
- * Returns both discovered and cleaned agents.
- */
-export declare function discoverAgentsOnDisk(workspacePath: string): DiscoverResult;
-/**
- * Get all repositories in workspace
- */
-export declare function getWorkspaceRepositories(workspacePath: string): Repository[];
 /**
- * Get worktrees for a specific agent
+ * Database Module - Re-export Facade
+ *
+ * This module re-exports all database operations from domain-specific modules.
+ * Consumers should import from this index for backward compatibility.
+ *
+ * Domain modules:
+ * - workspace.ts  - Database lifecycle (open, create, config)
+ * - agents.ts     - Agent CRUD operations
+ * - repositories.ts - Repository operations
+ * - themes.ts     - Agent naming theme operations
+ * - worktrees.ts  - Agent worktree queries
+ * - media.ts      - Media item operations
+ * - pmo-bootstrap.ts - PMO initialization/teardown
+ * - driver.ts     - DatabaseDriver abstraction layer
+ * - settings-store.ts - Workspace settings key-value store
  */
-export declare function getAgentWorktrees(workspacePath: string, agentName: string): AgentWorktree[];
-/**
- * Find agent worktrees matching a branch pattern (case-insensitive LIKE).
- */
-export declare function findWorktreesByBranch(workspacePath: string, branchPattern: string): AgentWorktree[];
-/**
- * Get agent worktrees for a specific repository.
- */
-export declare function getWorktreesForRepo(workspacePath: string, repoName: string): Array<{
-    agent_name: string;
-    is_clean: number;
-    commits_ahead: number;
-    branch: string;
-}>;
-/**
- * Upsert a workspace setting (key-value pair).
- */
-export declare function upsertWorkspaceSetting(db: Database.Database, key: string, value: string): void;
-/**
- * Remove agents from database
- */
-export declare function removeAgentsFromDatabase(workspacePath: string, agentNames: string[]): void;
-/**
- * Check if PMO tables exist and get basic stats.
- * Used by pmo init to detect existing PMO before storage layer is available.
- * Raw SQL: uses sqlite_master introspection (pre-migration bootstrap).
- */
-export declare function checkPMOExists(dbPath: string): {
-    exists: boolean;
-    projectCount: number;
-    ticketCount: number;
-};
-/**
- * Get a PMO setting from the pmo_settings table.
- * Used for bootstrapping queries before storage layer is available.
- * Raw SQL: pre-migration bootstrap query.
- */
-export declare function getPMOSetting(dbPath: string, key: string): string | null;
-/**
- * Drop PMO tables from the database.
- * Used during PMO reinitialization.
- * Raw SQL: DDL operations (DROP TABLE) are not supported by Drizzle.
- */
-export declare function dropPMOTables(dbPath: string, tables: string[]): void;
-/**
- * Get all themes
- */
-export declare function getThemes(workspacePath: string): AgentTheme[];
-/**
- * Get a theme by ID
- */
-export declare function getTheme(workspacePath: string, themeId: string): AgentTheme | null;
-/**
- * Create a new theme
- */
-export declare function createTheme(workspacePath: string, theme: {
-    id: string;
-    name: string;
-    displayName: string;
-    description?: string;
-    builtin?: boolean;
-}): AgentTheme;
-/**
- * Delete a theme (cannot delete builtin themes)
- */
-export declare function deleteTheme(workspacePath: string, themeId: string): boolean;
-/**
- * Get names for a theme
- */
-export declare function getThemeNames(workspacePath: string, themeId: string): AgentThemeName[];
-/**
- * Get available names for a theme.
- * A name is available if:
- * 1. No staff agent exists in the database with that name (case-insensitive), OR
- * 2. The agent exists but its worktree directory is missing (manually deleted)
- */
-export declare function getAvailableThemeNames(workspacePath: string, themeId: string): string[];
-/**
- * Add names to a theme (case-insensitive uniqueness)
- */
-export declare function addThemeNames(workspacePath: string, themeId: string, names: string[]): void;
-export interface MediaItem {
-    name: string;
-    path: string;
-    source_path: string | null;
-    media_type: 'video' | 'audio';
-    duration_seconds: number | null;
-    resolution: string | null;
-    frame_count: number;
-    has_transcript: boolean;
-    frame_interval: number;
-    status: 'pending' | 'processing' | 'ready' | 'error';
-    error_message: string | null;
-    added_at: string;
-    processed_at: string | null;
-}
-/**
- * Add a media item to the database
- */
-export declare function addMediaItemToDatabase(workspacePath: string, item: {
-    name: string;
-    path: string;
-    source_path?: string;
-    media_type: 'video' | 'audio';
-    frame_interval?: number;
-}): void;
-/**
- * Update media item after preprocessing
- */
-export declare function updateMediaItemStatus(workspacePath: string, name: string, updates: {
-    status: 'pending' | 'processing' | 'ready' | 'error';
-    duration_seconds?: number;
-    resolution?: string;
-    frame_count?: number;
-    has_transcript?: boolean;
-    error_message?: string;
-}): void;
-/**
- * Get all media items in workspace
- */
-export declare function getWorkspaceMediaItems(workspacePath: string): MediaItem[];
-/**
- * Get a single media item by name
- */
-export declare function getMediaItem(workspacePath: string, name: string): MediaItem | null;
-/**
- * Remove a media item from the database
- */
-export declare function removeMediaItemFromDatabase(workspacePath: string, name: string): void;
+export { CREATE_TABLES_SQL } from './workspace-schema.js';
+export { type WorkspaceConfig, withDrizzle, getDatabasePath, getConfigPath, openWorkspaceDatabase, openWorkspaceDriver, createWorkspaceDatabase, getWorkspaceConfig, } from './workspace.js';
+export { type AgentType, type AgentStatus, type MountMode, type Agent, type DiscoverResult, addAgentsToDatabase, addEphemeralAgentToDatabase, tryAddEphemeralAgentToDatabase, getEphemeralAgentNames, removeEphemeralAgent, getWorkspaceAgents, getAgentByPath, markAgentCleaned, syncAgentsWithDisk, discoverAgentsOnDisk, removeAgentsFromDatabase, } from './agents.js';
+export { type Repository, addRepositoriesToDatabase, getWorkspaceRepositories, } from './repositories.js';
+export { type AgentTheme, type AgentThemeName, getActiveTheme, setActiveTheme, getThemes, getTheme, createTheme, deleteTheme, getThemeNames, getAvailableThemeNames, addThemeNames, } from './themes.js';
+export { type AgentWorktree, getAgentWorktrees, findWorktreesByBranch, getWorktreesForRepo, } from './worktrees.js';
+export { type MediaItem, addMediaItemToDatabase, updateMediaItemStatus, getWorkspaceMediaItems, getMediaItem, removeMediaItemFromDatabase, } from './media.js';
+export { checkPMOExists, getPMOSetting, dropPMOTables, upsertWorkspaceSetting, } from './pmo-bootstrap.js';
+export { type DatabaseDriver, type PreparedStatement, type RunResult, BetterSqlite3Driver, wrapDatabase, openDriver, getRawDatabase, } from './driver.js';
+export { SettingsStore, createSettingsStore, } from './settings-store.js';