gitifact 0.8.2 → 0.8.4

package/dist/main.js

@@ -3407,6 +3407,8 @@ var messages_default = {
   "config.invalidFields": "\uD504\uB85C\uC81D\uD2B8 \uC124\uC815\uC758 \uD544\uB4DC\uB098 \uAC12\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "config.jsonUnreadableShort": "\uC124\uC815 JSON\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "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.",
   "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}",
@@ -3524,6 +3526,8 @@ var messages_default2 = {
   "config.invalidFields": "Invalid project configuration fields or values.",
   "config.jsonUnreadableShort": "Could not read configuration JSON.",
   "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}.",
   "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}",
@@ -3682,6 +3686,8 @@ var InitError = class extends Error {
 };
 var SCHEMA_VERSION = 3;
 var PREVIOUS_SCHEMA_VERSION = 2;
+var PROJECT_LANGUAGES = ["ko", "en"];
+var CLI_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
 var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var keys = (value, expected) => Object.keys(value).sort().join(",") === expected.sort().join(",");
 function parseBaseline(value) {
@@ -3714,7 +3720,7 @@ function parseManagedConfig(text4) {
   }
   if (!object(value) || !("schemaVersion" in value))
     throw new InitError("UNSUPPORTED_FORMAT", t("config.unsupportedFormat"));
-  if (!keys(value, ["baseline", "schemaVersion"]))
+  if (!("baseline" in value))
     throw new InitError("INVALID_CONFIG", t("config.schemaFields"));
   if (value.schemaVersion !== SCHEMA_VERSION) {
     const found = value.schemaVersion;
@@ -3723,7 +3729,35 @@ function parseManagedConfig(text4) {
       throw new InitError("UNSUPPORTED_SCHEMA", t("config.migrationRequired"));
     throw new InitError("UNSUPPORTED_SCHEMA", newer ? t("config.newerSchema", { version: String(found) }) : t("config.unsupportedSchema", { version: String(found) }));
   }
-  return { schemaVersion: SCHEMA_VERSION, baseline: parseBaseline(value.baseline) };
+  const config2 = { schemaVersion: SCHEMA_VERSION, baseline: parseBaseline(value.baseline) };
+  if ("cli" in value) {
+    if (typeof value.cli !== "string" || !CLI_VERSION_PATTERN.test(value.cli))
+      throw new InitError("INVALID_CONFIG", t("config.cliVersion"));
+    config2.cli = value.cli;
+  }
+  if ("language" in value) {
+    if (!PROJECT_LANGUAGES.includes(value.language))
+      throw new InitError("INVALID_CONFIG", t("config.language", { languages: PROJECT_LANGUAGES.join(", ") }));
+    config2.language = value.language;
+  }
+  return config2;
+}
+function formatManagedConfig(config2, previous) {
+  let unknown2 = {};
+  if (previous !== void 0) {
+    const value = JSON.parse(previous);
+    if (object(value)) {
+      const { schemaVersion: _s, baseline: _b, cli: _c, language: _l, ...rest } = value;
+      unknown2 = rest;
+    }
+  }
+  const known = {
+    schemaVersion: config2.schemaVersion,
+    baseline: config2.baseline,
+    ...config2.cli === void 0 ? {} : { cli: config2.cli },
+    ...config2.language === void 0 ? {} : { language: config2.language }
+  };
+  return JSON.stringify({ ...known, ...unknown2 }, null, 2) + "\n";
 }
 
 // ../../packages/core/dist/formats/links.js
@@ -25400,9 +25434,9 @@ var projectInitV8 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(8), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
-// ../../packages/contracts/dist/versions/update-v5.js
+// ../../packages/contracts/dist/versions/update-v6.js
 var commitReason = external_exports.enum(["untracked", "other-changes", "commit-failed"]);
-var agentDocsCommit = external_exports.strictObject({
+var updateCommit = external_exports.strictObject({
   state: external_exports.enum(["not-requested", "nothing", "committed", "skipped"]),
   commit: external_exports.string().nullable(),
   paths: external_exports.array(external_exports.string()),
@@ -25410,27 +25444,40 @@ var agentDocsCommit = external_exports.strictObject({
   reason: commitReason.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 updateV5 = external_exports.discriminatedUnion("ok", [
+var updateV6 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
     contract: external_exports.literal("update"),
-    version: external_exports.literal(5),
+    version: external_exports.literal(6),
     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.
+    // Present only when a newer release exists; after installing it, `gitifact update` sets the project to it.
+    install: external_exports.strictObject({ npmGlobal: external_exports.string().min(1) }).nullable(),
+    // refreshed: blocks whose text differed were rewritten. current: every block already matched. kept: the project is on a
+    // release newer than this CLI, so its blocks were left as they are.
     // 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: agentDocsCommit,
+    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "kept", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()), missing: external_exports.array(external_exports.string()) }),
+    // written: .gitifact/config.json now names this release as `cli` and the block language. current: it already did.
+    // cli is the project's release afterwards; one newer than cliVersion was kept, since an older CLI does not lower it.
+    project: external_exports.strictObject({ state: external_exports.enum(["written", "current", "not-initialized"]), cli: external_exports.string().min(1).nullable() }),
+    commit: updateCommit,
     // The project still uses the 0.7 storage convention (schemaVersion 2): the blocks now describe commands that will refuse it
     // until the documents are moved with `gitifact guide show migrate`.
     migrationRequired: external_exports.boolean()
   }),
-  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(5), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+  external_exports.strictObject({ contract: external_exports.literal("update"), 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-later-v1.js
+var updateLaterV1 = external_exports.strictObject({
+  contract: external_exports.literal("update-later"),
+  version: external_exports.literal(1),
+  ok: external_exports.literal(true),
+  cliVersion: external_exports.string().min(1),
+  later: external_exports.strictObject({ version: external_exports.string().min(1), until: external_exports.iso.datetime() }).nullable()
+});
+
 // ../../packages/contracts/dist/versions/browser-session-v3.js
 var browserSessionV3 = external_exports.strictObject({
   contract: external_exports.literal("browser-session"),
@@ -25631,7 +25678,7 @@ var messages_default3 = {
   "init.text.storage": "\uC800\uC7A5 \uADDC\uC57D",
   "init.text.agentDocs": "\uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68",
   "init.text.lineEndings": "\uC904\uBC14\uAFC8: {path}\uB85C \uBB38\uC11C\uB97C LF\uB85C \uACE0\uC815\uD588\uC2B5\uB2C8\uB2E4. \uC774\uBBF8 \uC788\uB358 \uBB38\uC11C\uAC00 \uBCC0\uACBD\uC73C\uB85C \uBCF4\uC774\uBA74 \uC904\uBC14\uAFC8\uB9CC \uBC14\uB010 \uAC83\uC774\uB2C8 \uADF8 \uBB38\uC11C\uB4E4\uC744 \uD55C \uBC88 \uCEE4\uBC0B\uD574 \uC815\uB9AC\uD558\uC138\uC694.",
-  "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.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC124\uCE58\uD55C \uB4A4 gitifact update\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uC0C8 \uBC84\uC804\uC5D0 \uB9DE\uCD94\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.fileShape": "config.json\uC740 64 KiB \uC774\uD558\uC758 \uC77C\uBC18 \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
@@ -25666,13 +25713,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": "\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.install": "\uC124\uCE58 \uBA85\uB839: {command}",
+  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uACFC \uC9C0\uCE68\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uBC14\uB01D\uB2C8\uB2E4. \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. npx --yes gitifact@{version} 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. gitifact 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. 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.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.migrationRequired": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBB38\uC11C\uB294 \uC544\uC9C1 0.7 \uC800\uC7A5 \uADDC\uC57D(schemaVersion 2)\uC785\uB2C8\uB2E4. \uC9C0\uCE68 \uBE14\uB85D\uC740 \uC0C8 \uBA85\uB839\uC744 \uC548\uB0B4\uD558\uC9C0\uB9CC \uC804\uD658 \uC804\uC5D0\uB294 specs\xB7instructions\xB7records\xB7check\xB7changes \uBA85\uB839\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. npx --yes gitifact@{version} guide show migrate\uC758 \uC808\uCC28\uB85C \uBB38\uC11C\uB97C \uC804\uD658\uD558\uC138\uC694.",
   "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.",
@@ -25684,7 +25731,7 @@ var messages_default3 = {
   "server.assetNotFound": "\uC5D0\uC14B\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "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",
-  "commitFiles.notRecord": ".gitifact \uC548\uC5D0\uC11C\uB294 \uAE30\uB85D\xB7\uC124\uC815\xB7\uC5D0\uC14B\uB9CC \uCEE4\uBC0B\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4: {path}",
+  "commitFiles.notRecord": ".gitifact \uC548\uC5D0\uC11C\uB294 \uAE30\uB85D\xB7\uC124\uC815(config.json\xB7.gitattributes)\xB7\uC5D0\uC14B\uB9CC \uCEE4\uBC0B\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4: {path}",
   "help.changes": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC740 \uBB38\uC11C \uBCC0\uACBD \uC870\uD68C\uC640 \uCEE4\uBC0B",
   "help.changesList": "HEAD \uB300\uBE44 \uBC14\uB010 \uBB38\uC11C, \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC740 \uACB0\uC815\uAE30\uB85D, \uAE30\uB85D\uC774 \uC5C6\uB294 \uBCC0\uACBD, \uCEE4\uBC0B \uC785\uB825 \uD30C\uC77C \uACBD\uB85C",
   "help.changesCommit": "check\uC640 \uAC19\uC740 \uAC80\uC0AC \uB4A4 \uC120\uD0DD\uD55C \uD30C\uC77C\uACFC \uACB0\uC815\uAE30\uB85D\uC744 \uCEE4\uBC0B",
@@ -25837,7 +25884,16 @@ var messages_default3 = {
   "feedback.openUrl": "gh\uB97C \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC8FC\uC18C\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC5F4\uC5B4 \uC774\uC288\uB97C \uC81C\uCD9C\uD558\uC138\uC694.",
   "feedback.ghFailed": "gh\uB85C \uC774\uC288\uB97C \uB9CC\uB4E4\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC8FC\uC18C\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC5F4\uC5B4 \uC774\uC288\uB97C \uC81C\uCD9C\uD558\uC138\uC694.",
   "feedback.truncated": "\uBCF8\uBB38\uC774 \uAE38\uC5B4 \uC8FC\uC18C\uC5D0\uB294 \uC55E\uBD80\uBD84\uB9CC \uB2F4\uACBC\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC804\uCCB4 \uBCF8\uBB38\uC744 \uC791\uC131 \uD398\uC774\uC9C0\uC5D0 \uBD99\uC5EC \uB123\uC73C\uC138\uC694.",
-  "feedback.title": "\uC81C\uBAA9: {title}"
+  "feedback.title": "\uC81C\uBAA9: {title}",
+  "update.text.projectWritten": "{path}\uC758 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC744 gitifact {version}\uC73C\uB85C \uC801\uC5C8\uC2B5\uB2C8\uB2E4.",
+  "update.text.projectAhead": "\uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC740 gitifact {project}\uC785\uB2C8\uB2E4. \uC774 CLI({version})\uAC00 \uB354 \uC624\uB798\uB418\uC5B4 \uB0AE\uCD94\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC62C\uB9AC\uC138\uC694.",
+  "update.later.postponed": "{latest} \uC548\uB0B4\uB97C {until}\uAE4C\uC9C0 \uC27D\uB2C8\uB2E4. \uB354 \uC0C8 \uBC84\uC804\uC774 \uB098\uC624\uBA74 \uBC14\uB85C \uB2E4\uC2DC \uC548\uB0B4\uD569\uB2C8\uB2E4.",
+  "update.later.nothing": "\uBBF8\uB8F0 \uC0C8 \uBC84\uC804 \uC548\uB0B4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}).",
+  "notice.release": "\uC0C8 \uBC84\uC804 {latest}\uAC00 \uC788\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}). \uC5C5\uB370\uC774\uD2B8: {command} \uD6C4 gitifact update \xB7 \uB098\uC911\uC5D0: gitifact update --later",
+  "notice.projectNewer": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 gitifact {project} \uAE30\uC900\uC785\uB2C8\uB2E4(\uC2E4\uD589 \uC911 {version}). {command}\uB85C \uC62C\uB9AC\uC138\uC694.",
+  "notice.projectOlder": "\uC774 CLI({version})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900({project})\uBCF4\uB2E4 \uC0C8 \uBC84\uC804\uC785\uB2C8\uB2E4. gitifact update\uB85C \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC744 \uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
+  "help.updateLater": "\uC9C0\uAE08 \uC548\uB0B4\uB41C \uC0C8 \uBC84\uC804\uC744 24\uC2DC\uAC04 \uB3D9\uC548 \uC548\uB0B4\uD558\uC9C0 \uC54A\uC74C. \uB354 \uC0C8 \uBC84\uC804\uC740 \uBC14\uB85C \uC548\uB0B4",
+  "update.text.blockKept": "\uD504\uB85C\uC81D\uD2B8\uAC00 \uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804 \uAE30\uC900\uC774\uB77C \uC9C0\uCE68 \uBE14\uB85D\uC744 \uADF8\uB300\uB85C \uB450\uC5C8\uC2B5\uB2C8\uB2E4: {paths}"
 };
 
 // src/shared/i18n/en/messages.json
@@ -25936,7 +25992,7 @@ var messages_default4 = {
   "init.text.storage": "Storage convention",
   "init.text.agentDocs": "Agent instructions",
   "init.text.lineEndings": "Line endings: {path} keeps documents in LF. Documents that now show as changed differ only in line endings; commit them once to settle it.",
-  "init.text.updateAvailable": "Version {version} is available. Run {command} to use it and refresh the project instructions.",
+  "init.text.updateAvailable": "Version {version} is available. Install it with {command}, then run gitifact update to move the project to it.",
   "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.fileShape": "config.json must be a regular file no larger than 64 KiB.",
@@ -25971,13 +26027,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": "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.install": "Install command: {command}",
+  "update.text.afterInstall": "After installing, run gitifact update again to move the project and its instructions to the new version. Restart the browser with the new version too.",
   "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 npx --yes gitifact@{version} init to install one.",
+  "update.text.noBlock": "No instruction files contain a GITIFACT block. Run gitifact 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 npx --yes gitifact@{version} init to create the import file.",
+  "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.migrationRequired": "This project's documents still use the 0.7 storage convention (schemaVersion 2). The blocks describe the new commands, but the specs, instructions, records, check and changes commands refuse to run until the documents are moved. Follow npx --yes gitifact@{version} guide show migrate to move them.",
   "update.text.committed": "Instruction blocks committed: {commit} ({paths})",
   "update.text.commitNothing": "No instruction block changes to commit.",
@@ -25989,7 +26045,7 @@ var messages_default4 = {
   "server.assetNotFound": "Asset not found.",
   "help.lang": "Output language (ko or en)",
   "help.updateCheck": "Check for a newer version without changing files",
-  "commitFiles.notRecord": "Inside .gitifact only records, the configuration and assets can be committed: {path}",
+  "commitFiles.notRecord": "Inside .gitifact only records, the configuration (config.json, .gitattributes) and assets can be committed: {path}",
   "help.changes": "Inspect and commit uncommitted document changes",
   "help.changesList": "Documents changed since HEAD, uncommitted records, changes without a record, and the commit input path",
   "help.changesCommit": "Check like the check command, then commit the selected files and records",
@@ -26142,7 +26198,16 @@ var messages_default4 = {
   "feedback.openUrl": "gh is not available. Open the address below in a browser and submit the issue.",
   "feedback.ghFailed": "gh could not create the issue. Open the address below in a browser and submit the issue.",
   "feedback.truncated": "The body is long, so the address holds only its beginning. Paste the full body below into the page.",
-  "feedback.title": "Title: {title}"
+  "feedback.title": "Title: {title}",
+  "update.text.projectWritten": "Set the project to gitifact {version} in {path}.",
+  "update.text.projectAhead": "The project is set to gitifact {project}. This CLI ({version}) is older, so it was not lowered. Install it with {command}.",
+  "update.later.postponed": "The notice for {latest} is quiet until {until}. A newer release is announced right away.",
+  "update.later.nothing": "No newer release to postpone (running {version}).",
+  "notice.release": "Version {latest} is available (running {version}). Update: {command}, then gitifact update \xB7 Later: gitifact update --later",
+  "notice.projectNewer": "This project is set to gitifact {project} (running {version}). Install it with {command}.",
+  "notice.projectOlder": "This CLI ({version}) is newer than the project ({project}). Run gitifact update to move the project to it.",
+  "help.updateLater": "Quiet the announced newer release for 24 hours; a release newer than it is announced right away",
+  "update.text.blockKept": "The project is set to a newer release than this CLI, so the instruction blocks were left as they are: {paths}"
 };
 
 // src/shared/i18n/index.ts
@@ -28982,15 +29047,15 @@ function boilerplateFor(path3) {
   return "# " + name2 + "\n\nProject-specific guidance for AI coding agents.\n";
 }
 var readBundledBlock = (lang) => readFile12(new URL("./i18n/" + lang + "/block.md", import.meta.url), "utf8");
-async function renderAgentBlock(version2, controls = {}, lang = getLanguage()) {
+async function renderAgentBlock(controls = {}, lang = getLanguage()) {
   const body2 = await (controls.readBlock ?? readBundledBlock)(lang);
-  const filled = body2.trimEnd().replace(/\{(version|language|topics)\}/g, (_whole, name2) => name2 === "version" ? version2 : name2 === "language" ? lang : guideTopics.join(", "));
-  return AGENT_START + "\n" + filled + "\n" + AGENT_END;
+  return AGENT_START + "\n" + body2.trimEnd().replace(/\{topics\}/g, guideTopics.join(", ")) + "\n" + AGENT_END;
 }
-function parseAgentBlock(text4) {
-  const match = /^gitifact v(\S+)(?: · ([a-z][a-z-]*))? · .*schemaVersion (\d+)$/m.exec(text4);
-  if (!match) return null;
-  return { version: match[1], language: match[2] ?? "ko", schemaVersion: Number(match[3]) };
+function legacyBlockLanguage(text4) {
+  const match = /^gitifact v\S+(?: · ([a-z][a-z-]*))? · .*schemaVersion \d+$/m.exec(text4);
+  if (!match) return void 0;
+  const language = match[1] ?? "ko";
+  return language === "ko" || language === "en" ? language : void 0;
 }
 function findBlock(text4) {
   const start = text4.indexOf(AGENT_START);
@@ -29052,14 +29117,26 @@ function removeBlock(text4, boilerplate) {
 }
 
 // src/commands/agent-docs.ts
-var skippedAgentDocs = { mode: "skip", paths: [], writes: [], missing: [] };
+var skippedAgentDocs = (language = explicitLanguage() ?? getLanguage()) => ({ mode: "skip", paths: [], writes: [], missing: [], language });
+var blockOf = (text4) => {
+  try {
+    const found = findBlock(text4);
+    return found ? text4.slice(found.start, found.end) : void 0;
+  } catch {
+    return void 0;
+  }
+};
 async function planAgentDocs(root, options) {
-  if (options.skip) return skippedAgentDocs;
+  if (options.skip) return skippedAgentDocs(explicitLanguage() ?? options.language ?? getLanguage());
   const existing = /* @__PURE__ */ new Map();
   for (const path3 of candidatePaths) {
     const text4 = await managedRead(root, path3);
     if (text4 !== null) existing.set(path3, text4);
   }
+  const language = explicitLanguage() ?? options.language ?? [...existing.values()].map((text4) => {
+    const block2 = blockOf(text4);
+    return block2 === void 0 ? void 0 : legacyBlockLanguage(block2);
+  }).find(Boolean) ?? getLanguage();
   const writes = [];
   const paths2 = [];
   if (options.remove) {
@@ -29075,19 +29152,14 @@ async function planAgentDocs(root, options) {
       paths2.push(CLAUDE_WRAPPER_PATH);
       writes.push({ path: CLAUDE_WRAPPER_PATH, previous: wrapper, next: null });
     }
-    return { mode: "remove", paths: paths2, writes, missing: [] };
+    return { mode: "remove", paths: paths2, writes, missing: [], language };
   }
-  const blocks = /* @__PURE__ */ new Map();
-  const blockFor = async (previous) => {
-    const stored = previous ? parseAgentBlock(previous)?.language : void 0;
-    const language = explicitLanguage() ?? (stored === "ko" || stored === "en" ? stored : getLanguage());
-    if (!blocks.has(language)) blocks.set(language, await renderAgentBlock(options.version, options, language));
-    return blocks.get(language);
-  };
+  let block;
+  const blockFor = async () => block ??= await renderAgentBlock(options, language);
   const { inject, create } = options.onlyExisting ? { inject: candidatePaths.filter((path3) => existing.has(path3) && findBlock(existing.get(path3)) && !isWrapperFile(existing.get(path3))), create: null } : resolveAgentPaths(options.agent, existing);
   for (const path3 of inject) {
     const previous = existing.get(path3);
-    const next = injectBlock(previous, await blockFor(previous), boilerplateFor(path3));
+    const next = injectBlock(previous, await blockFor(), boilerplateFor(path3));
     paths2.push(path3);
     if (next !== previous) writes.push({ path: path3, previous, next });
   }
@@ -29107,7 +29179,7 @@ async function planAgentDocs(root, options) {
     if (paths2.includes(path3) || !isWrapperFile(text4) || !findBlock(text4)) continue;
     writes.push({ path: path3, previous: text4, next: removeBlock(text4, boilerplateFor(path3)) });
   }
-  return { mode: "install", paths: paths2, writes, missing: missing2 };
+  return { mode: "install", paths: paths2, writes, missing: missing2, language };
 }
 async function applyAgentDocs(root, plan, recheck) {
   for (const write of plan.writes) await managedWrite(root, write.path, write.previous, write.next, recheck);
@@ -29156,12 +29228,32 @@ async function resolveUpdate(current2, fetchLatest, signal, timeoutMs = updateCh
 var npmGlobalInstall = (version2) => "npm install -g gitifact@" + version2;
 var npxUpdate = (version2) => "npx --yes gitifact@" + version2 + " update";
 
+// src/commands/project-settings.ts
+function settleConfig(config2, version2, language) {
+  const cli = !CLI_VERSION_PATTERN.test(version2) || config2.cli !== void 0 && !isNewerRelease(version2, config2.cli) ? config2.cli : version2;
+  const next = { ...config2, ...cli === void 0 ? {} : { cli }, language };
+  return { config: next, changed: next.cli !== config2.cli || next.language !== config2.language };
+}
+function projectSettings(text4) {
+  if (text4 === void 0) return {};
+  try {
+    const value = JSON.parse(text4);
+    return {
+      ...typeof value.cli === "string" && CLI_VERSION_PATTERN.test(value.cli) ? { cli: value.cli } : {},
+      ...value.language === "ko" || value.language === "en" ? { language: value.language } : {}
+    };
+  } catch {
+    return {};
+  }
+}
+
 // src/commands/spec-init.ts
 async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs, update = disabledUpdate) {
   const repo = initRepository(cwd, env);
   const first = await repo.inspect();
   const root = first.state.repository.rootPath;
-  const docsPlan = agentDocs ? await planAgentDocs(root, agentDocs) : skippedAgentDocs;
+  const language = projectSettings(await readConfigFile(root).catch(() => void 0)).language;
+  let docsPlan = agentDocs ? await planAgentDocs(root, { ...agentDocs, language }) : skippedAgentDocs(language);
   const result = async (config3, outcome, lineEndings = false) => {
     const checked = await update;
     return projectInitV8.parse({
@@ -29182,16 +29274,25 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   const existing = async (text5) => {
     const config3 = parseManagedConfig(text5);
     await repo.validateBaseline(config3, root, first.state.head.commit, first.state.repository.objectFormat);
+    let current2 = text5;
     const unchanged = async () => {
-      if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text5) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
+      if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== current2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
     };
     await unchanged();
+    if (agentDocs && config3.cli && isNewerRelease(config3.cli, agentDocs.version) && docsPlan.mode === "install") docsPlan = skippedAgentDocs(docsPlan.language);
     if (dryRun) return result(config3, "already-initialized");
+    const settled2 = agentDocs ? settleConfig(config3, agentDocs.version, docsPlan.language) : { config: config3, changed: false };
+    if (settled2.changed) {
+      const next = formatManagedConfig(settled2.config, text5);
+      await publishConfig(root, next, unchanged, void 0, true);
+      current2 = next;
+    }
     await applyAgentDocs(root, docsPlan, unchanged);
-    return result(config3, "already-initialized", await writeLineEndings(root));
+    return result(settled2.config, "already-initialized", await writeLineEndings(root));
   };
-  const config2 = { schemaVersion: SCHEMA_VERSION, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
-  const text4 = JSON.stringify(config2, null, 2) + "\n";
+  const base = { schemaVersion: SCHEMA_VERSION, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
+  const config2 = agentDocs ? settleConfig(base, agentDocs.version, docsPlan.language).config : base;
+  const text4 = formatManagedConfig(config2);
   const finish = async (outcome) => {
     const published = async () => {
       if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text4) throw new InitError("INPUT_CHANGED_AFTER_WRITE", t2("init.changedAfterWrite"));
@@ -29241,6 +29342,53 @@ var fetchLatestVersion = async (signal) => {
   return latest;
 };
 
+// src/adapters/filesystem/user-cache.ts
+import { mkdir as mkdir5, readFile as readFile13, rename as rename3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join as join15 } from "node:path";
+import { randomUUID as randomUUID5 } from "node:crypto";
+function userCacheDirectory(env = process.env, platform = process.platform, home = homedir()) {
+  if (env.GITIFACT_CACHE_DIR) return env.GITIFACT_CACHE_DIR;
+  if (platform === "win32") return join15(env.LOCALAPPDATA || join15(home, "AppData", "Local"), "gitifact");
+  if (platform === "darwin") return join15(home, "Library", "Caches", "gitifact");
+  return join15(env.XDG_CACHE_HOME || join15(home, ".cache"), "gitifact");
+}
+var cacheFile = (env) => join15(userCacheDirectory(env), "update.json");
+var isTime = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
+async function readUpdateCache(env = process.env) {
+  let value;
+  try {
+    value = JSON.parse(await readFile13(cacheFile(env), "utf8"));
+  } catch {
+    return {};
+  }
+  if (typeof value !== "object" || value === null) return {};
+  const later = value.later;
+  return {
+    ...isTime(value.checkedAt) ? { checkedAt: value.checkedAt } : {},
+    ...typeof value.latest === "string" ? { latest: value.latest } : {},
+    ...isTime(value.checkingSince) ? { checkingSince: value.checkingSince } : {},
+    ...later && typeof later.version === "string" && isTime(later.until) ? { later: { version: later.version, until: later.until } } : {}
+  };
+}
+async function changeUpdateCache(env, change2) {
+  const directory = userCacheDirectory(env);
+  const temporary = join15(directory, "update-" + randomUUID5() + ".tmp");
+  try {
+    const next = change2(await readUpdateCache(env));
+    await mkdir5(directory, { recursive: true });
+    await writeFile3(temporary, JSON.stringify(next) + "\n", "utf8");
+    await rename3(temporary, cacheFile(env));
+  } catch {
+    await unlink3(temporary).catch(() => {
+    });
+  }
+}
+async function recordUpdateCheck(env, update, now = Date.now()) {
+  if (update.status === "disabled" || update.status === "checking") return;
+  await changeUpdateCache(env, ({ checkingSince: _done, ...cache }) => ({ ...cache, checkedAt: new Date(now).toISOString(), ...update.latestVersion ? { latest: update.latestVersion } : {} }));
+}
+
 // src/commands/init.ts
 async function runInit(options, version2) {
   const cancel = new AbortController();
@@ -29255,9 +29403,10 @@ async function runInit(options, version2) {
       update
     );
     if (!dto.ok) throw new Error("unreachable");
+    await recordUpdateCheck(process.env, dto.update);
     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 lineEndings = dto.lineEndings.created ? t2("init.text.lineEndings", { path: dto.lineEndings.path }) + "\n" : "";
-    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npx }) + "\n" : "";
+    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npmGlobal }) + "\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}
@@ -29272,17 +29421,17 @@ ${lineEndings}${newer}` : JSON.stringify(dto) + "\n");
 }
 
 // src/commands/documents.ts
-import { readFile as readFile13 } from "node:fs/promises";
-import { join as join16 } from "node:path";
+import { readFile as readFile14 } from "node:fs/promises";
+import { join as join17 } from "node:path";
 
 // src/commands/project.ts
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 var operations = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
 async function openProject(cwd, options = {}) {
   const reader = storeReader(cwd);
   const location = await reader.location();
   if (options.writing) {
-    for (const marker2 of operations) if (await fileInfo(join15(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join16(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await reader.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
   }
   const raw = await readConfigFile(location.root);
@@ -29446,7 +29595,7 @@ async function working(project) {
   const { documents } = await project.cache.documents.list();
   return {
     byId: new Map(documents.map((d) => [d.id, d])),
-    read: (path3) => readFile13(join16(project.root, ...path3.split("/")), "utf8"),
+    read: (path3) => readFile14(join17(project.root, ...path3.split("/")), "utf8"),
     referencing: async (id) => [...new Set((await project.cache.documents.referencing(id)).map((r) => r.from))]
   };
 }
@@ -29645,14 +29794,14 @@ var runSpecsNew = (kind2, path3, options) => runCommand("specs", options.format,
 
 // src/queries/instructions.ts
 import { lstat as lstat12 } from "node:fs/promises";
-import { join as join17 } from "node:path";
+import { join as join18 } from "node:path";
 var AGENTS = "AGENTS.md";
 async function listInstructions(source2, options, request) {
   const listed3 = await source2.cache.documents.list();
   const problems = listed3.problems;
   const states = await documentStates(source2, listed3.documents);
   const documents = states.documents;
-  const agents2 = { path: AGENTS, exists: !!(await lstat12(join17(source2.root, AGENTS)).catch(() => void 0))?.isFile() };
+  const agents2 = { path: AGENTS, exists: !!(await lstat12(join18(source2.root, AGENTS)).catch(() => void 0))?.isFile() };
   const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!options.withUpdated;
   const latest = /* @__PURE__ */ new Map();
   const newest = /* @__PURE__ */ new Map();
@@ -29751,7 +29900,7 @@ var runInstructionsNew = (name2, options) => runCommand("instructions", options.
 
 // src/adapters/filesystem/document-warnings.ts
 import { lstat as lstat13, readdir as readdir6 } from "node:fs/promises";
-import { join as join18 } from "node:path";
+import { join as join19 } from "node:path";
 var info2 = async (path3) => lstat13(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
@@ -29760,11 +29909,11 @@ var posix = (path3) => path3.split("\\").join("/");
 async function listAssets(root) {
   const out = [];
   async function visit2(relative, depth) {
-    const stat3 = await info2(join18(root, relative));
+    const stat3 = await info2(join19(root, relative));
     if (!stat3 || stat3.isSymbolicLink()) return;
     if (stat3.isDirectory()) {
       if (depth > 8 || out.length > 4e3) return;
-      for (const name2 of (await readdir6(join18(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
+      for (const name2 of (await readdir6(join19(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
     } else if (stat3.isFile()) out.push({ path: posix(relative), bytes: stat3.size });
   }
   await visit2(ASSETS_DIR, 0);
@@ -29773,7 +29922,7 @@ async function listAssets(root) {
 async function readDocumentWarnings(root, documents) {
   const outside = [...new Set(documentBodyLinks(documents).map((l) => l.target).filter((t3) => !t3.startsWith(".gitifact/") || t3.startsWith(INSTRUCTIONS_ROOT + "/")))];
   const existing = /* @__PURE__ */ new Set();
-  for (const target of outside) if ((await info2(join18(root, ...target.split("/"))))?.isFile()) existing.add(target);
+  for (const target of outside) if ((await info2(join19(root, ...target.split("/"))))?.isFile()) existing.add(target);
   return documentWarnings(documents, await listAssets(root), existing);
 }
 
@@ -29796,15 +29945,15 @@ var runCheck = (options) => runCommand("check", options.format, async () => {
 });
 
 // src/commands/changes.ts
-import { randomUUID as randomUUID5 } from "node:crypto";
-import { mkdir as mkdir6, open as open5, readFile as readFile16, rename as rename3, rmdir, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join21 } from "node:path";
+import { randomUUID as randomUUID6 } from "node:crypto";
+import { mkdir as mkdir7, open as open5, readFile as readFile17, rename as rename4, rmdir, unlink as unlink5, writeFile as writeFile5 } from "node:fs/promises";
+import { join as join22 } from "node:path";
 
 // src/adapters/filesystem/agent-inputs.ts
 import { createHash as createHash4, randomBytes as randomBytes2 } from "node:crypto";
-import { lstat as lstat14, mkdir as mkdir5, readdir as readdir7, realpath as realpath3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { lstat as lstat14, mkdir as mkdir6, readdir as readdir7, realpath as realpath3, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, dirname as dirname2, join as join19 } from "node:path";
+import { basename, dirname as dirname2, join as join20 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
 var info3 = (path3) => lstat14(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
@@ -29813,16 +29962,16 @@ var info3 = (path3) => lstat14(path3).catch((e) => {
 var comparable = (path3) => process.platform === "win32" ? path3.toLowerCase() : path3;
 async function candidates(root, controls) {
   const key = createHash4("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
-  return { system: join19((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join19(root, ".gitifact", "tmp") };
+  return { system: join20((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join20(root, ".gitifact", "tmp") };
 }
 async function writable(directory) {
   try {
-    await mkdir5(directory, { recursive: true });
+    await mkdir6(directory, { recursive: true });
     const stat3 = await info3(directory);
     if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
-    const probe = join19(directory, ".probe-" + randomBytes2(8).toString("hex"));
-    await writeFile3(probe, "", { flag: "wx" });
-    await unlink3(probe);
+    const probe = join20(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    await writeFile4(probe, "", { flag: "wx" });
+    await unlink4(probe);
     return true;
   } catch {
     return false;
@@ -29834,7 +29983,7 @@ async function prepareAgentInputs(root, controls = {}) {
   if (await writable(system)) directory = system;
   else if (await writable(project)) {
     directory = project;
-    await writeFile3(join19(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+    await writeFile4(join20(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
@@ -29842,10 +29991,10 @@ async function prepareAgentInputs(root, controls = {}) {
   const now = (controls.now ?? Date.now)();
   for (const name2 of await readdir7(directory).catch(() => [])) {
     if (name2 === ".gitignore") continue;
-    const stat3 = await info3(join19(directory, name2)).catch(() => void 0);
-    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join19(directory, name2)).catch(() => void 0);
+    const stat3 = await info3(join20(directory, name2)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join20(directory, name2)).catch(() => void 0);
   }
-  return { commit: join19(directory, "commit.json") };
+  return { commit: join20(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
@@ -29858,7 +30007,7 @@ async function discardAgentInput(root, file2, controls = {}) {
       if (await info3(directory) && comparable(await realpath3(directory)) === parent) managed = true;
     }
     if (!managed || basename(file2) === ".gitignore") return false;
-    await unlink3(file2);
+    await unlink4(file2);
     return true;
   } catch {
     return false;
@@ -29867,13 +30016,13 @@ async function discardAgentInput(root, file2, controls = {}) {
 
 // src/commands/commit-files.ts
 import { createHash as createHash5 } from "node:crypto";
-import { lstat as lstat15, readFile as readFile14 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { lstat as lstat15, readFile as readFile15 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 var fail3 = (message) => {
   throw new CommandError("INVALID_COMMIT", message);
 };
 var hash2 = (value) => createHash5("sha256").update(value).digest("hex");
-var optional2 = (path3) => readFile14(path3).catch((e) => {
+var optional2 = (path3) => readFile15(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
@@ -29903,14 +30052,14 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join20(root, ...parts.slice(0, i));
+    const target = join21(root, ...parts.slice(0, i));
     const stat3 = await info4(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail3(t2("commitFiles.linkOrDirectory"));
-    if (i < parts.length && await info4(join20(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info4(join21(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail3(t2("commitFiles.hardLinkOrSize"));
-      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile14(target)]));
+      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile15(target)]));
     }
   }
   return null;
@@ -29937,14 +30086,15 @@ function policyPaths(files) {
   }
   return [...all].sort();
 }
+var storeFiles = /* @__PURE__ */ new Set([".gitifact/config.json", LINE_ENDINGS_PATH]);
 function checkStoreSelection(selected2) {
-  for (const p of selected2.filter((p2) => p2.startsWith(".gitifact/") && !record3(p2) && p2 !== ".gitifact/config.json")) {
+  for (const p of selected2.filter((p2) => p2.startsWith(".gitifact/") && !record3(p2) && !storeFiles.has(p2))) {
     if (!isAssetPath(p) && !instructionFile2(p)) fail3(t2("commitFiles.notRecord", { path: p }));
   }
 }
 
 // src/commands/input.ts
-import { readFile as readFile15, stat as stat2 } from "node:fs/promises";
+import { readFile as readFile16, stat as stat2 } from "node:fs/promises";
 var LIMIT2 = 1024 * 1024;
 async function readJsonInput(file2, stdin = process.stdin) {
   const bytes = file2 === "-" ? await readStdin(stdin) : await readInputFile(file2);
@@ -29957,7 +30107,7 @@ async function readJsonInput(file2, stdin = process.stdin) {
 async function readInputFile(path3) {
   const source2 = await stat2(path3).catch(() => void 0);
   if (!source2?.isFile() || source2.size > LIMIT2) throw new CommandError("INVALID_INPUT", t2("input.file"));
-  return readFile15(path3);
+  return readFile16(path3);
 }
 async function readStdin(stream) {
   const chunks = [];
@@ -30057,7 +30207,7 @@ async function commitChanges(cwd, input2, dryRun) {
     ...stdin ? { input: stdin } : {}
   });
   const staged = async (index) => (await git(["diff", "--cached", "--ita-visible-in-index", "--name-only", "--no-renames", "-z"], index)).toString("utf8").split("\0").filter(Boolean).sort();
-  const busy = join21(gitDir, "gitifact-changes-commit.lock");
+  const busy = join22(gitDir, "gitifact-changes-commit.lock");
   if (await info4(busy)) fail3(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail3(t2("commit.existingStaging"));
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
@@ -30096,7 +30246,7 @@ async function commitChanges(cwd, input2, dryRun) {
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     return { outcome: "dry-run", committed: false, ...summary, commit: void 0 };
   }
-  const temporary = join21(gitDir, "gitifact-commit-index-" + randomUUID5());
+  const temporary = join22(gitDir, "gitifact-commit-index-" + randomUUID6());
   let owned = false;
   let uncertain = false;
   let commitStarted = false;
@@ -30104,7 +30254,7 @@ async function commitChanges(cwd, input2, dryRun) {
   let committed2;
   try {
     try {
-      await mkdir6(busy);
+      await mkdir7(busy);
       owned = true;
     } catch (e) {
       if (e.code === "EEXIST") fail3(t2("commit.busy", { path: busy }));
@@ -30115,31 +30265,31 @@ async function commitChanges(cwd, input2, dryRun) {
     if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail3(t2("commit.indexChanged"));
     const before = await hashes([...started.keys()]);
     for (const [path3, value] of started) if (before.get(path3) !== value) fail3(t2("commit.fileChangedRunning", { path: path3 }));
-    await writeFile4(join21(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
+    await writeFile5(join22(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
     const locked = await hashes([.../* @__PURE__ */ new Set([...selected2, ...contextPaths])]);
-    if (original) await writeFile4(temporary, original, { flag: "wx" });
+    if (original) await writeFile5(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
     await git(["add", "--pathspec-from-file=-", "--pathspec-file-nul"], temporary, Buffer.from(stageable.join("\0")));
     const actual = await staged(temporary);
     if (!actual.length || actual.some((p) => !selected2.includes(p))) fail3(t2("commit.unexpectedFiles"));
-    const storeFiles = selected2.filter((p) => record3(p) && locked.get(p) !== null);
-    if (storeFiles.length) {
-      const output2 = await git(["cat-file", "--batch"], temporary, Buffer.from(storeFiles.map((p) => ":" + p).join("\n") + "\n"));
+    const storeFiles2 = selected2.filter((p) => record3(p) && locked.get(p) !== null);
+    if (storeFiles2.length) {
+      const output2 = await git(["cat-file", "--batch"], temporary, Buffer.from(storeFiles2.map((p) => ":" + p).join("\n") + "\n"));
       let offset = 0;
-      for (const path3 of storeFiles) {
+      for (const path3 of storeFiles2) {
         const end = output2.indexOf(10, offset);
         const header = output2.subarray(offset, end).toString("utf8").split(" ");
         const size = Number(header[2]);
         if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail3(t2("commit.stagedUnreadable", { path: path3 }));
         const blob = output2.subarray(end + 1, end + 1 + size);
-        const file2 = await readFile16(join21(root, path3));
+        const file2 = await readFile17(join22(root, path3));
         if (!blob.equals(file2) && !blob.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail3(t2("commit.filterChanged"));
         offset = end + size + 2;
       }
     }
     const again = await hashes([...locked.keys()]);
     for (const [path3, value] of locked) if (again.get(path3) !== value) fail3(t2("commit.fileChangedPreparing", { path: path3 }));
-    for (const name2 of integration) if (await info4(join21(gitDir, name2))) fail3(t2("commit.integrationStarted"));
+    for (const name2 of integration) if (await info4(join22(gitDir, name2))) fail3(t2("commit.integrationStarted"));
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
     commitStarted = true;
@@ -30154,10 +30304,10 @@ async function commitChanges(cwd, input2, dryRun) {
     if (headers[0] !== "tree " + tree || after.branch !== base.branch || !same2(parents, base.head ? [base.head] : []) || trailers.some((line2) => !body2.split(/\r?\n/).includes(line2))) fail3(t2("commit.resultAltered"));
     if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== indexHash) fail3(t2("commit.indexChangedAfter"));
     if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail3(t2("commit.hookChangedStaging"));
-    await lock.writeFile(await readFile16(temporary));
+    await lock.writeFile(await readFile17(temporary));
     await lock.sync();
     await lock.close();
-    await rename3(indexPath + ".lock", indexPath);
+    await rename4(indexPath + ".lock", indexPath);
     indexLock = void 0;
     committed2 = { commit: after.head, paths: actual };
   } catch (error62) {
@@ -30174,12 +30324,12 @@ async function commitChanges(cwd, input2, dryRun) {
     await indexLock?.close().catch(() => {
     });
     if (!uncertain) {
-      if (indexLock) await unlink4(indexPath + ".lock").catch(() => {
+      if (indexLock) await unlink5(indexPath + ".lock").catch(() => {
       });
-      await unlink4(temporary).catch(() => {
+      await unlink5(temporary).catch(() => {
       });
       if (owned) {
-        await unlink4(join21(busy, "recovery.json")).catch(() => {
+        await unlink5(join22(busy, "recovery.json")).catch(() => {
         });
         await rmdir(busy);
       }
@@ -30189,8 +30339,8 @@ async function commitChanges(cwd, input2, dryRun) {
 }
 
 // src/commands/records.ts
-import { readFile as readFile17 } from "node:fs/promises";
-import { join as join22 } from "node:path";
+import { readFile as readFile18 } from "node:fs/promises";
+import { join as join23 } from "node:path";
 var runRecordsNew = (options) => runCommand("records", options.format, async () => {
   if (/[\r\n]/.test(options.title)) throw new CommandError("INVALID_VALUE", t2("docs.singleLine", { field: "title" }));
   const docs = [...new Set(options.docs.flatMap((d) => d.split(",")).map((d) => d.trim()).filter(Boolean))];
@@ -30226,7 +30376,7 @@ var runRecordsShow = (ids, options) => runCommand("records", options.format, asy
   const shown = await Promise.all([...new Set(ids)].map(async (id) => {
     const path3 = await findRecord(project.root, id);
     if (!path3) return { id, missing: true };
-    const source2 = await readFile17(join22(project.root, ...path3.split("/")), "utf8");
+    const source2 = await readFile18(join23(project.root, ...path3.split("/")), "utf8");
     const log = project.reader.decode(await project.reader.run(["log", "-1", "--diff-filter=A", "--format=%H%x00%aN%x00%aI", "--", path3])).trim();
     const [commit, author, date5] = log.split("\0");
     return { id, path: path3, text: source2, commit: commit ? { commit, author, date: date5 } : null };
@@ -30334,9 +30484,7 @@ async function readThrough(project, head, filter, id) {
 }
 
 // src/commands/feedback.ts
-import { readFile as readFile18 } from "node:fs/promises";
 import { release as release3 } from "node:os";
-import { dirname as dirname3, join as join23 } from "node:path";
 
 // src/adapters/github/issue.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -30390,6 +30538,17 @@ function newIssueUrl(title, body2, marker2) {
   return { url: address(characters.slice(0, low).join("") + marker2), truncated: true };
 }
 
+// src/shared/project-config.ts
+import { readFile as readFile19 } from "node:fs/promises";
+import { dirname as dirname3, join as join24 } from "node:path";
+async function findProjectConfig(from) {
+  for (let folder = from; ; folder = dirname3(folder)) {
+    const text4 = await readFile19(join24(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
+    if (text4 !== void 0) return { root: folder, text: text4 };
+    if (dirname3(folder) === folder) return void 0;
+  }
+}
+
 // src/commands/feedback.ts
 var types = ["bug", "idea"];
 function parseFeedback(input2) {
@@ -30402,17 +30561,13 @@ function parseFeedback(input2) {
   return { type, title: title.trim(), body: body2.trim() };
 }
 async function schemaVersion(from) {
-  for (let folder = from; ; folder = dirname3(folder)) {
-    const config2 = await readFile18(join23(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
-    if (config2 !== void 0) {
-      try {
-        const value = JSON.parse(config2).schemaVersion;
-        return typeof value === "number" ? String(value) : "none";
-      } catch {
-        return "none";
-      }
-    }
-    if (dirname3(folder) === folder) return "none";
+  const config2 = (await findProjectConfig(from))?.text;
+  if (config2 === void 0) return "none";
+  try {
+    const value = JSON.parse(config2).schemaVersion;
+    return typeof value === "number" ? String(value) : "none";
+  } catch {
+    return "none";
   }
 }
 async function issueBody(feedback, version2, cwd) {
@@ -30449,6 +30604,11 @@ var runFeedback = (options, version2, run) => runCommand("feedback", options.for
   return { json: { ...sent, title: feedback.title, body: body2 }, text: text2(out) };
 });
 
+// src/commands/update.ts
+import { readFile as readFile20 } from "node:fs/promises";
+import { join as join25 } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+
 // src/adapters/git/agent-docs-commit.ts
 function agentDocsGit(root, inherited = process.env) {
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_LAZY_FETCH: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "1", LC_ALL: "C" };
@@ -30480,9 +30640,11 @@ function agentDocsGit(root, inherited = process.env) {
 }
 
 // src/commands/update.ts
-var blockCommitMessage = (version2) => "chore(gitifact): refresh GITIFACT block to v" + version2;
+var CONFIG_PATH = ".gitifact/config.json";
+var updateCommitMessage = (version2) => "chore(gitifact): update project to gitifact v" + version2;
 var commitState = (state2, extra = {}) => ({ state: state2, commit: null, paths: [], message: null, reason: null, detail: null, ...extra });
-async function refreshBlocks(cwd, version2, env, controls) {
+var notInitialized = { docs: { state: "not-initialized", paths: [], missing: [] }, project: { state: "not-initialized", cli: null } };
+async function refreshProject(cwd, version2, env, controls) {
   const repo = initRepository(cwd, env);
   let first;
   let config2;
@@ -30490,20 +30652,28 @@ async function refreshBlocks(cwd, version2, env, controls) {
     first = await repo.inspect();
     config2 = await readConfigFile(first.state.repository.rootPath);
   } catch (error62) {
-    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY") return { state: "not-initialized", paths: [], missing: [] };
+    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY") return notInitialized;
     throw error62;
   }
-  if (config2 === void 0) return { state: "not-initialized", paths: [], missing: [] };
+  if (config2 === void 0) return notInitialized;
   const root = first.state.repository.rootPath;
-  const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, ...controls });
+  const parsed2 = needsMigration(config2) ? void 0 : parseManagedConfig(config2);
+  const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, language: parsed2?.language, ...controls });
   const { missing: missing2 } = plan;
-  if (plan.paths.length === 0) return { state: "no-block", paths: [], missing: missing2, root };
-  if (plan.writes.length === 0) return { state: "current", paths: plan.paths, missing: missing2, root, candidates: plan.paths };
+  if (parsed2?.cli && isNewerRelease(parsed2.cli, version2)) return { docs: { state: "kept", paths: plan.paths, missing: missing2, root }, project: { state: "current", cli: parsed2.cli } };
+  let current2 = config2;
   const unchanged = async () => {
-    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== config2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
+    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== current2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
   };
-  const applied = await applyAgentDocs(root, plan, unchanged);
-  return { state: "refreshed", paths: applied, missing: missing2, root, candidates: plan.paths };
+  const docs = plan.paths.length === 0 ? { state: "no-block", paths: [], missing: missing2, root } : plan.writes.length === 0 ? { state: "current", paths: plan.paths, missing: missing2, root, candidates: plan.paths } : { state: "refreshed", paths: await applyAgentDocs(root, plan, unchanged), missing: missing2, root, candidates: plan.paths };
+  if (!parsed2) return { docs, project: { state: "current", cli: null } };
+  const settled2 = settleConfig(parsed2, version2, plan.language);
+  if (settled2.changed) {
+    const next = formatManagedConfig(settled2.config, config2);
+    await publishConfig(root, next, unchanged, void 0, true);
+    current2 = next;
+  }
+  return { docs: { ...docs, root }, project: { state: settled2.changed ? "written" : "current", cli: settled2.config.cli ?? null } };
 }
 function outsideBlock(text4) {
   const normalized2 = text4.replace(/\r\n/g, "\n");
@@ -30514,12 +30684,20 @@ function outsideBlock(text4) {
     return null;
   }
 }
-async function commitBlocks(docs, version2, env) {
-  if (!docs.root || !docs.candidates?.length) return commitState("nothing");
+function withoutSettings(text4) {
+  try {
+    const { cli: _c, language: _l, ...rest } = JSON.parse(text4);
+    return rest;
+  } catch {
+    return null;
+  }
+}
+async function commitUpdate(docs, version2, env) {
+  if (!docs.root) return commitState("nothing");
   const git = agentDocsGit(docs.root, env);
   const head = await git.head();
   const changed = [];
-  for (const path3 of docs.candidates) {
+  for (const path3 of docs.candidates ?? []) {
     const working2 = await managedRead(docs.root, path3);
     const committed2 = head ? await git.committed(head, path3) : null;
     if (working2 === null) continue;
@@ -30529,8 +30707,16 @@ async function commitBlocks(docs, version2, env) {
     if (before === null || before !== outsideBlock(working2)) return commitState("skipped", { paths: [path3], reason: "other-changes" });
     changed.push(path3);
   }
+  const workingConfig = await readFile20(join25(docs.root, CONFIG_PATH), "utf8").catch(() => null);
+  const committedConfig = head ? await git.committed(head, CONFIG_PATH) : null;
+  if (workingConfig !== null && committedConfig?.replace(/\r\n/g, "\n") !== workingConfig.replace(/\r\n/g, "\n")) {
+    if (committedConfig === null) return commitState("skipped", { paths: [CONFIG_PATH], reason: "untracked" });
+    const before = withoutSettings(committedConfig);
+    if (before === null || !isDeepStrictEqual(before, withoutSettings(workingConfig))) return commitState("skipped", { paths: [CONFIG_PATH], reason: "other-changes" });
+    changed.push(CONFIG_PATH);
+  }
   if (changed.length === 0) return commitState("nothing");
-  const message = blockCommitMessage(version2);
+  const message = updateCommitMessage(version2);
   let failure2;
   try {
     await git.commitOnly(changed, message);
@@ -30544,20 +30730,23 @@ async function commitBlocks(docs, version2, env) {
   return commitState("committed", { commit: after, paths: await git.changedPaths(after), message });
 }
 async function updateCommand(cwd, version2, env = process.env, controls = {}) {
-  const [update, agentDocs] = await Promise.all([
+  const [update, refreshed] = await Promise.all([
     updateCheckDisabled(env) ? disabledUpdate : resolveUpdate(version2, controls.fetchLatest ?? fetchLatestVersion, void 0, controls.timeoutMs),
-    refreshBlocks(cwd, version2, env, controls)
+    refreshProject(cwd, version2, env, controls)
   ]);
-  const commit = controls.commit ? await commitBlocks(agentDocs, version2, env) : commitState("not-requested");
-  const config2 = await readConfigFile(agentDocs.root ?? cwd).catch(() => void 0);
-  return updateV5.parse({
+  await recordUpdateCheck(env, update, controls.now?.());
+  const { docs, project } = refreshed;
+  const commit = controls.commit ? await commitUpdate(docs, version2, env) : commitState("not-requested");
+  const config2 = await readConfigFile(docs.root ?? cwd).catch(() => void 0);
+  return updateV6.parse({
     contract: "update",
-    version: 5,
+    version: 6,
     ok: true,
     cliVersion: version2,
     update,
-    install: update.status === "available" ? { npx: npxUpdate(update.latestVersion), npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
-    agentDocs: { state: agentDocs.state, paths: agentDocs.paths, missing: agentDocs.missing },
+    install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
+    agentDocs: { state: docs.state, paths: docs.paths, missing: docs.missing },
+    project,
     commit,
     migrationRequired: config2 !== void 0 && needsMigration(config2)
   });
@@ -30572,9 +30761,11 @@ 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.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 }));
+    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 { commit } = dto;
     if (commit.state === "committed") lines.push(t2("update.text.committed", { commit: commit.commit.slice(0, 12), paths: commit.paths.join(", ") }));
@@ -30588,7 +30779,7 @@ 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(updateV5.parse({ contract: "update", version: 5, ok: false, error: failure2 })) + "\n");
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV6.parse({ contract: "update", version: 6, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
@@ -30596,6 +30787,7 @@ async function runUpdate(options, version2) {
 // 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);
+  await recordUpdateCheck(env, update, controls.now?.());
   return updateCheckV1.parse({
     contract: "update-check",
     version: 1,
@@ -30616,10 +30808,73 @@ async function runUpdateCheck(format2, version2) {
     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 (dto.command) lines.push(t2("update.text.install", { command: dto.command }));
+  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");
 }
 
+// src/commands/version-notice.ts
+import { spawn as spawn3 } from "node:child_process";
+import { homedir as homedir2 } from "node:os";
+var REFRESH_AFTER_MS = 60 * 60 * 1e3;
+var CHECKING_WINDOW_MS = 5 * 60 * 1e3;
+var LATER_MS = 24 * 60 * 60 * 1e3;
+var REFRESH_COMMAND = "__refresh-update";
+var noticeScope = (command) => ({ release: command !== "init" && command !== "update", projectOlder: command !== "init" && command !== "update" });
+function chooseNotice(running2, project, cache, now, scope = { release: true, projectOlder: true }) {
+  if (project && isNewerRelease(project, running2)) return { kind: "project-newer", project };
+  const latest = cache.latest;
+  const postponed = cache.later !== void 0 && cache.later.version === latest && now < Date.parse(cache.later.until);
+  if (scope.release && latest && isNewerRelease(latest, running2) && !postponed) return { kind: "release", latest };
+  if (scope.projectOlder && project && isNewerRelease(running2, project)) return { kind: "project-older", project };
+  return null;
+}
+function noticeText(notice, running2) {
+  if (notice.kind === "project-newer") return t2("notice.projectNewer", { project: notice.project, version: running2, command: npmGlobalInstall(notice.project) });
+  if (notice.kind === "release") return t2("notice.release", { latest: notice.latest, version: running2, command: npmGlobalInstall(notice.latest) });
+  return t2("notice.projectOlder", { project: notice.project, version: running2 });
+}
+var needsRefresh = (cache, now) => !(cache.checkedAt && now - Date.parse(cache.checkedAt) < REFRESH_AFTER_MS) && !(cache.checkingSince && now - Date.parse(cache.checkingSince) < CHECKING_WINDOW_MS);
+var spawnRefresh = () => {
+  const child = spawn3(process.execPath, [...process.execArgv, process.argv[1], REFRESH_COMMAND], { cwd: homedir2(), detached: true, stdio: "ignore", windowsHide: true });
+  child.on("error", () => {
+  });
+  child.unref();
+};
+async function noticeVersion(version2, command, controls = {}) {
+  const env = controls.env ?? process.env;
+  const now = controls.now ?? Date.now();
+  try {
+    const project = projectSettings((await findProjectConfig(controls.cwd ?? process.cwd()))?.text).cli;
+    const scope = noticeScope(command);
+    let cache = {};
+    if (!updateCheckDisabled(env)) {
+      cache = await readUpdateCache(env);
+      if (scope.release && needsRefresh(cache, now)) {
+        await changeUpdateCache(env, (current2) => ({ ...current2, checkingSince: new Date(now).toISOString() }));
+        (controls.refresh ?? spawnRefresh)();
+      }
+    }
+    const notice = chooseNotice(version2, project, cache, now, scope);
+    if (notice) (controls.write ?? ((line2) => process.stderr.write(line2 + "\n")))(noticeText(notice, version2));
+  } catch {
+  }
+}
+async function refreshUpdateCache(version2, env = process.env, fetchLatest = fetchLatestVersion, now) {
+  if (updateCheckDisabled(env)) return;
+  const update = await resolveUpdate(version2, fetchLatest);
+  await recordUpdateCheck(env, update, now?.());
+}
+async function postponeRelease(version2, env = process.env, now = Date.now()) {
+  const cache = await readUpdateCache(env);
+  const later = cache.latest && isNewerRelease(cache.latest, version2) ? { version: cache.latest, until: new Date(now + LATER_MS).toISOString() } : null;
+  if (later) await changeUpdateCache(env, (current2) => ({ ...current2, later }));
+  return updateLaterV1.parse({ contract: "update-later", version: 1, ok: true, cliVersion: version2, later });
+}
+async function runUpdateLater(format2, version2) {
+  const dto = await postponeRelease(version2);
+  process.stdout.write(format2 === "json" ? JSON.stringify(dto) + "\n" : (dto.later ? t2("update.later.postponed", { latest: dto.later.version, until: new Date(dto.later.until).toLocaleString() }) : t2("update.later.nothing", { version: version2 })) + "\n");
+}
+
 // src/main.ts
 var languageArgs = process.argv.slice(2).slice(0, process.argv.slice(2).indexOf("--") < 0 ? void 0 : process.argv.slice(2).indexOf("--"));
 var selectedLanguage;
@@ -30629,11 +30884,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.2").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.4").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());
+});
+program2.command(REFRESH_COMMAND, { hidden: true }).allowExcessArguments(false).action(() => refreshUpdateCache("0.8.4"));
 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.2"));
-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.2"));
-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.8.2") : runUpdate(options, "0.8.2"));
+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"));
 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]));
@@ -30655,7 +30916,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.2"));
+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"));
 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));