@bosun-sh/logbook 1.1.0 → 2.0.1

package/dist/task/edit.js

@@ -0,0 +1,105 @@
+import { DefinitionOfDoneSchema, TaskEstimateSchema, TitleSchema, } from "../shared/schema/value-objects.js";
+import { nowIso } from "../shared/time.js";
+import { Effect } from "effect";
+import { error, validatePriority } from "./comments.js";
+import { TaskRepository } from "./ports.js";
+import { TaskSchema } from "./schema.js";
+export const editTask = (input) => Effect.gen(function* () {
+    const validationError = validateEditTaskInput(input);
+    if (validationError) {
+        return validationError;
+    }
+    const repo = (yield* TaskRepository);
+    const existing = yield* Effect.either(repo.findById(input.id));
+    if (existing._tag === "Left") {
+        return repositoryError(existing.left);
+    }
+    const changedFields = Object.keys(input).filter((key) => key !== "id");
+    if (changedFields.length === 0) {
+        return {
+            ok: true,
+            data: {
+                task: existing.right,
+            },
+        };
+    }
+    const now = yield* nowIso();
+    const taskCandidate = {
+        ...existing.right,
+        updatedAt: now,
+        ...(input.title === undefined ? {} : { title: input.title }),
+        ...(input.description === undefined ? {} : { description: input.description }),
+        ...(input.definitionOfReady === undefined
+            ? {}
+            : { definitionOfReady: input.definitionOfReady }),
+        ...(input.definitionOfDone === undefined ? {} : { definitionOfDone: input.definitionOfDone }),
+        ...(input.project === undefined ? {} : { project: input.project }),
+        ...(input.milestone === undefined ? {} : { milestone: input.milestone }),
+        ...(input.priority === undefined ? {} : { priority: input.priority }),
+        ...(input.estimate === undefined ? {} : { estimate: input.estimate }),
+    };
+    const parsed = TaskSchema.safeParse(taskCandidate);
+    if (!parsed.success) {
+        return error("validation_error", parsed.error.issues[0]?.message ?? "validation failed", {
+            issues: parsed.error.issues.map((issue) => issue.message),
+        });
+    }
+    const saved = yield* Effect.either(repo.update(parsed.data));
+    if (saved._tag === "Left") {
+        return repositoryError(saved.left);
+    }
+    return {
+        ok: true,
+        data: {
+            task: parsed.data,
+        },
+    };
+});
+const validateEditTaskInput = (input) => {
+    if (input.title !== undefined) {
+        const title = TitleSchema.safeParse(input.title);
+        if (!title.success) {
+            return error("validation_error", title.error.issues[0]?.message ?? "validation failed", {
+                issues: title.error.issues.map((issue) => issue.message),
+            });
+        }
+    }
+    if (input.definitionOfDone !== undefined) {
+        const definitionOfDone = DefinitionOfDoneSchema.safeParse(input.definitionOfDone);
+        if (!definitionOfDone.success) {
+            return error("validation_error", definitionOfDone.error.issues[0]?.message ?? "validation failed", {
+                issues: definitionOfDone.error.issues.map((issue) => issue.message),
+            });
+        }
+    }
+    if (input.priority !== undefined) {
+        const priorityError = validatePriority(input.priority);
+        if (priorityError) {
+            return priorityError;
+        }
+    }
+    if (input.project !== undefined && input.project.length === 0) {
+        return error("validation_error", "project must not be empty", { field: "project" });
+    }
+    if (input.milestone !== undefined && input.milestone.length === 0) {
+        return error("validation_error", "milestone must not be empty", { field: "milestone" });
+    }
+    if (input.estimate !== undefined) {
+        const estimate = TaskEstimateSchema.safeParse(input.estimate);
+        if (!estimate.success) {
+            return error("validation_error", estimate.error.issues[0]?.message ?? "validation failed", {
+                issues: estimate.error.issues.map((issue) => issue.message),
+            });
+        }
+    }
+    return null;
+};
+const repositoryError = (cause) => {
+    if (typeof cause === "object" && cause !== null && "_tag" in cause) {
+        const tagged = cause;
+        const details = Object.fromEntries(Object.entries(tagged).filter(([key]) => key !== "_tag" && key !== "message"));
+        return error(String(tagged._tag), typeof tagged.message === "string" ? tagged.message : "repository operation failed", Object.keys(details).length === 0 ? undefined : details);
+    }
+    return error("storage_error", "repository operation failed");
+};
+//# sourceMappingURL=edit.js.map

package/dist/task/edit.js.map

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

package/dist/task/estimate.d.ts

@@ -0,0 +1,20 @@
+import type { ToolResult } from "../shared/result.js";
+import type { TaskEstimate } from "../shared/schema/value-objects.js";
+import { type Clock, Effect } from "effect";
+import { TaskRepository } from "./ports.js";
+import { type Task } from "./schema.js";
+export type EstimateTaskInput = {
+    readonly id?: string | undefined;
+    readonly predictedKTokens: number;
+    readonly complexity: TaskEstimate["complexity"] | string;
+    readonly confidence?: TaskEstimate["confidence"] | undefined;
+    readonly rationale?: string | undefined;
+};
+type EstimateTaskResult = {
+    readonly estimate: TaskEstimate;
+    readonly task?: Task | undefined;
+};
+export declare const defaultTaskEstimate: (input: EstimateTaskInput) => ToolResult<TaskEstimate>;
+export declare const estimateTask: (input: EstimateTaskInput) => Effect.Effect<ToolResult<EstimateTaskResult>, never, TaskRepository | Clock.Clock>;
+export {};
+//# sourceMappingURL=estimate.d.ts.map

package/dist/task/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/task/estimate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAG3E,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,KAAK,IAAI,EAAc,MAAM,aAAa,CAAA;AAOnD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,MAAM,CAAA;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;CACjC,CAAA;AASD,eAAO,MAAM,mBAAmB,GAAI,OAAO,iBAAiB,KAAG,UAAU,CAAC,YAAY,CA0BrF,CAAA;AAED,eAAO,MAAM,YAAY,GACvB,OAAO,iBAAiB,KACvB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,KAAK,CAAC,KAAK,CAgDhF,CAAA"}

package/dist/task/estimate.js

@@ -0,0 +1,141 @@
+import { TaskEstimateSchema } from "../shared/schema/value-objects.js";
+import { nowIso } from "../shared/time.js";
+import { Effect } from "effect";
+import { error } from "./comments.js";
+import { TaskRepository } from "./ports.js";
+import { TaskSchema } from "./schema.js";
+const VALID_FIBONACCI = [1, 2, 3, 5, 8, 13, 21];
+const MAX_PREDICTED_KTOKENS = 64;
+const MAX_RATIONALE_BYTES = 4096;
+const textEncoder = new TextEncoder();
+export const defaultTaskEstimate = (input) => {
+    const validationError = validateEstimateInput(input);
+    if (validationError !== null) {
+        return validationError;
+    }
+    const fibonacci = nearestFibonacci(input.predictedKTokens);
+    const estimate = {
+        predictedKTokens: input.predictedKTokens,
+        complexity: input.complexity,
+        fibonacci,
+        confidence: input.confidence ?? "low",
+        ...(input.rationale === undefined ? {} : { rationale: input.rationale }),
+    };
+    const parsed = TaskEstimateSchema.safeParse(estimate);
+    if (!parsed.success) {
+        return error("validation_error", parsed.error.issues[0]?.message ?? "validation failed", {
+            issues: parsed.error.issues.map((issue) => issue.message),
+        });
+    }
+    return {
+        ok: true,
+        data: parsed.data,
+    };
+};
+export const estimateTask = (input) => Effect.gen(function* () {
+    const estimate = defaultTaskEstimate(input);
+    if (!estimate.ok) {
+        return estimate;
+    }
+    if (input.id === undefined) {
+        return {
+            ok: true,
+            data: {
+                estimate: estimate.data,
+            },
+        };
+    }
+    const repo = (yield* TaskRepository);
+    const task = yield* Effect.either(repo.findById(input.id));
+    if (task._tag === "Left") {
+        return repositoryError(task.left);
+    }
+    const now = yield* nowIso();
+    const updatedTaskCandidate = {
+        ...task.right,
+        updatedAt: now,
+        estimate: estimate.data,
+    };
+    const parsed = TaskSchema.safeParse(updatedTaskCandidate);
+    if (!parsed.success) {
+        return error("validation_error", parsed.error.issues[0]?.message ?? "validation failed", {
+            issues: parsed.error.issues.map((issue) => issue.message),
+        });
+    }
+    const saved = yield* Effect.either(repo.update(parsed.data));
+    if (saved._tag === "Left") {
+        return repositoryError(saved.left);
+    }
+    return {
+        ok: true,
+        data: {
+            estimate: estimate.data,
+            task: parsed.data,
+        },
+    };
+});
+const validateEstimateInput = (input) => {
+    if (!Number.isFinite(input.predictedKTokens) || !Number.isInteger(input.predictedKTokens)) {
+        return error("validation_error", "predictedKTokens must be an integer", {
+            predictedKTokens: input.predictedKTokens,
+        });
+    }
+    if (input.predictedKTokens <= 0) {
+        return error("validation_error", "predictedKTokens must be positive", {
+            predictedKTokens: input.predictedKTokens,
+        });
+    }
+    if (input.predictedKTokens > MAX_PREDICTED_KTOKENS) {
+        return error("validation_error", "predictedKTokens must be at most 64", {
+            predictedKTokens: input.predictedKTokens,
+            maxPredictedKTokens: MAX_PREDICTED_KTOKENS,
+        });
+    }
+    if (!isTaskEstimateComplexity(input.complexity)) {
+        return error("validation_error", "complexity is required", {
+            complexity: input.complexity,
+        });
+    }
+    if (input.confidence !== undefined && !isTaskEstimateConfidence(input.confidence)) {
+        return error("validation_error", "confidence must be low, medium, or high", {
+            confidence: input.confidence,
+        });
+    }
+    if (input.rationale !== undefined) {
+        const rationaleBytes = textEncoder.encode(input.rationale).length;
+        if (rationaleBytes > MAX_RATIONALE_BYTES) {
+            return error("validation_error", `rationale exceeds ${MAX_RATIONALE_BYTES} bytes`, {
+                maxBytes: MAX_RATIONALE_BYTES,
+                actualBytes: rationaleBytes,
+            });
+        }
+    }
+    return null;
+};
+const isTaskEstimateComplexity = (value) => value === "trivial" ||
+    value === "small" ||
+    value === "medium" ||
+    value === "large" ||
+    value === "complex";
+const isTaskEstimateConfidence = (value) => value === "low" || value === "medium" || value === "high";
+const nearestFibonacci = (value) => {
+    let nearest = VALID_FIBONACCI[0];
+    let minDistance = Math.abs(value - nearest);
+    for (const candidate of VALID_FIBONACCI) {
+        const distance = Math.abs(value - candidate);
+        if (distance < minDistance || (distance === minDistance && candidate > nearest)) {
+            nearest = candidate;
+            minDistance = distance;
+        }
+    }
+    return nearest;
+};
+const repositoryError = (cause) => {
+    if (typeof cause === "object" && cause !== null && "_tag" in cause) {
+        const tagged = cause;
+        const details = Object.fromEntries(Object.entries(tagged).filter(([key]) => key !== "_tag" && key !== "message"));
+        return error(String(tagged._tag), typeof tagged.message === "string" ? tagged.message : "repository operation failed", Object.keys(details).length === 0 ? undefined : details);
+    }
+    return error("storage_error", "repository operation failed");
+};
+//# sourceMappingURL=estimate.js.map

package/dist/task/estimate.js.map

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

package/dist/task/get.d.ts

@@ -0,0 +1,13 @@
+import type { ToolResult } from "../shared/result.js";
+import { Effect } from "effect";
+import { TaskRepository } from "./ports.js";
+import type { Task } from "./schema.js";
+export type GetTaskInput = {
+    readonly id: string;
+};
+type GetTaskResult = {
+    readonly task: Task;
+};
+export declare const getTask: (input: GetTaskInput) => Effect.Effect<ToolResult<GetTaskResult>, never, TaskRepository>;
+export {};
+//# sourceMappingURL=get.d.ts.map

package/dist/task/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/task/get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AASvC,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,OAAO,GAClB,OAAO,YAAY,KAClB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,cAAc,CAc7D,CAAA"}

package/dist/task/get.js

@@ -0,0 +1,29 @@
+import { Effect } from "effect";
+import { error } from "./comments.js";
+import { TaskRepository } from "./ports.js";
+export const getTask = (input) => Effect.gen(function* () {
+    const repo = (yield* TaskRepository);
+    const task = yield* Effect.either(repo.findById(input.id));
+    if (task._tag === "Left") {
+        return repositoryError(task.left);
+    }
+    return {
+        ok: true,
+        data: {
+            task: task.right,
+        },
+    };
+});
+const repositoryError = (cause) => {
+    if (typeof cause === "object" && cause !== null && "_tag" in cause) {
+        const tagged = cause;
+        const id = typeof tagged.id === "string"
+            ? tagged.id
+            : typeof tagged.taskId === "string"
+                ? tagged.taskId
+                : undefined;
+        return error(String(tagged._tag), typeof tagged.message === "string" ? tagged.message : "repository operation failed", id === undefined ? undefined : { id });
+    }
+    return error("storage_error", "repository operation failed");
+};
+//# sourceMappingURL=get.js.map

package/dist/task/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/task/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAkB3C,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAAmB,EAC8C,EAAE,CACnE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,cAAc,CAAmC,CAAA;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,KAAK;SACjB;KACF,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,eAAe,GAAG,CAAC,KAAc,EAAqB,EAAE;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,MAAM,EAAE,GACN,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;YAC3B,CAAC,CAAC,MAAM,CAAC,EAAE;YACX,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;gBACjC,CAAC,CAAC,MAAM,CAAC,MAAM;gBACf,CAAC,CAAC,SAAS,CAAA;QAEjB,OAAO,KAAK,CACV,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EACnB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,EACnF,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CACtC,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAC,eAAe,EAAE,6BAA6B,CAAC,CAAA;AAC9D,CAAC,CAAA"}

package/dist/task/hierarchy.d.ts

@@ -0,0 +1,18 @@
+import type { ToolResult } from "../shared/result.js";
+import type { Story } from "../story/schema.js";
+import { Effect } from "effect";
+import type { Task } from "./schema.js";
+type StoryRepositoryShape = {
+    create(story: Story): Effect.Effect<Story, unknown>;
+    get(id: string): Effect.Effect<Story, unknown>;
+    list(): Effect.Effect<readonly Story[], unknown>;
+    update(story: Story): Effect.Effect<Story, unknown>;
+    tombstone(id: string): Effect.Effect<Story, unknown>;
+};
+type AttachTaskHierarchyResult = {
+    readonly task: Task;
+    readonly story?: Story;
+};
+export declare const attachTaskHierarchy: (task: Task) => Effect.Effect<ToolResult<AttachTaskHierarchyResult>, never, StoryRepositoryShape>;
+export {};
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/task/hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/task/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,KAAK,oBAAoB,GAAG;IAC1B,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC9C,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;CACrD,CAAA;AAMD,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,MAAM,IAAI,KACT,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,oBAAoB,CA8D/E,CAAA"}

package/dist/task/hierarchy.js

@@ -0,0 +1,56 @@
+import { error, repositoryError } from "../story/rules.js";
+import { Context, Effect } from "effect";
+const StoryRepository = Context.GenericTag("StoryRepository");
+const HIERARCHY_REFERENCE_UPDATE_LIMIT = 1000;
+export const attachTaskHierarchy = (task) => Effect.gen(function* () {
+    if (task.storyId === undefined) {
+        return {
+            ok: true,
+            data: {
+                task,
+            },
+        };
+    }
+    const storyRepo = (yield* StoryRepository);
+    const parentStory = yield* Effect.either(storyRepo.get(task.storyId));
+    if (parentStory._tag === "Left") {
+        return repositoryError(parentStory.left);
+    }
+    if (parentStory.right.deletedAt !== undefined) {
+        return error("hierarchy_violation", `story ${task.storyId} is deleted`, {
+            storyId: task.storyId,
+        });
+    }
+    if (task.epicId !== undefined && task.epicId !== parentStory.right.epicId) {
+        return error("hierarchy_violation", `task epicId must match story ${task.storyId}`, {
+            epicId: task.epicId,
+            storyId: task.storyId,
+            storyEpicId: parentStory.right.epicId,
+        });
+    }
+    const nextTaskIds = parentStory.right.taskIds.includes(task.id)
+        ? [...parentStory.right.taskIds]
+        : [...parentStory.right.taskIds, task.id];
+    if (nextTaskIds.length > HIERARCHY_REFERENCE_UPDATE_LIMIT) {
+        return error("hierarchy_violation", `story ${task.storyId} exceeds the hierarchy reference update limit`, {
+            storyId: task.storyId,
+            limit: HIERARCHY_REFERENCE_UPDATE_LIMIT,
+        });
+    }
+    return {
+        ok: true,
+        data: {
+            task: task.epicId === undefined
+                ? {
+                    ...task,
+                    epicId: parentStory.right.epicId,
+                }
+                : task,
+            story: {
+                ...parentStory.right,
+                taskIds: nextTaskIds,
+            },
+        },
+    };
+});
+//# sourceMappingURL=hierarchy.js.map

package/dist/task/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../../src/task/hierarchy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAWxC,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAuB,iBAAiB,CAAC,CAAA;AAEnF,MAAM,gCAAgC,GAAG,IAAI,CAAA;AAO7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAAU,EACyE,EAAE,CACrF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,IAAI;aACL;SACF,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,eAAe,CAAoC,CAAA;IAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACrE,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC,qBAAqB,EAAE,SAAS,IAAI,CAAC,OAAO,aAAa,EAAE;YACtE,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC,qBAAqB,EAAE,gCAAgC,IAAI,CAAC,OAAO,EAAE,EAAE;YAClF,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;SACtC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;QAChC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IAE3C,IAAI,WAAW,CAAC,MAAM,GAAG,gCAAgC,EAAE,CAAC;QAC1D,OAAO,KAAK,CACV,qBAAqB,EACrB,SAAS,IAAI,CAAC,OAAO,+CAA+C,EACpE;YACE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,gCAAgC;SACxC,CACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,IAAI,EACF,IAAI,CAAC,MAAM,KAAK,SAAS;gBACvB,CAAC,CAAC;oBACE,GAAG,IAAI;oBACP,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;iBACjC;gBACH,CAAC,CAAC,IAAI;YACV,KAAK,EAAE;gBACL,GAAG,WAAW,CAAC,KAAK;gBACpB,OAAO,EAAE,WAAW;aACrB;SACF;KACF,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/task/lifecycle.d.ts

@@ -0,0 +1,14 @@
+import type { ToolResult } from "../shared/result.js";
+import type { Comment } from "../shared/schema/value-objects.js";
+import type { Task } from "./schema.js";
+type TaskStatus = Task["status"];
+type TransitionComment = Omit<Comment, "kind"> & {
+    readonly kind?: Comment["kind"];
+};
+type TransitionOptions = {
+    readonly now: string;
+    readonly comment?: TransitionComment | undefined;
+};
+export declare const transitionTaskStatus: (task: Task, nextStatus: TaskStatus, options: TransitionOptions) => ToolResult<Task>;
+export {};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/task/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/task/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAA;AAEtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,KAAK,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;AAChC,KAAK,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAA;AAEpF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CACjD,CAAA;AAaD,eAAO,MAAM,oBAAoB,GAC/B,MAAM,IAAI,EACV,YAAY,UAAU,EACtB,SAAS,iBAAiB,KACzB,UAAU,CAAC,IAAI,CA4CjB,CAAA"}

package/dist/task/lifecycle.js

@@ -0,0 +1,80 @@
+import { appendTaskComment, error, validateCommentContent, validatePriority } from "./comments.js";
+const allowedTransitions = {
+    backlog: ["todo", "canceled"],
+    todo: ["in_progress", "canceled"],
+    in_progress: ["need_info", "blocked", "pending_review", "canceled"],
+    need_info: ["in_progress", "canceled"],
+    blocked: ["in_progress", "canceled"],
+    pending_review: ["in_progress", "done", "canceled"],
+    done: [],
+    canceled: [],
+};
+export const transitionTaskStatus = (task, nextStatus, options) => {
+    const priorityError = validatePriority(task.priority);
+    if (priorityError) {
+        return priorityError;
+    }
+    if (task.status === nextStatus) {
+        return { ok: true, data: task };
+    }
+    if (!allowedTransitions[task.status].includes(nextStatus)) {
+        return error("invalid_transition", `cannot transition task from ${task.status} to ${nextStatus}`, {
+            from: task.status,
+            to: nextStatus,
+        });
+    }
+    const comment = normalizeTransitionComment(nextStatus, options.comment);
+    const commentError = validateTransitionComment(nextStatus, comment);
+    if (commentError) {
+        return commentError;
+    }
+    const nextTask = {
+        ...task,
+        status: nextStatus,
+        updatedAt: options.now,
+        ...(nextStatus === "in_progress" ? { inProgressSince: options.now } : {}),
+    };
+    const withoutStaleProgress = task.status === "in_progress" && nextStatus !== "in_progress"
+        ? clearInProgressSince(nextTask)
+        : nextTask;
+    if (!comment) {
+        return { ok: true, data: withoutStaleProgress };
+    }
+    return appendTaskComment(withoutStaleProgress, comment);
+};
+const normalizeTransitionComment = (nextStatus, comment) => {
+    if (!comment) {
+        return undefined;
+    }
+    if (comment.kind !== undefined) {
+        return comment;
+    }
+    if (nextStatus === "pending_review" || nextStatus === "done") {
+        return { ...comment, kind: "review" };
+    }
+    return { ...comment, kind: "regular" };
+};
+const validateTransitionComment = (nextStatus, comment) => {
+    if (comment) {
+        const contentError = validateCommentContent(comment.content);
+        if (contentError) {
+            return contentError;
+        }
+    }
+    if (nextStatus === "need_info") {
+        if (!comment || comment.kind !== "need_info") {
+            return error("validation_error", "need_info transitions require a need_info comment");
+        }
+    }
+    if (nextStatus === "blocked") {
+        if (!comment || (comment.kind !== "regular" && comment.kind !== "need_info")) {
+            return error("validation_error", "blocked transitions require a regular or need_info comment");
+        }
+    }
+    return null;
+};
+const clearInProgressSince = (task) => {
+    const { inProgressSince: _inProgressSince, ...rest } = task;
+    return rest;
+};
+//# sourceMappingURL=lifecycle.js.map

package/dist/task/lifecycle.js.map

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

package/dist/task/list.d.ts

@@ -0,0 +1,24 @@
+import { type PageCursor as EncodedPageCursor } from "../shared/pagination.js";
+import type { ToolResult } from "../shared/result.js";
+import { Effect } from "effect";
+import { TaskRepository } from "./ports.js";
+import type { Task } from "./schema.js";
+export type ListTasksInput = {
+    readonly status?: Task["status"] | "*";
+    readonly project?: string | undefined;
+    readonly milestone?: string | undefined;
+    readonly epicId?: string | undefined;
+    readonly storyId?: string | undefined;
+    readonly assigneeId?: string | undefined;
+    readonly sessionId?: string | undefined;
+    readonly limit?: number | undefined;
+    readonly cursor?: EncodedPageCursor | undefined;
+};
+type ListTasksResult = {
+    readonly items: readonly Task[];
+    readonly hasMore: boolean;
+    readonly nextCursor?: EncodedPageCursor | undefined;
+};
+export declare const listTasks: (input: ListTasksInput) => Effect.Effect<ToolResult<ListTasksResult>, never, TaskRepository>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/task/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/task/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAAc,MAAM,+BAA+B,CAAA;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAYvC,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAA;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAChD,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CACpD,CAAA;AAED,eAAO,MAAM,SAAS,GACpB,OAAO,cAAc,KACpB,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,cAAc,CAgE/D,CAAA"}