@kynetic-ai/spec 0.10.0 → 0.12.0

package/dist/parser/review-task-integration.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Review-task integration: sync rules and linkage.
+ *
+ * Implements the synchronization rules between review records and task
+ * lifecycle without replacing the lightweight task workflow model.
+ *
+ * AC: @review-task-lifecycle-integration ac-1 - review_ref linkage
+ * AC: @review-task-lifecycle-integration ac-2 - auto-set review_ref on task subject
+ * AC: @review-task-lifecycle-integration ac-3 - auto-set review_ref on related task
+ * AC: @review-task-lifecycle-integration ac-4 - verdict drives task transition
+ * AC: @review-task-lifecycle-integration ac-5 - inconsistent linkage warning
+ * AC: @review-task-lifecycle-integration ac-6 - history preserved through fix cycles
+ * AC: @review-task-lifecycle-integration ac-7 - external links as compatibility
+ */
+import type { ReviewRecord, ReviewVerdictDecision } from "../schema/index.js";
+import type { KspecContext, LoadedTask } from "./yaml.js";
+import { type LoadedReviewRecord } from "./reviews.js";
+/**
+ * Result of linking a review to task(s).
+ */
+export interface ReviewTaskLinkResult {
+    /** Tasks that had their review_ref updated. */
+    linkedTasks: Array<{
+        ulid: string;
+        slug?: string;
+    }>;
+}
+/**
+ * Link a newly created review to associated tasks by setting review_ref.
+ *
+ * AC: @review-task-lifecycle-integration ac-2 - task subject auto-link
+ * AC: @review-task-lifecycle-integration ac-3 - related_refs auto-link
+ *
+ * When a review is created with:
+ * - A task subject (type: "task"): sets review_ref on the subject task
+ * - related_refs containing task refs: sets review_ref on each related task
+ *
+ * Uses the first slug as the review ref, falling back to @ULID.
+ */
+export declare function linkReviewToTasks(ctx: KspecContext, review: ReviewRecord, allTasks: LoadedTask[]): Promise<ReviewTaskLinkResult>;
+/**
+ * Handle verdict-driven task transition.
+ *
+ * AC: @review-task-lifecycle-integration ac-4
+ *
+ * When a changes_requested verdict is recorded on a review:
+ * - If the review has a task subject, transition that task to needs_work
+ * - If the review has related task refs, transition those tasks to needs_work
+ *
+ * Only transitions tasks that are currently in pending_review.
+ * Returns the list of tasks that were transitioned.
+ */
+export declare function handleVerdictTaskTransition(ctx: KspecContext, review: ReviewRecord, decision: ReviewVerdictDecision, allTasks: LoadedTask[], reviewer?: string): Promise<Array<{
+    ulid: string;
+    slug?: string;
+    transitioned: boolean;
+}>>;
+/**
+ * Warning about inconsistent review linkage on a task.
+ *
+ * AC: @review-task-lifecycle-integration ac-5
+ */
+export interface ReviewLinkageWarning {
+    taskRef: string;
+    taskTitle: string;
+    message: string;
+}
+/**
+ * Check tasks for inconsistent review linkage.
+ *
+ * AC: @review-task-lifecycle-integration ac-5
+ *
+ * Surfaces warnings when:
+ * - A task is in pending_review with no review_ref
+ * - A task is in pending_review with a review_ref pointing at a closed/archived review
+ */
+export declare function checkReviewLinkageConsistency(tasks: LoadedTask[], reviews: LoadedReviewRecord[]): ReviewLinkageWarning[];
+//# sourceMappingURL=review-task-integration.d.ts.map

package/dist/parser/review-task-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-task-integration.d.ts","sourceRoot":"","sources":["../../src/parser/review-task-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAsC,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAoD/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAsExE;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,oBAAoB,EAAE,CAmCxB"}

package/dist/parser/review-task-integration.js

@@ -0,0 +1,173 @@
+/**
+ * Review-task integration: sync rules and linkage.
+ *
+ * Implements the synchronization rules between review records and task
+ * lifecycle without replacing the lightweight task workflow model.
+ *
+ * AC: @review-task-lifecycle-integration ac-1 - review_ref linkage
+ * AC: @review-task-lifecycle-integration ac-2 - auto-set review_ref on task subject
+ * AC: @review-task-lifecycle-integration ac-3 - auto-set review_ref on related task
+ * AC: @review-task-lifecycle-integration ac-4 - verdict drives task transition
+ * AC: @review-task-lifecycle-integration ac-5 - inconsistent linkage warning
+ * AC: @review-task-lifecycle-integration ac-6 - history preserved through fix cycles
+ * AC: @review-task-lifecycle-integration ac-7 - external links as compatibility
+ */
+import { createNote, getAuthor, mutateTaskAtomically } from "./yaml.js";
+import { findReviewByRef } from "./reviews.js";
+/**
+ * Link a newly created review to associated tasks by setting review_ref.
+ *
+ * AC: @review-task-lifecycle-integration ac-2 - task subject auto-link
+ * AC: @review-task-lifecycle-integration ac-3 - related_refs auto-link
+ *
+ * When a review is created with:
+ * - A task subject (type: "task"): sets review_ref on the subject task
+ * - related_refs containing task refs: sets review_ref on each related task
+ *
+ * Uses the first slug as the review ref, falling back to @ULID.
+ */
+export async function linkReviewToTasks(ctx, review, allTasks) {
+    const result = { linkedTasks: [] };
+    const reviewRef = review.slugs.length > 0
+        ? `@${review.slugs[0]}`
+        : `@${review._ulid}`;
+    // Collect task refs to link
+    const taskRefsToLink = new Set();
+    // AC: @review-task-lifecycle-integration ac-2 - task subject
+    if (review.subject.type === "task") {
+        taskRefsToLink.add(review.subject.ref);
+    }
+    // AC: @review-task-lifecycle-integration ac-3 - related_refs
+    for (const ref of review.related_refs) {
+        // Only link refs that resolve to tasks
+        const cleanRef = ref.startsWith("@") ? ref.slice(1) : ref;
+        const matchedTask = allTasks.find((t) => t._ulid === cleanRef ||
+            t._ulid.toLowerCase().startsWith(cleanRef.toLowerCase()) ||
+            t.slugs.includes(cleanRef));
+        if (matchedTask) {
+            taskRefsToLink.add(ref);
+        }
+    }
+    // Set review_ref on each matched task
+    for (const taskRef of taskRefsToLink) {
+        const cleanRef = taskRef.startsWith("@") ? taskRef.slice(1) : taskRef;
+        const task = allTasks.find((t) => t._ulid === cleanRef ||
+            t._ulid.toLowerCase().startsWith(cleanRef.toLowerCase()) ||
+            t.slugs.includes(cleanRef));
+        if (!task)
+            continue;
+        await mutateTaskAtomically(ctx, task, (latestTask) => ({
+            ...latestTask,
+            review_ref: reviewRef,
+        }));
+        result.linkedTasks.push({
+            ulid: task._ulid,
+            slug: task.slugs[0],
+        });
+    }
+    return result;
+}
+/**
+ * Handle verdict-driven task transition.
+ *
+ * AC: @review-task-lifecycle-integration ac-4
+ *
+ * When a changes_requested verdict is recorded on a review:
+ * - If the review has a task subject, transition that task to needs_work
+ * - If the review has related task refs, transition those tasks to needs_work
+ *
+ * Only transitions tasks that are currently in pending_review.
+ * Returns the list of tasks that were transitioned.
+ */
+export async function handleVerdictTaskTransition(ctx, review, decision, allTasks, reviewer) {
+    if (decision !== "request_changes") {
+        return [];
+    }
+    const results = [];
+    // Collect task refs from subject and related_refs
+    const taskRefsToCheck = new Set();
+    if (review.subject.type === "task") {
+        taskRefsToCheck.add(review.subject.ref);
+    }
+    for (const ref of review.related_refs) {
+        const cleanRef = ref.startsWith("@") ? ref.slice(1) : ref;
+        const matchedTask = allTasks.find((t) => t._ulid === cleanRef ||
+            t._ulid.toLowerCase().startsWith(cleanRef.toLowerCase()) ||
+            t.slugs.includes(cleanRef));
+        if (matchedTask) {
+            taskRefsToCheck.add(ref);
+        }
+    }
+    for (const taskRef of taskRefsToCheck) {
+        const cleanRef = taskRef.startsWith("@") ? taskRef.slice(1) : taskRef;
+        const task = allTasks.find((t) => t._ulid === cleanRef ||
+            t._ulid.toLowerCase().startsWith(cleanRef.toLowerCase()) ||
+            t.slugs.includes(cleanRef));
+        if (!task)
+            continue;
+        if (task.status !== "pending_review") {
+            results.push({ ulid: task._ulid, slug: task.slugs[0], transitioned: false });
+            continue;
+        }
+        // Count existing fix cycles for cycle numbering
+        const existingKickbacks = task.notes.filter((note) => note.content.includes("[FIX_CYCLE:")).length;
+        const cycleNumber = existingKickbacks + 1;
+        await mutateTaskAtomically(ctx, task, (latestTask) => {
+            if (latestTask.status !== "pending_review") {
+                return latestTask;
+            }
+            const note = createNote(`[FIX_CYCLE: ${cycleNumber}] Review verdict: changes_requested${reviewer ? ` by ${reviewer}` : ""}`, getAuthor(ctx.config?.identity?.author));
+            return {
+                ...latestTask,
+                status: "needs_work",
+                session_id: null,
+                notes: [...latestTask.notes, note],
+            };
+        });
+        results.push({ ulid: task._ulid, slug: task.slugs[0], transitioned: true });
+    }
+    return results;
+}
+/**
+ * Check tasks for inconsistent review linkage.
+ *
+ * AC: @review-task-lifecycle-integration ac-5
+ *
+ * Surfaces warnings when:
+ * - A task is in pending_review with no review_ref
+ * - A task is in pending_review with a review_ref pointing at a closed/archived review
+ */
+export function checkReviewLinkageConsistency(tasks, reviews) {
+    const warnings = [];
+    for (const task of tasks) {
+        if (task.status !== "pending_review")
+            continue;
+        const taskRef = task.slugs[0] ? `@${task.slugs[0]}` : `@${task._ulid}`;
+        if (!task.review_ref) {
+            warnings.push({
+                taskRef,
+                taskTitle: task.title,
+                message: `Task ${taskRef} is in pending_review but has no review_ref — review linkage is missing`,
+            });
+            continue;
+        }
+        // Check if review_ref points to a valid, non-closed review
+        const review = findReviewByRef(reviews, task.review_ref);
+        if (!review) {
+            warnings.push({
+                taskRef,
+                taskTitle: task.title,
+                message: `Task ${taskRef} has review_ref ${task.review_ref} but the review record was not found`,
+            });
+        }
+        else if (review.lifecycle_state === "closed" || review.lifecycle_state === "archived") {
+            warnings.push({
+                taskRef,
+                taskTitle: task.title,
+                message: `Task ${taskRef} is in pending_review but review_ref ${task.review_ref} is ${review.lifecycle_state}`,
+            });
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=review-task-integration.js.map

package/dist/parser/review-task-integration.js.map

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

package/dist/parser/review-threads.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Review thread operations.
+ *
+ * Provides functions to add threads (general or anchored), add replies,
+ * resolve/reopen threads, and compute review disposition based on
+ * unresolved blocking threads.
+ *
+ * AC: @review-comment-threads-and-anchors ac-1 - General thread creation
+ * AC: @review-comment-threads-and-anchors ac-2 - Code anchor threads
+ * AC: @review-comment-threads-and-anchors ac-3 - Structured anchor threads
+ * AC: @review-comment-threads-and-anchors ac-4 - Threaded replies
+ * AC: @review-comment-threads-and-anchors ac-5 - Thread kind field
+ * AC: @review-comment-threads-and-anchors ac-6 - Disposition computation
+ */
+import type { ReviewRecord, ReviewThread, ReviewThreadEntry, ReviewThreadKind, ReviewAnchor, ReviewDisposition } from "../schema/index.js";
+import type { LoadedReviewRecord } from "./reviews.js";
+import type { KspecContext } from "./yaml.js";
+export interface AddThreadInput {
+    author: string;
+    body: string;
+    kind?: ReviewThreadKind;
+    anchor?: ReviewAnchor;
+}
+export interface AddReplyInput {
+    threadUlid: string;
+    author: string;
+    body: string;
+}
+export interface ResolveThreadInput {
+    threadUlid: string;
+    actor: string;
+}
+/**
+ * Add a new thread to a review record.
+ *
+ * AC: @review-comment-threads-and-anchors ac-1 - General threads (no anchor)
+ * AC: @review-comment-threads-and-anchors ac-2 - Code anchor threads
+ * AC: @review-comment-threads-and-anchors ac-3 - Structured anchor threads
+ * AC: @review-comment-threads-and-anchors ac-5 - Thread kind field
+ */
+export declare function addThread(review: ReviewRecord, input: AddThreadInput): {
+    review: ReviewRecord;
+    thread: ReviewThread;
+};
+/**
+ * Add a reply to an existing thread.
+ *
+ * AC: @review-comment-threads-and-anchors ac-4 - Threaded replies
+ */
+export declare function addReply(review: ReviewRecord, input: AddReplyInput): {
+    review: ReviewRecord;
+    entry: ReviewThreadEntry;
+};
+/**
+ * Resolve a thread.
+ */
+export declare function resolveThread(review: ReviewRecord, input: ResolveThreadInput): ReviewRecord;
+/**
+ * Reopen a previously resolved thread.
+ */
+export declare function reopenThread(review: ReviewRecord, input: ResolveThreadInput): ReviewRecord;
+/**
+ * Compute review disposition based on unresolved threads.
+ *
+ * AC: @review-comment-threads-and-anchors ac-6
+ *
+ * Only unresolved threads with kind "blocker" prevent approval.
+ * Unresolved "nit" and "question" threads do not block.
+ */
+export declare function computeThreadDisposition(review: ReviewRecord): ReviewDisposition;
+/**
+ * Get unresolved blocking threads from a review.
+ */
+export declare function getUnresolvedBlockers(review: ReviewRecord): ReviewThread[];
+/**
+ * Get all unresolved threads from a review (any kind).
+ */
+export declare function getUnresolvedThreads(review: ReviewRecord): ReviewThread[];
+/**
+ * Add a thread to a review with atomic persistence.
+ */
+export declare function addThreadAtomic(ctx: KspecContext, review: LoadedReviewRecord, input: AddThreadInput): Promise<{
+    review: LoadedReviewRecord;
+    thread: ReviewThread;
+}>;
+/**
+ * Add a reply to a thread with atomic persistence.
+ */
+export declare function addReplyAtomic(ctx: KspecContext, review: LoadedReviewRecord, input: AddReplyInput): Promise<{
+    review: LoadedReviewRecord;
+    entry: ReviewThreadEntry;
+}>;
+/**
+ * Resolve a thread with atomic persistence.
+ */
+export declare function resolveThreadAtomic(ctx: KspecContext, review: LoadedReviewRecord, input: ResolveThreadInput): Promise<LoadedReviewRecord>;
+/**
+ * Reopen a thread with atomic persistence.
+ */
+export declare function reopenThreadAtomic(ctx: KspecContext, review: LoadedReviewRecord, input: ResolveThreadInput): Promise<LoadedReviewRecord>;
+//# sourceMappingURL=review-threads.d.ts.map

package/dist/parser/review-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-threads.d.ts","sourceRoot":"","sources":["../../src/parser/review-threads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EAEZ,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,cAAc,GACpB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAkChD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,aAAa,GACnB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAwCpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,kBAAkB,GACxB,YAAY,CA6Bd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,kBAAkB,GACxB,YAAY,CA6Bd;AAID;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,GACnB,iBAAiB,CAUnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,GACnB,YAAY,EAAE,CAIhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,GACnB,YAAY,EAAE,CAEhB;AAID;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,CAU/D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAUnE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}

package/dist/parser/review-threads.js

@@ -0,0 +1,222 @@
+/**
+ * Review thread operations.
+ *
+ * Provides functions to add threads (general or anchored), add replies,
+ * resolve/reopen threads, and compute review disposition based on
+ * unresolved blocking threads.
+ *
+ * AC: @review-comment-threads-and-anchors ac-1 - General thread creation
+ * AC: @review-comment-threads-and-anchors ac-2 - Code anchor threads
+ * AC: @review-comment-threads-and-anchors ac-3 - Structured anchor threads
+ * AC: @review-comment-threads-and-anchors ac-4 - Threaded replies
+ * AC: @review-comment-threads-and-anchors ac-5 - Thread kind field
+ * AC: @review-comment-threads-and-anchors ac-6 - Disposition computation
+ */
+import { ulid } from "ulid";
+import { mutateReviewAtomically } from "./reviews.js";
+// --- Event helpers ---
+function createEvent(eventType, actor, payload = {}) {
+    return {
+        _ulid: ulid(),
+        event_type: eventType,
+        actor,
+        timestamp: new Date().toISOString(),
+        payload,
+    };
+}
+// --- Thread operations ---
+/**
+ * Add a new thread to a review record.
+ *
+ * AC: @review-comment-threads-and-anchors ac-1 - General threads (no anchor)
+ * AC: @review-comment-threads-and-anchors ac-2 - Code anchor threads
+ * AC: @review-comment-threads-and-anchors ac-3 - Structured anchor threads
+ * AC: @review-comment-threads-and-anchors ac-5 - Thread kind field
+ */
+export function addThread(review, input) {
+    const now = new Date().toISOString();
+    const threadUlid = ulid();
+    const entryUlid = ulid();
+    const entry = {
+        _ulid: entryUlid,
+        author: input.author,
+        body: input.body,
+        created_at: now,
+    };
+    const thread = {
+        _ulid: threadUlid,
+        kind: input.kind ?? "nit",
+        entries: [entry],
+        ...(input.anchor ? { anchor: input.anchor } : {}),
+    };
+    const event = createEvent("thread_created", input.author, {
+        thread_ulid: threadUlid,
+        kind: thread.kind,
+        ...(input.anchor ? { anchor_type: input.anchor.type } : {}),
+    });
+    return {
+        review: {
+            ...review,
+            threads: [...review.threads, thread],
+            events: [...review.events, event],
+            updated_at: now,
+        },
+        thread,
+    };
+}
+/**
+ * Add a reply to an existing thread.
+ *
+ * AC: @review-comment-threads-and-anchors ac-4 - Threaded replies
+ */
+export function addReply(review, input) {
+    const now = new Date().toISOString();
+    const entryUlid = ulid();
+    const threadIndex = review.threads.findIndex((t) => t._ulid === input.threadUlid);
+    if (threadIndex === -1) {
+        throw new Error(`Thread not found: ${input.threadUlid}`);
+    }
+    const entry = {
+        _ulid: entryUlid,
+        author: input.author,
+        body: input.body,
+        created_at: now,
+    };
+    const updatedThread = {
+        ...review.threads[threadIndex],
+        entries: [...review.threads[threadIndex].entries, entry],
+    };
+    const updatedThreads = [...review.threads];
+    updatedThreads[threadIndex] = updatedThread;
+    const event = createEvent("thread_replied", input.author, {
+        thread_ulid: input.threadUlid,
+        entry_ulid: entryUlid,
+    });
+    return {
+        review: {
+            ...review,
+            threads: updatedThreads,
+            events: [...review.events, event],
+            updated_at: now,
+        },
+        entry,
+    };
+}
+/**
+ * Resolve a thread.
+ */
+export function resolveThread(review, input) {
+    const now = new Date().toISOString();
+    const threadIndex = review.threads.findIndex((t) => t._ulid === input.threadUlid);
+    if (threadIndex === -1) {
+        throw new Error(`Thread not found: ${input.threadUlid}`);
+    }
+    const updatedThread = {
+        ...review.threads[threadIndex],
+        resolved_at: now,
+        resolved_by: input.actor,
+    };
+    const updatedThreads = [...review.threads];
+    updatedThreads[threadIndex] = updatedThread;
+    const event = createEvent("thread_resolved", input.actor, {
+        thread_ulid: input.threadUlid,
+    });
+    return {
+        ...review,
+        threads: updatedThreads,
+        events: [...review.events, event],
+        updated_at: now,
+    };
+}
+/**
+ * Reopen a previously resolved thread.
+ */
+export function reopenThread(review, input) {
+    const now = new Date().toISOString();
+    const threadIndex = review.threads.findIndex((t) => t._ulid === input.threadUlid);
+    if (threadIndex === -1) {
+        throw new Error(`Thread not found: ${input.threadUlid}`);
+    }
+    const updatedThread = {
+        ...review.threads[threadIndex],
+        resolved_at: null,
+        resolved_by: null,
+    };
+    const updatedThreads = [...review.threads];
+    updatedThreads[threadIndex] = updatedThread;
+    const event = createEvent("thread_reopened", input.actor, {
+        thread_ulid: input.threadUlid,
+    });
+    return {
+        ...review,
+        threads: updatedThreads,
+        events: [...review.events, event],
+        updated_at: now,
+    };
+}
+// --- Disposition computation ---
+/**
+ * Compute review disposition based on unresolved threads.
+ *
+ * AC: @review-comment-threads-and-anchors ac-6
+ *
+ * Only unresolved threads with kind "blocker" prevent approval.
+ * Unresolved "nit" and "question" threads do not block.
+ */
+export function computeThreadDisposition(review) {
+    const hasUnresolvedBlockers = review.threads.some((t) => t.kind === "blocker" && !t.resolved_at);
+    if (hasUnresolvedBlockers) {
+        return "changes_requested";
+    }
+    return "pending";
+}
+/**
+ * Get unresolved blocking threads from a review.
+ */
+export function getUnresolvedBlockers(review) {
+    return review.threads.filter((t) => t.kind === "blocker" && !t.resolved_at);
+}
+/**
+ * Get all unresolved threads from a review (any kind).
+ */
+export function getUnresolvedThreads(review) {
+    return review.threads.filter((t) => !t.resolved_at);
+}
+// --- Atomic persistence wrappers ---
+/**
+ * Add a thread to a review with atomic persistence.
+ */
+export async function addThreadAtomic(ctx, review, input) {
+    let createdThread;
+    const updated = await mutateReviewAtomically(ctx, review, (latest) => {
+        const result = addThread(latest, input);
+        createdThread = result.thread;
+        return result.review;
+    });
+    return { review: updated, thread: createdThread };
+}
+/**
+ * Add a reply to a thread with atomic persistence.
+ */
+export async function addReplyAtomic(ctx, review, input) {
+    let createdEntry;
+    const updated = await mutateReviewAtomically(ctx, review, (latest) => {
+        const result = addReply(latest, input);
+        createdEntry = result.entry;
+        return result.review;
+    });
+    return { review: updated, entry: createdEntry };
+}
+/**
+ * Resolve a thread with atomic persistence.
+ */
+export async function resolveThreadAtomic(ctx, review, input) {
+    return mutateReviewAtomically(ctx, review, (latest) => resolveThread(latest, input));
+}
+/**
+ * Reopen a thread with atomic persistence.
+ */
+export async function reopenThreadAtomic(ctx, review, input) {
+    return mutateReviewAtomically(ctx, review, (latest) => reopenThread(latest, input));
+}
+//# sourceMappingURL=review-threads.js.map

package/dist/parser/review-threads.js.map

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

package/dist/parser/review-validation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Validation module for review records.
+ *
+ * Provides schema validation for review records, threads, checks, verdicts,
+ * events, and subject bindings. Used during parsing, persistence, and
+ * command mutation to ensure review data integrity.
+ *
+ * AC: @review-record-validation ac-1, ac-2
+ */
+import type { SchemaValidationError } from "./validate.js";
+/**
+ * Result of validating a single review record.
+ */
+export interface ReviewValidationResult {
+    valid: boolean;
+    errors: SchemaValidationError[];
+}
+/**
+ * Validate a single review record against the full ReviewRecordSchema.
+ * Use this when validating persisted or loaded review records.
+ *
+ * AC: @review-record-validation ac-1
+ */
+export declare function validateReviewRecord(data: unknown, source?: string): ReviewValidationResult;
+/**
+ * Validate review record input (for creating new reviews).
+ * Uses ReviewRecordInputSchema which has relaxed requirements.
+ *
+ * AC: @review-record-validation ac-1, ac-2
+ */
+export declare function validateReviewRecordInput(data: unknown, source?: string): ReviewValidationResult;
+/**
+ * Validate a reviews YAML file (project.reviews.yaml).
+ * Validates the file-level schema and each individual review record.
+ *
+ * AC: @review-record-validation ac-1, ac-2
+ */
+export declare function validateReviewsFile(filePath: string): Promise<SchemaValidationError[]>;
+/**
+ * Find review files in a directory (files matching *.reviews.yaml).
+ */
+export declare function findReviewFiles(dir: string): Promise<string[]>;
+/**
+ * Convenience: parse and validate a review record, returning the typed
+ * result on success or errors on failure.
+ *
+ * AC: @review-record-validation ac-1, ac-2
+ */
+export declare function parseReviewRecord(data: unknown, source?: string): {
+    ok: true;
+    data: import("../schema/review-records.js").ReviewRecord;
+} | {
+    ok: false;
+    errors: SchemaValidationError[];
+};
+/**
+ * Convenience: parse and validate review record input, returning the typed
+ * result on success or errors on failure.
+ *
+ * AC: @review-record-validation ac-1, ac-2
+ */
+export declare function parseReviewRecordInput(data: unknown, source?: string): {
+    ok: true;
+    data: import("../schema/review-records.js").ReviewRecordInput;
+} | {
+    ok: false;
+    errors: SchemaValidationError[];
+};
+//# sourceMappingURL=review-validation.d.ts.map