gitifact 0.3.2 → 0.4.0

package/dist/main.js

@@ -4030,6 +4030,70 @@ function comparePreviewBundles(before, after) {
   return { specChanges: specs.specChanges, changes: [...specs.changes, ...compareDocumentSets(a.documents, b.documents)] };
 }
 
+// ../../packages/core/dist/formats/changelog.js
+var changelogSections = ["added", "changed", "removed", "fixed"];
+var versionLine = /^## (\d+)\.(\d+)\.(\d+) - (\d{4})-(\d{2})-(\d{2})$/;
+var sectionLine = /^### (Added|Changed|Removed|Fixed)$/;
+var itemLine = /^- (\S.*)$/;
+var realDate = (year, month, day) => {
+  const date5 = new Date(Date.UTC(year, month - 1, day));
+  return date5.getUTCFullYear() === year && date5.getUTCMonth() === month - 1 && date5.getUTCDate() === day;
+};
+function parseChangelog(text2) {
+  const entries = [];
+  let previous;
+  let entry2;
+  let section;
+  const fail8 = (line, key, values = {}) => new InitError("INVALID_CHANGELOG", t("changelog.atLine", { line, reason: t(key, values) }));
+  const lines = text2.replace(/\r\n/g, "\n").split("\n");
+  const close = (line) => {
+    if (entry2 && changelogSections.every((name) => entry2[name].length === 0))
+      throw fail8(line, "changelog.emptyVersion", { version: entry2.version });
+  };
+  lines.forEach((raw, index) => {
+    const line = index + 1;
+    if (raw.trim() === "")
+      return;
+    const version2 = versionLine.exec(raw);
+    if (version2) {
+      close(line);
+      const core = [Number(version2[1]), Number(version2[2]), Number(version2[3])];
+      if (!realDate(Number(version2[4]), Number(version2[5]), Number(version2[6])))
+        throw fail8(line, "changelog.invalidDate", { text: raw });
+      if (previous && !(core[0] < previous[0] || core[0] === previous[0] && (core[1] < previous[1] || core[1] === previous[1] && core[2] < previous[2]))) {
+        throw fail8(line, "changelog.order", { version: core.join(".") });
+      }
+      previous = core;
+      section = void 0;
+      entry2 = { version: core.join("."), date: version2[4] + "-" + version2[5] + "-" + version2[6], added: [], changed: [], removed: [], fixed: [] };
+      entries.push(entry2);
+      return;
+    }
+    const heading = sectionLine.exec(raw);
+    if (heading) {
+      if (!entry2)
+        throw fail8(line, "changelog.sectionBeforeVersion");
+      const name = heading[1].toLowerCase();
+      if (entry2[name].length > 0)
+        throw fail8(line, "changelog.duplicateSection", { section: heading[1] });
+      section = name;
+      return;
+    }
+    const item = itemLine.exec(raw);
+    if (item) {
+      if (!entry2 || !section)
+        throw fail8(line, "changelog.itemOutsideSection");
+      entry2[section].push(item[1].trimEnd());
+      return;
+    }
+    throw fail8(line, "changelog.unknownLine", { text: raw });
+  });
+  close(lines.length);
+  if (entries.length === 0)
+    throw fail8(1, "changelog.noVersions");
+  return entries;
+}
+
 // ../../packages/core/dist/use-cases/edit-spec-preview.js
 var fail2 = (message) => {
   throw new SpecPreviewError(message);
@@ -24380,16 +24444,7 @@ var repositoryStatusFailureV1 = external_exports.strictObject({
 });
 var repositoryStatusV1 = external_exports.union([repositoryStatusSuccessV1, repositoryStatusFailureV1]);
 
-// ../../packages/contracts/dist/versions/browser-session-v1.js
-var browserSessionV1 = external_exports.strictObject({
-  contract: external_exports.literal("browser-session"),
-  version: external_exports.literal(1),
-  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}$/)
-  })
-});
+// ../../packages/contracts/dist/versions/browser-http-error-v1.js
 var browserHttpErrorV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-http-error"),
   version: external_exports.literal(1),
@@ -24489,6 +24544,42 @@ 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-v1.js
+var updateV1 = external_exports.discriminatedUnion("ok", [
+  external_exports.strictObject({
+    contract: external_exports.literal("update"),
+    version: external_exports.literal(1),
+    ok: external_exports.literal(true),
+    cliVersion: external_exports.string().min(1),
+    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(),
+    // refreshed: blocks whose version line differed were rewritten. current: every block already matched.
+    // not-initialized: no .gitifact config here, so only the version check ran. no-block: no file carries a block.
+    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()) })
+  }),
+  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(1), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+]);
+
 // src/shared/i18n/ko/messages.json
 var messages_default2 = {
   "help.program": "\uD504\uB85C\uC81D\uD2B8\uC758 \uC694\uAD6C\uC0AC\uD56D\uACFC \uACB0\uC815 \uC774\uB825\uC744 Git\uC5D0 \uB0A8\uAE30\uB294 \uB3C4\uAD6C",
@@ -24717,7 +24808,24 @@ var messages_default2 = {
   "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, \uAC1C\uC815 \uBC29\uC2DD",
   "docs.summary.product": "PRODUCT.md\uC640 guides \uBB38\uC11C\uC758 \uC5ED\uD560\uACFC \uC800\uC7A5 \uBA85\uB839",
-  "docs.summary.commit": "spec commit \uC785\uB825, \uC774\uC720 \uAE30\uB85D, \uC2E4\uD328 \uD6C4 \uBCF5\uAD6C"
+  "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.update": "\uC0C8 \uBC84\uC804 \uD655\uC778\uACFC \uC124\uCE58 \uBC29\uBC95 \uC548\uB0B4, \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68 \uD30C\uC77C\uC758 GITIFACT \uBE14\uB85D\uC744 \uD604\uC7AC \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0",
+  "server.badLanguage": "\uC5B8\uC5B4 \uCF54\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.",
+  "server.changelogNotFound": "\uD328\uCE58\uB178\uD2B8\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
+  "server.changelogUnreadable": "\uD328\uCE58\uB178\uD2B8\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
+  "update.text.current": "\uD604\uC7AC \uBC84\uC804: {version}",
+  "update.text.available": "\uC0C8 \uBC84\uC804: {version}",
+  "update.text.upToDate": "\uCD5C\uC2E0 \uBC84\uC804\uC744 \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.",
+  "update.text.disabled": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC774 \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4.",
+  "update.text.unavailable": "\uC0C8 \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.",
+  "update.text.install": "npm \uC804\uC5ED \uC124\uCE58\uC6A9: {command}",
+  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uC9C0\uCE68 \uBE14\uB85D\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0\uB429\uB2C8\uB2E4.",
+  "update.text.blockRefreshed": "\uC9C0\uCE68 \uBE14\uB85D \uAC31\uC2E0: {paths}",
+  "update.text.blockCurrent": "\uC9C0\uCE68 \uBE14\uB85D\uC740 \uC774\uBBF8 \uD604\uC7AC \uBC84\uC804\uC785\uB2C8\uB2E4: {paths}",
+  "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. gitifact init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
+  "update.text.notInitialized": "\uCD08\uAE30\uD654\uB41C \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2C8\uC5B4\uC11C \uBC84\uC804\uB9CC \uD655\uC778\uD588\uC2B5\uB2C8\uB2E4.",
+  "update.failed": "\uC5C5\uB370\uC774\uD2B8 \uD655\uC778\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4."
 };
 
 // src/shared/i18n/index.ts
@@ -24832,17 +24940,63 @@ function contentType(path3) {
 
 // src/server/status-session.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-function createStatusSession(initial, read) {
-  const session = browserSessionV1.parse({
-    contract: "browser-session",
-    version: 1,
-    sessionId: randomUUID2(),
-    repository: { key: initial.repository.key, worktreeKey: initial.repository.worktreeKey }
-  });
+
+// src/shared/update-check.ts
+var updateCheckTimeoutMs = 3e3;
+var release2 = /^(\d+)\.(\d+)\.(\d+)$/;
+var running = /^(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?$/;
+function isNewerRelease(latest, current) {
+  const next = release2.exec(latest);
+  const now = running.exec(current);
+  if (!next || !now) return false;
+  for (let index = 1; index <= 3; index++) {
+    const difference = Number(next[index]) - Number(now[index]);
+    if (difference !== 0) return difference > 0;
+  }
+  return now[4] !== void 0;
+}
+var updateCheckDisabled = (env, flagged = false) => flagged || env.GITIFACT_NO_UPDATE_CHECK !== void 0 && env.GITIFACT_NO_UPDATE_CHECK !== "" && env.GITIFACT_NO_UPDATE_CHECK !== "0";
+var checkingUpdate = { status: "checking", latestVersion: null };
+var disabledUpdate = { status: "disabled", latestVersion: null };
+async function resolveUpdate(current, fetchLatest, signal, timeoutMs = updateCheckTimeoutMs) {
+  const controller = new AbortController();
+  const abort = () => controller.abort();
+  const timer = setTimeout(abort, timeoutMs);
+  signal?.addEventListener("abort", abort, { once: true });
+  if (signal?.aborted) controller.abort();
+  try {
+    const latest = await Promise.race([
+      fetchLatest(controller.signal),
+      new Promise((_resolve, reject) => {
+        if (controller.signal.aborted) reject(new Error("aborted"));
+        else controller.signal.addEventListener("abort", () => reject(new Error("aborted")), { once: true });
+      })
+    ]);
+    if (typeof latest !== "string" || !release2.test(latest)) return { status: "unavailable", latestVersion: null };
+    return { status: isNewerRelease(latest, current) ? "available" : "up-to-date", latestVersion: latest };
+  } catch {
+    return { status: "unavailable", latestVersion: null };
+  } finally {
+    clearTimeout(timer);
+    signal?.removeEventListener("abort", abort);
+  }
+}
+var npmGlobalInstall = (version2) => "npm install -g gitifact@" + version2;
+
+// src/server/status-session.ts
+function createStatusSession(initial, read, cliVersion = "0.0.0") {
+  const identity2 = { sessionId: randomUUID2(), repository: { key: initial.repository.key, worktreeKey: initial.repository.worktreeKey } };
+  let update = disabledUpdate;
   let latest = initial;
   let pending;
   return {
-    session,
+    // The identity never changes; only the update state moves (checking → a final state), so the session is built per read.
+    get session() {
+      return browserSessionV2.parse({ contract: "browser-session", version: 2, ...identity2, cliVersion, update });
+    },
+    setUpdate(next) {
+      update = next;
+    },
     get latest() {
       return latest;
     },
@@ -24854,7 +25008,7 @@ function createStatusSession(initial, read) {
       pending = (async () => {
         try {
           const next = await read();
-          if (next.repository.key !== session.repository.key || next.repository.worktreeKey !== session.repository.worktreeKey) {
+          if (next.repository.key !== identity2.repository.key || next.repository.worktreeKey !== identity2.repository.worktreeKey) {
             throw new RepositoryReadError("REPOSITORY_CHANGED");
           }
           latest = next;
@@ -25432,6 +25586,10 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
 }
 
 // src/server/browser-server.ts
+var readBundledChangelog = (language) => readFile4(new URL("./i18n/" + language + "/changelog.md", import.meta.url), "utf8").catch((error62) => {
+  if (error62.code === "ENOENT") return null;
+  throw error62;
+});
 async function startBrowserServer(options) {
   const controller = new AbortController();
   const onAbort = () => controller.abort();
@@ -25451,11 +25609,13 @@ async function startBrowserServer(options) {
     options.signal?.removeEventListener("abort", onAbort);
     throw error62;
   }
-  const store = createStatusSession(initial, () => read(controller.signal));
-  const { session } = store;
+  const store = createStatusSession(initial, () => read(controller.signal), options.cliVersion);
+  const sessionId = store.session.sessionId;
+  const readChangelog = options.readChangelog ?? readBundledChangelog;
+  let updatePending;
   let closing = false;
   let origin = "";
-  const readSpecs = createSpecBrowserReader(initial.repository.rootPath, session.sessionId, options.env);
+  const readSpecs = createSpecBrowserReader(initial.repository.rootPath, sessionId, options.env);
   function json2(response, status, value) {
     response.writeHead(status, { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-store" });
     response.end(JSON.stringify(value) + "\n");
@@ -25493,7 +25653,7 @@ async function startBrowserServer(options) {
     const api = path3 === "/api" || path3.startsWith("/api/");
     if (api) {
       if (request.headers["sec-fetch-site"] === "cross-site" && !allowedOrigin) return fail8(response, 403, "FORBIDDEN", t2("server.crossSite"));
-      if (url2.search && path3 !== "/api/v1/specs") return fail8(response, 400, "BAD_REQUEST", t2("server.noQuery"));
+      if (url2.search && path3 !== "/api/v1/specs" && path3 !== "/api/v1/changelog") return fail8(response, 400, "BAD_REQUEST", t2("server.noQuery"));
       if (path3.startsWith("/api/v1/product/assets/")) {
         const name = path3.slice("/api/v1/product/assets/".length);
         if (request.method !== "GET") {
@@ -25510,13 +25670,13 @@ async function startBrowserServer(options) {
         return;
       }
       const method = path3 === "/api/v1/status/refresh" ? "POST" : "GET";
-      if (!["/api/v1/session", "/api/v1/status", "/api/v1/status/refresh", "/api/v1/specs"].includes(path3)) return fail8(response, 404, "NOT_FOUND", t2("server.apiNotFound"));
+      if (!["/api/v1/session", "/api/v1/status", "/api/v1/status/refresh", "/api/v1/specs", "/api/v1/changelog"].includes(path3)) return fail8(response, 404, "NOT_FOUND", t2("server.apiNotFound"));
       if (request.method !== method) {
         response.setHeader("Allow", method);
         return fail8(response, 405, "METHOD_NOT_ALLOWED", t2("server.methodNotAllowed"));
       }
-      if (path3 === "/api/v1/session") return json2(response, 200, session);
-      if (request.headers["x-gitifact-session"] !== session.sessionId) return fail8(response, 409, "SESSION_CHANGED", t2("server.sessionChanged"));
+      if (path3 === "/api/v1/session") return json2(response, 200, store.session);
+      if (request.headers["x-gitifact-session"] !== sessionId) return fail8(response, 409, "SESSION_CHANGED", t2("server.sessionChanged"));
       if (path3 === "/api/v1/specs") {
         const cursor = url2.searchParams.get("cursor") ?? "0";
         const head = url2.searchParams.get("head");
@@ -25528,6 +25688,19 @@ async function startBrowserServer(options) {
         }
         return;
       }
+      if (path3 === "/api/v1/changelog") {
+        const language = url2.searchParams.get("lang") ?? defaultLanguage2;
+        if ([...url2.searchParams.keys()].some((key) => key !== "lang") || url2.searchParams.getAll("lang").length > 1 || !/^[a-z]{2}(?:-[A-Z]{2})?$/.test(language)) return fail8(response, 400, "BAD_REQUEST", t2("server.badLanguage"));
+        try {
+          const own2 = await readChangelog(language);
+          const text2 = own2 ?? (language === defaultLanguage2 ? null : await readChangelog(defaultLanguage2));
+          if (text2 === null) return fail8(response, 404, "NOT_FOUND", t2("server.changelogNotFound"));
+          json2(response, 200, changelogV1.parse({ contract: "changelog", version: 1, language: own2 === null ? defaultLanguage2 : language, fallback: own2 === null, entries: parseChangelog(text2) }));
+        } catch (error62) {
+          fail8(response, 503, "INTERNAL_ERROR", error62 instanceof Error ? error62.message : t2("server.changelogUnreadable"));
+        }
+        return;
+      }
       if (method === "POST" && !allowedOrigin) return fail8(response, 403, "FORBIDDEN", t2("server.refreshOrigin"));
       const value = method === "POST" ? await store.refresh() : store.latest;
       if (!response.destroyed) json2(response, value.ok ? 200 : 503, value);
@@ -25573,6 +25746,12 @@ async function startBrowserServer(options) {
   const address = server.address();
   if (!address || typeof address === "string") throw new Error(t2("server.addressUnknown"));
   origin = "http://127.0.0.1:" + address.port;
+  if (options.fetchLatest) {
+    store.setUpdate(checkingUpdate);
+    updatePending = resolveUpdate(store.session.cliVersion, options.fetchLatest, controller.signal, options.updateCheckTimeoutMs).then((state) => {
+      store.setUpdate(state);
+    });
+  }
   let resolveClosed;
   const closed = new Promise((resolve) => {
     resolveClosed = resolve;
@@ -25588,6 +25767,7 @@ async function startBrowserServer(options) {
         server.closeAllConnections();
       });
       await store.pending;
+      await updatePending;
       options.signal?.removeEventListener("abort", onAbort);
       options.signal?.removeEventListener("abort", closeOnAbort);
       resolveClosed();
@@ -25599,15 +25779,28 @@ async function startBrowserServer(options) {
   };
   options.signal?.addEventListener("abort", closeOnAbort, { once: true });
   if (options.signal?.aborted) void close();
-  return { url: origin, session, close, closed };
+  return { url: origin, get session() {
+    return store.session;
+  }, close, closed };
 }
 
+// src/adapters/registry/latest-version.ts
+var manifestUrl = "https://registry.npmjs.org/gitifact";
+var fetchLatestVersion = async (signal) => {
+  const response = await fetch(manifestUrl, { signal, redirect: "error", headers: { Accept: "application/vnd.npm.install-v1+json" } });
+  if (!response.ok) throw new Error("registry status " + response.status);
+  const manifest = await response.json();
+  const latest = manifest["dist-tags"]?.latest;
+  if (typeof latest !== "string") throw new Error("registry answer has no latest tag");
+  return latest;
+};
+
 // src/commands/browser.ts
 function parsePort(value) {
   if (!/^\d+$/.test(value) || Number(value) > 65535) throw new InvalidArgumentError(t2("browser.invalidPort"));
   return Number(value);
 }
-async function runBrowser(options) {
+async function runBrowser(options, version2) {
   const controller = new AbortController();
   const stop = () => controller.abort();
   process.once("SIGINT", stop);
@@ -25617,7 +25810,10 @@ async function runBrowser(options) {
       cwd: process.cwd(),
       port: options.port,
       dev: options.dev ?? false,
-      signal: controller.signal
+      signal: controller.signal,
+      cliVersion: version2,
+      // --no-update-check or GITIFACT_NO_UPDATE_CHECK keeps the server from contacting the npm registry.
+      ...updateCheckDisabled(process.env, options.updateCheck === false) ? {} : { fetchLatest: fetchLatestVersion }
     });
     if (!controller.signal.aborted) process.stdout.write(server.url + "/\n");
     await server.closed;
@@ -25892,7 +26088,7 @@ async function planAgentDocs(root, options) {
     return { mode: "remove", paths: paths2, writes };
   }
   const block = await renderAgentBlock(options.version, options);
-  const { inject, create } = resolveAgentPaths(options.agent, existing);
+  const { inject, create } = options.onlyExisting ? { inject: candidatePaths.filter((path3) => existing.has(path3) && findBlock(existing.get(path3)) && !isWrapperFile(existing.get(path3))), create: null } : resolveAgentPaths(options.agent, existing);
   for (const path3 of inject) {
     const previous = existing.get(path3);
     const next = injectBlock(previous, block, boilerplateFor(path3));
@@ -26004,6 +26200,64 @@ ${t2("init.text.agentDocs")}: ${docs}
   }
 }
 
+// src/commands/update.ts
+async function refreshBlocks(cwd, version2, env, controls) {
+  const repo = initRepository(cwd, env);
+  let first;
+  let config2;
+  try {
+    first = await repo.inspect();
+    config2 = await readConfigFile(first.state.repository.rootPath);
+  } catch (error62) {
+    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY" || error62 instanceof InitError && error62.code === "MIGRATION_REQUIRED") return { state: "not-initialized", paths: [] };
+    throw error62;
+  }
+  if (config2 === void 0) return { state: "not-initialized", paths: [] };
+  const root = first.state.repository.rootPath;
+  const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, ...controls });
+  if (plan.paths.length === 0) return { state: "no-block", paths: [] };
+  if (plan.writes.length === 0) return { state: "current", paths: plan.paths };
+  const unchanged = async () => {
+    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== config2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
+  };
+  return { state: "refreshed", paths: await applyAgentDocs(root, plan, unchanged) };
+}
+async function updateCommand(cwd, version2, env = process.env, controls = {}) {
+  const [update, agentDocs] = await Promise.all([
+    updateCheckDisabled(env) ? disabledUpdate : resolveUpdate(version2, controls.fetchLatest ?? fetchLatestVersion, void 0, controls.timeoutMs),
+    refreshBlocks(cwd, version2, env, controls)
+  ]);
+  return updateV1.parse({
+    contract: "update",
+    version: 1,
+    ok: true,
+    cliVersion: version2,
+    update,
+    install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
+    agentDocs
+  });
+}
+async function runUpdate(options, version2) {
+  try {
+    const dto = await updateCommand(process.cwd(), version2);
+    if (!dto.ok) throw new Error("unreachable");
+    if (options.format !== "text") {
+      process.stdout.write(JSON.stringify(dto) + "\n");
+      return;
+    }
+    const lines = [t2("update.text.current", { version: dto.cliVersion })];
+    lines.push(dto.update.status === "available" ? t2("update.text.available", { version: dto.update.latestVersion }) : dto.update.status === "up-to-date" ? t2("update.text.upToDate") : dto.update.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable"));
+    if (dto.install) lines.push(t2("update.text.install", { command: dto.install.npmGlobal }), t2("update.text.afterInstall"));
+    lines.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock") : t2("update.text.notInitialized"));
+    process.stdout.write(lines.join("\n") + "\n");
+  } catch (error62) {
+    const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
+    const failure2 = { code: known ? error62.code : "UPDATE_FAILED", message: known ? error62.message : t2("update.failed") };
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV1.parse({ contract: "update", version: 1, ok: false, error: failure2 })) + "\n");
+    process.exitCode = 1;
+  }
+}
+
 // src/commands/spec-preview.ts
 import { join as join12 } from "node:path";
 import { readFile as readFile12, stat as stat2 } from "node:fs/promises";
@@ -26682,15 +26936,16 @@ async function runMigrate(options) {
 }
 
 // src/main.ts
-var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.3.2").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.4.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")).action(runBrowser);
-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.3.2"));
+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.4.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.4.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")).action((options) => runUpdate(options, "0.4.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");

package/package.json

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