@kya-os/cli 1.8.1 → 1.8.3

package/dist/tui/views/index.js

@@ -0,0 +1,150 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { theme, statusColor, severityColor } from "../theme.js";
+import { Chips, Rule, SectionHeader, StatStrip, Table, Sparkline, } from "../components.js";
+/**
+ * The newest timestamp in a set, computed rather than assumed.
+ *
+ * Both stat strips said "most recent activity" while reading row zero, which
+ * is only the newest row if a reader three files away happens to sort that
+ * way. It did not for tickets -- listTickets orders by created_at ascending,
+ * so row zero is the OLDEST ticket and the strip reported its update time as
+ * the latest activity. Filtering made it worse: row zero of a filtered set is
+ * arbitrary. Taking the max says what the label already claims.
+ *
+ * Compares the strings directly, which is sound only because every writer in
+ * db/ stamps `new Date(...).toISOString()`: fixed-width UTC, so lexical order
+ * is chronological order. A writer that stored a local-time or offset format
+ * would break this quietly, which is why the columns carry no SQL default.
+ */
+export function mostRecent(rows, pick) {
+    let best;
+    for (const row of rows) {
+        const at = pick(row);
+        if (best === undefined || at > best)
+            best = at;
+    }
+    return best;
+}
+/** Relative time, the dashboard's "just now / 5m ago" idiom. */
+export function ago(iso) {
+    const ms = Date.now() - new Date(iso).getTime();
+    if (!Number.isFinite(ms))
+        return "unknown";
+    const s = Math.floor(ms / 1000);
+    if (s < 45)
+        return "just now";
+    // Past the "just now" cutoff, never show 0m: 45-59s still floors to 0 here.
+    const m = Math.max(1, Math.floor(s / 60));
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    return `${Math.floor(h / 24)}d ago`;
+}
+/**
+ * The state every Checkpoint-backed view shows until the read plane exists.
+ *
+ * Names the reason and the fix. "No data" would be a lie of omission: there is
+ * plenty of data, we simply have no route to it.
+ */
+export function NotConnected({ what }) {
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { color: theme.dim, children: [what, " lives in Checkpoint."] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: "This view needs the CLI read plane, which is not built yet. Nothing is" }) }), _jsx(Text, { color: theme.dim, children: "wrong with your setup and there is nothing to retry." }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.accent, children: "Tracked as CLI-P1 + CLI-P7 Workstream A." }) })] }));
+}
+// ── Ledger-backed views ───────────────────────────────────────────────
+/**
+ * The ticket filters, as data.
+ *
+ * Declared here rather than inline so the chip row, the counts and the actual
+ * row filtering all read from one list. Split across three places, a new
+ * filter is three edits and the chip that silently filters nothing is the one
+ * you ship.
+ */
+export const TICKET_FILTERS = [
+    { label: "All", match: () => true },
+    { label: "Open", match: (t) => t.status === "open" },
+    {
+        label: "In flight",
+        match: (t) => ["claimed", "in-progress", "in-review", "ready"].includes(t.status),
+    },
+    { label: "Blocked", match: (t) => t.status === "blocked" },
+];
+export function TicketsView({ snap, width, filter = 0, }) {
+    const all = snap.tickets;
+    const active = TICKET_FILTERS[filter] ?? TICKET_FILTERS[0];
+    const t = all.filter(active.match);
+    const columns = [
+        { header: "Ticket", width: 22, render: (r) => r.title },
+        { header: "Status", width: 12, render: (r) => r.status, color: (r) => statusColor(r.status) },
+        { header: "Severity", width: 10, render: (r) => r.severity ?? "-", color: (r) => severityColor(r.severity) },
+        { header: "Claimed by", width: 24, render: (r) => r.claimed_by ?? "-" },
+        { header: "Updated", width: 10, render: (r) => ago(r.updated_at) },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginTop: 1, children: _jsx(Chips, { items: TICKET_FILTERS.map((f) => `${f.label} ${all.filter(f.match).length}`), activeIndex: filter }) }), _jsx(Rule, { width: width }), _jsx(StatStrip, { width: width, 
+                // Derived from the SAME predicates the chips use, so the two cannot
+                // disagree. Hand-written totals did: the strip counted only claimed and
+                // in-progress as "in flight" while the chip of that name also matched
+                // in-review and ready, so one screen carried one label with two numbers.
+                // In a view whose whole argument is that every control carries its count,
+                // a count contradicting the control beside it is worse than none.
+                stats: TICKET_FILTERS.map((f) => ({
+                    value: all.filter(f.match).length,
+                    // "All" reads as the total here; the rest keep their own labels.
+                    label: f.label === "All" ? "tickets" : f.label.toLowerCase(),
+                })), trailing: (() => {
+                    const at = mostRecent(t, (r) => r.updated_at);
+                    return at ? `updated ${ago(at)}` : undefined;
+                })() }), _jsx(Rule, { width: width }), _jsx(Box, { marginTop: 1, children: _jsx(Table, { width: width, columns: columns, rows: t, empty: all.length
+                        ? `No ${active.label.toLowerCase()} tickets. Press f to change the filter.`
+                        : "No tickets yet. They arrive by mirroring Linear." }) })] }));
+}
+export function DispatchesView({ snap, width }) {
+    const d = snap.dispatches;
+    const columns = [
+        { header: "Worker", width: 26, render: (r) => r.worker_did },
+        { header: "Repo", width: 20, render: (r) => r.repo ?? "-" },
+        { header: "PR", width: 6, render: (r) => (r.pr_number ? `#${r.pr_number}` : "-") },
+        { header: "Status", width: 12, render: (r) => r.status, color: (r) => statusColor(r.status) },
+        { header: "Started", width: 10, render: (r) => ago(r.dispatched_at) },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginTop: 1 }), _jsx(StatStrip, { width: width, stats: [
+                    { value: d.length, label: "dispatches" },
+                    { value: d.filter((x) => x.status === "in-progress").length, label: "running" },
+                    { value: d.filter((x) => x.status === "failed").length, label: "failed" },
+                ] }), _jsx(Rule, { width: width }), _jsx(Box, { marginTop: 1, children: _jsx(Table, { width: width, columns: columns, rows: d, empty: "Nothing dispatched. Workers appear here once a ticket is staffed." }) })] }));
+}
+export function JournalView({ snap, width }) {
+    const j = snap.journal;
+    // Counts per event type, which is the aggregate the dashboard's chart carries.
+    const buckets = new Map();
+    for (const row of j)
+        buckets.set(row.event_type, (buckets.get(row.event_type) ?? 0) + 1);
+    const columns = [
+        { header: "Event", width: 24, render: (r) => r.event_type },
+        { header: "Agent", width: 22, render: (r) => r.agent_name ?? "-" },
+        { header: "Ticket", width: 14, render: (r) => r.ticket_id ?? "(none)" },
+        { header: "When", width: 10, render: (r) => ago(r.observed_at) },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginTop: 1 }), _jsx(StatStrip, { width: width, stats: [
+                    { value: j.length, label: "observations" },
+                    { value: buckets.size, label: "event types" },
+                    { value: j.filter((r) => r.ticket_id === null).length, label: "uncorrelated" },
+                ], trailing: (() => {
+                    const at = mostRecent(j, (r) => r.observed_at);
+                    return at ? `last ${ago(at)}` : undefined;
+                })() }), _jsx(Rule, { width: width }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(SectionHeader, { title: "Observations over time", hint: "by event type", width: width }), _jsx(Sparkline, { values: [...buckets.values()] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Table, { width: width, columns: columns, rows: j.slice(0, 12), empty: "Nothing observed yet. The daemon writes here as hub events arrive." }) })] }));
+}
+export function ReviewView({ snap, width }) {
+    // Verdicts land here once the review loop is wired; until then this reads
+    // the review-shaped journal rows, which is honest about what exists.
+    const rows = snap.journal.filter((r) => /review|quorum|verdict/i.test(r.event_type));
+    const columns = [
+        { header: "Event", width: 22, render: (r) => r.event_type },
+        { header: "Reviewer", width: 26, render: (r) => r.agent_did ?? "-" },
+        { header: "Ticket", width: 14, render: (r) => r.ticket_id ?? "(none)" },
+        { header: "When", width: 10, render: (r) => ago(r.observed_at) },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Rule, { width: width }), _jsx(StatStrip, { width: width, stats: [{ value: rows.length, label: "review events" }], trailing: "approve/reject split lands with the verdict payload" }), _jsx(Rule, { width: width }), _jsx(Box, { marginTop: 1, children: _jsx(Table, { width: width, columns: columns, rows: rows, empty: "No review activity. Verdicts appear once the review loop is wired to the ledger." }) })] }));
+}
+//# sourceMappingURL=index.js.map

package/dist/tui/views/index.js.map

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

package/dist/tui/views/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * View registry.
+ *
+ * The seam the frame depends on: it renders whatever is registered for the
+ * active nav id and knows nothing about where the data came from. Adding the
+ * Checkpoint-backed views later means adding entries here, not touching
+ * app.tsx.
+ *
+ * @module cli/tui/views/registry
+ */
+import { type LedgerSnapshot, type ViewProps } from "./index.js";
+export declare function buildViews(snap: LedgerSnapshot): Promise<Record<string, (p: ViewProps) => JSX.Element>>;
+/**
+ * How many filter chips each view renders, keyed by nav id.
+ *
+ * Lives beside the registry because the same file already decides which
+ * component answers for which nav entry. A view absent here has one implicit
+ * "everything" filter, so `f` is a no-op rather than a key that appears to do
+ * something and does not.
+ */
+export declare const FILTER_COUNTS: Record<string, number>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tui/views/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tui/views/registry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAsDpB,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,CAyDxD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEhD,CAAC"}

package/dist/tui/views/registry.js

@@ -0,0 +1,110 @@
+/**
+ * View registry.
+ *
+ * The seam the frame depends on: it renders whatever is registered for the
+ * active nav id and knows nothing about where the data came from. Adding the
+ * Checkpoint-backed views later means adding entries here, not touching
+ * app.tsx.
+ *
+ * @module cli/tui/views/registry
+ */
+import React from "react";
+import { TICKET_FILTERS } from "./index.js";
+import { TicketsView, DispatchesView, JournalView, ReviewView, NotConnected, } from "./index.js";
+import { AgentsView } from "./agents.js";
+import { listProfiles } from "../../utils/agent-profiles.js";
+import { readHubConfig } from "../../utils/hub-config.js";
+import { dispatchToProfile } from "../../orchestrator/hub-dispatch.js";
+// Generic module-existence probe, shared with init.ts's runtime-optional
+// stage guards (P16/P17) -- the same "does this not-yet-landed module
+// exist yet" question, here asked about review-loop P13's agent task/
+// review run functions rather than an init stage.
+import { moduleExists } from "../../utils/init/pipeline.js";
+/**
+ * Builds the launchAgentFlow callback for the agents view IF review-loop
+ * P13's run functions are resolvable AND this view has a way to invoke
+ * them meaningfully -- else undefined (the view hides the action
+ * entirely rather than showing a dead key). P13 landed with real
+ * `agentTask`/`agentReview` functions, but both need a description or PR
+ * URL argument this view has no input step to collect (the dispatch
+ * action's text-entry submode has no launch counterpart yet), and firing
+ * either with an empty string is a real risk now that the module is
+ * genuinely reachable, not a placeholder: `launchAgentFlow` is called
+ * fire-and-forget from AgentsView (never awaited), so an unhandled
+ * rejection from a validation error would surface as an unhandled
+ * promise rejection instead of a rendered message. Staying undefined
+ * until a follow-up PR adds that input step is the safe default; the
+ * probe below still activates the moment both are wired.
+ */
+async function resolveLaunchAgentFlow() {
+    const specifier = "../../commands/agent.js";
+    if (!(await moduleExists(specifier, import.meta.url)))
+        return undefined;
+    const mod = (await import(specifier));
+    if (!mod.agentTask && !mod.agentReview)
+        return undefined;
+    // Confirmed callable, but no description/prUrl input step exists in
+    // this view yet -- see the module doc above. Kept hidden rather than
+    // wired to an empty-string call.
+    return undefined;
+}
+export async function buildViews(snap) {
+    const checkpoint = (what) => () => React.createElement(NotConnected, { what });
+    /**
+     * Bind a ledger view to the snapshot, forwarding EVERY frame prop.
+     *
+     * Each wrapper used to name the props it passed on, which meant adding one
+     * to ViewProps silently dropped it at all four call sites: `filter` reached
+     * the wrapper and stopped there, so pressing f moved keymap state and help
+     * copy while the table never changed. Spreading makes the next added prop
+     * arrive on its own, and makes the drop impossible rather than merely fixed.
+     */
+    const ledger = (View) => (p) => React.createElement(View, { ...p, snap });
+    // Real, local, synchronous (agent-profiles.ts and hub-config.ts are both
+    // plain fs reads) -- read once per TUI launch, same freshness contract
+    // as the ledger snapshot every other view here already has.
+    const profiles = listProfiles();
+    const hubConfig = readHubConfig();
+    const launchAgentFlow = await resolveLaunchAgentFlow();
+    return {
+        // Real data, today.
+        "orc.tickets": ledger(TicketsView),
+        "orc.dispatches": ledger(DispatchesView),
+        "orc.journal": ledger(JournalView),
+        "orc.review": ledger(ReviewView),
+        agents: (p) => React.createElement(AgentsView, {
+            ...p,
+            profiles,
+            dispatches: snap.dispatches,
+            journal: snap.journal,
+            hubConnected: hubConfig !== undefined,
+            launchAgentFlow,
+            // Absent (not merely a no-op function) when there is no hub to
+            // dispatch through -- AgentsView hides the whole action on
+            // `dispatchTask === undefined`, which is what "the action is
+            // absent when ~/.mcpi/hub.json is absent" means concretely.
+            dispatchTask: hubConfig ? dispatchToProfile : undefined,
+        }),
+        // Ported V2 routes. The layout is here; the read plane is not.
+        monitor: checkpoint("Live agent activity"),
+        "monitor.access": checkpoint("Access control"),
+        analyze: checkpoint("Analytics"),
+        "agents.marketplace": checkpoint("The agent marketplace"),
+        projects: checkpoint("Projects"),
+        settings: checkpoint("Settings"),
+        "settings.keys": checkpoint("API keys"),
+        "settings.docs": checkpoint("Documentation"),
+    };
+}
+/**
+ * How many filter chips each view renders, keyed by nav id.
+ *
+ * Lives beside the registry because the same file already decides which
+ * component answers for which nav entry. A view absent here has one implicit
+ * "everything" filter, so `f` is a no-op rather than a key that appears to do
+ * something and does not.
+ */
+export const FILTER_COUNTS = {
+    "orc.tickets": TICKET_FILTERS.length,
+};
+//# sourceMappingURL=registry.js.map

package/dist/tui/views/registry.js.map

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

package/dist/utils/agent/backoff.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Retry-with-backoff for GitHub API calls made through `gh` from the
+ * `--watch` polling loops (`agent task --watch`, `agent review --watch`).
+ * Mirrors `commands/score.ts`'s `submitWithRetry` formula
+ * (`min(cap, base * 2^attempt)`) generalized to any `gh`-shelling call
+ * rather than one specific HTTP submission, and narrowed to rate-limit
+ * signals only — never retrying a genuine auth/scope/not-found failure,
+ * which a retry would just repeat identically.
+ */
+export interface BackoffOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    capDelayMs?: number;
+    /** Injectable so tests never actually sleep. */
+    sleepImpl?: (ms: number) => Promise<void>;
+}
+/**
+ * Same narrow-match discipline as `github.ts`'s `isScopeError`: only the
+ * explicit HTTP 403/429 rate-limit shape counts, never a bare error message
+ * that happens to mention neither — a genuine auth failure or 404 must
+ * propagate on the first attempt, not get retried into a slower identical
+ * failure.
+ */
+export declare function isRateLimitedError(error: unknown): boolean;
+/**
+ * Run `fn`, retrying on a detected rate-limit failure with exponential
+ * backoff up to `maxRetries` additional attempts. Any other failure, or
+ * exhausting the retries, rethrows the last error untouched.
+ */
+export declare function withGithubBackoff<T>(fn: () => Promise<T>, options?: BackoffOptions): Promise<T>;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/utils/agent/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../../src/utils/agent/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI1D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBzG"}

package/dist/utils/agent/backoff.js

@@ -0,0 +1,51 @@
+/**
+ * Retry-with-backoff for GitHub API calls made through `gh` from the
+ * `--watch` polling loops (`agent task --watch`, `agent review --watch`).
+ * Mirrors `commands/score.ts`'s `submitWithRetry` formula
+ * (`min(cap, base * 2^attempt)`) generalized to any `gh`-shelling call
+ * rather than one specific HTTP submission, and narrowed to rate-limit
+ * signals only — never retrying a genuine auth/scope/not-found failure,
+ * which a retry would just repeat identically.
+ */
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_BASE_DELAY_MS = 250;
+const DEFAULT_CAP_DELAY_MS = 2000;
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Same narrow-match discipline as `github.ts`'s `isScopeError`: only the
+ * explicit HTTP 403/429 rate-limit shape counts, never a bare error message
+ * that happens to mention neither — a genuine auth failure or 404 must
+ * propagate on the first attempt, not get retried into a slower identical
+ * failure.
+ */
+export function isRateLimitedError(error) {
+    const err = error;
+    const message = `${err?.stderr ?? ""} ${err?.message ?? ""}`;
+    return /HTTP 403|HTTP 429/.test(message) || /rate limit/i.test(message);
+}
+/**
+ * Run `fn`, retrying on a detected rate-limit failure with exponential
+ * backoff up to `maxRetries` additional attempts. Any other failure, or
+ * exhausting the retries, rethrows the last error untouched.
+ */
+export async function withGithubBackoff(fn, options = {}) {
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const baseDelayMs = options.baseDelayMs ?? DEFAULT_BASE_DELAY_MS;
+    const capDelayMs = options.capDelayMs ?? DEFAULT_CAP_DELAY_MS;
+    const sleep = options.sleepImpl ?? defaultSleep;
+    let attempt = 0;
+    for (;;) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (!isRateLimitedError(error) || attempt >= maxRetries) {
+                throw error;
+            }
+            const delayMs = Math.min(capDelayMs, baseDelayMs * 2 ** attempt);
+            attempt += 1;
+            await sleep(delayMs);
+        }
+    }
+}
+//# sourceMappingURL=backoff.js.map

package/dist/utils/agent/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../../src/utils/agent/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAUlC,MAAM,YAAY,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEtG;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,GAAG,GAAG,KAA8C,CAAC;IAC3D,MAAM,OAAO,GAAG,GAAG,GAAG,EAAE,MAAM,IAAI,EAAE,IAAI,GAAG,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;IAC7D,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,EAAoB,EAAE,UAA0B,EAAE;IAC3F,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,CAAC;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,IAAI,YAAY,CAAC;IAEhD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,SAAS,CAAC;QACR,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;gBACxD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,CAAC;YACb,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/agent/markers.d.ts

@@ -0,0 +1,87 @@
+import { type FixAttestation, type ReviewVerdictBody } from "@kya-os/contracts/review";
+/**
+ * Marker-based idempotency for `kya-os agent review`'s posted verdicts,
+ * following review-loop P9's exact scheme: an HTML-comment marker naming
+ * `(repo, pr, head, reviewer)` so a replay (the `--watch` loop re-polling
+ * after its own post, or a re-run after a crash) can find its own prior
+ * post and skip rather than posting the same verdict for the same head
+ * twice. Mirrors `dco fix.ts`'s `buildFixAttestationCommentBody` /
+ * `sanitizeForMarkdownBlock` idiom for the same reason that file's doc
+ * comment gives: the marker and human summary render as live markdown, so
+ * a backtick/`-->`/`<!--` in a free-text field (here, `reviewerDid`; there,
+ * `agentName`/`agentDid`) must never be able to break out of the marker or
+ * prematurely close/open the surrounding HTML comment. The fenced JSON
+ * block itself is never sanitized — it is the actual signed data, and
+ * sanitizing it would make it not round-trip.
+ */
+export interface VerdictMarker {
+    repo: string;
+    prNumber: number;
+    headSha: string;
+    reviewerDid: string;
+}
+export declare function buildVerdictMarker(marker: VerdictMarker): string;
+/** Parse the first `kya-os-verdict:v1` marker out of a review/comment body, if present. */
+export declare function findVerdictMarker(body: string): VerdictMarker | null;
+/**
+ * Whether any of `bodies` already carries a marker for the exact same
+ * `(repo, pr, head, reviewer)` — the idempotency check `kya-os agent
+ * review` runs before posting a new verdict for a head it may have already
+ * reviewed (e.g. the hub/PR replaying events to a reconnecting consumer, or
+ * a `--watch` loop's own poll tick landing right after its own post).
+ */
+export declare function hasVerdictMarker(bodies: readonly string[], target: VerdictMarker): boolean;
+/**
+ * Find the `ReviewVerdictBody` actually posted AND cryptographically
+ * verified for `target`'s `(repo, pr, head, reviewer)`, if any. Used on an
+ * idempotent skip to recover the TRUE prior verdict instead of trusting a
+ * freshly recomputed one: the review-analysis pass is LLM-driven and can be
+ * non-deterministic, so re-running it against an already-reviewed head can
+ * produce a different verdict than what is actually signed and posted on
+ * the PR. A caller that returned the recompute instead (e.g. treating a
+ * recomputed "approve" as equivalent to a truly-posted one) could report
+ * success without a real approve ever having landed.
+ *
+ * `publicKeyRaw` MUST be this reviewer's own Ed25519 public key -- the only
+ * key a genuine prior post from this same `reviewerDid` could have signed
+ * with. This is not optional: the marker is free text and a fenced block's
+ * shape is Zod-checked only, so without a signature check anyone who can
+ * post a `COMMENT` review could plant a matching marker plus a schema-valid
+ * but unsigned "approve" block and have it trusted as a real prior post. The
+ * search keeps scanning past a marker match whose block is missing, corrupt,
+ * or fails verification, rather than stopping at the first one found --
+ * a forged comment must never be able to shadow a real, later, genuinely
+ * signed post. Returns `null` (never a partial/unverified value) when no
+ * candidate verifies, so a caller can tell "nothing genuine was posted" from
+ * "something was posted"; treating null the same as "not yet posted" (i.e.
+ * proceeding to post a real verdict) is the correct, fail-safe response to
+ * either a missing OR a forged prior post.
+ */
+export declare function findPostedVerdict(bodies: readonly string[], target: VerdictMarker, publicKeyRaw: Buffer | Uint8Array): ReviewVerdictBody | null;
+/**
+ * Build the review body posted for a signed verdict: the idempotency
+ * marker, a human-readable findings section, then the fenced
+ * `kya-os-signed-verdict` JSON block `kya-os agent verify` reads back.
+ * `findingsSummary` is caller-built (severity/path:line/summary lines) so
+ * this function stays about structure, not findings formatting.
+ */
+export declare function buildVerdictReviewBody(verdict: ReviewVerdictBody, reviewerDid: string, findingsSummary: string): string;
+export interface FencedBlock {
+    /** Raw text between the fences, before JSON.parse. */
+    raw: string;
+    /** Parsed JSON value, or absent when `raw` wasn't valid JSON. */
+    parsed?: unknown;
+}
+/**
+ * Extract every ` ```<tag> ... ``` ` fenced block from `body`, JSON-parsing
+ * each one. A block whose contents don't parse is still returned (with
+ * `parsed` absent) rather than silently dropped: `kya-os agent verify`
+ * needs to report "found but INVALID: schema" for a corrupted block, not
+ * make it disappear as if it were never posted.
+ */
+export declare function extractFencedBlocks(body: string, tag: string): FencedBlock[];
+/** Every `kya-os-signed-verdict` block in `body` that parses AND validates against the schema. */
+export declare function extractSignedVerdicts(body: string): ReviewVerdictBody[];
+/** Every `kya-os-fix-attestation` block in `body` that parses AND validates against the schema. */
+export declare function extractFixAttestations(body: string): FixAttestation[];
+//# sourceMappingURL=markers.d.ts.map

package/dist/utils/agent/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../src/utils/agent/markers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAIlC;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAGhE;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAIpE;AAYD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAG1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,GAAG,UAAU,GAChC,iBAAiB,GAAG,IAAI,CAe1B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CASvH;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAa5E;AAED,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAQvE;AAED,mGAAmG;AACnG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAQrE"}