gitifact 0.8.1 → 0.8.3

package/dist/main.js

@@ -3407,6 +3407,8 @@ var messages_default = {
   "config.invalidFields": "\uD504\uB85C\uC81D\uD2B8 \uC124\uC815\uC758 \uD544\uB4DC\uB098 \uAC12\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "config.jsonUnreadableShort": "\uC124\uC815 JSON\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "config.schemaFields": "schemaVersion\uACFC baseline \uC124\uC815 \uD544\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.",
+  "config.cliVersion": "\uC124\uC815\uC758 cli\uB294 0.8.3 \uAC19\uC740 \uBC30\uD3EC \uBC84\uC804\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
+  "config.language": "\uC124\uC815\uC758 language\uB294 {languages} \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "document.pathTooLong": "\uC704\uD0A4 \uD398\uC774\uC9C0 \uACBD\uB85C \uAE4A\uC774 \uB610\uB294 \uAE38\uC774 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4: {path}",
   "document.fileName": "\uC704\uD0A4 \uD398\uC774\uC9C0 \uD30C\uC77C \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uACFC .md\uC5EC\uC57C \uD569\uB2C8\uB2E4(\uB8E8\uD2B8\uC758 README.md\xB7ARCHITECTURE.md \uAC19\uC740 \uB300\uBB38\uC790 \uC774\uB984 \uC608\uC678): {path}",
   "document.folderName": "\uC704\uD0A4 \uD3F4\uB354 \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: {path}",
@@ -3524,6 +3526,8 @@ var messages_default2 = {
   "config.invalidFields": "Invalid project configuration fields or values.",
   "config.jsonUnreadableShort": "Could not read configuration JSON.",
   "config.schemaFields": "Check the schemaVersion and baseline fields.",
+  "config.cliVersion": "The config field cli must be a release version such as 0.8.3.",
+  "config.language": "The config field language must be one of {languages}.",
   "document.pathTooLong": "Wiki page path exceeds the depth or length limit: {path}",
   "document.fileName": "Wiki filenames must use lowercase letters, digits, hyphens and .md; uppercase root names such as README.md and ARCHITECTURE.md are allowed: {path}",
   "document.folderName": "Wiki folder names must use lowercase letters, digits and hyphens: {path}",
@@ -3682,6 +3686,8 @@ var InitError = class extends Error {
 };
 var SCHEMA_VERSION = 3;
 var PREVIOUS_SCHEMA_VERSION = 2;
+var PROJECT_LANGUAGES = ["ko", "en"];
+var CLI_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
 var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var keys = (value, expected) => Object.keys(value).sort().join(",") === expected.sort().join(",");
 function parseBaseline(value) {
@@ -3714,7 +3720,7 @@ function parseManagedConfig(text4) {
   }
   if (!object(value) || !("schemaVersion" in value))
     throw new InitError("UNSUPPORTED_FORMAT", t("config.unsupportedFormat"));
-  if (!keys(value, ["baseline", "schemaVersion"]))
+  if (!("baseline" in value))
     throw new InitError("INVALID_CONFIG", t("config.schemaFields"));
   if (value.schemaVersion !== SCHEMA_VERSION) {
     const found = value.schemaVersion;
@@ -3723,7 +3729,35 @@ function parseManagedConfig(text4) {
       throw new InitError("UNSUPPORTED_SCHEMA", t("config.migrationRequired"));
     throw new InitError("UNSUPPORTED_SCHEMA", newer ? t("config.newerSchema", { version: String(found) }) : t("config.unsupportedSchema", { version: String(found) }));
   }
-  return { schemaVersion: SCHEMA_VERSION, baseline: parseBaseline(value.baseline) };
+  const config2 = { schemaVersion: SCHEMA_VERSION, baseline: parseBaseline(value.baseline) };
+  if ("cli" in value) {
+    if (typeof value.cli !== "string" || !CLI_VERSION_PATTERN.test(value.cli))
+      throw new InitError("INVALID_CONFIG", t("config.cliVersion"));
+    config2.cli = value.cli;
+  }
+  if ("language" in value) {
+    if (!PROJECT_LANGUAGES.includes(value.language))
+      throw new InitError("INVALID_CONFIG", t("config.language", { languages: PROJECT_LANGUAGES.join(", ") }));
+    config2.language = value.language;
+  }
+  return config2;
+}
+function formatManagedConfig(config2, previous) {
+  let unknown2 = {};
+  if (previous !== void 0) {
+    const value = JSON.parse(previous);
+    if (object(value)) {
+      const { schemaVersion: _s, baseline: _b, cli: _c, language: _l, ...rest } = value;
+      unknown2 = rest;
+    }
+  }
+  const known = {
+    schemaVersion: config2.schemaVersion,
+    baseline: config2.baseline,
+    ...config2.cli === void 0 ? {} : { cli: config2.cli },
+    ...config2.language === void 0 ? {} : { language: config2.language }
+  };
+  return JSON.stringify({ ...known, ...unknown2 }, null, 2) + "\n";
 }
 
 // ../../packages/core/dist/formats/links.js
@@ -10413,15 +10447,15 @@ function bucketFor(state2, inst) {
 var handoff;
 var open = [];
 var memo = {
-  alloc(_inst, payload, empty) {
+  alloc(_inst, payload, empty2) {
     const bucket = handoff;
     if (!bucket)
-      return empty;
+      return empty2;
     handoff = void 0;
-    const entry2 = { value: empty, issues: null };
+    const entry2 = { value: empty2, issues: null };
     bucket.set(payload.value, entry2);
     open.push(entry2);
-    return empty;
+    return empty2;
   },
   guard(inst) {
     var _a3;
@@ -13092,8 +13126,8 @@ var error20 = () => {
       case "invalid_union":
         return "\u05E7\u05DC\u05D8 \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF";
       case "invalid_element": {
-        const place2 = withDefinite(issue2.origin ?? "array");
-        return `\u05E2\u05E8\u05DA \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF \u05D1${place2}`;
+        const place3 = withDefinite(issue2.origin ?? "array");
+        return `\u05E2\u05E8\u05DA \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF \u05D1${place3}`;
       }
       default:
         return `\u05E7\u05DC\u05D8 \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF`;
@@ -25064,20 +25098,73 @@ var instruction = external_exports.strictObject({
 var agents = external_exports.strictObject({ path: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
 var problem = external_exports.strictObject({ code: external_exports.string(), path: external_exports.string(), message: external_exports.string() });
 var oid2 = external_exports.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/);
-var browserSpecsV7 = external_exports.strictObject({
-  contract: external_exports.literal("browser-specs"),
-  version: external_exports.literal(7),
+var indexFeature = external_exports.strictObject({
+  id: external_exports.string(),
+  path: external_exports.string(),
+  title: external_exports.string(),
+  state,
+  requirements: external_exports.array(external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string() })),
+  designs: external_exports.array(external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string() }))
+});
+var indexInstruction = external_exports.strictObject({ id: external_exports.string(), name: external_exports.string(), path: external_exports.string(), title: external_exports.string() });
+var browserCheckoutV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-checkout"),
+  version: external_exports.literal(1),
   sessionId: external_exports.string(),
   head: oid2.nullable(),
   observedAt: external_exports.string(),
   working: external_exports.boolean(),
   stamp: external_exports.string(),
-  features: external_exports.array(feature),
-  instructions: external_exports.array(instruction),
-  agents: agents.nullable(),
   problems: external_exports.array(problem),
+  index: external_exports.strictObject({ features: external_exports.array(indexFeature), instructions: external_exports.array(indexInstruction), people: external_exports.array(external_exports.strictObject({ name: external_exports.string(), email: external_exports.string() })) })
+});
+var featureRow = external_exports.strictObject({
+  id: external_exports.string(),
+  path: external_exports.string(),
+  title: external_exports.string(),
+  description: external_exports.string(),
+  state,
+  designs: external_exports.number().int().nonnegative(),
   contributors: external_exports.array(contributor),
-  contributorsLimited: external_exports.boolean()
+  updatedAt: external_exports.string().nullable(),
+  requirementCount: external_exports.number().int().nonnegative(),
+  // `acceptance`: the numbered items under the acceptance heading, null without one. `designed`: a design names it.
+  requirements: external_exports.array(external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), description: external_exports.string(), state, acceptance: external_exports.number().int().positive().nullable(), designed: external_exports.boolean() })),
+  hidden: external_exports.number().int().nonnegative()
+});
+var browserFeaturesV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-features"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  total: external_exports.number().int().nonnegative(),
+  all: external_exports.number().int().nonnegative(),
+  requirements: external_exports.number().int().nonnegative(),
+  mostRequirements: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
+  features: external_exports.array(featureRow)
+});
+var browserFeatureV1 = external_exports.strictObject({ contract: external_exports.literal("browser-feature"), version: external_exports.literal(1), sessionId: external_exports.string(), feature });
+var browserInstructionsV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-instructions"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  instructions: external_exports.array(instruction),
+  agents: agents.nullable()
+});
+var browserContributorsV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-contributors"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  total: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
+  people: external_exports.array(external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string(), features: external_exports.number().int().nonnegative() }))
+});
+var browserContributorV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-contributor"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  person: contributor,
+  features: external_exports.array(external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), commits: external_exports.number().int().nonnegative(), requirements: external_exports.number().int().nonnegative() }))
 });
 var kind = external_exports.enum(["feature", "requirement", "design", "wiki", "instruction"]);
 var reference = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), specId: external_exports.string(), path: external_exports.string() }).nullable();
@@ -25122,11 +25209,13 @@ var browserHistoryV6 = external_exports.strictObject({
   next: oid2.nullable(),
   events: external_exports.array(event)
 });
-var browserHistorySummaryV4 = external_exports.strictObject({
+var browserHistorySummaryV5 = external_exports.strictObject({
   contract: external_exports.literal("browser-history-summary"),
-  version: external_exports.literal(4),
+  version: external_exports.literal(5),
   sessionId: external_exports.string(),
   head: oid2,
+  // The three who committed most, and how many others there are and how many commits they made between them.
+  people: external_exports.strictObject({ total: external_exports.number().int().nonnegative(), top: external_exports.array(contributor), rest: external_exports.strictObject({ count: external_exports.number().int().nonnegative(), commits: external_exports.number().int().nonnegative() }) }),
   total: external_exports.number().int().nonnegative(),
   byType: external_exports.strictObject({ created: external_exports.number().int().nonnegative(), modified: external_exports.number().int().nonnegative(), moved: external_exports.number().int().nonnegative(), deleted: external_exports.number().int().nonnegative() }),
   // One entry per commit within three weeks of the newest change, so the reader can count by its own calendar day.
@@ -25134,22 +25223,23 @@ var browserHistorySummaryV4 = external_exports.strictObject({
   // The newest commits: a few of their changes each and how many there are in all.
   recent: external_exports.array(external_exports.strictObject({ commit: oid2, count: external_exports.number().int().positive(), events: external_exports.array(event) }))
 });
-var browserSearchV2 = external_exports.strictObject({
+var searchKind = external_exports.enum(["feature", "requirement", "design", "instruction", "record", "commit"]);
+var searchHit = external_exports.strictObject({
+  id: external_exports.string(),
+  kind: searchKind,
+  title: external_exports.string(),
+  where: external_exports.string(),
+  line: external_exports.string(),
+  // What the hit opens: a feature (with the requirement or design tab), an instruction, a record, or a commit.
+  featureId: external_exports.string().optional(),
+  commit: oid2.optional()
+});
+var browserSearchV3 = external_exports.strictObject({
   contract: external_exports.literal("browser-search"),
-  version: external_exports.literal(2),
+  version: external_exports.literal(3),
   sessionId: external_exports.string(),
   query: external_exports.string(),
-  hits: external_exports.array(external_exports.strictObject({
-    id: external_exports.string(),
-    kind: external_exports.enum(["feature", "requirement", "design", "instruction", "history"]),
-    title: external_exports.string(),
-    where: external_exports.string(),
-    line: external_exports.string(),
-    // What the hit opens: a feature (with the requirement or design tab), an instruction, or one change in the activity.
-    featureId: external_exports.string().optional(),
-    documentId: external_exports.string().optional(),
-    key: external_exports.string().optional()
-  }))
+  groups: external_exports.array(external_exports.strictObject({ group: external_exports.union([searchKind, external_exports.literal("recent")]), total: external_exports.number().int().nonnegative(), next: external_exports.string().nullable(), hits: external_exports.array(searchHit) }))
 });
 var headQuery = oid2;
 var count = (max) => external_exports.string().regex(/^(0|[1-9]\d{0,6})$/).transform(Number).pipe(external_exports.number().int().min(0).max(max));
@@ -25164,7 +25254,26 @@ var browserHistoryQueryV4 = external_exports.strictObject({
   q: external_exports.string().max(200).optional()
 });
 var browserHistorySummaryQueryV1 = external_exports.strictObject({ head: headQuery });
-var browserSearchQueryV1 = external_exports.strictObject({ q: external_exports.string().min(1).max(200), head: headQuery.optional() });
+var featureId = external_exports.string().regex(/^S-[a-z2-7]{10}$/);
+var browserFeaturesQueryV1 = external_exports.strictObject({
+  q: external_exports.string().max(200).optional(),
+  design: external_exports.enum(["yes", "no"]).optional(),
+  author: external_exports.string().min(1).max(320).optional(),
+  sort: external_exports.enum(["title", "requirements", "updated"]).optional(),
+  dir: external_exports.enum(["asc", "desc"]).optional(),
+  after: featureId.optional(),
+  limit: count(50).pipe(external_exports.number().min(1)).optional()
+});
+var browserFeatureQueryV1 = external_exports.strictObject({ id: featureId });
+var browserContributorsQueryV1 = external_exports.strictObject({ q: external_exports.string().max(200).optional(), after: external_exports.string().min(1).max(320).optional(), limit: count(50).pipe(external_exports.number().min(1)).optional() });
+var browserContributorQueryV1 = external_exports.strictObject({ email: external_exports.string().min(1).max(320) });
+var browserSearchQueryV2 = external_exports.strictObject({
+  q: external_exports.string().max(200),
+  head: headQuery.optional(),
+  group: searchKind.optional(),
+  after: external_exports.string().min(1).max(200).optional(),
+  limit: count(50).pipe(external_exports.number().min(1)).optional()
+});
 var browserInstructionFileQueryV1 = external_exports.strictObject({ id: external_exports.string().regex(/^I-[a-z2-7]{10}$/), path: external_exports.string().min(1).max(1e3) });
 var changelogQueryV1 = external_exports.strictObject({ lang: external_exports.string().regex(/^[a-z]{2}(?:-[A-Z]{2})?$/).optional() });
 var fileStatus = external_exports.enum(["added", "modified", "deleted", "renamed"]);
@@ -25176,12 +25285,13 @@ var commitFile = external_exports.strictObject({
   additions: external_exports.number().int().nonnegative().nullable(),
   deletions: external_exports.number().int().nonnegative().nullable()
 });
-var browserCommitFilesV1 = external_exports.strictObject({
+var browserCommitFilesV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit-files"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   commit: oid2,
   total: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
   files: external_exports.array(commitFile)
 });
 var browserCommitFileV1 = external_exports.strictObject({
@@ -25196,7 +25306,7 @@ var browserCommitFileV1 = external_exports.strictObject({
   binary: external_exports.boolean(),
   tooLarge: external_exports.boolean()
 });
-var browserCommitFilesQueryV1 = external_exports.strictObject({ commit: oid2 });
+var browserCommitFilesQueryV2 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(4096).optional(), limit: count(100).pipe(external_exports.number().min(1)).optional() });
 var browserCommitFileQueryV1 = external_exports.strictObject({ commit: oid2, path: external_exports.string().min(1).max(4096) });
 var browserCommitV4 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit"),
@@ -25212,7 +25322,8 @@ var browserCommitV4 = external_exports.strictObject({
   next: external_exports.string().nullable(),
   changes: external_exports.array(event)
 });
-var browserCommitQueryV2 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(200).optional(), limit: count(500).pipe(external_exports.number().min(1)).optional() });
+var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
+var browserCommitQueryV3 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(200).optional(), limit: count(100).pipe(external_exports.number().min(1)).optional(), record: recordId.optional() });
 var browserCommitChangeV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit-change"),
   version: external_exports.literal(1),
@@ -25223,14 +25334,15 @@ var browserCommitChangeV1 = external_exports.strictObject({
   after: snapshot
 });
 var browserCommitChangeQueryV1 = external_exports.strictObject({ commit: oid2, id: external_exports.string().min(1).max(100) });
-var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
-var browserRecordV1 = external_exports.strictObject({
+var browserRecordV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-record"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   head: oid2,
   id: recordId,
-  commit: oid2
+  commit: oid2,
+  record: record2,
+  others: external_exports.number().int().nonnegative()
 });
 var browserRecordQueryV1 = external_exports.strictObject({ head: oid2, id: recordId });
 var browserInstructionFileV1 = external_exports.strictObject({
@@ -25322,9 +25434,9 @@ var projectInitV8 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(8), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
-// ../../packages/contracts/dist/versions/update-v5.js
+// ../../packages/contracts/dist/versions/update-v6.js
 var commitReason = external_exports.enum(["untracked", "other-changes", "commit-failed"]);
-var agentDocsCommit = external_exports.strictObject({
+var updateCommit = external_exports.strictObject({
   state: external_exports.enum(["not-requested", "nothing", "committed", "skipped"]),
   commit: external_exports.string().nullable(),
   paths: external_exports.array(external_exports.string()),
@@ -25332,27 +25444,40 @@ var agentDocsCommit = external_exports.strictObject({
   reason: commitReason.nullable(),
   detail: external_exports.string().nullable()
 }).refine((value) => value.state === "committed" === (value.commit !== null) && value.state === "skipped" === (value.reason !== null), "commit is set exactly when committed, reason exactly when skipped.");
-var updateV5 = external_exports.discriminatedUnion("ok", [
+var updateV6 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
     contract: external_exports.literal("update"),
-    version: external_exports.literal(5),
+    version: external_exports.literal(6),
     ok: external_exports.literal(true),
     cliVersion: external_exports.string().min(1),
     update: updateStateV1,
-    // Present only when a newer release exists. npx refreshes the project blocks without a global install; npmGlobal remains an alternative.
-    install: external_exports.strictObject({ npx: external_exports.string().min(1), npmGlobal: external_exports.string().min(1) }).nullable(),
-    // refreshed: blocks whose version line differed were rewritten. current: every block already matched.
+    // Present only when a newer release exists; after installing it, `gitifact update` sets the project to it.
+    install: external_exports.strictObject({ npmGlobal: external_exports.string().min(1) }).nullable(),
+    // refreshed: blocks whose text differed were rewritten. current: every block already matched. kept: the project is on a
+    // release newer than this CLI, so its blocks were left as they are.
     // not-initialized: no .gitifact config here, so only the version check ran. no-block: no file carries a block.
     // missing: files `gitifact init` would add and update does not create, e.g. CLAUDE.md when only AGENTS.md has the block.
-    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()), missing: external_exports.array(external_exports.string()) }),
-    commit: agentDocsCommit,
+    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "kept", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()), missing: external_exports.array(external_exports.string()) }),
+    // written: .gitifact/config.json now names this release as `cli` and the block language. current: it already did.
+    // cli is the project's release afterwards; one newer than cliVersion was kept, since an older CLI does not lower it.
+    project: external_exports.strictObject({ state: external_exports.enum(["written", "current", "not-initialized"]), cli: external_exports.string().min(1).nullable() }),
+    commit: updateCommit,
     // The project still uses the 0.7 storage convention (schemaVersion 2): the blocks now describe commands that will refuse it
     // until the documents are moved with `gitifact guide show migrate`.
     migrationRequired: external_exports.boolean()
   }),
-  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(5), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(6), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
+// ../../packages/contracts/dist/versions/update-later-v1.js
+var updateLaterV1 = external_exports.strictObject({
+  contract: external_exports.literal("update-later"),
+  version: external_exports.literal(1),
+  ok: external_exports.literal(true),
+  cliVersion: external_exports.string().min(1),
+  later: external_exports.strictObject({ version: external_exports.string().min(1), until: external_exports.iso.datetime() }).nullable()
+});
+
 // ../../packages/contracts/dist/versions/browser-session-v3.js
 var browserSessionV3 = external_exports.strictObject({
   contract: external_exports.literal("browser-session"),
@@ -25505,6 +25630,8 @@ var messages_default3 = {
   "server.sessionChanged": "\uC11C\uBC84 \uC138\uC158\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC5F0\uACB0\uD558\uC138\uC694.",
   "server.badRange": "\uC870\uD68C \uBC94\uC704\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "server.commitNotFound": "\uC774 \uC800\uC7A5\uC18C\uC5D0 \uADF8 \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "server.featureNotFound": "\uCCB4\uD06C\uC544\uC6C3\uC5D0 \uADF8 \uAE30\uB2A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "server.contributorNotFound": "HEAD\uC5D0 \uADF8 \uC774\uBA54\uC77C\uB85C \uCEE4\uBC0B\uD55C \uC0AC\uB78C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.cursorNotFound": "\uC774\uC5B4 \uC77D\uC744 \uC704\uCE58\uB97C \uBAA9\uB85D\uC5D0\uC11C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uCC98\uC74C\uBD80\uD130 \uB2E4\uC2DC \uBD88\uB7EC\uC624\uC138\uC694.",
   "server.workingChangeNotFound": "\uCEE4\uBC0B \uC804 \uBCC0\uACBD\uC5D0 \uADF8 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.recordNotFound": "\uC774 \uC774\uB825\uC5D0 \uADF8 \uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -25551,7 +25678,7 @@ var messages_default3 = {
   "init.text.storage": "\uC800\uC7A5 \uADDC\uC57D",
   "init.text.agentDocs": "\uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68",
   "init.text.lineEndings": "\uC904\uBC14\uAFC8: {path}\uB85C \uBB38\uC11C\uB97C LF\uB85C \uACE0\uC815\uD588\uC2B5\uB2C8\uB2E4. \uC774\uBBF8 \uC788\uB358 \uBB38\uC11C\uAC00 \uBCC0\uACBD\uC73C\uB85C \uBCF4\uC774\uBA74 \uC904\uBC14\uAFC8\uB9CC \uBC14\uB010 \uAC83\uC774\uB2C8 \uADF8 \uBB38\uC11C\uB4E4\uC744 \uD55C \uBC88 \uCEE4\uBC0B\uD574 \uC815\uB9AC\uD558\uC138\uC694.",
-  "init.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC0C8 \uBC84\uC804\uC744 \uC2E4\uD589\uD558\uACE0 \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC744 \uAC31\uC2E0\uD558\uC138\uC694.",
+  "init.text.updateAvailable": "\uC0C8 \uBC84\uC804 {version}\uC774 \uC788\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC124\uCE58\uD55C \uB4A4 gitifact update\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uC0C8 \uBC84\uC804\uC5D0 \uB9DE\uCD94\uC138\uC694.",
   "init.failed": "\uCD08\uAE30\uD654\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uD30C\uC77C \uC811\uADFC \uAD8C\uD55C\uACFC \uC0DD\uC131\uB41C \uC124\uC815\xB7\uC784\uC2DC \uD30C\uC77C\uC744 \uD655\uC778\uD558\uC138\uC694.",
   "config.storeNotDirectory": ".gitifact\uB294 \uB9C1\uD06C\uAC00 \uC544\uB2CC \uC77C\uBC18 \uB514\uB809\uD130\uB9AC\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "config.fileShape": "config.json\uC740 64 KiB \uC774\uD558\uC758 \uC77C\uBC18 \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
@@ -25571,7 +25698,6 @@ var messages_default3 = {
   "agentBlock.duplicateStart": "GITIFACT \uC2DC\uC791 \uB9C8\uCEE4\uAC00 \uC5EC\uB7EC \uAC1C\uC785\uB2C8\uB2E4. \uC911\uBCF5 \uBE14\uB85D\uC744 \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   "specReader.headUnreadable": "HEAD\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "specReader.schemaRequired": "\uC0C8 \uC2A4\uD0A4\uB9C8 \uD504\uB85C\uC81D\uD2B8\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
-  "specReader.authorUnreadable": "Git \uC791\uC131\uC790\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "specReader.historyUnreadable": "Git \uC774\uB825 \uD615\uC2DD\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "specReader.projectChanged": "\uC870\uD68C \uC911 \uD504\uB85C\uC81D\uD2B8\uAC00 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uC0C8\uB85C\uACE0\uCE68\uD558\uC138\uC694.",
   "browser.invalidPort": "\uD3EC\uD2B8\uB294 0\uBD80\uD130 65535 \uC0AC\uC774\uC758 \uC815\uC218\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
@@ -25587,13 +25713,13 @@ var messages_default3 = {
   "update.text.upToDate": "\uCD5C\uC2E0 \uBC84\uC804\uC744 \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.",
   "update.text.disabled": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC774 \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4.",
   "update.text.unavailable": "\uC0C8 \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.",
-  "update.text.install": "\uC5C5\uB370\uC774\uD2B8 \uBA85\uB839: {command}",
-  "update.text.afterInstall": "\uC704 \uBA85\uB839\uC740 \uC804\uC5ED \uC124\uCE58 \uC5C6\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uC9C0\uCE68\uC744 \uAC31\uC2E0\uD569\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uC758\uC874\uC131\uC73C\uB85C \uAD00\uB9AC\uD55C\uB2E4\uBA74 \uD574\uB2F9 \uBC84\uC804\uC744 \uBA3C\uC800 \uAC31\uC2E0\uD558\uC138\uC694. \uBE0C\uB77C\uC6B0\uC800\uB3C4 \uC0C8 \uBC84\uC804\uC73C\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
+  "update.text.install": "\uC124\uCE58 \uBA85\uB839: {command}",
+  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uACFC \uC9C0\uCE68\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uBC14\uB01D\uB2C8\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB3C4 \uC0C8 \uBC84\uC804\uC73C\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   "update.text.blockRefreshed": "\uC9C0\uCE68 \uBE14\uB85D \uAC31\uC2E0: {paths}",
   "update.text.blockCurrent": "\uC9C0\uCE68 \uBE14\uB85D\uC740 \uC774\uBBF8 \uD604\uC7AC \uBC84\uC804\uC785\uB2C8\uB2E4: {paths}",
-  "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. npx --yes gitifact@{version} init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
+  "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. gitifact init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
   "update.text.notInitialized": "\uCD08\uAE30\uD654\uB41C \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2C8\uC5B4\uC11C \uBC84\uC804\uB9CC \uD655\uC778\uD588\uC2B5\uB2C8\uB2E4.",
-  "update.text.missing": "{paths} \uD30C\uC77C\uC774 \uC5C6\uC5B4 Claude Code\uAC00 AGENTS.md\uC758 \uC9C0\uCE68\uC744 \uC77D\uC9C0 \uBABB\uD569\uB2C8\uB2E4. npx --yes gitifact@{version} init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 AGENTS.md\uB97C \uAC00\uC838\uC624\uB294 \uD30C\uC77C\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.",
+  "update.text.missing": "{paths} \uD30C\uC77C\uC774 \uC5C6\uC5B4 Claude Code\uAC00 AGENTS.md\uC758 \uC9C0\uCE68\uC744 \uC77D\uC9C0 \uBABB\uD569\uB2C8\uB2E4. gitifact init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 AGENTS.md\uB97C \uAC00\uC838\uC624\uB294 \uD30C\uC77C\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.",
   "update.text.migrationRequired": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBB38\uC11C\uB294 \uC544\uC9C1 0.7 \uC800\uC7A5 \uADDC\uC57D(schemaVersion 2)\uC785\uB2C8\uB2E4. \uC9C0\uCE68 \uBE14\uB85D\uC740 \uC0C8 \uBA85\uB839\uC744 \uC548\uB0B4\uD558\uC9C0\uB9CC \uC804\uD658 \uC804\uC5D0\uB294 specs\xB7instructions\xB7records\xB7check\xB7changes \uBA85\uB839\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. npx --yes gitifact@{version} guide show migrate\uC758 \uC808\uCC28\uB85C \uBB38\uC11C\uB97C \uC804\uD658\uD558\uC138\uC694.",
   "update.text.committed": "\uC9C0\uCE68 \uBE14\uB85D \uCEE4\uBC0B: {commit} ({paths})",
   "update.text.commitNothing": "\uCEE4\uBC0B\uD560 \uC9C0\uCE68 \uBE14\uB85D \uBCC0\uACBD\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -25605,7 +25731,7 @@ var messages_default3 = {
   "server.assetNotFound": "\uC5D0\uC14B\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "help.lang": "\uCD9C\uB825 \uC5B8\uC5B4 (ko \uB610\uB294 en)",
   "help.updateCheck": "\uD30C\uC77C\uC744 \uBC14\uAFB8\uC9C0 \uC54A\uACE0 \uC0C8 \uBC84\uC804\uB9CC \uD655\uC778",
-  "commitFiles.notRecord": ".gitifact \uC548\uC5D0\uC11C\uB294 \uAE30\uB85D\xB7\uC124\uC815\xB7\uC5D0\uC14B\uB9CC \uCEE4\uBC0B\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4: {path}",
+  "commitFiles.notRecord": ".gitifact \uC548\uC5D0\uC11C\uB294 \uAE30\uB85D\xB7\uC124\uC815(config.json\xB7.gitattributes)\xB7\uC5D0\uC14B\uB9CC \uCEE4\uBC0B\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4: {path}",
   "help.changes": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC740 \uBB38\uC11C \uBCC0\uACBD \uC870\uD68C\uC640 \uCEE4\uBC0B",
   "help.changesList": "HEAD \uB300\uBE44 \uBC14\uB010 \uBB38\uC11C, \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC740 \uACB0\uC815\uAE30\uB85D, \uAE30\uB85D\uC774 \uC5C6\uB294 \uBCC0\uACBD, \uCEE4\uBC0B \uC785\uB825 \uD30C\uC77C \uACBD\uB85C",
   "help.changesCommit": "check\uC640 \uAC19\uC740 \uAC80\uC0AC \uB4A4 \uC120\uD0DD\uD55C \uD30C\uC77C\uACFC \uACB0\uC815\uAE30\uB85D\uC744 \uCEE4\uBC0B",
@@ -25758,7 +25884,16 @@ var messages_default3 = {
   "feedback.openUrl": "gh\uB97C \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC8FC\uC18C\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC5F4\uC5B4 \uC774\uC288\uB97C \uC81C\uCD9C\uD558\uC138\uC694.",
   "feedback.ghFailed": "gh\uB85C \uC774\uC288\uB97C \uB9CC\uB4E4\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC8FC\uC18C\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC5F4\uC5B4 \uC774\uC288\uB97C \uC81C\uCD9C\uD558\uC138\uC694.",
   "feedback.truncated": "\uBCF8\uBB38\uC774 \uAE38\uC5B4 \uC8FC\uC18C\uC5D0\uB294 \uC55E\uBD80\uBD84\uB9CC \uB2F4\uACBC\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC804\uCCB4 \uBCF8\uBB38\uC744 \uC791\uC131 \uD398\uC774\uC9C0\uC5D0 \uBD99\uC5EC \uB123\uC73C\uC138\uC694.",
-  "feedback.title": "\uC81C\uBAA9: {title}"
+  "feedback.title": "\uC81C\uBAA9: {title}",
+  "update.text.projectWritten": "{path}\uC758 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC744 gitifact {version}\uC73C\uB85C \uC801\uC5C8\uC2B5\uB2C8\uB2E4.",
+  "update.text.projectAhead": "\uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC740 gitifact {project}\uC785\uB2C8\uB2E4. \uC774 CLI({version})\uAC00 \uB354 \uC624\uB798\uB418\uC5B4 \uB0AE\uCD94\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. {command}\uB85C \uC62C\uB9AC\uC138\uC694.",
+  "update.later.postponed": "{latest} \uC548\uB0B4\uB97C {until}\uAE4C\uC9C0 \uC27D\uB2C8\uB2E4. \uB354 \uC0C8 \uBC84\uC804\uC774 \uB098\uC624\uBA74 \uBC14\uB85C \uB2E4\uC2DC \uC548\uB0B4\uD569\uB2C8\uB2E4.",
+  "update.later.nothing": "\uBBF8\uB8F0 \uC0C8 \uBC84\uC804 \uC548\uB0B4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}).",
+  "notice.release": "\uC0C8 \uBC84\uC804 {latest}\uAC00 \uC788\uC2B5\uB2C8\uB2E4(\uC9C0\uAE08 {version}). \uC5C5\uB370\uC774\uD2B8: {command} \uD6C4 gitifact update \xB7 \uB098\uC911\uC5D0: gitifact update --later",
+  "notice.projectNewer": "\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 gitifact {project} \uAE30\uC900\uC785\uB2C8\uB2E4(\uC2E4\uD589 \uC911 {version}). {command}\uB85C \uC62C\uB9AC\uC138\uC694.",
+  "notice.projectOlder": "\uC774 CLI({version})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900({project})\uBCF4\uB2E4 \uC0C8 \uBC84\uC804\uC785\uB2C8\uB2E4. gitifact update\uB85C \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC744 \uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
+  "help.updateLater": "\uC9C0\uAE08 \uC548\uB0B4\uB41C \uC0C8 \uBC84\uC804\uC744 24\uC2DC\uAC04 \uB3D9\uC548 \uC548\uB0B4\uD558\uC9C0 \uC54A\uC74C. \uB354 \uC0C8 \uBC84\uC804\uC740 \uBC14\uB85C \uC548\uB0B4",
+  "update.text.blockKept": "\uD504\uB85C\uC81D\uD2B8\uAC00 \uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804 \uAE30\uC900\uC774\uB77C \uC9C0\uCE68 \uBE14\uB85D\uC744 \uADF8\uB300\uB85C \uB450\uC5C8\uC2B5\uB2C8\uB2E4: {paths}"
 };
 
 // src/shared/i18n/en/messages.json
@@ -25809,6 +25944,8 @@ var messages_default4 = {
   "server.sessionChanged": "The server session changed. Reconnect to continue.",
   "server.badRange": "Check the requested range.",
   "server.commitNotFound": "This repository has no such commit.",
+  "server.featureNotFound": "The checkout has no such feature.",
+  "server.contributorNotFound": "Nobody with this email committed to HEAD.",
   "server.cursorNotFound": "The place to read on from is no longer in the list. Load it again from the start.",
   "server.workingChangeNotFound": "No uncommitted change of that document.",
   "server.recordNotFound": "This history has no such decision record.",
@@ -25855,7 +25992,7 @@ var messages_default4 = {
   "init.text.storage": "Storage convention",
   "init.text.agentDocs": "Agent instructions",
   "init.text.lineEndings": "Line endings: {path} keeps documents in LF. Documents that now show as changed differ only in line endings; commit them once to settle it.",
-  "init.text.updateAvailable": "Version {version} is available. Run {command} to use it and refresh the project instructions.",
+  "init.text.updateAvailable": "Version {version} is available. Install it with {command}, then run gitifact update to move the project to it.",
   "init.failed": "Initialization failed. Check file permissions and the generated configuration and temporary files.",
   "config.storeNotDirectory": ".gitifact must be a regular directory, not a link.",
   "config.fileShape": "config.json must be a regular file no larger than 64 KiB.",
@@ -25875,7 +26012,6 @@ var messages_default4 = {
   "agentBlock.duplicateStart": "Multiple GITIFACT start markers found. Remove duplicate blocks before retrying.",
   "specReader.headUnreadable": "Could not read HEAD.",
   "specReader.schemaRequired": "A project using the supported schema is required.",
-  "specReader.authorUnreadable": "Could not read Git authors.",
   "specReader.historyUnreadable": "Could not read Git history.",
   "specReader.projectChanged": "The project changed while reading. Refresh to continue.",
   "browser.invalidPort": "Port must be an integer between 0 and 65535.",
@@ -25891,13 +26027,13 @@ var messages_default4 = {
   "update.text.upToDate": "You are using the latest version.",
   "update.text.disabled": "Update checks are disabled.",
   "update.text.unavailable": "Could not check for updates. Check your network connection.",
-  "update.text.install": "Update command: {command}",
-  "update.text.afterInstall": "This command refreshes the instructions with the new version without a global installation. If you manage Gitifact as a project dependency, update that dependency first. Restart the browser with the new version.",
+  "update.text.install": "Install command: {command}",
+  "update.text.afterInstall": "After installing, run gitifact update again to move the project and its instructions to the new version. Restart the browser with the new version too.",
   "update.text.blockRefreshed": "Instruction blocks refreshed: {paths}",
   "update.text.blockCurrent": "Instruction blocks are already current: {paths}",
-  "update.text.noBlock": "No instruction files contain a GITIFACT block. Run npx --yes gitifact@{version} init to install one.",
+  "update.text.noBlock": "No instruction files contain a GITIFACT block. Run gitifact init to install one.",
   "update.text.notInitialized": "Only the version was checked because this project is not initialized.",
-  "update.text.missing": "{paths} is missing, so Claude Code cannot load the AGENTS.md instructions. Rerun npx --yes gitifact@{version} init to create the import file.",
+  "update.text.missing": "{paths} is missing, so Claude Code cannot load the AGENTS.md instructions. Rerun gitifact init to create the import file.",
   "update.text.migrationRequired": "This project's documents still use the 0.7 storage convention (schemaVersion 2). The blocks describe the new commands, but the specs, instructions, records, check and changes commands refuse to run until the documents are moved. Follow npx --yes gitifact@{version} guide show migrate to move them.",
   "update.text.committed": "Instruction blocks committed: {commit} ({paths})",
   "update.text.commitNothing": "No instruction block changes to commit.",
@@ -25909,7 +26045,7 @@ var messages_default4 = {
   "server.assetNotFound": "Asset not found.",
   "help.lang": "Output language (ko or en)",
   "help.updateCheck": "Check for a newer version without changing files",
-  "commitFiles.notRecord": "Inside .gitifact only records, the configuration and assets can be committed: {path}",
+  "commitFiles.notRecord": "Inside .gitifact only records, the configuration (config.json, .gitattributes) and assets can be committed: {path}",
   "help.changes": "Inspect and commit uncommitted document changes",
   "help.changesList": "Documents changed since HEAD, uncommitted records, changes without a record, and the commit input path",
   "help.changesCommit": "Check like the check command, then commit the selected files and records",
@@ -26062,7 +26198,16 @@ var messages_default4 = {
   "feedback.openUrl": "gh is not available. Open the address below in a browser and submit the issue.",
   "feedback.ghFailed": "gh could not create the issue. Open the address below in a browser and submit the issue.",
   "feedback.truncated": "The body is long, so the address holds only its beginning. Paste the full body below into the page.",
-  "feedback.title": "Title: {title}"
+  "feedback.title": "Title: {title}",
+  "update.text.projectWritten": "Set the project to gitifact {version} in {path}.",
+  "update.text.projectAhead": "The project is set to gitifact {project}. This CLI ({version}) is older, so it was not lowered. Install it with {command}.",
+  "update.later.postponed": "The notice for {latest} is quiet until {until}. A newer release is announced right away.",
+  "update.later.nothing": "No newer release to postpone (running {version}).",
+  "notice.release": "Version {latest} is available (running {version}). Update: {command}, then gitifact update \xB7 Later: gitifact update --later",
+  "notice.projectNewer": "This project is set to gitifact {project} (running {version}). Install it with {command}.",
+  "notice.projectOlder": "This CLI ({version}) is newer than the project ({project}). Run gitifact update to move the project to it.",
+  "help.updateLater": "Quiet the announced newer release for 24 hours; a release newer than it is announced right away",
+  "update.text.blockKept": "The project is set to a newer release than this CLI, so the instruction blocks were left as they are: {paths}"
 };
 
 // src/shared/i18n/index.ts
@@ -26414,7 +26559,7 @@ function storeReader(cwd) {
 import { DatabaseSync } from "node:sqlite";
 import { lstat, mkdir, rm, writeFile } from "node:fs/promises";
 import { join as join2 } from "node:path";
-var CACHE_FORMAT = 9;
+var CACHE_FORMAT = 11;
 var CACHE_DIR = ".gitifact/cache";
 var SCHEMA = `
   -- Working-tree files already read: the modification time and size decide whether a file is read again.
@@ -26444,7 +26589,17 @@ var SCHEMA = `
   CREATE TABLE lineage (head TEXT NOT NULL, pos INTEGER NOT NULL, oid TEXT NOT NULL, PRIMARY KEY (head, pos));
   CREATE INDEX lineage_by_commit ON lineage (head, oid);
   CREATE TABLE heads (head TEXT PRIMARY KEY, seen INTEGER NOT NULL);
-  -- Everything the search box finds: documents of the working tree (scope 'checkout') and past changes ('history').
+  -- Every commit the log has met, code commits too: who made it and when, and whether it is a format migration.
+  -- 'reach' is 1 for the commits of the HEAD the log follows now; contributors are counted over those.
+  CREATE TABLE log (oid TEXT PRIMARY KEY, name TEXT NOT NULL, email TEXT NOT NULL, time INTEGER NOT NULL, date TEXT NOT NULL,
+    subject TEXT NOT NULL, migration INTEGER NOT NULL, reach INTEGER NOT NULL);
+  CREATE INDEX log_by_reach ON log (reach, email);
+  -- The store folders a commit touched: a feature folder, an instruction folder, or AGENTS.md.
+  CREATE TABLE touches (oid TEXT NOT NULL, folder TEXT NOT NULL, PRIMARY KEY (oid, folder));
+  CREATE INDEX touches_by_folder ON touches (folder);
+  -- What the log follows: the HEAD ('head') and the fingerprint of the .mailmap its names were read with ('mailmap').
+  CREATE TABLE state (key TEXT PRIMARY KEY, value TEXT NOT NULL);
+  -- What the search box finds among the working tree's documents (scope 'checkout'); records are searched in their table.
   -- The searched columns hold lower-cased text; trigram lets LIKE '%...%' use the index from three characters on.
   CREATE VIRTUAL TABLE search USING fts5(
     scope UNINDEXED, kind UNINDEXED, ref UNINDEXED, oid UNINDEXED, payload UNINDEXED,
@@ -26728,6 +26883,40 @@ function createDocumentCache(root, database) {
         }));
       });
     },
+    /**
+     * The working documents of one kind whose title, place or text holds the query, a page at a time: a title that
+     * starts with it first, then a title, a place, and the text; by title within each. `after` is the ID of the last
+     * hit of the page before; one that no longer matches answers undefined. Each hit names its feature's ID.
+     */
+    async searchKind(kind2, raw, after, limit) {
+      const query = raw.trim().toLowerCase();
+      await sync();
+      return database.with((db) => {
+        const literal2 = /[\\%_]/.test(query);
+        const match = (column) => literal2 ? `instr(${column}, :q) > 0` : `${column} LIKE :like`;
+        const ordered = `WITH hits AS (
+            SELECT json_extract(payload, '$.id') AS id, payload, title, ref,
+              CASE WHEN substr(title, 1, length(:q)) = :q THEN 0 WHEN instr(title, :q) > 0 THEN 1 WHEN instr(place, :q) > 0 THEN 2 ELSE 3 END AS rank
+            FROM search WHERE scope = 'checkout' AND kind = :kind AND (${match("title")} OR ${match("place")} OR ${match("body")})),
+          ordered AS (SELECT *, row_number() OVER (ORDER BY rank, title, ref) AS n FROM hits)`;
+        const params = { q: query, kind: kind2, ...literal2 ? {} : { like: containing(query) } };
+        const total = Number(db.prepare(`${ordered} SELECT count(*) AS n FROM ordered`).get(params).n);
+        let start = 0;
+        if (after !== void 0) {
+          const at = db.prepare(`${ordered} SELECT n FROM ordered WHERE id = :after`).get({ ...params, after });
+          if (!at) return void 0;
+          start = Number(at.n);
+        }
+        const rows = db.prepare(`${ordered} SELECT payload FROM ordered WHERE n > :start ORDER BY n LIMIT :limit`).all({ ...params, start, limit: limit + 1 });
+        const features = new Map(db.prepare("SELECT feature, id FROM documents WHERE kind = 'feature'").all().map((r) => [r.feature, r.id]));
+        const hits = rows.slice(0, limit).map((r) => {
+          const p = JSON.parse(r.payload);
+          const featureId2 = p.feature ? features.get(p.feature) : void 0;
+          return { id: p.id, kind: kind2, title: p.title, where: p.where, line: snippet(p.body, query), ...featureId2 ? { featureId: featureId2 } : {} };
+        });
+        return { total, next: rows.length > limit ? hits[hits.length - 1].id : null, hits };
+      });
+    },
     /** Documents that refer to `id` from their frontmatter: designs naming a requirement or a source. */
     async referencing(id) {
       await sync();
@@ -27096,20 +27285,19 @@ var listed = (e) => {
   return { ...event2, before: reference2(e.before), after: reference2(e.after) };
 };
 var sideOf3 = (snapshot5, rev) => !snapshot5 ? null : rev ? { rev, path: snapshot5.path } : snapshot5;
-var titleOf = (e) => (e.after ?? e.before)?.title ?? e.id;
 var DAY = 864e5;
 var KEPT_HEADS = 4;
 var RECENT_COMMITS = 3;
 var RECENT_CHANGES = 12;
-function createHistory(database, git) {
+function createHistory(database, git, originals) {
   const changes2 = createCommitChanges(git);
+  const texts = originals ?? changes2;
   const building = /* @__PURE__ */ new Map();
   const built = /* @__PURE__ */ new Set();
   function insert(db, commits, readers) {
     const commit = db.prepare("INSERT OR IGNORE INTO commits (oid, reader) VALUES (?, ?)");
     const change2 = db.prepare("INSERT OR IGNORE INTO changes (key, oid, ord, id, kind, types, email, date, before_spec, after_spec, needle, row, detail) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)");
     const record4 = db.prepare("INSERT OR IGNORE INTO records (oid, id, title, sections) VALUES (?, ?, ?, ?)");
-    const search = db.prepare("INSERT INTO search (scope, kind, ref, oid, payload, title, place, body) VALUES (?,?,?,?,?,?,?,?)");
     transaction(db, () => {
       for (const c of commits) {
         if (!Number(commit.run(c.commit, readers.get(c.commit) ?? "current").changes)) continue;
@@ -27132,23 +27320,19 @@ function createHistory(database, git) {
             JSON.stringify(row),
             JSON.stringify(detail)
           );
-          const line2 = e.records.length ? e.records.map((r) => [r.title, ...r.sections.map((s) => s.body)].join(" ")).join(" \xB7 ") : e.message;
-          const where2 = e.commit.slice(0, 7) + " \xB7 " + e.author;
-          search.run(
-            "history",
-            "history",
-            e.key,
-            e.commit,
-            JSON.stringify({ title: titleOf(e), where: where2, line: line2 }),
-            titleOf(e).toLowerCase(),
-            where2.toLowerCase(),
-            [line2, e.message, e.id].join(" ").toLowerCase()
-          );
         });
       }
     });
   }
   async function build(head) {
+    const known = await database.with((db) => {
+      const seen = !!db.prepare("SELECT 1 FROM heads WHERE head = ?").get(head);
+      if (seen) db.prepare("UPDATE heads SET seen = ? WHERE head = ?").run(Date.now(), head);
+      return seen;
+    });
+    if (!known) await read(head);
+  }
+  async function read(head) {
     const lineage = await changes2.lineage(head);
     const readers = await changes2.readers(head, lineage);
     const known = await database.with((db) => new Map(db.prepare("SELECT oid, reader FROM commits").all().map((r) => [r.oid, r.reader])));
@@ -27158,13 +27342,14 @@ function createHistory(database, git) {
         db.prepare("DELETE FROM commits WHERE oid = ?").run(oid3);
         db.prepare("DELETE FROM changes WHERE oid = ?").run(oid3);
         db.prepare("DELETE FROM records WHERE oid = ?").run(oid3);
-        db.prepare("DELETE FROM search WHERE scope = 'history' AND oid = ?").run(oid3);
       }
+      db.prepare("DELETE FROM lineage WHERE head != ?").run(head);
+      db.prepare("DELETE FROM heads WHERE head != ?").run(head);
     }));
     const missing2 = lineage.filter((oid3) => !known.has(oid3) || stale.includes(oid3));
     for (let i = 0; i < missing2.length; i += 100) {
-      const read = await changes2.of(missing2.slice(i, i + 100), readers);
-      await database.with((db) => insert(db, read, readers));
+      const read2 = await changes2.of(missing2.slice(i, i + 100), readers);
+      await database.with((db) => insert(db, read2, readers));
     }
     await database.with((db) => transaction(db, () => {
       db.prepare("DELETE FROM lineage WHERE head = ?").run(head);
@@ -27191,15 +27376,21 @@ function createHistory(database, git) {
   async function readCommit(commit) {
     const known = await database.with((db) => !!db.prepare("SELECT 1 FROM commits WHERE oid = ?").get(commit));
     if (known) return;
-    const read = await changes2.of([commit]).catch(() => void 0);
-    if (read) await database.with((db) => insert(db, read, /* @__PURE__ */ new Map()));
+    const read2 = await changes2.of([commit]).catch(() => void 0);
+    if (read2) await database.with((db) => insert(db, read2, /* @__PURE__ */ new Map()));
+  }
+  function sameRecord(db, commit, id) {
+    if (!id.startsWith("H-")) return [id];
+    const own2 = db.prepare("SELECT title, sections FROM records WHERE oid = ? AND id = ?").get(commit, id);
+    if (!own2) return [id];
+    return db.prepare("SELECT id FROM records WHERE oid = ? AND id LIKE 'H-%' AND title = ? AND sections = ?").all(commit, own2.title, own2.sections).map((r) => r.id);
   }
   function hydrate(db, rows) {
     const events = rows.map((row) => JSON.parse(row));
-    const read = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?");
+    const read2 = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?");
     const byCommit = /* @__PURE__ */ new Map();
     for (const e of events) if (e.records.length && !byCommit.has(e.commit)) {
-      byCommit.set(e.commit, new Map(read.all(e.commit).map((r) => [r.id, { id: r.id, title: r.title, sections: JSON.parse(r.sections) }])));
+      byCommit.set(e.commit, new Map(read2.all(e.commit).map((r) => [r.id, { id: r.id, title: r.title, sections: JSON.parse(r.sections) }])));
     }
     return events.map((e) => ({ ...e, records: e.records.flatMap((id) => {
       const r = byCommit.get(e.commit)?.get(id);
@@ -27216,8 +27407,8 @@ function createHistory(database, git) {
         if (value && "rev" in value) places.push({ rev: value.rev, path: value.path, specId: events[i][key]?.specId ?? "" });
       }
     });
-    const read = places.length ? await changes2.sides(places) : [];
-    const text4 = new Map(places.map((p, i) => [p.rev + ":" + p.path, read[i] ?? null]));
+    const read2 = places.length ? await texts.sides(places) : [];
+    const text4 = new Map(places.map((p, i) => [p.rev + ":" + p.path, read2[i] ?? null]));
     const resolve = (value) => !value ? null : "rev" in value ? text4.get(value.rev + ":" + value.path) ?? null : value;
     return events.map((event2, i) => ({ event: event2, before: resolve(sides[i].before), after: resolve(sides[i].after) }));
   }
@@ -27249,7 +27440,7 @@ function createHistory(database, git) {
   return {
     ensure,
     /** The document and reason files of one commit, read from Git and not kept. */
-    filesAt: (rev) => changes2.tree(rev),
+    filesAt: (rev) => texts.tree(rev),
     /**
      * The changes that match, newest first, a page of whole commits: `limit` commits after the commit `after`, each
      * with all of its matching changes, and how many changes and commits match in all. `next` is the last commit of the
@@ -27278,11 +27469,15 @@ function createHistory(database, git) {
         };
       });
     },
-    /** The changes of one commit without their text, a page at a time after the change `after` (a key): the commit page's list. */
-    async commitChanges(commit, after, limit) {
+    /**
+     * The changes of one commit without their text, a page at a time after the change `after` (a key): the commit page's
+     * list. With `record`, only the changes that record explains: the record page's documents.
+     */
+    async commitChanges(commit, after, limit, record4) {
       await readCommit(commit);
       return database.with((db) => {
-        const all = db.prepare("SELECT key, row FROM changes WHERE oid = ? ORDER BY ord").all(commit);
+        const ids = record4 === void 0 ? void 0 : JSON.stringify(sameRecord(db, commit, record4));
+        const all = ids === void 0 ? db.prepare("SELECT key, row FROM changes WHERE oid = ? ORDER BY ord").all(commit) : db.prepare("SELECT key, row FROM changes c WHERE oid = ? AND EXISTS (SELECT 1 FROM json_each(c.row, '$.records') j WHERE j.value IN (SELECT value FROM json_each(?))) ORDER BY ord").all(commit, ids);
         const start = after === void 0 ? 0 : all.findIndex((r) => r.key === after) + 1;
         if (after !== void 0 && !start) return void 0;
         const shown = all.slice(start, start + limit);
@@ -27372,86 +27567,226 @@ function createHistory(database, git) {
         const commits = db.prepare(`SELECT l.oid AS oid, max(c.date) AS date, count(*) AS n ${from} GROUP BY l.pos, l.oid ORDER BY l.pos`).all(head);
         const newest = Math.max(0, ...commits.map((c) => Date.parse(c.date)).filter(Number.isFinite));
         const pulse = commits.filter((c) => Date.parse(c.date) >= newest - 22 * DAY).map((c) => ({ date: c.date, count: Number(c.n) }));
-        const recent = commits.slice(0, RECENT_COMMITS).map((c) => ({
+        const recent2 = commits.slice(0, RECENT_COMMITS).map((c) => ({
           commit: c.oid,
           count: Number(c.n),
           events: hydrate(db, db.prepare("SELECT row FROM changes WHERE oid = ? ORDER BY ord LIMIT ?").all(c.oid, RECENT_CHANGES).map((r) => r.row))
         }));
-        return { total, byType: { created: count2("created"), modified: count2("modified"), moved: count2("moved"), deleted: count2("deleted") }, pulse, recent };
+        return { total, byType: { created: count2("created"), modified: count2("modified"), moved: count2("moved"), deleted: count2("deleted") }, pulse, recent: recent2 };
       });
     },
-    /** The commit of `head`'s history that added a record, found through the records its changes carry. */
-    async commitOfRecord(head, id) {
+    /**
+     * The record of `head`'s history with the commit that added it, and how many other records that commit holds (a
+     * 0.7 reason written once over several documents counts once). Undefined when the history has no such record.
+     */
+    async recordOf(head, id) {
       await ensure(head);
-      return database.with((db) => db.prepare("SELECT l.oid AS oid FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = ? AND r.id = ? ORDER BY l.pos LIMIT 1").get(head, id)?.oid);
+      return database.with((db) => {
+        const found = db.prepare("SELECT r.oid AS oid, r.title AS title, r.sections AS sections FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = ? AND r.id = ? ORDER BY l.pos LIMIT 1").get(head, id);
+        if (!found) return void 0;
+        const all = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?").all(found.oid);
+        const groups = new Set(all.map((r) => r.id.startsWith("H-") ? "H\0" + r.title + "\0" + r.sections : r.id));
+        return { commit: found.oid, record: { id, title: found.title, sections: JSON.parse(found.sections) }, others: groups.size - 1 };
+      });
     },
     /**
-     * Documents whose title, place or text holds the query — a title match before a place match before a text match —
-     * then past changes of `head`'s history, newest first. The caller syncs the working documents first.
+     * The records of `head`'s history whose title, ID or sections hold the query, one hit per record file, a page at a
+     * time: a title that starts with it first, then a title, the ID, and the sections; newest first within each. `after`
+     * is the ID of the last hit of the page before; one that no longer matches answers undefined.
      */
-    async search(head, raw) {
+    async searchRecords(head, raw, after, limit) {
       const query = raw.trim().toLowerCase();
-      if (!query) return [];
-      if (head) await ensure(head);
+      await ensure(head);
       return database.with((db) => {
-        const literal2 = /[\\%_]/.test(query);
-        const match = (column) => literal2 ? `instr(${column}, ?) > 0` : `${column} LIKE ?`;
-        const needle = literal2 ? query : containing(query);
-        const features = new Map(db.prepare("SELECT feature, id FROM documents WHERE kind = 'feature'").all().map((r) => [r.feature, r.id]));
-        const found = db.prepare(`SELECT kind, payload, title, place FROM search WHERE scope = 'checkout' AND (${match("title")} OR ${match("place")} OR ${match("body")}) LIMIT 400`).all(needle, needle, needle);
-        const documents = found.map((r) => {
-          const at = r.title.indexOf(query);
-          const rank = at === 0 ? 0 : at > 0 ? 1 : r.place.includes(query) ? 2 : 3;
-          const p = JSON.parse(r.payload);
-          const featureId = p.feature ? features.get(p.feature) : void 0;
-          const hit = {
-            id: p.id,
-            kind: r.kind,
-            title: p.title,
-            where: p.where,
-            line: snippet(p.body, query),
-            ...featureId ? { featureId } : {}
-          };
-          return { rank, hit };
-        }).sort((a, b) => a.rank - b.rank || a.hit.title.localeCompare(b.hit.title)).slice(0, 24).map((r) => r.hit);
-        const past = !head ? [] : db.prepare(`SELECT s.ref AS ref, s.payload AS payload FROM search s JOIN lineage l ON l.head = ? AND l.oid = s.oid
-          WHERE s.scope = 'history' AND (${match("s.title")} OR ${match("s.body")}) ORDER BY l.pos LIMIT 8`).all(head, needle, needle).map((r) => {
-          const p = JSON.parse(r.payload);
-          return { id: r.ref, kind: "history", title: p.title, where: p.where, line: snippet(p.line, query), key: r.ref };
+        const ordered = `WITH own AS (
+            SELECT r.id AS id, r.title AS title, r.oid AS oid, min(l.pos) AS pos, r.sections AS sections,
+              lower((SELECT group_concat(json_extract(s.value, '$.body'), ' ') FROM json_each(r.sections) s)) AS body
+            FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = :head GROUP BY r.id),
+          hits AS (SELECT *, CASE WHEN substr(lower(title), 1, length(:q)) = :q THEN 0 WHEN instr(lower(title), :q) > 0 THEN 1
+              WHEN instr(lower(id), :q) > 0 THEN 2 ELSE 3 END AS rank
+            FROM own WHERE instr(lower(title), :q) > 0 OR instr(lower(id), :q) > 0 OR instr(body, :q) > 0),
+          ordered AS (SELECT *, row_number() OVER (ORDER BY rank, pos, id) AS n FROM hits)`;
+        const params = { head, q: query };
+        const total = Number(db.prepare(`${ordered} SELECT count(*) AS n FROM ordered`).get(params).n);
+        let start = 0;
+        if (after !== void 0) {
+          const at = db.prepare(`${ordered} SELECT n FROM ordered WHERE id = :after`).get({ ...params, after });
+          if (!at) return void 0;
+          start = Number(at.n);
+        }
+        const rows = db.prepare(`${ordered} SELECT id, title, oid, sections FROM ordered WHERE n > :start ORDER BY n LIMIT :limit`).all({ ...params, start, limit: limit + 1 });
+        const hits = rows.slice(0, limit).map((r) => {
+          const text4 = JSON.parse(r.sections).map((s) => s.body).join(" ");
+          return { id: r.id, kind: "record", title: r.title, where: r.id + " \xB7 " + r.oid.slice(0, 7), line: snippet(text4, query), commit: r.oid };
         });
-        return [...documents, ...past];
+        return { total, next: rows.length > limit ? hits[hits.length - 1].id : null, hits };
+      });
+    }
+  };
+}
+
+// src/adapters/cache/commit-log.ts
+import { lstat as lstat3 } from "node:fs/promises";
+import { join as join4 } from "node:path";
+var FORMAT2 = `%x1e%H%x00%aN%x00%aE%x00%at%x00%aI%x00%s%x00%(trailers:key=${MIGRATION_TRAILER},valueonly,separator=%x2C)`;
+var CHUNK = 1e5;
+var folderOf2 = (path3) => path3 === "AGENTS.md" ? path3 : new RegExp(`^(${SPEC_ROOT.replace(/\./g, "\\.")}/[^/]+|${INSTRUCTIONS_ROOT.replace(/\./g, "\\.")}/[^/]+)/`).exec(path3)?.[1];
+function createCommitLog(database, git, root) {
+  let following;
+  let followingHead;
+  const read = async (args) => git.decode(await git.run(args));
+  async function commits(range) {
+    const out = [];
+    for (let skip = 0; ; skip += CHUNK) {
+      const text4 = await read(["log", `--format=${FORMAT2}`, `--max-count=${CHUNK}`, `--skip=${skip}`, ...range, "--"]);
+      const chunk = text4.split("").filter(Boolean).map((entry2) => {
+        const [oid3, name2, email3, time3, date5, subject, migration] = entry2.split("\0");
+        return { oid: oid3, name: name2 ?? "", email: email3 ?? "", time: Number(time3), date: date5 ?? "", subject: subject ?? "", migration: !!migration?.trim() };
+      });
+      out.push(...chunk);
+      if (chunk.length < CHUNK) return out;
+    }
+  }
+  async function touches(range) {
+    const text4 = await read(["log", "--format=%x1e%H", "-z", "--name-only", "--no-renames", ...range, "--", SPEC_ROOT, INSTRUCTIONS_ROOT, "AGENTS.md"]);
+    const out = [];
+    for (const entry2 of text4.split("").filter(Boolean)) {
+      const [oid3, ...paths2] = entry2.split("\0");
+      const folders = new Set(paths2.map((p) => folderOf2(p.replace(/^\n/, ""))).filter((f) => !!f));
+      for (const folder of folders) out.push([oid3.trim(), folder]);
+    }
+    return out;
+  }
+  async function mailmap() {
+    const info5 = await lstat3(join4(root, ".mailmap")).catch(() => void 0);
+    return info5 ? info5.mtimeMs + ":" + info5.size : "-";
+  }
+  const stateOf = (db, key) => db.prepare("SELECT value FROM state WHERE key = ?").get(key)?.value;
+  async function follow(head, attempts = 3) {
+    const names = await mailmap();
+    const [before, named] = await database.with((db) => [stateOf(db, "head"), stateOf(db, "mailmap")]);
+    if (before === head && named === names) return;
+    let change2;
+    if (before && named === names) {
+      try {
+        const range = [head, "^" + before];
+        const [added2, removed2, touched2] = await Promise.all([commits(range), read(["rev-list", before, "^" + head, "--"]), touches(range)]);
+        change2 = { added: added2, removed: removed2.split("\n").filter(Boolean), touched: touched2, whole: false };
+      } catch {
+        change2 = void 0;
+      }
+    }
+    if (!change2) {
+      const [added2, touched2] = await Promise.all([commits([head]), touches([head])]);
+      change2 = { added: added2, removed: [], touched: touched2, whole: true };
+    }
+    const { added, removed, touched, whole } = change2;
+    const written = await database.with((db) => transaction(db, () => {
+      if (stateOf(db, "head") !== before || stateOf(db, "mailmap") !== named) return false;
+      if (whole) {
+        db.exec("DELETE FROM log");
+        db.exec("DELETE FROM touches");
+      }
+      const put = db.prepare(`INSERT INTO log (oid, name, email, time, date, subject, migration, reach) VALUES (?, ?, ?, ?, ?, ?, ?, 1)
+        ON CONFLICT (oid) DO UPDATE SET name = excluded.name, email = excluded.email, reach = 1`);
+      for (const c of added) put.run(c.oid, c.name, c.email, c.time, c.date, c.subject, c.migration ? 1 : 0);
+      const leave = db.prepare("UPDATE log SET reach = 0 WHERE oid = ?");
+      for (const oid3 of removed) leave.run(oid3);
+      const touch = db.prepare("INSERT OR IGNORE INTO touches (oid, folder) VALUES (?, ?)");
+      for (const [oid3, folder] of touched) touch.run(oid3, folder);
+      const set2 = db.prepare("INSERT INTO state (key, value) VALUES (?, ?) ON CONFLICT (key) DO UPDATE SET value = excluded.value");
+      set2.run("head", head);
+      set2.run("mailmap", names);
+      return true;
+    }));
+    if (!written && attempts > 1) return follow(head, attempts - 1);
+  }
+  async function ensure(head) {
+    while (following && followingHead !== head) await following.catch(() => void 0);
+    if (!following) {
+      followingHead = head;
+      following = follow(head).finally(() => {
+        following = void 0;
+        followingHead = void 0;
+      });
+    }
+    return following;
+  }
+  return {
+    ensure,
+    /** Everyone who committed to `head`, most commits first, format migrations left out. `latest` is their newest commit. */
+    async contributors(head) {
+      await ensure(head);
+      return database.with((db) => db.prepare(`SELECT email, name, count(*) AS commits, max(time) AS time, date AS latest FROM log
+        WHERE reach = 1 AND migration = 0 GROUP BY email ORDER BY commits DESC, name, email`).all().map(({ name: name2, email: email3, commits: commits2, latest }) => ({ name: name2, email: email3, commits: Number(commits2), latest })));
+    },
+    /**
+     * The commits of `head` a hash names: the whole hash, or its start from seven characters on, as `git log --oneline`
+     * prints it. Anything shorter or not a hash names none. Newest first, a page after the commit `after`.
+     */
+    async commitsNamed(head, raw, after, limit) {
+      const prefix = raw.trim().toLowerCase();
+      if (!/^[0-9a-f]{7,64}$/.test(prefix)) return { total: 0, next: null, hits: [] };
+      await ensure(head);
+      return database.with((db) => {
+        const rows = db.prepare("SELECT oid, name, date, subject FROM log WHERE reach = 1 AND substr(oid, 1, length(?)) = ? ORDER BY time DESC, oid").all(prefix, prefix);
+        const start = after === void 0 ? 0 : rows.findIndex((r) => r.oid === after) + 1;
+        if (after !== void 0 && !start) return void 0;
+        const shown = rows.slice(start, start + limit);
+        return {
+          total: rows.length,
+          next: start + shown.length < rows.length ? shown[shown.length - 1].oid : null,
+          hits: shown.map((r) => ({ id: r.oid, kind: "commit", title: r.subject, where: r.oid.slice(0, 7) + " \xB7 " + r.name, line: r.date.slice(0, 10), commit: r.oid }))
+        };
+      });
+    },
+    /** Each store folder's authors, most commits first, and when it was last touched, format migrations left out. */
+    async folders(head) {
+      await ensure(head);
+      return database.with((db) => {
+        const rows = db.prepare(`SELECT t.folder AS folder, l.email AS email, l.name AS name, count(*) AS commits, max(l.time) AS time, l.date AS latest
+          FROM touches t JOIN log l ON l.oid = t.oid WHERE l.reach = 1 AND l.migration = 0
+          GROUP BY t.folder, l.email ORDER BY t.folder, commits DESC, name, email`).all();
+        const out = /* @__PURE__ */ new Map();
+        for (const r of rows) {
+          let entry2 = out.get(r.folder);
+          if (!entry2) out.set(r.folder, entry2 = { people: [], latest: r.latest, time: r.time });
+          entry2.people.push({ name: r.name, email: r.email, commits: Number(r.commits), latest: r.latest });
+          if (r.time > entry2.time) {
+            entry2.time = r.time;
+            entry2.latest = r.latest;
+          }
+        }
+        return new Map([...out].map(([folder, { people, latest }]) => [folder, { people, latest }]));
       });
     }
   };
 }
 
 // src/adapters/cache/index.ts
-function openCache(root, git) {
+function openCache(root, git, originals) {
   const database = createCacheDatabase(root);
   const documents = createDocumentCache(root, database);
-  const history = createHistory(database, git);
+  const history = createHistory(database, git, originals);
+  const log = createCommitLog(database, git, root);
   return {
     documents,
     history,
-    location: database.location,
-    /** Documents first, so a search right after an edit finds the edited text. */
-    async search(head, query) {
-      await documents.sync();
-      return history.search(head, query);
-    }
+    log,
+    location: database.location
   };
 }
 
 // src/adapters/git/pending-records.ts
-import { lstat as lstat3, readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { lstat as lstat4, readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
+import { join as join5 } from "node:path";
 var decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
-var info = (path3) => lstat3(path3).catch((error62) => {
+var info = (path3) => lstat4(path3).catch((error62) => {
   if (error62.code === "ENOENT") return void 0;
   throw error62;
 });
 async function recordFolders(root) {
-  return (await readdir3(join4(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
+  return (await readdir3(join5(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
     if (error62.code === "ENOENT") return [];
     throw error62;
   })).filter(isRecordFolder);
@@ -27459,7 +27794,7 @@ async function recordFolders(root) {
 async function findRecord(root, id) {
   for (const folder of await recordFolders(root)) {
     const path3 = `${RECORDS_ROOT}/${folder}/${id}.md`;
-    if ((await info(join4(root, ...path3.split("/"))))?.isFile()) return path3;
+    if ((await info(join5(root, ...path3.split("/"))))?.isFile()) return path3;
   }
   return void 0;
 }
@@ -27475,7 +27810,7 @@ async function readPendingRecords(root, run) {
       altered.push(path3);
       continue;
     }
-    const file2 = join4(root, ...path3.split("/"));
+    const file2 = join5(root, ...path3.split("/"));
     const stat3 = await info(file2);
     if (!stat3?.isFile() || stat3.isSymbolicLink()) {
       problems.push(docProblem("PATH_UNSUPPORTED", path3));
@@ -27497,30 +27832,30 @@ async function readPendingRecords(root, run) {
     if (!id) continue;
     for (const folder of folders) {
       const other = `${RECORDS_ROOT}/${folder}/${id}.md`;
-      if (other !== path3 && !files.has(other) && (await info(join4(root, ...other.split("/"))))?.isFile()) problems.push(docProblem("DUPLICATE_RECORD_ID", path3, { id, other }));
+      if (other !== path3 && !files.has(other) && (await info(join5(root, ...other.split("/"))))?.isFile()) problems.push(docProblem("DUPLICATE_RECORD_ID", path3, { id, other }));
     }
   }
   return { files, altered: altered.sort(), problems };
 }
 
 // src/adapters/filesystem/config-file.ts
-import { lstat as lstat4, readFile as readFile4, realpath, mkdir as mkdir2, open as open2, link, rename, unlink } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { lstat as lstat5, readFile as readFile4, realpath, mkdir as mkdir2, open as open2, link, rename, unlink } from "node:fs/promises";
+import { join as join6 } from "node:path";
 import { randomUUID as randomUUID2 } from "node:crypto";
 var missing = (error62) => error62.code === "ENOENT";
-var fileInfo = (path3) => lstat4(path3).catch((error62) => {
+var fileInfo = (path3) => lstat5(path3).catch((error62) => {
   if (missing(error62)) return void 0;
   throw error62;
 });
 async function configDirectory(root) {
-  const path3 = join5(root, ".gitifact");
+  const path3 = join6(root, ".gitifact");
   const info5 = await fileInfo(path3);
   if (info5 && (!info5.isDirectory() || info5.isSymbolicLink())) throw new InitError("PATH_CONFLICT", t2("config.storeNotDirectory"));
   return info5;
 }
 async function readConfigFile(root) {
   await configDirectory(root);
-  const path3 = join5(root, ".gitifact", "config.json");
+  const path3 = join6(root, ".gitifact", "config.json");
   const info5 = await fileInfo(path3);
   if (!info5) return void 0;
   if (!info5.isFile() || info5.isSymbolicLink() || info5.size > 65536) throw new InitError("PATH_CONFLICT", t2("config.fileShape"));
@@ -27537,7 +27872,7 @@ async function readConfigFile(root) {
   }
 }
 async function publishConfig(root, text4, recheck, beforePublish, replace = false) {
-  const directory = join5(root, ".gitifact");
+  const directory = join6(root, ".gitifact");
   await configDirectory(root);
   await mkdir2(directory).catch((error62) => {
     if (error62.code !== "EEXIST") throw error62;
@@ -27550,7 +27885,7 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
       throw new InitError("INPUT_CHANGED", t2("config.directoryChanged"));
     }
   };
-  const temporary = join5(directory, ".init-" + randomUUID2() + ".tmp");
+  const temporary = join6(directory, ".init-" + randomUUID2() + ".tmp");
   const handle = await open2(temporary, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -27567,8 +27902,8 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
     const bytes = await readFile4(temporary, "utf8");
     if (bytes !== text4) throw new InitError("INPUT_CHANGED", t2("config.temporaryChanged"));
     parseManagedConfig(bytes);
-    if (replace) await rename(temporary, join5(directory, "config.json"));
-    else await link(temporary, join5(directory, "config.json"));
+    if (replace) await rename(temporary, join6(directory, "config.json"));
+    else await link(temporary, join6(directory, "config.json"));
   } finally {
     await unchanged();
     const current2 = await fileInfo(temporary);
@@ -27577,11 +27912,11 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
 }
 
 // src/adapters/filesystem/instruction-folder.ts
-import { lstat as lstat5, open as open3, readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
-import { join as join6 } from "node:path";
+import { lstat as lstat6, open as open3, readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 var INSTRUCTION_FILE_LIMIT = 500;
 var INSTRUCTION_TEXT_LIMIT = 512 * 1024;
-var folderOf2 = (root, instructionPath) => join6(root, ...instructionPath.split("/").slice(0, -1));
+var folderOf3 = (root, instructionPath) => join7(root, ...instructionPath.split("/").slice(0, -1));
 async function listInstructionFiles(root, instructionPath) {
   const files = [];
   let limited = false;
@@ -27594,21 +27929,21 @@ async function listInstructionFiles(root, instructionPath) {
         return;
       }
       const path3 = prefix + entry2.name;
-      if (entry2.isDirectory()) await visit2(join6(folder, entry2.name), path3 + "/", depth + 1);
-      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat5(join6(folder, entry2.name))).size });
+      if (entry2.isDirectory()) await visit2(join7(folder, entry2.name), path3 + "/", depth + 1);
+      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat6(join7(folder, entry2.name))).size });
     }
   }
-  await visit2(folderOf2(root, instructionPath), "", 0);
+  await visit2(folderOf3(root, instructionPath), "", 0);
   return { files, limited };
 }
 var FRONTMATTER_WINDOW = 8 * 1024;
 async function describeFiles(root, instructionPath, files) {
-  const folder = folderOf2(root, instructionPath);
+  const folder = folderOf3(root, instructionPath);
   return Promise.all(files.map(async (file2) => {
     if (!isInstructionReference(file2.path)) return file2;
     let handle;
     try {
-      handle = await open3(join6(folder, ...file2.path.split("/")), "r");
+      handle = await open3(join7(folder, ...file2.path.split("/")), "r");
       const buffer = Buffer.alloc(Math.min(FRONTMATTER_WINDOW, file2.size));
       const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
       return { ...file2, ...parseInstructionFile(file2.path, buffer.subarray(0, bytesRead).toString("utf8")) };
@@ -27626,13 +27961,13 @@ async function readInstructionFiles(root, instructionPath) {
 async function readInstructionFile(root, instructionPath, path3) {
   const parts = path3.split("/");
   if (parts.some((p) => !p || p === "." || p === ".." || /[\\:\0]/.test(p))) return void 0;
-  let full = folderOf2(root, instructionPath);
+  let full = folderOf3(root, instructionPath);
   for (const [index, part] of parts.entries()) {
-    full = join6(full, part);
-    const info5 = await lstat5(full).catch(() => void 0);
+    full = join7(full, part);
+    const info5 = await lstat6(full).catch(() => void 0);
     if (!info5 || info5.isSymbolicLink() || (index < parts.length - 1 ? !info5.isDirectory() : !info5.isFile())) return void 0;
   }
-  const size = (await lstat5(full)).size;
+  const size = (await lstat6(full)).size;
   if (size > INSTRUCTION_TEXT_LIMIT) return { text: null, size, binary: false, tooLarge: true };
   const bytes = await readFile5(full);
   try {
@@ -27644,12 +27979,12 @@ async function readInstructionFile(root, instructionPath, path3) {
 }
 
 // src/adapters/filesystem/agents-file.ts
-import { lstat as lstat6, readFile as readFile6 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { lstat as lstat7, readFile as readFile6 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 var LIMIT = 1024 * 1024;
 async function readAgentsFile(root) {
-  const file2 = join7(root, "AGENTS.md");
-  const info5 = await lstat6(file2).catch(() => void 0);
+  const file2 = join8(root, "AGENTS.md");
+  const info5 = await lstat7(file2).catch(() => void 0);
   if (!info5?.isFile() || info5.size > LIMIT) return null;
   try {
     return new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(await readFile6(file2));
@@ -27726,8 +28061,8 @@ async function documentsAtHead(project, head, paths2) {
 
 // src/server/checkout/stamp.ts
 import { createHash as createHash2 } from "node:crypto";
-import { lstat as lstat7 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { lstat as lstat8 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 function createStampReader(root, inherited = process.env) {
   const runner = createGitRunner();
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_REPLACE_OBJECTS: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "0", LC_ALL: "C" };
@@ -27739,7 +28074,7 @@ function createStampReader(root, inherited = process.env) {
     ]);
     const paths2 = status.split("\0").filter(Boolean).map((entry2) => entry2.slice(3)).filter((path3) => !path3.startsWith(".gitifact/cache/"));
     const seen = await Promise.all(paths2.map(async (path3) => {
-      const info5 = await lstat7(join8(root, ...path3.split("/"))).catch(() => void 0);
+      const info5 = await lstat8(join9(root, ...path3.split("/"))).catch(() => void 0);
       return path3 + "	" + (info5 ? info5.mtimeMs + ":" + info5.size : "-");
     }));
     return createHash2("sha256").update(head.trim() + "\n" + seen.sort().join("\n")).digest("hex").slice(0, 20);
@@ -27747,19 +28082,14 @@ function createStampReader(root, inherited = process.env) {
 }
 
 // src/server/checkout/checkout-reader.ts
-var tally = (people, name2, email3, latest) => {
-  const person = people.get(email3);
-  if (person) person.commits++;
-  else people.set(email3, { name: name2, email: email3, latest, commits: 1 });
-};
 async function settled(reads) {
   const results = await Promise.allSettled(reads);
   const failure2 = results.find((r) => r.status === "rejected");
   if (failure2) throw failure2.reason;
   return results.map((r) => r.value);
 }
-var folderOf3 = (path3) => path3.split("/").slice(0, 3).join("/");
-function checkoutDocuments(states) {
+var folderOf4 = (path3) => path3.split("/").slice(0, 3).join("/");
+function checkoutDocuments(states, authors) {
   const documents = states.documents;
   const standing2 = (id) => {
     const previousPath = states.previousPath(id);
@@ -27772,30 +28102,45 @@ function checkoutDocuments(states) {
     return { id: s.id, ...target ? { title: target.title, path: target.path } : {}, ...s.note ? { note: s.note } : {} };
   };
   const arranged = arrangeDocuments(documents);
-  const features = arranged.features.map(({ index, requirements, designs }) => ({
-    id: index.id,
-    path: index.path,
-    title: index.title,
-    description: index.description,
-    body: index.body,
-    ...standing2(index.id),
-    requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, body: r.body, ...standing2(r.id) })),
-    designs: designs.map((d) => ({
-      id: d.id,
-      path: d.path,
-      title: d.title,
-      description: d.description,
-      order: d.order,
-      body: d.body,
-      requirements: d.requirements,
-      sources: d.sources.map(source2),
-      ...standing2(d.id)
-    }))
+  const features = arranged.features.map(({ index, requirements, designs }) => {
+    const entry2 = authors.get(folderOf4(index.path));
+    return {
+      id: index.id,
+      path: index.path,
+      title: index.title,
+      description: index.description,
+      body: index.body,
+      ...standing2(index.id),
+      requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, body: r.body, ...standing2(r.id) })),
+      designs: designs.map((d) => ({
+        id: d.id,
+        path: d.path,
+        title: d.title,
+        description: d.description,
+        order: d.order,
+        body: d.body,
+        requirements: d.requirements,
+        sources: d.sources.map(source2),
+        ...standing2(d.id)
+      })),
+      // Who committed to the feature folder, most first, and when it was last touched; nobody until first committed.
+      contributors: entry2?.people ?? [],
+      updatedAt: entry2?.latest ?? null
+    };
+  });
+  const instructions2 = arranged.instructions.map((k) => ({
+    id: k.id,
+    name: k.name,
+    path: k.path,
+    title: k.title,
+    description: k.description,
+    body: k.body,
+    ...standing2(k.id),
+    updatedAt: authors.get(folderOf4(k.path))?.latest ?? null
   }));
-  const instructions2 = arranged.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title, description: k.description, body: k.body, ...standing2(k.id) }));
   return { features, instructions: instructions2, orphans: arranged.orphans };
 }
-function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
+function createCheckoutReader(root, cache, inherited = process.env) {
   const reader = storeReader(root);
   const runner = createGitRunner();
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_REPLACE_OBJECTS: "1", GIT_TERMINAL_PROMPT: "0", LC_ALL: "C" };
@@ -27808,87 +28153,36 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
   };
   const pending = /* @__PURE__ */ new Map();
   const readStamp = createStampReader(root, inherited);
-  const notMigration = ["-E", "--invert-grep", `--grep=^${MIGRATION_TRAILER}: `];
-  async function storeAuthors(head) {
-    const text4 = await git(["log", ...notMigration, "--format=%x1e%aN%x00%aE%x00%aI", "-z", "--name-only", "--no-renames", "--max-count=20000", head, "--", ".gitifact/spec", INSTRUCTIONS_ROOT, "AGENTS.md"]);
-    const folders = /* @__PURE__ */ new Map();
-    const instructions2 = /* @__PURE__ */ new Map();
-    for (const chunk of text4.split("")) {
-      if (!chunk) continue;
-      const [name2, email3, date5, ...paths2] = chunk.split("\0");
-      if (!name2 || !email3 || !date5) throw new StoreError(t2("specReader.authorUnreadable"));
-      const seen = /* @__PURE__ */ new Set();
-      for (const raw of paths2) {
-        const path3 = raw.replace(/^\n/, "");
-        if (!path3) continue;
-        const folder = /^(\.gitifact\/spec\/[^/]+)\//.exec(path3)?.[1];
-        if (folder && !seen.has(folder)) {
-          seen.add(folder);
-          let entry2 = folders.get(folder);
-          if (!entry2) folders.set(folder, entry2 = { people: /* @__PURE__ */ new Map(), count: 0, latest: date5 });
-          if (entry2.count < 2e3) {
-            entry2.count++;
-            tally(entry2.people, name2, email3, date5);
-          }
-        }
-        const instruction2 = path3 === "AGENTS.md" ? path3 : /^(\.gitifact\/instructions\/[^/]+)\//.exec(path3)?.[1];
-        if (instruction2 && !instructions2.has(instruction2)) instructions2.set(instruction2, date5);
-      }
-    }
-    return { folders, instructions: instructions2 };
-  }
   async function read() {
     const raw = await readConfigFile(root);
     if (!raw) throw new StoreError(t2("specReader.schemaRequired"));
     parseManagedConfig(raw);
     const head = await readHead();
     const stamp = await readStamp();
-    const [current2, dirty, authors, everyone] = await settled([
+    const [current2, dirty, authors, people] = await settled([
       cache.documents.list(),
       head ? git(["status", "--porcelain=v1", "--", ".gitifact/spec", INSTRUCTIONS_ROOT]) : Promise.resolve(""),
-      head ? storeAuthors(head) : Promise.resolve(void 0),
-      // Git mailmap may change without a new HEAD; refresh names with every observation that carries them.
-      head ? git(["log", ...notMigration, "--format=%aN%x00%aE%x00%aI", "--max-count=10001", head]) : Promise.resolve("")
+      // Who touched each folder and who committed at all, counted over the commit log in the cache.
+      head ? cache.log.folders(head) : Promise.resolve(/* @__PURE__ */ new Map()),
+      head ? cache.log.contributors(head) : Promise.resolve([])
     ]);
-    const people = /* @__PURE__ */ new Map();
-    const lines = everyone.trim().split("\n").filter(Boolean);
-    for (const line2 of lines.slice(0, 1e4)) {
-      const [name2, email3, latest] = line2.split("\0");
-      if (!name2 || !email3 || !latest) throw new StoreError(t2("specReader.authorUnreadable"));
-      tally(people, name2, email3, latest);
-    }
     const states = await documentStates({ head: async () => head, reader }, current2.documents);
-    const arranged = checkoutDocuments(states);
-    const features = arranged.features.map((feature2) => {
-      const entry2 = authors?.folders.get(folderOf3(feature2.path));
-      return { ...feature2, contributors: entry2 ? [...entry2.people.values()].sort((a, b) => b.commits - a.commits) : [], updatedAt: entry2?.latest ?? null };
-    });
-    const instructions2 = await Promise.all(arranged.instructions.map(async (instruction2) => {
-      const { files, limited } = instruction2.state === "deleted" ? { files: [], limited: false } : await readInstructionFiles(root, instruction2.path);
-      return { ...instruction2, files, filesLimited: limited, updatedAt: authors?.instructions.get(instruction2.path.split("/").slice(0, 3).join("/")) ?? null };
-    }));
-    const agentsText = await readAgentsFile(root);
-    const agents2 = agentsText === null ? null : { path: "AGENTS.md", body: agentsText, updatedAt: authors?.instructions.get("AGENTS.md") ?? null };
-    const problems = [...current2.problems, ...arranged.orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
+    const { features, instructions: instructions2, orphans } = checkoutDocuments(states, authors);
+    const problems = [...current2.problems, ...orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
     if (await readHead() !== head) throw new StoreError(t2("specReader.projectChanged"));
-    const checkout = browserSpecsV7.parse({
-      contract: "browser-specs",
-      version: 7,
-      sessionId,
+    return {
       head,
-      observedAt: (/* @__PURE__ */ new Date()).toISOString(),
       stamp,
+      observedAt: (/* @__PURE__ */ new Date()).toISOString(),
       working: head ? !!dirty.trim() : features.length > 0 || instructions2.length > 0,
       features,
       instructions: instructions2,
-      agents: agents2,
       problems,
-      contributors: [...people.values()].sort((a, b) => b.commits - a.commits),
-      contributorsLimited: lines.length > 1e4
-    });
-    return { checkout, head };
+      people,
+      folders: authors
+    };
   }
-  return () => {
+  const base = () => {
     const language = getLanguage();
     let value = pending.get(language);
     if (!value) {
@@ -27897,10 +28191,37 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
     }
     return value;
   };
+  return {
+    base,
+    /** Every instruction by name with the other files of its folder, and AGENTS.md: few enough to read whole. */
+    async instructions() {
+      const checkout = await base();
+      const instructions2 = await Promise.all([...checkout.instructions].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0).map(async (instruction2) => {
+        const { files, limited } = instruction2.state === "deleted" ? { files: [], limited: false } : await readInstructionFiles(root, instruction2.path);
+        return { ...instruction2, files, filesLimited: limited };
+      }));
+      const agentsText = await readAgentsFile(root);
+      return { instructions: instructions2, agents: agentsText === null ? null : { path: "AGENTS.md", body: agentsText, updatedAt: checkout.folders.get("AGENTS.md")?.latest ?? null } };
+    }
+  };
+}
+
+// src/queries/paging.ts
+var PAGE_SIZE = 20;
+function pageOf(rows, keyOf, request) {
+  let start = 0;
+  if (request.after !== void 0) {
+    const at = rows.findIndex((row) => keyOf(row) === request.after);
+    if (at < 0) return void 0;
+    start = at + 1;
+  }
+  const size = request.all ? rows.length : request.limit ?? PAGE_SIZE;
+  const shown = rows.slice(start, start + size);
+  const more = start + shown.length < rows.length && shown.length > 0;
+  return { rows: shown, total: rows.length, next: more ? keyOf(shown[shown.length - 1]) : null };
 }
 
 // src/server/commit/commit-files.ts
-var LIST_LIMIT = 500;
 var TEXT_LIMIT = 512 * 1024;
 var KEPT = 200;
 var statusOf = (code) => code.startsWith("R") ? "renamed" : code === "A" ? "added" : code === "D" ? "deleted" : "modified";
@@ -27956,10 +28277,15 @@ function createCommitFiles(git) {
     return git.run(["cat-file", "blob", `${rev}:${path3}`]);
   }
   return {
-    /** The first `LIST_LIMIT` source files and how many there are; undefined for a commit the repository lacks. */
-    async files(commit) {
+    /**
+     * A page of the source files after the file `after` (a path) and how many there are in all: undefined for a commit
+     * the repository lacks, null for a cursor the commit does not have.
+     */
+    async files(commit, request) {
       const all = await list(commit);
-      return all && { ...all, files: all.files.slice(0, LIST_LIMIT) };
+      if (!all) return void 0;
+      const page = pageOf(all.files, (f) => f.path, request);
+      return page ? { ...all, files: page.rows, next: page.next } : null;
     },
     /** One listed file on both sides; undefined when the commit did not change that path. */
     async file(commit, path3) {
@@ -28041,31 +28367,200 @@ async function workingChange2(source2, id) {
   };
 }
 
+// src/queries/search.ts
+var SEARCH_GROUPS = ["feature", "requirement", "design", "instruction", "record", "commit"];
+var FIRST = 5;
+var RECENT = 6;
+var place2 = (path3) => path3.replace(/^\.gitifact\//, "");
+var folderOf5 = (path3) => path3.split("/").slice(0, 3).join("/");
+async function searchRecords(source2, request) {
+  const head = request.head ?? await source2.head();
+  const query = request.q.trim().toLowerCase();
+  if (!query) return [await recent(source2, head)];
+  const size = request.group ? request.limit ?? 20 : FIRST;
+  const one = async (group) => {
+    const found = group === "record" ? head ? await source2.cache.history.searchRecords(head, query, request.after, size) : empty() : group === "commit" ? head ? await source2.cache.log.commitsNamed(head, query, request.after, size) : empty() : await source2.cache.documents.searchKind(group, query, request.after, size);
+    return found && { group, ...found };
+  };
+  const groups = await Promise.all((request.group ? [request.group] : SEARCH_GROUPS).map(one));
+  if (groups.some((g) => !g)) return void 0;
+  return groups.filter((g) => request.group || g.total > 0);
+}
+var empty = () => ({ total: 0, next: null, hits: [] });
+async function recent(source2, head) {
+  const [{ documents }, folders] = await Promise.all([source2.cache.documents.list(), head ? source2.cache.log.folders(head) : /* @__PURE__ */ new Map()]);
+  const hits = documents.filter((d) => d.kind === "feature" || d.kind === "instruction").map((d) => ({ doc: d, latest: folders.get(folderOf5(d.path))?.latest })).filter((d) => !!d.latest).sort((a, b) => Date.parse(b.latest) - Date.parse(a.latest) || a.doc.id.localeCompare(b.doc.id)).slice(0, RECENT).map(({ doc }) => ({
+    id: doc.id,
+    kind: doc.kind,
+    title: doc.title,
+    where: place2(doc.path),
+    line: doc.description,
+    ...doc.kind === "feature" ? { featureId: doc.id } : {}
+  }));
+  return { group: "recent", total: hits.length, next: null, hits };
+}
+
+// src/queries/checkout.ts
+var SHOWN_REQUIREMENTS = 12;
+function checkoutIndex(base) {
+  return {
+    features: base.features.map((f) => ({
+      id: f.id,
+      path: f.path,
+      title: f.title,
+      state: f.state,
+      requirements: f.requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description })),
+      designs: f.designs.map((d) => ({ id: d.id, path: d.path, title: d.title }))
+    })),
+    instructions: base.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title })),
+    people: base.people.map((p) => ({ name: p.name, email: p.email }))
+  };
+}
+var acceptanceHeading = /^###\s+(?:수용 조건|acceptance criteria)\s*$/i;
+function acceptanceCount(body2) {
+  const lines = body2.replace(/\r\n/g, "\n").split("\n");
+  const start = lines.findIndex((line2) => acceptanceHeading.test(line2.trim()));
+  if (start < 0) return null;
+  let count2 = 0;
+  for (const line2 of lines.slice(start + 1)) {
+    if (/^#{1,6}\s/.test(line2)) break;
+    if (/^\d+\.\s/.test(line2)) count2++;
+  }
+  return count2 || null;
+}
+function listFeatures(base, filter, request) {
+  const query = filter.q?.trim().toLowerCase();
+  const named = (f) => !query || (f.title + " " + f.id).toLowerCase().includes(query);
+  const key = filter.sort ?? "updated";
+  const opens = { title: "asc", requirements: "desc", updated: "desc" };
+  const way = (filter.dir ?? opens[key]) === "asc" ? 1 : -1;
+  const groups = base.features.filter((f) => !filter.design || filter.design === "yes" === f.designs.length > 0).filter((f) => !filter.author || f.contributors.some((p) => p.email === filter.author)).map((f) => ({ feature: f, requirements: named(f) ? f.requirements : f.requirements.filter((r) => (r.title + " " + r.id).toLowerCase().includes(query)) })).filter((g) => named(g.feature) || g.requirements.length).sort((a, b) => way * (key === "requirements" ? a.feature.requirements.length - b.feature.requirements.length : key === "title" ? a.feature.title.localeCompare(b.feature.title) : (a.feature.updatedAt ?? "").localeCompare(b.feature.updatedAt ?? "")) || a.feature.title.localeCompare(b.feature.title));
+  const page = pageOf(groups, (g) => g.feature.id, request);
+  if (!page) return void 0;
+  const features = page.rows.map(({ feature: f, requirements }) => {
+    const designed = new Set(f.designs.flatMap((d) => d.requirements));
+    return {
+      id: f.id,
+      path: f.path,
+      title: f.title,
+      description: f.description,
+      state: f.state,
+      designs: f.designs.length,
+      contributors: f.contributors,
+      updatedAt: f.updatedAt,
+      requirementCount: f.requirements.length,
+      requirements: requirements.slice(0, SHOWN_REQUIREMENTS).map((r) => ({
+        id: r.id,
+        title: r.title,
+        description: r.description,
+        state: r.state,
+        acceptance: acceptanceCount(r.body),
+        designed: designed.has(r.id)
+      })),
+      hidden: Math.max(0, requirements.length - SHOWN_REQUIREMENTS)
+    };
+  });
+  return {
+    total: page.total,
+    all: base.features.length,
+    requirements: groups.reduce((sum, g) => sum + g.requirements.length, 0),
+    mostRequirements: Math.max(0, ...base.features.map((f) => f.requirements.length)),
+    next: page.next,
+    features
+  };
+}
+var featureOf = (base, id) => base.features.find((f) => f.id === id);
+function listContributors(base, q, request) {
+  const query = q?.trim().toLowerCase();
+  const people = base.people.filter((p) => !query || (p.name + " " + p.email).toLowerCase().includes(query));
+  const page = pageOf(people, (p) => p.email, request);
+  if (!page) return void 0;
+  const touched = (email3) => base.features.filter((f) => f.contributors.some((c) => c.email === email3)).length;
+  return { total: page.total, next: page.next, people: page.rows.map((p) => ({ ...p, features: touched(p.email) })) };
+}
+function contributorOf(base, email3) {
+  const person = base.people.find((p) => p.email === email3);
+  if (!person) return void 0;
+  const features = base.features.flatMap((f) => {
+    const share = f.contributors.find((c) => c.email === email3);
+    return share ? [{ id: f.id, title: f.title, commits: share.commits, requirements: f.requirements.length }] : [];
+  });
+  return { person, features };
+}
+function topContributors(people) {
+  const rest = people.slice(3);
+  return { total: people.length, top: people.slice(0, 3), rest: { count: rest.length, commits: rest.reduce((sum, p) => sum + p.commits, 0) } };
+}
+
 // src/server/routes/record-routes.ts
 var PAGE = 20;
 function recordRoutes(root, sessionId, env) {
   const git = storeReader(root);
   const cache = openCache(root, { run: (args, input2) => git.run(args, input2), decode: git.decode, legacyBundles: (oids) => git.readBundles(oids) });
-  const readCheckout = createCheckoutReader(root, sessionId, cache, env);
+  const checkout = createCheckoutReader(root, cache, env);
   const readStamp = createStampReader(root, env);
   const commitFiles = createCommitFiles(git);
+  const source2 = { head: async () => (await git.baseline()).head, reader: git, cache };
   const working2 = { head: async () => (await git.baseline()).head, cache, pendingRecords: () => readPendingRecords(root, (args) => git.run(args)) };
   const unreadable2 = () => t2("server.specsUnreadable");
-  const cursorGone = () => new HttpError(404, "NOT_FOUND", t2("server.cursorNotFound"));
+  const cursorGone2 = () => new HttpError(404, "NOT_FOUND", t2("server.cursorNotFound"));
   return [
-    route({ method: "GET", path: "/api/v1/specs", session: true, unreadable: unreadable2, handle: async () => ok((await readCheckout()).checkout) }),
+    // The checkout a part at a time, each shaped by the query layer (`queries/checkout.ts`): the frame every screen reads
+    // first, the feature list and one feature, the instructions, and the contributors.
+    route({ method: "GET", path: "/api/v1/checkout", session: true, unreadable: unreadable2, handle: async () => {
+      const base = await checkout.base();
+      return ok(browserCheckoutV1.parse({
+        contract: "browser-checkout",
+        version: 1,
+        sessionId,
+        head: base.head,
+        observedAt: base.observedAt,
+        stamp: base.stamp,
+        working: base.working,
+        problems: base.problems,
+        index: checkoutIndex(base)
+      }));
+    } }),
+    route({ method: "GET", path: "/api/v1/features", session: true, query: browserFeaturesQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = listFeatures(await checkout.base(), query, { after: query.after, limit: query.limit ?? PAGE });
+      if (!page) throw cursorGone2();
+      return ok(browserFeaturesV1.parse({ contract: "browser-features", version: 1, sessionId, ...page }));
+    } }),
+    route({ method: "GET", path: "/api/v1/feature", session: true, query: browserFeatureQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const feature2 = featureOf(await checkout.base(), query.id);
+      if (!feature2) throw new HttpError(404, "NOT_FOUND", t2("server.featureNotFound"));
+      return ok(browserFeatureV1.parse({ contract: "browser-feature", version: 1, sessionId, feature: feature2 }));
+    } }),
+    route({ method: "GET", path: "/api/v1/instructions", session: true, unreadable: unreadable2, handle: async () => ok(browserInstructionsV1.parse({ contract: "browser-instructions", version: 1, sessionId, ...await checkout.instructions() })) }),
+    route({ method: "GET", path: "/api/v1/contributors", session: true, query: browserContributorsQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = listContributors(await checkout.base(), query.q, { after: query.after, limit: query.limit ?? PAGE });
+      if (!page) throw cursorGone2();
+      return ok(browserContributorsV1.parse({ contract: "browser-contributors", version: 1, sessionId, ...page }));
+    } }),
+    route({ method: "GET", path: "/api/v1/contributor", session: true, query: browserContributorQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const found = contributorOf(await checkout.base(), query.email);
+      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.contributorNotFound"));
+      return ok(browserContributorV1.parse({ contract: "browser-contributor", version: 1, sessionId, ...found }));
+    } }),
     // Whether the screen is behind, asked when the reader comes back to the tab; cheap enough to ask every time.
     route({ method: "GET", path: "/api/v1/stamp", session: true, unreadable: unreadable2, handle: async () => ok(browserStampV1.parse({ contract: "browser-stamp", version: 1, sessionId, stamp: await readStamp() })) }),
     route({ method: "GET", path: "/api/v1/history", session: true, query: browserHistoryQueryV4, unreadable: unreadable2, handle: async ({ query }) => {
       const page = await cache.history.commits(query.head, { kind: query.kind, document: query.document, feature: query.feature, author: query.author, q: query.q }, query.after, query.limit ?? PAGE);
-      if (!page) throw cursorGone();
+      if (!page) throw cursorGone2();
       return ok(browserHistoryV6.parse({ contract: "browser-history", version: 6, sessionId, head: query.head, ...page }));
     } }),
-    route({ method: "GET", path: "/api/v1/history/summary", session: true, query: browserHistorySummaryQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserHistorySummaryV4.parse({ contract: "browser-history-summary", version: 4, sessionId, head: query.head, ...await cache.history.summary(query.head) })) }),
+    route({ method: "GET", path: "/api/v1/history/summary", session: true, query: browserHistorySummaryQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserHistorySummaryV5.parse({
+      contract: "browser-history-summary",
+      version: 5,
+      sessionId,
+      head: query.head,
+      ...await cache.history.summary(query.head),
+      people: topContributors(await cache.log.contributors(query.head))
+    })) }),
     // One commit as its page reads it: who made it and a page of the documents it changed, even when it changed none.
-    route({ method: "GET", path: "/api/v1/commit", session: true, query: browserCommitQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
-      const page = await cache.history.commitChanges(query.commit, query.after, query.limit ?? PAGE);
-      if (!page) throw cursorGone();
+    route({ method: "GET", path: "/api/v1/commit", session: true, query: browserCommitQueryV3, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = await cache.history.commitChanges(query.commit, query.after, query.limit ?? PAGE, query.record);
+      if (!page) throw cursorGone2();
       const first = page.events[0];
       const line2 = first ? [] : git.decode(await git.run(["log", "-1", "--format=%aN%x00%aE%x00%cN%x00%aI%x00%s", query.commit, "--"]).catch(() => Buffer.from(""))).split("\0");
       if (!first && line2.length < 5) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
@@ -28093,9 +28588,9 @@ function recordRoutes(root, sessionId, env) {
     } }),
     // A record's page names the record; which commit added it is read from the history of the HEAD the reader is on.
     route({ method: "GET", path: "/api/v1/record", session: true, query: browserRecordQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
-      const commit = await cache.history.commitOfRecord(query.head, query.id);
-      if (!commit) throw new HttpError(404, "NOT_FOUND", t2("server.recordNotFound"));
-      return ok(browserRecordV1.parse({ contract: "browser-record", version: 1, sessionId, head: query.head, id: query.id, commit }));
+      const found = await cache.history.recordOf(query.head, query.id);
+      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.recordNotFound"));
+      return ok(browserRecordV2.parse({ contract: "browser-record", version: 2, sessionId, head: query.head, id: query.id, ...found }));
     } }),
     // What is not committed yet, worked out again on every request: the uncommitted entry of the records list.
     route({ method: "GET", path: "/api/v1/working", session: true, unreadable: unreadable2, handle: async () => ok(browserWorkingV1.parse({ contract: "browser-working", version: 1, sessionId, ...await workingOverview(working2) })) }),
@@ -28105,10 +28600,11 @@ function recordRoutes(root, sessionId, env) {
       return ok(browserWorkingChangeV1.parse({ contract: "browser-working-change", version: 1, sessionId, ...change2 }));
     } }),
     // The source a commit changed beside its documents, read from Git when the commit or record page asks for it.
-    route({ method: "GET", path: "/api/v1/commit/files", session: true, query: browserCommitFilesQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
-      const found = await commitFiles.files(query.commit);
-      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
-      return ok(browserCommitFilesV1.parse({ contract: "browser-commit-files", version: 1, sessionId, commit: found.commit, total: found.total, files: found.files }));
+    route({ method: "GET", path: "/api/v1/commit/files", session: true, query: browserCommitFilesQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
+      const found = await commitFiles.files(query.commit, { after: query.after, limit: query.limit ?? PAGE });
+      if (found === void 0) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
+      if (found === null) throw cursorGone2();
+      return ok(browserCommitFilesV2.parse({ contract: "browser-commit-files", version: 2, sessionId, commit: found.commit, total: found.total, next: found.next, files: found.files }));
     } }),
     route({ method: "GET", path: "/api/v1/commit/file", session: true, query: browserCommitFileQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
       const found = await commitFiles.file(query.commit, query.path);
@@ -28122,21 +28618,26 @@ function recordRoutes(root, sessionId, env) {
       if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.instructionFileNotFound"));
       return ok(browserInstructionFileV1.parse({ contract: "browser-instruction-file", version: 1, sessionId, id: query.id, path: query.path, ...found }));
     } }),
-    route({ method: "GET", path: "/api/v1/search", session: true, query: browserSearchQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserSearchV2.parse({ contract: "browser-search", version: 2, sessionId, query: query.q, hits: await cache.search(query.head ?? null, query.q) })) })
+    // The search box's groups as the query layer works them out (`queries/search.ts`); the browser only draws them.
+    route({ method: "GET", path: "/api/v1/search", session: true, query: browserSearchQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
+      const groups = await searchRecords(source2, query);
+      if (!groups) throw cursorGone2();
+      return ok(browserSearchV3.parse({ contract: "browser-search", version: 3, sessionId, query: query.q, groups }));
+    } })
   ];
 }
 
 // src/server/routes/asset-routes.ts
-import { lstat as lstat8, readFile as readFile7 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { lstat as lstat9, readFile as readFile7 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 function assetRoutes(root) {
   return [
     route({ method: "GET", path: "/api/v1/assets/*", session: false, handle: async ({ path: path3, response }) => {
       const relative = path3.slice("/api/v1/assets/".length);
       const assetPath = ASSETS_DIR + "/" + relative;
       if (!isAssetPath(assetPath)) throw new HttpError(404, "NOT_FOUND", t2("server.assetNotFound"));
-      const file2 = join9(root, ...assetPath.split("/"));
-      const stat3 = await lstat8(file2).catch(() => void 0);
+      const file2 = join10(root, ...assetPath.split("/"));
+      const stat3 = await lstat9(file2).catch(() => void 0);
       if (!stat3?.isFile() || stat3.isSymbolicLink() || stat3.size > 20 * 1024 * 1024) throw new HttpError(404, "NOT_FOUND", t2("server.assetNotFound"));
       const bytes = await readFile7(file2);
       const extension = assetExtension(relative);
@@ -28286,13 +28787,13 @@ async function runBrowser(options, version2) {
 
 // src/commands/spec-init.ts
 import { readdir as readdir5 } from "node:fs/promises";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 
 // src/adapters/git/init-repository.ts
 import { createHash as createHash3 } from "node:crypto";
-import { lstat as lstat9, readFile as readFile9 } from "node:fs/promises";
-import { join as join10 } from "node:path";
-var markerPresent = (path3) => lstat9(path3).then(() => true, (error62) => {
+import { lstat as lstat10, readFile as readFile9 } from "node:fs/promises";
+import { join as join11 } from "node:path";
+var markerPresent = (path3) => lstat10(path3).then(() => true, (error62) => {
   if (error62.code === "ENOENT") return false;
   throw error62;
 });
@@ -28315,7 +28816,7 @@ function initRepository(cwd, inherited = process.env) {
       const gitDir = locations.length === 2 ? locations[0] : decodeGitLine(await git(["rev-parse", "--absolute-git-dir"], root));
       const indexPath = locations.length === 2 ? locations[1] : decodeGitLine(await git(["rev-parse", "--path-format=absolute", "--git-path", "index"], root));
       for (const marker2 of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"]) {
-        if (await markerPresent(join10(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+        if (await markerPresent(join11(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
       }
       if (state2.changes.some((change2) => change2.kind === "unmerged")) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
       const index = await readFile9(indexPath).catch((error62) => {
@@ -28353,14 +28854,14 @@ function initRepository(cwd, inherited = process.env) {
 
 // src/adapters/filesystem/document-file.ts
 import { randomBytes } from "node:crypto";
-import { lstat as lstat10, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { lstat as lstat11, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join12 } from "node:path";
 var generateId = (prefix) => prefix + "-" + [...randomBytes(10)].map((n) => "abcdefghijklmnopqrstuvwxyz234567"[n & 31]).join("");
 async function createDocumentFile(root, path3, text4) {
   const parts = path3.split("/");
   for (let i = 1; i < parts.length; i++) {
-    const folder = join11(root, ...parts.slice(0, i));
-    const info5 = await lstat10(folder).catch((error62) => {
+    const folder = join12(root, ...parts.slice(0, i));
+    const info5 = await lstat11(folder).catch((error62) => {
       if (error62.code === "ENOENT") return void 0;
       throw error62;
     });
@@ -28370,7 +28871,7 @@ async function createDocumentFile(root, path3, text4) {
     }
     if (!info5.isDirectory() || info5.isSymbolicLink()) throw Object.assign(new Error(folder), { code: "ENOTDIR" });
   }
-  await writeFile2(join11(root, ...parts), text4, { flag: "wx" });
+  await writeFile2(join12(root, ...parts), text4, { flag: "wx" });
 }
 var LINE_ENDINGS_PATH = ".gitifact/.gitattributes";
 var LINE_ENDINGS = "# Written by gitifact init: documents keep LF on every OS, so what Git holds and the files read the same.\n* text=auto eol=lf\n";
@@ -28386,14 +28887,14 @@ async function writeLineEndings(root) {
 
 // src/adapters/filesystem/managed-file.ts
 import { open as open4, readFile as readFile10, mkdir as mkdir4, realpath as realpath2, rename as rename2, link as link2, unlink as unlink2 } from "node:fs/promises";
-import { join as join12, dirname } from "node:path";
+import { join as join13, dirname } from "node:path";
 import { randomUUID as randomUUID4 } from "node:crypto";
 var DEFAULT_LIMIT = 1024 * 1024;
 async function managedPath(root, path3, create = false) {
   let full = root;
   const parts = path3.split("/");
   for (let i = 0; i < parts.length; i++) {
-    full = join12(full, parts[i]);
+    full = join13(full, parts[i]);
     let info5 = await fileInfo(full);
     if (!info5 && create && i < parts.length - 1) {
       await mkdir4(full).catch((error62) => {
@@ -28441,7 +28942,7 @@ async function managedWrite(root, path3, previous, next, recheck) {
     if (previous !== null) await unlink2(full);
     return;
   }
-  const temp = join12(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
+  const temp = join13(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
   const handle = await open4(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -28546,15 +29047,15 @@ function boilerplateFor(path3) {
   return "# " + name2 + "\n\nProject-specific guidance for AI coding agents.\n";
 }
 var readBundledBlock = (lang) => readFile12(new URL("./i18n/" + lang + "/block.md", import.meta.url), "utf8");
-async function renderAgentBlock(version2, controls = {}, lang = getLanguage()) {
+async function renderAgentBlock(controls = {}, lang = getLanguage()) {
   const body2 = await (controls.readBlock ?? readBundledBlock)(lang);
-  const filled = body2.trimEnd().replace(/\{(version|language|topics)\}/g, (_whole, name2) => name2 === "version" ? version2 : name2 === "language" ? lang : guideTopics.join(", "));
-  return AGENT_START + "\n" + filled + "\n" + AGENT_END;
+  return AGENT_START + "\n" + body2.trimEnd().replace(/\{topics\}/g, guideTopics.join(", ")) + "\n" + AGENT_END;
 }
-function parseAgentBlock(text4) {
-  const match = /^gitifact v(\S+)(?: · ([a-z][a-z-]*))? · .*schemaVersion (\d+)$/m.exec(text4);
-  if (!match) return null;
-  return { version: match[1], language: match[2] ?? "ko", schemaVersion: Number(match[3]) };
+function legacyBlockLanguage(text4) {
+  const match = /^gitifact v\S+(?: · ([a-z][a-z-]*))? · .*schemaVersion \d+$/m.exec(text4);
+  if (!match) return void 0;
+  const language = match[1] ?? "ko";
+  return language === "ko" || language === "en" ? language : void 0;
 }
 function findBlock(text4) {
   const start = text4.indexOf(AGENT_START);
@@ -28616,14 +29117,26 @@ function removeBlock(text4, boilerplate) {
 }
 
 // src/commands/agent-docs.ts
-var skippedAgentDocs = { mode: "skip", paths: [], writes: [], missing: [] };
+var skippedAgentDocs = (language = explicitLanguage() ?? getLanguage()) => ({ mode: "skip", paths: [], writes: [], missing: [], language });
+var blockOf = (text4) => {
+  try {
+    const found = findBlock(text4);
+    return found ? text4.slice(found.start, found.end) : void 0;
+  } catch {
+    return void 0;
+  }
+};
 async function planAgentDocs(root, options) {
-  if (options.skip) return skippedAgentDocs;
+  if (options.skip) return skippedAgentDocs(explicitLanguage() ?? options.language ?? getLanguage());
   const existing = /* @__PURE__ */ new Map();
   for (const path3 of candidatePaths) {
     const text4 = await managedRead(root, path3);
     if (text4 !== null) existing.set(path3, text4);
   }
+  const language = explicitLanguage() ?? options.language ?? [...existing.values()].map((text4) => {
+    const block2 = blockOf(text4);
+    return block2 === void 0 ? void 0 : legacyBlockLanguage(block2);
+  }).find(Boolean) ?? getLanguage();
   const writes = [];
   const paths2 = [];
   if (options.remove) {
@@ -28639,19 +29152,14 @@ async function planAgentDocs(root, options) {
       paths2.push(CLAUDE_WRAPPER_PATH);
       writes.push({ path: CLAUDE_WRAPPER_PATH, previous: wrapper, next: null });
     }
-    return { mode: "remove", paths: paths2, writes, missing: [] };
+    return { mode: "remove", paths: paths2, writes, missing: [], language };
   }
-  const blocks = /* @__PURE__ */ new Map();
-  const blockFor = async (previous) => {
-    const stored = previous ? parseAgentBlock(previous)?.language : void 0;
-    const language = explicitLanguage() ?? (stored === "ko" || stored === "en" ? stored : getLanguage());
-    if (!blocks.has(language)) blocks.set(language, await renderAgentBlock(options.version, options, language));
-    return blocks.get(language);
-  };
+  let block;
+  const blockFor = async () => block ??= await renderAgentBlock(options, language);
   const { inject, create } = options.onlyExisting ? { inject: candidatePaths.filter((path3) => existing.has(path3) && findBlock(existing.get(path3)) && !isWrapperFile(existing.get(path3))), create: null } : resolveAgentPaths(options.agent, existing);
   for (const path3 of inject) {
     const previous = existing.get(path3);
-    const next = injectBlock(previous, await blockFor(previous), boilerplateFor(path3));
+    const next = injectBlock(previous, await blockFor(), boilerplateFor(path3));
     paths2.push(path3);
     if (next !== previous) writes.push({ path: path3, previous, next });
   }
@@ -28671,7 +29179,7 @@ async function planAgentDocs(root, options) {
     if (paths2.includes(path3) || !isWrapperFile(text4) || !findBlock(text4)) continue;
     writes.push({ path: path3, previous: text4, next: removeBlock(text4, boilerplateFor(path3)) });
   }
-  return { mode: "install", paths: paths2, writes, missing: missing2 };
+  return { mode: "install", paths: paths2, writes, missing: missing2, language };
 }
 async function applyAgentDocs(root, plan, recheck) {
   for (const write of plan.writes) await managedWrite(root, write.path, write.previous, write.next, recheck);
@@ -28720,12 +29228,32 @@ async function resolveUpdate(current2, fetchLatest, signal, timeoutMs = updateCh
 var npmGlobalInstall = (version2) => "npm install -g gitifact@" + version2;
 var npxUpdate = (version2) => "npx --yes gitifact@" + version2 + " update";
 
+// src/commands/project-settings.ts
+function settleConfig(config2, version2, language) {
+  const cli = !CLI_VERSION_PATTERN.test(version2) || config2.cli !== void 0 && !isNewerRelease(version2, config2.cli) ? config2.cli : version2;
+  const next = { ...config2, ...cli === void 0 ? {} : { cli }, language };
+  return { config: next, changed: next.cli !== config2.cli || next.language !== config2.language };
+}
+function projectSettings(text4) {
+  if (text4 === void 0) return {};
+  try {
+    const value = JSON.parse(text4);
+    return {
+      ...typeof value.cli === "string" && CLI_VERSION_PATTERN.test(value.cli) ? { cli: value.cli } : {},
+      ...value.language === "ko" || value.language === "en" ? { language: value.language } : {}
+    };
+  } catch {
+    return {};
+  }
+}
+
 // src/commands/spec-init.ts
 async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs, update = disabledUpdate) {
   const repo = initRepository(cwd, env);
   const first = await repo.inspect();
   const root = first.state.repository.rootPath;
-  const docsPlan = agentDocs ? await planAgentDocs(root, agentDocs) : skippedAgentDocs;
+  const language = projectSettings(await readConfigFile(root).catch(() => void 0)).language;
+  let docsPlan = agentDocs ? await planAgentDocs(root, { ...agentDocs, language }) : skippedAgentDocs(language);
   const result = async (config3, outcome, lineEndings = false) => {
     const checked = await update;
     return projectInitV8.parse({
@@ -28746,16 +29274,25 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   const existing = async (text5) => {
     const config3 = parseManagedConfig(text5);
     await repo.validateBaseline(config3, root, first.state.head.commit, first.state.repository.objectFormat);
+    let current2 = text5;
     const unchanged = async () => {
-      if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text5) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
+      if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== current2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
     };
     await unchanged();
+    if (agentDocs && config3.cli && isNewerRelease(config3.cli, agentDocs.version) && docsPlan.mode === "install") docsPlan = skippedAgentDocs(docsPlan.language);
     if (dryRun) return result(config3, "already-initialized");
+    const settled2 = agentDocs ? settleConfig(config3, agentDocs.version, docsPlan.language) : { config: config3, changed: false };
+    if (settled2.changed) {
+      const next = formatManagedConfig(settled2.config, text5);
+      await publishConfig(root, next, unchanged, void 0, true);
+      current2 = next;
+    }
     await applyAgentDocs(root, docsPlan, unchanged);
-    return result(config3, "already-initialized", await writeLineEndings(root));
+    return result(settled2.config, "already-initialized", await writeLineEndings(root));
   };
-  const config2 = { schemaVersion: SCHEMA_VERSION, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
-  const text4 = JSON.stringify(config2, null, 2) + "\n";
+  const base = { schemaVersion: SCHEMA_VERSION, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
+  const config2 = agentDocs ? settleConfig(base, agentDocs.version, docsPlan.language).config : base;
+  const text4 = formatManagedConfig(config2);
   const finish = async (outcome) => {
     const published = async () => {
       if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text4) throw new InitError("INPUT_CHANGED_AFTER_WRITE", t2("init.changedAfterWrite"));
@@ -28768,7 +29305,7 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   if (old !== void 0) return existing(old);
   if (first.trackedConfig) throw new InitError("CONFIG_DELETED", t2("init.configDeleted"));
   const checkRecords = async () => {
-    const entries = await readdir5(join13(root, ".gitifact")).catch((e) => {
+    const entries = await readdir5(join14(root, ".gitifact")).catch((e) => {
       if (e.code === "ENOENT") return [];
       throw e;
     });
@@ -28805,6 +29342,53 @@ var fetchLatestVersion = async (signal) => {
   return latest;
 };
 
+// src/adapters/filesystem/user-cache.ts
+import { mkdir as mkdir5, readFile as readFile13, rename as rename3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join as join15 } from "node:path";
+import { randomUUID as randomUUID5 } from "node:crypto";
+function userCacheDirectory(env = process.env, platform = process.platform, home = homedir()) {
+  if (env.GITIFACT_CACHE_DIR) return env.GITIFACT_CACHE_DIR;
+  if (platform === "win32") return join15(env.LOCALAPPDATA || join15(home, "AppData", "Local"), "gitifact");
+  if (platform === "darwin") return join15(home, "Library", "Caches", "gitifact");
+  return join15(env.XDG_CACHE_HOME || join15(home, ".cache"), "gitifact");
+}
+var cacheFile = (env) => join15(userCacheDirectory(env), "update.json");
+var isTime = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
+async function readUpdateCache(env = process.env) {
+  let value;
+  try {
+    value = JSON.parse(await readFile13(cacheFile(env), "utf8"));
+  } catch {
+    return {};
+  }
+  if (typeof value !== "object" || value === null) return {};
+  const later = value.later;
+  return {
+    ...isTime(value.checkedAt) ? { checkedAt: value.checkedAt } : {},
+    ...typeof value.latest === "string" ? { latest: value.latest } : {},
+    ...isTime(value.checkingSince) ? { checkingSince: value.checkingSince } : {},
+    ...later && typeof later.version === "string" && isTime(later.until) ? { later: { version: later.version, until: later.until } } : {}
+  };
+}
+async function changeUpdateCache(env, change2) {
+  const directory = userCacheDirectory(env);
+  const temporary = join15(directory, "update-" + randomUUID5() + ".tmp");
+  try {
+    const next = change2(await readUpdateCache(env));
+    await mkdir5(directory, { recursive: true });
+    await writeFile3(temporary, JSON.stringify(next) + "\n", "utf8");
+    await rename3(temporary, cacheFile(env));
+  } catch {
+    await unlink3(temporary).catch(() => {
+    });
+  }
+}
+async function recordUpdateCheck(env, update, now = Date.now()) {
+  if (update.status === "disabled" || update.status === "checking") return;
+  await changeUpdateCache(env, ({ checkingSince: _done, ...cache }) => ({ ...cache, checkedAt: new Date(now).toISOString(), ...update.latestVersion ? { latest: update.latestVersion } : {} }));
+}
+
 // src/commands/init.ts
 async function runInit(options, version2) {
   const cancel = new AbortController();
@@ -28819,9 +29403,10 @@ async function runInit(options, version2) {
       update
     );
     if (!dto.ok) throw new Error("unreachable");
+    await recordUpdateCheck(process.env, dto.update);
     const docs = dto.agentDocs.mode === "skip" ? t2("init.text.skipped") : dto.agentDocs.paths.join(", ") + (dto.agentDocs.mode === "remove" ? " (" + t2("init.text.blockRemoved") + ")" : dto.outcome === "planned" ? " (" + t2("init.text.blockPlanned") + ")" : " (" + t2("init.text.blockUpdated") + ")");
     const lineEndings = dto.lineEndings.created ? t2("init.text.lineEndings", { path: dto.lineEndings.path }) + "\n" : "";
-    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npx }) + "\n" : "";
+    const newer = dto.install ? t2("init.text.updateAvailable", { version: dto.update.latestVersion, command: dto.install.npmGlobal }) + "\n" : "";
     process.stdout.write(options.format === "text" ? `${dto.outcome}: ${dto.rootPath}/.gitifact/config.json
 ${t2("init.text.storage")}: schemaVersion ${dto.schemaVersion}
 ${t2("init.text.agentDocs")}: ${docs}
@@ -28836,17 +29421,17 @@ ${lineEndings}${newer}` : JSON.stringify(dto) + "\n");
 }
 
 // src/commands/documents.ts
-import { readFile as readFile13 } from "node:fs/promises";
-import { join as join15 } from "node:path";
+import { readFile as readFile14 } from "node:fs/promises";
+import { join as join17 } from "node:path";
 
 // src/commands/project.ts
-import { join as join14 } from "node:path";
+import { join as join16 } from "node:path";
 var operations = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
 async function openProject(cwd, options = {}) {
   const reader = storeReader(cwd);
   const location = await reader.location();
   if (options.writing) {
-    for (const marker2 of operations) if (await fileInfo(join14(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join16(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await reader.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
   }
   const raw = await readConfigFile(location.root);
@@ -28877,6 +29462,125 @@ function documentsOf(files) {
   return docs;
 }
 
+// src/queries/filters.ts
+function byAuthor(author) {
+  if (author === void 0) return () => true;
+  const wanted = author.trim().toLowerCase();
+  return (change2) => change2.author.toLowerCase() === wanted || change2.email.toLowerCase() === wanted;
+}
+async function since(project, value, head) {
+  if (value === void 0) return () => true;
+  if (/^\d{4}-\d\d-\d\d/.test(value)) {
+    const from = Date.parse(value);
+    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+    return (change2) => Date.parse(change2.date) >= from;
+  }
+  let commit;
+  try {
+    commit = await project.reader.resolve(value);
+  } catch {
+    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+  }
+  if (!head) return () => false;
+  const after = new Set(project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean));
+  return (change2) => after.has(change2.commit);
+}
+async function sinceRange(project, value, head) {
+  if (value === void 0) return {};
+  if (/^\d{4}-\d\d-\d\d/.test(value)) {
+    const from = Date.parse(value);
+    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+    return { from };
+  }
+  let commit;
+  try {
+    commit = await project.reader.resolve(value);
+  } catch {
+    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+  }
+  if (!head) return { commits: [] };
+  return { commits: project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean) };
+}
+var contains = (query) => {
+  const wanted = query?.trim().toLowerCase();
+  return (...texts) => !wanted || texts.some((value) => value?.toLowerCase().includes(wanted));
+};
+
+// src/queries/specs.ts
+var titledSources = (d, byId) => d.sources.map((s) => "id" in s ? { id: s.id, title: byId.get(s.id)?.title ?? null, ...s.note ? { note: s.note } : {} } : s);
+async function listSpecs(source2, filter, request) {
+  const listed3 = await source2.cache.documents.list();
+  const problems = listed3.problems;
+  const states = await documentStates(source2, listed3.documents);
+  const documents = states.documents;
+  const byId = new Map(documents.map((d) => [d.id, d]));
+  const arranged = arrangeDocuments(documents);
+  let features = arranged.features;
+  if (filter.feature !== void 0) {
+    features = features.filter((f) => f.index.feature === filter.feature);
+    if (!features.length) throw new CommandError("UNKNOWN_FEATURE", t2("docs.unknownFeature", { feature: filter.feature }));
+  }
+  const titled = (id) => ({ id, title: byId.get(id)?.title ?? null });
+  const designsOf = /* @__PURE__ */ new Map();
+  for (const f of arranged.features) for (const d of f.designs) for (const r of d.requirements) designsOf.set(r, [...designsOf.get(r) ?? [], titled(d.id)]);
+  const historyNeeded = filter.sort === "updated" || filter.changedSince !== void 0 || filter.author !== void 0 || !!filter.withUpdated;
+  const latest = /* @__PURE__ */ new Map();
+  const newest = /* @__PURE__ */ new Map();
+  let touched;
+  if (historyNeeded) {
+    const head = await source2.head();
+    const changes2 = head ? await source2.cache.history.changesOf(head) : [];
+    changes2.forEach((c, rank) => {
+      if (!latest.has(c.id)) {
+        latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
+        newest.set(c.id, rank);
+      }
+    });
+    if (filter.changedSince !== void 0 || filter.author !== void 0) {
+      const after = await since(source2, filter.changedSince, head);
+      const by = byAuthor(filter.author);
+      touched = new Set(changes2.filter((c) => after(c) && by(c)).map((c) => c.id));
+    }
+  }
+  const matched = filter.q !== void 0 ? await source2.cache.documents.matching(filter.q) : void 0;
+  const rows = features.flatMap((f) => [f.index, ...f.requirements, ...f.designs].filter(
+    (doc) => (filter.type === void 0 || doc.kind === filter.type) && (!filter.withoutDesign || !f.designs.length) && (!filter.uncovered || doc.kind === "requirement" && !designsOf.has(doc.id)) && (!filter.draft || doc.draft) && (!touched || touched.has(doc.id)) && (!matched || matched.has(doc.id))
+  ).map((doc) => ({
+    id: doc.id,
+    kind: doc.kind,
+    feature: doc.feature,
+    path: doc.path,
+    title: doc.title,
+    description: doc.description,
+    ...doc.kind === "requirement" || doc.kind === "design" ? { order: doc.order } : {},
+    ...doc.draft ? { draft: true } : {},
+    state: states.state(doc.id),
+    ...states.previousPath(doc.id) ? { previousPath: states.previousPath(doc.id) } : {},
+    ...doc.kind === "design" ? { requirements: doc.requirements.map(titled), sources: titledSources(doc, byId) } : {},
+    ...doc.kind === "requirement" ? { designs: designsOf.get(doc.id) ?? [] } : {},
+    ...historyNeeded ? { updated: latest.get(doc.id) ?? null } : {},
+    ...matched ? { line: matched.get(doc.id) } : {}
+  })));
+  if (filter.sort === "title") rows.sort((a, b) => a.title.localeCompare(b.title));
+  if (filter.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
+  const grouped = filter.sort === "order";
+  const groups = features.map((f) => ({ id: f.index.id, rows: rows.filter((r) => r.feature === f.index.feature) })).filter((g) => g.rows.length);
+  const page = grouped ? pageOf(groups, (g) => g.id, request) : pageOf(rows, (r) => r.id, request);
+  if (!page) return void 0;
+  const shown = grouped ? page.rows.flatMap((g) => g.rows) : page.rows;
+  return {
+    rows: shown,
+    features,
+    byId,
+    states,
+    grouped,
+    problems,
+    page: { rows: page.rows, total: page.total, next: page.next },
+    unit: grouped ? "feature" : "document",
+    orphans: filter.feature === void 0 ? arranged.orphans : []
+  };
+}
+
 // src/commands/documents.ts
 var draftMark = (doc) => doc.draft ? " (" + t2("docs.draft") + ")" : "";
 var stateLabel = {
@@ -28887,12 +29591,11 @@ var stateLabel = {
 var stateMark = (state2) => state2 === "committed" ? "" : " (" + stateLabel[state2]() + ")";
 var line = (doc) => `${doc.id} ${doc.title}${draftMark(doc)} \u2014 ${doc.description}`;
 var fileLine = (f) => f.title ? `${f.path} ${f.title} \u2014 ${f.description}` : f.path;
-var titledSources = (d, byId) => d.sources.map((s) => "id" in s ? { id: s.id, title: byId.get(s.id)?.title ?? null, ...s.note ? { note: s.note } : {} } : s);
 async function working(project) {
   const { documents } = await project.cache.documents.list();
   return {
     byId: new Map(documents.map((d) => [d.id, d])),
-    read: (path3) => readFile13(join15(project.root, ...path3.split("/")), "utf8"),
+    read: (path3) => readFile14(join17(project.root, ...path3.split("/")), "utf8"),
     referencing: async (id) => [...new Set((await project.cache.documents.referencing(id)).map((r) => r.from))]
   };
 }
@@ -29001,48 +29704,6 @@ function checkFields(fields2, columns3) {
   if (unknown2.length || !fields2.length) throw new CommandError("INVALID_VALUE", t2("list.unknownFields", { fields: unknown2.join(", "), columns: columns3.join(", ") }));
   return [...new Set(fields2)];
 }
-function byAuthor(author) {
-  if (author === void 0) return () => true;
-  const wanted = author.trim().toLowerCase();
-  return (change2) => change2.author.toLowerCase() === wanted || change2.email.toLowerCase() === wanted;
-}
-async function since(project, value, head) {
-  if (value === void 0) return () => true;
-  if (/^\d{4}-\d\d-\d\d/.test(value)) {
-    const from = Date.parse(value);
-    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-    return (change2) => Date.parse(change2.date) >= from;
-  }
-  let commit;
-  try {
-    commit = await project.reader.resolve(value);
-  } catch {
-    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-  }
-  if (!head) return () => false;
-  const after = new Set(project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean));
-  return (change2) => after.has(change2.commit);
-}
-async function sinceRange(project, value, head) {
-  if (value === void 0) return {};
-  if (/^\d{4}-\d\d-\d\d/.test(value)) {
-    const from = Date.parse(value);
-    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-    return { from };
-  }
-  let commit;
-  try {
-    commit = await project.reader.resolve(value);
-  } catch {
-    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-  }
-  if (!head) return { commits: [] };
-  return { commits: project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean) };
-}
-var contains = (query) => {
-  const wanted = query?.trim().toLowerCase();
-  return (...texts) => !wanted || texts.some((value) => value?.toLowerCase().includes(wanted));
-};
 function cell(value) {
   if (value === void 0 || value === null || value === false) return "";
   if (Array.isArray(value)) return value.map((v) => typeof v === "object" && v !== null ? "id" in v ? v.id : "title" in v ? v.title : JSON.stringify(v) : String(v)).join(",");
@@ -29061,18 +29722,14 @@ function selected(rows, fields2) {
     text: rows.length ? text2(rows.map((row) => fields2.map((f) => cell(row[f])).join("	"))) : ""
   };
 }
-var PAGE_SIZE = 20;
 function paginate(rows, keyOf, options) {
-  let start = 0;
-  if (options.after !== void 0) {
-    const at = rows.findIndex((row) => keyOf(row) === options.after);
-    if (at < 0) throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after }));
-    start = at + 1;
-  }
-  const size = options.all ? rows.length : options.limit ?? PAGE_SIZE;
-  const shown = rows.slice(start, start + size);
-  const more = start + shown.length < rows.length && shown.length > 0;
-  return { rows: shown, total: rows.length, next: more ? keyOf(shown[shown.length - 1]) : null };
+  return pageOr(pageOf(rows, keyOf, options), options);
+}
+function pageOr(page, options) {
+  return page ?? cursorGone(options);
+}
+function cursorGone(options) {
+  throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after ?? "" }));
 }
 var pageLine = (page, before = 0, unit = t2("list.items")) => page.next === null ? [] : [t2("list.more", { shown: before + page.rows.length, total: page.total, unit, cursor: page.next })];
 function aside(format2, lines) {
@@ -29088,67 +29745,10 @@ var kindLabel = { feature: () => t2("docs.feature"), requirement: () => t2("docs
 var runSpecsList = (options) => runCommand("specs", options.format, async () => {
   const fields2 = checkFields(options.fields, columns);
   const project = await openProject(process.cwd());
-  const listed3 = await project.cache.documents.list();
-  const problems = listed3.problems;
-  const states = await documentStates(project, listed3.documents);
-  const documents = states.documents;
-  const byId = new Map(documents.map((d) => [d.id, d]));
-  const arranged = arrangeDocuments(documents);
-  let features = arranged.features;
-  if (options.feature !== void 0) {
-    features = features.filter((f) => f.index.feature === options.feature);
-    if (!features.length) throw new CommandError("UNKNOWN_FEATURE", t2("docs.unknownFeature", { feature: options.feature }));
-  }
-  const titled = (id) => ({ id, title: byId.get(id)?.title ?? null });
-  const designsOf = /* @__PURE__ */ new Map();
-  for (const f of arranged.features) for (const d of f.designs) for (const r of d.requirements) designsOf.set(r, [...designsOf.get(r) ?? [], titled(d.id)]);
-  const historyNeeded = options.sort === "updated" || options.changedSince !== void 0 || options.author !== void 0 || !!fields2?.includes("updated");
-  const latest = /* @__PURE__ */ new Map();
-  const newest = /* @__PURE__ */ new Map();
-  let touched;
-  if (historyNeeded) {
-    const head = await project.head();
-    const changes2 = head ? await project.cache.history.changesOf(head) : [];
-    changes2.forEach((c, rank) => {
-      if (!latest.has(c.id)) {
-        latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
-        newest.set(c.id, rank);
-      }
-    });
-    if (options.changedSince !== void 0 || options.author !== void 0) {
-      const after = await since(project, options.changedSince, head);
-      const by = byAuthor(options.author);
-      touched = new Set(changes2.filter((c) => after(c) && by(c)).map((c) => c.id));
-    }
-  }
-  const matched = options.q !== void 0 ? await project.cache.documents.matching(options.q) : void 0;
-  const rows = features.flatMap((f) => [f.index, ...f.requirements, ...f.designs].filter(
-    (doc) => (options.type === void 0 || doc.kind === options.type) && (!options.withoutDesign || !f.designs.length) && (!options.uncovered || doc.kind === "requirement" && !designsOf.has(doc.id)) && (!options.draft || doc.draft) && (!touched || touched.has(doc.id)) && (!matched || matched.has(doc.id))
-  ).map((doc) => ({
-    id: doc.id,
-    kind: doc.kind,
-    feature: doc.feature,
-    path: doc.path,
-    title: doc.title,
-    description: doc.description,
-    ...doc.kind === "requirement" || doc.kind === "design" ? { order: doc.order } : {},
-    ...doc.draft ? { draft: true } : {},
-    state: states.state(doc.id),
-    ...states.previousPath(doc.id) ? { previousPath: states.previousPath(doc.id) } : {},
-    ...doc.kind === "design" ? { requirements: doc.requirements.map(titled), sources: titledSources(doc, byId) } : {},
-    ...doc.kind === "requirement" ? { designs: designsOf.get(doc.id) ?? [] } : {},
-    ...historyNeeded ? { updated: latest.get(doc.id) ?? null } : {},
-    ...matched ? { line: matched.get(doc.id) } : {}
-  })));
-  if (options.sort === "title") rows.sort((a, b) => a.title.localeCompare(b.title));
-  if (options.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
-  const grouped = options.sort === "order";
-  const groups = features.map((f) => ({ id: f.index.id, rows: rows.filter((r) => r.feature === f.index.feature) })).filter((g) => g.rows.length);
-  const page = grouped ? paginate(groups, (g) => g.id, options) : paginate(rows, (r) => r.id, options);
-  const shown = grouped ? page.rows.flatMap((g) => g.rows) : page.rows;
+  const listed3 = await listSpecs(project, { ...options, withUpdated: !!fields2?.includes("updated") }, options) ?? cursorGone(options);
+  const { rows: shown, features, byId, states, grouped, problems, orphans, page } = listed3;
   const more = pageLine(page, 0, grouped ? t2("list.features") : t2("list.items"));
-  const paging = { total: page.total, next: page.next, unit: grouped ? "feature" : "document" };
-  const orphans = options.feature === void 0 ? arranged.orphans : [];
+  const paging = { total: page.total, next: page.next, unit: listed3.unit };
   if (fields2) {
     const picked = selected(shown, fields2);
     return { json: { documents: picked.json, orphans, problems, page: paging }, text: picked.text + aside(options.format, more) };
@@ -29192,27 +29792,23 @@ var runSpecsShow = (ids, options) => runCommand("specs", options.format, async (
 });
 var runSpecsNew = (kind2, path3, options) => runCommand("specs", options.format, async () => createDocument(await openProject(process.cwd()), kind2, path3, options));
 
-// src/commands/instructions.ts
-import { lstat as lstat11 } from "node:fs/promises";
-import { join as join16 } from "node:path";
-var instructionSorts = ["name", "updated"];
-var columns2 = ["id", "name", "path", "title", "description", "draft", "state", "previousPath", "files", "updated", "line"];
+// src/queries/instructions.ts
+import { lstat as lstat12 } from "node:fs/promises";
+import { join as join18 } from "node:path";
 var AGENTS = "AGENTS.md";
-var runInstructionsList = (options) => runCommand("instructions", options.format, async () => {
-  const fields2 = checkFields(options.fields, columns2);
-  const project = await openProject(process.cwd());
-  const listed3 = await project.cache.documents.list();
+async function listInstructions(source2, options, request) {
+  const listed3 = await source2.cache.documents.list();
   const problems = listed3.problems;
-  const states = await documentStates(project, listed3.documents);
+  const states = await documentStates(source2, listed3.documents);
   const documents = states.documents;
-  const agents2 = { path: AGENTS, exists: !!(await lstat11(join16(project.root, AGENTS)).catch(() => void 0))?.isFile() };
-  const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!fields2?.includes("updated");
+  const agents2 = { path: AGENTS, exists: !!(await lstat12(join18(source2.root, AGENTS)).catch(() => void 0))?.isFile() };
+  const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!options.withUpdated;
   const latest = /* @__PURE__ */ new Map();
   const newest = /* @__PURE__ */ new Map();
   let touched;
   if (historyNeeded) {
-    const head = await project.head();
-    const changes2 = head ? await project.cache.history.changesOf(head) : [];
+    const head = await source2.head();
+    const changes2 = head ? await source2.cache.history.changesOf(head) : [];
     changes2.forEach((c, rank) => {
       if (!latest.has(c.id)) {
         latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
@@ -29224,11 +29820,11 @@ var runInstructionsList = (options) => runCommand("instructions", options.format
       touched = new Set(changes2.filter(by).map((c) => c.id));
     }
   }
-  const matched = options.q !== void 0 ? await project.cache.documents.matching(options.q) : void 0;
+  const matched = options.q !== void 0 ? await source2.cache.documents.matching(options.q) : void 0;
   const instructions2 = documents.filter((d) => d.kind === "instruction").filter((d) => (!touched || touched.has(d.id)) && (!matched || matched.has(d.id))).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
   const rows = await Promise.all(instructions2.map(async (d) => {
     const state2 = states.state(d.id);
-    const { files, limited } = state2 === "deleted" ? { files: [], limited: false } : await readInstructionFiles(project.root, d.path);
+    const { files, limited } = state2 === "deleted" ? { files: [], limited: false } : await readInstructionFiles(source2.root, d.path);
     return {
       id: d.id,
       name: d.name,
@@ -29245,7 +29841,19 @@ var runInstructionsList = (options) => runCommand("instructions", options.format
     };
   }));
   if (options.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
-  const page = paginate(rows, (r) => r.id, options);
+  const page = pageOf(rows, (r) => r.id, request);
+  if (!page) return void 0;
+  return { agents: agents2, problems, page };
+}
+
+// src/commands/instructions.ts
+var instructionSorts = ["name", "updated"];
+var columns2 = ["id", "name", "path", "title", "description", "draft", "state", "previousPath", "files", "updated", "line"];
+var runInstructionsList = (options) => runCommand("instructions", options.format, async () => {
+  const fields2 = checkFields(options.fields, columns2);
+  const project = await openProject(process.cwd());
+  const listed3 = await listInstructions(project, { ...options, withUpdated: !!fields2?.includes("updated") }, options) ?? cursorGone(options);
+  const { agents: agents2, problems, page } = listed3;
   const shown = page.rows;
   const paging = { total: page.total, next: page.next, unit: "instruction" };
   const unreadable2 = problems.filter((p) => p.path.startsWith(INSTRUCTIONS_ROOT + "/"));
@@ -29291,9 +29899,9 @@ var runInstructionsShow = (targets, options) => runCommand("instructions", optio
 var runInstructionsNew = (name2, options) => runCommand("instructions", options.format, async () => createDocument(await openProject(process.cwd()), "instruction", name2, options));
 
 // src/adapters/filesystem/document-warnings.ts
-import { lstat as lstat12, readdir as readdir6 } from "node:fs/promises";
-import { join as join17 } from "node:path";
-var info2 = async (path3) => lstat12(path3).catch((e) => {
+import { lstat as lstat13, readdir as readdir6 } from "node:fs/promises";
+import { join as join19 } from "node:path";
+var info2 = async (path3) => lstat13(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -29301,11 +29909,11 @@ var posix = (path3) => path3.split("\\").join("/");
 async function listAssets(root) {
   const out = [];
   async function visit2(relative, depth) {
-    const stat3 = await info2(join17(root, relative));
+    const stat3 = await info2(join19(root, relative));
     if (!stat3 || stat3.isSymbolicLink()) return;
     if (stat3.isDirectory()) {
       if (depth > 8 || out.length > 4e3) return;
-      for (const name2 of (await readdir6(join17(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
+      for (const name2 of (await readdir6(join19(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
     } else if (stat3.isFile()) out.push({ path: posix(relative), bytes: stat3.size });
   }
   await visit2(ASSETS_DIR, 0);
@@ -29314,7 +29922,7 @@ async function listAssets(root) {
 async function readDocumentWarnings(root, documents) {
   const outside = [...new Set(documentBodyLinks(documents).map((l) => l.target).filter((t3) => !t3.startsWith(".gitifact/") || t3.startsWith(INSTRUCTIONS_ROOT + "/")))];
   const existing = /* @__PURE__ */ new Set();
-  for (const target of outside) if ((await info2(join17(root, ...target.split("/"))))?.isFile()) existing.add(target);
+  for (const target of outside) if ((await info2(join19(root, ...target.split("/"))))?.isFile()) existing.add(target);
   return documentWarnings(documents, await listAssets(root), existing);
 }
 
@@ -29337,33 +29945,33 @@ var runCheck = (options) => runCommand("check", options.format, async () => {
 });
 
 // src/commands/changes.ts
-import { randomUUID as randomUUID5 } from "node:crypto";
-import { mkdir as mkdir6, open as open5, readFile as readFile16, rename as rename3, rmdir, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { randomUUID as randomUUID6 } from "node:crypto";
+import { mkdir as mkdir7, open as open5, readFile as readFile17, rename as rename4, rmdir, unlink as unlink5, writeFile as writeFile5 } from "node:fs/promises";
+import { join as join22 } from "node:path";
 
 // src/adapters/filesystem/agent-inputs.ts
 import { createHash as createHash4, randomBytes as randomBytes2 } from "node:crypto";
-import { lstat as lstat13, mkdir as mkdir5, readdir as readdir7, realpath as realpath3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { lstat as lstat14, mkdir as mkdir6, readdir as readdir7, realpath as realpath3, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, dirname as dirname2, join as join18 } from "node:path";
+import { basename, dirname as dirname2, join as join20 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
-var info3 = (path3) => lstat13(path3).catch((e) => {
+var info3 = (path3) => lstat14(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
 var comparable = (path3) => process.platform === "win32" ? path3.toLowerCase() : path3;
 async function candidates(root, controls) {
   const key = createHash4("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
-  return { system: join18((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join18(root, ".gitifact", "tmp") };
+  return { system: join20((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join20(root, ".gitifact", "tmp") };
 }
 async function writable(directory) {
   try {
-    await mkdir5(directory, { recursive: true });
+    await mkdir6(directory, { recursive: true });
     const stat3 = await info3(directory);
     if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
-    const probe = join18(directory, ".probe-" + randomBytes2(8).toString("hex"));
-    await writeFile3(probe, "", { flag: "wx" });
-    await unlink3(probe);
+    const probe = join20(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    await writeFile4(probe, "", { flag: "wx" });
+    await unlink4(probe);
     return true;
   } catch {
     return false;
@@ -29375,7 +29983,7 @@ async function prepareAgentInputs(root, controls = {}) {
   if (await writable(system)) directory = system;
   else if (await writable(project)) {
     directory = project;
-    await writeFile3(join18(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+    await writeFile4(join20(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
@@ -29383,10 +29991,10 @@ async function prepareAgentInputs(root, controls = {}) {
   const now = (controls.now ?? Date.now)();
   for (const name2 of await readdir7(directory).catch(() => [])) {
     if (name2 === ".gitignore") continue;
-    const stat3 = await info3(join18(directory, name2)).catch(() => void 0);
-    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join18(directory, name2)).catch(() => void 0);
+    const stat3 = await info3(join20(directory, name2)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join20(directory, name2)).catch(() => void 0);
   }
-  return { commit: join18(directory, "commit.json") };
+  return { commit: join20(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
@@ -29399,7 +30007,7 @@ async function discardAgentInput(root, file2, controls = {}) {
       if (await info3(directory) && comparable(await realpath3(directory)) === parent) managed = true;
     }
     if (!managed || basename(file2) === ".gitignore") return false;
-    await unlink3(file2);
+    await unlink4(file2);
     return true;
   } catch {
     return false;
@@ -29408,17 +30016,17 @@ async function discardAgentInput(root, file2, controls = {}) {
 
 // src/commands/commit-files.ts
 import { createHash as createHash5 } from "node:crypto";
-import { lstat as lstat14, readFile as readFile14 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { lstat as lstat15, readFile as readFile15 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 var fail3 = (message) => {
   throw new CommandError("INVALID_COMMIT", message);
 };
 var hash2 = (value) => createHash5("sha256").update(value).digest("hex");
-var optional2 = (path3) => readFile14(path3).catch((e) => {
+var optional2 = (path3) => readFile15(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info4 = (path3) => lstat14(path3).catch((e) => {
+var info4 = (path3) => lstat15(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -29444,14 +30052,14 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join19(root, ...parts.slice(0, i));
+    const target = join21(root, ...parts.slice(0, i));
     const stat3 = await info4(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail3(t2("commitFiles.linkOrDirectory"));
-    if (i < parts.length && await info4(join19(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info4(join21(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail3(t2("commitFiles.hardLinkOrSize"));
-      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile14(target)]));
+      return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile15(target)]));
     }
   }
   return null;
@@ -29478,14 +30086,15 @@ function policyPaths(files) {
   }
   return [...all].sort();
 }
+var storeFiles = /* @__PURE__ */ new Set([".gitifact/config.json", LINE_ENDINGS_PATH]);
 function checkStoreSelection(selected2) {
-  for (const p of selected2.filter((p2) => p2.startsWith(".gitifact/") && !record3(p2) && p2 !== ".gitifact/config.json")) {
+  for (const p of selected2.filter((p2) => p2.startsWith(".gitifact/") && !record3(p2) && !storeFiles.has(p2))) {
     if (!isAssetPath(p) && !instructionFile2(p)) fail3(t2("commitFiles.notRecord", { path: p }));
   }
 }
 
 // src/commands/input.ts
-import { readFile as readFile15, stat as stat2 } from "node:fs/promises";
+import { readFile as readFile16, stat as stat2 } from "node:fs/promises";
 var LIMIT2 = 1024 * 1024;
 async function readJsonInput(file2, stdin = process.stdin) {
   const bytes = file2 === "-" ? await readStdin(stdin) : await readInputFile(file2);
@@ -29498,7 +30107,7 @@ async function readJsonInput(file2, stdin = process.stdin) {
 async function readInputFile(path3) {
   const source2 = await stat2(path3).catch(() => void 0);
   if (!source2?.isFile() || source2.size > LIMIT2) throw new CommandError("INVALID_INPUT", t2("input.file"));
-  return readFile15(path3);
+  return readFile16(path3);
 }
 async function readStdin(stream) {
   const chunks = [];
@@ -29598,7 +30207,7 @@ async function commitChanges(cwd, input2, dryRun) {
     ...stdin ? { input: stdin } : {}
   });
   const staged = async (index) => (await git(["diff", "--cached", "--ita-visible-in-index", "--name-only", "--no-renames", "-z"], index)).toString("utf8").split("\0").filter(Boolean).sort();
-  const busy = join20(gitDir, "gitifact-changes-commit.lock");
+  const busy = join22(gitDir, "gitifact-changes-commit.lock");
   if (await info4(busy)) fail3(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail3(t2("commit.existingStaging"));
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
@@ -29637,7 +30246,7 @@ async function commitChanges(cwd, input2, dryRun) {
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     return { outcome: "dry-run", committed: false, ...summary, commit: void 0 };
   }
-  const temporary = join20(gitDir, "gitifact-commit-index-" + randomUUID5());
+  const temporary = join22(gitDir, "gitifact-commit-index-" + randomUUID6());
   let owned = false;
   let uncertain = false;
   let commitStarted = false;
@@ -29645,7 +30254,7 @@ async function commitChanges(cwd, input2, dryRun) {
   let committed2;
   try {
     try {
-      await mkdir6(busy);
+      await mkdir7(busy);
       owned = true;
     } catch (e) {
       if (e.code === "EEXIST") fail3(t2("commit.busy", { path: busy }));
@@ -29656,31 +30265,31 @@ async function commitChanges(cwd, input2, dryRun) {
     if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail3(t2("commit.indexChanged"));
     const before = await hashes([...started.keys()]);
     for (const [path3, value] of started) if (before.get(path3) !== value) fail3(t2("commit.fileChangedRunning", { path: path3 }));
-    await writeFile4(join20(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
+    await writeFile5(join22(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
     const locked = await hashes([.../* @__PURE__ */ new Set([...selected2, ...contextPaths])]);
-    if (original) await writeFile4(temporary, original, { flag: "wx" });
+    if (original) await writeFile5(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
     await git(["add", "--pathspec-from-file=-", "--pathspec-file-nul"], temporary, Buffer.from(stageable.join("\0")));
     const actual = await staged(temporary);
     if (!actual.length || actual.some((p) => !selected2.includes(p))) fail3(t2("commit.unexpectedFiles"));
-    const storeFiles = selected2.filter((p) => record3(p) && locked.get(p) !== null);
-    if (storeFiles.length) {
-      const output2 = await git(["cat-file", "--batch"], temporary, Buffer.from(storeFiles.map((p) => ":" + p).join("\n") + "\n"));
+    const storeFiles2 = selected2.filter((p) => record3(p) && locked.get(p) !== null);
+    if (storeFiles2.length) {
+      const output2 = await git(["cat-file", "--batch"], temporary, Buffer.from(storeFiles2.map((p) => ":" + p).join("\n") + "\n"));
       let offset = 0;
-      for (const path3 of storeFiles) {
+      for (const path3 of storeFiles2) {
         const end = output2.indexOf(10, offset);
         const header = output2.subarray(offset, end).toString("utf8").split(" ");
         const size = Number(header[2]);
         if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail3(t2("commit.stagedUnreadable", { path: path3 }));
         const blob = output2.subarray(end + 1, end + 1 + size);
-        const file2 = await readFile16(join20(root, path3));
+        const file2 = await readFile17(join22(root, path3));
         if (!blob.equals(file2) && !blob.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail3(t2("commit.filterChanged"));
         offset = end + size + 2;
       }
     }
     const again = await hashes([...locked.keys()]);
     for (const [path3, value] of locked) if (again.get(path3) !== value) fail3(t2("commit.fileChangedPreparing", { path: path3 }));
-    for (const name2 of integration) if (await info4(join20(gitDir, name2))) fail3(t2("commit.integrationStarted"));
+    for (const name2 of integration) if (await info4(join22(gitDir, name2))) fail3(t2("commit.integrationStarted"));
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
     commitStarted = true;
@@ -29695,10 +30304,10 @@ async function commitChanges(cwd, input2, dryRun) {
     if (headers[0] !== "tree " + tree || after.branch !== base.branch || !same2(parents, base.head ? [base.head] : []) || trailers.some((line2) => !body2.split(/\r?\n/).includes(line2))) fail3(t2("commit.resultAltered"));
     if (hash2(await optional2(indexPath) ?? Buffer.alloc(0)) !== indexHash) fail3(t2("commit.indexChangedAfter"));
     if ((await git(["write-tree"], temporary)).toString("utf8").trim() !== tree) fail3(t2("commit.hookChangedStaging"));
-    await lock.writeFile(await readFile16(temporary));
+    await lock.writeFile(await readFile17(temporary));
     await lock.sync();
     await lock.close();
-    await rename3(indexPath + ".lock", indexPath);
+    await rename4(indexPath + ".lock", indexPath);
     indexLock = void 0;
     committed2 = { commit: after.head, paths: actual };
   } catch (error62) {
@@ -29715,12 +30324,12 @@ async function commitChanges(cwd, input2, dryRun) {
     await indexLock?.close().catch(() => {
     });
     if (!uncertain) {
-      if (indexLock) await unlink4(indexPath + ".lock").catch(() => {
+      if (indexLock) await unlink5(indexPath + ".lock").catch(() => {
       });
-      await unlink4(temporary).catch(() => {
+      await unlink5(temporary).catch(() => {
       });
       if (owned) {
-        await unlink4(join20(busy, "recovery.json")).catch(() => {
+        await unlink5(join22(busy, "recovery.json")).catch(() => {
         });
         await rmdir(busy);
       }
@@ -29730,8 +30339,8 @@ async function commitChanges(cwd, input2, dryRun) {
 }
 
 // src/commands/records.ts
-import { readFile as readFile17 } from "node:fs/promises";
-import { join as join21 } from "node:path";
+import { readFile as readFile18 } from "node:fs/promises";
+import { join as join23 } from "node:path";
 var runRecordsNew = (options) => runCommand("records", options.format, async () => {
   if (/[\r\n]/.test(options.title)) throw new CommandError("INVALID_VALUE", t2("docs.singleLine", { field: "title" }));
   const docs = [...new Set(options.docs.flatMap((d) => d.split(",")).map((d) => d.trim()).filter(Boolean))];
@@ -29767,7 +30376,7 @@ var runRecordsShow = (ids, options) => runCommand("records", options.format, asy
   const shown = await Promise.all([...new Set(ids)].map(async (id) => {
     const path3 = await findRecord(project.root, id);
     if (!path3) return { id, missing: true };
-    const source2 = await readFile17(join21(project.root, ...path3.split("/")), "utf8");
+    const source2 = await readFile18(join23(project.root, ...path3.split("/")), "utf8");
     const log = project.reader.decode(await project.reader.run(["log", "-1", "--diff-filter=A", "--format=%H%x00%aN%x00%aI", "--", path3])).trim();
     const [commit, author, date5] = log.split("\0");
     return { id, path: path3, text: source2, commit: commit ? { commit, author, date: date5 } : null };
@@ -29875,9 +30484,7 @@ async function readThrough(project, head, filter, id) {
 }
 
 // src/commands/feedback.ts
-import { readFile as readFile18 } from "node:fs/promises";
 import { release as release3 } from "node:os";
-import { dirname as dirname3, join as join22 } from "node:path";
 
 // src/adapters/github/issue.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -29931,6 +30538,17 @@ function newIssueUrl(title, body2, marker2) {
   return { url: address(characters.slice(0, low).join("") + marker2), truncated: true };
 }
 
+// src/shared/project-config.ts
+import { readFile as readFile19 } from "node:fs/promises";
+import { dirname as dirname3, join as join24 } from "node:path";
+async function findProjectConfig(from) {
+  for (let folder = from; ; folder = dirname3(folder)) {
+    const text4 = await readFile19(join24(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
+    if (text4 !== void 0) return { root: folder, text: text4 };
+    if (dirname3(folder) === folder) return void 0;
+  }
+}
+
 // src/commands/feedback.ts
 var types = ["bug", "idea"];
 function parseFeedback(input2) {
@@ -29943,17 +30561,13 @@ function parseFeedback(input2) {
   return { type, title: title.trim(), body: body2.trim() };
 }
 async function schemaVersion(from) {
-  for (let folder = from; ; folder = dirname3(folder)) {
-    const config2 = await readFile18(join22(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
-    if (config2 !== void 0) {
-      try {
-        const value = JSON.parse(config2).schemaVersion;
-        return typeof value === "number" ? String(value) : "none";
-      } catch {
-        return "none";
-      }
-    }
-    if (dirname3(folder) === folder) return "none";
+  const config2 = (await findProjectConfig(from))?.text;
+  if (config2 === void 0) return "none";
+  try {
+    const value = JSON.parse(config2).schemaVersion;
+    return typeof value === "number" ? String(value) : "none";
+  } catch {
+    return "none";
   }
 }
 async function issueBody(feedback, version2, cwd) {
@@ -29990,6 +30604,11 @@ var runFeedback = (options, version2, run) => runCommand("feedback", options.for
   return { json: { ...sent, title: feedback.title, body: body2 }, text: text2(out) };
 });
 
+// src/commands/update.ts
+import { readFile as readFile20 } from "node:fs/promises";
+import { join as join25 } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+
 // src/adapters/git/agent-docs-commit.ts
 function agentDocsGit(root, inherited = process.env) {
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_LAZY_FETCH: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "1", LC_ALL: "C" };
@@ -30021,9 +30640,11 @@ function agentDocsGit(root, inherited = process.env) {
 }
 
 // src/commands/update.ts
-var blockCommitMessage = (version2) => "chore(gitifact): refresh GITIFACT block to v" + version2;
+var CONFIG_PATH = ".gitifact/config.json";
+var updateCommitMessage = (version2) => "chore(gitifact): update project to gitifact v" + version2;
 var commitState = (state2, extra = {}) => ({ state: state2, commit: null, paths: [], message: null, reason: null, detail: null, ...extra });
-async function refreshBlocks(cwd, version2, env, controls) {
+var notInitialized = { docs: { state: "not-initialized", paths: [], missing: [] }, project: { state: "not-initialized", cli: null } };
+async function refreshProject(cwd, version2, env, controls) {
   const repo = initRepository(cwd, env);
   let first;
   let config2;
@@ -30031,20 +30652,28 @@ async function refreshBlocks(cwd, version2, env, controls) {
     first = await repo.inspect();
     config2 = await readConfigFile(first.state.repository.rootPath);
   } catch (error62) {
-    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY") return { state: "not-initialized", paths: [], missing: [] };
+    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY") return notInitialized;
     throw error62;
   }
-  if (config2 === void 0) return { state: "not-initialized", paths: [], missing: [] };
+  if (config2 === void 0) return notInitialized;
   const root = first.state.repository.rootPath;
-  const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, ...controls });
+  const parsed2 = needsMigration(config2) ? void 0 : parseManagedConfig(config2);
+  const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, language: parsed2?.language, ...controls });
   const { missing: missing2 } = plan;
-  if (plan.paths.length === 0) return { state: "no-block", paths: [], missing: missing2, root };
-  if (plan.writes.length === 0) return { state: "current", paths: plan.paths, missing: missing2, root, candidates: plan.paths };
+  if (parsed2?.cli && isNewerRelease(parsed2.cli, version2)) return { docs: { state: "kept", paths: plan.paths, missing: missing2, root }, project: { state: "current", cli: parsed2.cli } };
+  let current2 = config2;
   const unchanged = async () => {
-    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== config2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
+    if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== current2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
   };
-  const applied = await applyAgentDocs(root, plan, unchanged);
-  return { state: "refreshed", paths: applied, missing: missing2, root, candidates: plan.paths };
+  const docs = plan.paths.length === 0 ? { state: "no-block", paths: [], missing: missing2, root } : plan.writes.length === 0 ? { state: "current", paths: plan.paths, missing: missing2, root, candidates: plan.paths } : { state: "refreshed", paths: await applyAgentDocs(root, plan, unchanged), missing: missing2, root, candidates: plan.paths };
+  if (!parsed2) return { docs, project: { state: "current", cli: null } };
+  const settled2 = settleConfig(parsed2, version2, plan.language);
+  if (settled2.changed) {
+    const next = formatManagedConfig(settled2.config, config2);
+    await publishConfig(root, next, unchanged, void 0, true);
+    current2 = next;
+  }
+  return { docs: { ...docs, root }, project: { state: settled2.changed ? "written" : "current", cli: settled2.config.cli ?? null } };
 }
 function outsideBlock(text4) {
   const normalized2 = text4.replace(/\r\n/g, "\n");
@@ -30055,12 +30684,20 @@ function outsideBlock(text4) {
     return null;
   }
 }
-async function commitBlocks(docs, version2, env) {
-  if (!docs.root || !docs.candidates?.length) return commitState("nothing");
+function withoutSettings(text4) {
+  try {
+    const { cli: _c, language: _l, ...rest } = JSON.parse(text4);
+    return rest;
+  } catch {
+    return null;
+  }
+}
+async function commitUpdate(docs, version2, env) {
+  if (!docs.root) return commitState("nothing");
   const git = agentDocsGit(docs.root, env);
   const head = await git.head();
   const changed = [];
-  for (const path3 of docs.candidates) {
+  for (const path3 of docs.candidates ?? []) {
     const working2 = await managedRead(docs.root, path3);
     const committed2 = head ? await git.committed(head, path3) : null;
     if (working2 === null) continue;
@@ -30070,8 +30707,16 @@ async function commitBlocks(docs, version2, env) {
     if (before === null || before !== outsideBlock(working2)) return commitState("skipped", { paths: [path3], reason: "other-changes" });
     changed.push(path3);
   }
+  const workingConfig = await readFile20(join25(docs.root, CONFIG_PATH), "utf8").catch(() => null);
+  const committedConfig = head ? await git.committed(head, CONFIG_PATH) : null;
+  if (workingConfig !== null && committedConfig?.replace(/\r\n/g, "\n") !== workingConfig.replace(/\r\n/g, "\n")) {
+    if (committedConfig === null) return commitState("skipped", { paths: [CONFIG_PATH], reason: "untracked" });
+    const before = withoutSettings(committedConfig);
+    if (before === null || !isDeepStrictEqual(before, withoutSettings(workingConfig))) return commitState("skipped", { paths: [CONFIG_PATH], reason: "other-changes" });
+    changed.push(CONFIG_PATH);
+  }
   if (changed.length === 0) return commitState("nothing");
-  const message = blockCommitMessage(version2);
+  const message = updateCommitMessage(version2);
   let failure2;
   try {
     await git.commitOnly(changed, message);
@@ -30085,20 +30730,23 @@ async function commitBlocks(docs, version2, env) {
   return commitState("committed", { commit: after, paths: await git.changedPaths(after), message });
 }
 async function updateCommand(cwd, version2, env = process.env, controls = {}) {
-  const [update, agentDocs] = await Promise.all([
+  const [update, refreshed] = await Promise.all([
     updateCheckDisabled(env) ? disabledUpdate : resolveUpdate(version2, controls.fetchLatest ?? fetchLatestVersion, void 0, controls.timeoutMs),
-    refreshBlocks(cwd, version2, env, controls)
+    refreshProject(cwd, version2, env, controls)
   ]);
-  const commit = controls.commit ? await commitBlocks(agentDocs, version2, env) : commitState("not-requested");
-  const config2 = await readConfigFile(agentDocs.root ?? cwd).catch(() => void 0);
-  return updateV5.parse({
+  await recordUpdateCheck(env, update, controls.now?.());
+  const { docs, project } = refreshed;
+  const commit = controls.commit ? await commitUpdate(docs, version2, env) : commitState("not-requested");
+  const config2 = await readConfigFile(docs.root ?? cwd).catch(() => void 0);
+  return updateV6.parse({
     contract: "update",
-    version: 5,
+    version: 6,
     ok: true,
     cliVersion: version2,
     update,
-    install: update.status === "available" ? { npx: npxUpdate(update.latestVersion), npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
-    agentDocs: { state: agentDocs.state, paths: agentDocs.paths, missing: agentDocs.missing },
+    install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
+    agentDocs: { state: docs.state, paths: docs.paths, missing: docs.missing },
+    project,
     commit,
     migrationRequired: config2 !== void 0 && needsMigration(config2)
   });
@@ -30113,9 +30761,11 @@ async function runUpdate(options, version2) {
     }
     const lines = [t2("update.text.current", { version: dto.cliVersion })];
     lines.push(dto.update.status === "available" ? t2("update.text.available", { version: dto.update.latestVersion }) : dto.update.status === "up-to-date" ? t2("update.text.upToDate") : dto.update.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable"));
-    if (dto.install) lines.push(t2("update.text.install", { command: dto.install.npx }), t2("update.text.afterInstall"));
-    lines.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock", { version: dto.cliVersion }) : t2("update.text.notInitialized"));
-    if (dto.agentDocs.missing.length) lines.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", "), version: dto.cliVersion }));
+    if (dto.install) lines.push(t2("update.text.install", { command: dto.install.npmGlobal }), t2("update.text.afterInstall"));
+    lines.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "kept" ? t2("update.text.blockKept", { paths: dto.agentDocs.paths.join(", ") || "-" }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock") : t2("update.text.notInitialized"));
+    if (dto.agentDocs.missing.length) lines.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", ") }));
+    if (dto.project.state === "written") lines.push(t2("update.text.projectWritten", { path: CONFIG_PATH, version: dto.project.cli ?? dto.cliVersion }));
+    if (dto.project.cli && isNewerRelease(dto.project.cli, dto.cliVersion)) lines.push(t2("update.text.projectAhead", { project: dto.project.cli, version: dto.cliVersion, command: npmGlobalInstall(dto.project.cli) }));
     if (dto.migrationRequired) lines.push(t2("update.text.migrationRequired", { version: dto.cliVersion }));
     const { commit } = dto;
     if (commit.state === "committed") lines.push(t2("update.text.committed", { commit: commit.commit.slice(0, 12), paths: commit.paths.join(", ") }));
@@ -30129,7 +30779,7 @@ async function runUpdate(options, version2) {
   } catch (error62) {
     const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
     const failure2 = { code: known ? error62.code : "UPDATE_FAILED", message: known ? error62.message : t2("update.failed") };
-    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV5.parse({ contract: "update", version: 5, ok: false, error: failure2 })) + "\n");
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV6.parse({ contract: "update", version: 6, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
@@ -30137,6 +30787,7 @@ async function runUpdate(options, version2) {
 // src/commands/update-check.ts
 async function checkUpdateCommand(version2, env = process.env, controls = {}) {
   const update = updateCheckDisabled(env) ? disabledUpdate : await resolveUpdate(version2, controls.fetchLatest ?? fetchLatestVersion, void 0, controls.timeoutMs);
+  await recordUpdateCheck(env, update, controls.now?.());
   return updateCheckV1.parse({
     contract: "update-check",
     version: 1,
@@ -30157,10 +30808,73 @@ async function runUpdateCheck(format2, version2) {
     t2("update.text.current", { version: dto.cliVersion }),
     state2.status === "available" ? t2("update.text.available", { version: state2.latestVersion }) : state2.status === "up-to-date" ? t2("update.text.upToDate") : state2.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable")
   ];
-  if (dto.command) lines.push(t2("update.text.install", { command: dto.command }));
+  if (state2.status === "available") lines.push(t2("update.text.install", { command: npmGlobalInstall(state2.latestVersion) }), t2("update.text.afterInstall"));
   process.stdout.write(lines.join("\n") + "\n");
 }
 
+// src/commands/version-notice.ts
+import { spawn as spawn3 } from "node:child_process";
+import { homedir as homedir2 } from "node:os";
+var REFRESH_AFTER_MS = 60 * 60 * 1e3;
+var CHECKING_WINDOW_MS = 5 * 60 * 1e3;
+var LATER_MS = 24 * 60 * 60 * 1e3;
+var REFRESH_COMMAND = "__refresh-update";
+var noticeScope = (command) => ({ release: command !== "init" && command !== "update", projectOlder: command !== "update" });
+function chooseNotice(running2, project, cache, now, scope = { release: true, projectOlder: true }) {
+  if (project && isNewerRelease(project, running2)) return { kind: "project-newer", project };
+  const latest = cache.latest;
+  const postponed = cache.later !== void 0 && cache.later.version === latest && now < Date.parse(cache.later.until);
+  if (scope.release && latest && isNewerRelease(latest, running2) && !postponed) return { kind: "release", latest };
+  if (scope.projectOlder && project && isNewerRelease(running2, project)) return { kind: "project-older", project };
+  return null;
+}
+function noticeText(notice, running2) {
+  if (notice.kind === "project-newer") return t2("notice.projectNewer", { project: notice.project, version: running2, command: npmGlobalInstall(notice.project) });
+  if (notice.kind === "release") return t2("notice.release", { latest: notice.latest, version: running2, command: npmGlobalInstall(notice.latest) });
+  return t2("notice.projectOlder", { project: notice.project, version: running2 });
+}
+var needsRefresh = (cache, now) => !(cache.checkedAt && now - Date.parse(cache.checkedAt) < REFRESH_AFTER_MS) && !(cache.checkingSince && now - Date.parse(cache.checkingSince) < CHECKING_WINDOW_MS);
+var spawnRefresh = () => {
+  const child = spawn3(process.execPath, [...process.execArgv, process.argv[1], REFRESH_COMMAND], { cwd: homedir2(), detached: true, stdio: "ignore", windowsHide: true });
+  child.on("error", () => {
+  });
+  child.unref();
+};
+async function noticeVersion(version2, command, controls = {}) {
+  const env = controls.env ?? process.env;
+  const now = controls.now ?? Date.now();
+  try {
+    const project = projectSettings((await findProjectConfig(controls.cwd ?? process.cwd()))?.text).cli;
+    const scope = noticeScope(command);
+    let cache = {};
+    if (!updateCheckDisabled(env)) {
+      cache = await readUpdateCache(env);
+      if (scope.release && needsRefresh(cache, now)) {
+        await changeUpdateCache(env, (current2) => ({ ...current2, checkingSince: new Date(now).toISOString() }));
+        (controls.refresh ?? spawnRefresh)();
+      }
+    }
+    const notice = chooseNotice(version2, project, cache, now, scope);
+    if (notice) (controls.write ?? ((line2) => process.stderr.write(line2 + "\n")))(noticeText(notice, version2));
+  } catch {
+  }
+}
+async function refreshUpdateCache(version2, env = process.env, fetchLatest = fetchLatestVersion, now) {
+  if (updateCheckDisabled(env)) return;
+  const update = await resolveUpdate(version2, fetchLatest);
+  await recordUpdateCheck(env, update, now?.());
+}
+async function postponeRelease(version2, env = process.env, now = Date.now()) {
+  const cache = await readUpdateCache(env);
+  const later = cache.latest && isNewerRelease(cache.latest, version2) ? { version: cache.latest, until: new Date(now + LATER_MS).toISOString() } : null;
+  if (later) await changeUpdateCache(env, (current2) => ({ ...current2, later }));
+  return updateLaterV1.parse({ contract: "update-later", version: 1, ok: true, cliVersion: version2, later });
+}
+async function runUpdateLater(format2, version2) {
+  const dto = await postponeRelease(version2);
+  process.stdout.write(format2 === "json" ? JSON.stringify(dto) + "\n" : (dto.later ? t2("update.later.postponed", { latest: dto.later.version, until: new Date(dto.later.until).toLocaleString() }) : t2("update.later.nothing", { version: version2 })) + "\n");
+}
+
 // src/main.ts
 var languageArgs = process.argv.slice(2).slice(0, process.argv.slice(2).indexOf("--") < 0 ? void 0 : process.argv.slice(2).indexOf("--"));
 var selectedLanguage;
@@ -30170,11 +30884,17 @@ for (let i = 0; i < languageArgs.length; i++) {
   if (value === "ko" || value === "en") selectedLanguage = value;
 }
 configureLanguage(selectedLanguage ?? environmentLanguage(), selectedLanguage);
-var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.1").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.3").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+program2.hook("preAction", async (_program, action) => {
+  let top = action;
+  while (top.parent && top.parent !== program2) top = top.parent;
+  if (top.name() !== REFRESH_COMMAND) await noticeVersion("0.8.3", top.name());
+});
+program2.command(REFRESH_COMMAND, { hidden: true }).allowExcessArguments(false).action(() => refreshUpdateCache("0.8.3"));
 var format = () => new Option("--format <format>", t2("help.format")).choices(formats).default("text");
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.1"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.1"));
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).action((options) => options.check ? runUpdateCheck(options.format, "0.8.1") : runUpdate(options, "0.8.1"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.3"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.3"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).addOption(new Option("--later", t2("help.updateLater")).conflicts(["check", "commit"])).action((options) => options.later ? runUpdateLater(options.format, "0.8.3") : options.check ? runUpdateCheck(options.format, "0.8.3") : runUpdate(options, "0.8.3"));
 var listed2 = (command, sorts) => {
   command.allowExcessArguments(false).option("--q <words>", t2("help.listQ")).option("--author <name>", t2("help.listAuthor"));
   if (sorts) command.addOption(new Option("--sort <key>", t2("help.listSort")).choices([...sorts]).default(sorts[0]));
@@ -30196,7 +30916,7 @@ program2.command("check").description(t2("help.check")).allowExcessArguments(fal
 var changes = program2.command("changes").description(t2("help.changes"));
 changes.command("list").description(t2("help.changesList")).allowExcessArguments(false).addOption(format()).action((o) => runChangesList(o));
 changes.command("commit").description(t2("help.changesCommit")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.changesCommitFile")).option("--dry-run", t2("help.changesCommitDryRun")).addOption(format()).action((o) => runChangesCommit(o));
-program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.1"));
+program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.3"));
 var guide = program2.command("guide").description(t2("help.guide"));
 guide.command("list").description(t2("help.guideList")).allowExcessArguments(false).addOption(format()).action((o) => runGuideList(o));
 guide.command("show").description(t2("help.guideShow")).argument("<topic>", t2("help.guideTopic")).allowExcessArguments(false).addOption(format()).action((topic, o) => runGuideShow(topic, o));