@jamesaphoenix/tx-types 0.4.2 → 0.4.3

package/dist/candidate.d.ts

@@ -3,188 +3,160 @@
  *
  * 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
  */
-/**
- * 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";
+import { Schema } from "effect";
 /**
  * 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 {
+/** 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 */
-    readonly content: string;
+    content: typeof Schema.String;
     /** Source file path (e.g., ~/.claude/projects/foo/session.jsonl) */
-    readonly sourceFile: string;
+    sourceFile: typeof Schema.String;
     /** Optional run ID for provenance tracking */
-    readonly sourceRunId?: string | null;
+    sourceRunId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
     /** Optional task ID for provenance tracking */
-    readonly sourceTaskId?: string | null;
+    sourceTaskId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
     /** Byte offset in source file (for incremental processing) */
-    readonly byteOffset?: number;
+    byteOffset: Schema.optional<Schema.filter<typeof Schema.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 {
+    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) */
-    readonly content: string;
+    content: typeof Schema.String;
     /** Confidence level assigned by the LLM */
-    readonly confidence: CandidateConfidence;
+    confidence: Schema.Literal<["high", "medium", "low"]>;
     /** 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 {
+    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 */
-    readonly id: CandidateId;
+    id: Schema.filter<typeof Schema.Number>;
     /** The learning text (1-3 sentences, actionable) */
-    readonly content: string;
+    content: typeof Schema.String;
     /** Confidence level assigned by the LLM */
-    readonly confidence: CandidateConfidence;
+    confidence: Schema.Literal<["high", "medium", "low"]>;
     /** Category of the learning */
-    readonly category: CandidateCategory | null;
+    category: Schema.NullOr<Schema.Literal<["architecture", "testing", "performance", "security", "debugging", "tooling", "patterns", "other"]>>;
     /** Source JSONL file path */
-    readonly sourceFile: string;
+    sourceFile: typeof Schema.String;
     /** Source run ID for provenance */
-    readonly sourceRunId: string | null;
+    sourceRunId: Schema.NullOr<typeof Schema.String>;
     /** Source task ID for provenance */
-    readonly sourceTaskId: string | null;
+    sourceTaskId: Schema.NullOr<typeof Schema.String>;
     /** When the candidate was extracted */
-    readonly extractedAt: Date;
+    extractedAt: typeof Schema.DateFromSelf;
     /** Current status in promotion pipeline */
-    readonly status: CandidateStatus;
+    status: Schema.Literal<["pending", "promoted", "rejected", "merged"]>;
     /** When the candidate was reviewed */
-    readonly reviewedAt: Date | null;
+    reviewedAt: Schema.NullOr<typeof Schema.DateFromSelf>;
     /** Who reviewed ('auto' or user identifier) */
-    readonly reviewedBy: string | null;
+    reviewedBy: Schema.NullOr<typeof Schema.String>;
     /** ID of promoted learning (if promoted or merged) */
-    readonly promotedLearningId: number | null;
+    promotedLearningId: Schema.NullOr<Schema.filter<typeof Schema.Number>>;
     /** 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.
- */
+    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;

package/dist/candidate.d.ts.map

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

package/dist/candidate.js

@@ -3,9 +3,14 @@
  *
  * 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";
+// =============================================================================
+// CONSTANTS
+// =============================================================================
 /**
  * All valid confidence levels.
  */
@@ -27,4 +32,108 @@ export const CANDIDATE_CATEGORIES = [
  * All valid candidate statuses.
  */
 export const CANDIDATE_STATUSES = ["pending", "promoted", "rejected", "merged"];
+// =============================================================================
+// SCHEMAS & TYPES
+// =============================================================================
+/** Confidence level for extracted learning candidates. */
+export const CandidateConfidenceSchema = Schema.Literal(...CANDIDATE_CONFIDENCES);
+/** Category of the extracted learning. */
+export const CandidateCategorySchema = Schema.Literal(...CANDIDATE_CATEGORIES);
+/** Status of a learning candidate in the promotion pipeline. */
+export const CandidateStatusSchema = Schema.Literal(...CANDIDATE_STATUSES);
+/** A chunk of transcript content to be analyzed for learning extraction. */
+export const TranscriptChunkSchema = Schema.Struct({
+    /** The transcript text content to analyze */
+    content: Schema.String,
+    /** Source file path (e.g., ~/.claude/projects/foo/session.jsonl) */
+    sourceFile: Schema.String,
+    /** Optional run ID for provenance tracking */
+    sourceRunId: Schema.optional(Schema.NullOr(Schema.String)),
+    /** Optional task ID for provenance tracking */
+    sourceTaskId: Schema.optional(Schema.NullOr(Schema.String)),
+    /** Byte offset in source file (for incremental processing) */
+    byteOffset: Schema.optional(Schema.Number.pipe(Schema.int())),
+    /** Line number range in source file */
+    lineRange: Schema.optional(Schema.Struct({
+        start: Schema.Number.pipe(Schema.int()),
+        end: Schema.Number.pipe(Schema.int()),
+    })),
+});
+/** A learning candidate extracted from a transcript by the LLM. */
+export const ExtractedCandidateSchema = Schema.Struct({
+    /** The learning text (1-3 sentences, actionable) */
+    content: Schema.String,
+    /** Confidence level assigned by the LLM */
+    confidence: CandidateConfidenceSchema,
+    /** Category of the learning */
+    category: CandidateCategorySchema,
+});
+/** A learning candidate stored in the database. */
+export const LearningCandidateSchema = Schema.Struct({
+    /** Unique database ID */
+    id: Schema.Number.pipe(Schema.int()),
+    /** The learning text (1-3 sentences, actionable) */
+    content: Schema.String,
+    /** Confidence level assigned by the LLM */
+    confidence: CandidateConfidenceSchema,
+    /** Category of the learning */
+    category: Schema.NullOr(CandidateCategorySchema),
+    /** Source JSONL file path */
+    sourceFile: Schema.String,
+    /** Source run ID for provenance */
+    sourceRunId: Schema.NullOr(Schema.String),
+    /** Source task ID for provenance */
+    sourceTaskId: Schema.NullOr(Schema.String),
+    /** When the candidate was extracted */
+    extractedAt: Schema.DateFromSelf,
+    /** Current status in promotion pipeline */
+    status: CandidateStatusSchema,
+    /** When the candidate was reviewed */
+    reviewedAt: Schema.NullOr(Schema.DateFromSelf),
+    /** Who reviewed ('auto' or user identifier) */
+    reviewedBy: Schema.NullOr(Schema.String),
+    /** ID of promoted learning (if promoted or merged) */
+    promotedLearningId: Schema.NullOr(Schema.Number.pipe(Schema.int())),
+    /** Reason for rejection (if rejected) */
+    rejectionReason: Schema.NullOr(Schema.String),
+});
+/** Input for creating a new learning candidate. */
+export const CreateCandidateInputSchema = Schema.Struct({
+    content: Schema.String,
+    confidence: CandidateConfidenceSchema,
+    category: Schema.optional(Schema.NullOr(CandidateCategorySchema)),
+    sourceFile: Schema.String,
+    sourceRunId: Schema.optional(Schema.NullOr(Schema.String)),
+    sourceTaskId: Schema.optional(Schema.NullOr(Schema.String)),
+});
+/** Input for updating a learning candidate. */
+export const UpdateCandidateInputSchema = Schema.Struct({
+    status: Schema.optional(CandidateStatusSchema),
+    reviewedAt: Schema.optional(Schema.DateFromSelf),
+    reviewedBy: Schema.optional(Schema.String),
+    promotedLearningId: Schema.optional(Schema.Number.pipe(Schema.int())),
+    rejectionReason: Schema.optional(Schema.String),
+});
+/** Filter options for querying learning candidates. */
+export const CandidateFilterSchema = Schema.Struct({
+    status: Schema.optional(Schema.Union(CandidateStatusSchema, Schema.Array(CandidateStatusSchema))),
+    confidence: Schema.optional(Schema.Union(CandidateConfidenceSchema, Schema.Array(CandidateConfidenceSchema))),
+    category: Schema.optional(Schema.Union(CandidateCategorySchema, Schema.Array(CandidateCategorySchema))),
+    sourceFile: Schema.optional(Schema.String),
+    sourceRunId: Schema.optional(Schema.String),
+    sourceTaskId: Schema.optional(Schema.String),
+    limit: Schema.optional(Schema.Number.pipe(Schema.int())),
+    offset: Schema.optional(Schema.Number.pipe(Schema.int())),
+});
+/** Result of candidate extraction from a transcript chunk. */
+export const ExtractionResultSchema = Schema.Struct({
+    candidates: Schema.Array(ExtractedCandidateSchema),
+    sourceChunk: TranscriptChunkSchema,
+    wasExtracted: Schema.Boolean,
+    metadata: Schema.optional(Schema.Struct({
+        model: Schema.optional(Schema.String),
+        tokensUsed: Schema.optional(Schema.Number.pipe(Schema.int())),
+        durationMs: Schema.optional(Schema.Number),
+    })),
+});
 //# sourceMappingURL=candidate.js.map

package/dist/candidate.js.map

@@ -1 +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"}
+{"version":3,"file":"candidate.js","sourceRoot":"","sources":["../src/candidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA;AAEvE;;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;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAA;AAExF,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,qBAAqB,CAAC,CAAA;AAGjF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,oBAAoB,CAAC,CAAA;AAG9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,CAAA;AAM1E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACvC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;KACtC,CAAC,CAAC;CACJ,CAAC,CAAA;AAGF,mEAAmE;AACnE,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,2CAA2C;IAC3C,UAAU,EAAE,yBAAyB;IACrC,+BAA+B;IAC/B,QAAQ,EAAE,uBAAuB;CAClC,CAAC,CAAA;AAGF,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IACpC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,2CAA2C;IAC3C,UAAU,EAAE,yBAAyB;IACrC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAChD,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACzC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1C,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC,YAAY;IAChC,2CAA2C;IAC3C,MAAM,EAAE,qBAAqB;IAC7B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAC9C,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,sDAAsD;IACtD,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;CAC9C,CAAC,CAAA;AAGF,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,UAAU,EAAE,yBAAyB;IACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACjE,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CAC5D,CAAC,CAAA;AAGF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACrE,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CAChD,CAAC,CAAA;AAGF,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACjG,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAC7G,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACvG,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;CAC1D,CAAC,CAAA;AAGF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAClD,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,MAAM,CAAC,OAAO;IAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QACrC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7D,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;KAC3C,CAAC,CAAC;CACJ,CAAC,CAAA"}

package/dist/cycle.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Cycle types for tx
+ *
+ * Type definitions for the cycle-based issue discovery system.
+ * Core type definitions using Effect Schema (Doctrine Rule 10).
+ *
+ * Cycles dispatch sub-agent swarms to scan for codebase issues,
+ * deduplicate findings against known issues, and optionally fix them.
+ */
+import { Schema } from "effect";
+export declare const FINDING_SEVERITIES: readonly ["high", "medium", "low"];
+export declare const LOSS_WEIGHTS: {
+    readonly high: 3;
+    readonly medium: 2;
+    readonly low: 1;
+};
+/** Severity level for a finding. */
+export declare const FindingSeveritySchema: Schema.Literal<["high", "medium", "low"]>;
+export type FindingSeverity = typeof FindingSeveritySchema.Type;
+/** A single issue found by a scan agent. */
+export declare const FindingSchema: Schema.Struct<{
+    title: typeof Schema.String;
+    description: typeof Schema.String;
+    severity: Schema.Literal<["high", "medium", "low"]>;
+    issueType: typeof Schema.String;
+    file: typeof Schema.String;
+    line: typeof Schema.Number;
+}>;
+export type Finding = typeof FindingSchema.Type;
+/** A duplicate finding mapped to an existing issue. */
+export declare const DuplicateSchema: Schema.Struct<{
+    findingIdx: typeof Schema.Number;
+    existingIssueId: typeof Schema.String;
+    reason: typeof Schema.String;
+}>;
+export type Duplicate = typeof DuplicateSchema.Type;
+/** Result of deduplication: new issues and identified duplicates. */
+export declare const DedupResultSchema: Schema.Struct<{
+    newIssues: Schema.Array$<Schema.Struct<{
+        title: typeof Schema.String;
+        description: typeof Schema.String;
+        severity: Schema.Literal<["high", "medium", "low"]>;
+        issueType: typeof Schema.String;
+        file: typeof Schema.String;
+        line: typeof Schema.Number;
+    }>>;
+    duplicates: Schema.Array$<Schema.Struct<{
+        findingIdx: typeof Schema.Number;
+        existingIssueId: typeof Schema.String;
+        reason: typeof Schema.String;
+    }>>;
+}>;
+export type DedupResult = typeof DedupResultSchema.Type;
+/** Configuration for a cycle scan run. */
+export declare const CycleConfigSchema: Schema.Struct<{
+    taskPrompt: typeof Schema.String;
+    scanPrompt: typeof Schema.String;
+    name: Schema.optional<typeof Schema.String>;
+    description: Schema.optional<typeof Schema.String>;
+    cycles: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    maxRounds: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    agents: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    model: Schema.optional<typeof Schema.String>;
+    fix: Schema.optional<typeof Schema.Boolean>;
+    scanOnly: Schema.optional<typeof Schema.Boolean>;
+    dryRun: Schema.optional<typeof Schema.Boolean>;
+    score: Schema.optional<Schema.filter<typeof Schema.Number>>;
+}>;
+export type CycleConfig = typeof CycleConfigSchema.Type;
+/** Metrics for a single round within a cycle. */
+export declare const RoundMetricsSchema: Schema.Struct<{
+    cycle: Schema.filter<typeof Schema.Number>;
+    round: Schema.filter<typeof Schema.Number>;
+    loss: typeof Schema.Number;
+    newIssues: Schema.filter<typeof Schema.Number>;
+    existingIssues: Schema.filter<typeof Schema.Number>;
+    duplicates: Schema.filter<typeof Schema.Number>;
+    high: Schema.filter<typeof Schema.Number>;
+    medium: Schema.filter<typeof Schema.Number>;
+    low: Schema.filter<typeof Schema.Number>;
+}>;
+export type RoundMetrics = typeof RoundMetricsSchema.Type;
+/** Result of a completed cycle. */
+export declare const CycleResultSchema: Schema.Struct<{
+    cycleRunId: typeof Schema.String;
+    cycle: Schema.filter<typeof Schema.Number>;
+    name: typeof Schema.String;
+    description: typeof Schema.String;
+    rounds: Schema.filter<typeof Schema.Number>;
+    totalNewIssues: Schema.filter<typeof Schema.Number>;
+    existingIssues: Schema.filter<typeof Schema.Number>;
+    finalLoss: typeof Schema.Number;
+    converged: typeof Schema.Boolean;
+}>;
+export type CycleResult = typeof CycleResultSchema.Type;
+/** Progress events emitted during cycle scan — keeps service UI-agnostic. */
+export type CycleProgressEvent = {
+    type: "cycle_start";
+    cycle: number;
+    totalCycles: number;
+    name: string;
+} | {
+    type: "scan_complete";
+    cycle: number;
+    round: number;
+    findings: number;
+    durationMs: number;
+} | {
+    type: "dedup_complete";
+    cycle: number;
+    round: number;
+    newIssues: number;
+    duplicates: number;
+} | {
+    type: "round_loss";
+    cycle: number;
+    round: number;
+    loss: number;
+    high: number;
+    medium: number;
+    low: number;
+} | {
+    type: "converged";
+    cycle: number;
+    round: number;
+} | {
+    type: "cycle_complete";
+    result: CycleResult;
+};
+//# sourceMappingURL=cycle.d.ts.map

package/dist/cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.d.ts","sourceRoot":"","sources":["../src/cycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,eAAO,MAAM,kBAAkB,oCAAqC,CAAA;AAEpE,eAAO,MAAM,YAAY;;;;CAA0C,CAAA;AAMnE,oCAAoC;AACpC,eAAO,MAAM,qBAAqB,2CAAwC,CAAA;AAC1E,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAE/D,4CAA4C;AAC5C,eAAO,MAAM,aAAa;;;;;;;EAOxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAM/C,uDAAuD;AACvD,eAAO,MAAM,eAAe;;;;EAI1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEnD,qEAAqE;AACrE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;EAG5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAMvD,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAa5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAMvD,iDAAiD;AACjD,eAAO,MAAM,kBAAkB;;;;;;;;;;EAU7B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAEzD,mCAAmC;AACnC,eAAO,MAAM,iBAAiB;;;;;;;;;;EAU5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAMvD,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7G;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAA"}