@blockspool/core 0.4.1 → 0.4.3

package/dist/exec/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ExecRunner types - Interface for command execution
+ *
+ * Core contains only the interface/types.
+ * Node implementation lives in packages/cli.
+ */
+export type ExecStatus = 'success' | 'failed' | 'timeout' | 'canceled';
+export interface ExecOutput {
+    /** Path intended to be stored in DB (usually repo-relative) */
+    path: string;
+    /** Absolute path for immediate file access */
+    absPath: string;
+    /** Bytes written to artifact file (capped by maxLogBytes) */
+    bytes: number;
+    /** Whether output exceeded maxLogBytes (file is truncated) */
+    truncated: boolean;
+    /** Tail of output (last tailBytes), derived from full stream even if truncated */
+    tail: string;
+}
+export interface ExecSpec {
+    cmd: string;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    /** Defaults to true (runs through shell). */
+    shell?: boolean;
+    /** Timeout for the process. If hit -> kill -> status=timeout. */
+    timeoutMs?: number;
+    /** Optional cancellation. If aborted -> kill -> status=canceled. */
+    signal?: AbortSignal;
+    /**
+     * Artifact config.
+     * artifactsDir can be repo-relative (recommended) or absolute.
+     */
+    repoRoot: string;
+    artifactsDir: string;
+    runId: string;
+    attempt: number;
+    stepName: string;
+    ordinal: number;
+    /** Cap bytes written to disk per stream (stdout/stderr). */
+    maxLogBytes?: number;
+    /** Tail buffer size in bytes per stream. */
+    tailBytes?: number;
+    /** Optional live hooks (useful later for TUI/streaming). */
+    onStdoutChunk?: (chunk: Buffer) => void;
+    onStderrChunk?: (chunk: Buffer) => void;
+}
+export interface ExecResult {
+    status: ExecStatus;
+    exitCode: number | null;
+    signal: string | null;
+    /** Runner/system failure (spawn error, timeout msg, stream write error, etc.) */
+    errorMessage?: string;
+    pid: number | null;
+    startedAtMs: number;
+    endedAtMs: number;
+    durationMs: number;
+    stdout: ExecOutput;
+    stderr: ExecOutput;
+}
+export interface ExecRunner {
+    run(spec: ExecSpec): Promise<ExecResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/exec/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/exec/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAEzC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IAErB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAEhB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1C"}

package/dist/exec/types.js

@@ -0,0 +1,8 @@
+/**
+ * ExecRunner types - Interface for command execution
+ *
+ * Core contains only the interface/types.
+ * Node implementation lives in packages/cli.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/exec/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/exec/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @blockspool/core
+ *
+ * Core business logic and shared types for BlockSpool.
+ * This package is open source (Apache-2.0) and provides:
+ *
+ * - Database adapter interface (works with Postgres or SQLite)
+ * - Repository layer for data access
+ * - Services for business logic orchestration
+ * - Scout service for codebase analysis
+ * - Shared type definitions
+ * - Core business logic utilities
+ */
+export * from './db/index.js';
+export * as repos from './repos/index.js';
+export type { Project, Ticket, TicketStatus, TicketCategory, Run, RunStatus, RunType } from './repos/index.js';
+export * as services from './services/index.js';
+export type { ScoutDeps, ScoutRepoOptions, ScoutRepoResult, GitService, Logger } from './services/index.js';
+export { scoutRepo, approveProposals } from './services/index.js';
+export * as scout from './scout/index.js';
+export * from './exec/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,cAAc,eAAe,CAAC;AAG9B,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG/G,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAG1C,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @blockspool/core
+ *
+ * Core business logic and shared types for BlockSpool.
+ * This package is open source (Apache-2.0) and provides:
+ *
+ * - Database adapter interface (works with Postgres or SQLite)
+ * - Repository layer for data access
+ * - Services for business logic orchestration
+ * - Scout service for codebase analysis
+ * - Shared type definitions
+ * - Core business logic utilities
+ */
+// Database adapter
+export * from './db/index.js';
+// Repositories (namespaced)
+export * as repos from './repos/index.js';
+// Services (namespaced to avoid conflicts with scout)
+export * as services from './services/index.js';
+export { scoutRepo, approveProposals } from './services/index.js';
+// Scout (low-level scanning/analysis - namespaced)
+export * as scout from './scout/index.js';
+// Exec runner interface
+export * from './exec/index.js';
+// Utilities
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,mBAAmB;AACnB,cAAc,eAAe,CAAC;AAE9B,4BAA4B;AAC5B,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAG1C,sDAAsD;AACtD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAElE,mDAAmD;AACnD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,wBAAwB;AACxB,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,cAAc,kBAAkB,CAAC"}

package/dist/repos/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Repository exports
+ *
+ * Repositories provide database operations using the DatabaseAdapter interface.
+ * They handle row mapping and business logic validation.
+ */
+export * as projects from './projects.js';
+export * as tickets from './tickets.js';
+export * as runs from './runs.js';
+export * as runSteps from './run_steps.js';
+export type { Project } from './projects.js';
+export type { Ticket, TicketStatus, TicketCategory } from './tickets.js';
+export type { Run, RunStatus, RunType, RunSummary } from './runs.js';
+export type { RunStep, StepStatus, StepKind, StepCounts, StepSummary, } from './run_steps.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/repos/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repos/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EACV,OAAO,EACP,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC"}

package/dist/repos/index.js

@@ -0,0 +1,11 @@
+/**
+ * Repository exports
+ *
+ * Repositories provide database operations using the DatabaseAdapter interface.
+ * They handle row mapping and business logic validation.
+ */
+export * as projects from './projects.js';
+export * as tickets from './tickets.js';
+export * as runs from './runs.js';
+export * as runSteps from './run_steps.js';
+//# sourceMappingURL=index.js.map

package/dist/repos/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repos/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC"}

package/dist/repos/projects.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Project repository - Database operations for projects
+ */
+import type { DatabaseAdapter } from '../db/adapter.js';
+export interface Project {
+    id: string;
+    name: string;
+    repoUrl: string | null;
+    rootPath: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Get project by ID
+ */
+export declare function getById(db: DatabaseAdapter, id: string): Promise<Project | null>;
+/**
+ * Get project by repository root path
+ */
+export declare function getByRepoRoot(db: DatabaseAdapter, rootPath: string): Promise<Project | null>;
+/**
+ * Ensure a project exists for a repository
+ * Returns existing project or creates new one
+ *
+ * This is idempotent - calling twice with same rootPath returns same project
+ */
+export declare function ensureForRepo(db: DatabaseAdapter, opts: {
+    name: string;
+    rootPath: string;
+    id?: string;
+    repoUrl?: string | null;
+}): Promise<Project>;
+/**
+ * List all projects
+ */
+export declare function list(db: DatabaseAdapter): Promise<Project[]>;
+/**
+ * Delete a project and all related data
+ */
+export declare function remove(db: DatabaseAdapter, id: string): Promise<void>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/repos/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/repos/projects.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAsBD;;GAEG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAMzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,eAAe,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAMzB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GACA,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAKlE;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3E"}

package/dist/repos/projects.js

@@ -0,0 +1,74 @@
+/**
+ * Project repository - Database operations for projects
+ */
+import { nanoid } from '../utils/id.js';
+function rowToProject(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        repoUrl: row.repo_url,
+        rootPath: row.root_path,
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at),
+    };
+}
+/**
+ * Get project by ID
+ */
+export async function getById(db, id) {
+    const result = await db.query('SELECT * FROM projects WHERE id = $1', [id]);
+    return result.rows[0] ? rowToProject(result.rows[0]) : null;
+}
+/**
+ * Get project by repository root path
+ */
+export async function getByRepoRoot(db, rootPath) {
+    const result = await db.query('SELECT * FROM projects WHERE root_path = $1', [rootPath]);
+    return result.rows[0] ? rowToProject(result.rows[0]) : null;
+}
+/**
+ * Ensure a project exists for a repository
+ * Returns existing project or creates new one
+ *
+ * This is idempotent - calling twice with same rootPath returns same project
+ */
+export async function ensureForRepo(db, opts) {
+    // Check if already exists by rootPath
+    const existing = await getByRepoRoot(db, opts.rootPath);
+    if (existing) {
+        return existing;
+    }
+    // Create new project (use ON CONFLICT to handle race conditions / worktree paths)
+    const id = opts.id ?? `proj_${nanoid(6)}`;
+    await db.query(`INSERT INTO projects (id, name, repo_url, root_path)
+     VALUES ($1, $2, $3, $4)
+     ON CONFLICT (id) DO NOTHING`, [id, opts.name, opts.repoUrl ?? null, opts.rootPath]);
+    const created = await getById(db, id);
+    if (!created) {
+        throw new Error('Failed to create project');
+    }
+    return created;
+}
+/**
+ * List all projects
+ */
+export async function list(db) {
+    const result = await db.query('SELECT * FROM projects ORDER BY updated_at DESC');
+    return result.rows.map(rowToProject);
+}
+/**
+ * Delete a project and all related data
+ */
+export async function remove(db, id) {
+    await db.withTransaction(async (tx) => {
+        // Delete in order respecting foreign keys
+        await tx.query('DELETE FROM run_events WHERE run_id IN (SELECT id FROM runs WHERE ticket_id IN (SELECT id FROM tickets WHERE project_id = $1))', [id]);
+        await tx.query('DELETE FROM artifacts WHERE run_id IN (SELECT id FROM runs WHERE ticket_id IN (SELECT id FROM tickets WHERE project_id = $1))', [id]);
+        await tx.query('DELETE FROM leases WHERE ticket_id IN (SELECT id FROM tickets WHERE project_id = $1)', [id]);
+        await tx.query('DELETE FROM runs WHERE ticket_id IN (SELECT id FROM tickets WHERE project_id = $1)', [id]);
+        await tx.query('DELETE FROM learnings WHERE project_id = $1', [id]);
+        await tx.query('DELETE FROM tickets WHERE project_id = $1', [id]);
+        await tx.query('DELETE FROM projects WHERE id = $1', [id]);
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/repos/projects.js.map

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

package/dist/repos/run_steps.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Run Steps repository - Database operations for run steps
+ *
+ * Steps are individual commands/actions within a run (e.g., QA commands).
+ * Supports retry attempts with full history preserved.
+ */
+import type { DatabaseAdapter } from '../db/adapter.js';
+export type StepStatus = 'queued' | 'running' | 'success' | 'failed' | 'skipped' | 'canceled';
+export type StepKind = 'command' | 'llm_fix' | 'git' | 'internal';
+export interface RunStep {
+    id: string;
+    runId: string;
+    attempt: number;
+    ordinal: number;
+    name: string;
+    kind: StepKind;
+    status: StepStatus;
+    cmd: string | null;
+    cwd: string | null;
+    timeoutMs: number | null;
+    exitCode: number | null;
+    signal: string | null;
+    startedAtMs: number | null;
+    endedAtMs: number | null;
+    durationMs: number | null;
+    stdoutPath: string | null;
+    stderrPath: string | null;
+    stdoutBytes: number;
+    stderrBytes: number;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+    stdoutTail: string | null;
+    stderrTail: string | null;
+    errorMessage: string | null;
+    metadata: Record<string, unknown>;
+    createdAtMs: number;
+    updatedAtMs: number;
+}
+/**
+ * Get step by ID
+ */
+export declare function getById(db: DatabaseAdapter, id: string): Promise<RunStep | null>;
+/**
+ * Create a new step
+ */
+export declare function create(db: DatabaseAdapter, opts: {
+    runId: string;
+    attempt?: number;
+    ordinal: number;
+    name: string;
+    kind?: StepKind;
+    cmd?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    metadata?: Record<string, unknown>;
+}): Promise<RunStep>;
+/**
+ * Create multiple steps at once (for initializing a QA run)
+ */
+export declare function createMany(db: DatabaseAdapter, runId: string, steps: Array<{
+    name: string;
+    cmd: string;
+    cwd?: string;
+    timeoutMs?: number;
+}>, attempt?: number): Promise<RunStep[]>;
+/**
+ * Mark step as started
+ */
+export declare function markStarted(db: DatabaseAdapter, id: string): Promise<RunStep | null>;
+/**
+ * Mark step as successful
+ */
+export declare function markSuccess(db: DatabaseAdapter, id: string, opts?: {
+    exitCode?: number;
+    stdoutPath?: string;
+    stderrPath?: string;
+    stdoutBytes?: number;
+    stderrBytes?: number;
+    stdoutTruncated?: boolean;
+    stderrTruncated?: boolean;
+    stdoutTail?: string;
+    stderrTail?: string;
+    metadata?: Record<string, unknown>;
+}): Promise<RunStep | null>;
+/**
+ * Mark step as failed
+ */
+export declare function markFailed(db: DatabaseAdapter, id: string, opts: {
+    exitCode?: number;
+    signal?: string;
+    errorMessage?: string;
+    stdoutPath?: string;
+    stderrPath?: string;
+    stdoutBytes?: number;
+    stderrBytes?: number;
+    stdoutTruncated?: boolean;
+    stderrTruncated?: boolean;
+    stdoutTail?: string;
+    stderrTail?: string;
+    metadata?: Record<string, unknown>;
+}): Promise<RunStep | null>;
+/**
+ * Mark step as skipped
+ */
+export declare function markSkipped(db: DatabaseAdapter, id: string, reason?: string): Promise<RunStep | null>;
+/**
+ * Mark step as canceled
+ */
+export declare function markCanceled(db: DatabaseAdapter, id: string, reason?: string): Promise<RunStep | null>;
+/**
+ * List steps for a run
+ */
+export declare function listByRun(db: DatabaseAdapter, runId: string, opts?: {
+    attempt?: number;
+    status?: StepStatus | StepStatus[];
+}): Promise<RunStep[]>;
+/**
+ * Get the latest attempt number for a run
+ */
+export declare function getLatestAttempt(db: DatabaseAdapter, runId: string): Promise<number>;
+/**
+ * Get step counts for a run attempt
+ */
+export interface StepCounts {
+    passed: number;
+    failed: number;
+    active: number;
+    skipped: number;
+    total: number;
+}
+export declare function getStepCounts(db: DatabaseAdapter, runId: string, attempt?: number): Promise<StepCounts>;
+/**
+ * Get the first failed step for a run attempt
+ */
+export declare function getFirstFailedStep(db: DatabaseAdapter, runId: string, attempt?: number): Promise<RunStep | null>;
+/**
+ * Get the currently running step for a run
+ */
+export declare function getRunningStep(db: DatabaseAdapter, runId: string, attempt?: number): Promise<RunStep | null>;
+/**
+ * Get run step summary for display
+ */
+export interface StepSummary {
+    runId: string;
+    latestAttempt: number;
+    counts: StepCounts;
+    firstFailedStep: string | null;
+    runningStep: string | null;
+    totalDurationMs: number;
+}
+export declare function getSummary(db: DatabaseAdapter, runId: string): Promise<StepSummary>;
+//# sourceMappingURL=run_steps.d.ts.map

package/dist/repos/run_steps.d.ts.map

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