@opvs-ai/cli 0.27.0 → 0.27.2

package/README.md

@@ -195,6 +195,31 @@ opvs scheduled-runs cancel <id> --yes         # only a run that has not fired
 > admin only (403). `--run-at` must carry a zone (`Z` or `+02:00`); ids are full UUIDs. Cancel never disarms
 > a run that already fired — it returns the row unchanged, and the CLI says so.
 
+### Calendar
+
+Write a wake-up for the current agent, inspect what is open, or report that a wake finished:
+
+```bash
+opvs calendar wait --pr opvs-ai/OPVS#3470 --merged --title "pull request 3470 is merged"
+opvs calendar wait --card HEA-39 --status done --title "calendar CLI card is done"
+opvs calendar wait --mail --title "direct mail arrives"
+opvs calendar wait --mail-reply <message-id> --title "the owner replies"
+opvs calendar wait --box <environment-id> --version 0.2.140 --title "the box is upgraded"
+opvs calendar at 2026-10-20T18:00+02:00 --title "send the report"
+opvs calendar every 2h --title "check the queue" --ends 3x
+opvs calendar preview --every 1d --title "daily review"
+opvs calendar list [--owner me] [--status open]
+opvs calendar cancel <entry-id> --yes
+opvs calendar done --token <run-id>.<secret> [--no-work]
+```
+
+Times must include `Z` or an offset such as `+02:00`. Add `--deadline <zoned-time>`, repeatable
+`--remind who:how:anchor:minutes`, and `--note <words>` when registering an entry. For example,
+`--remind owner:notify:deadline:+1440` tells the owner one day after the deadline. Repeating entries
+are previewed before they are saved. Every calendar command accepts `--json`; `cancel` reads the
+entry's current version before writing and needs `--yes` when no terminal is attached. A direct-mail
+wait uses `OPVS_AGENT_ADDRESS`, then the address configured for `opvs mail`.
+
 ### Members
 
 ```bash
@@ -245,6 +270,30 @@ opvs tasks search -q OSB-78                # By ref, PR number (#1256), title, d
 opvs tasks search -q deploy --board OSB,ASP --status pending --column Review --offset 20
 ```
 
+#### Task schedules
+
+Tasks can carry a start time, repeat rule, and reminders alongside their due date:
+
+```bash
+opvs tasks create --board OPS -t "Send the weekly report" \
+  --start 2026-10-20T09:00+02:00 --timezone Europe/Berlin \
+  --repeat 1w --ends 8x \
+  --remind assignee:wake:fire:-15 \
+  --remind owner:notify:deadline:+1440 \
+  --due 2026-10-20T17:00+02:00
+
+opvs tasks update OPS-142 --no-schedule       # Clear the whole schedule
+opvs tasks get OPS-142                        # Schedule shown in words
+opvs tasks get OPS-142 --json                 # Raw API schedule object
+```
+
+`--start` and a timed `--due` must be ISO 8601 times with an explicit offset or
+`Z`. A bare due date such as `--due 2026-10-20` remains valid. `--timezone`
+takes an IANA name and is used for repeats across clock changes; when it is
+omitted, the CLI uses and prints the machine's timezone. Repeat intervals are
+`<N>d`, `<N>w`, or `<N>m`; repeat ends are `never`, a date, or `<N>x`.
+Each repeatable reminder is `who:how:anchor:minutes`.
+
 ### Comments
 
 ```bash

package/dist/.build-stamp.json

@@ -1,9 +1,9 @@
 {
   "stamp_version": 1,
   "package": "@opvs-ai/cli",
-  "version": "0.27.0",
-  "source_digest": "9f4d7df59f3c6548b5e8b2cb2a17c1b476df0e9766f556ec2b91b1fa0cab5dac",
-  "source_files": 56,
-  "built_at": "2026-10-14T06:29:59.711Z",
+  "version": "0.27.2",
+  "source_digest": "b93b5a62130f3048bbfc2a17c8ecbaa8fa5ef352a1ab6859cb2fff42957fd7a0",
+  "source_files": 59,
+  "built_at": "2026-10-15T09:58:32.629Z",
   "node": "v22.23.3"
 }

package/dist/commands/calendar.d.ts

@@ -0,0 +1,3 @@
+/** opvs calendar — write and inspect the current agent's wake-up calendar. */
+import { Command } from "commander";
+export declare function registerCalendarCommands(program: Command): void;

package/dist/commands/calendar.js

@@ -0,0 +1,294 @@
+/** opvs calendar — write and inspect the current agent's wake-up calendar. */
+import { createClient, getEffectiveConfig, resolveAgentIdentity, } from "@opvs-ai/core";
+import { confirmOrExit, YES_HELP } from "../lib/confirm.js";
+import { CalendarSpecError, conditionFromFlags, describeReminder, describeRepeat, parseEnds, parseEvery, parseRemind, parseZonedTime, } from "../lib/calendar-spec.js";
+import { printJson } from "../lib/format.js";
+const BASE = "/api/v1/calendar";
+function collect(value, previous) {
+    return [...previous, value];
+}
+function addEntryOptions(command) {
+    return command
+        .requiredOption("--title <words>", "What should wake the agent, in words")
+        .option("--deadline <time>", "Deadline as ISO 8601 with a zone")
+        .option("--ends <end>", "never, YYYY-MM-DD, or a count such as 3x")
+        .option("--remind <who:how:anchor:minutes>", "Reminder to add; repeat this flag for more than one", collect, [])
+        .option("--note <words>", "A note delivered with the wake")
+        .option("--json", "Print one JSON document");
+}
+function commonEntry(opts) {
+    const body = {
+        title: opts.title,
+        reminders: opts.remind.map(parseRemind),
+    };
+    if (opts.deadline)
+        body.deadline_at = parseZonedTime(opts.deadline);
+    if (opts.ends)
+        Object.assign(body, parseEnds(opts.ends));
+    if (opts.note)
+        body.registered_note = opts.note;
+    return body;
+}
+function errorPayload(error) {
+    if (!error || typeof error !== "object")
+        return undefined;
+    const candidate = error;
+    for (const value of [candidate.detail, candidate.data, candidate.body]) {
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            return value;
+        }
+    }
+    return candidate;
+}
+function fail(error, fallback) {
+    if (error instanceof CalendarSpecError) {
+        console.error(error.message);
+        process.exit(1);
+    }
+    const payload = errorPayload(error);
+    if (payload?.error === "calendar_bounds") {
+        console.error(`${String(payload.field)} has a limit of ${String(payload.limit)}; got ${String(payload.got)}.`);
+        process.exit(1);
+    }
+    if (payload?.error === "stale_version") {
+        console.error("someone changed it; run the command again");
+        process.exit(1);
+    }
+    const candidate = error;
+    const detail = typeof candidate?.detail === "string" ? candidate.detail : candidate?.message;
+    console.error(`Error: ${detail || fallback}`);
+    process.exit(1);
+}
+async function responseJson(response) {
+    return response.json();
+}
+function printTimes(times) {
+    if (!Array.isArray(times))
+        return;
+    console.log("Next 5 times:");
+    for (const time of times)
+        console.log(`- ${String(time)}`);
+}
+function printCreated(entry, title, reminders, repeat) {
+    const id = entry && typeof entry === "object" && "id" in entry
+        ? String(entry.id)
+        : "(unknown id)";
+    console.log(`Registered ${id}: ${title}`);
+    if (repeat)
+        console.log(describeRepeat(repeat));
+    for (const reminder of reminders)
+        console.log(describeReminder(reminder));
+}
+function directMailAddress(workspace) {
+    const fromEnvironment = process.env.OPVS_AGENT_ADDRESS?.trim();
+    const configured = resolveAgentIdentity(workspace)?.address?.trim();
+    const address = fromEnvironment || configured;
+    if (!address) {
+        throw new CalendarSpecError("mail conditions need an OPVS mail address (opvs mail whoami)");
+    }
+    return address;
+}
+async function createEntry(program, body) {
+    const client = createClient(program.opts().workspace);
+    return responseJson(await client.post(`${BASE}/commitments`, body));
+}
+export function registerCalendarCommands(program) {
+    const calendar = program
+        .command("calendar")
+        .description("Write and inspect this agent's wake-up calendar");
+    const wait = addEntryOptions(calendar
+        .command("wait")
+        .description("Wake when one registered condition becomes true")
+        .option("--pr <owner/repo#N>", "Pull request to watch")
+        .option("--merged", "Wake when --pr is merged")
+        .option("--closed", "Wake when --pr is closed")
+        .option("--green", "Wake when every required check on --pr is green")
+        .option("--card <REF>", "Card to watch")
+        .option("--status <word>", "Wake when --card reaches this status")
+        .option("--mail-reply <id>", "Wake when this message receives a reply")
+        .option("--mail", "Wake when direct mail arrives for this agent")
+        .option("--box <environment>", "Environment to watch")
+        .option("--version <version>", "Wake when --box reaches this version"));
+    wait.action(async (opts) => {
+        try {
+            const cfg = getEffectiveConfig(program.opts().workspace);
+            const condition = conditionFromFlags(opts);
+            if (condition.source === "mail" && condition.key === "direct") {
+                condition.value = {
+                    exists: true,
+                    owner_address: directMailAddress(cfg.workspace_slug),
+                };
+            }
+            const body = {
+                ...commonEntry(opts),
+                schedule_kind: "trigger",
+                condition,
+            };
+            const entry = await createEntry(program, body);
+            if (opts.json)
+                printJson(entry);
+            else
+                printCreated(entry, opts.title, opts.remind.map(parseRemind));
+        }
+        catch (error) {
+            fail(error, "Failed to register calendar wait");
+        }
+    });
+    const at = addEntryOptions(calendar
+        .command("at <time>")
+        .description("Wake once at an ISO 8601 time with a zone"));
+    at.action(async (time, opts) => {
+        try {
+            const body = {
+                ...commonEntry(opts),
+                schedule_kind: "once",
+                fire_at: parseZonedTime(time),
+            };
+            const entry = await createEntry(program, body);
+            if (opts.json)
+                printJson(entry);
+            else
+                printCreated(entry, opts.title, opts.remind.map(parseRemind));
+        }
+        catch (error) {
+            fail(error, "Failed to register calendar time");
+        }
+    });
+    const every = addEntryOptions(calendar
+        .command("every <repeat>")
+        .description("Wake every N minutes, hours or days, starting now"));
+    every.action(async (repeat, opts) => {
+        try {
+            const repeatFields = {
+                ...parseEvery(repeat),
+                ...(opts.ends ? parseEnds(opts.ends) : { repeat_ends: "never" }),
+                fire_at: new Date().toISOString(),
+            };
+            const body = {
+                ...commonEntry({ ...opts, ends: undefined }),
+                schedule_kind: "interval",
+                ...repeatFields,
+            };
+            const client = createClient(program.opts().workspace);
+            const times = await responseJson(await client.post(`${BASE}/commitments/preview`, body));
+            if (!opts.json)
+                printTimes(times);
+            const entry = await responseJson(await client.post(`${BASE}/commitments`, body));
+            if (opts.json)
+                printJson({ next_five: times, entry });
+            else {
+                printCreated(entry, opts.title, opts.remind.map(parseRemind), repeatFields);
+            }
+        }
+        catch (error) {
+            fail(error, "Failed to register repeating calendar entry");
+        }
+    });
+    calendar
+        .command("list")
+        .description("List calendar entries")
+        .option("--owner <owner>", "Owner to list; defaults to me")
+        .option("--status <status>", "Entry status; defaults to open")
+        .option("--json", "Print one JSON document")
+        .action(async (opts) => {
+        try {
+            const params = new URLSearchParams();
+            if (opts.owner)
+                params.set("owner", opts.owner);
+            if (opts.status)
+                params.set("status", opts.status);
+            const suffix = params.size ? `?${params.toString()}` : "";
+            const client = createClient(program.opts().workspace);
+            const entries = await responseJson(await client.get(`${BASE}/commitments${suffix}`));
+            printJson(entries);
+        }
+        catch (error) {
+            fail(error, "Failed to list calendar entries");
+        }
+    });
+    const preview = addEntryOptions(calendar
+        .command("preview")
+        .description("Show the next five times for an unsaved entry")
+        .option("--at <time>", "Preview a one-time entry")
+        .option("--every <repeat>", "Preview an interval entry"));
+    preview.action(async (opts) => {
+        try {
+            if (Boolean(opts.at) === Boolean(opts.every)) {
+                throw new CalendarSpecError("a preview needs exactly one time, for example --at 2026-10-20T18:00+02:00 or --every 2h.");
+            }
+            const body = {
+                ...commonEntry(opts),
+                schedule_kind: opts.at ? "once" : "interval",
+            };
+            if (opts.at)
+                body.fire_at = parseZonedTime(opts.at);
+            if (opts.every) {
+                Object.assign(body, parseEvery(opts.every));
+                body.fire_at = new Date().toISOString();
+            }
+            const client = createClient(program.opts().workspace);
+            const times = await responseJson(await client.post(`${BASE}/commitments/preview`, body));
+            if (opts.json)
+                printJson(times);
+            else
+                printTimes(times);
+        }
+        catch (error) {
+            fail(error, "Failed to preview calendar entry");
+        }
+    });
+    calendar
+        .command("cancel <id>")
+        .description("Cancel an open entry. Asks first; needs --yes off a terminal")
+        .option("-y, --yes", YES_HELP)
+        .option("--json", "Print one JSON document")
+        .action(async (id, opts) => {
+        await confirmOrExit(`Cancel calendar entry ${id}?`, opts.yes);
+        try {
+            const client = createClient(program.opts().workspace);
+            const current = (await responseJson(await client.get(`${BASE}/commitments/${id}`)));
+            if (!Number.isInteger(current.version)) {
+                throw new Error("calendar entry did not include its version");
+            }
+            const entry = await responseJson(await client.post(`${BASE}/commitments/${id}/cancel`, {
+                version: current.version,
+            }));
+            if (opts.json)
+                printJson(entry);
+            else
+                console.log(`Cancelled ${id}.`);
+        }
+        catch (error) {
+            fail(error, "Failed to cancel calendar entry");
+        }
+    });
+    calendar
+        .command("done")
+        .description("Report the outcome of a finished wake")
+        .requiredOption("--token <run.secret>", "One-use dispatch token")
+        .option("--no-work", "Report that the wake found no work")
+        .option("--json", "Print one JSON document")
+        .action(async (opts) => {
+        try {
+            const dot = opts.token.indexOf(".");
+            if (dot <= 0 || dot === opts.token.length - 1) {
+                throw new CalendarSpecError("a dispatch token needs its run id and secret, for example R.S.");
+            }
+            const runId = opts.token.slice(0, dot);
+            const client = createClient(program.opts().workspace);
+            const result = await responseJson(await client.post(`${BASE}/runs/${runId}/complete`, {
+                dispatch_token: opts.token,
+                outcome: opts.work === false ? "no_work" : "work_done",
+            }));
+            if (opts.json)
+                printJson(result);
+            else {
+                console.log(`Completed wake ${runId}: ${opts.work === false ? "no work" : "work done"}.`);
+            }
+        }
+        catch (error) {
+            fail(error, "Failed to complete calendar wake");
+        }
+    });
+}
+//# sourceMappingURL=calendar.js.map

package/dist/commands/calendar.js.map

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

package/dist/commands/code.js

@@ -29,7 +29,9 @@
  * `format=undefined` is a literal string on the URL. Each `if (opts.x) ...`
  * gate exists so the request the server sees is the request the user asked for.
  */
+import { readFile } from "node:fs/promises";
 import { codeCallers, createClient, getEffectiveConfig, } from "@opvs-ai/core";
+import { extractCardAnchors, } from "../lib/card-anchors.js";
 import { buildUrl, printResponse } from "../lib/format.js";
 export function registerCodeCommands(program) {
     const code = program
@@ -131,6 +133,80 @@ export function registerCodeCommands(program) {
             process.exit(1);
         }
     });
+    // ── check-card: bounded index facts for a planner's draft brief ──
+    code
+        .command("check-card <brief.md>")
+        .description("Check a draft card's paths and names against the code index")
+        .option("--project <id>", "Project id (or OPVS_CODE_PROJECT)")
+        .option("--similar <words>", "Append existing code similar to these words (repeatable, max 5)", (value, previous) => [...previous, value], [])
+        .option("--strict", "Exit 1 when an anchor is absent and not declared new")
+        .option("--json", "Print the same facts as JSON")
+        .action(async (briefPath, opts) => {
+        const project = opts.project || process.env.OPVS_CODE_PROJECT;
+        if (!project) {
+            reportCannotCheckCard("project required: pass --project <id> or set OPVS_CODE_PROJECT");
+            return;
+        }
+        const similarQueries = Array.isArray(opts.similar) ? opts.similar : [];
+        if (similarQueries.length > 5) {
+            reportCannotCheckCard("--similar may be repeated at most 5 times");
+            return;
+        }
+        let markdown;
+        try {
+            markdown = await readFile(briefPath, "utf8");
+        }
+        catch {
+            reportCannotCheckCard(`cannot read brief: ${briefPath}`);
+            return;
+        }
+        const extracted = extractCardAnchors(markdown);
+        const anchorNames = extracted.anchors.map((item) => item.anchor);
+        const wsSlug = program.opts().workspace;
+        try {
+            const client = createClient(wsSlug);
+            const resolvedResponse = await client.post(`/api/v1/code/${project}/nodes/resolve`, { anchors: anchorNames });
+            const resolutions = await resolvedResponse.json();
+            const resolutionByAnchor = new Map(resolutions.map((item) => [item.anchor, item]));
+            const live = resolutions.filter((item) => item.state === "live");
+            const nodeIds = live.map((item) => item.node_id);
+            const callersOptions = { callersLimit: 20, testsLimit: 10 };
+            const callersResponse = wsSlug
+                ? await codeCallers(project, nodeIds, callersOptions, wsSlug)
+                : await codeCallers(project, nodeIds, callersOptions);
+            if (callersResponse.degraded || !callersResponse.index) {
+                reportCannotCheckCard("code index unavailable");
+                return;
+            }
+            const callerByNode = new Map(callersResponse.results.map((item) => [item.node_id, item]));
+            const facts = extracted.anchors.map((item) => cardAnchorFact(item, resolutionByAnchor.get(item.anchor), callersResponse, callerByNode));
+            const similar = await loadSimilarFacts(client, project, similarQueries);
+            const checkedAt = new Date().toISOString();
+            const output = {
+                version: "index-facts-v1",
+                project_id: project,
+                checked_at: checkedAt,
+                index: callersResponse.index,
+                paths_checked: facts.length,
+                paths_left_out: extracted.leftOut,
+                anchors: facts,
+                similar,
+            };
+            if (opts.json) {
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                console.log(boundIndexFactsMarkdown(indexFactsMarkdown(project, callersResponse, checkedAt, facts, extracted.leftOut, similar)));
+            }
+            if (opts.strict && facts.some((fact) => fact.in_index === "NO — not in the index and not declared new")) {
+                process.exitCode = 1;
+            }
+        }
+        catch (err) {
+            const e = err;
+            reportCannotCheckCard(e.detail || e.message || "code index unavailable");
+        }
+    });
     // ── summary: the orientation document as data ───────────────────
     code
         .command("summary")
@@ -368,15 +444,19 @@ function printCallersText(anchors, resolutions, response) {
     console.log(response.index
         ? `index: ${response.index.commit.slice(0, 7)}, ${ageInWords(response.index.age_seconds)}`
         : "index: unavailable");
-    let resultIndex = 0;
+    const callerByNode = new Map(response.results.map((item) => [item.node_id, item]));
     for (let anchorIndex = 0; anchorIndex < anchors.length; anchorIndex += 1) {
         const resolution = resolutions[anchorIndex];
         if (!resolution || resolution.state !== "live") {
             printUnresolvedAnchor(resolution?.anchor ?? anchors[anchorIndex], resolution);
             continue;
         }
-        const result = response.results[resultIndex];
-        resultIndex += 1;
+        const result = callerByNode.get(resolution.node_id);
+        if (!result || result.state !== "found") {
+            console.log(`\n${resolution.anchor}\n` +
+                "UNKNOWN — the node was not found when callers were asked (index changed?)");
+            continue;
+        }
         console.log(`\n${nodeLabel(result, resolution.anchor)}`);
         if (!response.calls_indexed) {
             console.log("calls are not indexed for this repo: callers are UNKNOWN, not zero");
@@ -415,4 +495,150 @@ function printUnresolvedAnchor(anchor, resolution) {
     }
     console.log(`\n${anchor}\n${status}`);
 }
+function reportCannotCheckCard(reason) {
+    console.error(`CANNOT: ${reason}`);
+    process.exitCode = 2;
+}
+function cardAnchorFact(cardAnchor, resolution, response, callerByNode) {
+    const state = resolution?.state ?? "unknown";
+    if (state === "moved") {
+        return {
+            anchor: cardAnchor.anchor,
+            declared_new: cardAnchor.declaredNew,
+            state,
+            moved_to_anchor: resolution?.moved_to_anchor ?? null,
+            in_index: resolution?.moved_to_anchor
+                ? `MOVED → ${resolution.moved_to_anchor}`
+                : "MOVED",
+            callers: "n/a",
+            test_hints: "n/a",
+            callers_truncated: false,
+            test_hints_truncated: false,
+        };
+    }
+    if (state !== "live" || !resolution) {
+        return {
+            anchor: cardAnchor.anchor,
+            declared_new: cardAnchor.declaredNew,
+            state,
+            moved_to_anchor: null,
+            in_index: cardAnchor.declaredNew
+                ? "no (declared new)"
+                : "NO — not in the index and not declared new",
+            callers: "n/a",
+            test_hints: "n/a",
+            callers_truncated: false,
+            test_hints_truncated: false,
+        };
+    }
+    const result = callerByNode.get(resolution.node_id);
+    if (!result || result.state !== "found") {
+        return {
+            anchor: cardAnchor.anchor,
+            declared_new: cardAnchor.declaredNew,
+            state: result?.state ?? "unknown",
+            moved_to_anchor: null,
+            in_index: "UNKNOWN — gone between resolve and callers",
+            callers: "n/a",
+            test_hints: "n/a",
+            callers_truncated: result?.callers_truncated ?? false,
+            test_hints_truncated: result?.nearby_tests_truncated ?? false,
+        };
+    }
+    let callers;
+    if (!response.calls_indexed) {
+        callers = "unknown (calls not indexed)";
+    }
+    else if (!result.callers_known) {
+        callers = "unknown (calls not indexed for this file type)";
+    }
+    else if (result.callers_truncated && result.callers_total === 0) {
+        callers = "unknown — answer cut (file has more than 500 symbols)";
+    }
+    else {
+        const shown = result.callers.slice(0, 5);
+        const exact = result.callers.filter((caller) => caller.resolution === "exact").length;
+        const heuristic = result.callers.filter((caller) => caller.resolution === "heuristic").length;
+        const labels = shown.map((caller) => caller.symbol ? `${caller.path}#${caller.symbol}` : caller.path);
+        const more = result.callers_total > shown.length ? ", …" : "";
+        const count = result.callers_truncated
+            ? `≥ ${result.callers_total} (page of ${result.callers.length}: ${exact} exact, ${heuristic} heuristic) — truncated`
+            : `${result.callers_total} (${exact} exact, ${heuristic} heuristic)`;
+        callers = count +
+            (labels.length > 0 ? `: ${labels.map(inlineCode).join(", ")}${more}` : "");
+    }
+    const testHints = (result.nearby_tests.length
+        ? result.nearby_tests.map((test) => inlineCode(test.path)).join(", ")
+        : "none") + (result.nearby_tests_truncated ? " — truncated" : "");
+    return {
+        anchor: cardAnchor.anchor,
+        declared_new: cardAnchor.declaredNew,
+        state,
+        moved_to_anchor: null,
+        in_index: "yes",
+        callers,
+        test_hints: testHints,
+        callers_truncated: result.callers_truncated,
+        test_hints_truncated: result.nearby_tests_truncated,
+    };
+}
+async function loadSimilarFacts(client, project, queries) {
+    const facts = [];
+    for (const query of queries) {
+        const response = await client.get(buildUrl(`/api/v1/code/${project}/context`, { query, limit: "5" }, "json"));
+        const body = await response.json();
+        for (const match of (body.matches ?? []).slice(0, 5)) {
+            const path = match.file_path;
+            const symbol = match.name;
+            const detail = firstLine(match.doc_first_line) || firstLine(match.signature) || "matching code";
+            facts.push({ query, anchor: symbol ? `${path}#${symbol}` : path, detail });
+        }
+    }
+    return facts;
+}
+function firstLine(value) {
+    return value?.split(/\r?\n/, 1)[0].trim() ?? "";
+}
+function indexFactsMarkdown(project, response, checkedAt, facts, leftOut, similar) {
+    const index = response.index;
+    const lines = [
+        "## Index facts",
+        `<!-- index-facts v1 commit=${index.commit} indexed_at=${index.indexed_at} checked_at=${checkedAt} -->`,
+        `index: ${index.commit.slice(0, 7)}, ${ageInWords(index.age_seconds)} · project ${project} · ${facts.length} paths checked`,
+    ];
+    if (leftOut > 0) {
+        lines.push(`_${leftOut} ${leftOut === 1 ? "path" : "paths"} left out after the 50-anchor limit._`);
+    }
+    lines.push("| Anchor | In the index | Callers | Test hints (not coverage) |", "| --- | --- | --- | --- |");
+    for (const fact of facts) {
+        lines.push(`| ${inlineCode(fact.anchor)} | ${markdownCell(fact.in_index)} | ${markdownCell(fact.callers)} | ${markdownCell(fact.test_hints)} |`);
+    }
+    for (const fact of similar) {
+        lines.push(`Already exists for "${markdownText(fact.query)}": ${inlineCode(fact.anchor)} — ${markdownText(fact.detail)}`);
+    }
+    return lines.join("\n");
+}
+const INDEX_FACTS_MAX_BYTES = 6_000;
+const INDEX_FACTS_TRUNCATED = "_Truncated: output exceeded 6,000 bytes._";
+function boundIndexFactsMarkdown(markdown) {
+    if (Buffer.byteLength(`${markdown}\n`, "utf8") <= INDEX_FACTS_MAX_BYTES)
+        return markdown;
+    const kept = [];
+    for (const line of markdown.split("\n")) {
+        const candidate = [...kept, line, INDEX_FACTS_TRUNCATED].join("\n");
+        if (Buffer.byteLength(`${candidate}\n`, "utf8") > INDEX_FACTS_MAX_BYTES)
+            break;
+        kept.push(line);
+    }
+    return [...kept, INDEX_FACTS_TRUNCATED].join("\n");
+}
+function inlineCode(value) {
+    return `\`${markdownText(value).replaceAll("`", "\\`")}\``;
+}
+function markdownCell(value) {
+    return value.replaceAll("|", "\\|").replaceAll("\n", " ");
+}
+function markdownText(value) {
+    return value.replaceAll("|", "\\|").replaceAll("\r", " ").replaceAll("\n", " ");
+}
 //# sourceMappingURL=code.js.map