@jamesaphoenix/tx-core 0.4.2 → 0.4.3

package/dist/sync/claude-task-writer.js

@@ -0,0 +1,135 @@
+/**
+ * Claude Code task directory writer.
+ *
+ * Pure functions that transform TaskWithDeps[] into Claude Code's
+ * on-disk task format (individual JSON files per task).
+ *
+ * Claude Code stores team tasks at ~/.claude/tasks/{team-name}/
+ * with files: {id}.json, .highwatermark, .lock
+ */
+import { Schema } from "effect";
+// =============================================================================
+// Types
+// =============================================================================
+const ClaudeTaskStatusSchema = Schema.Literal("pending", "in_progress", "completed");
+/** A single Claude Code task file (written as {id}.json) */
+export const ClaudeTaskFileSchema = Schema.Struct({
+    id: Schema.String,
+    subject: Schema.String,
+    description: Schema.String,
+    activeForm: Schema.String,
+    status: ClaudeTaskStatusSchema,
+    blocks: Schema.Array(Schema.String),
+    blockedBy: Schema.Array(Schema.String),
+});
+/** Result of building Claude task files from tx tasks */
+export const ClaudeSyncResultSchema = Schema.Struct({
+    files: Schema.Array(ClaudeTaskFileSchema),
+    highwatermark: Schema.Number,
+});
+// =============================================================================
+// Status Mapping
+// =============================================================================
+function mapStatus(txStatus) {
+    switch (txStatus) {
+        case "active":
+        case "review":
+        case "human_needs_to_review":
+            return "in_progress";
+        default:
+            return "pending";
+    }
+}
+// =============================================================================
+// Description Builder
+// =============================================================================
+function buildClaudeDescription(task, txIdMap) {
+    const lines = [];
+    if (task.description) {
+        lines.push(task.description);
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push(`**tx ID**: ${task.id} | **Priority**: ${task.score} | **Status**: ${task.status}`);
+    if (task.blockedBy.length > 0) {
+        const refs = task.blockedBy.map((id) => {
+            const numId = txIdMap.get(id);
+            return numId ? `#${numId} (${id})` : `${id}`;
+        });
+        lines.push(`**Blocked by**: ${refs.join(", ")}`);
+    }
+    if (task.blocks.length > 0) {
+        const refs = task.blocks.map((id) => {
+            const numId = txIdMap.get(id);
+            return numId ? `#${numId} (${id})` : `${id}`;
+        });
+        lines.push(`**Blocks**: ${refs.join(", ")}`);
+    }
+    if (task.parentId) {
+        lines.push(`**Parent**: ${task.parentId}`);
+    }
+    if (task.children.length > 0) {
+        lines.push(`**Children**: ${task.children.join(", ")}`);
+    }
+    lines.push("");
+    lines.push(`Run \`tx context ${task.id}\` for relevant learnings before starting.`);
+    lines.push(`Run \`tx done ${task.id}\` when complete.`);
+    return lines.join("\n");
+}
+// =============================================================================
+// Main Builder
+// =============================================================================
+/**
+ * Transform tx tasks into Claude Code task files.
+ *
+ * - Filters out done tasks
+ * - Sorts: ready tasks first (highest score first), then non-ready by score
+ * - Assigns sequential numeric IDs
+ * - Maps blockedBy/blocks references to numeric IDs
+ */
+export function buildClaudeTaskFiles(tasks) {
+    // Filter out done tasks
+    const nonDone = tasks.filter(t => t.status !== "done");
+    // Sort: ready first (highest score), then non-ready (highest score)
+    // Tie-break by tx ID for deterministic ordering across syncs
+    const sorted = [...nonDone].sort((a, b) => {
+        if (a.isReady !== b.isReady) {
+            return a.isReady ? -1 : 1;
+        }
+        if (a.score !== b.score) {
+            return b.score - a.score;
+        }
+        return a.id.localeCompare(b.id);
+    });
+    // Build tx ID -> numeric ID mapping
+    const txIdMap = new Map();
+    for (let i = 0; i < sorted.length; i++) {
+        txIdMap.set(sorted[i].id, String(i + 1));
+    }
+    // Build task files
+    const files = sorted.map((task, i) => {
+        const numericId = String(i + 1);
+        // Map blockedBy/blocks to numeric IDs, filtering out done tasks
+        const blockedBy = task.blockedBy
+            .map((id) => txIdMap.get(id))
+            .filter((id) => id !== undefined);
+        const blocks = task.blocks
+            .map((id) => txIdMap.get(id))
+            .filter((id) => id !== undefined);
+        return {
+            id: numericId,
+            subject: task.title,
+            description: buildClaudeDescription(task, txIdMap),
+            activeForm: `Working on ${task.id}: ${task.title}`,
+            status: mapStatus(task.status),
+            blocks,
+            blockedBy,
+        };
+    });
+    return {
+        files,
+        highwatermark: files.length + 1,
+        txIdMap,
+    };
+}
+//# sourceMappingURL=claude-task-writer.js.map

package/dist/sync/claude-task-writer.js.map

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

package/dist/utils/doc-hash.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Content-addressed hashing for docs.
+ * SHA256 hex digest of normalized content.
+ */
+/**
+ * Compute SHA256 hash of document content.
+ * Normalizes content by trimming whitespace and normalizing line endings.
+ */
+export declare const computeDocHash: (content: string) => string;
+//# sourceMappingURL=doc-hash.d.ts.map

package/dist/utils/doc-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-hash.d.ts","sourceRoot":"","sources":["../../src/utils/doc-hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAGhD,CAAA"}

package/dist/utils/doc-hash.js

@@ -0,0 +1,14 @@
+/**
+ * Content-addressed hashing for docs.
+ * SHA256 hex digest of normalized content.
+ */
+import { createHash } from "node:crypto";
+/**
+ * Compute SHA256 hash of document content.
+ * Normalizes content by trimming whitespace and normalizing line endings.
+ */
+export const computeDocHash = (content) => {
+    const normalized = content.trim().replace(/\r\n/g, "\n");
+    return createHash("sha256").update(normalized, "utf8").digest("hex");
+};
+//# sourceMappingURL=doc-hash.js.map

package/dist/utils/doc-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-hash.js","sourceRoot":"","sources":["../../src/utils/doc-hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACxD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACtE,CAAC,CAAA"}

package/dist/utils/doc-renderer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pure YML → MD renderer for tx docs.
+ *
+ * Deterministic output with stable section ordering per doc kind.
+ * Free-text sections pass through as-is (already markdown).
+ * Structured sections (invariants, failure_modes, edge_cases) render as tables.
+ */
+import type { DocKind } from "@jamesaphoenix/tx-types";
+/** Parsed YAML doc content (loosely typed — sections may or may not exist). */
+type ParsedYaml = Record<string, unknown>;
+/**
+ * Render a parsed YAML doc to deterministic markdown.
+ * Section order is fixed per kind. Missing sections are skipped.
+ */
+export declare const renderDocToMarkdown: (parsed: ParsedYaml, kind: DocKind) => string;
+/**
+ * Render index data to markdown.
+ */
+export declare const renderIndexToMarkdown: (indexData: {
+    overview?: string;
+    prds: Array<{
+        name: string;
+        title: string;
+        status: string;
+    }>;
+    design_docs: Array<{
+        name: string;
+        title: string;
+        status: string;
+        implements?: string;
+    }>;
+    links: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    invariant_summary?: {
+        total: number;
+        by_enforcement: Record<string, number>;
+        by_subsystem: Record<string, number>;
+    };
+}) => string;
+export {};
+//# sourceMappingURL=doc-renderer.d.ts.map

package/dist/utils/doc-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-renderer.d.ts","sourceRoot":"","sources":["../../src/utils/doc-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AA4BtD,+EAA+E;AAC/E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,UAAU,EAAE,MAAM,OAAO,KAAG,MAwBvE,CAAA;AAgJD;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5D,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxF,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD,iBAAiB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CACpH,KAAG,MAgEH,CAAA"}

package/dist/utils/doc-renderer.js

@@ -0,0 +1,202 @@
+/**
+ * Pure YML → MD renderer for tx docs.
+ *
+ * Deterministic output with stable section ordering per doc kind.
+ * Free-text sections pass through as-is (already markdown).
+ * Structured sections (invariants, failure_modes, edge_cases) render as tables.
+ */
+/**
+ * Render a parsed YAML doc to deterministic markdown.
+ * Section order is fixed per kind. Missing sections are skipped.
+ */
+export const renderDocToMarkdown = (parsed, kind) => {
+    const title = parsed.title ?? parsed.name ?? "Untitled";
+    const lines = [`# ${title}`, ""];
+    // Metadata header
+    if (parsed.kind)
+        lines.push(`**Kind**: ${parsed.kind}`);
+    if (parsed.status)
+        lines.push(`**Status**: ${parsed.status}`);
+    if (parsed.version)
+        lines.push(`**Version**: ${parsed.version}`);
+    if (parsed.implements)
+        lines.push(`**Implements**: ${parsed.implements}`);
+    lines.push("");
+    switch (kind) {
+        case "overview":
+            renderOverview(parsed, lines);
+            break;
+        case "prd":
+            renderPrd(parsed, lines);
+            break;
+        case "design":
+            renderDesign(parsed, lines);
+            break;
+    }
+    return lines.join("\n");
+};
+// =============================================================================
+// KIND-SPECIFIC RENDERERS
+// =============================================================================
+const renderOverview = (parsed, lines) => {
+    renderFreeTextSection(parsed, lines, "problem_definition", "Problem Definition");
+    renderFreeTextSection(parsed, lines, "subsystems", "Subsystems");
+    renderFreeTextSection(parsed, lines, "object_model", "Object Model");
+    renderFreeTextSection(parsed, lines, "storage_schema", "Storage Schema");
+    renderInvariantsTable(parsed.invariants, lines);
+    renderFailureModesTable(parsed.failure_modes, lines);
+    renderEdgeCasesTable(parsed.edge_cases, lines);
+    renderConstraintsList(parsed.constraints, lines);
+    renderFreeTextSection(parsed, lines, "cross_cutting", "Cross-Cutting Concerns");
+    renderFreeTextSection(parsed, lines, "data_retention", "Data Retention");
+};
+const renderPrd = (parsed, lines) => {
+    renderFreeTextSection(parsed, lines, "problem", "Problem");
+    renderFreeTextSection(parsed, lines, "solution", "Solution");
+    renderStringList(parsed.requirements, lines, "Requirements");
+    renderStringList(parsed.acceptance_criteria, lines, "Acceptance Criteria");
+    renderStringList(parsed.out_of_scope, lines, "Out of Scope");
+};
+const renderDesign = (parsed, lines) => {
+    renderFreeTextSection(parsed, lines, "problem_definition", "Problem Definition");
+    renderStringList(parsed.goals, lines, "Goals");
+    renderFreeTextSection(parsed, lines, "architecture", "Architecture");
+    renderFreeTextSection(parsed, lines, "interfaces", "Interfaces");
+    renderFreeTextSection(parsed, lines, "implementation", "Implementation");
+    renderFreeTextSection(parsed, lines, "data_model", "Data Model");
+    renderInvariantsTable(parsed.invariants, lines);
+    renderFailureModesTable(parsed.failure_modes, lines);
+    renderEdgeCasesTable(parsed.edge_cases, lines);
+    renderWorkBreakdown(parsed.work_breakdown, lines);
+    renderFreeTextSection(parsed, lines, "retention", "Retention");
+    renderFreeTextSection(parsed, lines, "testing_strategy", "Testing Strategy");
+    renderFreeTextSection(parsed, lines, "open_questions", "Open Questions");
+};
+// =============================================================================
+// SECTION RENDERERS
+// =============================================================================
+const renderFreeTextSection = (parsed, lines, key, heading) => {
+    const content = parsed[key];
+    if (!content || (typeof content === "string" && !content.trim()))
+        return;
+    lines.push(`## ${heading}`, "");
+    lines.push(String(content).trim(), "");
+};
+const renderStringList = (items, lines, heading) => {
+    if (!Array.isArray(items) || items.length === 0)
+        return;
+    lines.push(`## ${heading}`, "");
+    for (const item of items) {
+        lines.push(`- ${String(item)}`);
+    }
+    lines.push("");
+};
+const renderConstraintsList = (constraints, lines) => {
+    renderStringList(constraints, lines, "Constraints");
+};
+const renderInvariantsTable = (invariants, lines) => {
+    if (!Array.isArray(invariants) || invariants.length === 0)
+        return;
+    lines.push("## Invariants", "");
+    lines.push("| ID | Rule | Enforcement | Reference |");
+    lines.push("|-----|------|-------------|-----------|");
+    for (const inv of invariants) {
+        const ref = inv.test_ref ?? inv.lint_rule ?? inv.prompt_ref ?? "-";
+        const subsystem = inv.subsystem ? ` (${inv.subsystem})` : "";
+        lines.push(`| ${inv.id} | ${inv.rule}${subsystem} | ${inv.enforcement} | ${ref} |`);
+    }
+    lines.push("");
+};
+const renderFailureModesTable = (failureModes, lines) => {
+    if (!Array.isArray(failureModes) || failureModes.length === 0)
+        return;
+    lines.push("## Failure Modes", "");
+    lines.push("| ID | Description | Mitigation |");
+    lines.push("|-----|-------------|------------|");
+    for (const fm of failureModes) {
+        lines.push(`| ${fm.id} | ${fm.description} | ${fm.mitigation ?? "-"} |`);
+    }
+    lines.push("");
+};
+const renderEdgeCasesTable = (edgeCases, lines) => {
+    if (!Array.isArray(edgeCases) || edgeCases.length === 0)
+        return;
+    lines.push("## Edge Cases", "");
+    lines.push("| ID | Description |");
+    lines.push("|-----|-------------|");
+    for (const ec of edgeCases) {
+        lines.push(`| ${ec.id} | ${ec.description} |`);
+    }
+    lines.push("");
+};
+const renderWorkBreakdown = (items, lines) => {
+    if (!Array.isArray(items) || items.length === 0)
+        return;
+    lines.push("## Work Breakdown", "");
+    for (const item of items) {
+        const taskRef = item.task_id ? `\`${item.task_id}\` — ` : "";
+        lines.push(`- ${taskRef}${item.description}`);
+    }
+    lines.push("");
+};
+/**
+ * Render index data to markdown.
+ */
+export const renderIndexToMarkdown = (indexData) => {
+    const lines = ["# Documentation Index", ""];
+    if (indexData.overview) {
+        lines.push(`**System Overview**: [${indexData.overview}](${indexData.overview}.md)`, "");
+    }
+    // PRDs table
+    if (indexData.prds.length > 0) {
+        lines.push("## Product Requirements Documents", "");
+        lines.push("| Name | Title | Status |");
+        lines.push("|------|-------|--------|");
+        for (const prd of indexData.prds) {
+            lines.push(`| [${prd.name}](prd/${prd.name}.md) | ${prd.title} | ${prd.status} |`);
+        }
+        lines.push("");
+    }
+    // Design docs table
+    if (indexData.design_docs.length > 0) {
+        lines.push("## Design Documents", "");
+        lines.push("| Name | Title | Implements | Status |");
+        lines.push("|------|-------|------------|--------|");
+        for (const dd of indexData.design_docs) {
+            lines.push(`| [${dd.name}](design/${dd.name}.md) | ${dd.title} | ${dd.implements ?? "-"} | ${dd.status} |`);
+        }
+        lines.push("");
+    }
+    // Invariant summary
+    if (indexData.invariant_summary && indexData.invariant_summary.total > 0) {
+        const s = indexData.invariant_summary;
+        lines.push("## Invariant Summary", "");
+        lines.push(`**Total invariants**: ${s.total}`, "");
+        if (Object.keys(s.by_enforcement).length > 0) {
+            lines.push("**By enforcement type**:", "");
+            for (const [type, count] of Object.entries(s.by_enforcement)) {
+                lines.push(`- ${type}: ${count}`);
+            }
+            lines.push("");
+        }
+        if (Object.keys(s.by_subsystem).length > 0) {
+            lines.push("**By subsystem**:", "");
+            for (const [subsystem, count] of Object.entries(s.by_subsystem)) {
+                lines.push(`- ${subsystem}: ${count}`);
+            }
+            lines.push("");
+        }
+    }
+    // Links
+    if (indexData.links.length > 0) {
+        lines.push("## Document Links", "");
+        lines.push("| From | To | Type |");
+        lines.push("|------|-----|------|");
+        for (const link of indexData.links) {
+            lines.push(`| ${link.from} | ${link.to} | ${link.type} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+};
+//# sourceMappingURL=doc-renderer.js.map

package/dist/utils/doc-renderer.js.map

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

package/dist/utils/math.d.ts

@@ -1,6 +1,10 @@
+import { Effect } from "effect";
+import { EmbeddingDimensionMismatchError } from "../errors.js";
 /**
  * Calculate cosine similarity between two vectors.
  * Returns a value between -1 and 1, where 1 means identical direction.
+ *
+ * @returns Effect that fails with EmbeddingDimensionMismatchError if vectors have different dimensions
  */
-export declare const cosineSimilarity: (a: Float32Array, b: Float32Array) => number;
+export declare const cosineSimilarity: (a: Float32Array, b: Float32Array) => Effect.Effect<number, EmbeddingDimensionMismatchError>;
 //# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,GAAG,YAAY,EAAE,GAAG,YAAY,KAAG,MAiBnE,CAAA"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,GAAG,YAAY,EACf,GAAG,YAAY,KACd,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAwBvD,CAAA"}

package/dist/utils/math.js

@@ -1,10 +1,18 @@
+import { Effect } from "effect";
+import { EmbeddingDimensionMismatchError } from "../errors.js";
 /**
  * Calculate cosine similarity between two vectors.
  * Returns a value between -1 and 1, where 1 means identical direction.
+ *
+ * @returns Effect that fails with EmbeddingDimensionMismatchError if vectors have different dimensions
  */
 export const cosineSimilarity = (a, b) => {
-    if (a.length !== b.length)
-        return 0;
+    if (a.length !== b.length) {
+        return Effect.fail(new EmbeddingDimensionMismatchError({
+            queryDimensions: a.length,
+            documentDimensions: b.length
+        }));
+    }
     let dotProduct = 0;
     let normA = 0;
     let normB = 0;
@@ -15,7 +23,7 @@ export const cosineSimilarity = (a, b) => {
     }
     const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
     if (magnitude === 0)
-        return 0;
-    return dotProduct / magnitude;
+        return Effect.succeed(0);
+    return Effect.succeed(dotProduct / magnitude);
 };
 //# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAe,EAAE,CAAe,EAAU,EAAE;IAC3E,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAA;IAEnC,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QAC3B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QACtB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IACxB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrD,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAE7B,OAAO,UAAU,GAAG,SAAS,CAAA;AAC/B,CAAC,CAAA"}
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,CAAe,EACf,CAAe,EACyC,EAAE;IAC1D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,+BAA+B,CAAC;YAClC,eAAe,EAAE,CAAC,CAAC,MAAM;YACzB,kBAAkB,EAAE,CAAC,CAAC,MAAM;SAC7B,CAAC,CACH,CAAA;IACH,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QAC3B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QACtB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IACxB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrD,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAE7C,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;AAC/C,CAAC,CAAA"}

package/dist/utils/sql.d.ts

@@ -0,0 +1,9 @@
+/** Escape LIKE special characters so user input is treated as literal text. */
+export declare const escapeLikePattern: (input: string) => string;
+/**
+ * Default row limit for unbounded SELECT queries (findAll / getAll).
+ * Prevents accidental memory blowup when tables grow large.
+ * Callers that genuinely need more rows should pass an explicit limit.
+ */
+export declare const DEFAULT_QUERY_LIMIT = 1000;
+//# sourceMappingURL=sql.d.ts.map

package/dist/utils/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/utils/sql.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MACsB,CAAA;AAExE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAA"}

package/dist/utils/sql.js

@@ -0,0 +1,9 @@
+/** Escape LIKE special characters so user input is treated as literal text. */
+export const escapeLikePattern = (input) => input.replace(/\\/g, "\\\\").replace(/%/g, "\\%").replace(/_/g, "\\_");
+/**
+ * Default row limit for unbounded SELECT queries (findAll / getAll).
+ * Prevents accidental memory blowup when tables grow large.
+ * Callers that genuinely need more rows should pass an explicit limit.
+ */
+export const DEFAULT_QUERY_LIMIT = 1000;
+//# sourceMappingURL=sql.js.map

package/dist/utils/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/utils/sql.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAA"}

package/dist/utils/toml-config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Read tx configuration from .tx/config.toml.
+ * Returns defaults if file doesn't exist.
+ */
+export type TxDocsConfig = {
+    readonly path: string;
+};
+export type TxCyclesConfig = {
+    readonly scanPrompt: string | null;
+    readonly agents: number;
+    readonly model: string;
+};
+export type TxConfig = {
+    readonly docs: TxDocsConfig;
+    readonly cycles: TxCyclesConfig;
+};
+/**
+ * Read .tx/config.toml and return parsed config.
+ * Falls back to defaults if file doesn't exist or is invalid.
+ */
+export declare const readTxConfig: (cwd?: string) => TxConfig;
+//# sourceMappingURL=toml-config.d.ts.map

package/dist/utils/toml-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml-config.d.ts","sourceRoot":"","sources":["../../src/utils/toml-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAChC,CAAA;AAOD;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAK,MAAsB,KAAG,QA8B1D,CAAA"}

package/dist/utils/toml-config.js

@@ -0,0 +1,75 @@
+/**
+ * Read tx configuration from .tx/config.toml.
+ * Returns defaults if file doesn't exist.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+const DEFAULT_CONFIG = {
+    docs: { path: ".tx/docs" },
+    cycles: { scanPrompt: null, agents: 3, model: "claude-opus-4-6" },
+};
+/**
+ * Read .tx/config.toml and return parsed config.
+ * Falls back to defaults if file doesn't exist or is invalid.
+ */
+export const readTxConfig = (cwd = process.cwd()) => {
+    const configPath = resolve(cwd, ".tx", "config.toml");
+    if (!existsSync(configPath)) {
+        return DEFAULT_CONFIG;
+    }
+    try {
+        const raw = readFileSync(configPath, "utf8");
+        // Lightweight TOML parsing for our simple config structure.
+        // We only support [docs] section with path key.
+        const docsPath = extractTomlValue(raw, "docs", "path");
+        const cyclesScanPrompt = extractTomlValue(raw, "cycles", "scan_prompt");
+        const cyclesAgents = extractTomlValue(raw, "cycles", "agents");
+        const cyclesModel = extractTomlValue(raw, "cycles", "model");
+        return {
+            docs: {
+                path: docsPath ?? DEFAULT_CONFIG.docs.path,
+            },
+            cycles: {
+                scanPrompt: cyclesScanPrompt ?? DEFAULT_CONFIG.cycles.scanPrompt,
+                agents: cyclesAgents ? parseInt(cyclesAgents, 10) : DEFAULT_CONFIG.cycles.agents,
+                model: cyclesModel ?? DEFAULT_CONFIG.cycles.model,
+            },
+        };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+};
+/**
+ * Extract a value from a simple TOML file.
+ * Handles [section] + key = "value" patterns.
+ */
+const extractTomlValue = (toml, section, key) => {
+    const lines = toml.split("\n");
+    let inSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check for section header
+        if (trimmed === `[${section}]`) {
+            inSection = true;
+            continue;
+        }
+        // New section starts — stop looking
+        if (trimmed.startsWith("[") && inSection) {
+            break;
+        }
+        // Look for key = "value", key = 'value', or key = unquoted
+        if (inSection) {
+            const quoted = trimmed.match(new RegExp(`^${key}\\s*=\\s*["'](.+?)["']$`));
+            if (quoted) {
+                return quoted[1];
+            }
+            const unquoted = trimmed.match(new RegExp(`^${key}\\s*=\\s*([^#\\s]+)`));
+            if (unquoted) {
+                return unquoted[1];
+            }
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=toml-config.js.map

package/dist/utils/toml-config.js.map

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