gitifact 0.5.0 → 0.6.0

package/dist/main.js

@@ -1537,16 +1537,16 @@ var Command = class _Command extends EventEmitter {
    * @param {Function} listener
    * @return {Command} `this` command for chaining
    */
-  hook(event, listener) {
+  hook(event2, listener) {
     const allowedValues = ["preSubcommand", "preAction", "postAction"];
-    if (!allowedValues.includes(event)) {
-      throw new Error(`Unexpected value for event passed to hook : '${event}'.
+    if (!allowedValues.includes(event2)) {
+      throw new Error(`Unexpected value for event passed to hook : '${event2}'.
 Expecting one of '${allowedValues.join("', '")}'`);
     }
-    if (this._lifeCycleHooks[event]) {
-      this._lifeCycleHooks[event].push(listener);
+    if (this._lifeCycleHooks[event2]) {
+      this._lifeCycleHooks[event2].push(listener);
     } else {
-      this._lifeCycleHooks[event] = [listener];
+      this._lifeCycleHooks[event2] = [listener];
     }
     return this;
   }
@@ -2383,15 +2383,15 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @return {(Promise|undefined)}
    * @private
    */
-  _chainOrCallHooks(promise2, event) {
+  _chainOrCallHooks(promise2, event2) {
     let result = promise2;
     const hooks = [];
-    this._getCommandAndAncestors().reverse().filter((cmd) => cmd._lifeCycleHooks[event] !== void 0).forEach((hookedCommand) => {
-      hookedCommand._lifeCycleHooks[event].forEach((callback) => {
+    this._getCommandAndAncestors().reverse().filter((cmd) => cmd._lifeCycleHooks[event2] !== void 0).forEach((hookedCommand) => {
+      hookedCommand._lifeCycleHooks[event2].forEach((callback) => {
         hooks.push({ hookedCommand, callback });
       });
     });
-    if (event === "postAction") {
+    if (event2 === "postAction") {
       hooks.reverse();
     }
     hooks.forEach((hookDetail) => {
@@ -2409,10 +2409,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @return {(Promise|undefined)}
    * @private
    */
-  _chainOrCallSubCommandHook(promise2, subCommand, event) {
+  _chainOrCallSubCommandHook(promise2, subCommand, event2) {
     let result = promise2;
-    if (this._lifeCycleHooks[event] !== void 0) {
-      this._lifeCycleHooks[event].forEach((hook) => {
+    if (this._lifeCycleHooks[event2] !== void 0) {
+      this._lifeCycleHooks[event2].forEach((hook) => {
         result = this._chainOrCall(result, () => {
           return hook(this, subCommand);
         });
@@ -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 };
 }
@@ -3775,9 +3779,9 @@ function parseDesignPreview(source2, specId) {
         fence = void 0;
       return line;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       return line;
     }
     if (/^#\s/.test(line))
@@ -3828,9 +3832,9 @@ function parseDocument(path3, source2) {
         fence = void 0;
       continue;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       continue;
     }
     if (/^#\s/.test(line))
@@ -3928,9 +3932,9 @@ function extractLinks(body) {
         fence = void 0;
       continue;
     }
-    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line);
-    if (open6) {
-      fence = { char: open6[1][0], size: open6[1].length };
+    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line);
+    if (open5) {
+      fence = { char: open5[1][0], size: open5[1].length };
       continue;
     }
     for (const m of line.replace(/`[^`]*`/g, "").matchAll(/!?\[[^\]]*\]\((?:<([^>]+)>|([^)\s]+))(?:\s+"[^"]*")?\)/g))
@@ -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,12 +24623,15 @@ 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
+// ../../packages/contracts/dist/versions/browser-specs-v3.js
 var requirement = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), body: external_exports.string() });
 var contributor = external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string() });
 var source = external_exports.strictObject({ title: external_exports.string(), path: external_exports.string().optional(), url: external_exports.string().optional(), note: external_exports.string().optional() });
@@ -24622,34 +24648,42 @@ var feature = external_exports.strictObject({
 });
 var snapshot = requirement.extend({ specId: external_exports.string(), path: external_exports.string(), sources: external_exports.array(source).optional() }).nullable();
 var document = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
-var browserSpecsV2 = external_exports.strictObject({
+var event = external_exports.strictObject({
+  key: external_exports.string(),
+  commit: external_exports.string(),
+  date: external_exports.string(),
+  author: external_exports.string(),
+  email: external_exports.string(),
+  committer: external_exports.string(),
+  message: external_exports.string(),
+  id: external_exports.string(),
+  kind: external_exports.enum(["requirement", "design", "wiki"]).optional(),
+  types: external_exports.array(external_exports.enum(["created", "modified", "moved", "deleted"])),
+  before: snapshot,
+  after: snapshot,
+  reasons: external_exports.array(external_exports.string())
+});
+var browserSpecsV3 = external_exports.strictObject({
   contract: external_exports.literal("browser-specs"),
-  version: external_exports.literal(2),
+  version: external_exports.literal(3),
   sessionId: external_exports.string(),
   head: external_exports.string().nullable(),
   observedAt: external_exports.string(),
-  working: external_exports.boolean(),
-  features: external_exports.array(feature),
-  documents: external_exports.array(document).default([]),
-  events: external_exports.array(external_exports.strictObject({
-    key: external_exports.string(),
-    commit: external_exports.string(),
-    date: external_exports.string(),
-    author: external_exports.string(),
-    email: external_exports.string(),
-    committer: external_exports.string(),
-    message: external_exports.string(),
-    id: external_exports.string(),
-    kind: external_exports.enum(["requirement", "design", "wiki"]).optional(),
-    types: external_exports.array(external_exports.enum(["created", "modified", "moved", "deleted"])),
-    before: snapshot,
-    after: snapshot,
-    reasons: external_exports.array(external_exports.string())
-  })),
-  contributors: external_exports.array(contributor),
-  contributorsLimited: external_exports.boolean(),
+  events: external_exports.array(event),
   nextCursor: external_exports.number().int().nonnegative().nullable(),
-  boundary: external_exports.boolean()
+  boundary: external_exports.boolean(),
+  working: external_exports.boolean().optional(),
+  features: external_exports.array(feature).optional(),
+  documents: external_exports.array(document).optional(),
+  contributors: external_exports.array(contributor).optional(),
+  contributorsLimited: external_exports.boolean().optional()
+});
+var browserSpecsFirstV3 = browserSpecsV3.required({
+  working: true,
+  features: true,
+  documents: true,
+  contributors: true,
+  contributorsLimited: true
 });
 
 // ../../packages/contracts/dist/versions/changelog-v1.js
@@ -24677,25 +24711,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({
@@ -24743,14 +24758,9 @@ var messages_default2 = {
   "help.migrate": ".tryce \uC800\uC7A5\uC18C\uB97C .gitifact\uB85C \uC804\uD658 (\uACBD\uB85C\uC640 \uB9C8\uCEE4\uB9CC \uBC14\uAFB8\uACE0 ID\xB7\uC774\uC720\xB7\uC774\uB825\uC740 \uBCF4\uC874)",
   "help.migrateDryRun": "\uD30C\uC77C\uC744 \uBC14\uAFB8\uC9C0 \uC54A\uACE0 \uC804\uD658 \uACC4\uD68D \uD655\uC778",
   "help.spec": "Markdown \uBA85\uC138 \uC791\uC131\xB7\uC870\uD68C\xB7Git \uAE30\uB85D",
-  "help.deprecated": "Deprecated: 0.6.0\uC5D0\uC11C \uC81C\uAC70 \uC608\uC815. spec commit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.",
   "help.specCommit": "\uBCC0\uACBD \uC774\uC720 \uAE30\uB85D\uACFC \uAD00\uB828 \uD30C\uC77C \uCEE4\uBC0B\uC744 \uD55C \uBC88\uC5D0 \uC2E4\uD589",
   "help.specCommitFile": "reasons\xB7paths\xB7message\xB7authorization\uC744 \uB2F4\uC740 JSON \uD30C\uC77C (-\uB294 \uD45C\uC900 \uC785\uB825)",
   "help.specCommitDryRun": "\uD30C\uC77C\uC744 \uC4F0\uAC70\uB098 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uACE0 \uACB0\uACFC\uB9CC \uD655\uC778",
-  "help.specCommitPlanFile": "\uCEE4\uBC0B \uC785\uB825 \uB610\uB294 \uACC4\uD68D JSON \uD30C\uC77C",
-  "help.specPrepareFile": "expected\uC640 \uCD5C\uC885 reasons\uB97C \uB2F4\uC740 JSON \uD30C\uC77C",
-  "help.specVerifyFile": "prepare\uC758 verification \uAC1D\uCCB4\uB97C \uB2F4\uC740 JSON \uD30C\uC77C",
-  "help.specVerifyStaged": "index \uC6D0\uBB38\uB3C4 \uBE44\uAD50",
   "help.specSaveFile": "expected\uC640 operations\uB97C \uB2F4\uC740 UTF-8 JSON \uD30C\uC77C (-\uB294 \uD45C\uC900 \uC785\uB825)",
   "help.specReadRef": "\uC77D\uC744 \uCEE4\uBC0B",
   "help.specDiffFrom": "\uC774\uC804 \uCEE4\uBC0B",
@@ -24816,13 +24826,6 @@ var messages_default2 = {
   "commit.fileChangedPreparing": "\uCEE4\uBC0B \uC900\uBE44 \uC911 \uD30C\uC77C\xB7\uC815\uCC45\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4: {path}",
   "commit.resultUnknown": "\uCEE4\uBC0B \uACB0\uACFC\uB97C \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "commit.uncertain": "Git \uC2E4\uD589 \uACB0\uACFC\uB97C \uD655\uC778\uD574\uC57C \uD569\uB2C8\uB2E4. \uC7AC\uC2DC\uB3C4\uD558\uC9C0 \uB9D0\uACE0 HEAD\uC640 \uBCF5\uAD6C \uC790\uB8CC\uB97C \uD655\uC778\uD558\uC138\uC694: {path}",
-  "commit.existingStagingPlan": "\uAE30\uC874 staging\uC744 \uBCF4\uC874\uD569\uB2C8\uB2E4. \uC120\uD0DD \uBC94\uC704\uB97C \uC815\uB9AC\uD55C \uD6C4 \uB2E4\uC2DC \uACC4\uD68D\uD558\uC138\uC694.",
-  "commit.designUseSpecCommit": "\uC124\uACC4 \uBCC0\uACBD\uC740 spec commit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.",
-  "commit.indexChangedPlanning": "\uACC4\uD68D \uC911 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.",
-  "commit.planCorrupted": "\uCEE4\uBC0B \uACC4\uD68D\uC774 \uC190\uC0C1\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uACC4\uD68D\uD558\uC138\uC694.",
-  "commit.planScope": "\uACC4\uD68D\uC758 \uC800\uC7A5\uC18C \uB610\uB294 \uD30C\uC77C \uBC94\uC704\uAC00 \uB2E4\uB985\uB2C8\uB2E4.",
-  "commit.planStale": "\uACC4\uD68D \uC774\uD6C4 \uD30C\uC77C\xB7\uC815\uCC45\xB7index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uACC4\uD68D\uD558\uC138\uC694.",
-  "commit.indexChangedLocked": "\uC7A0\uAE08 \uC911 index\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.",
   "store.legacyLock": "\uC774\uC804 Tryce \uC2E4\uD589\uC758 \uC7A0\uAE08 \uB610\uB294 \uBCF5\uAD6C \uC790\uB8CC\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {path}",
   "store.storeNotDirectory": ".gitifact\uB294 \uC77C\uBC18 \uB514\uB809\uD130\uB9AC\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "store.migrateFirst": ".tryce \uC800\uC7A5\uC18C\uC785\uB2C8\uB2E4. gitifact migrate\uB85C .gitifact\uC5D0 \uC804\uD658\uD55C \uB4A4 \uC0AC\uC6A9\uD558\uC138\uC694.",
@@ -24884,18 +24887,8 @@ var messages_default2 = {
   "reader.blobShape": "\uAC80\uD1A0 \uC870\uD68C blob \uD615\uC2DD \uB610\uB294 1 MiB \uD55C\uB3C4\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "reader.totalLimit": "\uBA85\uC138 \uC804\uCCB4 \uC870\uD68C 16 MiB \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.",
   "reader.blobBoundary": "Git blob \uC751\uB2F5 \uACBD\uACC4\uAC00 \uB2E4\uB985\uB2C8\uB2E4.",
-  "prepare.integrationInProgress": "Git \uD1B5\uD569 \uC791\uC5C5 \uC911\uC5D0\uB294 \uC2E4\uD5D8\uC6A9 \uCEE4\uBC0B \uC900\uBE44\uB97C \uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
+  "prepare.integrationInProgress": "Git \uD1B5\uD569 \uC791\uC5C5 \uC911\uC5D0\uB294 \uBA85\uC138\uB97C \uC77D\uC5B4 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "prepare.headChanged": "HEAD \uB610\uB294 \uBE0C\uB79C\uCE58\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. changes\uBD80\uD130 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.",
-  "prepare.invalidInput": "\uC798\uBABB\uB41C \uC900\uBE44 \uC785\uB825\uC785\uB2C8\uB2E4.",
-  "prepare.expectedReasons": "expected\uC640 reasons\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
-  "prepare.staleInput": "\uC900\uBE44 \uC785\uB825\uC774 \uC624\uB798\uB410\uC2B5\uB2C8\uB2E4. changes\uBD80\uD130 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.",
-  "prepare.invalidVerifyInput": "\uC798\uBABB\uB41C \uD655\uC778 \uC785\uB825\uC785\uB2C8\uB2E4.",
-  "prepare.verificationRequired": "prepare\uAC00 \uBC18\uD658\uD55C verification \uAC1D\uCCB4\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
-  "prepare.changedAfterPrepare": "\uC900\uBE44 \uB4A4 HEAD \uB610\uB294 \uBA85\uC138\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC900\uBE44\uD558\uC138\uC694.",
-  "prepare.stagingScope": "staging\uC758 \uBA85\uC138 \uBC94\uC704\uAC00 \uC900\uBE44\uD55C \uC6D0\uBB38\uACFC \uB2E4\uB985\uB2C8\uB2E4.",
-  "prepare.stagingContent": "staging \uC6D0\uBB38\uC774 \uC900\uBE44\uD55C \uD30C\uC77C\uACFC \uB2E4\uB985\uB2C8\uB2E4: {path}",
-  "prepare.stagingChanged": "\uD655\uC778 \uC911 staging\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.",
-  "prepare.specsChanged": "\uD655\uC778 \uC911 \uBA85\uC138\uAC00 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4.",
   "commitFiles.relativePath": "\uC800\uC7A5\uC18C \uC0C1\uB300 \uACBD\uB85C\uC758 \uBA85\uC138 \uB610\uB294 \uC77C\uBC18 \uD30C\uC77C\uB9CC \uC120\uD0DD\uD558\uC138\uC694.",
   "commitFiles.linkOrDirectory": "\uB9C1\uD06C\xB7\uB514\uB809\uD130\uB9AC\xB7\uD2B9\uC218 \uD30C\uC77C\uC740 \uC120\uD0DD\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "commitFiles.nestedRepository": "\uC911\uCCA9 \uC800\uC7A5\uC18C\uB294 \uC120\uD0DD\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -24910,6 +24903,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 +24913,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.",
@@ -24954,6 +24949,7 @@ var messages_default2 = {
   "docs.summary.workflow": "\uC2DC\uC791 \uC2DC \uD655\uC778\uD560 \uAC83, \uC694\uAD6C\uC0AC\uD56D\uC73C\uB85C \uB0A8\uAE38 \uC694\uCCAD\uC758 \uAD6C\uBD84, \uB9C8\uBB34\uB9AC \uBCF4\uACE0",
   "docs.summary.spec": "\uC0AC\uC6A9\uC790 \uC2A4\uD1A0\uB9AC\xB7\uC218\uC6A9 \uC870\uAC74 \uD615\uC2DD, ID \uADDC\uCE59, spec save \uC785\uB825",
   "docs.summary.design": "design.md \uBAA9\uCC28, \uCC38\uC870 \uC8FC\uC11D\uACFC \uCC38\uACE0 \uBB38\uC11C, \uAC1C\uC815 \uBC29\uC2DD",
+  "docs.summary.writing": "\uC704\uD0A4\xB7\uC694\uAD6C\uC0AC\uD56D\xB7\uC124\uACC4\uC5D0 \uACF5\uD1B5\uC73C\uB85C \uC801\uC6A9\uD558\uB294 \uBB38\uCCB4, \uC778\uC6A9\uACFC Alert, AI \uC2AC\uB86D \uC81C\uAC70",
   "docs.summary.commit": "spec commit \uC785\uB825, \uC774\uC720 \uAE30\uB85D, \uC2E4\uD328 \uD6C4 \uBCF5\uAD6C",
   "help.browserNoUpdateCheck": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC744 \uC704\uD55C npm \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC870\uD68C\uB97C \uB054 (GITIFACT_NO_UPDATE_CHECK\uC640 \uAC19\uC74C)",
   "help.updateCommit": "\uAC31\uC2E0\uD55C GITIFACT \uBE14\uB85D\uC774 HEAD\uC640 \uBE14\uB85D \uC548\uC5D0\uC11C\uB9CC \uB2E4\uB974\uBA74 \uADF8 \uD30C\uC77C\uB9CC \uACE0\uC815 \uBA54\uC2DC\uC9C0\uB85C \uCEE4\uBC0B",
@@ -25331,7 +25327,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 +25379,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 +25414,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 +25445,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 +25518,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 +25542,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 +25627,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;
@@ -25688,9 +25685,10 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
     const current = await readWorkingPreviewState(root);
     const bare = current.specs.map(({ history: _history, ...s }) => ({ ...s, contributors: [], updatedAt: null }));
     const bareDocuments = current.wiki.documents.map((d) => ({ ...d, updatedAt: null }));
-    if (!base.head) return browserSpecsV2.parse({ contract: "browser-specs", version: 2, sessionId, head: null, observedAt: (/* @__PURE__ */ new Date()).toISOString(), working: bare.length > 0 || bareDocuments.length > 0, features: bare, documents: bareDocuments, events: [], contributors: [], contributorsLimited: false, nextCursor: null, boundary: false });
+    if (!base.head) return browserSpecsV3.parse({ contract: "browser-specs", version: 3, sessionId, head: null, observedAt: (/* @__PURE__ */ new Date()).toISOString(), working: bare.length > 0 || bareDocuments.length > 0, features: bare, documents: bareDocuments, events: [], contributors: [], contributorsLimited: false, nextCursor: null, boundary: false });
     const head = base.head;
-    const features = await Promise.all(bare.map(async (feature2) => {
+    const first = cursor === 0;
+    const features = !first ? void 0 : await Promise.all(bare.map(async (feature2) => {
       const folder = feature2.path.replace(/^\.(?:gitifact|tryce)\/(spec\/[^/]+)\/requirements\.md$/, "$1");
       const lines = (await git(["log", "--format=%aN%x00%aE%x00%aI", "--max-count=2000", head, "--", `.gitifact/${folder}`, `.tryce/${folder}`])).trim().split("\n").filter(Boolean);
       const people = /* @__PURE__ */ new Map();
@@ -25703,7 +25701,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       }
       return { ...feature2, contributors: [...people.values()].sort((a, b) => b.commits - a.commits), updatedAt: lines[0]?.split("\0")[2] ?? null };
     }));
-    const documents = await Promise.all(bareDocuments.map(async (doc) => ({ ...doc, updatedAt: (await git(["log", "--format=%aI", "--max-count=1", head, "--", doc.path])).trim() || null })));
+    const documents = !first ? void 0 : await Promise.all(bareDocuments.map(async (doc) => ({ ...doc, updatedAt: (await git(["log", "--format=%aI", "--max-count=1", head, "--", doc.path])).trim() || null })));
     const documentDirs = [WIKI_DIR];
     const [rows, dirty] = await Promise.all([
       git([
@@ -25718,9 +25716,9 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
         ...[".gitifact", ".tryce"].flatMap((d) => [`:(glob)${d}/spec/*/requirements.md`, `:(glob)${d}/spec/*/design.md`, `:(glob)${d}/spec/*/history.jsonl`]),
         ...documentDirs.flatMap((d) => [`:(glob)${d}/**/*.md`, `:(glob)${d}/history.jsonl`])
       ]),
-      git(["status", "--porcelain=v1", "--", ".gitifact/spec", ...documentDirs])
+      first ? git(["status", "--porcelain=v1", "--", ".gitifact/spec", ...documentDirs]) : Promise.resolve("")
     ]);
-    {
+    if (first) {
       const people = /* @__PURE__ */ new Map();
       const lines = (await git(["log", "--format=%aN%x00%aE%x00%aI", "--max-count=10001", head])).trim().split("\n").filter(Boolean);
       for (const line of lines.slice(0, 1e4)) {
@@ -25765,20 +25763,16 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       }));
     }));
     if (await readHead() !== head || (await readWorkingPreviewState(root)).stamp !== current.stamp) throw new SpecPreviewError(t2("specReader.projectChanged"));
-    return browserSpecsV2.parse({
+    return browserSpecsV3.parse({
       contract: "browser-specs",
-      version: 2,
+      version: 3,
       sessionId,
       head,
       observedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      working: !!dirty.trim(),
-      features,
-      documents,
       events: groups.flat(),
-      contributors: peopleCache.data,
-      contributorsLimited: peopleCache.limited,
       nextCursor: commits.length > 10 ? cursor + 10 : null,
-      boundary
+      boundary,
+      ...first ? { working: !!dirty.trim(), features, documents, contributors: peopleCache?.data ?? [], contributorsLimited: peopleCache?.limited ?? false } : {}
     });
   }
   return (cursor = 0, head) => {
@@ -26108,7 +26102,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 +26172,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);
@@ -26192,7 +26186,7 @@ import { readFile as readFile8 } from "node:fs/promises";
 // src/commands/docs.ts
 import { lstat as lstat5, readFile as readFile7 } from "node:fs/promises";
 import { dirname as dirname3, join as join8 } from "node:path";
-var docTopics = ["workflow", "spec", "design", "wiki", "commit"];
+var docTopics = ["workflow", "spec", "design", "wiki", "writing", "commit"];
 var isDocTopic = (value) => docTopics.includes(value);
 var readBundledDoc = (name, lang) => readFile7(new URL("./i18n/" + lang + "/docs/" + name + ".md", import.meta.url), "utf8");
 var info3 = (path3) => lstat5(path3).catch((e) => {
@@ -26389,22 +26383,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 +26415,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 +26458,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 +26475,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 +26504,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;
   }
 }
@@ -26634,10 +26674,10 @@ async function runUpdate(options, version2) {
 }
 
 // src/commands/spec-preview.ts
-import { join as join15 } from "node:path";
-import { readFile as readFile12, stat as stat2 } from "node:fs/promises";
+import { join as join14 } from "node:path";
+import { readFile as readFile11, stat as stat2 } from "node:fs/promises";
 
-// src/adapters/filesystem/spec-preview-prepare.ts
+// src/adapters/filesystem/spec-preview-context.ts
 import { lstat as lstat6 } from "node:fs/promises";
 import { join as join10 } from "node:path";
 import { createHash as createHash4 } from "node:crypto";
@@ -26680,44 +26720,6 @@ async function readFinalPreviewChanges(cwd) {
   const pendingReasons = pendingPreviewReasons(c.bundle, current.bundle);
   return { base: c.base, expected: expected(c.base, current.stamp), stamp: current.stamp, pendingReasons, ...delta };
 }
-async function prepareWorkingPreview(cwd, input2, publish) {
-  if (!input2 || typeof input2 !== "object" || Array.isArray(input2)) fail5(t2("prepare.invalidInput"));
-  const request = input2;
-  if (Object.keys(request).sort().join(",") !== "expected,reasons" || typeof request.expected !== "string") fail5(t2("prepare.expectedReasons"));
-  const c = await context(cwd);
-  const current = await readWorkingPreviewState(cwd);
-  if (request.expected !== expected(c.base, current.stamp)) fail5(t2("prepare.staleInput"));
-  const result = await previewTransaction(cwd, current.stamp, async (before) => {
-    await c.recheck();
-    const prepared = prepareSpecPreview(c.bundle, before.bundle, c.files, before.files, request.reasons, () => generatePreviewId("H"));
-    return { writes: prepared.writes, data: { changes: prepared.changes, specChanges: prepared.specChanges, reasons: prepared.reasons, withoutReason: prepared.withoutReason }, recheck: c.recheck };
-  }, publish);
-  return { ...result, base: c.base, expected: expected(c.base, result.stamp), verification: { base: c.base, stamp: result.stamp } };
-}
-async function verifyPreparedPreview(cwd, input2, staged) {
-  if (!input2 || typeof input2 !== "object" || Array.isArray(input2)) fail5(t2("prepare.invalidVerifyInput"));
-  const request = input2;
-  if (Object.keys(request).sort().join(",") !== "base,stamp" || typeof request.stamp !== "string") fail5(t2("prepare.verificationRequired"));
-  const c = await context(cwd);
-  const current = await readWorkingPreviewState(cwd);
-  if (!same(request.base, c.base) || request.stamp !== current.stamp) fail5(t2("prepare.changedAfterPrepare"));
-  finalSpecPreviewChanges(c.bundle, current.bundle);
-  comparePreviewBundles(c.bundle, current.bundle);
-  if (staged) {
-    const index = await c.reader.index();
-    if (index.size !== current.files.size) fail5(t2("prepare.stagingScope"));
-    for (const [path3, source2] of current.files) {
-      const oid2 = index.get(path3);
-      const bytes = Buffer.from(source2);
-      const hash3 = createHash4(oid2?.length === 64 ? "sha256" : "sha1").update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
-      if (oid2 !== hash3) fail5(t2("prepare.stagingContent", { path: path3 }));
-    }
-    if (!same([...index], [...await c.reader.index()])) fail5(t2("prepare.stagingChanged"));
-  }
-  if ((await readWorkingPreviewState(cwd)).stamp !== current.stamp) fail5(t2("prepare.specsChanged"));
-  await c.recheck();
-  return { verified: true, scope: staged ? "staged" : "working", base: c.base, stamp: current.stamp };
-}
 
 // src/adapters/filesystem/agent-inputs.ts
 import { createHash as createHash5, randomBytes as randomBytes2 } from "node:crypto";
@@ -26784,9 +26786,9 @@ 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";
+// src/commands/spec-commit.ts
+import { createHash as createHash7, randomUUID as randomUUID6 } from "node:crypto";
+import { mkdir as mkdir6, open as open4, readFile as readFile10, rename as rename4, rmdir as rmdir2, unlink as unlink5, writeFile as writeFile4 } from "node:fs/promises";
 import { join as join13 } from "node:path";
 
 // src/commands/spec-commit-files.ts
@@ -26858,166 +26860,7 @@ async function checkLegacySelection(root, selected) {
   }
 }
 
-// src/commands/spec-preview-commit.ts
-var seal = (p) => hash2(JSON.stringify(p));
-async function previewCommit(cwd, action, input2) {
-  const reader = specPreviewReader(cwd);
-  const { root, gitDir } = await reader.location();
-  const runner = createGitRunner();
-  const git = (args, index) => runner(["-c", "core.fsmonitor=false", ...args], {
-    cwd: root,
-    env: {
-      ...process.env,
-      GIT_LITERAL_PATHSPECS: "1",
-      GIT_GLOB_PATHSPECS: "0",
-      GIT_NOGLOB_PATHSPECS: "0",
-      GIT_ICASE_PATHSPECS: "0",
-      GIT_OPTIONAL_LOCKS: "0",
-      GIT_NO_LAZY_FETCH: "1",
-      GIT_NO_REPLACE_OBJECTS: "1",
-      GIT_TERMINAL_PROMPT: "0",
-      ...index ? { GIT_INDEX_FILE: index } : {}
-    },
-    timeoutMs: 12e4,
-    maxBytes: 32 * 1024 * 1024
-  });
-  const indexPath = (await git(["rev-parse", "--path-format=absolute", "--git-path", "index"])).toString("utf8").trim();
-  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 = join13(gitDir, "gitifact-spec-commit.lock");
-  if (await info5(busy)) fail6(t2("commit.busy", { path: busy }));
-  if ((await staged()).length) fail6(t2("commit.existingStagingPlan"));
-  const request = object3(input2);
-  let plan;
-  if (action === "plan") {
-    if (Object.keys(request).some((k) => !["verification", "paths", "message", "requirements", "authorization", "policyFiles"].includes(k))) fail6(t2("commit.unknownField"));
-    await verifyPreparedPreview(cwd, request.verification, false);
-    const selected2 = paths(request.paths);
-    const authorization = object3(request.authorization);
-    await checkLegacySelection(root, selected2);
-    if (Object.keys(authorization).sort().join(",") !== "basis,evidence" || !["user-request", "project-policy"].includes(String(authorization.basis))) fail6(t2("commit.authorizationRequired"));
-    const message = text(request.message, 4e3);
-    if (/^\s*Gitifact-/im.test(message)) fail6(t2("commit.trailerInMessage"));
-    const state = await readWorkingPreviewState(cwd);
-    const base = await reader.baseline();
-    const previous = base.head ? await reader.files(base.head, state.config !== void 0) : /* @__PURE__ */ new Map();
-    const pending = [.../* @__PURE__ */ new Set([...previous.keys(), ...state.files.keys()])].filter((p) => previous.get(p) !== state.files.get(p));
-    if (pending.some((p) => !selected2.includes(p))) fail6(t2("commit.selectPending"));
-    const delta = await readFinalPreviewChanges(cwd);
-    const references = request.requirements ?? [];
-    if (!Array.isArray(references) || references.length > 1e3 || references.some((r) => typeof r !== "string")) fail6(t2("commit.invalidReferences"));
-    if (delta.changes.some((c) => c.kind === "design")) fail6(t2("commit.designUseSpecCommit"));
-    const known = /* @__PURE__ */ new Set([...state.specs.flatMap((s) => s.requirements.map((r) => r.id)), ...delta.changes.map((c) => c.id)]);
-    if (references.some((r) => !known.has(r))) fail6(t2("commit.unknownRequirement"));
-    const extra = request.policyFiles === void 0 ? [] : paths(request.policyFiles, 1024);
-    const contents = async (list) => Promise.all(list.map(async (path3) => ({ path: path3, hash: await fingerprint(root, path3) })));
-    const data2 = {
-      kind: "spec-preview-commit",
-      root,
-      verification: request.verification,
-      index: hash2(await optional2(indexPath) ?? Buffer.alloc(0)),
-      files: await contents(selected2),
-      context: await contents([.../* @__PURE__ */ new Set([...policyPaths(selected2), ...extra])].sort()),
-      message,
-      requirements: [.../* @__PURE__ */ new Set([...references, ...delta.changes.map((c) => c.id)])].sort(),
-      authorization: { basis: String(authorization.basis), evidence: text(authorization.evidence, 2e3) }
-    };
-    await verifyPreparedPreview(cwd, request.verification, false);
-    if (data2.index !== hash2(await optional2(indexPath) ?? Buffer.alloc(0)) || (await staged()).length) fail6(t2("commit.indexChangedPlanning"));
-    return { outcome: "planned", plan: { ...data2, digest: seal(data2) }, committed: false };
-  }
-  const { digest: digest2, ...data } = request;
-  if (request.kind !== "spec-preview-commit" || typeof digest2 !== "string" || digest2 !== seal(data)) fail6(t2("commit.planCorrupted"));
-  plan = request;
-  if (plan.root !== root || !Array.isArray(plan.files) || !Array.isArray(plan.context)) fail6(t2("commit.planScope"));
-  const selected = paths(plan.files.map((f) => f.path));
-  const refreshed = await previewCommit(cwd, "plan", {
-    verification: plan.verification,
-    paths: selected,
-    message: plan.message,
-    requirements: plan.requirements,
-    authorization: plan.authorization,
-    policyFiles: plan.context.map((f) => f.path)
-  });
-  if (!("plan" in refreshed) || refreshed.plan.digest !== plan.digest) fail6(t2("commit.planStale"));
-  const before = await reader.baseline();
-  const original = await optional2(indexPath);
-  await mkdir6(busy);
-  const draftLock = join13(gitDir, "gitifact-spec-preview.lock");
-  let draftOwned = false;
-  let indexLock;
-  let uncertain = false;
-  let commitStarted = false;
-  const temporary = join13(gitDir, "gitifact-commit-index-" + randomUUID6());
-  const checkFiles = async () => {
-    for (const f of [...plan.files, ...plan.context]) if (f.hash !== await fingerprint(root, f.path)) fail6(t2("commit.fileChangedPreparing", { path: f.path }));
-    if ((await readLockedPreviewState(root)).stamp !== object3(plan.verification).stamp) fail6(t2("commit.specsChangedPreparing"));
-    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info5(join13(gitDir, name))) fail6(t2("commit.integrationStarted"));
-  };
-  try {
-    await verifyPreparedPreview(cwd, plan.verification, false);
-    await mkdir6(draftLock);
-    draftOwned = true;
-    indexLock = await open4(indexPath + ".lock", "wx", 384);
-    if (plan.index !== hash2(await optional2(indexPath) ?? Buffer.alloc(0)) || (await staged()).length) fail6(t2("commit.indexChangedLocked"));
-    await writeFile4(join13(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
-    if (original) await writeFile4(temporary, original, { flag: "wx" });
-    else await git(["read-tree", "--empty"], temporary);
-    await git(["add", "--", ...selected], temporary);
-    const actual = await staged(temporary);
-    if (!actual.length || actual.some((p) => !selected.includes(p))) fail6(t2("commit.unexpectedFiles"));
-    for (const file2 of plan.files.filter((f) => record2(f.path) && f.hash !== null)) {
-      const stagedBytes = await git(["show", ":" + file2.path], temporary);
-      if (!stagedBytes.equals(await readFile10(join13(root, file2.path)))) fail6(t2("commit.filterChanged"));
-    }
-    await checkFiles();
-    if (JSON.stringify(before) !== JSON.stringify(await reader.baseline())) fail6(t2("commit.headChanged"));
-    const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
-    const trailers = plan.requirements.map((id) => "Gitifact-Req: " + id);
-    commitStarted = true;
-    await git(["commit", "-m", plan.message.trim() + (trailers.length ? "\n\n" + trailers.join("\n") : "")], temporary);
-    const after = await reader.baseline();
-    const actualTree = (await git(["rev-parse", "HEAD^{tree}"])).toString("utf8").trim();
-    const parents = (await git(["rev-list", "--parents", "-n", "1", "HEAD"])).toString("utf8").trim().split(" ").slice(1);
-    const message = (await git(["log", "-1", "--format=%B"])).toString("utf8");
-    if (actualTree !== tree || after.branch !== before.branch || JSON.stringify(parents) !== JSON.stringify(before.head ? [before.head] : []) || trailers.some((t3) => !message.split(/\r?\n/).includes(t3))) fail6(t2("commit.resultAltered"));
-    if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== plan.index) fail6(t2("commit.indexChangedAfter"));
-    if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail6(t2("commit.hookChangedStaging"));
-    await indexLock.writeFile(await readFile10(temporary));
-    await indexLock.sync();
-    await indexLock.close();
-    await rename3(indexPath + ".lock", indexPath);
-    indexLock = void 0;
-    return { outcome: "committed", commit: after.head, paths: actual, requirements: plan.requirements, pushed: false };
-  } catch (error62) {
-    if (commitStarted) {
-      try {
-        uncertain = JSON.stringify(before) !== JSON.stringify(await reader.baseline());
-      } catch {
-        uncertain = true;
-      }
-    }
-    if (uncertain) fail6(t2("commit.uncertain", { path: busy }));
-    throw error62;
-  } finally {
-    await indexLock?.close().catch(() => {
-    });
-    if (!uncertain) {
-      if (indexLock) await unlink5(indexPath + ".lock").catch(() => {
-      });
-      await unlink5(temporary).catch(() => {
-      });
-      await unlink5(join13(busy, "recovery.json")).catch(() => {
-      });
-      await rmdir2(busy);
-      if (draftOwned) await rmdir2(draftLock);
-    }
-  }
-}
-
 // 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 { 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"];
 var same2 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
@@ -27056,7 +26899,7 @@ async function specCommit(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 = join14(gitDir, "gitifact-spec-commit.lock");
+  const busy = join13(gitDir, "gitifact-spec-commit.lock");
   await failOnLegacyLock(gitDir);
   if (await info5(busy)) fail6(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail6(t2("commit.existingStaging"));
@@ -27067,7 +26910,7 @@ async function specCommit(cwd, input2, dryRun) {
   const prepared = prepareSpecPreview(c.bundle, current.bundle, c.files, current.files, reasons, () => generatePreviewId("H"));
   const blobId = (text2) => {
     const bytes = Buffer.from(text2);
-    return createHash8(objectFormat).update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
+    return createHash7(objectFormat).update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
   };
   const present = [...current.files.keys()];
   if (present.some((p) => p.includes("\n"))) fail6(t2("commit.newlinePath"));
@@ -27110,14 +26953,14 @@ async function specCommit(cwd, input2, dryRun) {
     ...prepared.changes.filter((c2) => c2.kind === "design").map((c2) => "Gitifact-Design: " + c2.id),
     ...prepared.changes.filter((c2) => c2.kind === "wiki").map((c2) => "Gitifact-Doc: " + c2.id)
   ];
-  const temporary = join14(gitDir, "gitifact-commit-index-" + randomUUID7());
+  const temporary = join13(gitDir, "gitifact-commit-index-" + randomUUID6());
   let owned = false;
   let uncertain = false;
   let indexLock;
   let committed;
   try {
     try {
-      await mkdir7(busy);
+      await mkdir6(busy);
       owned = true;
     } catch (e) {
       if (e.code === "EEXIST") fail6(t2("commit.busy", { path: busy }));
@@ -27126,13 +26969,13 @@ async function specCommit(cwd, input2, dryRun) {
     await previewTransaction(cwd, current.stamp, async () => ({ writes, data: {}, recheck: c.recheck }), rename4, async (published) => {
       let commitStarted = false;
       try {
-        const lock = indexLock = await open5(indexPath + ".lock", "wx", 384);
+        const lock = indexLock = await open4(indexPath + ".lock", "wx", 384);
         const original = await optional2(indexPath);
         if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail6(t2("commit.indexChanged"));
         const locked = await hashes([.../* @__PURE__ */ new Set([...selected, ...contextPaths])]);
         for (const [path3, value] of started) if (locked.get(path3) !== value) fail6(t2("commit.fileChangedRunning", { path: path3 }));
-        await writeFile5(join14(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
-        if (original) await writeFile5(temporary, original, { flag: "wx" });
+        await writeFile4(join13(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
+        if (original) await writeFile4(temporary, original, { flag: "wx" });
         else await git(["read-tree", "--empty"], temporary);
         await git(["add", "--", ...stageable], temporary);
         const actual = await staged(temporary);
@@ -27147,7 +26990,7 @@ async function specCommit(cwd, input2, dryRun) {
             const size = Number(header[2]);
             if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail6(t2("commit.stagedUnreadable", { path: path3 }));
             const staged2 = output2.subarray(end + 1, end + 1 + size);
-            const file2 = await readFile11(join14(root, path3));
+            const file2 = await readFile10(join13(root, path3));
             if (!staged2.equals(file2) && !staged2.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail6(t2("commit.filterChanged"));
             offset = end + size + 2;
           }
@@ -27155,7 +26998,7 @@ async function specCommit(cwd, input2, dryRun) {
         const again = await hashes([...locked.keys()]);
         for (const [path3, value] of locked) if (again.get(path3) !== value) fail6(t2("commit.fileChangedPreparing", { path: path3 }));
         if ((await readLockedPreviewState(root)).stamp !== published.stamp) fail6(t2("commit.specsChangedPreparing"));
-        for (const name of integration) if (await info5(join14(gitDir, name))) fail6(t2("commit.integrationStarted"));
+        for (const name of integration) if (await info5(join13(gitDir, name))) fail6(t2("commit.integrationStarted"));
         if (!same2(c.base, await c.reader.baseline())) fail6(t2("commit.headChanged"));
         const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
         commitStarted = true;
@@ -27170,7 +27013,7 @@ async function specCommit(cwd, input2, dryRun) {
         if (headers[0] !== "tree " + tree || after.branch !== c.base.branch || !same2(parents, c.base.head ? [c.base.head] : []) || trailers.some((t3) => !body.split(/\r?\n/).includes(t3))) fail6(t2("commit.resultAltered"));
         if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== indexHash) fail6(t2("commit.indexChangedAfter"));
         if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail6(t2("commit.hookChangedStaging"));
-        await lock.writeFile(await readFile11(temporary));
+        await lock.writeFile(await readFile10(temporary));
         await lock.sync();
         await lock.close();
         await rename4(indexPath + ".lock", indexPath);
@@ -27192,14 +27035,14 @@ async function specCommit(cwd, input2, dryRun) {
     await indexLock?.close().catch(() => {
     });
     if (!uncertain) {
-      if (indexLock) await unlink6(indexPath + ".lock").catch(() => {
+      if (indexLock) await unlink5(indexPath + ".lock").catch(() => {
       });
-      await unlink6(temporary).catch(() => {
+      await unlink5(temporary).catch(() => {
       });
       if (owned) {
-        await unlink6(join14(busy, "recovery.json")).catch(() => {
+        await unlink5(join13(busy, "recovery.json")).catch(() => {
         });
-        await rmdir3(busy);
+        await rmdir2(busy);
       }
     }
   }
@@ -27214,14 +27057,14 @@ async function execute(action, options, controls) {
   try {
     const guard = specPreviewReader(process.cwd());
     const { root, gitDir, objectFormat } = await guard.location();
-    for (const marker2 of operations) if (await fileInfo(join15(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join14(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await guard.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
     const raw = await readConfigFile(root);
     if (raw === void 0) throw new SpecPreviewError(t2("preview.notInitialized"));
     const config2 = parseManagedConfig(raw);
     if (!("schemaVersion" in config2)) throw new SpecPreviewError(t2("preview.legacyProject"));
     await initRepository(root).validateBaseline(config2, root, "HEAD", objectFormat);
-    if (["working", "save", "changes", "prepare", "verify", "commit-plan", "commit-apply", "commit"].includes(action)) {
+    if (["working", "save", "changes", "commit"].includes(action)) {
       let result;
       const inputs = () => prepareAgentInputs(root, controls).catch(() => void 0);
       if (action === "working") result = narrowWorking(await readWorkingPreview(process.cwd()), options, await inputs());
@@ -27235,7 +27078,7 @@ async function execute(action, options, controls) {
         } catch {
           throw new SpecPreviewError(t2("preview.inputJson"));
         }
-        result = action === "commit" ? await specCommit(process.cwd(), input2, !!options.dryRun) : action === "commit-plan" || action === "commit-apply" ? await previewCommit(process.cwd(), action === "commit-plan" ? "plan" : "apply", input2) : action === "prepare" ? await prepareWorkingPreview(process.cwd(), input2) : action === "verify" ? await verifyPreparedPreview(process.cwd(), input2, !!options.staged) : await saveWorkingPreview(process.cwd(), input2);
+        result = action === "commit" ? await specCommit(process.cwd(), input2, !!options.dryRun) : await saveWorkingPreview(process.cwd(), input2);
         const consumed = action === "save" || action === "commit" && result.outcome === "committed";
         if (consumed && options.file !== "-") result = { ...result, inputRemoved: await discardAgentInput(root, options.file, controls) };
       }
@@ -27261,7 +27104,7 @@ async function execute(action, options, controls) {
 async function readInputFile(path3) {
   const source2 = await stat2(path3);
   if (!source2.isFile() || source2.size > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputFile"));
-  return readFile12(path3);
+  return readFile11(path3);
 }
 async function readStdin(stream) {
   const chunks = [];
@@ -27293,11 +27136,11 @@ 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 { join as join16 } from "node:path";
+import { lstat as lstat9, readdir as readdir6, readFile as readFile12, rename as rename5, writeFile as writeFile5, unlink as unlink6 } from "node:fs/promises";
+import { join as join15 } 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"];
-var info6 = (path3) => lstat10(path3).catch((e) => {
+var info6 = (path3) => lstat9(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -27308,18 +27151,18 @@ var fail7 = (code, message) => {
 async function migrateStore(cwd, dryRun = false) {
   const reader = specPreviewReader(cwd);
   const { root, gitDir } = await reader.location();
-  for (const marker3 of operations2) if (await info6(join16(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker3 }));
+  for (const marker3 of operations2) if (await info6(join15(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker3 }));
   if (await reader.hasUnmerged()) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
-  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info6(join16(gitDir, name))) fail7("LOCKED", t2("migrate.locked", { path: join16(gitDir, name) }));
-  const from = join16(root, ".tryce");
-  const to = join16(root, ".gitifact");
+  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info6(join15(gitDir, name))) fail7("LOCKED", t2("migrate.locked", { path: join15(gitDir, name) }));
+  const from = join15(root, ".tryce");
+  const to = join15(root, ".gitifact");
   const fromInfo = await info6(from);
   if (await info6(to)) fail7("ALREADY_MIGRATED", t2("migrate.alreadyMigrated"));
   if (!fromInfo) return fail7("NOTHING_TO_MIGRATE", t2("migrate.nothingToMigrate"));
   if (!fromInfo.isDirectory() || fromInfo.isSymbolicLink()) fail7("PATH_CONFLICT", t2("migrate.notDirectory"));
-  const configInfo = await info6(join16(from, "config.json"));
+  const configInfo = await info6(join15(from, "config.json"));
   if (!configInfo?.isFile() || configInfo.isSymbolicLink()) fail7("NOT_INITIALIZED", t2("migrate.noConfig"));
-  const config2 = parseManagedConfig(decode4(await readFile13(join16(from, "config.json"))));
+  const config2 = parseManagedConfig(decode4(await readFile12(join15(from, "config.json"))));
   if (!("schemaVersion" in config2)) fail7("UNSUPPORTED_FORMAT", t2("migrate.legacyJson"));
   const top = (await readdir6(from)).sort();
   if (top.some((name) => name !== "config.json" && name !== "spec")) fail7("UNSUPPORTED_FORMAT", t2("migrate.extraEntries"));
@@ -27328,20 +27171,20 @@ async function migrateStore(cwd, dryRun = false) {
   const legacyRecords = [];
   const marker2 = /^<!-- tryce-(spec|req|design|ref): /;
   if (top.includes("spec")) {
-    for (const feature2 of (await readdir6(join16(from, "spec"))).sort()) {
-      const dir = join16(from, "spec", feature2);
+    for (const feature2 of (await readdir6(join15(from, "spec"))).sort()) {
+      const dir = join15(from, "spec", feature2);
       const stat3 = await info6(dir);
       if (!stat3?.isDirectory() || stat3.isSymbolicLink()) fail7("UNSUPPORTED_FORMAT", t2("migrate.notSpecFolder", { feature: feature2 }));
       for (const name of (await readdir6(dir)).sort()) {
         if (!["requirements.md", "design.md", "history.jsonl", "tryce.json"].includes(name)) fail7("UNSUPPORTED_FORMAT", t2("migrate.unsupportedFile", { feature: feature2, name }));
-        const fileStat = await info6(join16(dir, name));
+        const fileStat = await info6(join15(dir, name));
         if (!fileStat?.isFile() || fileStat.isSymbolicLink() || fileStat.nlink !== 1 || fileStat.size > 1024 * 1024) fail7("UNSUPPORTED_FORMAT", t2("migrate.fileTooLarge", { name }));
         const newPath = `.gitifact/spec/${feature2}/${name}`;
         if (name === "tryce.json") {
           legacyRecords.push(newPath);
           continue;
         }
-        const text2 = decode4(await readFile13(join16(dir, name)));
+        const text2 = decode4(await readFile12(join15(dir, name)));
         if (name === "history.jsonl") {
           files.set(newPath, text2);
           continue;
@@ -27352,9 +27195,9 @@ async function migrateStore(cwd, dryRun = false) {
             if (new RegExp(`^ {0,3}${fence.char}{${fence.size},}\\s*$`).test(line)) fence = void 0;
             return line;
           }
-          const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line);
-          if (open6) {
-            fence = { char: open6[1][0], size: open6[1].length };
+          const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line);
+          if (open5) {
+            fence = { char: open5[1][0], size: open5[1].length };
             return line;
           }
           return marker2.test(line) ? line.replace(/^<!-- tryce-/, "<!-- gitifact-") : line;
@@ -27386,13 +27229,13 @@ async function migrateStore(cwd, dryRun = false) {
   if (dryRun) return result("planned");
   await rename5(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" });
+    const full = join15(root, r.path);
+    const temp = join15(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes3(8).toString("hex"));
+    await writeFile5(temp, r.content, { flag: "wx" });
     try {
       await rename5(temp, full);
     } finally {
-      await unlink7(temp).catch(() => {
+      await unlink6(temp).catch(() => {
       });
     }
   }
@@ -27410,24 +27253,20 @@ 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.6.0").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.6.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.6.0"));
 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.6.0"));
 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");
 spec.command("commit").description(t2("help.specCommit")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specCommitFile")).option("--dry-run", t2("help.specCommitDryRun")).action((o) => runSpecPreview("commit", o));
-for (const action of ["commit-plan", "commit-apply"]) spec.command(action).description(replaced).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specCommitPlanFile")).action((o) => runSpecPreview(action, o));
 spec.command("changes").description(t2("help.specChanges")).allowExcessArguments(false).action((o) => runSpecPreview("changes", o));
-spec.command("prepare").description(replaced).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specPrepareFile")).action((o) => runSpecPreview("prepare", o));
-spec.command("verify").description(replaced).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specVerifyFile")).option("--staged", t2("help.specVerifyStaged")).action((o) => runSpecPreview("verify", o));
 spec.command("working").description(t2("help.specWorking")).allowExcessArguments(false).addOption(new Option("--stamp", t2("help.specWorkingStamp")).conflicts(["feature", "ids"])).option("--feature <name>", t2("help.specWorkingFeature")).option("--ids", t2("help.specWorkingIds")).action((o) => runSpecPreview("working", o));
 spec.command("save").description(t2("help.specSave")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specSaveFile")).action((o) => runSpecPreview("save", o));
 spec.command("read").description(t2("help.specRead")).allowExcessArguments(false).option("--ref <commit>", t2("help.specReadRef"), "HEAD").action((o) => runSpecPreview("read", o));