gitifact 0.8.4 → 0.8.5

package/dist/main.js

@@ -3517,6 +3517,9 @@ var messages_default = {
   "warn.ASSET_EXTENSION": "\uBE0C\uB77C\uC6B0\uC800\uAC00 \uBBF8\uB9AC \uBCF4\uC5EC \uC8FC\uC9C0 \uC54A\uB294 \uD655\uC7A5\uC790\uB77C \uB0B4\uB824\uBC1B\uAE30\uB85C\uB9CC \uC5F4\uB9BD\uB2C8\uB2E4: {path}",
   "warn.UNREFERENCED_ASSET": "\uC5B4\uB5A4 \uBB38\uC11C\uB3C4 \uAC00\uB9AC\uD0A4\uC9C0 \uC54A\uB294 \uC5D0\uC14B\uC785\uB2C8\uB2E4: {path}",
   "warn.ASSETS_TOTAL_SIZE": "\uC5D0\uC14B \uC804\uCCB4\uAC00 \uAD8C\uC7A5 \uD06C\uAE30(50MB)\uB97C \uB118\uC2B5\uB2C8\uB2E4: {bytes}\uBC14\uC774\uD2B8",
+  "warn.DESIGN_OVERVIEW_LARGE": "\uC124\uACC4 overview.md\uC758 \uC808\uC774 {sections}\uAC1C\uC785\uB2C8\uB2E4. \uB367\uBD99\uC774\uAE30 \uC804\uC5D0 \uCD95 \uD30C\uC77C\uB85C \uB098\uB20C\uC9C0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB3C\uC73C\uC138\uC694(guide show design\uC758 \uAC1C\uC815): {path}",
+  "warn.REQUIREMENT_SCOPE_FORMAT": "\uBC94\uC704\uC640 \uC81C\uC57D\uC740 \uC218\uC6A9 \uC870\uAC74 \uC55E\uC5D0 - \uBAA9\uB85D\uC73C\uB85C\uB9CC \uC501\uB2C8\uB2E4(guide show spec): {path}",
+  "warn.REQUIREMENT_CRITERIA_FORMAT": "\uC218\uC6A9 \uC870\uAC74 \uC544\uB798\uC5D0\uB294 \uBC88\uD638 \uD56D\uBAA9\uB9CC \uB461\uB2C8\uB2E4. \uADDC\uCE59\uC740 \uBC94\uC704\uC640 \uC81C\uC57D\uC73C\uB85C \uC62E\uAE30\uC138\uC694(guide show spec): {path}",
   "config.migrationRequired": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 0.7 \uC800\uC7A5 \uADDC\uC57D(schemaVersion 2)\uC785\uB2C8\uB2E4. 0.8.0 CLI\uB294 \uC61B \uD615\uC2DD\uC744 \uC77D\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. gitifact guide show migrate\uC758 \uC808\uCC28\uB85C \uBB38\uC11C\uB97C \uC0C8 \uAD6C\uC870\uB85C \uC62E\uAE30\uC138\uC694."
 };
 
@@ -3636,6 +3639,9 @@ var messages_default2 = {
   "warn.ASSET_EXTENSION": "The browser does not preview this extension and offers it only as a download: {path}",
   "warn.UNREFERENCED_ASSET": "No document refers to this asset: {path}",
   "warn.ASSETS_TOTAL_SIZE": "All assets together are over the recommended size (50 MB): {bytes} bytes",
+  "warn.DESIGN_OVERVIEW_LARGE": "The design overview.md has {sections} sections. Before adding to it, ask the user whether to split it into axis files (revising, in guide show design): {path}",
+  "warn.REQUIREMENT_SCOPE_FORMAT": "Scope and constraints come before the acceptance criteria, as - items only (guide show spec): {path}",
+  "warn.REQUIREMENT_CRITERIA_FORMAT": "The acceptance criteria hold numbered items only; move rules to scope and constraints (guide show spec): {path}",
   "config.migrationRequired": "This project uses the 0.7 storage convention (schemaVersion 2). The 0.8.0 CLI does not read the old format. Move the documents to the new structure by following gitifact guide show migrate."
 };
 
@@ -3860,20 +3866,20 @@ var scalar = (value) => {
     fail(t("frontmatter.scalar", { value }));
   return value;
 };
-function parseFrontmatter(lines, kind2, legacyIds) {
-  const legacy = new RegExp(`^<!-- ${marker}-(?:${kind2 === "wiki" ? "product|guide" : kind2}): (${legacyIds}-${token}) -->$`).exec(lines[0] ?? "");
+function parseFrontmatter(lines2, kind2, legacyIds) {
+  const legacy = new RegExp(`^<!-- ${marker}-(?:${kind2 === "wiki" ? "product|guide" : kind2}): (${legacyIds}-${token}) -->$`).exec(lines2[0] ?? "");
   if (legacy) {
-    lines.shift();
+    lines2.shift();
     return { id: legacy[1] };
   }
-  if (lines[0] !== "---")
+  if (lines2[0] !== "---")
     fail(t("frontmatter.required"));
-  lines.shift();
-  const end = lines.indexOf("---");
+  lines2.shift();
+  const end = lines2.indexOf("---");
   if (end === -1)
     fail(t("frontmatter.unclosed"));
-  const block = lines.splice(0, end);
-  lines.shift();
+  const block = lines2.splice(0, end);
+  lines2.shift();
   const fields2 = /* @__PURE__ */ new Map();
   for (let i = 0; i < block.length; i++) {
     const line2 = block[i];
@@ -3938,17 +3944,17 @@ function validateSource(value) {
 function parseDesign(source2, specId) {
   if (source2.includes("\0") || /\r(?!\n)/.test(source2))
     fail(t("design.invalidCharacters"));
-  const lines = normalized(source2).split("\n");
-  const front = parseFrontmatter(lines, "design", "S");
+  const lines2 = normalized(source2).split("\n");
+  const front = parseFrontmatter(lines2, "design", "S");
   if (front.id !== specId)
     fail(t("design.idMismatch"));
-  while (lines[0] === "")
-    lines.shift();
-  const heading = lines.shift();
+  while (lines2[0] === "")
+    lines2.shift();
+  const heading = lines2.shift();
   if (!heading?.startsWith("# ") || !heading.slice(2).trim())
     fail(t("design.titleRequired"));
   const title = heading.slice(2).trim();
-  const raw = normalized(lines.join("\n"));
+  const raw = normalized(lines2.join("\n"));
   if (!raw)
     fail(t("design.bodyRequired"));
   const references = /* @__PURE__ */ new Set();
@@ -3986,15 +3992,15 @@ function parseDocument(path3, source2) {
   validateDocumentRelativePath(match[1]);
   if (source2.includes("\0") || /\r(?!\n)/.test(source2))
     fail(t("document.invalidCharacters", { path: path3 }));
-  const lines = normalized(source2).split("\n");
-  const { id } = parseFrontmatter(lines, "wiki", "W");
-  while (lines[0] === "")
-    lines.shift();
-  const heading = lines.shift();
+  const lines2 = normalized(source2).split("\n");
+  const { id } = parseFrontmatter(lines2, "wiki", "W");
+  while (lines2[0] === "")
+    lines2.shift();
+  const heading = lines2.shift();
   if (!heading?.startsWith("# ") || !heading.slice(2).trim())
     fail(t("document.titleRequired", { path: path3 }));
   const title = heading.slice(2).trim();
-  const body2 = normalized(lines.join("\n"));
+  const body2 = normalized(lines2.join("\n"));
   if (!body2)
     fail(t("document.bodyRequired", { path: path3 }));
   let fence;
@@ -4081,8 +4087,8 @@ function parseSpec(path3, source2, history = "", designSource) {
     fail(t("spec.unsupportedPath", { path: path3 }));
   if (source2.includes("\0") || source2.includes("\r") && /\r(?!\n)/.test(source2))
     fail(t("spec.invalidCharacters", { path: path3 }));
-  const lines = normalized(source2).split("\n");
-  const specId = parseFrontmatter(lines, "spec", "S").id;
+  const lines2 = normalized(source2).split("\n");
+  const specId = parseFrontmatter(lines2, "spec", "S").id;
   let title = "";
   let description = "";
   let current2;
@@ -4095,8 +4101,8 @@ function parseSpec(path3, source2, history = "", designSource) {
     else
       description += line2 + "\n";
   };
-  for (let i = 0; i < lines.length; i++) {
-    const line2 = lines[i];
+  for (let i = 0; i < lines2.length; i++) {
+    const line2 = lines2[i];
     if (waitingId) {
       const match = new RegExp(`^<!-- ${marker}-req: (R-${token}) -->$`).exec(line2);
       if (!match || !current2)
@@ -4336,13 +4342,13 @@ function quoteScalar(value) {
   return plain2 ? value : '"' + value.replace(/[\\"]/g, "\\$&") + '"';
 }
 function parseFrontmatterBlock(source2, path3) {
-  const lines = source2.split("\n");
-  if (lines[0] !== "---")
+  const lines2 = source2.split("\n");
+  if (lines2[0] !== "---")
     throw new DocumentError("FRONTMATTER_REQUIRED", path3, t("doc.FRONTMATTER_REQUIRED", { path: path3 }));
-  const end = lines.indexOf("---", 1);
+  const end = lines2.indexOf("---", 1);
   if (end === -1)
     throw new DocumentError("FRONTMATTER_UNCLOSED", path3, t("doc.FRONTMATTER_UNCLOSED", { path: path3 }));
-  const block = lines.slice(1, end);
+  const block = lines2.slice(1, end);
   const fields2 = /* @__PURE__ */ new Map();
   const bad = (line2) => new DocumentError("FRONTMATTER_LINE", path3, t("doc.FRONTMATTER_LINE", { path: path3, line: line2 }));
   for (let i = 0; i < block.length; i++) {
@@ -4385,7 +4391,7 @@ function parseFrontmatterBlock(source2, path3) {
       throw bad(line2);
     fields2.set(key, scalars.length ? { type: "list", items: scalars } : { type: "maps", items: maps });
   }
-  return { fields: fields2, body: lines.slice(end + 1).join("\n") };
+  return { fields: fields2, body: lines2.slice(end + 1).join("\n") };
 }
 function renderFrontmatterBlock(fields2) {
   const out = ["---"];
@@ -4929,6 +4935,7 @@ function compareDocumentSets(before, after) {
 }
 
 // ../../packages/core/dist/use-cases/document-warnings.js
+var OVERVIEW_SECTION_LIMIT = 7;
 function documentBodyLinks(documents) {
   return documents.flatMap((doc) => extractLinks(doc.body).flatMap((link3) => {
     const target = resolveLink(doc.path, link3);
@@ -4963,6 +4970,35 @@ function documentWarnings(documents, assets, existing) {
   }
   if (total > ASSETS_TOTAL_LIMIT)
     warnings.push(docWarning("ASSETS_TOTAL_SIZE", ASSETS_DIR, { bytes: total }));
+  for (const doc of documents) {
+    if (doc.kind !== "design" || !doc.path.endsWith("/design/overview.md"))
+      continue;
+    const sections2 = lines(doc.body).filter((line2) => /^##\s/.test(line2)).length;
+    if (sections2 >= OVERVIEW_SECTION_LIMIT)
+      warnings.push(docWarning("DESIGN_OVERVIEW_LARGE", doc.path, { sections: sections2 }));
+  }
+  return warnings;
+}
+var lines = (body2) => body2.replace(/\r\n/g, "\n").split("\n");
+var scopeHeading = /^###\s+(?:범위와 제약|scope and constraints)\s*$/i;
+var acceptanceHeading = /^###\s+(?:수용 조건|acceptance criteria)\s*$/i;
+function requirementFormatWarnings(doc) {
+  if (doc.kind !== "requirement")
+    return [];
+  const body2 = lines(doc.body);
+  const scope = body2.findIndex((line2) => scopeHeading.test(line2.trim()));
+  const acceptance = body2.findIndex((line2) => acceptanceHeading.test(line2.trim()));
+  const sectionOf = (start) => {
+    const rest = body2.slice(start + 1);
+    const end = rest.findIndex((line2) => /^#{1,3}\s/.test(line2));
+    return end < 0 ? rest : rest.slice(0, end);
+  };
+  const outside = (section2, item) => section2.some((line2) => line2.trim() !== "" && !item.test(line2) && !/^\s+\S/.test(line2));
+  const warnings = [];
+  if (scope >= 0 && (acceptance >= 0 && scope > acceptance || outside(sectionOf(scope), /^- /)))
+    warnings.push(docWarning("REQUIREMENT_SCOPE_FORMAT", doc.path));
+  if (acceptance >= 0 && (outside(sectionOf(acceptance), /^\d+\.\s/) || body2.slice(acceptance + 1).some((line2) => /^#{1,3}\s/.test(line2) && !scopeHeading.test(line2.trim()))))
+    warnings.push(docWarning("REQUIREMENT_CRITERIA_FORMAT", doc.path));
   return warnings;
 }
 
@@ -4981,12 +5017,12 @@ function parseChangelog(text4) {
   let entry2;
   let section2;
   const fail4 = (line2, key, values = {}) => new InitError("INVALID_CHANGELOG", t("changelog.atLine", { line: line2, reason: t(key, values) }));
-  const lines = text4.replace(/\r\n/g, "\n").split("\n");
+  const lines2 = text4.replace(/\r\n/g, "\n").split("\n");
   const close = (line2) => {
     if (entry2 && changelogSections.every((name2) => entry2[name2].length === 0))
       throw fail4(line2, "changelog.emptyVersion", { version: entry2.version });
   };
-  lines.forEach((raw, index) => {
+  lines2.forEach((raw, index) => {
     const line2 = index + 1;
     if (raw.trim() === "")
       return;
@@ -5024,7 +5060,7 @@ function parseChangelog(text4) {
     }
     throw fail4(line2, "changelog.unknownLine", { text: raw });
   });
-  close(lines.length);
+  close(lines2.length);
   if (entries.length === 0)
     throw fail4(1, "changelog.noVersions");
   return entries;
@@ -6997,14 +7033,14 @@ function toDotPath(_path) {
   return segs.join("");
 }
 function prettifyError(error62) {
-  const lines = [];
+  const lines2 = [];
   const issues = [...error62.issues].sort((a, b) => (a.path ?? []).length - (b.path ?? []).length);
   for (const issue2 of issues) {
-    lines.push(`\u2716 ${issue2.message}`);
+    lines2.push(`\u2716 ${issue2.message}`);
     if (issue2.path?.length)
-      lines.push(`  \u2192 at ${toDotPath(issue2.path)}`);
+      lines2.push(`  \u2192 at ${toDotPath(issue2.path)}`);
   }
-  return lines.join("\n");
+  return lines2.join("\n");
 }
 
 // ../../node_modules/.pnpm/zod@4.6.4/node_modules/zod/v4/core/parse.js
@@ -7839,9 +7875,9 @@ var Doc = class {
       return;
     }
     const content = arg;
-    const lines = content.split("\n").filter((x) => x);
-    const minIndent = Math.min(...lines.map((x) => x.length - x.trimStart().length));
-    const dedented = lines.map((x) => x.slice(minIndent)).map((x) => " ".repeat(this.indent * 2) + x);
+    const lines2 = content.split("\n").filter((x) => x);
+    const minIndent = Math.min(...lines2.map((x) => x.length - x.trimStart().length));
+    const dedented = lines2.map((x) => x.slice(minIndent)).map((x) => " ".repeat(this.indent * 2) + x);
     for (const line2 of dedented) {
       this.content.push(line2);
     }
@@ -25198,16 +25234,25 @@ var event = external_exports.strictObject({
   after: reference,
   records: external_exports.array(record2)
 });
-var browserHistoryV6 = external_exports.strictObject({
+var browserHistoryV7 = external_exports.strictObject({
   contract: external_exports.literal("browser-history"),
-  version: external_exports.literal(6),
+  version: external_exports.literal(7),
   sessionId: external_exports.string(),
   head: oid2,
   // Matching changes and the commits that hold them in all of history, not in this page.
   total: external_exports.number().int().nonnegative(),
   commits: external_exports.number().int().nonnegative(),
   next: oid2.nullable(),
-  events: external_exports.array(event)
+  events: external_exports.array(event),
+  // Every document and those no record explains, and each record with how many documents it explains, in commit order.
+  whole: external_exports.array(external_exports.strictObject({
+    commit: oid2,
+    documents: external_exports.number().int().nonnegative(),
+    unrecorded: external_exports.number().int().nonnegative(),
+    records: external_exports.array(external_exports.strictObject({ id: external_exports.string(), documents: external_exports.number().int().positive() }))
+  })),
+  // The kinds of document the history holds at all, so the filter offers a kind only when it can find something.
+  kinds: external_exports.array(kind)
 });
 var browserHistorySummaryV5 = external_exports.strictObject({
   contract: external_exports.literal("browser-history-summary"),
@@ -25243,13 +25288,14 @@ var browserSearchV3 = external_exports.strictObject({
 });
 var headQuery = oid2;
 var count = (max) => external_exports.string().regex(/^(0|[1-9]\d{0,6})$/).transform(Number).pipe(external_exports.number().int().min(0).max(max));
-var browserHistoryQueryV4 = external_exports.strictObject({
+var browserHistoryQueryV5 = external_exports.strictObject({
   head: headQuery,
   after: oid2.optional(),
   limit: count(50).pipe(external_exports.number().min(1)).optional(),
-  kind: changeType.optional(),
+  // A feature or an instruction; `record=missing` keeps the changes no record explains.
+  target: external_exports.string().regex(/^[SI]-[a-z2-7]{10}$/).optional(),
   document: kind.optional(),
-  feature: external_exports.string().regex(/^S-[a-z2-7]{10}$/).optional(),
+  record: external_exports.literal("missing").optional(),
   author: external_exports.string().min(1).max(320).optional(),
   q: external_exports.string().max(200).optional()
 });
@@ -25345,6 +25391,24 @@ var browserRecordV2 = external_exports.strictObject({
   others: external_exports.number().int().nonnegative()
 });
 var browserRecordQueryV1 = external_exports.strictObject({ head: oid2, id: recordId });
+var browserDocumentHistoryV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-document-history"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  head: oid2,
+  doc: external_exports.strictObject({ id: external_exports.string(), title: external_exports.string().nullable(), kind: kind.nullable(), path: external_exports.string().nullable() }),
+  total: external_exports.number().int().nonnegative(),
+  recorded: external_exports.number().int().nonnegative(),
+  withoutRecord: external_exports.number().int().nonnegative(),
+  next: oid2.nullable(),
+  events: external_exports.array(event)
+});
+var browserDocumentHistoryQueryV1 = external_exports.strictObject({
+  head: oid2,
+  id: external_exports.string().regex(/^[SRDWI]-[a-z2-7]{10}$/),
+  after: oid2.optional(),
+  limit: count(50).pipe(external_exports.number().min(1)).optional()
+});
 var browserInstructionFileV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-instruction-file"),
   version: external_exports.literal(1),
@@ -25635,6 +25699,7 @@ var messages_default3 = {
   "server.cursorNotFound": "\uC774\uC5B4 \uC77D\uC744 \uC704\uCE58\uB97C \uBAA9\uB85D\uC5D0\uC11C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uCC98\uC74C\uBD80\uD130 \uB2E4\uC2DC \uBD88\uB7EC\uC624\uC138\uC694.",
   "server.workingChangeNotFound": "\uCEE4\uBC0B \uC804 \uBCC0\uACBD\uC5D0 \uADF8 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.recordNotFound": "\uC774 \uC774\uB825\uC5D0 \uADF8 \uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "server.documentNotFound": "\uC774 \uC774\uB825\uACFC \uC791\uC5C5 \uD3F4\uB354\uC5D0 \uADF8 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.commitFileNotFound": "\uADF8 \uCEE4\uBC0B\uC774 \uBC14\uAFBC \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4.",
   "server.instructionFileNotFound": "\uC9C0\uCE68 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.specsUnreadable": "\uBA85\uC138\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
@@ -25769,7 +25834,7 @@ var messages_default3 = {
   "docs.pathExample.design": "payment/api (.gitifact/spec/payment/design/api.md)",
   "docs.pathExample.instruction": "cli-architecture (.gitifact/instructions/cli-architecture/index.md)",
   "docs.skeleton.feature": "(\uC774 \uAE30\uB2A5\uC774 \uBB34\uC5C7\uC774\uACE0 \uC5B4\uB514\uAE4C\uC9C0\uC778\uC9C0)",
-  "docs.skeleton.requirement": "(\uC0AC\uC6A9\uC790)\uB85C\uC11C, (\uBAA9\uC801)\uC744 \uC704\uD574 (\uB3D9\uC791)\uC744 \uD558\uACE0 \uC2F6\uB2E4.\n\n### \uC218\uC6A9 \uC870\uAC74\n\n1. \uC870\uAC74: (\uC0C1\uD669)\n   \uAE30\uB300 \uB3D9\uC791: (\uACB0\uACFC)",
+  "docs.skeleton.requirement": "(\uC0AC\uC6A9\uC790)\uB85C\uC11C, (\uBAA9\uC801)\uC744 \uC704\uD574 (\uB3D9\uC791)\uC744 \uD558\uACE0 \uC2F6\uB2E4.\n\n### \uBC94\uC704\uC640 \uC81C\uC57D\n\n- (\uCC38\xB7\uAC70\uC9D3\uC744 \uAC00\uB9B4 \uC218 \uC788\uB294 \uADDC\uCE59 \uD55C \uBB38\uC7A5. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uC218\uC6A9 \uC870\uAC74\n\n1. \uC870\uAC74: (\uC0C1\uD669)\n   \uAE30\uB300 \uB3D9\uC791: (\uACB0\uACFC)",
   "docs.skeleton.design": "(\uC774 \uC124\uACC4\uAC00 \uB2E4\uB8E8\uB294 \uAD6C\uC870\uC640 \uCC98\uB9AC \uBC29\uC2DD)",
   "docs.skeleton.instruction": "(\uC774 \uC791\uC5C5\uC744 \uD560 \uB54C \uC9C0\uD0AC \uADDC\uCE59\uACFC \uC808\uCC28. \uC790\uC138\uD55C \uB0B4\uC6A9\uC740 references/ \uC544\uB798 \uD30C\uC77C\uB85C \uB098\uB204\uACE0 \uC5EC\uAE30\uC11C \uB9C1\uD06C\uD55C\uB2E4)",
   "docs.exists": "\uC774\uBBF8 \uC788\uB294 \uD30C\uC77C\uC785\uB2C8\uB2E4: {path}",
@@ -25794,6 +25859,7 @@ var messages_default3 = {
   "docs.singleLine": "{field}\uC740 \uD55C \uC904\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
   "changes.problems": "\uBB38\uC11C \uAC80\uC0AC: \uBB38\uC81C {count}\uAC1C (check\uB85C \uD655\uC778)",
   "changes.warnings": "\uBB38\uC11C \uACBD\uACE0: {count}\uAC1C (check\uB85C \uD655\uC778, \uCEE4\uBC0B\uC740 \uB9C9\uC9C0 \uC54A\uC74C)",
+  "changes.formatWarnings": "\uD615\uC2DD \uACBD\uACE0 {count}\uAC1C (\uC774\uBC88\uC5D0 \uBC14\uB010 \uC694\uAD6C\uC0AC\uD56D, \uCEE4\uBC0B\uC740 \uB9C9\uC9C0 \uC54A\uC74C)",
   "changes.clean": "\uBB38\uC11C \uAC80\uC0AC: \uBB38\uC81C \uC5C6\uC74C",
   "changes.pendingRecords": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC740 \uACB0\uC815\uAE30\uB85D {count}\uAC1C (*\uB294 \uC774\uBC88\uC5D0 \uBC14\uB00C\uC9C0 \uC54A\uC740 \uBB38\uC11C)",
   "changes.withoutRecord": "\uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uB294 \uC218\uC815\xB7\uC774\uB3D9\xB7\uC0AD\uC81C: {ids}",
@@ -25949,6 +26015,7 @@ var messages_default4 = {
   "server.cursorNotFound": "The place to read on from is no longer in the list. Load it again from the start.",
   "server.workingChangeNotFound": "No uncommitted change of that document.",
   "server.recordNotFound": "This history has no such decision record.",
+  "server.documentNotFound": "Neither this history nor the working tree has that document.",
   "server.commitFileNotFound": "That commit did not change this file.",
   "server.instructionFileNotFound": "The instruction file was not found.",
   "server.specsUnreadable": "Could not read specifications.",
@@ -26083,7 +26150,7 @@ var messages_default4 = {
   "docs.pathExample.design": "payment/api (.gitifact/spec/payment/design/api.md)",
   "docs.pathExample.instruction": "cli-architecture (.gitifact/instructions/cli-architecture/index.md)",
   "docs.skeleton.feature": "(What this feature is and where it ends)",
-  "docs.skeleton.requirement": "As (a user), I want to (act) so that (purpose).\n\n### Acceptance criteria\n\n1. Condition: (situation)\n   Expected: (result)",
+  "docs.skeleton.requirement": "As (a user), I want to (act) so that (purpose).\n\n### Scope and constraints\n\n- (One rule that is either true or false. Remove this section if there is none)\n\n### Acceptance criteria\n\n1. Condition: (situation)\n   Expected: (result)",
   "docs.skeleton.design": "(The structure and processing this design covers)",
   "docs.skeleton.instruction": "(Rules and steps to follow for this kind of work. Put details in files under references/ and link them from here)",
   "docs.exists": "The file already exists: {path}",
@@ -26108,6 +26175,7 @@ var messages_default4 = {
   "docs.singleLine": "The {field} must be a single line.",
   "changes.problems": "Document check: {count} problems (see check)",
   "changes.warnings": "Document warnings: {count} (see check; they do not block a commit)",
+  "changes.formatWarnings": "Format warnings: {count} (requirements changed here; they do not block a commit)",
   "changes.clean": "Document check: no problems",
   "changes.pendingRecords": "{count} uncommitted record(s) (* marks a document this change does not touch)",
   "changes.withoutRecord": "Changed, moved or deleted without a record: {ids}",
@@ -26711,6 +26779,10 @@ function snippet(text4, query) {
   return (from > 0 ? "\u2026" : "") + text4.slice(from, at + query.length + 70).trim() + (at + query.length + 70 < text4.length ? "\u2026" : "");
 }
 var containing = (query) => "%" + query.replace(/[\\%_]/g, (c) => "\\" + c) + "%";
+function hashPrefix(query) {
+  const wanted = query?.trim().toLowerCase();
+  return wanted && /^[0-9a-f]{7,64}$/.test(wanted) ? wanted : void 0;
+}
 
 // src/adapters/cache/documents.ts
 var FILE_LIMIT = 1024 * 1024;
@@ -27103,10 +27175,10 @@ function createCommitChanges(git) {
       }
     };
     for (const chunk of patch.split("").filter(Boolean)) {
-      const lines = chunk.split("\n");
-      const commit = lines[0].trim();
-      const removed = new Set(lines.filter((l) => l.startsWith("-") && !l.startsWith("---")).flatMap((l) => read(l.slice(1))).map((r) => r.id));
-      found.set(commit, lines.filter((l) => l.startsWith("+") && !l.startsWith("+++")).flatMap((l) => read(l.slice(1))).filter((r) => !removed.has(r.id)).map((r) => reasonRecord(r.id, r.docs, r.reason)));
+      const lines2 = chunk.split("\n");
+      const commit = lines2[0].trim();
+      const removed = new Set(lines2.filter((l) => l.startsWith("-") && !l.startsWith("---")).flatMap((l) => read(l.slice(1))).map((r) => r.id));
+      found.set(commit, lines2.filter((l) => l.startsWith("+") && !l.startsWith("+++")).flatMap((l) => read(l.slice(1))).filter((r) => !removed.has(r.id)).map((r) => reasonRecord(r.id, r.docs, r.reason)));
     }
     return found;
   }
@@ -27415,25 +27487,30 @@ function createHistory(database, git, originals) {
   function where(filter) {
     const clauses = [];
     const params = [];
-    if (filter.kind) {
-      clauses.push("instr(',' || c.types || ',', ?) > 0");
-      params.push("," + filter.kind + ",");
+    if (filter.target?.startsWith("I-")) {
+      clauses.push("c.id = ?");
+      params.push(filter.target);
+    } else if (filter.target) {
+      clauses.push("(c.before_spec = ? OR c.after_spec = ?)");
+      params.push(filter.target, filter.target);
     }
     if (filter.document) {
       clauses.push("c.kind = ?");
       params.push(filter.document);
     }
-    if (filter.feature) {
-      clauses.push("(c.before_spec = ? OR c.after_spec = ?)");
-      params.push(filter.feature, filter.feature);
-    }
+    if (filter.unrecorded) clauses.push("json_array_length(c.row, '$.records') = 0");
     if (filter.author) {
       clauses.push("c.email = ?");
       params.push(filter.author);
     }
-    if (filter.q?.trim()) {
-      clauses.push("instr(c.needle, ?) > 0");
-      params.push(filter.q.trim().toLowerCase());
+    const q = filter.q?.trim().toLowerCase();
+    if (q) {
+      const record4 = `EXISTS (SELECT 1 FROM json_each(c.row, '$.records') j JOIN records r ON r.oid = c.oid AND r.id = j.value
+        WHERE instr(lower(r.title), ?) > 0 OR instr(lower(r.id), ?) > 0
+          OR instr(lower((SELECT group_concat(json_extract(s.value, '$.body'), ' ') FROM json_each(r.sections) s)), ?) > 0)`;
+      const hash3 = hashPrefix(q) ? " OR substr(c.oid, 1, length(?)) = ?" : "";
+      clauses.push(`(instr(c.needle, ?) > 0 OR ${record4}${hash3})`);
+      params.push(q, q, q, q, ...hash3 ? [q, q] : []);
     }
     return { sql: clauses.map((c) => " AND " + c).join(""), params };
   }
@@ -27461,11 +27538,28 @@ function createHistory(database, git, originals) {
         const commits = db.prepare(`SELECT l.pos AS pos, l.oid AS oid ${from} AND l.pos > ? GROUP BY l.pos, l.oid ORDER BY l.pos LIMIT ?`).all(head, ...params, start, limit + 1);
         const shown = commits.slice(0, limit);
         const rows = !shown.length ? [] : db.prepare(`SELECT c.row ${from} AND l.pos >= ? AND l.pos <= ? ORDER BY l.pos, c.ord`).all(head, ...params, shown[0].pos, shown[shown.length - 1].pos);
+        const oids = JSON.stringify(shown.map((c) => c.oid));
+        const sizes = db.prepare(`SELECT oid, count(*) AS documents, sum(json_array_length(row, '$.records') = 0) AS unrecorded
+          FROM changes WHERE oid IN (SELECT value FROM json_each(?)) GROUP BY oid`).all(oids);
+        const explained = db.prepare(`SELECT c.oid AS oid, j.value AS id, count(*) AS documents FROM changes c, json_each(c.row, '$.records') j
+          WHERE c.oid IN (SELECT value FROM json_each(?)) GROUP BY c.oid, j.value ORDER BY c.oid, min(c.ord)`).all(oids);
+        const whole = shown.map(({ oid: oid3 }) => {
+          const size = sizes.find((s) => s.oid === oid3);
+          return {
+            commit: oid3,
+            documents: Number(size?.documents ?? 0),
+            unrecorded: Number(size?.unrecorded ?? 0),
+            records: explained.filter((r) => r.oid === oid3).map((r) => ({ id: r.id, documents: Number(r.documents) }))
+          };
+        });
+        const kinds = db.prepare("SELECT DISTINCT c.kind AS kind FROM lineage l JOIN changes c ON c.oid = l.oid WHERE l.head = ?").all(head).map((k) => k.kind);
         return {
           total: Number(counted.n),
           commits: Number(counted.commits),
           next: commits.length > limit ? shown[shown.length - 1].oid : null,
-          events: hydrate(db, rows.map((r) => r.row))
+          events: hydrate(db, rows.map((r) => r.row)),
+          whole,
+          kinds
         };
       });
     },
@@ -27515,9 +27609,11 @@ function createHistory(database, git, originals) {
           clauses.push("(lower(json_extract(row, '$.author')) = ? OR lower(json_extract(row, '$.email')) = ?)");
           params.push(filter.author.toLowerCase(), filter.author.toLowerCase());
         }
-        if (filter.q?.trim()) {
-          clauses.push("instr(lower(title || ' ' || body || ' ' || json_extract(row, '$.message')), ?) > 0");
-          params.push(filter.q.trim().toLowerCase());
+        const q = filter.q?.trim().toLowerCase();
+        const hash3 = hashPrefix(q);
+        if (q) {
+          clauses.push(`(instr(lower(title || ' ' || id || ' ' || coalesce(body, '')), ?) > 0${hash3 ? " OR substr(oid, 1, length(?)) = ?" : ""})`);
+          params.push(q, ...hash3 ? [hash3, hash3] : []);
         }
         if (filter.from !== void 0) {
           clauses.push("unixepoch(json_extract(row, '$.date')) * 1000 >= ?");
@@ -27725,8 +27821,8 @@ function createCommitLog(database, git, root) {
      * prints it. Anything shorter or not a hash names none. Newest first, a page after the commit `after`.
      */
     async commitsNamed(head, raw, after, limit) {
-      const prefix = raw.trim().toLowerCase();
-      if (!/^[0-9a-f]{7,64}$/.test(prefix)) return { total: 0, next: null, hits: [] };
+      const prefix = hashPrefix(raw);
+      if (!prefix) return { total: 0, next: null, hits: [] };
       await ensure(head);
       return database.with((db) => {
         const rows = db.prepare("SELECT oid, name, date, subject FROM log WHERE reach = 1 AND substr(oid, 1, length(?)) = ? ORDER BY time DESC, oid").all(prefix, prefix);
@@ -28077,6 +28173,8 @@ function createStampReader(root, inherited = process.env) {
       const info5 = await lstat8(join9(root, ...path3.split("/"))).catch(() => void 0);
       return path3 + "	" + (info5 ? info5.mtimeMs + ":" + info5.size : "-");
     }));
+    const mailmap = await lstat8(join9(root, ".mailmap")).catch(() => void 0);
+    seen.push(".mailmap	" + (mailmap ? mailmap.mtimeMs + ":" + mailmap.size : "-"));
     return createHash2("sha256").update(head.trim() + "\n" + seen.sort().join("\n")).digest("hex").slice(0, 20);
   };
 }
@@ -28152,23 +28250,23 @@ function createCheckoutReader(root, cache, inherited = process.env) {
     return head || null;
   };
   const pending = /* @__PURE__ */ new Map();
+  const last = /* @__PURE__ */ new Map();
   const readStamp = createStampReader(root, inherited);
-  async function read() {
+  async function read(stamp) {
     const raw = await readConfigFile(root);
     if (!raw) throw new StoreError(t2("specReader.schemaRequired"));
     parseManagedConfig(raw);
     const head = await readHead();
-    const stamp = await readStamp();
-    const [current2, dirty, authors, people] = await settled([
+    const [current3, dirty, authors, people] = await settled([
       cache.documents.list(),
       head ? git(["status", "--porcelain=v1", "--", ".gitifact/spec", INSTRUCTIONS_ROOT]) : Promise.resolve(""),
       // Who touched each folder and who committed at all, counted over the commit log in the cache.
       head ? cache.log.folders(head) : Promise.resolve(/* @__PURE__ */ new Map()),
       head ? cache.log.contributors(head) : Promise.resolve([])
     ]);
-    const states = await documentStates({ head: async () => head, reader }, current2.documents);
+    const states = await documentStates({ head: async () => head, reader }, current3.documents);
     const { features, instructions: instructions2, orphans } = checkoutDocuments(states, authors);
-    const problems = [...current2.problems, ...orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
+    const problems = [...current3.problems, ...orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
     if (await readHead() !== head) throw new StoreError(t2("specReader.projectChanged"));
     return {
       head,
@@ -28182,11 +28280,19 @@ function createCheckoutReader(root, cache, inherited = process.env) {
       folders: authors
     };
   }
+  async function current2(language) {
+    const stamp = await readStamp();
+    const known = last.get(language);
+    if (known?.stamp === stamp) return { ...known, observedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    const fresh = await read(stamp);
+    last.set(language, fresh);
+    return fresh;
+  }
   const base = () => {
     const language = getLanguage();
     let value = pending.get(language);
     if (!value) {
-      value = read().finally(() => pending.delete(language));
+      value = current2(language).finally(() => pending.delete(language));
       pending.set(language, value);
     }
     return value;
@@ -28240,15 +28346,15 @@ function createCommitFiles(git) {
     const revs = parent ? [parent, commit] : [commit];
     const names = (await text4([...base, "--name-status", ...revs, "--"])).split("\0");
     const counts = (await text4([...base, "--numstat", ...revs, "--"])).split("\0");
-    const lines = /* @__PURE__ */ new Map();
+    const lines2 = /* @__PURE__ */ new Map();
     for (let i = 0; i < counts.length; i++) {
       const [added, deleted, path3] = counts[i].split("	");
       if (added === void 0 || deleted === void 0) continue;
       const count2 = { additions: added === "-" ? null : Number(added), deletions: deleted === "-" ? null : Number(deleted) };
       if (path3 === "") {
-        lines.set(counts[i + 2], count2);
+        lines2.set(counts[i + 2], count2);
         i += 2;
-      } else if (path3 !== void 0) lines.set(path3, count2);
+      } else if (path3 !== void 0) lines2.set(path3, count2);
     }
     const files = [];
     for (let i = 0; i < names.length - 1; i++) {
@@ -28258,7 +28364,7 @@ function createCommitFiles(git) {
       const previousPath = renamed ? names[++i] : void 0;
       const path3 = names[++i];
       if (!isSource(path3) && (!previousPath || !isSource(previousPath))) continue;
-      files.push({ path: path3, ...renamed && code.startsWith("R") ? { previousPath } : {}, status: statusOf(code), ...lines.get(path3) ?? { additions: null, deletions: null } });
+      files.push({ path: path3, ...renamed && code.startsWith("R") ? { previousPath } : {}, status: statusOf(code), ...lines2.get(path3) ?? { additions: null, deletions: null } });
     }
     return { commit, parent, total: files.length, files };
   }
@@ -28400,6 +28506,25 @@ async function recent(source2, head) {
   return { group: "recent", total: hits.length, next: null, hits };
 }
 
+// src/queries/document-history.ts
+async function documentHistory(source2, head, id) {
+  const events = head ? await source2.cache.history.ofDocument(head, id) : [];
+  const current2 = (await source2.cache.documents.list()).documents.find((d) => d.id === id);
+  const last = events.map((e) => e.after ?? e.before).find(Boolean);
+  if (!current2 && !events.length) return void 0;
+  const doc = { id, title: current2?.title ?? last?.title ?? null, kind: current2?.kind ?? events[0]?.kind ?? null, path: current2?.path ?? last?.path ?? null };
+  return { doc, events };
+}
+async function documentHistoryPage(source2, head, id, request) {
+  const found = await documentHistory(source2, head, id);
+  if (!found) return void 0;
+  const page = pageOf(found.events, (e) => e.commit, request);
+  if (!page) return null;
+  const recorded = found.events.filter((e) => e.records.length).length;
+  const withoutRecord = found.events.filter((e) => !e.records.length && e.types.some((type) => type !== "created")).length;
+  return { doc: found.doc, total: page.total, recorded, withoutRecord, next: page.next, events: page.rows };
+}
+
 // src/queries/checkout.ts
 var SHOWN_REQUIREMENTS = 12;
 function checkoutIndex(base) {
@@ -28416,13 +28541,13 @@ function checkoutIndex(base) {
     people: base.people.map((p) => ({ name: p.name, email: p.email }))
   };
 }
-var acceptanceHeading = /^###\s+(?:수용 조건|acceptance criteria)\s*$/i;
+var acceptanceHeading2 = /^###\s+(?:수용 조건|acceptance criteria)\s*$/i;
 function acceptanceCount(body2) {
-  const lines = body2.replace(/\r\n/g, "\n").split("\n");
-  const start = lines.findIndex((line2) => acceptanceHeading.test(line2.trim()));
+  const lines2 = body2.replace(/\r\n/g, "\n").split("\n");
+  const start = lines2.findIndex((line2) => acceptanceHeading2.test(line2.trim()));
   if (start < 0) return null;
   let count2 = 0;
-  for (const line2 of lines.slice(start + 1)) {
+  for (const line2 of lines2.slice(start + 1)) {
     if (/^#{1,6}\s/.test(line2)) break;
     if (/^\d+\.\s/.test(line2)) count2++;
   }
@@ -28544,10 +28669,16 @@ function recordRoutes(root, sessionId, env) {
     } }),
     // Whether the screen is behind, asked when the reader comes back to the tab; cheap enough to ask every time.
     route({ method: "GET", path: "/api/v1/stamp", session: true, unreadable: unreadable2, handle: async () => ok(browserStampV1.parse({ contract: "browser-stamp", version: 1, sessionId, stamp: await readStamp() })) }),
-    route({ method: "GET", path: "/api/v1/history", session: true, query: browserHistoryQueryV4, unreadable: unreadable2, handle: async ({ query }) => {
-      const page = await cache.history.commits(query.head, { kind: query.kind, document: query.document, feature: query.feature, author: query.author, q: query.q }, query.after, query.limit ?? PAGE);
+    route({ method: "GET", path: "/api/v1/history", session: true, query: browserHistoryQueryV5, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = await cache.history.commits(query.head, {
+        target: query.target,
+        document: query.document,
+        unrecorded: query.record === "missing",
+        author: query.author,
+        q: query.q
+      }, query.after, query.limit ?? PAGE);
       if (!page) throw cursorGone2();
-      return ok(browserHistoryV6.parse({ contract: "browser-history", version: 6, sessionId, head: query.head, ...page }));
+      return ok(browserHistoryV7.parse({ contract: "browser-history", version: 7, sessionId, head: query.head, ...page }));
     } }),
     route({ method: "GET", path: "/api/v1/history/summary", session: true, query: browserHistorySummaryQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserHistorySummaryV5.parse({
       contract: "browser-history-summary",
@@ -28592,6 +28723,13 @@ function recordRoutes(root, sessionId, env) {
       if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.recordNotFound"));
       return ok(browserRecordV2.parse({ contract: "browser-record", version: 2, sessionId, head: query.head, id: query.id, ...found }));
     } }),
+    // One document's decision flow in the HEAD the reader is on: the commits that changed it, a page of them at a time.
+    route({ method: "GET", path: "/api/v1/document-history", session: true, query: browserDocumentHistoryQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const found = await documentHistoryPage(source2, query.head, query.id, { after: query.after, limit: query.limit ?? PAGE });
+      if (found === void 0) throw new HttpError(404, "NOT_FOUND", t2("server.documentNotFound"));
+      if (found === null) throw cursorGone2();
+      return ok(browserDocumentHistoryV1.parse({ contract: "browser-document-history", version: 1, sessionId, head: query.head, ...found }));
+    } }),
     // What is not committed yet, worked out again on every request: the uncommitted entry of the records list.
     route({ method: "GET", path: "/api/v1/working", session: true, unreadable: unreadable2, handle: async () => ok(browserWorkingV1.parse({ contract: "browser-working", version: 1, sessionId, ...await workingOverview(working2) })) }),
     route({ method: "GET", path: "/api/v1/working/change", session: true, query: browserWorkingChangeQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
@@ -28973,11 +29111,11 @@ import { readFile as readFile11 } from "node:fs/promises";
 // src/commands/output.ts
 var formats = ["text", "json"];
 var CommandError = class extends Error {
-  constructor(code, message, details = {}, lines = []) {
+  constructor(code, message, details = {}, lines2 = []) {
     super(message);
     this.code = code;
     this.details = details;
-    this.lines = lines;
+    this.lines = lines2;
   }
   code;
   details;
@@ -28994,13 +29132,13 @@ async function runCommand(contract, format2, run) {
     const code = known ? error62.code : contract.toUpperCase() + "_FAILED";
     const message = known ? error62.message : t2("command.failed");
     const details = error62 instanceof CommandError ? error62.details : {};
-    const lines = error62 instanceof CommandError ? error62.lines : [];
-    process.stderr.write(format2 === "json" ? JSON.stringify({ ...envelope, ok: false, error: { code, message, ...details } }) + "\n" : [code + ": " + message, ...lines].join("\n") + "\n");
+    const lines2 = error62 instanceof CommandError ? error62.lines : [];
+    process.stderr.write(format2 === "json" ? JSON.stringify({ ...envelope, ok: false, error: { code, message, ...details } }) + "\n" : [code + ": " + message, ...lines2].join("\n") + "\n");
     process.exitCode = 1;
   }
 }
-var section = (label, lines, indent = "  ") => lines.length ? [label, ...lines.map((line2) => indent + line2)] : [];
-var text2 = (lines) => lines.join("\n") + "\n";
+var section = (label, lines2, indent = "  ") => lines2.length ? [label, ...lines2.map((line2) => indent + line2)] : [];
+var text2 = (lines2) => lines2.join("\n") + "\n";
 
 // src/commands/guide.ts
 var guideTopics = ["workflow", "spec", "design", "instructions", "records", "writing", "commit", "migrate"];
@@ -29071,8 +29209,8 @@ function findBlock(text4) {
 function isWrapperFile(text4) {
   const found = findBlock(text4);
   const own2 = found ? text4.slice(0, found.start) + text4.slice(found.end) : text4;
-  const lines = own2.split(/\r?\n/).map((line2) => line2.trim()).filter(Boolean);
-  return lines.length > 0 && lines.every((line2) => /^@(?:\.\/)?[^\s]+$/.test(line2) && candidatePaths.includes(line2.replace(/^@(?:\.\/)?/, "")));
+  const lines2 = own2.split(/\r?\n/).map((line2) => line2.trim()).filter(Boolean);
+  return lines2.length > 0 && lines2.every((line2) => /^@(?:\.\/)?[^\s]+$/.test(line2) && candidatePaths.includes(line2.replace(/^@(?:\.\/)?/, "")));
 }
 var CLAUDE_WRAPPER_PATH = "CLAUDE.md";
 function claudeWrapperFor(agents2) {
@@ -29732,8 +29870,8 @@ function cursorGone(options) {
   throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after ?? "" }));
 }
 var pageLine = (page, before = 0, unit = t2("list.items")) => page.next === null ? [] : [t2("list.more", { shown: before + page.rows.length, total: page.total, unit, cursor: page.next })];
-function aside(format2, lines) {
-  if (format2 === "text" && lines.length) process.stderr.write(lines.join("\n") + "\n");
+function aside(format2, lines2) {
+  if (format2 === "text" && lines2.length) process.stderr.write(lines2.join("\n") + "\n");
   return "";
 }
 
@@ -30136,6 +30274,10 @@ var recordLine = (r, changes2) => {
   const changed = new Set(changes2.map((c) => c.id));
   return `${r.id} ${r.title}${r.draft ? " (" + t2("docs.draft") + ")" : ""} \u2014 ${r.docs.map((d) => changed.has(d) ? d : d + "*").join(", ")}`;
 };
+var formatWarnings = (changes2, documents) => {
+  const touched = new Set(changes2.map((c) => c.id));
+  return documents.filter((d) => touched.has(d.id)).flatMap(requirementFormatWarnings);
+};
 var recordSummary = (r) => ({ id: r.id, title: r.title, docs: r.docs, path: r.path, ...r.draft ? { draft: true } : {} });
 var runChangesList = (options, controls = {}) => runCommand("changes", options.format, async () => {
   const project = await openProject(process.cwd());
@@ -30146,7 +30288,8 @@ var runChangesList = (options, controls = {}) => runCommand("changes", options.f
   const withoutRecord = uncovered(changes2, records2);
   const sharedDocuments = shared(changes2, records2);
   const problems = [...working2.problems, ...pending.problems, ...checked.problems];
-  const warnings = await readDocumentWarnings(project.root, checked.documents);
+  const formats2 = formatWarnings(changes2, checked.documents);
+  const warnings = [...await readDocumentWarnings(project.root, checked.documents), ...formats2];
   const inputs = await prepareAgentInputs(project.root, controls).catch(() => void 0);
   const out = changes2.length ? [t2("changes.changed", { count: changes2.length }), ...changes2.map((c) => "  " + changeLine(c))] : [t2("changes.none")];
   out.push(...section(t2("changes.pendingRecords", { count: records2.length }), records2.map((r) => recordLine(r, changes2))));
@@ -30154,7 +30297,8 @@ var runChangesList = (options, controls = {}) => runCommand("changes", options.f
   if (sharedDocuments.length) out.push(t2("changes.sharedDocuments", { ids: sharedDocuments.join(", ") }));
   if (pending.altered.length) out.push(t2("changes.recordAltered", { paths: pending.altered.join(", ") }));
   out.push(problems.length ? t2("changes.problems", { count: problems.length }) : t2("changes.clean"));
-  if (warnings.length) out.push(t2("changes.warnings", { count: warnings.length }));
+  if (warnings.length > formats2.length) out.push(t2("changes.warnings", { count: warnings.length - formats2.length }));
+  out.push(...section(t2("changes.formatWarnings", { count: formats2.length }), formats2.map((w) => w.code + " " + w.message)));
   if (inputs) out.push(t2("changes.input", { path: inputs.commit }));
   return { json: { head, changes: changes2, pendingRecords: records2.map(recordSummary), withoutRecord, sharedDocuments, alteredRecords: pending.altered, problems, warnings, inputs: inputs ?? null }, text: text2(out) };
 });
@@ -30169,6 +30313,7 @@ var runChangesCommit = (options, controls = {}) => runCommand("changes", options
     ...result.changes.map((c) => "  " + changeLine(c)),
     ...result.records.map((r) => "  " + r.id + " " + r.title),
     ...result.withoutRecord.length ? [t2("changes.withoutRecord", { ids: result.withoutRecord.join(", ") })] : [],
+    ...section(t2("changes.formatWarnings", { count: result.warnings.length }), result.warnings.map((w) => w.code + " " + w.message)),
     ...result.trailers
   ];
   return { json: { ...json3, ...inputRemoved === void 0 ? {} : { inputRemoved } }, text: text2(out) };
@@ -30225,6 +30370,7 @@ async function commitChanges(cwd, input2, dryRun) {
   const split = changes2.filter((c) => c.previousPath !== void 0 && !(selected2.includes(c.path) && selected2.includes(c.previousPath)));
   if (split.length) fail3(t2("commit.selectMove", { ids: split.map((c) => c.id).join(", ") }));
   const withoutRecord = uncovered(changes2, records2);
+  const warnings = formatWarnings(changes2, checked.documents);
   const status = (await git(["status", "--porcelain=v1", "-z", "--untracked-files=all", "--no-renames", "--", ".gitifact"])).toString("utf8").split("\0").filter(Boolean);
   const removed = new Set(status.filter((entry2) => entry2.slice(0, 2).includes("D")).map((entry2) => entry2.slice(3)));
   checkStoreSelection(selected2.filter((p) => !(underDocuments(p) && removed.has(p))));
@@ -30241,7 +30387,7 @@ async function commitChanges(cwd, input2, dryRun) {
   const contextPaths = policyPaths(selected2);
   const hashes = async (list) => new Map(await Promise.all(list.map(async (p) => [p, await fingerprint(root, p)])));
   const started = await hashes([.../* @__PURE__ */ new Set([...selected2, ...contextPaths])]);
-  const summary = { root, head: base.head, message, paths: selected2, changes: changes2, records: records2.map(recordSummary), withoutRecord, trailers };
+  const summary = { root, head: base.head, message, paths: selected2, changes: changes2, records: records2.map(recordSummary), withoutRecord, warnings, trailers };
   if (dryRun) {
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     return { outcome: "dry-run", committed: false, ...summary, commit: void 0 };
@@ -30406,12 +30552,13 @@ var runRecordsList = (options) => runCommand("records", options.format, async ()
     const after = await since(project, options.since, head);
     const by = byAuthor(options.author);
     const has2 = contains(options.q);
+    const hash3 = hashPrefix(options.q);
     const id = options.doc;
-    const events = head ? await project.cache.history.ofDocument(head, id) : [];
-    const { documents } = await project.cache.documents.list();
-    const title = documents.find((d) => d.id === id)?.title ?? events.map((e) => (e.after ?? e.before)?.title).find(Boolean) ?? null;
-    if (!title && !events.length) throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.unknownDocument", { ids: id }));
-    const page = paginate(events.filter((e) => after(e) && by(e) && has2(e.message, ...e.records.flatMap((r) => [r.title, ...sectionText(r.sections)]))).map((e) => ({
+    const found2 = await documentHistory(project, head, id);
+    if (!found2) throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.unknownDocument", { ids: id }));
+    const { events } = found2;
+    const title = found2.doc.title;
+    const page = paginate(events.filter((e) => after(e) && by(e) && (has2(...e.records.flatMap((r) => [r.title, r.id, ...sectionText(r.sections)])) || !!hash3 && e.commit.startsWith(hash3))).map((e) => ({
       commit: e.commit,
       date: e.date,
       author: e.author,
@@ -30449,7 +30596,7 @@ var runRecordsList = (options) => runCommand("records", options.format, async ()
     } catch {
       return [];
     }
-  }).map((r) => ({ id: r.id, title: r.title, commit: null, date: null, author: null, docs: r.docs, sections: r.sections.map((s) => ({ key: s.key, body: s.body })) }))).filter((r) => has(r.title, ...sectionText(r.sections))).sort((a, b) => a.id < b.id ? -1 : 1);
+  }).map((r) => ({ id: r.id, title: r.title, commit: null, date: null, author: null, docs: r.docs, sections: r.sections.map((s) => ({ key: s.key, body: s.body })) }))).filter((r) => has(r.title, r.id, ...sectionText(r.sections))).sort((a, b) => a.id < b.id ? -1 : 1);
   const size = options.all ? void 0 : options.limit ?? PAGE_SIZE;
   const inPending = options.after === void 0 ? 0 : pending.findIndex((r) => r.id === options.after) + 1;
   const afterCommitted = options.after !== void 0 && !inPending ? options.after : void 0;
@@ -30759,23 +30906,23 @@ async function runUpdate(options, version2) {
       process.stdout.write(JSON.stringify(dto) + "\n");
       return;
     }
-    const lines = [t2("update.text.current", { version: dto.cliVersion })];
-    lines.push(dto.update.status === "available" ? t2("update.text.available", { version: dto.update.latestVersion }) : dto.update.status === "up-to-date" ? t2("update.text.upToDate") : dto.update.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable"));
-    if (dto.install) lines.push(t2("update.text.install", { command: dto.install.npmGlobal }), t2("update.text.afterInstall"));
-    lines.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "kept" ? t2("update.text.blockKept", { paths: dto.agentDocs.paths.join(", ") || "-" }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock") : t2("update.text.notInitialized"));
-    if (dto.agentDocs.missing.length) lines.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", ") }));
-    if (dto.project.state === "written") lines.push(t2("update.text.projectWritten", { path: CONFIG_PATH, version: dto.project.cli ?? dto.cliVersion }));
-    if (dto.project.cli && isNewerRelease(dto.project.cli, dto.cliVersion)) lines.push(t2("update.text.projectAhead", { project: dto.project.cli, version: dto.cliVersion, command: npmGlobalInstall(dto.project.cli) }));
-    if (dto.migrationRequired) lines.push(t2("update.text.migrationRequired", { version: dto.cliVersion }));
+    const lines2 = [t2("update.text.current", { version: dto.cliVersion })];
+    lines2.push(dto.update.status === "available" ? t2("update.text.available", { version: dto.update.latestVersion }) : dto.update.status === "up-to-date" ? t2("update.text.upToDate") : dto.update.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable"));
+    if (dto.install) lines2.push(t2("update.text.install", { command: dto.install.npmGlobal }), t2("update.text.afterInstall"));
+    lines2.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "kept" ? t2("update.text.blockKept", { paths: dto.agentDocs.paths.join(", ") || "-" }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock") : t2("update.text.notInitialized"));
+    if (dto.agentDocs.missing.length) lines2.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", ") }));
+    if (dto.project.state === "written") lines2.push(t2("update.text.projectWritten", { path: CONFIG_PATH, version: dto.project.cli ?? dto.cliVersion }));
+    if (dto.project.cli && isNewerRelease(dto.project.cli, dto.cliVersion)) lines2.push(t2("update.text.projectAhead", { project: dto.project.cli, version: dto.cliVersion, command: npmGlobalInstall(dto.project.cli) }));
+    if (dto.migrationRequired) lines2.push(t2("update.text.migrationRequired", { version: dto.cliVersion }));
     const { commit } = dto;
-    if (commit.state === "committed") lines.push(t2("update.text.committed", { commit: commit.commit.slice(0, 12), paths: commit.paths.join(", ") }));
-    else if (commit.state === "nothing") lines.push(t2("update.text.commitNothing"));
+    if (commit.state === "committed") lines2.push(t2("update.text.committed", { commit: commit.commit.slice(0, 12), paths: commit.paths.join(", ") }));
+    else if (commit.state === "nothing") lines2.push(t2("update.text.commitNothing"));
     else if (commit.state === "skipped") {
       const paths2 = commit.paths.join(", ");
       const text4 = commit.reason === "untracked" ? t2("update.text.commitSkipped.untracked", { paths: paths2 }) : commit.reason === "other-changes" ? t2("update.text.commitSkipped.other-changes", { paths: paths2 }) : t2("update.text.commitSkipped.commit-failed", { paths: paths2 });
-      lines.push(text4 + (commit.detail ? " (" + commit.detail + ")" : ""));
+      lines2.push(text4 + (commit.detail ? " (" + commit.detail + ")" : ""));
     }
-    process.stdout.write(lines.join("\n") + "\n");
+    process.stdout.write(lines2.join("\n") + "\n");
   } catch (error62) {
     const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
     const failure2 = { code: known ? error62.code : "UPDATE_FAILED", message: known ? error62.message : t2("update.failed") };
@@ -30804,12 +30951,12 @@ async function runUpdateCheck(format2, version2) {
     return;
   }
   const state2 = dto.update;
-  const lines = [
+  const lines2 = [
     t2("update.text.current", { version: dto.cliVersion }),
     state2.status === "available" ? t2("update.text.available", { version: state2.latestVersion }) : state2.status === "up-to-date" ? t2("update.text.upToDate") : state2.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable")
   ];
-  if (state2.status === "available") lines.push(t2("update.text.install", { command: npmGlobalInstall(state2.latestVersion) }), t2("update.text.afterInstall"));
-  process.stdout.write(lines.join("\n") + "\n");
+  if (state2.status === "available") lines2.push(t2("update.text.install", { command: npmGlobalInstall(state2.latestVersion) }), t2("update.text.afterInstall"));
+  process.stdout.write(lines2.join("\n") + "\n");
 }
 
 // src/commands/version-notice.ts
@@ -30884,17 +31031,17 @@ for (let i = 0; i < languageArgs.length; i++) {
   if (value === "ko" || value === "en") selectedLanguage = value;
 }
 configureLanguage(selectedLanguage ?? environmentLanguage(), selectedLanguage);
-var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.4").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.5").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 program2.hook("preAction", async (_program, action) => {
   let top = action;
   while (top.parent && top.parent !== program2) top = top.parent;
-  if (top.name() !== REFRESH_COMMAND) await noticeVersion("0.8.4", top.name());
+  if (top.name() !== REFRESH_COMMAND) await noticeVersion("0.8.5", top.name());
 });
-program2.command(REFRESH_COMMAND, { hidden: true }).allowExcessArguments(false).action(() => refreshUpdateCache("0.8.4"));
+program2.command(REFRESH_COMMAND, { hidden: true }).allowExcessArguments(false).action(() => refreshUpdateCache("0.8.5"));
 var format = () => new Option("--format <format>", t2("help.format")).choices(formats).default("text");
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.4"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.4"));
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).addOption(new Option("--later", t2("help.updateLater")).conflicts(["check", "commit"])).action((options) => options.later ? runUpdateLater(options.format, "0.8.4") : options.check ? runUpdateCheck(options.format, "0.8.4") : runUpdate(options, "0.8.4"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.5"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.5"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).addOption(new Option("--later", t2("help.updateLater")).conflicts(["check", "commit"])).action((options) => options.later ? runUpdateLater(options.format, "0.8.5") : options.check ? runUpdateCheck(options.format, "0.8.5") : runUpdate(options, "0.8.5"));
 var listed2 = (command, sorts) => {
   command.allowExcessArguments(false).option("--q <words>", t2("help.listQ")).option("--author <name>", t2("help.listAuthor"));
   if (sorts) command.addOption(new Option("--sort <key>", t2("help.listSort")).choices([...sorts]).default(sorts[0]));
@@ -30916,7 +31063,7 @@ program2.command("check").description(t2("help.check")).allowExcessArguments(fal
 var changes = program2.command("changes").description(t2("help.changes"));
 changes.command("list").description(t2("help.changesList")).allowExcessArguments(false).addOption(format()).action((o) => runChangesList(o));
 changes.command("commit").description(t2("help.changesCommit")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.changesCommitFile")).option("--dry-run", t2("help.changesCommitDryRun")).addOption(format()).action((o) => runChangesCommit(o));
-program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.4"));
+program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.5"));
 var guide = program2.command("guide").description(t2("help.guide"));
 guide.command("list").description(t2("help.guideList")).allowExcessArguments(false).addOption(format()).action((o) => runGuideList(o));
 guide.command("show").description(t2("help.guideShow")).argument("<topic>", t2("help.guideTopic")).allowExcessArguments(false).addOption(format()).action((topic, o) => runGuideShow(topic, o));