@jamesaphoenix/tx-core 0.8.0 → 0.9.0

package/dist/services/sync/file-utils.js

@@ -0,0 +1,97 @@
+import { Effect, Schema } from "effect";
+import { writeFile, rename, readFile, mkdir, access } from "node:fs/promises";
+import { dirname } from "node:path";
+import { DatabaseError, ValidationError } from "../../errors.js";
+/** Empty entity import result for early returns. */
+export const EMPTY_ENTITY_IMPORT_RESULT = { imported: 0, skipped: 0 };
+/** Check if a file exists without blocking the event loop. */
+export const fileExists = (filePath) => Effect.promise(() => access(filePath).then(() => true).catch(() => false));
+/**
+ * Write content to file atomically using temp file + rename.
+ * Uses async fs operations to avoid blocking the event loop.
+ */
+export const atomicWrite = (filePath, content) => Effect.tryPromise({
+    try: async () => {
+        const dir = dirname(filePath);
+        await mkdir(dir, { recursive: true });
+        const tempPath = `${filePath}.tmp.${Date.now()}.${process.pid}.${Math.random().toString(36).slice(2)}`;
+        await writeFile(tempPath, content, "utf-8");
+        await rename(tempPath, filePath);
+    },
+    catch: (cause) => new DatabaseError({ cause })
+});
+/** Read and parse a JSONL file into plain object records. */
+export const readJsonlRecords = (filePath) => Effect.gen(function* () {
+    const exists = yield* fileExists(filePath);
+    if (!exists)
+        return [];
+    const content = yield* Effect.tryPromise({
+        try: () => readFile(filePath, "utf-8"),
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const lines = content.trim().split("\n").filter(Boolean);
+    const records = [];
+    for (const line of lines) {
+        const parsed = yield* Effect.try({
+            try: () => JSON.parse(line),
+            catch: (cause) => new ValidationError({ reason: `Invalid JSON: ${cause}` })
+        });
+        if (!parsed || typeof parsed !== "object") {
+            return yield* Effect.fail(new ValidationError({ reason: "JSONL line is not an object" }));
+        }
+        records.push(parsed);
+    }
+    return records;
+});
+/**
+ * Generic helper: parse a JSONL file, validate with schema, dedup by contentHash,
+ * filter against existing entities, and insert new ones via caller-provided batch function.
+ */
+export const importEntityJsonl = (filePath, schema, existingHashes, insertBatch) => Effect.gen(function* () {
+    const importFileExists = yield* fileExists(filePath);
+    if (!importFileExists) {
+        return EMPTY_ENTITY_IMPORT_RESULT;
+    }
+    const content = yield* Effect.tryPromise({
+        try: () => readFile(filePath, "utf-8"),
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const lines = content.trim().split("\n").filter(Boolean);
+    if (lines.length === 0) {
+        return EMPTY_ENTITY_IMPORT_RESULT;
+    }
+    const states = new Map();
+    for (const line of lines) {
+        const parsed = yield* Effect.try({
+            try: () => JSON.parse(line),
+            catch: (cause) => new ValidationError({ reason: `Invalid JSON: ${cause}` })
+        });
+        const op = yield* Effect.try({
+            try: () => Schema.decodeUnknownSync(schema)(parsed),
+            catch: (cause) => new ValidationError({ reason: `Schema validation failed: ${cause}` })
+        });
+        const existing = states.get(op.contentHash);
+        if (!existing || op.ts > existing.ts) {
+            states.set(op.contentHash, op);
+        }
+    }
+    const newOps = [];
+    let skipped = 0;
+    for (const op of states.values()) {
+        if (existingHashes.has(op.contentHash)) {
+            skipped++;
+        }
+        else {
+            newOps.push(op);
+        }
+    }
+    if (newOps.length === 0) {
+        return { imported: 0, skipped };
+    }
+    const imported = yield* Effect.try({
+        try: () => insertBatch(newOps),
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    return { imported, skipped };
+});
+//# sourceMappingURL=file-utils.js.map

package/dist/services/sync/file-utils.js.map

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

package/dist/services/sync/index.d.ts

@@ -0,0 +1,3 @@
+export { SyncService, SyncServiceLive } from "./service.js";
+export type { ImportResult, SyncStatus, SyncExportResult, LegacySyncExportResult, SyncImportResult, SyncHydrateResult, SyncCompactResult, SyncStreamInfoResult, DependencyImportResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAA"}

package/dist/services/sync/index.js

@@ -0,0 +1,2 @@
+export { SyncService, SyncServiceLive } from "./service.js";
+//# sourceMappingURL=index.js.map

package/dist/services/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/services/sync/service.d.ts

@@ -0,0 +1,2 @@
+export * from "../../internal/sync/service-impl.js";
+//# sourceMappingURL=service.d.ts.map

package/dist/services/sync/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/sync/service.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAA"}

package/dist/services/sync/service.js

@@ -0,0 +1,2 @@
+export * from "../../internal/sync/service-impl.js";
+//# sourceMappingURL=service.js.map

package/dist/services/sync/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/services/sync/service.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAA"}

package/dist/services/sync/sync-helpers.d.ts

@@ -0,0 +1,54 @@
+import { type SyncEventEnvelope, type SyncEventType } from "../../schemas/sync-events.js";
+/**
+ * Compute a content hash for cross-machine dedup.
+ * Entities with auto-increment IDs use this to identify duplicates.
+ */
+export declare const contentHash: (...parts: string[]) => string;
+/**
+ * Convert SQLite datetime string ("YYYY-MM-DD HH:MM:SS") to ISO 8601 ("YYYY-MM-DDTHH:MM:SS").
+ * Labels use raw SQL so timestamps come in SQLite format rather than Date objects.
+ */
+export declare const sqliteToIso: (s: string) => string;
+export declare const V1_TO_SYNC_TYPE: Record<string, SyncEventType>;
+export declare const entityIdFromV1Op: (op: Record<string, unknown>) => string;
+export declare const opToSyncEventType: (op: Record<string, unknown>) => SyncEventType | null;
+export declare const getTsFromOp: (op: Record<string, unknown>) => string;
+export declare const getEventIdFromOp: (op: Record<string, unknown>) => string;
+export declare const compareOpOrder: (a: Record<string, unknown>, b: Record<string, unknown>) => number;
+export declare const compareSyncOrder: (a: {
+    ts: string;
+    eventId?: string;
+}, b: {
+    ts: string;
+    eventId?: string;
+}) => number;
+export declare const toSyncEvent: (op: Record<string, unknown>, streamId: string, seq: number) => SyncEventEnvelope | null;
+export declare const syncEventToV1Op: (event: SyncEventEnvelope) => Record<string, unknown> | null;
+export type V1OpBuckets = {
+    tasks: Record<string, unknown>[];
+    learnings: Record<string, unknown>[];
+    fileLearnings: Record<string, unknown>[];
+    attempts: Record<string, unknown>[];
+    pins: Record<string, unknown>[];
+    anchors: Record<string, unknown>[];
+    edges: Record<string, unknown>[];
+    docs: Record<string, unknown>[];
+    labels: Record<string, unknown>[];
+};
+export declare const emptyV1Buckets: () => V1OpBuckets;
+export declare const bucketForOp: (opName: string) => keyof V1OpBuckets | null;
+export declare const stateCategoryForOp: (opName: string) => string | null;
+export declare const isRemovalOp: (opName: string) => boolean;
+export declare const stateKeyForOp: (op: Record<string, unknown>) => string | null;
+/**
+ * Topologically sort task operations so parents are processed before children.
+ */
+export declare function topologicalSortTasks<T extends {
+    op: {
+        op: string;
+        data?: {
+            parentId?: string | null;
+        };
+    };
+}>(entries: Array<[string, T]>): Array<[string, T]>;
+//# sourceMappingURL=sync-helpers.d.ts.map

package/dist/services/sync/sync-helpers.d.ts.map

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

package/dist/services/sync/sync-helpers.js

@@ -0,0 +1,245 @@
+import { createHash } from "node:crypto";
+import { generateUlid } from "../../utils/ulid.js";
+/**
+ * Compute a content hash for cross-machine dedup.
+ * Entities with auto-increment IDs use this to identify duplicates.
+ */
+export const contentHash = (...parts) => createHash("sha256").update(parts.join("|")).digest("hex");
+/**
+ * Convert SQLite datetime string ("YYYY-MM-DD HH:MM:SS") to ISO 8601 ("YYYY-MM-DDTHH:MM:SS").
+ * Labels use raw SQL so timestamps come in SQLite format rather than Date objects.
+ */
+export const sqliteToIso = (s) => {
+    if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(s))
+        return s.replace(" ", "T") + ".000Z";
+    return s;
+};
+export const V1_TO_SYNC_TYPE = {
+    upsert: "task.upsert",
+    delete: "task.delete",
+    dep_add: "dep.add",
+    dep_remove: "dep.remove",
+    learning_upsert: "learning.upsert",
+    learning_delete: "learning.delete",
+    file_learning_upsert: "file_learning.upsert",
+    file_learning_delete: "file_learning.delete",
+    attempt_upsert: "attempt.upsert",
+    pin_upsert: "pin.upsert",
+    pin_delete: "pin.delete",
+    anchor_upsert: "anchor.upsert",
+    anchor_delete: "anchor.delete",
+    edge_upsert: "edge.upsert",
+    edge_delete: "edge.delete",
+    doc_upsert: "doc.upsert",
+    doc_delete: "doc.delete",
+    doc_link_upsert: "doc_link.upsert",
+    task_doc_link_upsert: "task_doc_link.upsert",
+    invariant_upsert: "invariant.upsert",
+    label_upsert: "label.upsert",
+    label_assignment_upsert: "label_assignment.upsert",
+};
+export const entityIdFromV1Op = (op) => {
+    const kind = typeof op.op === "string" ? op.op : "";
+    switch (kind) {
+        case "dep_add":
+        case "dep_remove":
+            return `${String(op.blockerId)}:${String(op.blockedId)}`;
+        case "learning_upsert":
+        case "learning_delete":
+        case "file_learning_upsert":
+        case "file_learning_delete":
+        case "attempt_upsert":
+        case "anchor_upsert":
+        case "anchor_delete":
+        case "edge_upsert":
+        case "edge_delete":
+        case "doc_upsert":
+        case "doc_delete":
+        case "label_upsert":
+            return String(op.contentHash ?? op.id ?? "");
+        case "doc_link_upsert":
+            return String(op.contentHash ?? op.id ?? "");
+        case "task_doc_link_upsert":
+            return String(op.contentHash ?? op.id ?? "");
+        case "label_assignment_upsert":
+            return String(op.contentHash ?? "");
+        default:
+            return String(op.id ?? op.contentHash ?? "");
+    }
+};
+export const opToSyncEventType = (op) => {
+    const v1Op = typeof op.op === "string" ? op.op : "";
+    return V1_TO_SYNC_TYPE[v1Op] ?? null;
+};
+export const getTsFromOp = (op) => typeof op.ts === "string" ? op.ts : new Date().toISOString();
+export const getEventIdFromOp = (op) => typeof op.eventId === "string" ? op.eventId : (typeof op.__event_id === "string" ? op.__event_id : "");
+export const compareOpOrder = (a, b) => {
+    const t = getTsFromOp(a).localeCompare(getTsFromOp(b));
+    if (t !== 0)
+        return t;
+    const eventCmp = getEventIdFromOp(a).localeCompare(getEventIdFromOp(b));
+    if (eventCmp !== 0)
+        return eventCmp;
+    return 0;
+};
+export const compareSyncOrder = (a, b) => {
+    const t = a.ts.localeCompare(b.ts);
+    if (t !== 0)
+        return t;
+    return (a.eventId ?? "").localeCompare(b.eventId ?? "");
+};
+export const toSyncEvent = (op, streamId, seq) => {
+    const type = opToSyncEventType(op);
+    if (!type)
+        return null;
+    return {
+        event_id: generateUlid(),
+        stream_id: streamId,
+        seq,
+        ts: getTsFromOp(op),
+        type,
+        entity_id: entityIdFromV1Op(op),
+        v: 2,
+        payload: op,
+    };
+};
+export const syncEventToV1Op = (event) => {
+    if (!event.payload || typeof event.payload !== "object")
+        return null;
+    const payload = event.payload;
+    return typeof payload.op === "string" ? payload : null;
+};
+export const emptyV1Buckets = () => ({
+    tasks: [],
+    learnings: [],
+    fileLearnings: [],
+    attempts: [],
+    pins: [],
+    anchors: [],
+    edges: [],
+    docs: [],
+    labels: [],
+});
+export const bucketForOp = (opName) => {
+    if (opName === "upsert" || opName === "delete" || opName === "dep_add" || opName === "dep_remove")
+        return "tasks";
+    if (opName === "learning_upsert" || opName === "learning_delete")
+        return "learnings";
+    if (opName === "file_learning_upsert" || opName === "file_learning_delete")
+        return "fileLearnings";
+    if (opName === "attempt_upsert")
+        return "attempts";
+    if (opName === "pin_upsert" || opName === "pin_delete")
+        return "pins";
+    if (opName === "anchor_upsert" || opName === "anchor_delete")
+        return "anchors";
+    if (opName === "edge_upsert" || opName === "edge_delete")
+        return "edges";
+    if (opName === "doc_upsert" || opName === "doc_delete" || opName === "doc_link_upsert" || opName === "task_doc_link_upsert" || opName === "invariant_upsert")
+        return "docs";
+    if (opName === "label_upsert" || opName === "label_assignment_upsert")
+        return "labels";
+    return null;
+};
+export const stateCategoryForOp = (opName) => {
+    if (opName === "upsert" || opName === "delete")
+        return "task";
+    if (opName === "dep_add" || opName === "dep_remove")
+        return "dep";
+    if (opName === "learning_upsert" || opName === "learning_delete")
+        return "learning";
+    if (opName === "file_learning_upsert" || opName === "file_learning_delete")
+        return "file_learning";
+    if (opName === "attempt_upsert")
+        return "attempt";
+    if (opName === "pin_upsert" || opName === "pin_delete")
+        return "pin";
+    if (opName === "anchor_upsert" || opName === "anchor_delete")
+        return "anchor";
+    if (opName === "edge_upsert" || opName === "edge_delete")
+        return "edge";
+    if (opName === "doc_upsert" || opName === "doc_delete")
+        return "doc";
+    if (opName === "doc_link_upsert")
+        return "doc_link";
+    if (opName === "task_doc_link_upsert")
+        return "task_doc_link";
+    if (opName === "invariant_upsert")
+        return "invariant";
+    if (opName === "label_upsert")
+        return "label";
+    if (opName === "label_assignment_upsert")
+        return "label_assignment";
+    return null;
+};
+export const isRemovalOp = (opName) => opName === "delete" ||
+    opName === "dep_remove" ||
+    opName === "learning_delete" ||
+    opName === "file_learning_delete" ||
+    opName === "pin_delete" ||
+    opName === "anchor_delete" ||
+    opName === "edge_delete" ||
+    opName === "doc_delete";
+export const stateKeyForOp = (op) => {
+    const opName = typeof op.op === "string" ? op.op : "";
+    const category = stateCategoryForOp(opName);
+    if (!category)
+        return null;
+    return `${category}:${entityIdFromV1Op(op)}`;
+};
+/**
+ * Topologically sort task operations so parents are processed before children.
+ */
+export function topologicalSortTasks(entries) {
+    const upsertEntries = entries.filter(([, { op }]) => op.op === "upsert");
+    const deleteEntries = entries.filter(([, { op }]) => op.op === "delete");
+    const importingIds = new Set(upsertEntries.map(([id]) => id));
+    const children = new Map();
+    for (const [id] of upsertEntries) {
+        children.set(id, []);
+    }
+    for (const [id, { op }] of upsertEntries) {
+        const parentId = op.data?.parentId;
+        if (parentId && importingIds.has(parentId)) {
+            const parentChildren = children.get(parentId);
+            if (parentChildren) {
+                parentChildren.push(id);
+            }
+        }
+    }
+    const inDegree = new Map();
+    for (const [id, { op }] of upsertEntries) {
+        const parentId = op.data?.parentId;
+        const hasParentInSet = parentId && importingIds.has(parentId);
+        inDegree.set(id, hasParentInSet ? 1 : 0);
+    }
+    const queue = [];
+    for (const [id, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(id);
+        }
+    }
+    const sorted = [];
+    const entryMap = new Map(upsertEntries);
+    while (queue.length > 0) {
+        const id = queue.shift();
+        const entry = entryMap.get(id);
+        if (entry) {
+            sorted.push([id, entry]);
+        }
+        const childIds = children.get(id) ?? [];
+        for (const childId of childIds) {
+            const currentDegree = inDegree.get(childId) ?? 0;
+            const newDegree = currentDegree - 1;
+            inDegree.set(childId, newDegree);
+            if (newDegree === 0) {
+                queue.push(childId);
+            }
+        }
+    }
+    if (sorted.length < upsertEntries.length) {
+        return [...upsertEntries, ...deleteEntries];
+    }
+    return [...sorted, ...deleteEntries];
+}
+//# sourceMappingURL=sync-helpers.js.map

package/dist/services/sync/sync-helpers.js.map

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

package/dist/services/sync/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Shared Sync service result types.
+ */
+/**
+ * Result of a dependency import operation.
+ */
+export type DependencyImportResult = {
+    readonly added: number;
+    readonly removed: number;
+    readonly skipped: number;
+    readonly failures: ReadonlyArray<{
+        blockerId: string;
+        blockedId: string;
+        error: string;
+    }>;
+};
+/**
+ * Result of an import operation.
+ */
+export type ImportResult = {
+    readonly imported: number;
+    readonly skipped: number;
+    readonly conflicts: number;
+    readonly dependencies: DependencyImportResult;
+};
+/**
+ * Result of importing a simple entity (no dependency sub-results).
+ */
+export type EntityImportResult = {
+    readonly imported: number;
+    readonly skipped: number;
+};
+/**
+ * Status of the sync system.
+ */
+export type SyncStatus = {
+    readonly dbTaskCount: number;
+    readonly eventOpCount: number;
+    readonly lastExport: Date | null;
+    readonly lastImport: Date | null;
+    readonly isDirty: boolean;
+    readonly autoSyncEnabled: boolean;
+};
+/**
+ * Result of event-log export.
+ */
+export type SyncExportResult = {
+    readonly eventCount: number;
+    readonly opCount: number;
+    readonly streamId: string;
+    readonly path: string;
+};
+/**
+ * Result of legacy task JSONL export.
+ */
+export type LegacySyncExportResult = {
+    readonly opCount: number;
+    readonly path: string;
+};
+/**
+ * Result of incremental event import.
+ */
+export type SyncImportResult = {
+    readonly importedEvents: number;
+    readonly appliedEvents: number;
+    readonly streamCount: number;
+    readonly imported: number;
+    readonly skipped: number;
+    readonly conflicts: number;
+    readonly dependencies: DependencyImportResult;
+};
+/**
+ * Result of full event rehydration.
+ */
+export type SyncHydrateResult = {
+    readonly importedEvents: number;
+    readonly appliedEvents: number;
+    readonly streamCount: number;
+    readonly rebuilt: boolean;
+};
+/**
+ * Result of compacting legacy task JSONL operations.
+ */
+export type SyncCompactResult = {
+    readonly before: number;
+    readonly after: number;
+    readonly path: string;
+};
+/**
+ * Stream metadata for sync.
+ */
+export type SyncStreamInfoResult = {
+    readonly streamId: string;
+    readonly nextSeq: number;
+    readonly lastSeq: number;
+    readonly eventsDir: string;
+    readonly configPath: string;
+    readonly knownStreams: ReadonlyArray<{
+        streamId: string;
+        lastSeq: number;
+        lastEventAt: string | null;
+    }>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/services/sync/types.d.ts.map

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

package/dist/services/sync/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared Sync service result types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/sync/types.js.map

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

package/dist/services/task-service/internals.d.ts

@@ -0,0 +1,36 @@
+import { Context, Effect } from "effect";
+import { TaskRepository } from "../../repo/task-repo.js";
+import { DependencyRepository } from "../../repo/dep-repo.js";
+import { GuardRepository } from "../../repo/guard-repo.js";
+import { PinRepository } from "../../repo/pin-repo.js";
+import { GuardExceededError, DatabaseError, StaleDataError, TaskNotFoundError } from "../../errors.js";
+import { readTxConfig } from "../../utils/toml-config.js";
+import type { Task, TaskId, TaskWithDeps } from "@jamesaphoenix/tx-types";
+type InternalDeps = {
+    readonly taskRepo: Context.Tag.Service<typeof TaskRepository>;
+    readonly depRepo: Context.Tag.Service<typeof DependencyRepository>;
+};
+/**
+ * Max recursion depth for destructive operations that must find ALL descendants.
+ * Bounded to avoid unbounded CTE recursion in SQLite while being deep enough
+ * for any realistic task hierarchy (display default is 10).
+ */
+export declare const CASCADE_MAX_DEPTH = 1000;
+export declare const listGateTaskLinks: (pinRepo: Context.Tag.Service<typeof PinRepository>) => Effect.Effect<ReadonlyMap<TaskId, readonly string[]>, DatabaseError>;
+/**
+ * Check guards before task creation. Returns advisory warnings (empty array if none).
+ * Advisory mode logs warnings to stderr and returns them for metadata injection;
+ * enforce mode fails with GuardExceededError.
+ */
+export declare const checkGuards: (guardRepo: Context.Tag.Service<typeof GuardRepository>, config: ReturnType<typeof readTxConfig>, parentId: string | null) => Effect.Effect<string[], GuardExceededError | DatabaseError>;
+export declare const enrichWithDeps: (deps: InternalDeps, task: Task) => Effect.Effect<TaskWithDeps, DatabaseError>;
+export declare const enrichWithDepsBatch: (deps: InternalDeps, tasks: readonly Task[]) => Effect.Effect<readonly TaskWithDeps[], DatabaseError>;
+/**
+ * Auto-complete parent task when all children are done.
+ * Optimized to use batch queries instead of N+1 recursive queries.
+ */
+export declare const autoCompleteParent: (taskRepo: Context.Tag.Service<typeof TaskRepository>, parentId: TaskId, now: Date, options?: {
+    readonly blockedTaskIds?: ReadonlySet<TaskId>;
+}) => Effect.Effect<void, DatabaseError | TaskNotFoundError | StaleDataError>;
+export {};
+//# sourceMappingURL=internals.d.ts.map

package/dist/services/task-service/internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../../src/services/task-service/internals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AASzE,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,cAAc,CAAC,CAAA;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,oBAAoB,CAAC,CAAA;CACnE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAmBrC,eAAO,MAAM,iBAAiB,GAC5B,SAAS,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,aAAa,CAAC,KACjD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,aAAa,CAiBlE,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,eAAe,CAAC,EACtD,QAAQ,UAAU,CAAC,OAAO,YAAY,CAAC,EACvC,UAAU,MAAM,GAAG,IAAI,KACtB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,kBAAkB,GAAG,aAAa,CAqFzD,CAAA;AAKJ,eAAO,MAAM,cAAc,GACzB,MAAM,YAAY,EAClB,MAAM,IAAI,KACT,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CA0BxC,CAAA;AAEJ,eAAO,MAAM,mBAAmB,GAC9B,MAAM,YAAY,EAClB,OAAO,SAAS,IAAI,EAAE,KACrB,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,aAAa,CA0DnD,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,cAAc,CAAC,EACpD,UAAU,MAAM,EAChB,KAAK,IAAI,EACT,UAAU;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,KAC1D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,iBAAiB,GAAG,cAAc,CAyErE,CAAA"}