@jamesaphoenix/tx-types 0.4.1

package/dist/anchor.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Anchor types for tx
+ *
+ * Type definitions for file/code associations (anchors) that link learnings
+ * to specific file locations, symbols, or code regions.
+ * Zero runtime dependencies - pure TypeScript types only.
+ */
+/**
+ * Branded type for anchor IDs.
+ */
+export type AnchorId = number & {
+    readonly _brand: unique symbol;
+};
+/**
+ * Anchor type - how the learning is associated with code.
+ * - glob: Pattern match (e.g., "src/repo/*.ts")
+ * - hash: Content hash of specific lines
+ * - symbol: Named code element (function, class, etc.)
+ * - line_range: Specific line numbers
+ */
+export declare const ANCHOR_TYPES: readonly ["glob", "hash", "symbol", "line_range"];
+export type AnchorType = (typeof ANCHOR_TYPES)[number];
+/**
+ * Anchor status - validity of the file/code association.
+ * - valid: Anchor still points to correct code
+ * - drifted: Code has changed but anchor still exists
+ * - invalid: Anchor no longer valid (file deleted, symbol removed)
+ */
+export declare const ANCHOR_STATUSES: readonly ["valid", "drifted", "invalid"];
+export type AnchorStatus = (typeof ANCHOR_STATUSES)[number];
+/**
+ * Anchor entity - links a learning to a file/code location.
+ */
+export interface Anchor {
+    readonly id: AnchorId;
+    readonly learningId: number;
+    readonly anchorType: AnchorType;
+    readonly anchorValue: string;
+    readonly filePath: string;
+    readonly symbolFqname: string | null;
+    readonly lineStart: number | null;
+    readonly lineEnd: number | null;
+    readonly contentHash: string | null;
+    /** Original content preview for self-healing Jaccard similarity comparison */
+    readonly contentPreview: string | null;
+    readonly status: AnchorStatus;
+    readonly pinned: boolean;
+    readonly verifiedAt: Date | null;
+    readonly createdAt: Date;
+}
+/**
+ * Input for creating a new anchor.
+ */
+export interface CreateAnchorInput {
+    readonly learningId: number;
+    readonly anchorType: AnchorType;
+    readonly anchorValue: string;
+    readonly filePath: string;
+    readonly symbolFqname?: string | null;
+    readonly lineStart?: number | null;
+    readonly lineEnd?: number | null;
+    readonly contentHash?: string | null;
+    /** Original content preview for self-healing comparison (max ~500 chars) */
+    readonly contentPreview?: string | null;
+}
+/**
+ * Input for updating an anchor.
+ */
+export interface UpdateAnchorInput {
+    readonly anchorValue?: string;
+    readonly filePath?: string;
+    readonly symbolFqname?: string | null;
+    readonly lineStart?: number | null;
+    readonly lineEnd?: number | null;
+    readonly contentHash?: string | null;
+    /** Updated content preview for self-healing comparison */
+    readonly contentPreview?: string | null;
+    readonly status?: AnchorStatus;
+    readonly verifiedAt?: Date | null;
+}
+/**
+ * Database row type for anchors (snake_case from SQLite).
+ */
+export interface AnchorRow {
+    id: number;
+    learning_id: number;
+    anchor_type: string;
+    anchor_value: string;
+    file_path: string;
+    symbol_fqname: string | null;
+    line_start: number | null;
+    line_end: number | null;
+    content_hash: string | null;
+    content_preview: string | null;
+    status: string;
+    pinned: number;
+    verified_at: string | null;
+    created_at: string;
+}
+/**
+ * Detection source for invalidation.
+ */
+export declare const INVALIDATION_SOURCES: readonly ["periodic", "lazy", "manual", "agent", "git_hook"];
+export type InvalidationSource = (typeof INVALIDATION_SOURCES)[number];
+/**
+ * Invalidation log entry - tracks anchor status changes.
+ */
+export interface InvalidationLog {
+    readonly id: number;
+    readonly anchorId: number;
+    readonly oldStatus: AnchorStatus;
+    readonly newStatus: AnchorStatus;
+    readonly reason: string;
+    readonly detectedBy: InvalidationSource;
+    readonly oldContentHash: string | null;
+    readonly newContentHash: string | null;
+    readonly similarityScore: number | null;
+    readonly invalidatedAt: Date;
+}
+/**
+ * Database row type for invalidation log (snake_case from SQLite).
+ */
+export interface InvalidationLogRow {
+    id: number;
+    anchor_id: number;
+    old_status: string;
+    new_status: string;
+    reason: string;
+    detected_by: string;
+    old_content_hash: string | null;
+    new_content_hash: string | null;
+    similarity_score: number | null;
+    invalidated_at: string;
+}
+/**
+ * Anchor with freshness information for lazy verification.
+ * Returned by getWithVerification - includes whether anchor was fresh or verified.
+ */
+export interface AnchorWithFreshness {
+    readonly anchor: Anchor;
+    /** True if anchor was still within TTL, false if verification was needed */
+    readonly isFresh: boolean;
+    /** True if verification was performed (because anchor was stale) */
+    readonly wasVerified: boolean;
+    /** Verification result if verification was performed */
+    readonly verificationResult?: {
+        readonly previousStatus: AnchorStatus;
+        readonly newStatus: AnchorStatus;
+        readonly action: "unchanged" | "self_healed" | "drifted" | "invalidated";
+        readonly reason?: string;
+    };
+}
+//# sourceMappingURL=anchor.d.ts.map

package/dist/anchor.d.ts.map

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

package/dist/anchor.js

@@ -0,0 +1,27 @@
+/**
+ * Anchor types for tx
+ *
+ * Type definitions for file/code associations (anchors) that link learnings
+ * to specific file locations, symbols, or code regions.
+ * Zero runtime dependencies - pure TypeScript types only.
+ */
+/**
+ * Anchor type - how the learning is associated with code.
+ * - glob: Pattern match (e.g., "src/repo/*.ts")
+ * - hash: Content hash of specific lines
+ * - symbol: Named code element (function, class, etc.)
+ * - line_range: Specific line numbers
+ */
+export const ANCHOR_TYPES = ["glob", "hash", "symbol", "line_range"];
+/**
+ * Anchor status - validity of the file/code association.
+ * - valid: Anchor still points to correct code
+ * - drifted: Code has changed but anchor still exists
+ * - invalid: Anchor no longer valid (file deleted, symbol removed)
+ */
+export const ANCHOR_STATUSES = ["valid", "drifted", "invalid"];
+/**
+ * Detection source for invalidation.
+ */
+export const INVALIDATION_SOURCES = ["periodic", "lazy", "manual", "agent", "git_hook"];
+//# sourceMappingURL=anchor.js.map

package/dist/anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.js","sourceRoot":"","sources":["../src/anchor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAG9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AA4ExE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC"}

package/dist/attempt.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Attempt types for tx
+ *
+ * Type definitions for tracking task approach outcomes.
+ * Zero runtime dependencies - pure TypeScript types only.
+ */
+import type { TaskId } from "./task.js";
+/**
+ * Valid attempt outcomes.
+ */
+export declare const ATTEMPT_OUTCOMES: readonly ["failed", "succeeded"];
+/**
+ * Attempt outcome - whether the approach failed or succeeded.
+ */
+export type AttemptOutcome = (typeof ATTEMPT_OUTCOMES)[number];
+/**
+ * Branded type for attempt IDs.
+ */
+export type AttemptId = number & {
+    readonly _brand: unique symbol;
+};
+/**
+ * Attempt entity - records a specific approach tried for a task.
+ */
+export interface Attempt {
+    readonly id: AttemptId;
+    readonly taskId: TaskId;
+    readonly approach: string;
+    readonly outcome: AttemptOutcome;
+    readonly reason: string | null;
+    readonly createdAt: Date;
+}
+/**
+ * Input for creating a new attempt.
+ */
+export interface CreateAttemptInput {
+    readonly taskId: string;
+    readonly approach: string;
+    readonly outcome: AttemptOutcome;
+    readonly reason?: string | null;
+}
+/**
+ * Database row type for attempts (snake_case from SQLite).
+ */
+export interface AttemptRow {
+    id: number;
+    task_id: string;
+    approach: string;
+    outcome: string;
+    reason: string | null;
+    created_at: string;
+}
+//# sourceMappingURL=attempt.d.ts.map

package/dist/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../src/attempt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,gBAAgB,kCAAmC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/attempt.js

@@ -0,0 +1,11 @@
+/**
+ * Attempt types for tx
+ *
+ * Type definitions for tracking task approach outcomes.
+ * Zero runtime dependencies - pure TypeScript types only.
+ */
+/**
+ * Valid attempt outcomes.
+ */
+export const ATTEMPT_OUTCOMES = ["failed", "succeeded"];
+//# sourceMappingURL=attempt.js.map

package/dist/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../src/attempt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAC"}

package/dist/candidate.d.ts

@@ -0,0 +1,203 @@
+/**
+ * @tx/types/candidate - Learning candidate types for transcript extraction
+ *
+ * Learning candidates are potential learnings extracted from Claude Code
+ * transcripts that await promotion to the learnings table.
+ *
+ * @see PRD-015 for the JSONL daemon and knowledge promotion pipeline
+ */
+/**
+ * Confidence level for extracted learning candidates.
+ *
+ * - high: Tested in session with clear outcome - auto-promotable
+ * - medium: Reasonable but unverified - needs review
+ * - low: Speculative or edge case - needs review
+ */
+export type CandidateConfidence = "high" | "medium" | "low";
+/**
+ * All valid confidence levels.
+ */
+export declare const CANDIDATE_CONFIDENCES: readonly ["high", "medium", "low"];
+/**
+ * Category of the extracted learning.
+ * Helps organize and filter learnings by domain.
+ */
+export type CandidateCategory = "architecture" | "testing" | "performance" | "security" | "debugging" | "tooling" | "patterns" | "other";
+/**
+ * All valid candidate categories.
+ */
+export declare const CANDIDATE_CATEGORIES: readonly ["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"];
+/**
+ * Status of a learning candidate in the promotion pipeline.
+ *
+ * - pending: Awaiting review or auto-promotion
+ * - promoted: Successfully promoted to learnings table
+ * - rejected: Manually rejected by reviewer
+ * - merged: Merged with existing similar learning
+ */
+export type CandidateStatus = "pending" | "promoted" | "rejected" | "merged";
+/**
+ * All valid candidate statuses.
+ */
+export declare const CANDIDATE_STATUSES: readonly ["pending", "promoted", "rejected", "merged"];
+/**
+ * A chunk of transcript content to be analyzed for learning extraction.
+ * Used as input to the CandidateExtractor.
+ */
+export interface TranscriptChunk {
+    /** The transcript text content to analyze */
+    readonly content: string;
+    /** Source file path (e.g., ~/.claude/projects/foo/session.jsonl) */
+    readonly sourceFile: string;
+    /** Optional run ID for provenance tracking */
+    readonly sourceRunId?: string | null;
+    /** Optional task ID for provenance tracking */
+    readonly sourceTaskId?: string | null;
+    /** Byte offset in source file (for incremental processing) */
+    readonly byteOffset?: number;
+    /** Line number range in source file */
+    readonly lineRange?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * A learning candidate extracted from a transcript by the LLM.
+ * This is the raw extraction output before database storage.
+ */
+export interface ExtractedCandidate {
+    /** The learning text (1-3 sentences, actionable) */
+    readonly content: string;
+    /** Confidence level assigned by the LLM */
+    readonly confidence: CandidateConfidence;
+    /** Category of the learning */
+    readonly category: CandidateCategory;
+}
+/**
+ * Unique identifier for a stored learning candidate.
+ */
+export type CandidateId = number;
+/**
+ * A learning candidate stored in the database.
+ * Extends ExtractedCandidate with storage metadata.
+ */
+export interface LearningCandidate {
+    /** Unique database ID */
+    readonly id: CandidateId;
+    /** The learning text (1-3 sentences, actionable) */
+    readonly content: string;
+    /** Confidence level assigned by the LLM */
+    readonly confidence: CandidateConfidence;
+    /** Category of the learning */
+    readonly category: CandidateCategory | null;
+    /** Source JSONL file path */
+    readonly sourceFile: string;
+    /** Source run ID for provenance */
+    readonly sourceRunId: string | null;
+    /** Source task ID for provenance */
+    readonly sourceTaskId: string | null;
+    /** When the candidate was extracted */
+    readonly extractedAt: Date;
+    /** Current status in promotion pipeline */
+    readonly status: CandidateStatus;
+    /** When the candidate was reviewed */
+    readonly reviewedAt: Date | null;
+    /** Who reviewed ('auto' or user identifier) */
+    readonly reviewedBy: string | null;
+    /** ID of promoted learning (if promoted or merged) */
+    readonly promotedLearningId: number | null;
+    /** Reason for rejection (if rejected) */
+    readonly rejectionReason: string | null;
+}
+/**
+ * Input for creating a new learning candidate.
+ */
+export interface CreateCandidateInput {
+    /** The learning text */
+    readonly content: string;
+    /** Confidence level */
+    readonly confidence: CandidateConfidence;
+    /** Category of the learning */
+    readonly category?: CandidateCategory | null;
+    /** Source file path */
+    readonly sourceFile: string;
+    /** Source run ID */
+    readonly sourceRunId?: string | null;
+    /** Source task ID */
+    readonly sourceTaskId?: string | null;
+}
+/**
+ * Input for updating a learning candidate.
+ */
+export interface UpdateCandidateInput {
+    /** New status */
+    readonly status?: CandidateStatus;
+    /** Review timestamp */
+    readonly reviewedAt?: Date;
+    /** Reviewer identifier */
+    readonly reviewedBy?: string;
+    /** Promoted learning ID */
+    readonly promotedLearningId?: number;
+    /** Rejection reason */
+    readonly rejectionReason?: string;
+}
+/**
+ * Filter options for querying learning candidates.
+ */
+export interface CandidateFilter {
+    /** Filter by status */
+    readonly status?: CandidateStatus | CandidateStatus[];
+    /** Filter by confidence */
+    readonly confidence?: CandidateConfidence | CandidateConfidence[];
+    /** Filter by category */
+    readonly category?: CandidateCategory | CandidateCategory[];
+    /** Filter by source file */
+    readonly sourceFile?: string;
+    /** Filter by source run ID */
+    readonly sourceRunId?: string;
+    /** Filter by source task ID */
+    readonly sourceTaskId?: string;
+    /** Maximum results */
+    readonly limit?: number;
+    /** Offset for pagination */
+    readonly offset?: number;
+}
+/**
+ * Result of candidate extraction from a transcript chunk.
+ */
+export interface ExtractionResult {
+    /** Extracted candidates */
+    readonly candidates: readonly ExtractedCandidate[];
+    /** Source chunk that was processed */
+    readonly sourceChunk: TranscriptChunk;
+    /** Whether extraction was performed (false if using noop) */
+    readonly wasExtracted: boolean;
+    /** Processing metadata */
+    readonly metadata?: {
+        /** Model used for extraction */
+        readonly model?: string;
+        /** Tokens used (input + output) */
+        readonly tokensUsed?: number;
+        /** Processing duration in milliseconds */
+        readonly durationMs?: number;
+    };
+}
+/**
+ * Database row representation for learning_candidates table.
+ */
+export interface CandidateRow {
+    readonly id: number;
+    readonly content: string;
+    readonly confidence: string;
+    readonly category: string | null;
+    readonly source_file: string;
+    readonly source_run_id: string | null;
+    readonly source_task_id: string | null;
+    readonly extracted_at: string;
+    readonly status: string;
+    readonly reviewed_at: string | null;
+    readonly reviewed_by: string | null;
+    readonly promoted_learning_id: number | null;
+    readonly rejection_reason: string | null;
+}
+//# sourceMappingURL=candidate.d.ts.map

package/dist/candidate.d.ts.map

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

package/dist/candidate.js

@@ -0,0 +1,30 @@
+/**
+ * @tx/types/candidate - Learning candidate types for transcript extraction
+ *
+ * Learning candidates are potential learnings extracted from Claude Code
+ * transcripts that await promotion to the learnings table.
+ *
+ * @see PRD-015 for the JSONL daemon and knowledge promotion pipeline
+ */
+/**
+ * All valid confidence levels.
+ */
+export const CANDIDATE_CONFIDENCES = ["high", "medium", "low"];
+/**
+ * All valid candidate categories.
+ */
+export const CANDIDATE_CATEGORIES = [
+    "architecture",
+    "testing",
+    "performance",
+    "security",
+    "debugging",
+    "tooling",
+    "patterns",
+    "other"
+];
+/**
+ * All valid candidate statuses.
+ */
+export const CANDIDATE_STATUSES = ["pending", "promoted", "rejected", "merged"];
+//# sourceMappingURL=candidate.js.map

package/dist/candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.js","sourceRoot":"","sources":["../src/candidate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA;AAgBvE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,SAAS;IACT,aAAa;IACb,UAAU;IACV,WAAW;IACX,SAAS;IACT,UAAU;IACV,OAAO;CACC,CAAA;AAYV;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAA"}

package/dist/deduplication.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Deduplication types for tx
+ *
+ * Type definitions for JSONL line deduplication and file progress tracking.
+ * Used by the telemetry daemon to avoid re-processing already-seen content.
+ * Zero runtime dependencies - pure TypeScript types only.
+ */
+/**
+ * Processed hash ID (auto-incremented integer).
+ */
+export type ProcessedHashId = number;
+/**
+ * A processed JSONL line hash record.
+ * Tracks unique content by SHA256 hash for deduplication.
+ */
+export interface ProcessedHash {
+    readonly id: ProcessedHashId;
+    readonly contentHash: string;
+    readonly sourceFile: string;
+    readonly sourceLine: number;
+    readonly processedAt: Date;
+}
+/**
+ * Input for recording a processed hash.
+ */
+export interface CreateProcessedHashInput {
+    readonly contentHash: string;
+    readonly sourceFile: string;
+    readonly sourceLine: number;
+}
+/**
+ * Database row type for processed_hashes (snake_case from SQLite).
+ */
+export interface ProcessedHashRow {
+    id: number;
+    content_hash: string;
+    source_file: string;
+    source_line: number;
+    processed_at: string;
+}
+/**
+ * File progress ID (auto-incremented integer).
+ */
+export type FileProgressId = number;
+/**
+ * File processing progress record.
+ * Tracks how far we've processed a JSONL file for incremental processing.
+ */
+export interface FileProgress {
+    readonly id: FileProgressId;
+    readonly filePath: string;
+    readonly lastLineProcessed: number;
+    readonly lastByteOffset: number;
+    readonly fileSize: number | null;
+    readonly fileChecksum: string | null;
+    readonly lastProcessedAt: Date;
+}
+/**
+ * Input for creating/updating file progress.
+ */
+export interface UpsertFileProgressInput {
+    readonly filePath: string;
+    readonly lastLineProcessed: number;
+    readonly lastByteOffset: number;
+    readonly fileSize?: number;
+    readonly fileChecksum?: string;
+}
+/**
+ * Database row type for file_progress (snake_case from SQLite).
+ */
+export interface FileProgressRow {
+    id: number;
+    file_path: string;
+    last_line_processed: number;
+    last_byte_offset: number;
+    file_size: number | null;
+    file_checksum: string | null;
+    last_processed_at: string;
+}
+/**
+ * Result of checking if a hash exists.
+ */
+export interface HashCheckResult {
+    readonly exists: boolean;
+    readonly hash: string;
+}
+/**
+ * Result of processing a JSONL line.
+ */
+export interface LineProcessResult {
+    readonly hash: string;
+    readonly isNew: boolean;
+    readonly lineNumber: number;
+    readonly content: string;
+}
+/**
+ * Result of processing a file.
+ */
+export interface FileProcessResult {
+    readonly filePath: string;
+    readonly totalLines: number;
+    readonly newLines: number;
+    readonly skippedLines: number;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly duration: number;
+}
+/**
+ * Options for deduplication processing.
+ */
+export interface DeduplicationOptions {
+    readonly batchSize?: number;
+    readonly startLine?: number;
+    readonly maxLines?: number;
+}
+//# sourceMappingURL=deduplication.d.ts.map

package/dist/deduplication.d.ts.map

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

package/dist/deduplication.js

@@ -0,0 +1,9 @@
+/**
+ * Deduplication types for tx
+ *
+ * Type definitions for JSONL line deduplication and file progress tracking.
+ * Used by the telemetry daemon to avoid re-processing already-seen content.
+ * Zero runtime dependencies - pure TypeScript types only.
+ */
+export {};
+//# sourceMappingURL=deduplication.js.map

package/dist/deduplication.js.map

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