gitifact 0.8.4 → 0.8.6

package/dist/main.js

@@ -3409,6 +3409,7 @@ var messages_default = {
   "config.schemaFields": "schemaVersion\uACFC baseline \uC124\uC815 \uD544\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "config.cliVersion": "\uC124\uC815\uC758 cli\uB294 0.8.3 \uAC19\uC740 \uBC30\uD3EC \uBC84\uC804\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
   "config.language": "\uC124\uC815\uC758 language\uB294 {languages} \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
+  "config.requirementStyle": "\uC124\uC815\uC758 requirementStyle\uC740 {styles} \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "document.pathTooLong": "\uC704\uD0A4 \uD398\uC774\uC9C0 \uACBD\uB85C \uAE4A\uC774 \uB610\uB294 \uAE38\uC774 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4: {path}",
   "document.fileName": "\uC704\uD0A4 \uD398\uC774\uC9C0 \uD30C\uC77C \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uACFC .md\uC5EC\uC57C \uD569\uB2C8\uB2E4(\uB8E8\uD2B8\uC758 README.md\xB7ARCHITECTURE.md \uAC19\uC740 \uB300\uBB38\uC790 \uC774\uB984 \uC608\uC678): {path}",
   "document.folderName": "\uC704\uD0A4 \uD3F4\uB354 \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: {path}",
@@ -3517,6 +3518,12 @@ 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}",
+  "warn.REQUIREMENT_FLOW_FORMAT": "\uC720\uC988\uCF00\uC774\uC2A4 \uC694\uAD6C\uC0AC\uD56D\uC5D0\uB294 \uAE30\uBCF8 \uD750\uB984\uC774 \uC788\uC5B4\uC57C \uD558\uACE0, \uC808\uC740 \uBC94\uC704\uC640 \uC81C\uC57D\xB7\uC0AC\uC804 \uC870\uAC74\xB7\uAE30\uBCF8 \uD750\uB984\xB7\uB300\uCCB4 \uD750\uB984\xB7\uC0AC\uD6C4 \uC870\uAC74\xB7\uC218\uC6A9 \uC870\uAC74 \uC21C\uC11C\uC785\uB2C8\uB2E4(guide show spec): {path}",
+  "warn.REQUIREMENT_PATH_FORMAT": "\uC720\uC988\uCF00\uC774\uC2A4 \uC694\uAD6C\uC0AC\uD56D\uC758 \uC218\uC6A9 \uC870\uAC74\uB9C8\uB2E4 \uACBD\uB85C: \uC904\uC744 \uB450\uACE0, \uAE30\uBCF8 \uD750\uB984\uACFC \uC774 \uC694\uAD6C\uC0AC\uD56D\uC758 \uB300\uCCB4 \uD750\uB984(A1\u2026)\uB9CC \uAC00\uB9AC\uD0B5\uB2C8\uB2E4(guide show spec): {path}",
+  "warn.REQUIREMENT_STYLE_MISSING": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 \uC694\uAD6C\uC0AC\uD56D\uC744 \uC720\uC988\uCF00\uC774\uC2A4\uB85C \uC501\uB2C8\uB2E4(config\uC758 requirementStyle). \uD504\uB860\uD2B8\uB9E4\uD130\uC5D0 style: usecase\uB97C, \uAE30\uBCF8 \uD615\uC2DD\uC73C\uB85C \uB458 \uC694\uAD6C\uC0AC\uD56D\uC774\uBA74 style: default\uB97C \uC801\uC73C\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."
 };
 
@@ -3528,6 +3535,7 @@ var messages_default2 = {
   "config.schemaFields": "Check the schemaVersion and baseline fields.",
   "config.cliVersion": "The config field cli must be a release version such as 0.8.3.",
   "config.language": "The config field language must be one of {languages}.",
+  "config.requirementStyle": "The config field requirementStyle must be one of {styles}.",
   "document.pathTooLong": "Wiki page path exceeds the depth or length limit: {path}",
   "document.fileName": "Wiki filenames must use lowercase letters, digits, hyphens and .md; uppercase root names such as README.md and ARCHITECTURE.md are allowed: {path}",
   "document.folderName": "Wiki folder names must use lowercase letters, digits and hyphens: {path}",
@@ -3636,6 +3644,12 @@ 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}",
+  "warn.REQUIREMENT_FLOW_FORMAT": "A use-case requirement has a basic flow, and its sections run scope and constraints, preconditions, basic flow, alternative flows, postconditions, acceptance criteria (guide show spec): {path}",
+  "warn.REQUIREMENT_PATH_FORMAT": "Each acceptance criterion of a use-case requirement has a Path: line naming only the basic flow and this requirement's alternative flows (A1\u2026) (guide show spec): {path}",
+  "warn.REQUIREMENT_STYLE_MISSING": "This project writes requirements as use cases (config requirementStyle). Add style: usecase to the frontmatter, or style: default for a requirement that keeps the default shape (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."
 };
 
@@ -3676,6 +3690,29 @@ async function readRepositoryStatus(reader, services) {
   };
 }
 
+// ../../packages/core/dist/domain/document.js
+var DOC_ID_PREFIX = { feature: "S", requirement: "R", design: "D", wiki: "W", instruction: "I" };
+var RECORD_ID_PREFIX = "DR";
+var token = "[a-z2-7]{10}";
+var docIdPattern = new RegExp(`^[SRDWI]-${token}$`);
+var recordIdPattern = new RegExp(`^DR-${token}$`);
+var reasonIdPattern = new RegExp(`^H-${token}$`);
+var idPatternOf = (kind2) => new RegExp(`^${DOC_ID_PREFIX[kind2]}-${token}$`);
+var kindOfId = (id) => Object.entries(DOC_ID_PREFIX).find(([, prefix]) => id.startsWith(prefix + "-"))?.[0];
+var requirementStyles = ["default", "usecase"];
+var docWarning = (code, path3, values = {}) => ({ code, path: path3, message: t(`warn.${code}`, { path: path3, ...values }) });
+var docProblem = (code, path3, values = {}) => ({ code, path: path3, message: t(`doc.${code}`, { path: path3, ...values }) });
+var DocumentError = class extends Error {
+  code;
+  path;
+  constructor(code, path3, message) {
+    super(message);
+    this.code = code;
+    this.path = path3;
+    this.name = "DocumentError";
+  }
+};
+
 // ../../packages/core/dist/formats/spec-project.js
 var InitError = class extends Error {
   code;
@@ -3740,6 +3777,11 @@ function parseManagedConfig(text4) {
       throw new InitError("INVALID_CONFIG", t("config.language", { languages: PROJECT_LANGUAGES.join(", ") }));
     config2.language = value.language;
   }
+  if ("requirementStyle" in value) {
+    if (!requirementStyles.includes(value.requirementStyle))
+      throw new InitError("INVALID_CONFIG", t("config.requirementStyle", { styles: requirementStyles.join(", ") }));
+    config2.requirementStyle = value.requirementStyle;
+  }
   return config2;
 }
 function formatManagedConfig(config2, previous) {
@@ -3747,7 +3789,7 @@ function formatManagedConfig(config2, previous) {
   if (previous !== void 0) {
     const value = JSON.parse(previous);
     if (object(value)) {
-      const { schemaVersion: _s, baseline: _b, cli: _c, language: _l, ...rest } = value;
+      const { schemaVersion: _s, baseline: _b, cli: _c, language: _l, requirementStyle: _r, ...rest } = value;
       unknown2 = rest;
     }
   }
@@ -3755,7 +3797,8 @@ function formatManagedConfig(config2, previous) {
     schemaVersion: config2.schemaVersion,
     baseline: config2.baseline,
     ...config2.cli === void 0 ? {} : { cli: config2.cli },
-    ...config2.language === void 0 ? {} : { language: config2.language }
+    ...config2.language === void 0 ? {} : { language: config2.language },
+    ...config2.requirementStyle === void 0 ? {} : { requirementStyle: config2.requirementStyle }
   };
   return JSON.stringify({ ...known, ...unknown2 }, null, 2) + "\n";
 }
@@ -3828,7 +3871,7 @@ var WIKI_DIR = ".gitifact/wiki";
 var WIKI_HISTORY_PATH = WIKI_DIR + "/history.jsonl";
 var WIKI_ENTRY = "README.md";
 var WIKI_ENTRY_PATH = WIKI_DIR + "/" + WIKI_ENTRY;
-var token = "[a-z2-7]{10}";
+var token2 = "[a-z2-7]{10}";
 var STORE_DIR = ".gitifact";
 var marker = "gitifact";
 var recordPathPattern = /^(?:\.gitifact\/spec\/[^/]+\/(?:requirements\.md|design\.md|history\.jsonl)|\.gitifact\/wiki\/(?:(?:[^/]+\/)*[^/]+\.md|history\.jsonl))$/;
@@ -3847,7 +3890,7 @@ function validateDocumentRelativePath(relative) {
     if (!nameToken.test(part) || part.length > 80)
       fail(t("document.folderName", { path: relative }));
 }
-var reqId = new RegExp(`^R-${token}$`);
+var reqId = new RegExp(`^R-${token2}$`);
 var fail = (message) => {
   throw new StoreError(message);
 };
@@ -3860,20 +3903,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}-${token2}) -->$`).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];
@@ -3909,7 +3952,7 @@ function parseFrontmatter(lines, kind2, legacyIds) {
     fields2.set("sources", sources3);
   }
   const id = fields2.get("id");
-  if (typeof id !== "string" || !new RegExp(`^(?:${legacyIds})-${token}$`).test(id))
+  if (typeof id !== "string" || !new RegExp(`^(?:${legacyIds})-${token2}$`).test(id))
     fail(t("frontmatter.id", { kind: kind2 }));
   for (const key of fields2.keys())
     if (key !== "id" && !(key === "sources" && kind2 === "design"))
@@ -3938,17 +3981,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 +4029,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 +4124,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,10 +4138,10 @@ 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);
+      const match = new RegExp(`^<!-- ${marker}-req: (R-${token2}) -->$`).exec(line2);
       if (!match || !current2)
         fail(t("spec.requirementIdRequired", { path: path3 }));
       current2.id = match[1];
@@ -4170,7 +4213,7 @@ function parseHistory(source2, scope = "spec") {
     if (!value || typeof value !== "object" || Array.isArray(value))
       fail(t("history.invalidRecord"));
     const r = value;
-    if (!shapes.includes(Object.keys(r).sort().join(",")) || typeof r.id !== "string" || !new RegExp(`^H-${token}$`).test(r.id) || ids.has(r.id) || typeof r.reason !== "string" || !r.reason.trim() || !Array.isArray(r.requirements) || !r.requirements.length && !Array.isArray(r.designs) && !Array.isArray(r.documents) || r.documents !== void 0 && (r.requirements.length || !Array.isArray(r.documents) || !r.documents.length || r.documents.some((id) => typeof id !== "string" || !/^W-[a-z2-7]{10}$/.test(id)) || new Set(r.documents).size !== r.documents.length) || r.designs !== void 0 && (!Array.isArray(r.designs) || !r.designs.length || r.designs.some((id) => typeof id !== "string" || !/^S-[a-z2-7]{10}$/.test(id)) || new Set(r.designs).size !== r.designs.length) || r.requirements.some((id) => typeof id !== "string" || !reqId.test(id)) || new Set(r.requirements).size !== r.requirements.length)
+    if (!shapes.includes(Object.keys(r).sort().join(",")) || typeof r.id !== "string" || !new RegExp(`^H-${token2}$`).test(r.id) || ids.has(r.id) || typeof r.reason !== "string" || !r.reason.trim() || !Array.isArray(r.requirements) || !r.requirements.length && !Array.isArray(r.designs) && !Array.isArray(r.documents) || r.documents !== void 0 && (r.requirements.length || !Array.isArray(r.documents) || !r.documents.length || r.documents.some((id) => typeof id !== "string" || !/^W-[a-z2-7]{10}$/.test(id)) || new Set(r.documents).size !== r.documents.length) || r.designs !== void 0 && (!Array.isArray(r.designs) || !r.designs.length || r.designs.some((id) => typeof id !== "string" || !/^S-[a-z2-7]{10}$/.test(id)) || new Set(r.designs).size !== r.designs.length) || r.requirements.some((id) => typeof id !== "string" || !reqId.test(id)) || new Set(r.requirements).size !== r.requirements.length)
       fail(t("history.invalidFields"));
     ids.add(r.id);
     records2.push({ id: r.id, requirements: r.requirements, ...r.designs === void 0 ? {} : { designs: r.designs }, ...r.documents === void 0 ? {} : { documents: r.documents }, reason: r.reason });
@@ -4289,28 +4332,6 @@ function compareStoreBundles(a, b) {
   return { specChanges: specs2.specChanges, changes: [...specs2.changes, ...compareWikis(a.wiki, b.wiki)] };
 }
 
-// ../../packages/core/dist/domain/document.js
-var DOC_ID_PREFIX = { feature: "S", requirement: "R", design: "D", wiki: "W", instruction: "I" };
-var RECORD_ID_PREFIX = "DR";
-var token2 = "[a-z2-7]{10}";
-var docIdPattern = new RegExp(`^[SRDWI]-${token2}$`);
-var recordIdPattern = new RegExp(`^DR-${token2}$`);
-var reasonIdPattern = new RegExp(`^H-${token2}$`);
-var idPatternOf = (kind2) => new RegExp(`^${DOC_ID_PREFIX[kind2]}-${token2}$`);
-var kindOfId = (id) => Object.entries(DOC_ID_PREFIX).find(([, prefix]) => id.startsWith(prefix + "-"))?.[0];
-var docWarning = (code, path3, values = {}) => ({ code, path: path3, message: t(`warn.${code}`, { path: path3, ...values }) });
-var docProblem = (code, path3, values = {}) => ({ code, path: path3, message: t(`doc.${code}`, { path: path3, ...values }) });
-var DocumentError = class extends Error {
-  code;
-  path;
-  constructor(code, path3, message) {
-    super(message);
-    this.code = code;
-    this.path = path3;
-    this.name = "DocumentError";
-  }
-};
-
 // ../../packages/core/dist/domain/record.js
 var recordSectionKeys = ["context", "decision", "alternatives"];
 var RECORD_REQUIRED_SECTIONS = ["context", "decision"];
@@ -4336,13 +4357,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 +4406,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 = ["---"];
@@ -4577,7 +4598,7 @@ function classifyDocPath(path3) {
 }
 var KEYS2 = {
   feature: ["id", "title", "description", "draft"],
-  requirement: ["id", "title", "description", "order", "draft"],
+  requirement: ["id", "title", "description", "order", "style", "draft"],
   design: ["id", "title", "description", "order", "requirements", "sources", "draft"],
   wiki: ["id", "title", "description", "draft"],
   instruction: ["id", "title", "description", "draft"]
@@ -4683,8 +4704,12 @@ function parseDocumentFile(path3, source2) {
     return { kind: "wiki", ...common };
   if (where.kind === "instruction")
     return { kind: "instruction", name: where.name, ...common };
-  if (where.kind === "requirement")
-    return { kind: "requirement", feature: where.feature, order: order(), ...common };
+  if (where.kind === "requirement") {
+    const style2 = fields2.get("style");
+    if (style2 && (style2.type !== "scalar" || !requirementStyles.includes(style2.value)))
+      throw new DocumentError("FRONTMATTER_VALUE", path3, t("doc.FRONTMATTER_VALUE", { path: path3, value: "style" }));
+    return { kind: "requirement", feature: where.feature, order: order(), ...style2 ? { style: style2.value } : {}, ...common };
+  }
   const refs = fields2.get("requirements");
   if (refs && (refs.type !== "list" || refs.items.some((r) => !idPatternOf("requirement").test(r)) || new Set(refs.items).size !== refs.items.length)) {
     throw new DocumentError("FRONTMATTER_VALUE", path3, t("doc.FRONTMATTER_VALUE", { path: path3, value: "requirements" }));
@@ -4710,6 +4735,7 @@ function renderDocumentFile(doc) {
     ["title", doc.title],
     ["description", doc.description],
     ["order", doc.kind === "requirement" || doc.kind === "design" ? doc.order : void 0],
+    ["style", doc.kind === "requirement" ? doc.style : void 0],
     ["requirements", doc.kind === "design" ? doc.requirements : void 0],
     ["sources", doc.kind === "design" ? doc.sources.map((s) => ({ ...s })) : void 0],
     ["draft", doc.draft ? true : void 0]
@@ -4929,6 +4955,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 +4990,79 @@ 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;
+var useCaseSections = [
+  ["scope", scopeHeading],
+  ["preconditions", /^###\s+(?:사전 조건|preconditions)\s*$/i],
+  ["basic", /^###\s+(?:기본 흐름|basic flow)\s*$/i],
+  ["alternatives", /^###\s+(?:대체 흐름|alternative flows?)\s*$/i],
+  ["postconditions", /^###\s+(?:사후 조건|postconditions)\s*$/i],
+  ["acceptance", acceptanceHeading]
+];
+var pathLine = /^\s*(?:경로|path)\s*:\s*(.*)$/i;
+var basicFlowName = /^(?:기본 흐름|basic flow)$/i;
+var alternativeId = /^-\s+(?:\*\*)?(A\d+)\b/;
+function requirementFormatWarnings(doc, projectStyle) {
+  if (doc.kind !== "requirement")
+    return [];
+  const missing2 = projectStyle === "usecase" && !doc.style ? [docWarning("REQUIREMENT_STYLE_MISSING", doc.path)] : [];
+  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));
+  if (doc.style === "usecase")
+    warnings.push(...useCaseWarnings(doc.path, body2, sectionOf, acceptance));
+  return [...missing2, ...warnings];
+}
+function useCaseWarnings(path3, body2, sectionOf, acceptance) {
+  const warnings = [];
+  const found = useCaseSections.map(([key, heading]) => ({ key, at: body2.findIndex((line2) => heading.test(line2.trim())) })).filter((s) => s.at >= 0);
+  const ordered = found.every((s, i) => i === 0 || s.at > found[i - 1].at);
+  if (!found.some((s) => s.key === "basic") || !ordered)
+    warnings.push(docWarning("REQUIREMENT_FLOW_FORMAT", path3));
+  if (acceptance < 0)
+    return warnings;
+  const alternatives = found.find((s) => s.key === "alternatives");
+  const defined = new Set(alternatives ? sectionOf(alternatives.at).flatMap((line2) => {
+    const m = alternativeId.exec(line2);
+    return m ? [m[1]] : [];
+  }) : []);
+  const items2 = [];
+  for (const line2 of sectionOf(acceptance)) {
+    if (/^\d+\.\s/.test(line2))
+      items2.push([line2.replace(/^\d+\.\s+/, "")]);
+    else if (items2.length && /^\s+\S/.test(line2))
+      items2[items2.length - 1].push(line2);
+  }
+  const named = (flow) => basicFlowName.test(flow) || defined.has(flow);
+  const unpathed = items2.some((item) => {
+    const match = item.map((line2) => pathLine.exec(line2)).find(Boolean);
+    const flows = match ? match[1].split(/[,，、]/).map((f) => f.trim()).filter(Boolean) : [];
+    return !flows.length || !flows.every(named);
+  });
+  if (unpathed)
+    warnings.push(docWarning("REQUIREMENT_PATH_FORMAT", path3));
   return warnings;
 }
 
@@ -4981,12 +5081,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 +5124,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 +7097,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 +7939,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);
     }
@@ -25056,7 +25156,8 @@ var state = external_exports.enum(["committed", "added", "modified", "deleted"])
 var standing = { state, previousPath: external_exports.string().optional() };
 var contributor = external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string() });
 var source = external_exports.strictObject({ id: external_exports.string().optional(), title: external_exports.string().optional(), path: external_exports.string().optional(), url: external_exports.string().optional(), note: external_exports.string().optional() });
-var requirement = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string(), order: external_exports.number().int().nonnegative(), body: external_exports.string(), ...standing });
+var style = external_exports.enum(["default", "usecase"]);
+var requirement = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string(), order: external_exports.number().int().nonnegative(), style: style.optional(), body: external_exports.string(), ...standing });
 var design = external_exports.strictObject({
   id: external_exports.string(),
   path: external_exports.string(),
@@ -25143,7 +25244,7 @@ var browserFeaturesV1 = external_exports.strictObject({
   next: external_exports.string().nullable(),
   features: external_exports.array(featureRow)
 });
-var browserFeatureV1 = external_exports.strictObject({ contract: external_exports.literal("browser-feature"), version: external_exports.literal(1), sessionId: external_exports.string(), feature });
+var browserFeatureV2 = external_exports.strictObject({ contract: external_exports.literal("browser-feature"), version: external_exports.literal(2), sessionId: external_exports.string(), feature });
 var browserInstructionsV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-instructions"),
   version: external_exports.literal(1),
@@ -25177,6 +25278,7 @@ var snapshot = external_exports.strictObject({
   specId: external_exports.string(),
   path: external_exports.string(),
   order: external_exports.number().int().optional(),
+  style: style.optional(),
   requirements: external_exports.array(external_exports.string()).optional(),
   sources: external_exports.array(source).optional()
 }).nullable();
@@ -25198,16 +25300,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 +25354,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()
 });
@@ -25324,9 +25436,9 @@ var browserCommitV4 = external_exports.strictObject({
 });
 var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
 var browserCommitQueryV3 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(200).optional(), limit: count(100).pipe(external_exports.number().min(1)).optional(), record: recordId.optional() });
-var browserCommitChangeV1 = external_exports.strictObject({
+var browserCommitChangeV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit-change"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   commit: oid2,
   event,
@@ -25345,6 +25457,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),
@@ -25367,9 +25497,9 @@ var browserWorkingV1 = external_exports.strictObject({
   changes: external_exports.array(workingChange),
   withoutRecord: external_exports.array(external_exports.string())
 });
-var browserWorkingChangeV1 = external_exports.strictObject({
+var browserWorkingChangeV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-working-change"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   change: workingChange,
   before: snapshot,
@@ -25635,6 +25765,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 +25900,8 @@ 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.requirementUsecase": "(\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### \uC0AC\uC804 \uC870\uAC74\n\n- (\uC2DC\uC791 \uC804\uC5D0 \uCC38\uC774\uC5B4\uC57C \uD558\uB294 \uAC83. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uAE30\uBCF8 \uD750\uB984\n\n1. (\uD589\uC704\uC790)\uAC00 (\uB3D9\uC791)\uD55C\uB2E4.\n2. (\uC2DC\uC2A4\uD15C)\uC774 (\uACB0\uACFC)\uB97C \uBCF4\uC778\uB2E4.\n\n### \uB300\uCCB4 \uD750\uB984\n\n- **A1. (\uAC08\uB77C\uC9C0\uB294 \uC0C1\uD669)** (1\uB2E8\uACC4\uC5D0\uC11C)\n  1. (\uADF8\uB54C\uC758 \uB3D9\uC791)\n\n### \uC0AC\uD6C4 \uC870\uAC74\n\n- (\uB05D\uB09C \uB4A4 \uCC38\uC778 \uAC83. \uC5C6\uC73C\uBA74 \uC774 \uC808\uC744 \uC9C0\uC6B4\uB2E4)\n\n### \uC218\uC6A9 \uC870\uAC74\n\n1. \uACBD\uB85C: \uAE30\uBCF8 \uD750\uB984\n   \uC870\uAC74: (\uC0C1\uD669)\n   \uAE30\uB300 \uB3D9\uC791: (\uACB0\uACFC)\n2. \uACBD\uB85C: \uAE30\uBCF8 \uD750\uB984, A1\n   \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}",
@@ -25792,8 +25924,10 @@ var messages_default3 = {
   "commit.checkFailed": "\uBB38\uC11C \uAC80\uC0AC\uC5D0\uC11C \uBB38\uC81C {count}\uAC1C\uAC00 \uB098\uC640 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.",
   "commit.unknownDocument": "\uACB0\uC815\uAE30\uB85D\uC774 \uAC00\uB9AC\uD0A4\uB294 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: {ids}",
   "docs.singleLine": "{field}\uC740 \uD55C \uC904\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
+  "docs.styleRequirementOnly": "--style\uC740 \uC694\uAD6C\uC0AC\uD56D(requirement)\uC744 \uB9CC\uB4E4 \uB54C\uB9CC \uC501\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}",
@@ -25830,6 +25964,7 @@ var messages_default3 = {
   "help.specsNew": "ID\uB97C \uBC1C\uAE09\uD558\uACE0 \uD504\uB860\uD2B8\uB9E4\uD130\uC640 \uBCF8\uBB38 \uBF08\uB300\uB97C \uCC44\uC6B4 \uC0C8 \uBA85\uC138 \uD30C\uC77C \uC0DD\uC131 (draft: true \uD45C\uC2DC)",
   "help.specsNewKind": "feature, requirement, design \uC911 \uD558\uB098",
   "help.specsNewPath": "\uAE30\uB2A5 \uC774\uB984 \uB610\uB294 \uAE30\uB2A5/slug (\uC608: payment, payment/cancel)",
+  "help.specsNewStyle": "\uC694\uAD6C\uC0AC\uD56D \uD615\uC2DD(usecase, default). \uC5C6\uC73C\uBA74 \uC124\uC815\uC758 requirementStyle\uC744 \uB530\uB978\uB2E4",
   "help.newTitle": "\uBB38\uC11C \uC81C\uBAA9",
   "help.newDescription": "\uD55C \uC904 \uC124\uBA85",
   "help.instructions": "\uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC758 \uBAA9\uB85D\xB7\uC6D0\uBB38\xB7\uC0DD\uC131",
@@ -25949,6 +26084,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 +26219,8 @@ 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.requirementUsecase": "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### Preconditions\n\n- (What holds before it starts. Remove this section if there is none)\n\n### Basic flow\n\n1. (The actor) (acts).\n2. (The system) shows (the result).\n\n### Alternative flows\n\n- **A1. (Where it branches)** (at step 1)\n  1. (What happens then)\n\n### Postconditions\n\n- (What holds when it ends. Remove this section if there is none)\n\n### Acceptance criteria\n\n1. Path: Basic flow\n   Condition: (situation)\n   Expected: (result)\n2. Path: Basic flow, A1\n   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}",
@@ -26106,8 +26243,10 @@ var messages_default4 = {
   "commit.checkFailed": "The document check found {count} problems; nothing was committed.",
   "commit.unknownDocument": "A record names documents that do not exist: {ids}",
   "docs.singleLine": "The {field} must be a single line.",
+  "docs.styleRequirementOnly": "--style applies only when creating a requirement.",
   "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}",
@@ -26144,6 +26283,7 @@ var messages_default4 = {
   "help.specsNew": "Create a spec file with an issued ID, frontmatter and a body skeleton (marked draft: true)",
   "help.specsNewKind": "One of feature, requirement, design",
   "help.specsNewPath": "Feature name or feature/slug (e.g. payment, payment/cancel)",
+  "help.specsNewStyle": "Requirement shape (usecase, default). Defaults to the config requirementStyle",
   "help.newTitle": "Document title",
   "help.newDescription": "One-line description",
   "help.instructions": "List, read and create project instructions",
@@ -26559,7 +26699,7 @@ function storeReader(cwd) {
 import { DatabaseSync } from "node:sqlite";
 import { lstat, mkdir, rm, writeFile } from "node:fs/promises";
 import { join as join2 } from "node:path";
-var CACHE_FORMAT = 11;
+var CACHE_FORMAT = 12;
 var CACHE_DIR = ".gitifact/cache";
 var SCHEMA = `
   -- Working-tree files already read: the modification time and size decide whether a file is read again.
@@ -26711,6 +26851,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;
@@ -27003,7 +27147,7 @@ var recordKind = (path3) => {
 var folderOf = (path3) => path3.startsWith(SPEC_ROOT + "/") ? path3.split("/").slice(0, 3).join("/") : null;
 function snapshot3(doc, specId) {
   const base = { id: doc.id, kind: doc.kind, title: doc.title, description: doc.description, body: doc.body, specId, path: doc.path };
-  if (doc.kind === "requirement") return { ...base, order: doc.order };
+  if (doc.kind === "requirement") return { ...base, order: doc.order, ...doc.style ? { style: doc.style } : {} };
   if (doc.kind === "design") return { ...base, order: doc.order, requirements: doc.requirements, sources: doc.sources };
   return base;
 }
@@ -27026,7 +27170,7 @@ function sideOf2(files) {
   }
   return { docs: new Map(docs.map((d) => [d.id, snapshot3(d, d.kind === "wiki" || d.kind === "instruction" ? d.kind : specIds.get(folderOf(d.path)) ?? "")])), reasons };
 }
-var same = (a, b) => a.title === b.title && a.description === b.description && a.body === b.body && a.order === b.order && JSON.stringify(a.requirements) === JSON.stringify(b.requirements) && JSON.stringify(a.sources) === JSON.stringify(b.sources);
+var same = (a, b) => a.title === b.title && a.description === b.description && a.body === b.body && a.order === b.order && a.style === b.style && JSON.stringify(a.requirements) === JSON.stringify(b.requirements) && JSON.stringify(a.sources) === JSON.stringify(b.sources);
 function compare(before, after) {
   const out = [];
   for (const id of [.../* @__PURE__ */ new Set([...before.docs.keys(), ...after.docs.keys()])].sort()) {
@@ -27103,10 +27247,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 +27559,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 +27610,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 +27681,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 +27893,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 +28245,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);
   };
 }
@@ -28111,7 +28281,7 @@ function checkoutDocuments(states, authors) {
       description: index.description,
       body: index.body,
       ...standing2(index.id),
-      requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, body: r.body, ...standing2(r.id) })),
+      requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, ...r.style ? { style: r.style } : {}, body: r.body, ...standing2(r.id) })),
       designs: designs.map((d) => ({
         id: d.id,
         path: d.path,
@@ -28152,23 +28322,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 +28352,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 +28418,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 +28436,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 };
   }
@@ -28339,7 +28517,7 @@ function snapshot4(doc, docs) {
   const folder = doc.path.split("/").slice(0, 3).join("/");
   const specId = doc.kind === "wiki" || doc.kind === "instruction" ? doc.kind : docs.find((d) => d.kind === "feature" && d.path === folder + "/index.md")?.id ?? "";
   const base = { id: doc.id, kind: doc.kind, title: doc.title, description: doc.description, body: doc.body, specId, path: doc.path };
-  if (doc.kind === "requirement") return { ...base, order: doc.order };
+  if (doc.kind === "requirement") return { ...base, order: doc.order, ...doc.style ? { style: doc.style } : {} };
   if (doc.kind === "design") return { ...base, order: doc.order, requirements: doc.requirements, sources: doc.sources };
   return base;
 }
@@ -28400,6 +28578,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 +28613,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++;
   }
@@ -28529,7 +28726,7 @@ function recordRoutes(root, sessionId, env) {
     route({ method: "GET", path: "/api/v1/feature", session: true, query: browserFeatureQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
       const feature2 = featureOf(await checkout.base(), query.id);
       if (!feature2) throw new HttpError(404, "NOT_FOUND", t2("server.featureNotFound"));
-      return ok(browserFeatureV1.parse({ contract: "browser-feature", version: 1, sessionId, feature: feature2 }));
+      return ok(browserFeatureV2.parse({ contract: "browser-feature", version: 2, sessionId, feature: feature2 }));
     } }),
     route({ method: "GET", path: "/api/v1/instructions", session: true, unreadable: unreadable2, handle: async () => ok(browserInstructionsV1.parse({ contract: "browser-instructions", version: 1, sessionId, ...await checkout.instructions() })) }),
     route({ method: "GET", path: "/api/v1/contributors", session: true, query: browserContributorsQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
@@ -28544,10 +28741,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",
@@ -28584,7 +28787,7 @@ function recordRoutes(root, sessionId, env) {
     route({ method: "GET", path: "/api/v1/commit/change", session: true, query: browserCommitChangeQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
       const change2 = await cache.history.commitChange(query.commit, query.id);
       if (!change2) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
-      return ok(browserCommitChangeV1.parse({ contract: "browser-commit-change", version: 1, sessionId, commit: query.commit, event: change2.event, before: change2.before, after: change2.after }));
+      return ok(browserCommitChangeV2.parse({ contract: "browser-commit-change", version: 2, sessionId, commit: query.commit, event: change2.event, before: change2.before, after: change2.after }));
     } }),
     // A record's page names the record; which commit added it is read from the history of the HEAD the reader is on.
     route({ method: "GET", path: "/api/v1/record", session: true, query: browserRecordQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
@@ -28592,12 +28795,19 @@ 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 }) => {
       const change2 = await workingChange2(working2, query.id);
       if (!change2) throw new HttpError(404, "NOT_FOUND", t2("server.workingChangeNotFound"));
-      return ok(browserWorkingChangeV1.parse({ contract: "browser-working-change", version: 1, sessionId, ...change2 }));
+      return ok(browserWorkingChangeV2.parse({ contract: "browser-working-change", version: 2, sessionId, ...change2 }));
     } }),
     // The source a commit changed beside its documents, read from Git when the commit or record page asks for it.
     route({ method: "GET", path: "/api/v1/commit/files", session: true, query: browserCommitFilesQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
@@ -28973,11 +29183,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 +29204,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 +29281,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) {
@@ -29662,6 +29872,10 @@ async function createDocument(project, kind2, path3, options) {
   for (const [field, value] of [["title", options.title], ["description", options.description]]) {
     if (/[\r\n]/.test(value)) throw new CommandError("INVALID_VALUE", t2("docs.singleLine", { field }));
   }
+  if (options.style && kind2 !== "requirement") throw new CommandError("INVALID_VALUE", t2("docs.styleRequirementOnly"));
+  const projectStyle = project.config.requirementStyle;
+  const style2 = kind2 === "requirement" ? options.style ?? projectStyle ?? "default" : void 0;
+  const styleKey = style2 === "usecase" || style2 === "default" && projectStyle === "usecase" ? { style: style2 } : {};
   const target = newPath(kind2, path3);
   const { documents } = await project.cache.documents.list();
   const taken = new Set(documents.map((d) => d.id));
@@ -29672,9 +29886,10 @@ async function createDocument(project, kind2, path3, options) {
   const folder = target.slice(0, target.lastIndexOf("/") + 1);
   const siblings = documents.filter((d) => (d.kind === "requirement" || d.kind === "design") && d.path.startsWith(folder) && !d.path.slice(folder.length).includes("/"));
   const order = Math.min(999999, Math.max(0, ...siblings.map((d) => d.order)) + 10);
-  const base = { id, path: target, title: options.title.trim(), description: options.description.trim(), body: skeleton[kind2](), draft: true };
+  const body2 = style2 === "usecase" ? t2("docs.skeleton.requirementUsecase") : skeleton[kind2]();
+  const base = { id, path: target, title: options.title.trim(), description: options.description.trim(), body: body2, draft: true };
   const feature2 = target.split("/")[2];
-  const doc = kind2 === "feature" ? { kind: kind2, feature: feature2, ...base } : kind2 === "instruction" ? { kind: kind2, name: path3, ...base } : kind2 === "requirement" ? { kind: kind2, feature: feature2, order, ...base } : { kind: kind2, feature: feature2, order, requirements: [], sources: [], ...base };
+  const doc = kind2 === "feature" ? { kind: kind2, feature: feature2, ...base } : kind2 === "instruction" ? { kind: kind2, name: path3, ...base } : kind2 === "requirement" ? { kind: kind2, feature: feature2, order, ...styleKey, ...base } : { kind: kind2, feature: feature2, order, requirements: [], sources: [], ...base };
   const rendered = renderDocumentFile(doc);
   parseDocumentFile(target, rendered);
   try {
@@ -29732,13 +29947,14 @@ 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 "";
 }
 
 // src/commands/specs.ts
 var specKinds = ["feature", "requirement", "design"];
+var specStyles = requirementStyles;
 var specSorts = ["order", "title", "updated"];
 var columns = ["id", "kind", "feature", "path", "title", "description", "order", "draft", "state", "previousPath", "requirements", "sources", "designs", "updated", "line"];
 var kindLabel = { feature: () => t2("docs.feature"), requirement: () => t2("docs.requirement"), design: () => t2("docs.design") };
@@ -30136,6 +30352,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, project) => {
+  const touched = new Set(changes2.map((c) => c.id));
+  return documents.filter((d) => touched.has(d.id)).flatMap((d) => requirementFormatWarnings(d, project.config.requirementStyle));
+};
 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 +30366,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, project);
+  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 +30375,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 +30391,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 +30448,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, project);
   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 +30465,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 +30630,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 +30674,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 +30984,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 +31029,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 +31109,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.6").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.6", 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.6"));
 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.6"));
+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.6"));
+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.6") : options.check ? runUpdateCheck(options.format, "0.8.6") : runUpdate(options, "0.8.6"));
 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]));
@@ -30903,7 +31128,7 @@ var listed2 = (command, sorts) => {
 var specs = program2.command("specs").description(t2("help.specs"));
 listed2(specs.command("list").description(t2("help.specsList")).addOption(new Option("--type <kind>", t2("help.specsListType")).choices([...specKinds])).option("--feature <folder>", t2("help.specsListFeature")).option("--without-design", t2("help.specsListWithoutDesign")).option("--uncovered", t2("help.specsListUncovered")).option("--draft", t2("help.specsListDraft")).option("--changed-since <date|commit>", t2("help.specsListChangedSince")), specSorts).action((o) => runSpecsList(o));
 specs.command("show").description(t2("help.specsShow")).argument("<ids...>", t2("help.specsShowIds")).option("--ref <commit>", t2("help.showRef")).addOption(format()).action((ids, o) => runSpecsShow(ids, o));
-specs.command("new").description(t2("help.specsNew")).allowExcessArguments(false).addArgument(new Argument("<kind>", t2("help.specsNewKind")).choices(specKinds)).argument("<path>", t2("help.specsNewPath")).requiredOption("--title <title>", t2("help.newTitle")).requiredOption("--description <text>", t2("help.newDescription")).addOption(format()).action((kind2, path3, o) => runSpecsNew(kind2, path3, o));
+specs.command("new").description(t2("help.specsNew")).allowExcessArguments(false).addArgument(new Argument("<kind>", t2("help.specsNewKind")).choices(specKinds)).argument("<path>", t2("help.specsNewPath")).requiredOption("--title <title>", t2("help.newTitle")).requiredOption("--description <text>", t2("help.newDescription")).addOption(new Option("--style <style>", t2("help.specsNewStyle")).choices(specStyles)).addOption(format()).action((kind2, path3, o) => runSpecsNew(kind2, path3, o));
 var instructions = program2.command("instructions").description(t2("help.instructions"));
 listed2(instructions.command("list").description(t2("help.instructionsList")), instructionSorts).action((o) => runInstructionsList(o));
 instructions.command("show").description(t2("help.instructionsShow")).argument("<targets...>", t2("help.instructionsShowTargets")).option("--ref <commit>", t2("help.showRef")).option("--file <path>", t2("help.instructionsShowFile")).addOption(format()).action((targets, o) => runInstructionsShow(targets, o));
@@ -30916,7 +31141,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.6"));
 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));