gitifact 0.7.0 → 0.7.1

package/dist/main.js

@@ -24917,6 +24917,69 @@ var updateV3 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(3), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
+// ../../packages/contracts/dist/versions/project-init-v6.js
+var projectInitV6 = external_exports.discriminatedUnion("ok", [
+  external_exports.strictObject({
+    contract: external_exports.literal("project-init"),
+    version: external_exports.literal(6),
+    ok: external_exports.literal(true),
+    outcome: external_exports.enum(["planned", "created", "replaced", "already-initialized"]),
+    rootPath: external_exports.string(),
+    configPath: external_exports.literal(".gitifact/config.json"),
+    schemaVersion: external_exports.literal(2),
+    baseline: external_exports.discriminatedUnion("kind", [
+      external_exports.strictObject({ kind: external_exports.literal("empty") }),
+      external_exports.strictObject({ kind: external_exports.literal("commit"), objectFormat: external_exports.enum(["sha1", "sha256"]), commit: external_exports.string() })
+    ]),
+    agentDocs: external_exports.strictObject({ mode: external_exports.enum(["install", "remove", "skip"]), paths: external_exports.array(external_exports.string()) }),
+    update: updateStateV1,
+    // Present only when a newer release exists. npx refreshes the project blocks without a global install; npmGlobal remains an alternative.
+    install: external_exports.strictObject({ npx: external_exports.string().min(1), npmGlobal: external_exports.string().min(1) }).nullable()
+  }),
+  external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(6), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+]);
+
+// ../../packages/contracts/dist/versions/update-v4.js
+var commitReason2 = external_exports.enum(["untracked", "other-changes", "commit-failed"]);
+var agentDocsCommit2 = external_exports.strictObject({
+  state: external_exports.enum(["not-requested", "nothing", "committed", "skipped"]),
+  commit: external_exports.string().nullable(),
+  paths: external_exports.array(external_exports.string()),
+  message: external_exports.string().nullable(),
+  reason: commitReason2.nullable(),
+  detail: external_exports.string().nullable()
+}).refine((value) => value.state === "committed" === (value.commit !== null) && value.state === "skipped" === (value.reason !== null), "commit is set exactly when committed, reason exactly when skipped.");
+var updateV4 = external_exports.discriminatedUnion("ok", [
+  external_exports.strictObject({
+    contract: external_exports.literal("update"),
+    version: external_exports.literal(4),
+    ok: external_exports.literal(true),
+    cliVersion: external_exports.string().min(1),
+    update: updateStateV1,
+    // Present only when a newer release exists. npx refreshes the project blocks without a global install; npmGlobal remains an alternative.
+    install: external_exports.strictObject({ npx: external_exports.string().min(1), npmGlobal: external_exports.string().min(1) }).nullable(),
+    // refreshed: blocks whose version line differed were rewritten. current: every block already matched.
+    // not-initialized: no .gitifact config here, so only the version check ran. no-block: no file carries a block.
+    // missing: files `gitifact init` would add and update does not create, e.g. CLAUDE.md when only AGENTS.md has the block.
+    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()), missing: external_exports.array(external_exports.string()) }),
+    commit: agentDocsCommit2
+  }),
+  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(4), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+]);
+
+// ../../packages/contracts/dist/versions/browser-session-v3.js
+var browserSessionV3 = browserSessionV2.omit({ update: true }).extend({ version: external_exports.literal(3) });
+
+// ../../packages/contracts/dist/versions/update-check-v1.js
+var updateCheckV1 = external_exports.strictObject({
+  contract: external_exports.literal("update-check"),
+  version: external_exports.literal(1),
+  ok: external_exports.literal(true),
+  cliVersion: external_exports.string().min(1),
+  update: updateStateV1.refine((value) => value.status !== "checking", "The check must have finished."),
+  command: external_exports.string().min(1).nullable()
+}).refine((value) => value.update.status === "available" === (value.command !== null), "An update command is present exactly when a newer release is available.");
+
 // src/shared/i18n/index.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 
@@ -25095,7 +25158,7 @@ var messages_default3 = {
   "init.text.blockUpdated": "\uBE14\uB85D \uAC31\uC2E0",
   "init.text.storage": "\uC800\uC7A5 \uADDC\uC57D",
   "init.text.agentDocs": "\uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68",
-  "init.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC124\uCE58\uD55C \uB4A4 gitifact init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uC9C0\uCE68 \uBE14\uB85D\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0\uB429\uB2C8\uB2E4.",
+  "init.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC0C8 \uBC84\uC804\uC744 \uC2E4\uD589\uD558\uACE0 \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC744 \uAC31\uC2E0\uD558\uC138\uC694.",
   "init.failed": "\uCD08\uAE30\uD654\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uD30C\uC77C \uC811\uADFC \uAD8C\uD55C\uACFC \uC0DD\uC131\uB41C \uC124\uC815\xB7\uC784\uC2DC \uD30C\uC77C\uC744 \uD655\uC778\uD558\uC138\uC694.",
   "config.storeNotDirectory": ".gitifact\uB294 \uB9C1\uD06C\uAC00 \uC544\uB2CC \uC77C\uBC18 \uB514\uB809\uD130\uB9AC\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "config.migrateFirst": ".tryce \uC800\uC7A5\uC18C\uC785\uB2C8\uB2E4. gitifact migrate\uB85C .gitifact\uC5D0 \uC804\uD658\uD558\uC138\uC694.",
@@ -25132,7 +25195,6 @@ var messages_default3 = {
   "docs.summary.design": "design.md \uBAA9\uCC28, \uCC38\uC870 \uC8FC\uC11D\uACFC \uCC38\uACE0 \uBB38\uC11C, \uAC1C\uC815 \uBC29\uC2DD",
   "docs.summary.writing": "\uC704\uD0A4\xB7\uC694\uAD6C\uC0AC\uD56D\xB7\uC124\uACC4\uC5D0 \uACF5\uD1B5\uC73C\uB85C \uC801\uC6A9\uD558\uB294 \uBB38\uCCB4, \uC778\uC6A9\uACFC Alert, AI \uC2AC\uB86D \uC81C\uAC70",
   "docs.summary.commit": "spec commit \uC785\uB825, \uC774\uC720 \uAE30\uB85D, \uC2E4\uD328 \uD6C4 \uBCF5\uAD6C",
-  "help.browserNoUpdateCheck": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC744 \uC704\uD55C npm \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC870\uD68C\uB97C \uB054 (GITIFACT_NO_UPDATE_CHECK\uC640 \uAC19\uC74C)",
   "help.updateCommit": "\uAC31\uC2E0\uD55C GITIFACT \uBE14\uB85D\uC774 HEAD\uC640 \uBE14\uB85D \uC548\uC5D0\uC11C\uB9CC \uB2E4\uB974\uBA74 \uADF8 \uD30C\uC77C\uB9CC \uACE0\uC815 \uBA54\uC2DC\uC9C0\uB85C \uCEE4\uBC0B",
   "help.update": "\uC0C8 \uBC84\uC804 \uD655\uC778\uACFC \uC124\uCE58 \uBC29\uBC95 \uC548\uB0B4, \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68 \uD30C\uC77C\uC758 GITIFACT \uBE14\uB85D\uC744 \uD604\uC7AC \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0",
   "server.changelogNotFound": "\uD328\uCE58\uB178\uD2B8\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
@@ -25142,13 +25204,13 @@ var messages_default3 = {
   "update.text.upToDate": "\uCD5C\uC2E0 \uBC84\uC804\uC744 \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.",
   "update.text.disabled": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC774 \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4.",
   "update.text.unavailable": "\uC0C8 \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.",
-  "update.text.install": "npm \uC804\uC5ED \uC124\uCE58\uC6A9: {command}",
-  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update --commit\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uC9C0\uCE68 \uBE14\uB85D\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0\uB418\uACE0 \uCEE4\uBC0B\uB429\uB2C8\uB2E4.",
+  "update.text.install": "\uC5C5\uB370\uC774\uD2B8 \uBA85\uB839: {command}",
+  "update.text.afterInstall": "\uC704 \uBA85\uB839\uC740 \uC804\uC5ED \uC124\uCE58 \uC5C6\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uC9C0\uCE68\uC744 \uAC31\uC2E0\uD569\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uC758\uC874\uC131\uC73C\uB85C \uAD00\uB9AC\uD55C\uB2E4\uBA74 \uD574\uB2F9 \uBC84\uC804\uC744 \uBA3C\uC800 \uAC31\uC2E0\uD558\uC138\uC694. \uBE0C\uB77C\uC6B0\uC800\uB3C4 \uC0C8 \uBC84\uC804\uC73C\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   "update.text.blockRefreshed": "\uC9C0\uCE68 \uBE14\uB85D \uAC31\uC2E0: {paths}",
   "update.text.blockCurrent": "\uC9C0\uCE68 \uBE14\uB85D\uC740 \uC774\uBBF8 \uD604\uC7AC \uBC84\uC804\uC785\uB2C8\uB2E4: {paths}",
-  "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. gitifact init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
+  "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. npx --yes gitifact@{version} init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
   "update.text.notInitialized": "\uCD08\uAE30\uD654\uB41C \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2C8\uC5B4\uC11C \uBC84\uC804\uB9CC \uD655\uC778\uD588\uC2B5\uB2C8\uB2E4.",
-  "update.text.missing": "{paths} \uD30C\uC77C\uC774 \uC5C6\uC5B4 Claude Code\uAC00 AGENTS.md\uC758 \uC9C0\uCE68\uC744 \uC77D\uC9C0 \uBABB\uD569\uB2C8\uB2E4. gitifact init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 AGENTS.md\uB97C \uAC00\uC838\uC624\uB294 \uD30C\uC77C\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.",
+  "update.text.missing": "{paths} \uD30C\uC77C\uC774 \uC5C6\uC5B4 Claude Code\uAC00 AGENTS.md\uC758 \uC9C0\uCE68\uC744 \uC77D\uC9C0 \uBABB\uD569\uB2C8\uB2E4. npx --yes gitifact@{version} init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 AGENTS.md\uB97C \uAC00\uC838\uC624\uB294 \uD30C\uC77C\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.",
   "update.text.committed": "\uC9C0\uCE68 \uBE14\uB85D \uCEE4\uBC0B: {commit} ({paths})",
   "update.text.commitNothing": "\uCEE4\uBC0B\uD560 \uC9C0\uCE68 \uBE14\uB85D \uBCC0\uACBD\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "update.text.commitSkipped.untracked": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. Git\uC774 \uCD94\uC801\uD558\uC9C0 \uC54A\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC785\uB2C8\uB2E4: {paths}",
@@ -25161,7 +25223,8 @@ var messages_default3 = {
   "docs.wikiPolicyProject": "\uC6B4\uC601 \uBC29\uCE68 (.gitifact/wiki/README.md)",
   "docs.wikiPolicyDefault": "\uC6B4\uC601 \uBC29\uCE68 (\uAE30\uBCF8\uAC12. .gitifact/wiki/README.md\uAC00 \uC5C6\uC5B4 \uB0B4\uC7A5 \uBC29\uCE68\uC744 \uC2E3\uB294\uB2E4)",
   "init.wikiReadmeTitle": "\uC704\uD0A4 \uC6B4\uC601 \uBC29\uCE68",
-  "help.lang": "\uCD9C\uB825 \uC5B8\uC5B4 (ko \uB610\uB294 en)"
+  "help.lang": "\uCD9C\uB825 \uC5B8\uC5B4 (ko \uB610\uB294 en)",
+  "help.updateCheck": "\uD30C\uC77C\uC744 \uBC14\uAFB8\uC9C0 \uC54A\uACE0 \uC0C8 \uBC84\uC804\uB9CC \uD655\uC778"
 };
 
 // src/shared/i18n/en/messages.json
@@ -25339,7 +25402,7 @@ var messages_default4 = {
   "init.text.blockUpdated": "Block refreshed",
   "init.text.storage": "Storage convention",
   "init.text.agentDocs": "Agent instructions",
-  "init.text.updateAvailable": "Version {version} is available. Install with {command}, then rerun gitifact init to refresh the instruction blocks.",
+  "init.text.updateAvailable": "Version {version} is available. Run {command} to use it and refresh the project instructions.",
   "init.failed": "Initialization failed. Check file permissions and the generated configuration and temporary files.",
   "config.storeNotDirectory": ".gitifact must be a regular directory, not a link.",
   "config.migrateFirst": "This is a .tryce store. Run gitifact migrate to move it to .gitifact.",
@@ -25376,7 +25439,6 @@ var messages_default4 = {
   "docs.summary.design": "Design structure, requirement references, sources and revisions",
   "docs.summary.writing": "Writing style, quotations, alerts and removing filler from documentation",
   "docs.summary.commit": "spec commit input, change reasons and recovery after failure",
-  "help.browserNoUpdateCheck": "Disable the npm update check (also available through GITIFACT_NO_UPDATE_CHECK)",
   "help.updateCommit": "Commit only instruction files changed solely inside the GITIFACT block, using a fixed message",
   "help.update": "Check for updates, show installation instructions and refresh existing GITIFACT blocks",
   "server.changelogNotFound": "Release notes not found.",
@@ -25386,13 +25448,13 @@ var messages_default4 = {
   "update.text.upToDate": "You are using the latest version.",
   "update.text.disabled": "Update checks are disabled.",
   "update.text.unavailable": "Could not check for updates. Check your network connection.",
-  "update.text.install": "For a global npm installation: {command}",
-  "update.text.afterInstall": "After installation, rerun gitifact update --commit to refresh and commit the instruction blocks.",
+  "update.text.install": "Update command: {command}",
+  "update.text.afterInstall": "This command refreshes the instructions with the new version without a global installation. If you manage Gitifact as a project dependency, update that dependency first. Restart the browser with the new version.",
   "update.text.blockRefreshed": "Instruction blocks refreshed: {paths}",
   "update.text.blockCurrent": "Instruction blocks are already current: {paths}",
-  "update.text.noBlock": "No instruction files contain a GITIFACT block. Run gitifact init to install one.",
+  "update.text.noBlock": "No instruction files contain a GITIFACT block. Run npx --yes gitifact@{version} init to install one.",
   "update.text.notInitialized": "Only the version was checked because this project is not initialized.",
-  "update.text.missing": "{paths} is missing, so Claude Code cannot load the AGENTS.md instructions. Rerun gitifact init to create the import file.",
+  "update.text.missing": "{paths} is missing, so Claude Code cannot load the AGENTS.md instructions. Rerun npx --yes gitifact@{version} init to create the import file.",
   "update.text.committed": "Instruction blocks committed: {commit} ({paths})",
   "update.text.commitNothing": "No instruction block changes to commit.",
   "update.text.commitSkipped.untracked": "Not committed. Instruction files are untracked: {paths}",
@@ -25405,7 +25467,8 @@ var messages_default4 = {
   "docs.wikiPolicyProject": "Wiki policy (.gitifact/wiki/README.md)",
   "docs.wikiPolicyDefault": "Default wiki policy (.gitifact/wiki/README.md is missing)",
   "init.wikiReadmeTitle": "Wiki policy",
-  "help.lang": "Output language (ko or en)"
+  "help.lang": "Output language (ko or en)",
+  "help.updateCheck": "Check for a newer version without changing files"
 };
 
 // src/shared/i18n/index.ts
@@ -25504,63 +25567,13 @@ import { readFile as readFile5 } from "node:fs/promises";
 
 // src/server/status-session.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-
-// src/shared/update-check.ts
-var updateCheckTimeoutMs = 3e3;
-var release2 = /^(\d+)\.(\d+)\.(\d+)$/;
-var running = /^(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?$/;
-function isNewerRelease(latest, current2) {
-  const next = release2.exec(latest);
-  const now = running.exec(current2);
-  if (!next || !now) return false;
-  for (let index = 1; index <= 3; index++) {
-    const difference = Number(next[index]) - Number(now[index]);
-    if (difference !== 0) return difference > 0;
-  }
-  return now[4] !== void 0;
-}
-var updateCheckDisabled = (env, flagged = false) => flagged || env.GITIFACT_NO_UPDATE_CHECK !== void 0 && env.GITIFACT_NO_UPDATE_CHECK !== "" && env.GITIFACT_NO_UPDATE_CHECK !== "0";
-var checkingUpdate = { status: "checking", latestVersion: null };
-var disabledUpdate = { status: "disabled", latestVersion: null };
-async function resolveUpdate(current2, fetchLatest, signal, timeoutMs = updateCheckTimeoutMs) {
-  const controller = new AbortController();
-  const abort = () => controller.abort();
-  const timer = setTimeout(abort, timeoutMs);
-  signal?.addEventListener("abort", abort, { once: true });
-  if (signal?.aborted) controller.abort();
-  try {
-    const latest = await Promise.race([
-      fetchLatest(controller.signal),
-      new Promise((_resolve, reject) => {
-        if (controller.signal.aborted) reject(new Error("aborted"));
-        else controller.signal.addEventListener("abort", () => reject(new Error("aborted")), { once: true });
-      })
-    ]);
-    if (typeof latest !== "string" || !release2.test(latest)) return { status: "unavailable", latestVersion: null };
-    return { status: isNewerRelease(latest, current2) ? "available" : "up-to-date", latestVersion: latest };
-  } catch {
-    return { status: "unavailable", latestVersion: null };
-  } finally {
-    clearTimeout(timer);
-    signal?.removeEventListener("abort", abort);
-  }
-}
-var npmGlobalInstall = (version2) => "npm install -g gitifact@" + version2;
-
-// src/server/status-session.ts
 function createStatusSession(initial, read, cliVersion = "0.0.0") {
   const identity2 = { sessionId: randomUUID2(), repository: { key: initial.repository.key, worktreeKey: initial.repository.worktreeKey } };
-  let update = disabledUpdate;
+  const session = browserSessionV3.parse({ contract: "browser-session", version: 3, ...identity2, cliVersion });
   let latest = initial;
   let pending;
   return {
-    // The identity never changes; only the update state moves (checking → a final state), so the session is built per read.
-    get session() {
-      return browserSessionV2.parse({ contract: "browser-session", version: 2, ...identity2, cliVersion, update });
-    },
-    setUpdate(next) {
-      update = next;
-    },
+    session,
     get latest() {
       return latest;
     },
@@ -26335,6 +26348,56 @@ function createCheckoutReader(root, sessionId, inherited = process.env) {
   };
 }
 
+// src/server/history/merge-records.ts
+function remergeRecords(patch) {
+  const touched = /* @__PURE__ */ new Set();
+  for (const file2 of patch.split(/^diff --git /m).slice(1)) {
+    const lines = file2.split("\n");
+    const oldPath = lines.find((l) => l.startsWith("--- "))?.slice(4);
+    const newPath = lines.find((l) => l.startsWith("+++ "))?.slice(4);
+    if (!oldPath && !newPath) continue;
+    const path3 = (newPath === "/dev/null" ? oldPath : newPath)?.replace(/^[ab]\//, "");
+    if (!path3 || !recordPathPattern.test(path3) || !path3.endsWith(".md")) continue;
+    const start = lines.findIndex((l) => l.startsWith("@@ "));
+    if (start < 0 || !/^@@ -[01](?:,\d+)? \+[01](?:,\d+)? @@/.test(lines[start])) throw new SpecPreviewError(t2("specReader.historyUnreadable"));
+    for (const side of ["-", "+"]) {
+      const content = [];
+      for (const line of lines.slice(start + 1)) {
+        if (line.startsWith("@@ ")) throw new SpecPreviewError(t2("specReader.historyUnreadable"));
+        if (line.startsWith(" ") || line.startsWith(side)) content.push({ text: line.slice(1).replace(/\r$/, ""), changed: line.startsWith(side) });
+      }
+      if (!path3.endsWith("/requirements.md")) {
+        const source2 = content.map((l) => l.text).join("\n");
+        const id = /^(?:id: "?|<!-- (?:gitifact|tryce)-(?:design|product|guide): )([SWPG]-[a-z2-7]{10})(?:"?$| -->$)/m.exec(source2)?.[1];
+        if (id && content.some((l) => l.changed)) touched.add(id);
+        continue;
+      }
+      let section = [];
+      let fence;
+      const finish = () => {
+        if (!section[0]?.text.startsWith("## ")) return;
+        const id = section.map((l) => /^<!-- (?:gitifact|tryce)-req: (R-[a-z2-7]{10}) -->$/.exec(l.text)?.[1]).find(Boolean);
+        if (id && section.some((l) => l.changed)) touched.add(id);
+      };
+      for (const line of content) {
+        if (!fence && /^## /.test(line.text)) {
+          finish();
+          section = [];
+        }
+        section.push(line);
+        if (fence) {
+          if (new RegExp(`^ {0,3}${fence.char}{${fence.size},}\\s*$`).test(line.text)) fence = void 0;
+        } else {
+          const match = /^ {0,3}(`{3,}|~{3,})/.exec(line.text);
+          if (match) fence = { char: match[1][0], size: match[1].length };
+        }
+      }
+      finish();
+    }
+  }
+  return touched;
+}
+
 // src/server/history/commit-changes.ts
 var HISTORY_PATHSPECS = [
   ...STORE_DIRS.flatMap((d) => [`:(glob)${d}/spec/*/requirements.md`, `:(glob)${d}/spec/*/design.md`, `:(glob)${d}/spec/*/history.jsonl`]),
@@ -26362,7 +26425,7 @@ function createCommitChanges(root, snapshot3) {
         if (!oldBlob || !newBlob || path3 === void 0) throw new SpecPreviewError(t2("specReader.historyUnreadable"));
         if (recordPathPattern.test(path3) || isLegacy(path3)) entries.push({ oldBlob, newBlob, path: path3 });
       }
-      return { commit, parent: parents.split(" ")[0] || void 0, author, email: email3, date: date5, committer, message, entries };
+      return { commit, parent: parents.split(" ")[0] || void 0, parents: parents.split(" ").filter(Boolean), author, email: email3, date: date5, committer, message, entries };
     });
   }
   function wanted(entries) {
@@ -26433,9 +26496,56 @@ function createCommitChanges(root, snapshot3) {
     }
     return { commit: c.commit, events: eventsOf(c, comparePreviewBundles(before, after).changes), boundary };
   }
+  async function merge2(c) {
+    let touched;
+    if (c.parents.length === 2) {
+      const patch = reader.decode(await reader.run([
+        "-c",
+        "merge.conflictStyle=merge",
+        "show",
+        "--remerge-diff",
+        "--format=",
+        "--no-color",
+        "--no-ext-diff",
+        "--no-textconv",
+        "--no-renames",
+        "--src-prefix=a/",
+        "--dst-prefix=b/",
+        "--unified=1048576",
+        c.commit,
+        "--",
+        ...HISTORY_PATHSPECS
+      ]));
+      touched = remergeRecords(patch);
+      if (!touched.size) return { commit: c.commit, events: [], boundary: false };
+    }
+    const after = await snapshot3(c.commit);
+    let boundary = false;
+    const parents = [];
+    for (const parent of c.parents) {
+      try {
+        parents.push(await snapshot3(parent));
+      } catch (error62) {
+        if (error62 instanceof LegacyBaselineError) {
+          parents.push(emptyBundle());
+          boundary = true;
+        } else throw error62;
+      }
+    }
+    const withoutReasons = (b) => ({ specs: b.specs.map((s) => ({ ...s, history: [] })), wiki: { ...b.wiki, history: [] } });
+    const differences = parents.map((p) => comparePreviewBundles(withoutReasons(p), withoutReasons(after)).changes);
+    const reasons = (b) => [...b.specs.flatMap((s) => s.history), ...b.wiki.history];
+    const inherited = new Set(parents.flatMap((p) => reasons(p).map((r) => r.id)));
+    const added = reasons(after).filter((r) => !inherited.has(r.id));
+    const selected = differences[0].filter((change2) => touched ? touched.has(change2.id) : differences.every((d) => d.some((v) => v.id === change2.id)));
+    return { commit: c.commit, events: eventsOf(c, selected.map((change2) => ({
+      ...change2,
+      reasons: added.filter((r) => [...r.requirements, ...r.designs ?? [], ...r.documents ?? []].includes(change2.id))
+    }))), boundary };
+  }
   async function batch(commits) {
     const names = /* @__PURE__ */ new Map();
-    for (const c of commits.filter((c2) => !c2.entries.some((e) => isLegacy(e.path) && !isZero(e.newBlob)))) {
+    for (const c of commits.filter((c2) => c2.parents.length < 2 && !c2.entries.some((e) => isLegacy(e.path) && !isZero(e.newBlob)))) {
       const files = wanted(c.entries);
       const boundary = c.entries.some((e) => isLegacy(e.path) && !isZero(e.oldBlob));
       names.set(c, { after: files.map((f) => c.commit + ":" + f), before: c.parent && !boundary ? files.map((f) => c.parent + ":" + f) : [], boundary });
@@ -26448,6 +26558,10 @@ function createCommitChanges(root, snapshot3) {
     }
     const result = [];
     for (const c of commits) {
+      if (c.parents.length > 1) {
+        result.push(await merge2(c));
+        continue;
+      }
       let value;
       const want = names.get(c);
       if (want && blobs) {
@@ -26465,12 +26579,12 @@ function createCommitChanges(root, snapshot3) {
     return result;
   }
   return {
-    /** The commits of `head`'s first-parent history that touched records, newest first. One Git process. */
+    /** All reachable record commits, children before parents even when author clocks differ. */
     async lineage(head) {
-      const text2 = reader.decode(await reader.run(["rev-list", "--first-parent", head, "--", ...HISTORY_PATHSPECS]));
+      const text2 = reader.decode(await reader.run(["rev-list", "--full-history", "--date-order", head, "--", ...HISTORY_PATHSPECS]));
       return text2.split("\n").filter(Boolean);
     },
-    /** The changes of the given commits, in the given order; two Git processes per hundred commits. */
+    /** Changes in the given order; ordinary commits are batched, merges also read their resolution diff. */
     async of(commits) {
       const out = [];
       for (let i = 0; i < commits.length; i += BATCH) {
@@ -26493,7 +26607,7 @@ function createCommitChanges(root, snapshot3) {
 import { DatabaseSync } from "node:sqlite";
 import { mkdir as mkdir3, rm } from "node:fs/promises";
 import { join as join5 } from "node:path";
-var INDEX_FORMAT = 1;
+var INDEX_FORMAT = 2;
 var SCHEMA = `
   -- Commits already read, and whether the commit's parent was legacy JSON the history does not read past.
   CREATE TABLE commits (oid TEXT PRIMARY KEY, boundary INTEGER NOT NULL);
@@ -26503,7 +26617,7 @@ var SCHEMA = `
     id TEXT NOT NULL, kind TEXT NOT NULL, types TEXT NOT NULL, email TEXT NOT NULL, date TEXT NOT NULL,
     before_spec TEXT, after_spec TEXT, needle TEXT NOT NULL, row TEXT NOT NULL, detail TEXT NOT NULL);
   CREATE INDEX changes_by_commit ON changes (oid, ord);
-  -- The commits of one HEAD's first-parent history that touched records, newest first (pos 0).
+  -- All reachable record commits of one HEAD, children before parents (pos 0 is newest).
   CREATE TABLE lineage (head TEXT NOT NULL, pos INTEGER NOT NULL, oid TEXT NOT NULL, PRIMARY KEY (head, pos));
   CREATE INDEX lineage_by_commit ON lineage (head, oid);
   CREATE TABLE heads (head TEXT PRIMARY KEY, seen INTEGER NOT NULL);
@@ -26943,7 +27057,6 @@ async function startBrowserServer(options) {
     ...recordRoutes(root, sessionId, options.env),
     ...assetRoutes(root)
   ];
-  let updatePending;
   let closing = false;
   let origin = "";
   const server = createServer({ requestTimeout: 5e3, headersTimeout: 5e3, maxHeaderSize: 8192 }, (request, response) => {
@@ -26980,12 +27093,6 @@ async function startBrowserServer(options) {
   const address = server.address();
   if (!address || typeof address === "string") throw new Error(t2("server.addressUnknown"));
   origin = "http://127.0.0.1:" + address.port;
-  if (options.fetchLatest) {
-    store.setUpdate(checkingUpdate);
-    updatePending = resolveUpdate(store.session.cliVersion, options.fetchLatest, controller.signal, options.updateCheckTimeoutMs).then((state) => {
-      store.setUpdate(state);
-    });
-  }
   let resolveClosed;
   const closed = new Promise((resolve) => {
     resolveClosed = resolve;
@@ -27001,7 +27108,6 @@ async function startBrowserServer(options) {
         server.closeAllConnections();
       });
       await store.pending;
-      await updatePending;
       options.signal?.removeEventListener("abort", onAbort);
       options.signal?.removeEventListener("abort", closeOnAbort);
       resolveClosed();
@@ -27018,17 +27124,6 @@ async function startBrowserServer(options) {
   }, close, closed };
 }
 
-// src/adapters/registry/latest-version.ts
-var manifestUrl = "https://registry.npmjs.org/gitifact";
-var fetchLatestVersion = async (signal) => {
-  const response = await fetch(manifestUrl, { signal, redirect: "error", headers: { Accept: "application/vnd.npm.install-v1+json" } });
-  if (!response.ok) throw new Error("registry status " + response.status);
-  const manifest = await response.json();
-  const latest = manifest["dist-tags"]?.latest;
-  if (typeof latest !== "string") throw new Error("registry answer has no latest tag");
-  return latest;
-};
-
 // src/commands/browser.ts
 function parsePort(value) {
   if (!/^\d+$/.test(value) || Number(value) > 65535) throw new InvalidArgumentError(t2("browser.invalidPort"));
@@ -27045,9 +27140,7 @@ async function runBrowser(options, version2) {
       port: options.port,
       dev: options.dev ?? false,
       signal: controller.signal,
-      cliVersion: version2,
-      // --no-update-check or GITIFACT_NO_UPDATE_CHECK keeps the server from contacting the npm registry.
-      ...updateCheckDisabled(process.env, options.updateCheck === false) ? {} : { fetchLatest: fetchLatestVersion }
+      cliVersion: version2
     });
     if (!controller.signal.aborted) process.stdout.write(server.url + "/\n");
     await server.closed;
@@ -27417,6 +27510,48 @@ async function applyAgentDocs(root, plan, recheck) {
   return plan.writes.map((write) => write.path);
 }
 
+// src/shared/update-check.ts
+var updateCheckTimeoutMs = 3e3;
+var release2 = /^(\d+)\.(\d+)\.(\d+)$/;
+var running = /^(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?$/;
+function isNewerRelease(latest, current2) {
+  const next = release2.exec(latest);
+  const now = running.exec(current2);
+  if (!next || !now) return false;
+  for (let index = 1; index <= 3; index++) {
+    const difference = Number(next[index]) - Number(now[index]);
+    if (difference !== 0) return difference > 0;
+  }
+  return now[4] !== void 0;
+}
+var updateCheckDisabled = (env, flagged = false) => flagged || env.GITIFACT_NO_UPDATE_CHECK !== void 0 && env.GITIFACT_NO_UPDATE_CHECK !== "" && env.GITIFACT_NO_UPDATE_CHECK !== "0";
+var disabledUpdate = { status: "disabled", latestVersion: null };
+async function resolveUpdate(current2, fetchLatest, signal, timeoutMs = updateCheckTimeoutMs) {
+  const controller = new AbortController();
+  const abort = () => controller.abort();
+  const timer = setTimeout(abort, timeoutMs);
+  signal?.addEventListener("abort", abort, { once: true });
+  if (signal?.aborted) controller.abort();
+  try {
+    const latest = await Promise.race([
+      fetchLatest(controller.signal),
+      new Promise((_resolve, reject) => {
+        if (controller.signal.aborted) reject(new Error("aborted"));
+        else controller.signal.addEventListener("abort", () => reject(new Error("aborted")), { once: true });
+      })
+    ]);
+    if (typeof latest !== "string" || !release2.test(latest)) return { status: "unavailable", latestVersion: null };
+    return { status: isNewerRelease(latest, current2) ? "available" : "up-to-date", latestVersion: latest };
+  } catch {
+    return { status: "unavailable", latestVersion: null };
+  } finally {
+    clearTimeout(timer);
+    signal?.removeEventListener("abort", abort);
+  }
+}
+var npmGlobalInstall = (version2) => "npm install -g gitifact@" + version2;
+var npxUpdate = (version2) => "npx --yes gitifact@" + version2 + " update";
+
 // src/commands/spec-init.ts
 async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs, readDoc = (name) => readBundledDoc(name, getLanguage()), update = disabledUpdate) {
   const repo = initRepository(cwd, env);
@@ -27425,9 +27560,9 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   const docsPlan = agentDocs ? await planAgentDocs(root, agentDocs) : skippedAgentDocs;
   const result = async (config3, outcome) => {
     const checked = await update;
-    return projectInitV5.parse({
+    return projectInitV6.parse({
       contract: "project-init",
-      version: 5,
+      version: 6,
       ok: true,
       outcome,
       rootPath: root,
@@ -27436,7 +27571,7 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
       baseline: config3.baseline,
       agentDocs: { mode: docsPlan.mode, paths: docsPlan.paths },
       update: checked,
-      install: checked.status === "available" ? { npmGlobal: npmGlobalInstall(checked.latestVersion) } : null
+      install: checked.status === "available" ? { npx: npxUpdate(checked.latestVersion), npmGlobal: npmGlobalInstall(checked.latestVersion) } : null
     });
   };
   const existing = async (text3) => {
@@ -27537,6 +27672,17 @@ async function writeWikiPolicy(root, readDoc) {
   await writeFile2(join10(root, ...WIKI_ENTRY_PATH.split("/")), text2, { flag: "wx" });
 }
 
+// src/adapters/registry/latest-version.ts
+var manifestUrl = "https://registry.npmjs.org/gitifact";
+var fetchLatestVersion = async (signal) => {
+  const response = await fetch(manifestUrl, { signal, redirect: "error", headers: { Accept: "application/vnd.npm.install-v1+json" } });
+  if (!response.ok) throw new Error("registry status " + response.status);
+  const manifest = await response.json();
+  const latest = manifest["dist-tags"]?.latest;
+  if (typeof latest !== "string") throw new Error("registry answer has no latest tag");
+  return latest;
+};
+
 // src/commands/init.ts
 async function runInit(options, version2) {
   const cancel = new AbortController();
@@ -27553,7 +27699,7 @@ async function runInit(options, version2) {
     );
     if (!dto.ok) throw new Error("unreachable");
     const docs = dto.agentDocs.mode === "skip" ? t2("init.text.skipped") : dto.agentDocs.paths.join(", ") + (dto.agentDocs.mode === "remove" ? " (" + t2("init.text.blockRemoved") + ")" : dto.outcome === "planned" ? " (" + t2("init.text.blockPlanned") + ")" : " (" + t2("init.text.blockUpdated") + ")");
-    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npmGlobal }) + "\n" : "";
+    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npx }) + "\n" : "";
     process.stdout.write(options.format === "text" ? `${dto.outcome}: ${dto.rootPath}/.gitifact/config.json
 ${t2("init.text.storage")}: schemaVersion ${dto.schemaVersion}
 ${t2("init.text.agentDocs")}: ${docs}
@@ -27562,7 +27708,7 @@ ${newer}` : JSON.stringify(dto) + "\n");
     cancel.abort();
     const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
     const failure2 = { code: known ? error62.code : "INIT_FAILED", message: known ? error62.message : t2("init.failed") };
-    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(projectInitV5.parse({ contract: "project-init", version: 5, ok: false, error: failure2 })) + "\n");
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(projectInitV6.parse({ contract: "project-init", version: 6, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
@@ -27667,13 +27813,13 @@ async function updateCommand(cwd, version2, env = process.env, controls = {}) {
     refreshBlocks(cwd, version2, env, controls)
   ]);
   const commit = controls.commit ? await commitBlocks(agentDocs, version2, env) : commitState("not-requested");
-  return updateV3.parse({
+  return updateV4.parse({
     contract: "update",
-    version: 3,
+    version: 4,
     ok: true,
     cliVersion: version2,
     update,
-    install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
+    install: update.status === "available" ? { npx: npxUpdate(update.latestVersion), npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
     agentDocs: { state: agentDocs.state, paths: agentDocs.paths, missing: agentDocs.missing },
     commit
   });
@@ -27688,9 +27834,9 @@ async function runUpdate(options, version2) {
     }
     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 === "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.install) lines.push(t2("update.text.install", { command: dto.install.npx }), 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 === "no-block" ? t2("update.text.noBlock", { version: dto.cliVersion }) : t2("update.text.notInitialized"));
+    if (dto.agentDocs.missing.length) lines.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", "), 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"));
@@ -27703,11 +27849,38 @@ async function runUpdate(options, version2) {
   } 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") };
-    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV3.parse({ contract: "update", version: 3, ok: false, error: failure2 })) + "\n");
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV4.parse({ contract: "update", version: 4, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
 
+// src/commands/update-check.ts
+async function checkUpdateCommand(version2, env = process.env, controls = {}) {
+  const update = updateCheckDisabled(env) ? disabledUpdate : await resolveUpdate(version2, controls.fetchLatest ?? fetchLatestVersion, void 0, controls.timeoutMs);
+  return updateCheckV1.parse({
+    contract: "update-check",
+    version: 1,
+    ok: true,
+    cliVersion: version2,
+    update,
+    command: update.status === "available" ? npxUpdate(update.latestVersion) : null
+  });
+}
+async function runUpdateCheck(format, version2) {
+  const dto = await checkUpdateCommand(version2);
+  if (format === "json") {
+    process.stdout.write(JSON.stringify(dto) + "\n");
+    return;
+  }
+  const state = dto.update;
+  const lines = [
+    t2("update.text.current", { version: dto.cliVersion }),
+    state.status === "available" ? t2("update.text.available", { version: state.latestVersion }) : state.status === "up-to-date" ? t2("update.text.upToDate") : state.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable")
+  ];
+  if (dto.command) lines.push(t2("update.text.install", { command: dto.command }));
+  process.stdout.write(lines.join("\n") + "\n");
+}
+
 // src/commands/spec-preview.ts
 import { join as join15 } from "node:path";
 import { readFile as readFile12, stat as stat2 } from "node:fs/promises";
@@ -28296,16 +28469,16 @@ 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.7.0").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.7.1").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 program2.command("status").description(t2("help.status")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action(async (options) => {
   await runStatus(options.format);
 });
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).option("--no-update-check", t2("help.browserNoUpdateCheck")).action((options) => runBrowser(options, "0.7.0"));
-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.7.0"));
+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.7.1"));
+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.7.1"));
 program2.command("docs").description(t2("help.docs")).argument("[topic]", t2("help.docsTopic")).allowExcessArguments(false).action(async (topic) => {
   await runDocs(topic);
 });
-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")).action((options) => runUpdate(options, "0.7.0"));
+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")).action((options) => options.check ? runUpdateCheck(options.format, "0.7.1") : runUpdate(options, "0.7.1"));
 program2.command("migrate").description(t2("help.migrate")).allowExcessArguments(false).option("--dry-run", t2("help.migrateDryRun")).action(runMigrate);
 var spec = program2.command("spec").description(t2("help.spec"));
 spec.command("commit").description(t2("help.specCommit")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specCommitFile")).option("--dry-run", t2("help.specCommitDryRun")).action((o) => runSpecPreview("commit", o));