@jamesaphoenix/tx-types 0.4.4 → 0.5.0

package/dist/anchor.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Anchor types for tx
+ *
+ * Type definitions for file/code associations (anchors) that link learnings
+ * to specific file locations, symbols, or code regions.
+ * Core type definitions using Effect Schema (Doctrine Rule 10).
+ * Schema definitions provide both compile-time types and runtime validation.
+ */
+import { Schema } from "effect";
+/**
+ * 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"];
+/**
+ * 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"];
+/**
+ * Detection source for invalidation.
+ */
+export declare const INVALIDATION_SOURCES: readonly ["periodic", "lazy", "manual", "agent", "git_hook"];
+/** Anchor ID - branded integer. */
+export declare const AnchorIdSchema: Schema.brand<Schema.filter<typeof Schema.Number>, "AnchorId">;
+export type AnchorId = typeof AnchorIdSchema.Type;
+/** Anchor type schema. */
+export declare const AnchorTypeSchema: Schema.Literal<["glob", "hash", "symbol", "line_range"]>;
+export type AnchorType = typeof AnchorTypeSchema.Type;
+/** Anchor status schema. */
+export declare const AnchorStatusSchema: Schema.Literal<["valid", "drifted", "invalid"]>;
+export type AnchorStatus = typeof AnchorStatusSchema.Type;
+/** Invalidation source schema. */
+export declare const InvalidationSourceSchema: Schema.Literal<["periodic", "lazy", "manual", "agent", "git_hook"]>;
+export type InvalidationSource = typeof InvalidationSourceSchema.Type;
+/** Anchor entity - links a learning to a file/code location. */
+export declare const AnchorSchema: Schema.Struct<{
+    id: Schema.brand<Schema.filter<typeof Schema.Number>, "AnchorId">;
+    learningId: Schema.filter<typeof Schema.Number>;
+    anchorType: Schema.Literal<["glob", "hash", "symbol", "line_range"]>;
+    anchorValue: typeof Schema.String;
+    filePath: typeof Schema.String;
+    symbolFqname: Schema.NullOr<typeof Schema.String>;
+    lineStart: Schema.NullOr<Schema.filter<typeof Schema.Number>>;
+    lineEnd: Schema.NullOr<Schema.filter<typeof Schema.Number>>;
+    contentHash: Schema.NullOr<typeof Schema.String>;
+    /** Original content preview for self-healing Jaccard similarity comparison */
+    contentPreview: Schema.NullOr<typeof Schema.String>;
+    status: Schema.Literal<["valid", "drifted", "invalid"]>;
+    pinned: typeof Schema.Boolean;
+    verifiedAt: Schema.NullOr<typeof Schema.DateFromSelf>;
+    createdAt: typeof Schema.DateFromSelf;
+}>;
+export type Anchor = typeof AnchorSchema.Type;
+/** Input for creating a new anchor. */
+export declare const CreateAnchorInputSchema: Schema.Struct<{
+    learningId: Schema.filter<typeof Schema.Number>;
+    anchorType: Schema.Literal<["glob", "hash", "symbol", "line_range"]>;
+    anchorValue: typeof Schema.String;
+    filePath: typeof Schema.String;
+    symbolFqname: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    lineStart: Schema.optional<Schema.NullOr<Schema.filter<typeof Schema.Number>>>;
+    lineEnd: Schema.optional<Schema.NullOr<Schema.filter<typeof Schema.Number>>>;
+    contentHash: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** Original content preview for self-healing comparison (max ~500 chars) */
+    contentPreview: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+}>;
+export type CreateAnchorInput = typeof CreateAnchorInputSchema.Type;
+/** Input for updating an anchor. */
+export declare const UpdateAnchorInputSchema: Schema.Struct<{
+    anchorValue: Schema.optional<typeof Schema.String>;
+    filePath: Schema.optional<typeof Schema.String>;
+    symbolFqname: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    lineStart: Schema.optional<Schema.NullOr<Schema.filter<typeof Schema.Number>>>;
+    lineEnd: Schema.optional<Schema.NullOr<Schema.filter<typeof Schema.Number>>>;
+    contentHash: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** Updated content preview for self-healing comparison */
+    contentPreview: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    status: Schema.optional<Schema.Literal<["valid", "drifted", "invalid"]>>;
+    verifiedAt: Schema.optional<Schema.NullOr<typeof Schema.DateFromSelf>>;
+}>;
+export type UpdateAnchorInput = typeof UpdateAnchorInputSchema.Type;
+/** Invalidation log entry - tracks anchor status changes. */
+export declare const InvalidationLogSchema: Schema.Struct<{
+    id: Schema.filter<typeof Schema.Number>;
+    anchorId: Schema.filter<typeof Schema.Number>;
+    oldStatus: Schema.Literal<["valid", "drifted", "invalid"]>;
+    newStatus: Schema.Literal<["valid", "drifted", "invalid"]>;
+    reason: typeof Schema.String;
+    detectedBy: Schema.Literal<["periodic", "lazy", "manual", "agent", "git_hook"]>;
+    oldContentHash: Schema.NullOr<typeof Schema.String>;
+    newContentHash: Schema.NullOr<typeof Schema.String>;
+    similarityScore: Schema.NullOr<typeof Schema.Number>;
+    invalidatedAt: typeof Schema.DateFromSelf;
+}>;
+export type InvalidationLog = typeof InvalidationLogSchema.Type;
+/**
+ * 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;
+    };
+}
+/** 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;
+}
+/** 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;
+}
+//# 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,mDAAoD,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,eAAe,0CAA2C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,8DAA+D,CAAC;AAMjG,mCAAmC;AACnC,eAAO,MAAM,cAAc,+DAG1B,CAAA;AACD,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEjD,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,0DAAkC,CAAA;AAC/D,MAAM,MAAM,UAAU,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAErD,4BAA4B;AAC5B,eAAO,MAAM,kBAAkB,iDAAqC,CAAA;AACpE,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAEzD,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,qEAA0C,CAAA;AAC/E,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA;AAErE,gEAAgE;AAChE,eAAO,MAAM,YAAY;;;;;;;;;;IAUvB,8EAA8E;;;;;;EAM9E,CAAA;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE7C,uCAAuC;AACvC,eAAO,MAAM,uBAAuB;;;;;;;;;IASlC,4EAA4E;;EAE5E,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEnE,oCAAoC;AACpC,eAAO,MAAM,uBAAuB;;;;;;;IAOlC,0DAA0D;;;;EAI1D,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEnE,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;EAWhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAE/D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,kBAAkB,CAAC,EAAE;QAC5B,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;QACtC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;QACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,CAAC;QACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAMD,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/anchor.js

@@ -0,0 +1,100 @@
+/**
+ * Anchor types for tx
+ *
+ * Type definitions for file/code associations (anchors) that link learnings
+ * to specific file locations, symbols, or code regions.
+ * Core type definitions using Effect Schema (Doctrine Rule 10).
+ * Schema definitions provide both compile-time types and runtime validation.
+ */
+import { Schema } from "effect";
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * 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"];
+// =============================================================================
+// SCHEMAS & TYPES
+// =============================================================================
+/** Anchor ID - branded integer. */
+export const AnchorIdSchema = Schema.Number.pipe(Schema.int(), Schema.brand("AnchorId"));
+/** Anchor type schema. */
+export const AnchorTypeSchema = Schema.Literal(...ANCHOR_TYPES);
+/** Anchor status schema. */
+export const AnchorStatusSchema = Schema.Literal(...ANCHOR_STATUSES);
+/** Invalidation source schema. */
+export const InvalidationSourceSchema = Schema.Literal(...INVALIDATION_SOURCES);
+/** Anchor entity - links a learning to a file/code location. */
+export const AnchorSchema = Schema.Struct({
+    id: AnchorIdSchema,
+    learningId: Schema.Number.pipe(Schema.int()),
+    anchorType: AnchorTypeSchema,
+    anchorValue: Schema.String,
+    filePath: Schema.String,
+    symbolFqname: Schema.NullOr(Schema.String),
+    lineStart: Schema.NullOr(Schema.Number.pipe(Schema.int())),
+    lineEnd: Schema.NullOr(Schema.Number.pipe(Schema.int())),
+    contentHash: Schema.NullOr(Schema.String),
+    /** Original content preview for self-healing Jaccard similarity comparison */
+    contentPreview: Schema.NullOr(Schema.String),
+    status: AnchorStatusSchema,
+    pinned: Schema.Boolean,
+    verifiedAt: Schema.NullOr(Schema.DateFromSelf),
+    createdAt: Schema.DateFromSelf,
+});
+/** Input for creating a new anchor. */
+export const CreateAnchorInputSchema = Schema.Struct({
+    learningId: Schema.Number.pipe(Schema.int()),
+    anchorType: AnchorTypeSchema,
+    anchorValue: Schema.String,
+    filePath: Schema.String,
+    symbolFqname: Schema.optional(Schema.NullOr(Schema.String)),
+    lineStart: Schema.optional(Schema.NullOr(Schema.Number.pipe(Schema.int()))),
+    lineEnd: Schema.optional(Schema.NullOr(Schema.Number.pipe(Schema.int()))),
+    contentHash: Schema.optional(Schema.NullOr(Schema.String)),
+    /** Original content preview for self-healing comparison (max ~500 chars) */
+    contentPreview: Schema.optional(Schema.NullOr(Schema.String)),
+});
+/** Input for updating an anchor. */
+export const UpdateAnchorInputSchema = Schema.Struct({
+    anchorValue: Schema.optional(Schema.String),
+    filePath: Schema.optional(Schema.String),
+    symbolFqname: Schema.optional(Schema.NullOr(Schema.String)),
+    lineStart: Schema.optional(Schema.NullOr(Schema.Number.pipe(Schema.int()))),
+    lineEnd: Schema.optional(Schema.NullOr(Schema.Number.pipe(Schema.int()))),
+    contentHash: Schema.optional(Schema.NullOr(Schema.String)),
+    /** Updated content preview for self-healing comparison */
+    contentPreview: Schema.optional(Schema.NullOr(Schema.String)),
+    status: Schema.optional(AnchorStatusSchema),
+    verifiedAt: Schema.optional(Schema.NullOr(Schema.DateFromSelf)),
+});
+/** Invalidation log entry - tracks anchor status changes. */
+export const InvalidationLogSchema = Schema.Struct({
+    id: Schema.Number.pipe(Schema.int()),
+    anchorId: Schema.Number.pipe(Schema.int()),
+    oldStatus: AnchorStatusSchema,
+    newStatus: AnchorStatusSchema,
+    reason: Schema.String,
+    detectedBy: InvalidationSourceSchema,
+    oldContentHash: Schema.NullOr(Schema.String),
+    newContentHash: Schema.NullOr(Schema.String),
+    similarityScore: Schema.NullOr(Schema.Number),
+    invalidatedAt: Schema.DateFromSelf,
+});
+//# sourceMappingURL=anchor.js.map

package/dist/anchor.js.map

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

package/dist/attempt.d.ts

@@ -34,21 +34,6 @@ export declare const CreateAttemptInputSchema: Schema.Struct<{
     reason: Schema.optional<Schema.NullOr<typeof Schema.String>>;
 }>;
 export type CreateAttemptInput = typeof CreateAttemptInputSchema.Type;
-/**
- * Check if a string is a valid attempt outcome.
- */
-export declare const isValidAttemptOutcome: (outcome: string) => outcome is AttemptOutcome;
-/**
- * Error thrown when an attempt outcome is invalid.
- */
-export declare class InvalidAttemptOutcomeError extends Error {
-    readonly outcome: string;
-    constructor(outcome: string);
-}
-/**
- * Validate and return an AttemptOutcome, or throw if invalid.
- */
-export declare const assertAttemptOutcome: (outcome: string) => AttemptOutcome;
 /** Database row type for attempts (snake_case from SQLite). */
 export interface AttemptRow {
     id: number;

package/dist/attempt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../src/attempt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAO/B;;GAEG;AACH,eAAO,MAAM,gBAAgB,kCAAmC,CAAC;AAMjE,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,yCAAsC,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAE7D,oCAAoC;AACpC,eAAO,MAAM,eAAe,gEAG3B,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEnD,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;;;;EAOxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAE/C,wCAAwC;AACxC,eAAO,MAAM,wBAAwB;;;;;EAKnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA;AAMrE;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,KAAG,OAAO,IAAI,cAElE,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aACvB,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAI5C;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,cAKtD,CAAC;AAMF,+DAA+D;AAC/D,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"}
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../src/attempt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAO/B;;GAEG;AACH,eAAO,MAAM,gBAAgB,kCAAmC,CAAC;AAMjE,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,yCAAsC,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAE7D,oCAAoC;AACpC,eAAO,MAAM,eAAe,gEAG3B,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEnD,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;;;;EAOxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAE/C,wCAAwC;AACxC,eAAO,MAAM,wBAAwB;;;;;EAKnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA;AAMrE,+DAA+D;AAC/D,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

@@ -37,33 +37,4 @@ export const CreateAttemptInputSchema = Schema.Struct({
     outcome: AttemptOutcomeSchema,
     reason: Schema.optional(Schema.NullOr(Schema.String)),
 });
-// =============================================================================
-// RUNTIME VALIDATORS
-// =============================================================================
-/**
- * Check if a string is a valid attempt outcome.
- */
-export const isValidAttemptOutcome = (outcome) => {
-    return ATTEMPT_OUTCOMES.includes(outcome);
-};
-/**
- * Error thrown when an attempt outcome is invalid.
- */
-export class InvalidAttemptOutcomeError extends Error {
-    outcome;
-    constructor(outcome) {
-        super(`Invalid attempt outcome: "${outcome}". Valid outcomes: ${ATTEMPT_OUTCOMES.join(", ")}`);
-        this.outcome = outcome;
-        this.name = "InvalidAttemptOutcomeError";
-    }
-}
-/**
- * Validate and return an AttemptOutcome, or throw if invalid.
- */
-export const assertAttemptOutcome = (outcome) => {
-    if (!isValidAttemptOutcome(outcome)) {
-        throw new InvalidAttemptOutcomeError(outcome);
-    }
-    return outcome;
-};
 //# sourceMappingURL=attempt.js.map

package/dist/attempt.js.map

@@ -1 +1 @@
-{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../src/attempt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAC;AAEjE,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAA;AAGvE,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC/C,MAAM,CAAC,GAAG,EAAE,EACZ,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAC1B,CAAA;AAGD,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,eAAe;IACnB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC,YAAY;CAC/B,CAAC,CAAA;AAGF,wCAAwC;AACxC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACtD,CAAC,CAAA;AAGF,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAA6B,EAAE;IAClF,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACvB;IAA5B,YAA4B,OAAe;QACzC,KAAK,CAAC,6BAA6B,OAAO,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QADrE,YAAO,GAAP,OAAO,CAAQ;QAEzC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAkB,EAAE;IACtE,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../src/attempt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAC;AAEjE,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAA;AAGvE,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC/C,MAAM,CAAC,GAAG,EAAE,EACZ,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAC1B,CAAA;AAGD,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,eAAe;IACnB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC,YAAY;CAC/B,CAAC,CAAA;AAGF,wCAAwC;AACxC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACtD,CAAC,CAAA"}

package/dist/candidate.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @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.
+ * Core type definitions using Effect Schema (Doctrine Rule 10).
+ *
+ * @see PRD-015 for the JSONL daemon and knowledge promotion pipeline
+ */
+import { Schema } from "effect";
+/**
+ * All valid confidence levels.
+ */
+export declare const CANDIDATE_CONFIDENCES: readonly ["high", "medium", "low"];
+/**
+ * All valid candidate categories.
+ */
+export declare const CANDIDATE_CATEGORIES: readonly ["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"];
+/**
+ * All valid candidate statuses.
+ */
+export declare const CANDIDATE_STATUSES: readonly ["pending", "promoted", "rejected", "merged"];
+/** Confidence level for extracted learning candidates. */
+export declare const CandidateConfidenceSchema: Schema.Literal<["high", "medium", "low"]>;
+export type CandidateConfidence = typeof CandidateConfidenceSchema.Type;
+/** Category of the extracted learning. */
+export declare const CandidateCategorySchema: Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>;
+export type CandidateCategory = typeof CandidateCategorySchema.Type;
+/** Status of a learning candidate in the promotion pipeline. */
+export declare const CandidateStatusSchema: Schema.Literal<["pending", "promoted", "rejected", "merged"]>;
+export type CandidateStatus = typeof CandidateStatusSchema.Type;
+/** Unique identifier for a stored learning candidate. */
+export type CandidateId = number;
+/** A chunk of transcript content to be analyzed for learning extraction. */
+export declare const TranscriptChunkSchema: Schema.Struct<{
+    /** The transcript text content to analyze */
+    content: typeof Schema.String;
+    /** Source file path (e.g., ~/.claude/projects/foo/session.jsonl) */
+    sourceFile: typeof Schema.String;
+    /** Optional run ID for provenance tracking */
+    sourceRunId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** Optional task ID for provenance tracking */
+    sourceTaskId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** Byte offset in source file (for incremental processing) */
+    byteOffset: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    /** Line number range in source file */
+    lineRange: Schema.optional<Schema.Struct<{
+        start: Schema.filter<typeof Schema.Number>;
+        end: Schema.filter<typeof Schema.Number>;
+    }>>;
+}>;
+export type TranscriptChunk = typeof TranscriptChunkSchema.Type;
+/** A learning candidate extracted from a transcript by the LLM. */
+export declare const ExtractedCandidateSchema: Schema.Struct<{
+    /** The learning text (1-3 sentences, actionable) */
+    content: typeof Schema.String;
+    /** Confidence level assigned by the LLM */
+    confidence: Schema.Literal<["high", "medium", "low"]>;
+    /** Category of the learning */
+    category: Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>;
+}>;
+export type ExtractedCandidate = typeof ExtractedCandidateSchema.Type;
+/** A learning candidate stored in the database. */
+export declare const LearningCandidateSchema: Schema.Struct<{
+    /** Unique database ID */
+    id: Schema.filter<typeof Schema.Number>;
+    /** The learning text (1-3 sentences, actionable) */
+    content: typeof Schema.String;
+    /** Confidence level assigned by the LLM */
+    confidence: Schema.Literal<["high", "medium", "low"]>;
+    /** Category of the learning */
+    category: Schema.NullOr<Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>>;
+    /** Source JSONL file path */
+    sourceFile: typeof Schema.String;
+    /** Source run ID for provenance */
+    sourceRunId: Schema.NullOr<typeof Schema.String>;
+    /** Source task ID for provenance */
+    sourceTaskId: Schema.NullOr<typeof Schema.String>;
+    /** When the candidate was extracted */
+    extractedAt: typeof Schema.DateFromSelf;
+    /** Current status in promotion pipeline */
+    status: Schema.Literal<["pending", "promoted", "rejected", "merged"]>;
+    /** When the candidate was reviewed */
+    reviewedAt: Schema.NullOr<typeof Schema.DateFromSelf>;
+    /** Who reviewed ('auto' or user identifier) */
+    reviewedBy: Schema.NullOr<typeof Schema.String>;
+    /** ID of promoted learning (if promoted or merged) */
+    promotedLearningId: Schema.NullOr<Schema.filter<typeof Schema.Number>>;
+    /** Reason for rejection (if rejected) */
+    rejectionReason: Schema.NullOr<typeof Schema.String>;
+}>;
+export type LearningCandidate = typeof LearningCandidateSchema.Type;
+/** Input for creating a new learning candidate. */
+export declare const CreateCandidateInputSchema: Schema.Struct<{
+    content: typeof Schema.String;
+    confidence: Schema.Literal<["high", "medium", "low"]>;
+    category: Schema.optional<Schema.NullOr<Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>>>;
+    sourceFile: typeof Schema.String;
+    sourceRunId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    sourceTaskId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+}>;
+export type CreateCandidateInput = typeof CreateCandidateInputSchema.Type;
+/** Input for updating a learning candidate. */
+export declare const UpdateCandidateInputSchema: Schema.Struct<{
+    status: Schema.optional<Schema.Literal<["pending", "promoted", "rejected", "merged"]>>;
+    reviewedAt: Schema.optional<typeof Schema.DateFromSelf>;
+    reviewedBy: Schema.optional<typeof Schema.String>;
+    promotedLearningId: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    rejectionReason: Schema.optional<typeof Schema.String>;
+}>;
+export type UpdateCandidateInput = typeof UpdateCandidateInputSchema.Type;
+/** Filter options for querying learning candidates. */
+export declare const CandidateFilterSchema: Schema.Struct<{
+    status: Schema.optional<Schema.Union<[Schema.Literal<["pending", "promoted", "rejected", "merged"]>, Schema.Array$<Schema.Literal<["pending", "promoted", "rejected", "merged"]>>]>>;
+    confidence: Schema.optional<Schema.Union<[Schema.Literal<["high", "medium", "low"]>, Schema.Array$<Schema.Literal<["high", "medium", "low"]>>]>>;
+    category: Schema.optional<Schema.Union<[Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>, Schema.Array$<Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>>]>>;
+    sourceFile: Schema.optional<typeof Schema.String>;
+    sourceRunId: Schema.optional<typeof Schema.String>;
+    sourceTaskId: Schema.optional<typeof Schema.String>;
+    limit: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    offset: Schema.optional<Schema.filter<typeof Schema.Number>>;
+}>;
+export type CandidateFilter = typeof CandidateFilterSchema.Type;
+/** Result of candidate extraction from a transcript chunk. */
+export declare const ExtractionResultSchema: Schema.Struct<{
+    candidates: Schema.Array$<Schema.Struct<{
+        /** The learning text (1-3 sentences, actionable) */
+        content: typeof Schema.String;
+        /** Confidence level assigned by the LLM */
+        confidence: Schema.Literal<["high", "medium", "low"]>;
+        /** Category of the learning */
+        category: Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>;
+    }>>;
+    sourceChunk: Schema.Struct<{
+        /** The transcript text content to analyze */
+        content: typeof Schema.String;
+        /** Source file path (e.g., ~/.claude/projects/foo/session.jsonl) */
+        sourceFile: typeof Schema.String;
+        /** Optional run ID for provenance tracking */
+        sourceRunId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** Optional task ID for provenance tracking */
+        sourceTaskId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** Byte offset in source file (for incremental processing) */
+        byteOffset: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Line number range in source file */
+        lineRange: Schema.optional<Schema.Struct<{
+            start: Schema.filter<typeof Schema.Number>;
+            end: Schema.filter<typeof Schema.Number>;
+        }>>;
+    }>;
+    wasExtracted: typeof Schema.Boolean;
+    metadata: Schema.optional<Schema.Struct<{
+        model: Schema.optional<typeof Schema.String>;
+        tokensUsed: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        durationMs: Schema.optional<typeof Schema.Number>;
+    }>>;
+}>;
+export type ExtractionResult = typeof ExtractionResultSchema.Type;
+/** 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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"}