@deftai/directive-core 0.84.0 → 0.86.0

package/dist/review-monitor/constants.d.ts

@@ -1,14 +1,20 @@
-/** Deterministic review-monitor gate (#2655). Three-state exit contract. */
+/** Deterministic review-monitor gate (#2655 / #2814). Three-state exit contract. */
 export declare const EXIT_READY = 0;
 export declare const EXIT_NOT_READY = 1;
 export declare const EXIT_CONFIG_ERROR = 2;
+export declare const EXIT_CONFLICT = 1;
 export declare const SCHEMA_VERSION = 1;
+/** @deprecated Obsolete local ledger (#2814); retained for migration references only. */
 export declare const REVIEW_MONITOR_FILENAME = "review-monitor.json";
+/** @deprecated Obsolete local ledger (#2814). */
 export declare const REVIEW_MONITOR_RELPATH: readonly [".deft", "review-monitor.json"];
+export declare const REVIEW_OWNER_MARKER_START = "<!-- deft:review-owner -->";
+export declare const REVIEW_OWNER_MARKER_END = "<!-- /deft:review-owner -->";
 export declare const MONITORING_TIER_1 = 1;
 export declare const MONITORING_TIER_2 = 2;
 export declare const MONITORING_TIER_3 = 3;
 export declare const DEFAULT_STALE_MINUTES = 30;
 export declare const REVIEW_MONITOR_HELP: string;
 export declare const REGISTER_HELP: string;
+export declare const RELEASE_HELP: string;
 //# sourceMappingURL=constants.d.ts.map

package/dist/review-monitor/constants.js

@@ -1,24 +1,31 @@
-/** Deterministic review-monitor gate (#2655). Three-state exit contract. */
+/** Deterministic review-monitor gate (#2655 / #2814). Three-state exit contract. */
 export const EXIT_READY = 0;
 export const EXIT_NOT_READY = 1;
 export const EXIT_CONFIG_ERROR = 2;
+export const EXIT_CONFLICT = 1;
 export const SCHEMA_VERSION = 1;
+/** @deprecated Obsolete local ledger (#2814); retained for migration references only. */
 export const REVIEW_MONITOR_FILENAME = "review-monitor.json";
+/** @deprecated Obsolete local ledger (#2814). */
 export const REVIEW_MONITOR_RELPATH = [".deft", REVIEW_MONITOR_FILENAME];
+export const REVIEW_OWNER_MARKER_START = "<!-- deft:review-owner -->";
+export const REVIEW_OWNER_MARKER_END = "<!-- /deft:review-owner -->";
 export const MONITORING_TIER_1 = 1;
 export const MONITORING_TIER_2 = 2;
 export const MONITORING_TIER_3 = 3;
 export const DEFAULT_STALE_MINUTES = 30;
 export const REVIEW_MONITOR_HELP = "usage: task verify:review-monitor -- --pr <N> [options]\n" +
     "\n" +
-    "Fail-closed gate: when Tier 1 (sub-agent primitive available), require a\n" +
-    "recorded active review-monitor before the parent may yield, Approach-3\n" +
-    "sleep-poll, or claim review ownership (#2655).\n" +
+    "Fail-closed gate: when Tier 1 (sub-agent primitive available), require an\n" +
+    "unexpired GitHub review-owner lease (`<!-- deft:review-owner -->` sticky\n" +
+    "PR comment) before the parent may yield, Approach-3 sleep-poll, or claim\n" +
+    "review ownership (#2655 / #2814). Legacy `.deft/review-monitor.json` is\n" +
+    "ignored and must not satisfy this gate.\n" +
     "\n" +
     "options:\n" +
     "  -h, --help                 Show this help and exit 0\n" +
     "  --pr N                     Pull request number (required unless --help)\n" +
-    "  --repo OWNER/REPO          Repository (optional audit field)\n" +
+    "  --repo OWNER/REPO          Repository (optional; inferred from origin)\n" +
     "  --head-sha SHA             Expected HEAD SHA (optional freshness check)\n" +
     "  --project-root PATH        Project root (default: cwd)\n" +
     "  --call-site SITE           solo | swarm-phase5-6 | swarm-phase6-cascade\n" +
@@ -27,18 +34,22 @@ export const REVIEW_MONITOR_HELP = "usage: task verify:review-monitor -- --pr <N
     "  --json                     Emit structured JSON on stdout\n" +
     "\n" +
     "exit codes:\n" +
-    "  0  READY       Tier 1 monitor recorded, or Tier 3 Approach 3 with warning ack\n" +
-    "  1  NOT READY   Tier 1 without monitor, or Approach 3 blocked on Tier 1\n" +
-    "  2  CONFIG      Usage / path / unreadable state error\n" +
+    "  0  READY       Tier 1 GitHub lease active, or Tier 3 Approach 3 with warning ack\n" +
+    "  1  NOT READY   Tier 1 without GitHub lease, or Approach 3 blocked on Tier 1\n" +
+    "  2  CONFIG      Usage / path / GitHub fetch error\n" +
     "\n" +
-    "Register a monitor after spawning Approach 1:\n" +
+    "Claim a lease after spawning Approach 1:\n" +
     "  task review-monitor:register -- --pr <N> --monitor-agent-id <id> \\\n" +
     "    --platform-primitive cursor-task|spawn_subagent|start_agent \\\n" +
-    "    [--head-sha SHA] [--repo OWNER/REPO]\n";
+    "    [--head-sha SHA] [--repo OWNER/REPO] [--force]\n" +
+    "\n" +
+    "Release when done:\n" +
+    "  task review-monitor:release -- --pr <N> [--monitor-agent-id <id>]\n";
 export const REGISTER_HELP = "usage: task review-monitor:register -- --pr <N> --monitor-agent-id <id> \\\n" +
     "       --platform-primitive <primitive> [options]\n" +
     "\n" +
-    "Record an active review-monitor after spawning an Approach 1 poller (#2655).\n" +
+    "Claim the PR-anchored review-owner lease via a sticky GitHub PR comment\n" +
+    "(`<!-- deft:review-owner -->`). Does not write `.deft/review-monitor.json` (#2814).\n" +
     "\n" +
     "required:\n" +
     "  --pr N                     Pull request number\n" +
@@ -46,10 +57,25 @@ export const REGISTER_HELP = "usage: task review-monitor:register -- --pr <N> --
     "  --platform-primitive P     start_agent | spawn_subagent | cursor-task\n" +
     "\n" +
     "options:\n" +
-    "  --repo OWNER/REPO          Repository\n" +
+    "  --repo OWNER/REPO          Repository (default: origin / DEFT_TRIAGE_REPO)\n" +
+    "  --owner LOGIN              GitHub login for claim (default: gh api user)\n" +
     "  --head-sha SHA             HEAD SHA at monitor start\n" +
     "  --project-root PATH        Project root (default: cwd)\n" +
-    "  --parent-session-id ID     Optional parent ritual / session id\n" +
+    "  --parent-session-id ID     Optional parent ritual / session id (audit only)\n" +
+    "  --force                    Take over a non-expired foreign lease (loud)\n" +
+    "\n" +
+    "exit codes: 0 claimed / 1 conflict / 2 config error\n";
+export const RELEASE_HELP = "usage: task review-monitor:release -- --pr <N> [options]\n" +
+    "\n" +
+    "End the PR-anchored review-owner lease by editing the sticky GitHub comment\n" +
+    "in place (#2814).\n" +
+    "\n" +
+    "options:\n" +
+    "  --pr N                     Pull request number (required)\n" +
+    "  --repo OWNER/REPO          Repository (default: origin / DEFT_TRIAGE_REPO)\n" +
+    "  --monitor-agent-id ID      Release only when this monitor holds the lease\n" +
+    "  --owner LOGIN              Release only when this GitHub login holds the lease\n" +
+    "  --project-root PATH        Project root (default: cwd)\n" +
     "\n" +
-    "exit codes: 0 registered / 2 config error\n";
+    "exit codes: 0 released / 1 held-by-other / 2 config error\n";
 //# sourceMappingURL=constants.js.map

package/dist/review-monitor/github-lease.d.ts

@@ -0,0 +1,45 @@
+import { type GhRestSeams } from "../scm/gh-rest.js";
+import { type IssueComment } from "../umbrella-current-shape/index.js";
+import { type ReviewOwnerComment } from "./lease-comment.js";
+export type { IssueComment };
+export interface ReviewOwnerGithubSeams extends GhRestSeams {
+    readonly fetchComments?: (repo: string, pr: number) => IssueComment[] | {
+        error: string;
+    };
+    readonly createComment?: (repo: string, pr: number, body: string) => {
+        id: number;
+    } | {
+        error: string;
+    };
+    readonly updateComment?: (repo: string, commentId: number, body: string) => {
+        ok: true;
+    } | {
+        error: string;
+    };
+    readonly deleteComment?: (repo: string, commentId: number) => {
+        ok: true;
+    } | {
+        error: string;
+    };
+    readonly getGitHubLogin?: () => string | null;
+}
+export declare function listReviewOwnerComments(repo: string, pr: number, seams?: ReviewOwnerGithubSeams): ReviewOwnerComment[] | {
+    error: string;
+};
+export declare function createReviewOwnerComment(repo: string, pr: number, body: string, seams?: ReviewOwnerGithubSeams): {
+    id: number;
+} | {
+    error: string;
+};
+export declare function updateReviewOwnerComment(repo: string, commentId: number, body: string, seams?: ReviewOwnerGithubSeams): {
+    ok: true;
+} | {
+    error: string;
+};
+export declare function deleteReviewOwnerComment(repo: string, commentId: number, seams?: ReviewOwnerGithubSeams): {
+    ok: true;
+} | {
+    error: string;
+};
+export declare function resolveGitHubLogin(seams?: ReviewOwnerGithubSeams): string | null;
+//# sourceMappingURL=github-lease.d.ts.map

package/dist/review-monitor/github-lease.js

@@ -0,0 +1,106 @@
+import { spawnSync } from "node:child_process";
+import { resolveBinary } from "../scm/binary.js";
+import { DEFAULT_TIMEOUT_S, restDeleteComment, restGetUser, restPostComment, restUpdateComment, } from "../scm/gh-rest.js";
+import { SUBPROCESS_MAX_BUFFER } from "../subprocess/max-buffer.js";
+import { isMaintainerAuthored, parseCommentsFromGhStdout, } from "../umbrella-current-shape/index.js";
+import { mapCommentEntry } from "./lease-comment.js";
+function defaultFetchComments(repo, pr, seams) {
+    const binary = resolveBinary(seams.whichFn);
+    const path = `repos/${repo}/issues/${pr}/comments?per_page=100`;
+    const proc = spawnSync(binary, ["api", "--paginate", path], {
+        encoding: "utf8",
+        maxBuffer: SUBPROCESS_MAX_BUFFER,
+        timeout: DEFAULT_TIMEOUT_S * 1000,
+    });
+    if (proc.error !== undefined) {
+        return { error: `fetch PR #${pr} comments (${repo}) failed: ${proc.error.message}` };
+    }
+    if (proc.status !== 0) {
+        return {
+            error: `fetch PR #${pr} comments (${repo}) failed: ${(proc.stderr || proc.stdout || "").trim()}`,
+        };
+    }
+    try {
+        return parseCommentsFromGhStdout(String(proc.stdout ?? ""));
+    }
+    catch (exc) {
+        return {
+            error: `fetch PR #${pr} comments (${repo}) returned non-JSON: ${String(exc)}`,
+        };
+    }
+}
+export function listReviewOwnerComments(repo, pr, seams = {}) {
+    const fetcher = seams.fetchComments ?? ((r, n) => defaultFetchComments(r, n, seams));
+    const fetched = fetcher(repo, pr);
+    if (!Array.isArray(fetched)) {
+        return fetched;
+    }
+    const comments = [];
+    for (const entry of fetched) {
+        if (!isMaintainerAuthored(entry.authorAssociation)) {
+            continue;
+        }
+        const mapped = mapCommentEntry({
+            id: entry.id,
+            body: entry.body,
+            created_at: entry.updatedAt,
+        });
+        if (mapped !== null) {
+            comments.push(mapped);
+        }
+    }
+    return comments;
+}
+export function createReviewOwnerComment(repo, pr, body, seams = {}) {
+    if (seams.createComment !== undefined) {
+        return seams.createComment(repo, pr, body);
+    }
+    try {
+        const created = restPostComment(repo, pr, body, seams);
+        const id = created.id;
+        if (typeof id !== "number") {
+            return { error: "create comment: response missing id" };
+        }
+        return { id };
+    }
+    catch (exc) {
+        return { error: String(exc.message ?? exc) };
+    }
+}
+export function updateReviewOwnerComment(repo, commentId, body, seams = {}) {
+    if (seams.updateComment !== undefined) {
+        return seams.updateComment(repo, commentId, body);
+    }
+    try {
+        restUpdateComment(repo, commentId, body, seams);
+        return { ok: true };
+    }
+    catch (exc) {
+        return { error: String(exc.message ?? exc) };
+    }
+}
+export function deleteReviewOwnerComment(repo, commentId, seams = {}) {
+    if (seams.deleteComment !== undefined) {
+        return seams.deleteComment(repo, commentId);
+    }
+    try {
+        restDeleteComment(repo, commentId, seams);
+        return { ok: true };
+    }
+    catch (exc) {
+        return { error: String(exc.message ?? exc) };
+    }
+}
+export function resolveGitHubLogin(seams = {}) {
+    if (seams.getGitHubLogin !== undefined) {
+        return seams.getGitHubLogin();
+    }
+    try {
+        const user = restGetUser(seams);
+        return typeof user.login === "string" && user.login.length > 0 ? user.login : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=github-lease.js.map

package/dist/review-monitor/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./constants.js";
+export * from "./github-lease.js";
+export * from "./lease-comment.js";
 export * from "./record.js";
 export * from "./tier-detection.js";
 export * from "./verify.js";

package/dist/review-monitor/index.js

@@ -1,4 +1,6 @@
 export * from "./constants.js";
+export * from "./github-lease.js";
+export * from "./lease-comment.js";
 export * from "./record.js";
 export * from "./tier-detection.js";
 export * from "./verify.js";

package/dist/review-monitor/lease-comment.d.ts

@@ -0,0 +1,36 @@
+import type { PlatformPrimitive } from "./tier-detection.js";
+export declare function parseIso8601Utc(value: string): Date | null;
+export interface ReviewOwnerLease {
+    readonly owner: string;
+    readonly monitor_agent_id: string;
+    readonly head_sha: string | null;
+    readonly started_at: string;
+    readonly expires_at: string;
+    readonly platform_primitive: PlatformPrimitive;
+    readonly ended_at: string | null;
+}
+export interface ReviewOwnerComment {
+    readonly id: number;
+    readonly body: string;
+    readonly createdAt: string;
+    readonly lease: ReviewOwnerLease | null;
+}
+/** True when the comment body contains the review-owner marker block. */
+export declare function hasReviewOwnerMarker(body: string): boolean;
+export declare function parseReviewOwnerLease(body: string): ReviewOwnerLease | null;
+export declare function renderReviewOwnerComment(lease: ReviewOwnerLease): string;
+export declare function renderReleasedReviewOwnerComment(endedAt: string): string;
+export declare function computeExpiresAt(startedAt: Date, staleMinutes?: number): string;
+export declare function isLeaseActive(lease: ReviewOwnerLease, options?: {
+    now?: Date;
+    headSha?: string | null;
+}): boolean;
+export declare function isLeaseExpired(lease: ReviewOwnerLease, now?: Date): boolean;
+export declare function mapCommentEntry(entry: unknown): ReviewOwnerComment | null;
+/** Oldest comment id wins create-race resolution (#2814). */
+export declare function selectWinningReviewOwnerComment(comments: readonly ReviewOwnerComment[]): ReviewOwnerComment | null;
+export declare function findActiveLeaseComment(comments: readonly ReviewOwnerComment[], options?: {
+    now?: Date;
+    headSha?: string | null;
+}): ReviewOwnerComment | null;
+//# sourceMappingURL=lease-comment.d.ts.map

package/dist/review-monitor/lease-comment.js

@@ -0,0 +1,152 @@
+import { DEFAULT_STALE_MINUTES, REVIEW_OWNER_MARKER_END, REVIEW_OWNER_MARKER_START, } from "./constants.js";
+export function parseIso8601Utc(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        return null;
+    }
+    const trimmed = value.trim();
+    let candidate = trimmed;
+    if (trimmed.endsWith("Z")) {
+        candidate = `${trimmed.slice(0, -1)}+00:00`;
+    }
+    if (!candidate.endsWith("+00:00")) {
+        return null;
+    }
+    const parsed = new Date(candidate);
+    if (Number.isNaN(parsed.getTime())) {
+        return null;
+    }
+    return parsed;
+}
+const FIELD_RE = /^(owner|monitor_agent_id|head_sha|started_at|expires_at|platform_primitive|ended_at):\s*(.*)$/;
+/** True when the comment body contains the review-owner marker block. */
+export function hasReviewOwnerMarker(body) {
+    return body.includes(REVIEW_OWNER_MARKER_START);
+}
+function parseFieldBlock(body) {
+    const start = body.indexOf(REVIEW_OWNER_MARKER_START);
+    const end = body.indexOf(REVIEW_OWNER_MARKER_END);
+    if (start < 0 || end < 0 || end <= start) {
+        return {};
+    }
+    const block = body.slice(start + REVIEW_OWNER_MARKER_START.length, end);
+    const fields = {};
+    for (const line of block.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            continue;
+        }
+        const match = FIELD_RE.exec(trimmed);
+        if (match?.[1] !== undefined) {
+            fields[match[1]] = (match[2] ?? "").trim();
+        }
+    }
+    return fields;
+}
+export function parseReviewOwnerLease(body) {
+    const fields = parseFieldBlock(body);
+    const owner = fields.owner ?? "";
+    const monitorAgentId = fields.monitor_agent_id ?? "";
+    const startedAt = fields.started_at ?? "";
+    const expiresAt = fields.expires_at ?? "";
+    const platformPrimitive = fields.platform_primitive ?? "";
+    if (owner.length === 0 ||
+        monitorAgentId.length === 0 ||
+        startedAt.length === 0 ||
+        expiresAt.length === 0 ||
+        platformPrimitive.length === 0) {
+        return null;
+    }
+    const headShaRaw = fields.head_sha ?? "";
+    const endedAtRaw = fields.ended_at ?? "";
+    return {
+        owner,
+        monitor_agent_id: monitorAgentId,
+        head_sha: headShaRaw.length > 0 ? headShaRaw : null,
+        started_at: startedAt,
+        expires_at: expiresAt,
+        platform_primitive: platformPrimitive,
+        ended_at: endedAtRaw.length > 0 ? endedAtRaw : null,
+    };
+}
+export function renderReviewOwnerComment(lease) {
+    const headShaLine = lease.head_sha !== null && lease.head_sha.length > 0
+        ? `head_sha: ${lease.head_sha}\n`
+        : "head_sha:\n";
+    const endedLine = lease.ended_at !== null && lease.ended_at.length > 0 ? `ended_at: ${lease.ended_at}\n` : "";
+    return (`${REVIEW_OWNER_MARKER_START}\n` +
+        `owner: ${lease.owner}\n` +
+        `monitor_agent_id: ${lease.monitor_agent_id}\n` +
+        headShaLine +
+        `started_at: ${lease.started_at}\n` +
+        `expires_at: ${lease.expires_at}\n` +
+        `platform_primitive: ${lease.platform_primitive}\n` +
+        endedLine +
+        `${REVIEW_OWNER_MARKER_END}`);
+}
+export function renderReleasedReviewOwnerComment(endedAt) {
+    return `${REVIEW_OWNER_MARKER_START}\n` + `ended_at: ${endedAt}\n` + `${REVIEW_OWNER_MARKER_END}`;
+}
+export function computeExpiresAt(startedAt, staleMinutes = DEFAULT_STALE_MINUTES) {
+    return new Date(startedAt.getTime() + staleMinutes * 60 * 1000).toISOString();
+}
+export function isLeaseActive(lease, options = {}) {
+    if (lease.ended_at !== null) {
+        return false;
+    }
+    const started = parseIso8601Utc(lease.started_at);
+    const expires = parseIso8601Utc(lease.expires_at);
+    const now = options.now ?? new Date();
+    if (started === null || expires === null) {
+        return false;
+    }
+    if (now.getTime() > expires.getTime()) {
+        return false;
+    }
+    if (options.headSha !== undefined && options.headSha !== null && lease.head_sha !== null) {
+        return lease.head_sha === options.headSha;
+    }
+    return true;
+}
+export function isLeaseExpired(lease, now = new Date()) {
+    if (lease.ended_at !== null) {
+        return true;
+    }
+    const expires = parseIso8601Utc(lease.expires_at);
+    if (expires === null) {
+        return true;
+    }
+    return now.getTime() > expires.getTime();
+}
+export function mapCommentEntry(entry) {
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+        return null;
+    }
+    const rec = entry;
+    if (typeof rec.id !== "number" || typeof rec.body !== "string") {
+        return null;
+    }
+    if (!hasReviewOwnerMarker(rec.body)) {
+        return null;
+    }
+    return {
+        id: rec.id,
+        body: rec.body,
+        createdAt: typeof rec.created_at === "string" ? rec.created_at : "",
+        lease: parseReviewOwnerLease(rec.body),
+    };
+}
+/** Oldest comment id wins create-race resolution (#2814). */
+export function selectWinningReviewOwnerComment(comments) {
+    if (comments.length === 0) {
+        return null;
+    }
+    return [...comments].sort((a, b) => a.id - b.id)[0] ?? null;
+}
+export function findActiveLeaseComment(comments, options = {}) {
+    const active = comments.filter((comment) => comment.lease !== null && isLeaseActive(comment.lease, options));
+    if (active.length === 0) {
+        return null;
+    }
+    return selectWinningReviewOwnerComment(active);
+}
+//# sourceMappingURL=lease-comment.js.map

package/dist/review-monitor/record.d.ts

@@ -1,26 +1,27 @@
+import { EXIT_CONFIG_ERROR, EXIT_CONFLICT, EXIT_READY } from "./constants.js";
+import { type ReviewOwnerGithubSeams } from "./github-lease.js";
+import { parseIso8601Utc } from "./lease-comment.js";
 import type { PlatformPrimitive } from "./tier-detection.js";
+export { parseIso8601Utc };
+/** Legacy shape retained for verify JSON compatibility (#2655 / #2814). */
 export interface ReviewMonitorRecord {
     readonly pr: number;
     readonly repo: string | null;
     readonly head_sha: string | null;
     readonly platform_primitive: PlatformPrimitive;
     readonly monitor_agent_id: string;
+    readonly owner: string;
     readonly started_at: string;
-    readonly worktree_path: string;
+    readonly expires_at: string;
+    readonly worktree_path: string | null;
     readonly parent_session_id: string | null;
     readonly ended_at: string | null;
+    readonly comment_id: number | null;
 }
 export interface ReviewMonitorFile {
     readonly schema_version: number;
     readonly records: ReviewMonitorRecord[];
 }
-export declare function reviewMonitorPath(projectRoot: string): string;
-export declare function emptyReviewMonitorFile(): ReviewMonitorFile;
-export declare function readReviewMonitorFile(path: string): {
-    data: ReviewMonitorFile | null;
-    error: string | null;
-};
-export declare function writeReviewMonitorFile(path: string, data: ReviewMonitorFile): void;
 export interface RegisterReviewMonitorInput {
     readonly pr: number;
     readonly repo?: string | null;
@@ -29,13 +30,43 @@ export interface RegisterReviewMonitorInput {
     readonly monitorAgentId: string;
     readonly projectRoot: string;
     readonly parentSessionId?: string | null;
+    readonly owner?: string | null;
     readonly startedAt?: Date;
+    readonly staleMinutes?: number;
+    readonly force?: boolean;
+    readonly seams?: ReviewOwnerGithubSeams;
 }
-export declare function registerReviewMonitor(input: RegisterReviewMonitorInput): {
-    path: string;
-    record: ReviewMonitorRecord;
-};
-export declare function parseIso8601Utc(value: string): Date | null;
+export interface RegisterReviewMonitorResult {
+    readonly exitCode: typeof EXIT_READY | typeof EXIT_CONFLICT | typeof EXIT_CONFIG_ERROR;
+    readonly message: string;
+    readonly record: ReviewMonitorRecord | null;
+    readonly commentId: number | null;
+    readonly priorOwner: string | null;
+}
+export interface ReleaseReviewMonitorInput {
+    readonly pr: number;
+    readonly repo?: string | null;
+    readonly monitorAgentId?: string | null;
+    readonly owner?: string | null;
+    readonly projectRoot: string;
+    readonly endedAt?: Date;
+    readonly seams?: ReviewOwnerGithubSeams;
+}
+export interface ReleaseReviewMonitorResult {
+    readonly exitCode: typeof EXIT_READY | typeof EXIT_CONFLICT | typeof EXIT_CONFIG_ERROR;
+    readonly message: string;
+}
+export declare function registerReviewMonitor(input: RegisterReviewMonitorInput): RegisterReviewMonitorResult;
+export declare function releaseReviewMonitor(input: ReleaseReviewMonitorInput): ReleaseReviewMonitorResult;
+export declare function findActiveMonitorForPrFromComments(comments: readonly {
+    id: number;
+    body: string;
+}[], pr: number, options: {
+    now?: Date;
+    staleMinutes?: number;
+    headSha?: string | null;
+    repo?: string | null;
+}): ReviewMonitorRecord | null;
 export declare function isRecordActive(record: ReviewMonitorRecord, options: {
     now?: Date;
     staleMinutes?: number;
@@ -46,5 +77,22 @@ export declare function findActiveMonitorForPr(file: ReviewMonitorFile, pr: numb
     staleMinutes?: number;
     headSha?: string | null;
 }): ReviewMonitorRecord | null;
+export declare function emptyReviewMonitorFile(): ReviewMonitorFile;
+/** @deprecated Local `.deft/review-monitor.json` is obsolete (#2814); always empty. */
+export declare function readReviewMonitorFile(_path: string): {
+    data: ReviewMonitorFile | null;
+    error: string | null;
+};
+/** @deprecated Local `.deft/review-monitor.json` is obsolete (#2814); no-op. */
+export declare function writeReviewMonitorFile(_path: string, _data: ReviewMonitorFile): void;
+/** @deprecated Local `.deft/review-monitor.json` is obsolete (#2814). */
+export declare function reviewMonitorPath(projectRoot: string): string;
 export declare function defaultSubagentStatusDir(projectRoot: string): string;
+export declare function fetchActiveMonitorFromGithub(repo: string, pr: number, options?: {
+    now?: Date;
+    headSha?: string | null;
+    seams?: ReviewOwnerGithubSeams;
+}): ReviewMonitorRecord | null | {
+    error: string;
+};
 //# sourceMappingURL=record.d.ts.map