kibi-cli 2.28.1 → 2.30.0

package/dist/signoff/collect.js

@@ -0,0 +1,398 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { effectiveFirmness } from "../decision-firmness.js";
+import { extractFromMarkdownString, } from "../extractors/markdown.js";
+import { readAllShards } from "../relationships/shards.js";
+import { SIGNOFF_VERSION, } from "./model.js";
+const REQUIREMENTS_DIR = ".kb/requirements";
+const SCENARIOS_DIR = ".kb/scenarios";
+const EMPTY_TREE = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
+const RETIRED_STATUS = /supersed|deprecat|reject|obsolete|retired|archived|removed|closed/i;
+const REQUIREMENT_ID = /^REQ-[A-Za-z0-9._-]+$/;
+function gitRunner(workspaceRoot) {
+    return (args) => execFileSync("git", [...args], {
+        cwd: workspaceRoot,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        maxBuffer: 64 * 1024 * 1024,
+    });
+}
+function tryGit(git, args) {
+    try {
+        return git(args);
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseEntity(content, filePath) {
+    if (content === undefined)
+        return undefined;
+    try {
+        return extractFromMarkdownString(content, filePath).entity;
+    }
+    catch {
+        return undefined;
+    }
+}
+function flat(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+/** The requirement's statement: its semantic text, else its title. */
+export function requirementStatement(entity) {
+    return flat(entity.semantic_text ?? entity.title ?? "");
+}
+function firmnessOf(entity) {
+    return effectiveFirmness(entity.type, entity.firmness, entity.origin);
+}
+function statementRef(entity) {
+    const firmness = firmnessOf(entity);
+    return {
+        id: entity.id,
+        title: flat(entity.title ?? entity.id),
+        statement: requirementStatement(entity),
+        ...(firmness ? { firmness } : {}),
+    };
+}
+/** Requirement documents the change adds, modifies or deletes. */
+function changedRequirementFiles(git, scope, base) {
+    const args = scope === "staged"
+        ? ["diff", "--cached", "--name-status", "--no-renames", base]
+        : ["diff", "--name-status", "--no-renames", base];
+    const output = git([...args, "--", REQUIREMENTS_DIR]);
+    const files = [];
+    for (const line of output.split("\n")) {
+        const [status, file] = line.split("\t");
+        if (!file?.endsWith(".md"))
+            continue;
+        if (status === "A" || status === "M" || status === "D") {
+            files.push({ status, file });
+        }
+    }
+    if (scope === "working") {
+        const untracked = git([
+            "ls-files",
+            "--others",
+            "--exclude-standard",
+            "--",
+            REQUIREMENTS_DIR,
+        ]);
+        for (const file of untracked.split("\n")) {
+            if (file.endsWith(".md"))
+                files.push({ status: "A", file });
+        }
+    }
+    return files.sort((left, right) => left.file.localeCompare(right.file));
+}
+function currentContent(workspaceRoot, git, scope, file) {
+    if (scope === "staged")
+        return tryGit(git, ["show", `:${file}`]);
+    try {
+        return readFileSync(path.join(workspaceRoot, file), "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Requirement entities in the working tree, read lazily by id. */
+function workspaceRequirements(workspaceRoot) {
+    const cache = new Map();
+    return (id) => {
+        if (!REQUIREMENT_ID.test(id))
+            return undefined;
+        if (!cache.has(id)) {
+            const file = path.join(workspaceRoot, REQUIREMENTS_DIR, `${id}.md`);
+            cache.set(id, existsSync(file)
+                ? parseEntity(readFileSync(file, "utf8"), file)
+                : undefined);
+        }
+        return cache.get(id);
+    };
+}
+function scenarioTitle(workspaceRoot, id) {
+    const file = path.join(workspaceRoot, SCENARIOS_DIR, `${id}.md`);
+    if (!/^SCEN-[A-Za-z0-9._-]+$/.test(id) || !existsSync(file))
+        return id;
+    return flat(parseEntity(readFileSync(file, "utf8"), file)?.title ?? id);
+}
+function readRelationships(workspaceRoot) {
+    try {
+        return readAllShards(path.join(workspaceRoot, ".kb"));
+    }
+    catch {
+        return [];
+    }
+}
+function headExists(git) {
+    return (tryGit(git, ["rev-parse", "--verify", "--quiet", "HEAD"]) !== undefined);
+}
+// implements REQ-kibi-signoff-views
+/**
+ * The end-of-work signoff summary: the requirements the change adds, rewrites,
+ * retires, or leaves unchanged while changing code that implements them, each
+ * with its statement, firmness, origin, scenarios and proof state.
+ */
+export async function collectSignoffSummary(workspaceRoot, scope, deps = {}) {
+    const git = deps.git ?? gitRunner(workspaceRoot);
+    const notes = [];
+    const base = headExists(git) ? "HEAD" : EMPTY_TREE;
+    const readRequirement = workspaceRequirements(workspaceRoot);
+    const relationships = readRelationships(workspaceRoot);
+    const outgoing = (id, type) => relationships
+        .filter((relationship) => relationship.from === id)
+        .filter((relationship) => relationship.type === type)
+        .map((relationship) => relationship.to);
+    const drafts = new Map();
+    const draftFor = (entity, change, source, previous) => {
+        const statement = requirementStatement(entity);
+        const previousStatement = previous
+            ? requirementStatement(previous)
+            : undefined;
+        const firmness = firmnessOf(entity);
+        const origin = entity.origin;
+        return {
+            id: entity.id,
+            title: flat(entity.title ?? entity.id),
+            change,
+            status: entity.status ?? "",
+            statement,
+            ...(previousStatement !== undefined && previousStatement !== statement
+                ? { previousStatement }
+                : {}),
+            ...(firmness ? { firmness } : {}),
+            ...(origin?.kind ? { originKind: origin.kind } : {}),
+            ...(origin?.ref ? { originRef: flat(origin.ref) } : {}),
+            ...(origin?.approved_by ? { approvedBy: origin.approved_by } : {}),
+            supersedes: outgoing(entity.id, "supersedes")
+                .map((id) => readRequirement(id))
+                .filter((ref) => ref !== undefined)
+                .map(statementRef),
+            scenarios: outgoing(entity.id, "specified_by")
+                .filter((id) => id.startsWith("SCEN-"))
+                .map((id) => ({ id, title: scenarioTitle(workspaceRoot, id) })),
+            symbols: [],
+            source,
+        };
+    };
+    let files = [];
+    try {
+        files = changedRequirementFiles(git, scope, base);
+    }
+    catch (error) {
+        notes.push(`Changed requirement documents could not be listed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    for (const { status, file } of files) {
+        const before = status === "A"
+            ? undefined
+            : parseEntity(tryGit(git, ["show", `${base}:${file}`]), file);
+        if (status === "D") {
+            if (before?.type === "req") {
+                drafts.set(before.id, draftFor(before, "retired", file));
+            }
+            continue;
+        }
+        const entity = parseEntity(currentContent(workspaceRoot, git, scope, file), file);
+        if (entity?.type !== "req")
+            continue;
+        const retired = RETIRED_STATUS.test(entity.status ?? "") &&
+            !RETIRED_STATUS.test(before?.status ?? "");
+        const change = status === "A" ? "new" : retired ? "retired" : "changed";
+        drafts.set(entity.id, draftFor(entity, change, file, before));
+    }
+    try {
+        const affected = await (deps.loadAffected ??
+            ((value) => loadAffectedForScope(workspaceRoot, value)))(scope);
+        for (const [id, symbols] of affected) {
+            const existing = drafts.get(id);
+            if (existing) {
+                drafts.set(id, { ...existing, symbols: [...symbols].sort() });
+                continue;
+            }
+            const entity = readRequirement(id);
+            if (!entity || RETIRED_STATUS.test(entity.status ?? ""))
+                continue;
+            drafts.set(id, {
+                ...draftFor(entity, "affected", `${REQUIREMENTS_DIR}/${id}.md`),
+                symbols: [...symbols].sort(),
+            });
+        }
+    }
+    catch (error) {
+        notes.push(`Requirements affected by code changes could not be computed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    let proof = new Map();
+    if (drafts.size > 0 && deps.loadProof) {
+        try {
+            proof = await deps.loadProof();
+        }
+        catch (error) {
+            notes.push(`Proof state is unavailable: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    const unsynced = [...drafts.values()].filter((draft) => draft.change !== "retired" && !proof.has(draft.id));
+    if (proof.size > 0 && unsynced.length > 0) {
+        notes.push(`${unsynced.map((draft) => draft.id).join(", ")} ${unsynced.length === 1 ? "is" : "are"} not in the synced knowledge base yet; run kibi sync to see ${unsynced.length === 1 ? "its" : "their"} proof state.`);
+    }
+    const order = {
+        new: 0,
+        changed: 1,
+        affected: 2,
+        retired: 3,
+    };
+    const requirements = [...drafts.values()]
+        .map((draft) => {
+        const row = proof.get(draft.id);
+        return row ? { ...draft, proof: row } : draft;
+    })
+        .sort((left, right) => order[left.change] - order[right.change] ||
+        left.id.localeCompare(right.id));
+    const branch = tryGit(git, ["rev-parse", "--abbrev-ref", "HEAD"])?.trim();
+    return {
+        version: SIGNOFF_VERSION,
+        kind: "summary",
+        scope,
+        generatedAt: (deps.now ?? (() => new Date()))().toISOString(),
+        ...(branch && branch !== "HEAD" ? { branch } : {}),
+        requirements,
+        notes,
+    };
+}
+// implements REQ-kibi-signoff-views
+/**
+ * Requirements whose implementing code the change edits, read from the
+ * `requirement_statement_unverified` impact diagnostics of `kibi check`.
+ */
+export async function loadAffectedForScope(workspaceRoot, scope) {
+    const { analyzeChangedFileImpact } = await import("../public/impact/analyzer.js");
+    const result = await analyzeChangedFileImpact({
+        workspaceRoot,
+        ...(scope === "staged"
+            ? { staged: true }
+            : { includeWorkingTreeDiff: true }),
+        includeImpactDiagnostics: true,
+    });
+    const affected = new Map();
+    for (const diagnostic of result.impactDiagnostics) {
+        if (diagnostic.id !== "requirement_statement_unverified")
+            continue;
+        const evidence = diagnostic.evidence;
+        const id = typeof evidence?.requirement === "string"
+            ? evidence.requirement
+            : diagnostic.entityId;
+        if (!id)
+            continue;
+        const symbols = Array.isArray(evidence?.symbols)
+            ? evidence.symbols.filter((symbol) => typeof symbol === "string")
+            : [];
+        affected.set(id, symbols);
+    }
+    return affected;
+}
+// implements REQ-kibi-signoff-views
+/**
+ * The mid-work decision questions, numbered, with the recorded requirement a
+ * question would change and the recorded rules it conflicts with quoted from
+ * the knowledge base rather than from the agent's memory.
+ */
+export function collectSignoffQuestions(workspaceRoot, inputs, now = () => new Date()) {
+    const readRequirement = workspaceRequirements(workspaceRoot);
+    const notes = [];
+    const questions = inputs.map((input, index) => {
+        const current = input.id ? readRequirement(input.id) : undefined;
+        const conflicts = [];
+        for (const id of input.conflictsWith ?? []) {
+            const entity = readRequirement(id);
+            if (entity)
+                conflicts.push(statementRef(entity));
+            else
+                notes.push(`Question ${index + 1}: ${id} is not a recorded requirement.`);
+        }
+        return {
+            ...input,
+            number: index + 1,
+            ...(current ? { current: statementRef(current) } : {}),
+            conflicts,
+        };
+    });
+    return {
+        version: SIGNOFF_VERSION,
+        kind: "questions",
+        generatedAt: now().toISOString(),
+        questions,
+        notes,
+    };
+}
+const FIRMNESS_VALUES = new Set(["firm", "default", "exploratory"]);
+function optionalString(record, key, where) {
+    const value = record[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new Error(`${where}.${key} must be a string`);
+    }
+    return value.trim() === "" ? undefined : value.trim();
+}
+function optionalStrings(record, key, where) {
+    const value = record[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`${where}.${key} must be an array of strings`);
+    }
+    return value.map((item) => item.trim()).filter(Boolean);
+}
+// implements REQ-kibi-signoff-views
+/**
+ * Parse the questions input: `{"questions":[{statement, id?, title?, quote?,
+ * firmness?, governs?, conflictsWith?, question?, answer?}]}` or a bare array.
+ */
+export function parseSignoffQuestionsInput(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`Questions input is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const list = Array.isArray(parsed)
+        ? parsed
+        : parsed !== null && typeof parsed === "object"
+            ? parsed.questions
+            : undefined;
+    if (!Array.isArray(list) || list.length === 0) {
+        throw new Error('Questions input must be {"questions":[...]} or an array with at least one question');
+    }
+    return list.map((item, index) => {
+        const where = `questions[${index}]`;
+        if (item === null || typeof item !== "object" || Array.isArray(item)) {
+            throw new Error(`${where} must be an object`);
+        }
+        const record = item;
+        const statement = optionalString(record, "statement", where);
+        if (!statement)
+            throw new Error(`${where}.statement is required`);
+        const firmness = optionalString(record, "firmness", where);
+        if (firmness !== undefined && !FIRMNESS_VALUES.has(firmness)) {
+            throw new Error(`${where}.firmness must be firm, default or exploratory`);
+        }
+        const id = optionalString(record, "id", where);
+        const title = optionalString(record, "title", where);
+        const quote = optionalString(record, "quote", where);
+        const governs = optionalStrings(record, "governs", where);
+        const conflictsWith = optionalStrings(record, "conflictsWith", where);
+        const question = optionalString(record, "question", where);
+        const answer = optionalString(record, "answer", where);
+        return {
+            statement: flat(statement),
+            ...(id ? { id } : {}),
+            ...(title ? { title } : {}),
+            ...(quote ? { quote } : {}),
+            ...(firmness ? { firmness: firmness } : {}),
+            ...(governs?.length ? { governs } : {}),
+            ...(conflictsWith?.length ? { conflictsWith } : {}),
+            ...(question ? { question } : {}),
+            ...(answer ? { answer } : {}),
+        };
+    });
+}

package/dist/signoff/html.d.ts

@@ -0,0 +1,4 @@
+import { type SignoffView } from "./model.js";
+/** A signoff view as a self-contained HTML page with no network assets. */
+export declare function renderSignoffHtml(view: SignoffView): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/signoff/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/signoff/html.ts"],"names":[],"mappings":"AAMA,OAAO,EAOL,KAAK,WAAW,EAQjB,MAAM,YAAY,CAAC;AA6OpB,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAoC3D"}

package/dist/signoff/html.js

@@ -0,0 +1,210 @@
+import { KIBI_BRAND, renderKibiFaviconDataUri, renderKibiLogo, } from "../report/brand.js";
+import { REPORT_CSP } from "../report/html-report.js";
+import { SIGNOFF_CHANGE_LABELS, approvalNumbers, approvalSentence, awaitsApproval, proofLabel, questionKind, questionOpen, statementSentenceDiff, } from "./model.js";
+function escapeHtml(value) {
+    return String(value ?? "")
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+function styles() {
+    return `
+:root{--bg:${KIBI_BRAND.deepCarbon};--panel:${KIBI_BRAND.panel};--text:${KIBI_BRAND.snow};--muted:${KIBI_BRAND.mist};--rail:${KIBI_BRAND.rail};--accent:${KIBI_BRAND.ice};--signal:${KIBI_BRAND.signal};--ok:${KIBI_BRAND.success};--warn:${KIBI_BRAND.warning};--bad:${KIBI_BRAND.danger}}
+@media (prefers-color-scheme: light){:root{--bg:#f4f6f8;--panel:#ffffff;--text:#1d1e23;--muted:#4f5b66;--rail:#d5dde3;--accent:#1f5f99;--signal:#1f5f99;--ok:#1e7a4f;--warn:#8a5a00;--bad:#b3261e}}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--text);font:15px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif}
+main{max-width:920px;margin:0 auto;padding:24px 16px 48px}
+header.page{display:flex;gap:12px;align-items:center;margin-bottom:8px}
+header.page svg{width:36px;height:36px;flex:none}
+h1{font-size:22px;margin:0}
+.meta{color:var(--muted);font-size:13px;margin:0 0 20px}
+h2{font-size:16px;margin:28px 0 10px;color:var(--accent)}
+.card{background:var(--panel);border:1px solid var(--rail);border-radius:10px;padding:14px 16px;margin:10px 0}
+.card--answered{opacity:.6}
+.card__head{display:flex;flex-wrap:wrap;gap:8px;align-items:baseline}
+.num{font-weight:700;color:var(--muted)}
+.id{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:13px;color:var(--accent)}
+.title{font-weight:600}
+.badge{font-size:12px;padding:1px 8px;border-radius:999px;border:1px solid var(--rail);color:var(--muted)}
+.badge--firm{border-color:var(--warn);color:var(--warn)}
+.badge--exploratory{border-color:var(--signal);color:var(--signal)}
+.badge--proven{border-color:var(--ok);color:var(--ok)}
+.badge--answered{border-color:var(--ok);color:var(--ok)}
+.badge--approval{border-color:var(--signal);color:var(--signal);font-weight:600}
+.callout{margin:12px 0 4px;padding:10px 14px;border:1px solid var(--signal);border-radius:8px;color:var(--text)}
+blockquote{margin:10px 0;padding:8px 12px;border-left:3px solid var(--accent);background:rgba(127,127,127,.08);border-radius:0 6px 6px 0}
+.diff{display:grid;gap:6px;margin:10px 0}
+.diff blockquote{margin:0}
+.diff .was{border-left-color:var(--bad);text-decoration:line-through;text-decoration-color:rgba(240,113,120,.6)}
+.diff .now{border-left-color:var(--ok)}
+.diff ins{text-decoration:none;background:rgba(61,186,128,.18);color:var(--text);border-radius:3px;padding:0 2px}
+.diff del{color:var(--muted);text-decoration-color:var(--bad);background:rgba(240,113,120,.12);border-radius:3px;padding:0 2px}
+.label{font-size:12px;color:var(--muted);text-transform:uppercase;letter-spacing:.04em}
+dl{display:grid;grid-template-columns:max-content 1fr;gap:4px 12px;margin:8px 0 0;font-size:14px}
+dt{color:var(--muted)}
+dd{margin:0;overflow-wrap:anywhere}
+.conflict{color:var(--bad)}
+.notes{color:var(--muted);font-size:13px}
+.empty{color:var(--muted)}
+footer{margin-top:28px;color:var(--muted);font-size:13px}
+`;
+}
+function firmnessBadge(firmness) {
+    const value = firmness ?? "default";
+    return `<span class="badge badge--${escapeHtml(value)}">${escapeHtml(value)}</span>`;
+}
+function row(label, value) {
+    return `<dt>${escapeHtml(label)}</dt><dd>${value}</dd>`;
+}
+function statementBlock(statement, previous, previousLabel = "Was", currentLabel = "Now") {
+    if (previous === undefined) {
+        return `<blockquote>${escapeHtml(statement)}</blockquote>`;
+    }
+    const diff = statementSentenceDiff(previous, statement);
+    if (diff !== undefined) {
+        const text = diff
+            .map((part) => part.change === "added"
+            ? `<ins>${escapeHtml(part.text)}</ins>`
+            : part.change === "removed"
+                ? `<del>${escapeHtml(part.text)}</del>`
+                : escapeHtml(part.text))
+            .join(" ");
+        return `<div class="diff"><span class="label">${escapeHtml(currentLabel)}, with the changed sentences marked</span><blockquote class="now">${text}</blockquote></div>`;
+    }
+    return `<div class="diff"><span class="label">${escapeHtml(previousLabel)}</span><blockquote class="was">${escapeHtml(previous)}</blockquote><span class="label">${escapeHtml(currentLabel)}</span><blockquote class="now">${escapeHtml(statement)}</blockquote></div>`;
+}
+function requirementCard(requirement, number) {
+    const details = [];
+    const origin = [
+        requirement.originKind,
+        requirement.originRef ? `“${requirement.originRef}”` : undefined,
+        requirement.approvedBy
+            ? `approved by ${requirement.approvedBy}`
+            : undefined,
+    ].filter(Boolean);
+    if (origin.length > 0)
+        details.push(row("Origin", escapeHtml(origin.join(", "))));
+    for (const superseded of requirement.supersedes) {
+        details.push(row("Replaces", `<span class="id">${escapeHtml(superseded.id)}</span> ${firmnessBadge(superseded.firmness)} ${escapeHtml(superseded.statement)}`));
+    }
+    if (requirement.symbols.length > 0) {
+        details.push(row("Changed code", escapeHtml(requirement.symbols.join(", "))));
+    }
+    if (requirement.change !== "retired") {
+        details.push(row("Scenarios", requirement.scenarios.length === 0
+            ? '<span class="empty">none yet</span>'
+            : requirement.scenarios
+                .map((scenario) => `<span class="id">${escapeHtml(scenario.id)}</span>${scenario.title === scenario.id ? "" : ` ${escapeHtml(scenario.title)}`}`)
+                .join("<br>")));
+        const proven = requirement.proof?.gate === "proven";
+        details.push(row("Proof", `<span class="badge${proven ? " badge--proven" : ""}">${escapeHtml(proofLabel(requirement.proof))}</span>`));
+        for (const conflict of requirement.proof?.contradictions ?? []) {
+            details.push(row("Contradiction", `<span class="conflict">${escapeHtml(conflict)}</span>`));
+        }
+    }
+    return `<article class="card" id="${escapeHtml(requirement.id)}">
+<div class="card__head"><span class="num">${number}.</span><span class="id">${escapeHtml(requirement.id)}</span>${firmnessBadge(requirement.firmness)}<span class="title">${escapeHtml(requirement.title)}</span>${awaitsApproval(requirement) ? '<span class="badge badge--approval">awaits your approval</span>' : ""}</div>
+${statementBlock(requirement.statement, requirement.previousStatement)}
+<dl>${details.join("")}</dl>
+</article>`;
+}
+function summaryBody(summary) {
+    const order = [
+        "new",
+        "changed",
+        "affected",
+        "retired",
+    ];
+    const sections = [];
+    const approvals = approvalNumbers(order.flatMap((change) => summary.requirements.filter((item) => item.change === change)));
+    if (approvals.length > 0) {
+        sections.push(`<p class="callout">${escapeHtml(approvalSentence(approvals))} Reply by number, for example “approve 1”.</p>`);
+    }
+    let number = 0;
+    for (const change of order) {
+        const rows = summary.requirements.filter((item) => item.change === change);
+        if (rows.length === 0)
+            continue;
+        sections.push(`<h2>${escapeHtml(SIGNOFF_CHANGE_LABELS[change])} (${rows.length})</h2>`);
+        for (const item of rows) {
+            number += 1;
+            sections.push(requirementCard(item, number));
+        }
+    }
+    if (sections.length === 0) {
+        sections.push('<p class="empty">This change adds, rewrites or affects no requirement.</p>');
+    }
+    return sections.join("\n");
+}
+function questionCard(question) {
+    const kind = questionKind(question);
+    const title = question.title ?? question.current?.title ?? question.id;
+    if (!questionOpen(question)) {
+        return `<article class="card card--answered"><div class="card__head"><span class="num">${question.number}.</span><span class="title">${escapeHtml(kind)}${title ? `: ${escapeHtml(title)}` : ""}</span><span class="badge badge--answered">answered: ${escapeHtml(question.answer)}</span></div></article>`;
+    }
+    const details = [];
+    if (question.quote)
+        details.push(row("Your words", escapeHtml(`“${question.quote}”`)));
+    if (question.governs?.length)
+        details.push(row("Governs", escapeHtml(question.governs.join(", "))));
+    for (const conflict of question.conflicts) {
+        details.push(row("Conflicts with", `<span class="id conflict">${escapeHtml(conflict.id)}</span> ${firmnessBadge(conflict.firmness)} ${escapeHtml(conflict.statement)}`));
+    }
+    if (question.question)
+        details.push(row("Question", escapeHtml(question.question)));
+    return `<article class="card" id="q${question.number}">
+<div class="card__head"><span class="num">${question.number}.</span><span class="title">${escapeHtml(kind)}${title ? `: ${escapeHtml(title)}` : ""}</span>${question.firmness ? `<span class="badge badge--${escapeHtml(question.firmness)}">would be ${escapeHtml(question.firmness)}</span>` : ""}</div>
+${statementBlock(question.statement, question.current?.statement, "Recorded now", "Proposed")}
+<dl>${details.join("")}</dl>
+</article>`;
+}
+function questionsBody(view) {
+    const open = view.questions.filter(questionOpen);
+    const answered = view.questions.filter((question) => !questionOpen(question));
+    const parts = [`<h2>Open (${open.length})</h2>`, ...open.map(questionCard)];
+    if (open.length > 0) {
+        parts.push('<p class="notes">Answer in the chat by number, for example “1 yes, 2 exploratory, 3 reword: …”.</p>');
+    }
+    if (answered.length > 0) {
+        parts.push(`<h2>Answered (${answered.length})</h2>`, ...answered.map(questionCard));
+    }
+    return parts.join("\n");
+}
+// implements REQ-kibi-signoff-views
+/** A signoff view as a self-contained HTML page with no network assets. */
+export function renderSignoffHtml(view) {
+    const heading = view.kind === "summary" ? "Requirements signoff" : "Decisions to confirm";
+    const meta = view.kind === "summary"
+        ? [
+            view.branch ? `Branch ${view.branch}` : undefined,
+            view.scope === "staged" ? "staged changes" : "working tree",
+            `generated ${view.generatedAt}`,
+        ]
+        : [`generated ${view.generatedAt}`];
+    const body = view.kind === "summary" ? summaryBody(view) : questionsBody(view);
+    const notes = view.notes.length
+        ? `<footer>${view.notes.map((note) => `<p class="notes">${escapeHtml(note)}</p>`).join("")}</footer>`
+        : "";
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="${REPORT_CSP}">
+<title>Kibi ${escapeHtml(heading.toLowerCase())}</title>
+<link rel="icon" href="${renderKibiFaviconDataUri()}">
+<style>${styles()}</style>
+</head>
+<body>
+<main>
+<header class="page">${renderKibiLogo()}<h1>${escapeHtml(heading)}</h1></header>
+<p class="meta">${escapeHtml(meta.filter(Boolean).join(" · "))}</p>
+${body}
+${notes}
+</main>
+</body>
+</html>
+`;
+}

package/dist/signoff/markdown.d.ts

@@ -0,0 +1,20 @@
+import { type SignoffQuestions, type SignoffSummary, type SignoffView } from "./model.js";
+/** Rows shown in chat before the rest is left to the HTML view. */
+export declare const SIGNOFF_MARKDOWN_LIMIT = 15;
+/** The end-of-work summary as Markdown, without the fence. */
+export declare function renderSummaryMarkdownBody(summary: SignoffSummary, limit?: number): string;
+/** The mid-work decision questions as Markdown, without the fence. */
+export declare function renderQuestionsMarkdownBody(view: SignoffQuestions): string;
+/**
+ * A signoff view as plain Markdown for a chat reply or a messaging tool
+ * (headings, quotes and lists that any Markdown surface renders), with no
+ * fence for a host renderer to find.
+ */
+export declare function renderSignoffChatMarkdown(view: SignoffView): string;
+/**
+ * A signoff view as the fenced block agents paste into chat. Host renderers
+ * (the Claude Code display hook, the OpenCode TUI) key on the fence's info
+ * string; hosts without one show it as a code block, so they get `chat`.
+ */
+export declare function renderSignoffMarkdown(view: SignoffView): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/signoff/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/signoff/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EAErB,KAAK,cAAc,EACnB,KAAK,WAAW,EAQjB,MAAM,YAAY,CAAC;AAEpB,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AA6HzC,8DAA8D;AAC9D,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,cAAc,EACvB,KAAK,SAAyB,GAC7B,MAAM,CAmCR;AAGD,sEAAsE;AACtE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA8C1E;AAGD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAInE;AAGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAM/D"}