@jamesaphoenix/tx-core 0.4.2 → 0.4.3

package/dist/services/transcript-adapter.d.ts

@@ -0,0 +1,99 @@
+/**
+ * TranscriptAdapter - Abstracts parsing of LLM transcript formats.
+ *
+ * Different LLM tools produce different transcript formats:
+ * - Claude Code: JSONL with stream-json format
+ * - Future: Codex, Cursor, custom agents
+ *
+ * Adapters provide a unified interface for extracting tool calls
+ * and messages regardless of the source format.
+ *
+ * → DD-019: Primitive 3 (Transcript Adapters)
+ */
+/**
+ * Represents a parsed tool call from a transcript.
+ */
+export interface ToolCall {
+    /** ISO timestamp of when the tool call occurred */
+    readonly timestamp: string;
+    /** Name of the tool (e.g., "Read", "Bash", "Edit") */
+    readonly name: string;
+    /** Input parameters passed to the tool */
+    readonly input: Record<string, unknown>;
+    /** Tool call ID for correlation with results */
+    readonly id?: string;
+    /** Result of the tool call, if available */
+    readonly result?: string;
+}
+/**
+ * Represents a parsed message from a transcript.
+ */
+export interface Message {
+    /** ISO timestamp of when the message occurred */
+    readonly timestamp: string;
+    /** Role of the message sender */
+    readonly role: "user" | "assistant";
+    /** Text content of the message */
+    readonly content: string;
+}
+/**
+ * Interface for adapters that parse different transcript formats.
+ * Implement this to support new LLM tools.
+ */
+export interface TranscriptAdapter {
+    /**
+     * Parse tool calls from transcript lines.
+     * @param lines - Raw JSONL lines from the transcript file
+     * @returns Array of parsed tool calls
+     */
+    readonly parseToolCalls: (lines: readonly string[]) => readonly ToolCall[];
+    /**
+     * Parse messages from transcript lines.
+     * @param lines - Raw JSONL lines from the transcript file
+     * @returns Array of parsed messages
+     */
+    readonly parseMessages: (lines: readonly string[]) => readonly Message[];
+    /**
+     * Check if this adapter can handle the given agent type.
+     * Used for adapter registry selection.
+     * @param agentType - The agent type from runs.agent column
+     * @returns true if this adapter can parse transcripts from this agent
+     */
+    readonly canHandle: (agentType: string) => boolean;
+}
+/**
+ * ClaudeCodeAdapter - Parses Claude Code's --output-format stream-json.
+ *
+ * Format details:
+ * - Each line is a JSON object with a top-level `type` field
+ * - Tool calls: type="assistant" with message.content[].type="tool_use"
+ * - Messages: type="user" or type="assistant"
+ * - Timestamps are at the top level
+ */
+export declare const ClaudeCodeAdapter: TranscriptAdapter;
+/**
+ * GenericJSONLAdapter - Fallback adapter for unknown JSONL formats.
+ *
+ * Attempts to parse common patterns:
+ * - Tool calls: entries with `tool`, `name`, or `function` fields
+ * - Messages: entries with `role` or `type` indicating user/assistant
+ *
+ * Less strict parsing to handle various custom formats.
+ */
+export declare const GenericJSONLAdapter: TranscriptAdapter;
+/**
+ * Get the appropriate adapter for the given agent type.
+ * Returns GenericJSONLAdapter if no specific adapter matches.
+ *
+ * @param agentType - The agent type from runs.agent column
+ * @returns The adapter to use for parsing transcripts
+ */
+export declare function getAdapter(agentType: string): TranscriptAdapter;
+/**
+ * Register a custom adapter at the beginning of the registry.
+ * Custom adapters take precedence over built-in ones.
+ *
+ * @param adapter - The adapter to register
+ */
+export declare function registerAdapter(adapter: TranscriptAdapter): void;
+//# sourceMappingURL=transcript-adapter.d.ts.map

package/dist/services/transcript-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-adapter.d.ts","sourceRoot":"","sources":["../../src/services/transcript-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,QAAQ,EAAE,CAAA;IAE1E;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,OAAO,EAAE,CAAA;IAExE;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;CACnD;AAkDD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBA6I/B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAoEjC,CAAA;AAaD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAGhE"}

package/dist/services/transcript-adapter.js

@@ -0,0 +1,283 @@
+/**
+ * TranscriptAdapter - Abstracts parsing of LLM transcript formats.
+ *
+ * Different LLM tools produce different transcript formats:
+ * - Claude Code: JSONL with stream-json format
+ * - Future: Codex, Cursor, custom agents
+ *
+ * Adapters provide a unified interface for extracting tool calls
+ * and messages regardless of the source format.
+ *
+ * → DD-019: Primitive 3 (Transcript Adapters)
+ */
+/**
+ * Helper to safely parse a JSON line, returning null for empty or non-JSON lines.
+ * Only catches SyntaxError from JSON.parse; unexpected errors are re-thrown.
+ */
+const safeParseJson = (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            return null;
+        }
+        // eslint-disable-next-line tx/no-throw-in-services -- Re-throw unexpected non-SyntaxError; this is a non-Effect utility helper
+        throw error;
+    }
+};
+/**
+ * Extract text content from Claude Code message content array.
+ * Content can be a string or an array of content blocks.
+ */
+const extractTextContent = (content) => {
+    if (typeof content === "string") {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        return content
+            .filter((block) => typeof block === "object" && block !== null)
+            .map((block) => {
+            if (block.type === "text" && typeof block.text === "string") {
+                return block.text;
+            }
+            if (block.type === "thinking" && typeof block.thinking === "string") {
+                return block.thinking;
+            }
+            return "";
+        })
+            .filter(Boolean)
+            .join("\n");
+    }
+    return "";
+};
+/**
+ * ClaudeCodeAdapter - Parses Claude Code's --output-format stream-json.
+ *
+ * Format details:
+ * - Each line is a JSON object with a top-level `type` field
+ * - Tool calls: type="assistant" with message.content[].type="tool_use"
+ * - Messages: type="user" or type="assistant"
+ * - Timestamps are at the top level
+ */
+export const ClaudeCodeAdapter = {
+    canHandle: (agentType) => agentType.includes("claude") ||
+        agentType.includes("tx-") ||
+        agentType === "claude-code",
+    parseToolCalls: (lines) => {
+        const toolCalls = [];
+        const toolResults = new Map();
+        // First pass: collect tool results
+        for (const line of lines) {
+            const entry = safeParseJson(line);
+            if (!entry)
+                continue;
+            // Tool results come as type="user" with content[].type="tool_result"
+            if (entry.type === "user") {
+                const message = entry.message;
+                const content = message?.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (typeof block === "object" &&
+                            block !== null &&
+                            block.type === "tool_result") {
+                            const toolResult = block;
+                            const toolUseId = toolResult.tool_use_id;
+                            const resultContent = toolResult.content;
+                            if (toolUseId && typeof resultContent === "string") {
+                                toolResults.set(toolUseId, resultContent);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Second pass: collect tool calls
+        for (const line of lines) {
+            const entry = safeParseJson(line);
+            if (!entry)
+                continue;
+            // Tool calls come as type="assistant" with content[].type="tool_use"
+            if (entry.type === "assistant") {
+                const timestamp = entry.timestamp ?? new Date().toISOString();
+                const message = entry.message;
+                const content = message?.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (typeof block === "object" &&
+                            block !== null &&
+                            block.type === "tool_use") {
+                            const toolUse = block;
+                            const id = toolUse.id;
+                            const name = toolUse.name;
+                            const input = toolUse.input ?? {};
+                            if (name) {
+                                toolCalls.push({
+                                    timestamp,
+                                    name,
+                                    input,
+                                    id,
+                                    result: id ? toolResults.get(id) : undefined
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return toolCalls;
+    },
+    parseMessages: (lines) => {
+        const messages = [];
+        for (const line of lines) {
+            const entry = safeParseJson(line);
+            if (!entry)
+                continue;
+            const timestamp = entry.timestamp ?? new Date().toISOString();
+            if (entry.type === "user") {
+                const message = entry.message;
+                if (!message)
+                    continue;
+                // Skip tool results - those are handled in parseToolCalls
+                const content = message.content;
+                if (Array.isArray(content)) {
+                    const hasOnlyToolResults = content.every((block) => typeof block === "object" &&
+                        block !== null &&
+                        block.type === "tool_result");
+                    if (hasOnlyToolResults)
+                        continue;
+                }
+                const text = extractTextContent(message.content);
+                if (text) {
+                    messages.push({
+                        timestamp,
+                        role: "user",
+                        content: text
+                    });
+                }
+            }
+            else if (entry.type === "assistant") {
+                const message = entry.message;
+                if (!message)
+                    continue;
+                // Skip entries that only contain tool_use blocks
+                const content = message.content;
+                if (Array.isArray(content)) {
+                    const hasOnlyToolUse = content.every((block) => typeof block === "object" &&
+                        block !== null &&
+                        block.type === "tool_use");
+                    if (hasOnlyToolUse)
+                        continue;
+                }
+                const text = extractTextContent(message.content);
+                if (text) {
+                    messages.push({
+                        timestamp,
+                        role: "assistant",
+                        content: text
+                    });
+                }
+            }
+        }
+        return messages;
+    }
+};
+/**
+ * GenericJSONLAdapter - Fallback adapter for unknown JSONL formats.
+ *
+ * Attempts to parse common patterns:
+ * - Tool calls: entries with `tool`, `name`, or `function` fields
+ * - Messages: entries with `role` or `type` indicating user/assistant
+ *
+ * Less strict parsing to handle various custom formats.
+ */
+export const GenericJSONLAdapter = {
+    canHandle: () => true, // Always matches as fallback
+    parseToolCalls: (lines) => {
+        const toolCalls = [];
+        for (const line of lines) {
+            const entry = safeParseJson(line);
+            if (!entry)
+                continue;
+            // Look for common tool call patterns
+            const name = entry.tool ??
+                entry.name ??
+                entry.function ??
+                entry.tool_call?.name;
+            if (name) {
+                toolCalls.push({
+                    timestamp: entry.timestamp ?? new Date().toISOString(),
+                    name,
+                    input: entry.input ??
+                        entry.args ??
+                        entry.arguments ??
+                        entry.tool_call
+                            ?.arguments ??
+                        {},
+                    id: entry.id,
+                    result: entry.result
+                });
+            }
+        }
+        return toolCalls;
+    },
+    parseMessages: (lines) => {
+        const messages = [];
+        for (const line of lines) {
+            const entry = safeParseJson(line);
+            if (!entry)
+                continue;
+            // Determine role from common patterns
+            const role = entry.role ??
+                entry.type ??
+                entry.sender;
+            if (role === "user" || role === "assistant") {
+                const content = entry.content ??
+                    entry.text ??
+                    entry.message;
+                if (content) {
+                    messages.push({
+                        timestamp: entry.timestamp ?? new Date().toISOString(),
+                        role,
+                        content
+                    });
+                }
+            }
+        }
+        return messages;
+    }
+};
+/**
+ * Registry of available transcript adapters.
+ * Order matters - first matching adapter is used.
+ * Mutable array to allow runtime registration of custom adapters.
+ */
+const adapters = [
+    ClaudeCodeAdapter,
+    // Future: CodexAdapter, CursorAdapter, etc.
+    GenericJSONLAdapter // Fallback - always matches
+];
+/**
+ * Get the appropriate adapter for the given agent type.
+ * Returns GenericJSONLAdapter if no specific adapter matches.
+ *
+ * @param agentType - The agent type from runs.agent column
+ * @returns The adapter to use for parsing transcripts
+ */
+export function getAdapter(agentType) {
+    return adapters.find((a) => a.canHandle(agentType)) ?? GenericJSONLAdapter;
+}
+/**
+ * Register a custom adapter at the beginning of the registry.
+ * Custom adapters take precedence over built-in ones.
+ *
+ * @param adapter - The adapter to register
+ */
+export function registerAdapter(adapter) {
+    // Insert at the beginning, before GenericJSONLAdapter fallback
+    adapters.unshift(adapter);
+}
+//# sourceMappingURL=transcript-adapter.js.map

package/dist/services/transcript-adapter.js.map

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

package/dist/services/validation-service.d.ts

@@ -0,0 +1,85 @@
+import { Context, Effect, Layer } from "effect";
+import { SqliteClient } from "../db.js";
+import { DatabaseError } from "../errors.js";
+/**
+ * Severity level for validation issues.
+ */
+export type ValidationSeverity = "error" | "warning" | "info";
+/**
+ * A single validation issue found during validation.
+ */
+export interface ValidationIssue {
+    readonly check: string;
+    readonly severity: ValidationSeverity;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+}
+/**
+ * Result of a single validation check.
+ */
+export interface CheckResult {
+    readonly name: string;
+    readonly passed: boolean;
+    readonly issues: readonly ValidationIssue[];
+    readonly fixable: boolean;
+    readonly fixed?: number;
+}
+/**
+ * Overall validation result.
+ */
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly checks: readonly CheckResult[];
+    readonly issueCount: {
+        readonly error: number;
+        readonly warning: number;
+        readonly info: number;
+    };
+    readonly fixedCount: number;
+}
+/**
+ * Options for running validation.
+ */
+export interface ValidateOptions {
+    readonly fix?: boolean;
+}
+declare const ValidationService_base: Context.TagClass<ValidationService, "ValidationService", {
+    /**
+     * Run all validation checks.
+     * Returns a summary of issues found.
+     */
+    readonly validate: (options?: ValidateOptions) => Effect.Effect<ValidationResult, DatabaseError>;
+    /**
+     * Run SQLite integrity check.
+     */
+    readonly checkIntegrity: () => Effect.Effect<CheckResult, DatabaseError>;
+    /**
+     * Verify schema version matches latest migration.
+     */
+    readonly checkSchemaVersion: () => Effect.Effect<CheckResult, DatabaseError>;
+    /**
+     * Check foreign key constraints.
+     */
+    readonly checkForeignKeys: () => Effect.Effect<CheckResult, DatabaseError>;
+    /**
+     * Detect orphaned dependencies (referencing non-existent tasks).
+     */
+    readonly checkOrphanedDependencies: (fix?: boolean) => Effect.Effect<CheckResult, DatabaseError>;
+    /**
+     * Scan for invalid status values.
+     */
+    readonly checkInvalidStatuses: (fix?: boolean) => Effect.Effect<CheckResult, DatabaseError>;
+    /**
+     * Check for missing task references in parent_id.
+     */
+    readonly checkMissingParentRefs: (fix?: boolean) => Effect.Effect<CheckResult, DatabaseError>;
+}>;
+/**
+ * ValidationService performs pre-flight database checks.
+ * Follows Effect-TS patterns per DD-002.
+ */
+export declare class ValidationService extends ValidationService_base {
+}
+export declare const ValidationServiceLive: Layer.Layer<ValidationService, never, SqliteClient>;
+export {};
+//# sourceMappingURL=validation-service.d.ts.map

package/dist/services/validation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-service.d.ts","sourceRoot":"","sources":["../../src/services/validation-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAI5C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CACvB;;IASG;;;OAGG;uBACgB,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC;IAEhG;;OAEG;6BACsB,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;IAExE;;OAEG;iCAC0B,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;IAE5E;;OAEG;+BACwB,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;IAE1E;;OAEG;wCACiC,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;IAEhG;;OAEG;mCAC4B,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;IAE3F;;OAEG;qCAC8B,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;;AAzCjG;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,sBAuCpC;CAAG;AAEN,eAAO,MAAM,qBAAqB,qDAyUjC,CAAA"}