gitifact 0.5.0 → 0.5.1

package/dist/main.js

@@ -3510,7 +3510,8 @@ var messages_default = {
   "source.path": "\uCC38\uACE0 \uBB38\uC11C path\uB294 .md\uB85C \uB05D\uB098\uB294 \uC0C1\uB300 \uACBD\uB85C\uC5EC\uC57C \uD569\uB2C8\uB2E4: {path}",
   "edit.documentIdNotFound": "\uC704\uD0A4 \uD398\uC774\uC9C0 ID\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: {id}",
   "edit.invalidSources": "sources\uB294 \uCD5C\uB300 50\uAC1C\uC758 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
-  "config.unsupportedSchema": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uC800\uC7A5 \uADDC\uC57D(schemaVersion {version})\uC740 \uC774 CLI\uAC00 \uC77D\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC815\uC2DD \uBC84\uC804 \uC804 \uADDC\uC57D\uC740 \uC804\uD658\uD558\uC9C0 \uC54A\uC73C\uBA70 \uC0C8\uB85C init \uD569\uB2C8\uB2E4."
+  "config.unsupportedSchema": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uC800\uC7A5 \uADDC\uC57D(schemaVersion {version})\uC740 \uC774\uC804 \uBC84\uC804\uC758 \uAC83\uC774\uB77C \uC774 CLI\uAC00 \uC77D\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC815\uC2DD \uBC84\uC804 \uC804 \uADDC\uC57D\uC740 \uC804\uD658\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. .gitifact\uC5D0 config.json\uB9CC \uC788\uC73C\uBA74 gitifact init\uC774 \uC0C8 \uADDC\uC57D\uC73C\uB85C \uBC14\uAFC9\uB2C8\uB2E4.",
+  "config.newerSchema": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 \uB354 \uC0C8\uB85C\uC6B4 \uC800\uC7A5 \uADDC\uC57D(schemaVersion {version})\uC744 \uC501\uB2C8\uB2E4. npm install -g gitifact@latest\uB85C CLI\uB97C \uC62C\uB9B0 \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694."
 };
 
 // ../../packages/core/dist/shared/i18n/index.js
@@ -3595,8 +3596,11 @@ function parseManagedConfig(text2) {
   const config2 = value;
   if (Object.keys(config2).sort().join(",") !== "baseline,schemaVersion")
     throw new InitError("INVALID_CONFIG", t("config.schemaFields"));
-  if (config2.schemaVersion !== SCHEMA_VERSION)
-    throw new InitError("UNSUPPORTED_SCHEMA", t("config.unsupportedSchema", { version: String(config2.schemaVersion) }));
+  if (config2.schemaVersion !== SCHEMA_VERSION) {
+    const found = config2.schemaVersion;
+    const newer = typeof found === "number" && found > SCHEMA_VERSION;
+    throw new InitError("UNSUPPORTED_SCHEMA", newer ? t("config.newerSchema", { version: String(found) }) : t("config.unsupportedSchema", { version: String(found) }));
+  }
   const checked = parseProjectConfig(JSON.stringify({ kind: "tryce-project", format: "workflow-1", mode: "auto", baseline: config2.baseline }));
   return { schemaVersion: SCHEMA_VERSION, baseline: checked.baseline };
 }
@@ -24586,13 +24590,32 @@ var browserHttpErrorV1 = external_exports.strictObject({
   })
 });
 
-// ../../packages/contracts/dist/versions/project-init-v4.js
-var projectInitV4 = external_exports.discriminatedUnion("ok", [
+// ../../packages/contracts/dist/versions/browser-session-v2.js
+var release = external_exports.string().regex(/^\d+\.\d+\.\d+$/);
+var updateStateV1 = external_exports.strictObject({
+  status: external_exports.enum(["checking", "available", "up-to-date", "unavailable", "disabled"]),
+  latestVersion: release.nullable()
+}).refine((value) => (value.status === "available" || value.status === "up-to-date") === (value.latestVersion !== null), "latestVersion is set exactly when the check produced a result.");
+var browserSessionV2 = external_exports.strictObject({
+  contract: external_exports.literal("browser-session"),
+  version: external_exports.literal(2),
+  sessionId: external_exports.uuid(),
+  repository: external_exports.strictObject({
+    key: external_exports.string().regex(/^repo:[0-9a-f]{64}$/),
+    worktreeKey: external_exports.string().regex(/^worktree:[0-9a-f]{64}$/)
+  }),
+  // The running CLI, the same value as `gitifact --version`. A development build may carry a pre-release suffix.
+  cliVersion: external_exports.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/),
+  update: updateStateV1
+});
+
+// ../../packages/contracts/dist/versions/project-init-v5.js
+var projectInitV5 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
     contract: external_exports.literal("project-init"),
-    version: external_exports.literal(4),
+    version: external_exports.literal(5),
     ok: external_exports.literal(true),
-    outcome: external_exports.enum(["planned", "created", "already-initialized"]),
+    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),
@@ -24600,9 +24623,12 @@ var projectInitV4 = external_exports.discriminatedUnion("ok", [
       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()) })
+    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. The command is for npm global installs; other installs differ.
+    install: external_exports.strictObject({ npmGlobal: external_exports.string().min(1) }).nullable()
   }),
-  external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(4), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+  external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(5), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
 // ../../packages/contracts/dist/versions/browser-specs-v2.js
@@ -24677,25 +24703,6 @@ var changelogV1 = external_exports.strictObject({
   }
 });
 
-// ../../packages/contracts/dist/versions/browser-session-v2.js
-var release = external_exports.string().regex(/^\d+\.\d+\.\d+$/);
-var updateStateV1 = external_exports.strictObject({
-  status: external_exports.enum(["checking", "available", "up-to-date", "unavailable", "disabled"]),
-  latestVersion: release.nullable()
-}).refine((value) => (value.status === "available" || value.status === "up-to-date") === (value.latestVersion !== null), "latestVersion is set exactly when the check produced a result.");
-var browserSessionV2 = external_exports.strictObject({
-  contract: external_exports.literal("browser-session"),
-  version: external_exports.literal(2),
-  sessionId: external_exports.uuid(),
-  repository: external_exports.strictObject({
-    key: external_exports.string().regex(/^repo:[0-9a-f]{64}$/),
-    worktreeKey: external_exports.string().regex(/^worktree:[0-9a-f]{64}$/)
-  }),
-  // The running CLI, the same value as `gitifact --version`. A development build may carry a pre-release suffix.
-  cliVersion: external_exports.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/),
-  update: updateStateV1
-});
-
 // ../../packages/contracts/dist/versions/update-v3.js
 var commitReason = external_exports.enum(["untracked", "other-changes", "commit-failed"]);
 var agentDocsCommit = external_exports.strictObject({
@@ -24910,6 +24917,7 @@ var messages_default2 = {
   "init.configDeleted": "\uAE30\uC874 \uC124\uC815\uC758 \uC0AD\uC81C\uB97C \uC2E0\uADDC \uB3C4\uC785\uC73C\uB85C \uCC98\uB9AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "init.existingSpecs": "\uAE30\uC874 specs \uACBD\uB85C\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "init.orphanStore": "\uC124\uC815 \uC5C6\uB294 .gitifact \uC790\uB8CC\uB97C \uC790\uB3D9 \uCC44\uD0DD\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
+  "init.legacyRecords": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uB294 \uC774\uC804 \uC800\uC7A5 \uADDC\uC57D(schemaVersion {version})\uC73C\uB85C \uC4F4 \uBA85\uC138\uB098 \uAE30\uB85D\uC774 \uC788\uC5B4 \uC124\uC815\uC744 \uBC14\uAFB8\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC774 CLI\uB294 \uC774\uC804 \uADDC\uC57D\uC744 \uC804\uD658\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uAE30\uB85D\uC744 \uB2E4\uB978 \uACF3\uC5D0 \uBCF4\uAD00\uD558\uACE0 .gitifact\uC5D0 config.json\uB9CC \uB0A8\uAE34 \uB4A4 \uB2E4\uC2DC init \uD558\uC138\uC694.",
   "init.headOrIndexChanged": "HEAD \uB610\uB294 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.",
   "init.configAppeared": "\uB2E4\uB978 \uC2E4\uD589\uC774 \uC124\uC815\uC744 \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4.",
   "init.changedAfterWrite": "\uC124\uC815 \uC0DD\uC131 \uD6C4 \uC785\uB825\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uD604\uC7AC \uD30C\uC77C\uC744 \uD655\uC778\uD558\uC138\uC694.",
@@ -24919,6 +24927,7 @@ var messages_default2 = {
   "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.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.",
@@ -25331,7 +25340,7 @@ function specPreviewReader(cwd) {
 }
 
 // src/adapters/filesystem/spec-preview-store.ts
-import { lstat as lstat3, readdir as readdir3, readFile as readFile3, mkdir as mkdir2, writeFile, rename, unlink as unlink2, rmdir } from "node:fs/promises";
+import { lstat as lstat3, readdir as readdir3, readFile as readFile3, mkdir as mkdir2, writeFile, rename as rename2, unlink as unlink2, rmdir } from "node:fs/promises";
 import { join as join4, dirname } from "node:path";
 import { createHash as createHash2, randomBytes } from "node:crypto";
 
@@ -25383,7 +25392,7 @@ async function workingWarnings(root, bundle) {
 }
 
 // src/adapters/filesystem/config-file.ts
-import { lstat as lstat2, readFile as readFile2, realpath, mkdir, open as open2, link, unlink } from "node:fs/promises";
+import { lstat as lstat2, readFile as readFile2, realpath, mkdir, open as open2, link, rename, unlink } from "node:fs/promises";
 import { join as join3 } from "node:path";
 import { randomUUID as randomUUID3 } from "node:crypto";
 var missing = (error62) => error62.code === "ENOENT";
@@ -25418,7 +25427,7 @@ async function readConfigFile(root) {
     throw new InitError("INVALID_CONFIG", t2("config.notUtf8Json"));
   }
 }
-async function publishConfig(root, text2, recheck, beforePublish) {
+async function publishConfig(root, text2, recheck, beforePublish, replace = false) {
   const directory = join3(root, ".gitifact");
   await configDirectory(root);
   await mkdir(directory).catch((error62) => {
@@ -25449,7 +25458,8 @@ async function publishConfig(root, text2, recheck, beforePublish) {
     const bytes = await readFile2(temporary, "utf8");
     if (bytes !== text2) throw new InitError("INPUT_CHANGED", t2("config.temporaryChanged"));
     parseManagedConfig(bytes);
-    await link(temporary, join3(directory, "config.json"));
+    if (replace) await rename(temporary, join3(directory, "config.json"));
+    else await link(temporary, join3(directory, "config.json"));
   } finally {
     await unchanged();
     const current = await fileInfo(temporary);
@@ -25521,7 +25531,7 @@ async function readWorkingPreview(cwd) {
   const { root, stamp, specs, wiki, bundle } = await readWorkingPreviewState(cwd);
   return { stamp, specs, wiki, warnings: await workingWarnings(root, bundle) };
 }
-async function saveWorkingPreview(cwd, input2, publish = rename) {
+async function saveWorkingPreview(cwd, input2, publish = rename2) {
   if (!input2 || typeof input2 !== "object" || Array.isArray(input2)) fail4(t2("store.invalidInput"));
   const request = input2;
   if (Object.keys(request).sort().join(",") !== "expected,operations" || typeof request.expected !== "string") fail4(t2("store.expectedOperations"));
@@ -25545,7 +25555,7 @@ async function saveWorkingPreview(cwd, input2, publish = rename) {
   }, publish);
 }
 var readLockedPreviewState = (root) => snapshot2(root);
-async function previewTransaction(cwd, expected2, build, publish = rename, afterPublish) {
+async function previewTransaction(cwd, expected2, build, publish = rename2, afterPublish) {
   const { root, gitDir } = await specPreviewReader(cwd).location();
   await failOnLegacyLock(gitDir);
   const lock = join4(gitDir, "gitifact-spec-preview.lock");
@@ -25630,7 +25640,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
           const temp = join4(dirname(path3), ".gitifact-restore-" + randomBytes(12).toString("hex"));
           temporary.push(temp);
           await writeFile(temp, c.before, { flag: "wx" });
-          await rename(temp, path3);
+          await rename2(temp, path3);
         }
       } catch {
         keepRecovery = true;
@@ -26108,7 +26118,7 @@ function initRepository(cwd, inherited = process.env) {
 }
 
 // src/adapters/filesystem/managed-file.ts
-import { open as open3, readFile as readFile6, mkdir as mkdir3, realpath as realpath2, rename as rename2, link as link2, unlink as unlink3 } from "node:fs/promises";
+import { open as open3, readFile as readFile6, mkdir as mkdir3, realpath as realpath2, rename as rename3, link as link2, unlink as unlink3 } from "node:fs/promises";
 import { join as join7, dirname as dirname2 } from "node:path";
 import { randomUUID as randomUUID5 } from "node:crypto";
 var DEFAULT_LIMIT = 1024 * 1024;
@@ -26178,7 +26188,7 @@ async function managedWrite(root, path3, previous, next, recheck) {
     await unchanged();
     if (await managedRead(root, path3) !== previous || await readFile6(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", t2("managedFile.publishTargetChanged", { path: path3 }));
     if (previous === null) await link2(temp, full);
-    else await rename2(temp, full);
+    else await rename3(temp, full);
   } finally {
     await unchanged();
     const now = await fileInfo(temp);
@@ -26389,22 +26399,27 @@ async function applyAgentDocs(root, plan, recheck) {
 }
 
 // src/commands/spec-init.ts
-async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs, readDoc = (name) => readBundledDoc(name, defaultLanguage2)) {
+async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs, readDoc = (name) => readBundledDoc(name, defaultLanguage2), 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 result = (config3, outcome) => projectInitV4.parse({
-    contract: "project-init",
-    version: 4,
-    ok: true,
-    outcome,
-    rootPath: root,
-    configPath: ".gitifact/config.json",
-    schemaVersion: config3.schemaVersion,
-    baseline: config3.baseline,
-    agentDocs: { mode: docsPlan.mode, paths: docsPlan.paths }
-  });
+  const result = async (config3, outcome) => {
+    const checked = await update;
+    return projectInitV5.parse({
+      contract: "project-init",
+      version: 5,
+      ok: true,
+      outcome,
+      rootPath: root,
+      configPath: ".gitifact/config.json",
+      schemaVersion: config3.schemaVersion,
+      baseline: config3.baseline,
+      agentDocs: { mode: docsPlan.mode, paths: docsPlan.paths },
+      update: checked,
+      install: checked.status === "available" ? { npmGlobal: npmGlobalInstall(checked.latestVersion) } : null
+    });
+  };
   const existing = async (text3) => {
     const config3 = parseManagedConfig(text3);
     if (!("schemaVersion" in config3)) throw new InitError("MIGRATION_REQUIRED", t2("init.migrationRequired"));
@@ -26416,8 +26431,40 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
     if (!dryRun) await applyAgentDocs(root, docsPlan, unchanged);
     return result(config3, "already-initialized");
   };
+  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 text2 = JSON.stringify(config2, null, 2) + "\n";
+  const replaceLegacy = async (before, version2) => {
+    const onlyConfig = async () => {
+      const entries = await readdir4(join9(root, ".gitifact"));
+      if (await fileInfo(join9(root, "specs")) || entries.some((name) => name !== "config.json" && !/^\.init-[a-f0-9-]+\.tmp$/.test(name))) {
+        throw new InitError("UNSUPPORTED_SCHEMA", t2("init.legacyRecords", { version: String(version2) }));
+      }
+    };
+    const recheck2 = async () => {
+      await onlyConfig();
+      await repo.checkIgnore(root);
+      if ((await repo.inspect()).stamp !== first.stamp) throw new InitError("INPUT_CHANGED", t2("init.headOrIndexChanged"));
+      if (await readConfigFile(root) !== before) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
+    };
+    await recheck2();
+    if (dryRun) return result(config2, "planned");
+    await publishConfig(root, text2, recheck2, beforePublish, true);
+    return finish("replaced");
+  };
+  const finish = async (outcome) => {
+    const published = async () => {
+      if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text2) throw new InitError("INPUT_CHANGED_AFTER_WRITE", t2("init.changedAfterWrite"));
+    };
+    await published();
+    await applyAgentDocs(root, docsPlan, published);
+    await writeWikiPolicy(root, readDoc);
+    return result(config2, outcome);
+  };
   const old = await readConfigFile(root);
-  if (old !== void 0) return existing(old);
+  if (old !== void 0) {
+    const legacy = legacySchemaVersion(old);
+    return legacy === void 0 ? existing(old) : replaceLegacy(old, legacy);
+  }
   if (first.trackedConfig) throw new InitError("CONFIG_DELETED", t2("init.configDeleted"));
   const checkRecords = async () => {
     if (await fileInfo(join9(root, "specs"))) throw new InitError("EXISTING_RECORDS", t2("init.existingSpecs"));
@@ -26427,8 +26474,6 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
     });
     if (entries.some((name) => !/^\.init-[a-f0-9-]+\.tmp$/.test(name))) throw new InitError("EXISTING_RECORDS", t2("init.orphanStore"));
   };
-  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 text2 = JSON.stringify(config2, null, 2) + "\n";
   const recheck = async () => {
     await checkRecords();
     await repo.checkIgnore(root);
@@ -26446,13 +26491,18 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
     }
     throw error62;
   }
-  const published = async () => {
-    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text2) throw new InitError("INPUT_CHANGED_AFTER_WRITE", t2("init.changedAfterWrite"));
-  };
-  await published();
-  await applyAgentDocs(root, docsPlan, published);
-  await writeWikiPolicy(root, readDoc);
-  return result(config2, "created");
+  return finish("created");
+}
+function legacySchemaVersion(text2) {
+  let value;
+  try {
+    value = JSON.parse(text2);
+  } catch {
+    return void 0;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const version2 = value.schemaVersion;
+  return Number.isInteger(version2) && version2 < SCHEMA_VERSION ? version2 : void 0;
 }
 async function writeWikiPolicy(root, readDoc) {
   if (await fileInfo(join9(root, ...WIKI_DIR.split("/")))) return;
@@ -26470,24 +26520,30 @@ async function writeWikiPolicy(root, readDoc) {
 
 // src/commands/init.ts
 async function runInit(options, version2) {
+  const cancel = new AbortController();
+  const update = updateCheckDisabled(process.env) ? disabledUpdate : resolveUpdate(version2, fetchLatestVersion, cancel.signal);
   try {
     const dto = await initializeSpecProject(
       process.cwd(),
       options.dryRun,
       process.env,
       void 0,
-      { version: version2, agent: options.agent, remove: options.removeAgents, skip: options.skipAgents }
+      { version: version2, agent: options.agent, remove: options.removeAgents, skip: options.skipAgents },
+      void 0,
+      update
     );
     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" : "";
     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}
-` : JSON.stringify(dto) + "\n");
+${newer}` : JSON.stringify(dto) + "\n");
   } catch (error62) {
+    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(projectInitV4.parse({ contract: "project-init", version: 4, ok: false, error: failure2 })) + "\n");
+    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.exitCode = 1;
   }
 }
@@ -26786,7 +26842,7 @@ async function discardAgentInput(root, file2, controls = {}) {
 
 // src/commands/spec-preview-commit.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
-import { readFile as readFile10, mkdir as mkdir6, open as open4, rename as rename3, unlink as unlink5, rmdir as rmdir2, writeFile as writeFile4 } from "node:fs/promises";
+import { readFile as readFile10, mkdir as mkdir6, open as open4, rename as rename4, unlink as unlink5, rmdir as rmdir2, writeFile as writeFile4 } from "node:fs/promises";
 import { join as join13 } from "node:path";
 
 // src/commands/spec-commit-files.ts
@@ -26985,7 +27041,7 @@ async function previewCommit(cwd, action, input2) {
     await indexLock.writeFile(await readFile10(temporary));
     await indexLock.sync();
     await indexLock.close();
-    await rename3(indexPath + ".lock", indexPath);
+    await rename4(indexPath + ".lock", indexPath);
     indexLock = void 0;
     return { outcome: "committed", commit: after.head, paths: actual, requirements: plan.requirements, pushed: false };
   } catch (error62) {
@@ -27016,7 +27072,7 @@ async function previewCommit(cwd, action, input2) {
 
 // src/commands/spec-commit.ts
 import { createHash as createHash8, randomUUID as randomUUID7 } from "node:crypto";
-import { mkdir as mkdir7, open as open5, readFile as readFile11, rename as rename4, rmdir as rmdir3, unlink as unlink6, writeFile as writeFile5 } from "node:fs/promises";
+import { mkdir as mkdir7, open as open5, readFile as readFile11, rename as rename5, rmdir as rmdir3, unlink as unlink6, writeFile as writeFile5 } from "node:fs/promises";
 import { join as join14 } from "node:path";
 var fields = ["reasons", "paths", "message", "authorization", "requirements", "policyFiles", "expected"];
 var integration = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"];
@@ -27123,7 +27179,7 @@ async function specCommit(cwd, input2, dryRun) {
       if (e.code === "EEXIST") fail6(t2("commit.busy", { path: busy }));
       throw e;
     }
-    await previewTransaction(cwd, current.stamp, async () => ({ writes, data: {}, recheck: c.recheck }), rename4, async (published) => {
+    await previewTransaction(cwd, current.stamp, async () => ({ writes, data: {}, recheck: c.recheck }), rename5, async (published) => {
       let commitStarted = false;
       try {
         const lock = indexLock = await open5(indexPath + ".lock", "wx", 384);
@@ -27173,7 +27229,7 @@ async function specCommit(cwd, input2, dryRun) {
         await lock.writeFile(await readFile11(temporary));
         await lock.sync();
         await lock.close();
-        await rename4(indexPath + ".lock", indexPath);
+        await rename5(indexPath + ".lock", indexPath);
         indexLock = void 0;
         committed = { commit: after.head, paths: actual };
       } catch (error62) {
@@ -27293,7 +27349,7 @@ function narrowWorking(working, options, inputs) {
 }
 
 // src/commands/migrate.ts
-import { lstat as lstat10, readdir as readdir6, readFile as readFile13, rename as rename5, writeFile as writeFile6, unlink as unlink7 } from "node:fs/promises";
+import { lstat as lstat10, readdir as readdir6, readFile as readFile13, rename as rename6, writeFile as writeFile6, unlink as unlink7 } from "node:fs/promises";
 import { join as join16 } from "node:path";
 import { randomBytes as randomBytes3 } from "node:crypto";
 var operations2 = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
@@ -27384,13 +27440,13 @@ async function migrateStore(cwd, dryRun = false) {
     ]
   });
   if (dryRun) return result("planned");
-  await rename5(from, to);
+  await rename6(from, to);
   for (const r of rewrites) {
     const full = join16(root, r.path);
     const temp = join16(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes3(8).toString("hex"));
     await writeFile6(temp, r.content, { flag: "wx" });
     try {
-      await rename5(temp, full);
+      await rename6(temp, full);
     } finally {
       await unlink7(temp).catch(() => {
       });
@@ -27410,16 +27466,16 @@ async function runMigrate(options) {
 }
 
 // src/main.ts
-var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.5.0").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.5.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.5.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.5.0"));
+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.5.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.5.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.5.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")).action((options) => runUpdate(options, "0.5.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"));
 var replaced = t2("help.deprecated");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitifact",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Git-backed requirements and change history for coding agents.",
   "license": "MIT",
   "repository": {