gitifact 0.8.0 → 0.8.2

package/dist/main.js

@@ -2427,11 +2427,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @private
    */
   _parseCommand(operands, unknown2) {
-    const parsed = this.parseOptions(unknown2);
+    const parsed2 = this.parseOptions(unknown2);
     this._parseOptionsEnv();
     this._parseOptionsImplied();
-    operands = operands.concat(parsed.operands);
-    unknown2 = parsed.unknown;
+    operands = operands.concat(parsed2.operands);
+    unknown2 = parsed2.unknown;
     this.args = operands.concat(unknown2);
     if (operands && this._findCommand(operands[0])) {
       return this._dispatchSubcommand(operands[0], operands.slice(1), unknown2);
@@ -2450,12 +2450,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
     if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
       this.help({ error: true });
     }
-    this._outputHelpIfRequested(parsed.unknown);
+    this._outputHelpIfRequested(parsed2.unknown);
     this._checkForMissingMandatoryOptions();
     this._checkForConflictingOptions();
     const checkForUnknownOptions = () => {
-      if (parsed.unknown.length > 0) {
-        this.unknownOption(parsed.unknown[0]);
+      if (parsed2.unknown.length > 0) {
+        this.unknownOption(parsed2.unknown[0]);
       }
     };
     const commandEvent = `command:${this.name()}`;
@@ -3381,7 +3381,7 @@ var program = new Command();
 import { createServer } from "node:http";
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { fileURLToPath } from "node:url";
-import { readFile as readFile7 } from "node:fs/promises";
+import { readFile as readFile8 } from "node:fs/promises";
 
 // ../../packages/core/dist/domain/repository-status.js
 function summarizeChanges(changes2) {
@@ -3659,16 +3659,16 @@ var RepositoryReadError = class extends Error {
 // ../../packages/core/dist/use-cases/read-repository-status.js
 async function readRepositoryStatus(reader, services) {
   const startedAt = services.now();
-  const state = await reader.read();
+  const state2 = await reader.read();
   return {
-    ...state,
+    ...state2,
     observation: {
       id: services.newId(),
       startedAt,
       completedAt: services.now(),
       consistency: "best-effort"
     },
-    summary: summarizeChanges(state.changes)
+    summary: summarizeChanges(state2.changes)
   };
 }
 
@@ -3775,9 +3775,9 @@ function extractLinks(body2) {
         fence = void 0;
       continue;
     }
-    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
-    if (open5) {
-      fence = { char: open5[1][0], size: open5[1].length };
+    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
+    if (open6) {
+      fence = { char: open6[1][0], size: open6[1].length };
       continue;
     }
     for (const m of line2.replace(/`[^`]*`/g, "").matchAll(/!?\[[^\]]*\]\((?:<([^>]+)>|([^)\s]+))(?:\s+"[^"]*")?\)/g))
@@ -3925,9 +3925,9 @@ function parseDesign(source2, specId) {
         fence = void 0;
       return line2;
     }
-    const open5 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
-    if (open5) {
-      fence = { char: open5[1][0], size: open5[1].length };
+    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
+    if (open6) {
+      fence = { char: open6[1][0], size: open6[1].length };
       return line2;
     }
     if (/^#\s/.test(line2))
@@ -3970,9 +3970,9 @@ function parseDocument(path3, source2) {
         fence = void 0;
       continue;
     }
-    const open5 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
-    if (open5) {
-      fence = { char: open5[1][0], size: open5[1].length };
+    const open6 = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line2);
+    if (open6) {
+      fence = { char: open6[1][0], size: open6[1].length };
       continue;
     }
     if (/^#\s/.test(line2))
@@ -4404,14 +4404,14 @@ function sections(raw, path3) {
       found.at(-1)?.lines.push(line2);
       continue;
     }
-    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
-    if (open5)
-      fence = { char: open5[1][0], size: open5[1].length };
+    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
+    if (open6)
+      fence = { char: open6[1][0], size: open6[1].length };
     else if (/^#\s/.test(line2))
       throw new DocumentError("BODY_HEADING", path3, t("doc.BODY_HEADING", { path: path3 }));
     else if (/<!-- gitifact-/.test(line2))
       throw new DocumentError("BODY_MARKER", path3, t("doc.BODY_MARKER", { path: path3 }));
-    const heading = !open5 && /^##\s+(.+?)\s*#*\s*$/.exec(line2);
+    const heading = !open6 && /^##\s+(.+?)\s*#*\s*$/.exec(line2);
     if (heading) {
       const key = sectionKeyOf(heading[1]);
       if (!key || found.some((s) => s.key === key))
@@ -4595,9 +4595,9 @@ function body(raw, path3) {
         fence = void 0;
       continue;
     }
-    const open5 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
-    if (open5) {
-      fence = { char: open5[1][0], size: open5[1].length };
+    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line2);
+    if (open6) {
+      fence = { char: open6[1][0], size: open6[1].length };
       continue;
     }
     if (/^#\s/.test(line2))
@@ -4657,6 +4657,19 @@ function parseDocumentFile(path3, source2) {
   }
   return { kind: "design", feature: where.feature, order: order(), requirements: refs?.type === "list" ? refs.items : [], sources: sources(fields2, path3), ...common };
 }
+var isInstructionReference = (path3) => path3.endsWith(".md");
+function parseInstructionFile(path3, source2) {
+  if (source2.includes("\0") || /\r(?!\n)/.test(source2) || source2.charCodeAt(0) === 65279)
+    throw new DocumentError("INVALID_CHARACTERS", path3, t("doc.INVALID_CHARACTERS", { path: path3 }));
+  const { fields: fields2 } = parseFrontmatterBlock(source2.replace(/\r\n/g, "\n"), path3);
+  for (const key of fields2.keys())
+    if (key !== "title" && key !== "description")
+      throw new DocumentError("FRONTMATTER_UNKNOWN_KEY", path3, t("doc.FRONTMATTER_UNKNOWN_KEY", { path: path3, key }));
+  for (const key of ["title", "description"])
+    if (!fields2.has(key))
+      throw new DocumentError("FRONTMATTER_MISSING_KEY", path3, t("doc.FRONTMATTER_MISSING_KEY", { path: path3, key }));
+  return { title: text(fields2, "title", path3, 200), description: text(fields2, "description", path3, 300) };
+}
 function renderDocumentFile(doc) {
   const front = renderFrontmatterBlock([
     ["id", doc.id],
@@ -4725,8 +4738,10 @@ function checkDocuments(files) {
       }
       if (where.type === "instruction-file") {
         instructionFolders.set(where.name, instructionFolders.get(where.name) === true);
-        if (path3.endsWith(".md"))
+        if (isInstructionReference(path3)) {
           specLinks(path3, source2);
+          parseInstructionFile(path3, source2);
+        }
         continue;
       }
       if (where.kind === "instruction")
@@ -10387,26 +10402,26 @@ function settle(inst, answer) {
 function isRecursiveSchema(inst) {
   return isRecursive(inst, /* @__PURE__ */ new Set(), true) !== NONE;
 }
-function bucketFor(state, inst) {
-  let bucket = state.buckets.get(inst);
+function bucketFor(state2, inst) {
+  let bucket = state2.buckets.get(inst);
   if (!bucket) {
     bucket = /* @__PURE__ */ new WeakMap();
-    state.buckets.set(inst, bucket);
+    state2.buckets.set(inst, bucket);
   }
   return bucket;
 }
 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;
@@ -10449,16 +10464,16 @@ var memo = {
         const input2 = payload.value;
         if (!isRef(input2))
           return base(payload, ctx);
-        let state = ctx[STATE];
-        if (!state) {
-          state = { buckets: /* @__PURE__ */ new WeakMap(), backEdges: void 0 };
-          ctx[STATE] = state;
+        let state2 = ctx[STATE];
+        if (!state2) {
+          state2 = { buckets: /* @__PURE__ */ new WeakMap(), backEdges: void 0 };
+          ctx[STATE] = state2;
         }
         let bucket;
         if (lastCtx === ctx) {
           bucket = lastBucket;
         } else {
-          bucket = bucketFor(state, inst);
+          bucket = bucketFor(state2, inst);
           lastCtx = ctx;
           lastBucket = bucket;
         }
@@ -10470,8 +10485,8 @@ var memo = {
               payload.issues.push(...cloneIssues(hit.issues));
           } else {
             payload.memo = true;
-            state.backEdges ?? (state.backEdges = /* @__PURE__ */ new WeakSet());
-            state.backEdges.add(hit.value);
+            state2.backEdges ?? (state2.backEdges = /* @__PURE__ */ new WeakSet());
+            state2.backEdges.add(hit.value);
           }
           return payload;
         }
@@ -13077,8 +13092,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`;
@@ -25003,9 +25018,11 @@ var browserHttpErrorV1 = external_exports.strictObject({
 });
 
 // ../../packages/contracts/dist/versions/browser-specs-v6.js
+var state = external_exports.enum(["committed", "added", "modified", "deleted"]);
+var standing = { state, previousPath: external_exports.string().optional() };
 var contributor = external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string() });
 var source = external_exports.strictObject({ id: external_exports.string().optional(), title: external_exports.string().optional(), path: external_exports.string().optional(), url: external_exports.string().optional(), note: external_exports.string().optional() });
-var requirement = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string(), order: external_exports.number().int().nonnegative(), body: external_exports.string() });
+var requirement = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string(), order: external_exports.number().int().nonnegative(), body: external_exports.string(), ...standing });
 var design = external_exports.strictObject({
   id: external_exports.string(),
   path: external_exports.string(),
@@ -25014,7 +25031,8 @@ var design = external_exports.strictObject({
   order: external_exports.number().int().nonnegative(),
   body: external_exports.string(),
   requirements: external_exports.array(external_exports.string()),
-  sources: external_exports.array(source)
+  sources: external_exports.array(source),
+  ...standing
 });
 var feature = external_exports.strictObject({
   id: external_exports.string(),
@@ -25022,13 +25040,14 @@ var feature = external_exports.strictObject({
   title: external_exports.string(),
   description: external_exports.string(),
   body: external_exports.string(),
+  ...standing,
   requirements: external_exports.array(requirement),
   designs: external_exports.array(design),
   // Authors of commits touching the feature folder and the latest such commit; empty until first committed.
   contributors: external_exports.array(contributor),
   updatedAt: external_exports.string().nullable()
 });
-var instructionFile = external_exports.strictObject({ path: external_exports.string(), size: external_exports.number().int().nonnegative() });
+var instructionFile = external_exports.strictObject({ path: external_exports.string(), size: external_exports.number().int().nonnegative(), title: external_exports.string().optional(), description: external_exports.string().optional() });
 var instruction = external_exports.strictObject({
   id: external_exports.string(),
   name: external_exports.string(),
@@ -25036,6 +25055,7 @@ var instruction = external_exports.strictObject({
   title: external_exports.string(),
   description: external_exports.string(),
   body: external_exports.string(),
+  ...standing,
   // Paths relative to the instruction folder, index.md left out; `limited` when the folder holds more than the list carries.
   files: external_exports.array(instructionFile),
   filesLimited: external_exports.boolean(),
@@ -25044,19 +25064,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 browserSpecsV6 = external_exports.strictObject({
-  contract: external_exports.literal("browser-specs"),
-  version: external_exports.literal(6),
+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(),
-  features: external_exports.array(feature),
-  instructions: external_exports.array(instruction),
-  agents: agents.nullable(),
+  stamp: external_exports.string(),
   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();
@@ -25090,21 +25164,24 @@ var event = external_exports.strictObject({
   after: reference,
   records: external_exports.array(record2)
 });
-var browserHistoryV5 = external_exports.strictObject({
+var browserHistoryV6 = external_exports.strictObject({
   contract: external_exports.literal("browser-history"),
-  version: external_exports.literal(5),
+  version: external_exports.literal(6),
   sessionId: external_exports.string(),
   head: oid2,
-  // Matching changes in all of history, not in this page; `offset` is where this page starts among them.
+  // Matching changes and the commits that hold them in all of history, not in this page.
   total: external_exports.number().int().nonnegative(),
-  offset: external_exports.number().int().nonnegative(),
+  commits: external_exports.number().int().nonnegative(),
+  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.
@@ -25112,29 +25189,30 @@ 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));
-var browserHistoryQueryV3 = external_exports.strictObject({
+var browserHistoryQueryV4 = external_exports.strictObject({
   head: headQuery,
-  offset: count(1e6).optional(),
-  limit: count(100).pipe(external_exports.number().min(1)).optional(),
+  after: oid2.optional(),
+  limit: count(50).pipe(external_exports.number().min(1)).optional(),
   kind: changeType.optional(),
   document: kind.optional(),
   feature: external_exports.string().regex(/^S-[a-z2-7]{10}$/).optional(),
@@ -25142,7 +25220,26 @@ var browserHistoryQueryV3 = 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"]);
@@ -25154,12 +25251,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({
@@ -25174,11 +25272,11 @@ 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 browserCommitV3 = external_exports.strictObject({
+var browserCommitV4 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit"),
-  version: external_exports.literal(3),
+  version: external_exports.literal(4),
   sessionId: external_exports.string(),
   commit: oid2,
   author: external_exports.string(),
@@ -25186,17 +25284,31 @@ var browserCommitV3 = external_exports.strictObject({
   committer: external_exports.string(),
   date: external_exports.string(),
   message: external_exports.string(),
-  changes: external_exports.array(external_exports.strictObject({ event, before: snapshot, after: snapshot }))
+  total: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
+  changes: external_exports.array(event)
 });
-var browserCommitQueryV1 = external_exports.strictObject({ commit: oid2 });
 var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
-var browserRecordV1 = external_exports.strictObject({
-  contract: external_exports.literal("browser-record"),
+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),
   sessionId: external_exports.string(),
+  commit: oid2,
+  event,
+  before: snapshot,
+  after: snapshot
+});
+var browserCommitChangeQueryV1 = external_exports.strictObject({ commit: oid2, id: external_exports.string().min(1).max(100) });
+var browserRecordV2 = external_exports.strictObject({
+  contract: external_exports.literal("browser-record"),
+  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({
@@ -25210,6 +25322,27 @@ var browserInstructionFileV1 = external_exports.strictObject({
   binary: external_exports.boolean(),
   tooLarge: external_exports.boolean()
 });
+var workingChange = external_exports.strictObject({ id: external_exports.string(), kind, title: external_exports.string(), path: external_exports.string(), previousPath: external_exports.string().optional(), types: external_exports.array(changeType) });
+var pendingRecord = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), docs: external_exports.array(external_exports.string()), sections: external_exports.array(recordSection), draft: external_exports.boolean() });
+var browserWorkingV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-working"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  head: oid2.nullable(),
+  records: external_exports.array(pendingRecord),
+  changes: external_exports.array(workingChange),
+  withoutRecord: external_exports.array(external_exports.string())
+});
+var browserWorkingChangeV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-working-change"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  change: workingChange,
+  before: snapshot,
+  after: snapshot
+});
+var browserWorkingChangeQueryV1 = external_exports.strictObject({ id: external_exports.string().regex(/^[SRDWI]-[a-z2-7]{10}$/) });
+var browserStampV1 = external_exports.strictObject({ contract: external_exports.literal("browser-stamp"), version: external_exports.literal(1), sessionId: external_exports.string(), stamp: external_exports.string() });
 
 // ../../packages/contracts/dist/versions/changelog-v1.js
 var items = external_exports.array(external_exports.string().min(1));
@@ -25243,11 +25376,11 @@ var updateStateV1 = external_exports.strictObject({
   latestVersion: release.nullable()
 }).refine((value) => (value.status === "available" || value.status === "up-to-date") === (value.latestVersion !== null), "latestVersion is set exactly when the check produced a result.");
 
-// ../../packages/contracts/dist/versions/project-init-v7.js
-var projectInitV7 = external_exports.discriminatedUnion("ok", [
+// ../../packages/contracts/dist/versions/project-init-v8.js
+var projectInitV8 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
     contract: external_exports.literal("project-init"),
-    version: external_exports.literal(7),
+    version: external_exports.literal(8),
     ok: external_exports.literal(true),
     outcome: external_exports.enum(["planned", "created", "already-initialized"]),
     rootPath: external_exports.string(),
@@ -25258,11 +25391,13 @@ var projectInitV7 = external_exports.discriminatedUnion("ok", [
       external_exports.strictObject({ kind: external_exports.literal("commit"), objectFormat: external_exports.enum(["sha1", "sha256"]), commit: external_exports.string() })
     ]),
     agentDocs: external_exports.strictObject({ mode: external_exports.enum(["install", "remove", "skip"]), paths: external_exports.array(external_exports.string()) }),
+    // The file that keeps documents in LF on every OS. `created` is false when it was already there or the run is planned.
+    lineEndings: external_exports.strictObject({ path: external_exports.literal(".gitifact/.gitattributes"), created: external_exports.boolean() }),
     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()
   }),
-  external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(7), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+  external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(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
@@ -25448,6 +25583,10 @@ 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.",
   "server.commitFileNotFound": "\uADF8 \uCEE4\uBC0B\uC774 \uBC14\uAFBC \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4.",
   "server.instructionFileNotFound": "\uC9C0\uCE68 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -25491,6 +25630,7 @@ var messages_default3 = {
   "init.text.blockUpdated": "\uBE14\uB85D \uAC31\uC2E0",
   "init.text.storage": "\uC800\uC7A5 \uADDC\uC57D",
   "init.text.agentDocs": "\uC5D0\uC774\uC804\uD2B8 \uC9C0\uCE68",
+  "init.text.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.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.",
@@ -25511,7 +25651,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.",
@@ -25534,7 +25673,7 @@ var messages_default3 = {
   "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.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.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 docs\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.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.",
   "update.text.commitSkipped.untracked": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. Git\uC774 \uCD94\uC801\uD558\uC9C0 \uC54A\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC785\uB2C8\uB2E4: {paths}",
@@ -25561,6 +25700,9 @@ var messages_default3 = {
   "input.size": "\uC785\uB825 \uD06C\uAE30\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.",
   "input.json": "\uC785\uB825 \uD30C\uC77C\uC740 UTF-8 JSON\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
   "docs.draft": "\uCD08\uC548",
+  "docs.state.added": "\uCEE4\uBC0B \uC804: \uCD94\uAC00",
+  "docs.state.modified": "\uCEE4\uBC0B \uC804: \uBCC0\uACBD",
+  "docs.state.deleted": "\uCEE4\uBC0B \uC804: \uC0AD\uC81C \uC608\uC815",
   "docs.feature": "\uAE30\uB2A5",
   "docs.requirements": "\uC694\uAD6C\uC0AC\uD56D",
   "docs.designs": "\uC124\uACC4",
@@ -25644,7 +25786,7 @@ var messages_default3 = {
   "help.newTitle": "\uBB38\uC11C \uC81C\uBAA9",
   "help.newDescription": "\uD55C \uC904 \uC124\uBA85",
   "help.instructions": "\uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68\uC758 \uBAA9\uB85D\xB7\uC6D0\uBB38\xB7\uC0DD\uC131",
-  "help.instructionsList": "AGENTS.md\uC640 \uC9C0\uCE68 \uBAA9\uB85D (\uC9C0\uCE68\uB9C8\uB2E4 \uB538\uB9B0 \uD30C\uC77C \uC218)",
+  "help.instructionsList": "AGENTS.md\uC640 \uC9C0\uCE68 \uBAA9\uB85D (\uC9C0\uCE68\uB9C8\uB2E4 \uB538\uB9B0 \uD30C\uC77C\uC758 \uC81C\uBAA9\uACFC \uC124\uBA85)",
   "help.instructionsShow": "\uC9C0\uCE68 index.md \uC6D0\uBB38, \uB530\uB974\uB294 \uC124\uACC4, \uD3F4\uB354 \uD30C\uC77C \uBAA9\uB85D",
   "help.instructionsShowTargets": "\uC9C0\uCE68 \uD3F4\uB354 \uC774\uB984\uC774\uB098 I- ID (\uC5EC\uB7EC \uAC1C \uAC00\uB2A5)",
   "help.instructionsShowFile": "\uC9C0\uCE68 \uD3F4\uB354 \uC548\uC758 \uD30C\uC77C \uD558\uB098\uB97C \uC77D\uC74C (\uC608: references/code-style.md)",
@@ -25657,18 +25799,26 @@ var messages_default3 = {
   "help.listQ": "\uC81C\uBAA9\xB7\uC124\uBA85\xB7\uBCF8\uBB38\uC5D0 \uC774 \uB9D0\uC774 \uC788\uB294 \uAC83\uB9CC",
   "help.listAuthor": "\uC774 Git \uC791\uC131\uC790(\uC774\uB984\uC774\uB098 \uC774\uBA54\uC77C)\uAC00 \uBC14\uAFBC \uAC83\uB9CC",
   "help.listSort": "\uC815\uB82C \uAE30\uC900",
-  "help.listLimit": "\uC55E\uC758 n\uAC1C\uB9CC",
+  "help.listLimit": "\uD55C \uD398\uC774\uC9C0\uC5D0 n\uAC1C (\uAE30\uBCF8 20)",
+  "help.listAll": "\uD398\uC774\uC9C0\uB85C \uB098\uB204\uC9C0 \uC54A\uACE0 \uC804\uBD80",
+  "help.listAfter": "\uC774 \uD56D\uBAA9 \uB2E4\uC74C\uBD80\uD130 (\uC55E \uD398\uC774\uC9C0 \uB05D\uC5D0 \uB098\uC628 \uAC12)",
   "help.listFields": "\uC774 \uC5F4\uB9CC \uC27C\uD45C\uB85C (\uD14D\uC2A4\uD2B8\uB294 \uD0ED\uC73C\uB85C \uB098\uB208 \uD55C \uC904)",
   "list.limit": "1 \uC774\uC0C1\uC758 \uC815\uC218\uB97C \uC801\uC73C\uC138\uC694.",
   "list.unknownFields": "\uC5C6\uB294 \uC5F4\uC785\uB2C8\uB2E4: {fields}. \uC4F8 \uC218 \uC788\uB294 \uC5F4: {columns}",
   "list.since": "\uB0A0\uC9DC(YYYY-MM-DD)\uB098 \uCEE4\uBC0B\uC774 \uC544\uB2D9\uB2C8\uB2E4: {value}",
+  "list.after": "\uBAA9\uB85D\uC5D0 \uC5C6\uB294 \uCEE4\uC11C\uC785\uB2C8\uB2E4: {cursor}. --after \uC5C6\uC774 \uCC98\uC74C\uBD80\uD130 \uB2E4\uC2DC \uC77D\uC73C\uC138\uC694.",
+  "list.more": "{unit} {shown}/{total}\uAC1C. \uB2E4\uC74C \uD398\uC774\uC9C0: \uAC19\uC740 \uBA85\uB839\uC5D0 --after {cursor}",
+  "list.items": "\uD56D\uBAA9",
+  "list.features": "\uAE30\uB2A5",
+  "list.commits": "\uCEE4\uBC0B",
+  "list.records": "\uACB0\uC815\uAE30\uB85D",
   "docs.otherResource": "\uC774 \uBA85\uB839\uC774 \uB2E4\uB8E8\uB294 \uBB38\uC11C\uAC00 \uC544\uB2D9\uB2C8\uB2E4: {ids}. {command}\uB85C \uC77D\uC73C\uC138\uC694.",
   "docs.noMatch": "\uC870\uAC74\uC5D0 \uB9DE\uB294 \uAC83\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "docs.requirement": "\uC694\uAD6C\uC0AC\uD56D",
   "docs.design": "\uC124\uACC4",
   "instructions.agents": "AGENTS.md \u2014 \uBE14\uB85D \uBC16 \uC0C9\uC778\uC774 \uC5B4\uB5A4 \uC791\uC5C5\uC5D0 \uC5B4\uB290 \uC9C0\uCE68\uC744 \uC77D\uC744\uC9C0 \uC54C\uB9B0\uB2E4",
   "instructions.noAgents": "AGENTS.md \uC5C6\uC74C \u2014 \uC9C0\uCE68\uC744 \uC5B8\uC81C \uC77D\uC744\uC9C0 \uC54C\uB9AC\uB294 \uC0C9\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4",
-  "instructions.files": "\uD30C\uC77C {count}\uAC1C",
+  "instructions.filesLimited": "(\uD30C\uC77C\uC774 \uB354 \uC788\uC5B4 \uC55E {count}\uAC1C\uB9CC \uBCF4\uC785\uB2C8\uB2E4)",
   "instructions.empty": "\uC9C0\uCE68\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. instructions new\uB85C \uB9CC\uB4DC\uC138\uC694.",
   "instructions.fileWithOne": "--file\uC740 \uC9C0\uCE68 \uD558\uB098\uC640 \uD568\uAED8 \uC4F0\uBA70 --ref\uC640 \uD568\uAED8 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "instructions.unknownFile": "\uC9C0\uCE68 {name} \uD3F4\uB354\uC5D0 \uADF8 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {path}",
@@ -25738,6 +25888,10 @@ 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.",
   "server.commitFileNotFound": "That commit did not change this file.",
   "server.instructionFileNotFound": "The instruction file was not found.",
@@ -25781,6 +25935,7 @@ var messages_default4 = {
   "init.text.blockUpdated": "Block refreshed",
   "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.failed": "Initialization failed. Check file permissions and the generated configuration and temporary files.",
   "config.storeNotDirectory": ".gitifact must be a regular directory, not a link.",
@@ -25801,7 +25956,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.",
@@ -25824,7 +25978,7 @@ var messages_default4 = {
   "update.text.noBlock": "No instruction files contain a GITIFACT block. Run npx --yes gitifact@{version} 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.migrationRequired": "This project's documents still use the 0.7 storage convention (schemaVersion 2). The blocks describe the new commands, but docs and changes refuse to run until the documents are moved. Follow npx --yes gitifact@{version} guide show migrate to move them.",
+  "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.",
   "update.text.commitSkipped.untracked": "Not committed. Instruction files are untracked: {paths}",
@@ -25851,6 +26005,9 @@ var messages_default4 = {
   "input.size": "The input is too large.",
   "input.json": "The input file must be UTF-8 JSON.",
   "docs.draft": "draft",
+  "docs.state.added": "uncommitted: added",
+  "docs.state.modified": "uncommitted: modified",
+  "docs.state.deleted": "uncommitted: to be deleted",
   "docs.feature": "Feature",
   "docs.requirements": "Requirements",
   "docs.designs": "Design",
@@ -25934,7 +26091,7 @@ var messages_default4 = {
   "help.newTitle": "Document title",
   "help.newDescription": "One-line description",
   "help.instructions": "List, read and create project instructions",
-  "help.instructionsList": "AGENTS.md and the instructions (with how many files each folder holds)",
+  "help.instructionsList": "AGENTS.md and the instructions (with the title and description of each file in their folders)",
   "help.instructionsShow": "An instruction's index.md as written, the designs that follow it and its folder's files",
   "help.instructionsShowTargets": "Instruction folder names or I- IDs (one or more)",
   "help.instructionsShowFile": "Read one file of the instruction folder (e.g. references/code-style.md)",
@@ -25947,18 +26104,26 @@ var messages_default4 = {
   "help.listQ": "Only those whose title, description or text holds these words",
   "help.listAuthor": "Only those this Git author (name or email) changed",
   "help.listSort": "Sort key",
-  "help.listLimit": "Only the first n",
+  "help.listLimit": "n per page (20 by default)",
+  "help.listAll": "Everything, not split into pages",
+  "help.listAfter": "Start after this item (the value at the end of the previous page)",
   "help.listFields": "Only these columns, comma-separated (text prints one tab-separated line each)",
   "list.limit": "Give a whole number of 1 or more.",
   "list.unknownFields": "Unknown columns: {fields}. Available columns: {columns}",
   "list.since": "Not a date (YYYY-MM-DD) or a commit: {value}",
+  "list.after": "No such cursor in the list: {cursor}. Read again from the start without --after.",
+  "list.more": "{unit}: {shown} of {total}. Next page: the same command with --after {cursor}",
+  "list.items": "Items",
+  "list.features": "Features",
+  "list.commits": "Commits",
+  "list.records": "Records",
   "docs.otherResource": "Not a document this command reads: {ids}. Use {command}.",
   "docs.noMatch": "Nothing matches.",
   "docs.requirement": "requirement",
   "docs.design": "design",
   "instructions.agents": "AGENTS.md \u2014 the index outside the block says which instruction to read for which work",
   "instructions.noAgents": "No AGENTS.md \u2014 nothing tells when to read which instruction",
-  "instructions.files": "{count} files",
+  "instructions.filesLimited": "(the folder holds more; only the first {count} are shown)",
   "instructions.empty": "No instructions yet. Create one with instructions new.",
   "instructions.fileWithOne": "--file takes one instruction and does not go with --ref.",
   "instructions.unknownFile": "The folder of instruction {name} has no such file: {path}",
@@ -26069,9 +26234,9 @@ async function dispatch(routes, sessionId, url2, path3, request, response, allow
   if (found.query) {
     const keys2 = [...url2.searchParams.keys()];
     if (new Set(keys2).size !== keys2.length) return fail2(response, 400, "BAD_REQUEST", t2("server.badRange"));
-    const parsed = found.query.safeParse(Object.fromEntries(url2.searchParams));
-    if (!parsed.success) return fail2(response, 400, "BAD_REQUEST", t2("server.badRange"));
-    query = parsed.data;
+    const parsed2 = found.query.safeParse(Object.fromEntries(url2.searchParams));
+    if (!parsed2.success) return fail2(response, 400, "BAD_REQUEST", t2("server.badRange"));
+    query = parsed2.data;
   } else if (url2.search) return fail2(response, 400, "BAD_REQUEST", t2("server.noQuery"));
   if (found.session && request.headers["x-gitifact-session"] !== sessionId) return fail2(response, 409, "SESSION_CHANGED", t2("server.sessionChanged"));
   try {
@@ -26329,7 +26494,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 = 8;
+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.
@@ -26344,18 +26509,32 @@ var SCHEMA = `
   CREATE INDEX doc_references_to ON doc_references (to_id);
   -- Commits already read, and with which parser: 'current', 'legacy' (0.7, before a migration) or 'migration' (hidden).
   CREATE TABLE commits (oid TEXT PRIMARY KEY, reader TEXT NOT NULL);
-  -- One row per change. 'row' is the list shape as JSON; 'detail' the text on both sides.
+  -- One row per change. 'row' is the list shape as JSON with its records by ID; 'detail' where each side's text is read
+  -- again from Git (commit and path), or the text itself for 0.7 history, which has no files to read again.
   CREATE TABLE changes (
     key TEXT PRIMARY KEY, oid TEXT NOT NULL, ord INTEGER NOT NULL,
     id TEXT NOT NULL, kind TEXT NOT NULL, types TEXT NOT NULL, email TEXT NOT NULL, date TEXT NOT NULL,
     before_spec TEXT, after_spec TEXT, needle TEXT NOT NULL, row TEXT NOT NULL, detail TEXT NOT NULL);
   CREATE INDEX changes_by_commit ON changes (oid, ord);
   CREATE INDEX changes_by_id ON changes (id);
+  -- The records each commit added, once each; change rows name them by ID.
+  CREATE TABLE records (oid TEXT NOT NULL, id TEXT NOT NULL, title TEXT NOT NULL, sections TEXT NOT NULL, PRIMARY KEY (oid, id));
+  CREATE INDEX records_by_id ON records (id);
   -- All reachable record commits of one HEAD, children before parents (pos 0 is newest).
   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,
@@ -26377,6 +26556,10 @@ function prepare(db) {
     db.exec("ROLLBACK");
     throw error62;
   }
+  try {
+    db.exec("VACUUM");
+  } catch {
+  }
 }
 function createCacheDatabase(root) {
   let path3;
@@ -26472,24 +26655,23 @@ var place = (doc) => doc.path.replace(/^\.gitifact\//, "");
 function createDocumentCache(root, database) {
   let syncing;
   async function walk() {
-    const found = /* @__PURE__ */ new Map();
+    const found = [];
     async function visit2(relative, depth) {
       const info5 = await lstat2(join3(root, ...relative.split("/"))).catch((error62) => {
         if (error62.code === "ENOENT") return void 0;
         throw error62;
       });
-      if (!info5 || found.size >= COUNT_LIMIT) return;
+      if (!info5 || found.length >= 2 * COUNT_LIMIT) return;
       if (info5.isDirectory() && !info5.isSymbolicLink()) {
         if (depth > 10) return;
-        for (const name2 of (await readdir2(join3(root, ...relative.split("/")))).sort()) await visit2(relative + "/" + name2, depth + 1);
+        await Promise.all((await readdir2(join3(root, ...relative.split("/")))).map((name2) => visit2(relative + "/" + name2, depth + 1)));
         return;
       }
-      found.set(relative, { mtime: info5.mtimeMs, size: info5.size, link: info5.isSymbolicLink() || !info5.isFile() });
+      found.push([relative, { mtime: info5.mtimeMs, size: info5.size, link: info5.isSymbolicLink() || !info5.isFile() }]);
     }
-    await visit2(SPEC_ROOT, 0);
-    await visit2(WIKI_ROOT, 0);
-    await visit2(INSTRUCTIONS_ROOT, 0);
-    return found;
+    await Promise.all([visit2(SPEC_ROOT, 0), visit2(WIKI_ROOT, 0), visit2(INSTRUCTIONS_ROOT, 0)]);
+    found.sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    return new Map(found.slice(0, COUNT_LIMIT));
   }
   async function read(path3, seen) {
     try {
@@ -26513,7 +26695,7 @@ function createDocumentCache(root, database) {
     });
     const gone = [...known.keys()].filter((path3) => !seen.has(path3));
     if (!changed.length && !gone.length) return;
-    const parsed = await Promise.all(changed.map(async ([path3, s]) => ({ path: path3, seen: s, ...await read(path3, s) })));
+    const parsed2 = await Promise.all(changed.map(async ([path3, s]) => ({ path: path3, seen: s, ...await read(path3, s) })));
     await database.with((db) => transaction(db, () => {
       const forget = (path3) => {
         const row = db.prepare("SELECT id FROM documents WHERE path = ?").get(path3);
@@ -26530,7 +26712,7 @@ function createDocumentCache(root, database) {
       const document = db.prepare("INSERT INTO documents (path, id, kind, feature, title, description, ord, doc) VALUES (?, ?, ?, ?, ?, ?, ?, ?)");
       const reference2 = db.prepare("INSERT INTO doc_references (from_id, to_id, type) VALUES (?, ?, ?)");
       const search = db.prepare("INSERT INTO search (scope, kind, ref, oid, payload, title, place, body) VALUES (?,?,?,?,?,?,?,?)");
-      for (const p of parsed) {
+      for (const p of parsed2) {
         forget(p.path);
         file2.run(p.path, p.seen.mtime, p.seen.size, p.problem ? JSON.stringify(p.problem) : null);
         const doc = p.doc;
@@ -26589,28 +26771,23 @@ function createDocumentCache(root, database) {
         throw error62;
       });
       if (history) seen.set(HISTORY_PATH, { mtime: history.mtimeMs, size: history.size, link: history.isSymbolicLink() || !history.isFile() });
-      const files = /* @__PURE__ */ new Map();
-      const problems = [];
-      for (const [path3, s] of seen) {
-        if (!readable(path3)) continue;
-        if (instructionFile3(path3) && !path3.endsWith(".md")) {
-          files.set(path3, "");
-          continue;
-        }
-        if (s.link) {
-          problems.push(docProblem("PATH_UNSUPPORTED", path3));
-          continue;
-        }
-        if (s.size > (path3 === HISTORY_PATH ? 64 * FILE_LIMIT : FILE_LIMIT)) {
-          problems.push(docProblem("FILE_TOO_LARGE", path3));
-          continue;
-        }
+      const read2 = await Promise.all([...seen].map(async ([path3, s]) => {
+        if (!readable(path3)) return { path: path3 };
+        if (instructionFile3(path3) && !path3.endsWith(".md")) return { path: path3, text: "" };
+        if (s.link) return { path: path3, problem: docProblem("PATH_UNSUPPORTED", path3) };
+        if (s.size > (path3 === HISTORY_PATH ? 64 * FILE_LIMIT : FILE_LIMIT)) return { path: path3, problem: docProblem("FILE_TOO_LARGE", path3) };
         try {
-          files.set(path3, decode3(await readFile2(join3(root, ...path3.split("/")))));
+          return { path: path3, text: decode3(await readFile2(join3(root, ...path3.split("/")))) };
         } catch (error62) {
-          if (error62 instanceof TypeError) problems.push(docProblem("INVALID_CHARACTERS", path3));
-          else throw error62;
+          if (error62 instanceof TypeError) return { path: path3, problem: docProblem("INVALID_CHARACTERS", path3) };
+          throw error62;
         }
+      }));
+      const files = /* @__PURE__ */ new Map();
+      const problems = [];
+      for (const r of read2) {
+        if (r.text !== void 0) files.set(r.path, r.text);
+        if (r.problem) problems.push(r.problem);
       }
       return { files, problems };
     },
@@ -26641,6 +26818,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();
@@ -26866,7 +27077,8 @@ function createCommitChanges(git) {
     types: change2.types,
     before: change2.before,
     after: change2.after,
-    records: recordsFor(records2, change2.id)
+    records: recordsFor(records2, change2.id),
+    source: { before: c.parent ?? null, after: c.commit }
   }));
   const newReasons = (before, after) => [...after.reasons.values()].filter((r) => before.every((b) => !b.reasons.has(r.id))).map((r) => reasonRecord(r.id, r.docs, r.reason));
   const recordsAt = (blobs, rev, paths2) => paths2.flatMap((path3) => {
@@ -26951,6 +27163,21 @@ function createCommitChanges(git) {
   return {
     /** Every document and reason file of a commit (path → text): what `specs show --ref` and `changes` compare against. */
     tree,
+    /**
+     * Documents read again at the commits and paths a change was read at, by one `cat-file --batch`: the text a
+     * change's detail shows, which the cache does not keep. A place that no longer reads is null.
+     */
+    async sides(places) {
+      const blobs = await readBlobs([...new Set(places.map((p) => p.rev + ":" + p.path))]);
+      return places.map((p) => {
+        const text4 = blobs.get(p.rev + ":" + p.path);
+        try {
+          return text4 === void 0 ? null : snapshot3(parseDocumentFile(p.path, text4), p.specId);
+        } catch {
+          return null;
+        }
+      });
+    },
     /** All reachable record commits, children before parents even when author clocks differ. */
     async lineage(head) {
       return git.decode(await git.run(["rev-list", "--full-history", "--date-order", head, "--", ...HISTORY_PATHSPECS])).split("\n").filter(Boolean);
@@ -26989,25 +27216,30 @@ function createCommitChanges(git) {
 // src/adapters/cache/history.ts
 var listed = (e) => {
   const reference2 = (s) => s ? { id: s.id, title: s.title, specId: s.specId, path: s.path } : null;
-  return { ...e, before: reference2(e.before), after: reference2(e.after) };
+  const { source: _source, ...event2 } = e;
+  return { ...event2, before: reference2(e.before), after: reference2(e.after) };
 };
-var titleOf = (e) => (e.after ?? e.before)?.title ?? e.id;
+var sideOf3 = (snapshot5, rev) => !snapshot5 ? null : rev ? { rev, path: snapshot5.path } : snapshot5;
 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 search = db.prepare("INSERT INTO search (scope, kind, ref, oid, payload, title, place, body) VALUES (?,?,?,?,?,?,?,?)");
+    const record4 = db.prepare("INSERT OR IGNORE INTO records (oid, id, title, sections) VALUES (?, ?, ?, ?)");
     transaction(db, () => {
       for (const c of commits) {
         if (!Number(commit.run(c.commit, readers.get(c.commit) ?? "current").changes)) continue;
         c.events.forEach((e, ord) => {
+          for (const r of e.records) record4.run(e.commit, r.id, r.title, JSON.stringify(r.sections));
+          const row = { ...listed(e), records: e.records.map((r) => r.id) };
+          const detail = { before: sideOf3(e.before, e.source?.before), after: sideOf3(e.after, e.source?.after) };
           change2.run(
             e.key,
             e.commit,
@@ -27020,26 +27252,22 @@ function createHistory(database, git) {
             e.before?.specId ?? null,
             e.after?.specId ?? null,
             [e.id, e.before?.title ?? "", e.after?.title ?? ""].join(" ").toLowerCase(),
-            JSON.stringify(listed(e)),
-            JSON.stringify({ before: e.before, after: e.after })
-          );
-          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()
+            JSON.stringify(row),
+            JSON.stringify(detail)
           );
         });
       }
     });
   }
   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])));
@@ -27048,13 +27276,15 @@ function createHistory(database, git) {
       for (const oid3 of stale) {
         db.prepare("DELETE FROM commits WHERE oid = ?").run(oid3);
         db.prepare("DELETE FROM changes WHERE oid = ?").run(oid3);
-        db.prepare("DELETE FROM search WHERE scope = 'history' AND oid = ?").run(oid3);
+        db.prepare("DELETE FROM records WHERE 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);
@@ -27078,6 +27308,45 @@ function createHistory(database, git) {
     }
     return pending;
   }
+  async function readCommit(commit) {
+    const known = await database.with((db) => !!db.prepare("SELECT 1 FROM commits WHERE oid = ?").get(commit));
+    if (known) return;
+    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 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(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);
+      return r ? [r] : [];
+    }) }));
+  }
+  async function detailOf(rows) {
+    const events = await database.with((db) => hydrate(db, rows.map((r) => r.row)));
+    const sides = rows.map((r) => JSON.parse(r.detail));
+    const places = [];
+    sides.forEach((side, i) => {
+      for (const key of ["before", "after"]) {
+        const value = side[key];
+        if (value && "rev" in value) places.push({ rev: value.rev, path: value.path, specId: events[i][key]?.specId ?? "" });
+      }
+    });
+    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) }));
+  }
   function where(filter) {
     const clauses = [];
     const params = [];
@@ -27106,22 +27375,60 @@ 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),
-    /** One page of the changes that match, newest first, with how many match in all. */
-    async page(head, filter, offset, limit) {
+    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
+     * page when more follow. A commit `after` that is not in `head`'s matching history answers undefined.
+     */
+    async commits(head, filter, after, limit) {
       await ensure(head);
       return database.with((db) => {
         const { sql, params } = where(filter);
         const from = "FROM lineage l JOIN changes c ON c.oid = l.oid WHERE l.head = ?" + sql;
-        const total = Number(db.prepare("SELECT count(*) AS n " + from).get(head, ...params).n);
-        const rows = db.prepare(`SELECT c.row ${from} ORDER BY l.pos, c.ord LIMIT ? OFFSET ?`).all(head, ...params, limit, offset);
-        return { total, events: rows.map((r) => JSON.parse(r.row)) };
+        const counted = db.prepare("SELECT count(*) AS n, count(DISTINCT c.oid) AS commits " + from).get(head, ...params);
+        let start = -1;
+        if (after !== void 0) {
+          const found = db.prepare("SELECT l.pos AS pos " + from + " AND l.oid = ? LIMIT 1").get(head, ...params, after);
+          if (!found) return void 0;
+          start = found.pos;
+        }
+        const commits = db.prepare(`SELECT l.pos AS pos, l.oid AS oid ${from} AND l.pos > ? GROUP BY l.pos, l.oid ORDER BY l.pos LIMIT ?`).all(head, ...params, start, limit + 1);
+        const shown = commits.slice(0, limit);
+        const rows = !shown.length ? [] : db.prepare(`SELECT c.row ${from} AND l.pos >= ? AND l.pos <= ? ORDER BY l.pos, c.ord`).all(head, ...params, shown[0].pos, shown[shown.length - 1].pos);
+        return {
+          total: Number(counted.n),
+          commits: Number(counted.commits),
+          next: commits.length > limit ? shown[shown.length - 1].oid : null,
+          events: hydrate(db, rows.map((r) => r.row))
+        };
+      });
+    },
+    /**
+     * 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 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);
+        return { total: all.length, next: start + shown.length < all.length ? shown[shown.length - 1].key : null, events: hydrate(db, shown.map((r) => r.row)) };
       });
     },
+    /** One change of a commit with the text on both sides, read again from Git: the change the reader opened. */
+    async commitChange(commit, id) {
+      await readCommit(commit);
+      const rows = await database.with((db) => db.prepare("SELECT row, detail FROM changes WHERE oid = ? AND id = ? ORDER BY ord LIMIT 1").all(commit, id));
+      return rows.length ? (await detailOf(rows))[0] : void 0;
+    },
     /** Every change of one document, newest first: `records list --doc`. */
     async ofDocument(head, id) {
       await ensure(head);
-      return database.with((db) => db.prepare("SELECT c.row FROM lineage l JOIN changes c ON c.oid = l.oid WHERE l.head = ? AND c.id = ? ORDER BY l.pos, c.ord").all(head, id).map((r) => JSON.parse(r.row)));
+      return database.with((db) => hydrate(db, db.prepare("SELECT c.row FROM lineage l JOIN changes c ON c.oid = l.oid WHERE l.head = ? AND c.id = ? ORDER BY l.pos, c.ord").all(head, id).map((r) => r.row)));
     },
     /** Who changed which document in which commit of `head`'s history, newest first: what the lists filter and sort by. */
     async changesOf(head) {
@@ -27130,25 +27437,60 @@ function createHistory(database, git) {
         FROM lineage l JOIN changes c ON c.oid = l.oid WHERE l.head = ? ORDER BY l.pos, c.ord`).all(head));
     },
     /**
-     * Every record of `head`'s history, newest first, once each: the commit that carries it and the documents it
-     * explains there. A record reaches the cache through the changes it explains, so one row per change is folded.
+     * The records of `head`'s history that match, newest first, a page at a time: what `records list` shows after the
+     * records not committed yet. The filters and the page are SQL over the records table, so a page reads only its
+     * rows. `after` is the ID of the last record of the previous page; `limit` undefined is every match.
      */
-    async recordsOf(head) {
+    async records(head, filter, after, limit) {
       await ensure(head);
-      const rows = await database.with((db) => db.prepare(`SELECT c.oid AS "commit", c.id AS doc, c.date AS date, json_extract(c.row, '$.author') AS author, c.email AS email,
-        json_extract(c.row, '$.message') AS message, r.value AS record
-        FROM lineage l JOIN changes c ON c.oid = l.oid, json_each(c.row, '$.records') r WHERE l.head = ? ORDER BY l.pos, c.ord`).all(head));
-      const records2 = /* @__PURE__ */ new Map();
-      for (const row of rows) {
-        const record4 = JSON.parse(row.record);
-        const known = records2.get(record4.id);
-        if (known) {
-          if (known.commit === row.commit && !known.docs.includes(row.doc)) known.docs.push(row.doc);
-          continue;
+      return database.with((db) => {
+        const clauses = [];
+        const params = [];
+        if (filter.author) {
+          clauses.push("(lower(json_extract(row, '$.author')) = ? OR lower(json_extract(row, '$.email')) = ?)");
+          params.push(filter.author.toLowerCase(), filter.author.toLowerCase());
         }
-        records2.set(record4.id, { id: record4.id, title: record4.title, sections: record4.sections, commit: row.commit, date: row.date, author: row.author, email: row.email, message: row.message, docs: [row.doc] });
-      }
-      return [...records2.values()];
+        if (filter.q?.trim()) {
+          clauses.push("instr(lower(title || ' ' || body || ' ' || json_extract(row, '$.message')), ?) > 0");
+          params.push(filter.q.trim().toLowerCase());
+        }
+        if (filter.from !== void 0) {
+          clauses.push("unixepoch(json_extract(row, '$.date')) * 1000 >= ?");
+          params.push(filter.from);
+        }
+        if (filter.commits) {
+          clauses.push("oid IN (SELECT value FROM json_each(?))");
+          params.push(JSON.stringify(filter.commits));
+        }
+        const matching = `WITH meta AS (SELECT l.pos AS pos, r.oid AS oid, r.id AS id, r.title AS title, r.sections AS sections,
+            (SELECT group_concat(json_extract(s.value, '$.body'), ' ') FROM json_each(r.sections) s) AS body,
+            (SELECT c.row FROM changes c WHERE c.oid = r.oid ORDER BY c.ord LIMIT 1) AS row
+          FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = ?)
+          SELECT * FROM meta WHERE 1 = 1${clauses.map((c) => " AND " + c).join("")}`;
+        const total = Number(db.prepare(`SELECT count(*) AS n FROM (${matching})`).get(head, ...params).n);
+        let from;
+        if (after !== void 0) {
+          from = db.prepare(`SELECT pos, id FROM (${matching}) WHERE id = ?`).get(head, ...params, after);
+          if (!from) return void 0;
+        }
+        const rows = db.prepare(`SELECT oid, id, title, sections, row FROM (${matching})${from ? " WHERE (pos, id) > (?, ?)" : ""} ORDER BY pos, id LIMIT ?`).all(head, ...params, ...from ? [from.pos, from.id] : [], limit ?? -1);
+        const docsOf = db.prepare("SELECT c.id AS id FROM changes c, json_each(c.row, '$.records') j WHERE c.oid = ? AND j.value = ? ORDER BY c.ord");
+        const records2 = rows.map((r) => {
+          const commit = JSON.parse(r.row);
+          return {
+            id: r.id,
+            title: r.title,
+            sections: JSON.parse(r.sections),
+            commit: r.oid,
+            date: commit.date,
+            author: commit.author,
+            email: commit.email,
+            message: commit.message,
+            docs: docsOf.all(r.oid, r.id).map((d) => d.id)
+          };
+        });
+        return { records: records2, total };
+      });
     },
     /** Counts over all of history and its newest commits, for the overview. */
     async summary(head) {
@@ -27160,110 +27502,299 @@ 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: db.prepare("SELECT row FROM changes WHERE oid = ? ORDER BY ord LIMIT ?").all(c.oid, RECENT_CHANGES).map((r) => JSON.parse(r.row))
+          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 changes c ON c.oid = l.oid, json_each(c.row, '$.records') r
-        WHERE l.head = ? AND json_extract(r.value, '$.id') = ? ORDER BY l.pos LIMIT 1`).get(head, id)?.oid);
-    },
-    /** Every change of one commit with the text on both sides: what the commit page reads. */
-    async ofCommit(commit) {
-      const rows = await database.with((db) => db.prepare("SELECT row, detail FROM changes WHERE oid = ? ORDER BY ord").all(commit));
-      if (rows.length) return rows.map((r) => ({ event: JSON.parse(r.row), ...JSON.parse(r.detail) }));
-      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) return [];
-      await database.with((db) => insert(db, read, /* @__PURE__ */ new Map()));
-      return database.with((db) => db.prepare("SELECT row, detail FROM changes WHERE oid = ? ORDER BY ord").all(commit).map((r) => ({ event: JSON.parse(r.row), ...JSON.parse(r.detail) })));
+      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 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) => lstat4(path3).catch((error62) => {
+  if (error62.code === "ENOENT") return void 0;
+  throw error62;
+});
+async function recordFolders(root) {
+  return (await readdir3(join5(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
+    if (error62.code === "ENOENT") return [];
+    throw error62;
+  })).filter(isRecordFolder);
+}
+async function findRecord(root, id) {
+  for (const folder of await recordFolders(root)) {
+    const path3 = `${RECORDS_ROOT}/${folder}/${id}.md`;
+    if ((await info(join5(root, ...path3.split("/"))))?.isFile()) return path3;
+  }
+  return void 0;
+}
+async function readPendingRecords(root, run) {
+  const status = (await run(["status", "--porcelain=v1", "-z", "--untracked-files=all", "--no-renames", "--", RECORDS_ROOT])).toString("utf8").split("\0").filter(Boolean);
+  const files = /* @__PURE__ */ new Map();
+  const altered = [];
+  const problems = [];
+  for (const entry2 of status) {
+    const state2 = entry2.slice(0, 2);
+    const path3 = entry2.slice(3);
+    if (state2 !== "??" && !state2.includes("A")) {
+      altered.push(path3);
+      continue;
+    }
+    const file2 = join5(root, ...path3.split("/"));
+    const stat3 = await info(file2);
+    if (!stat3?.isFile() || stat3.isSymbolicLink()) {
+      problems.push(docProblem("PATH_UNSUPPORTED", path3));
+      continue;
+    }
+    if (stat3.size > 1024 * 1024) {
+      problems.push(docProblem("FILE_TOO_LARGE", path3));
+      continue;
+    }
+    try {
+      files.set(path3, decoder.decode(await readFile3(file2)));
+    } catch {
+      problems.push(docProblem("INVALID_CHARACTERS", path3));
+    }
+  }
+  const folders = await recordFolders(root);
+  for (const path3 of files.keys()) {
+    const id = recordIdOf(path3);
+    if (!id) continue;
+    for (const folder of folders) {
+      const other = `${RECORDS_ROOT}/${folder}/${id}.md`;
+      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 lstat3, readFile as readFile3, realpath, mkdir as mkdir2, open as open2, link, rename, unlink } from "node:fs/promises";
-import { join as join4 } 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) => lstat3(path3).catch((error62) => {
+var fileInfo = (path3) => lstat5(path3).catch((error62) => {
   if (missing(error62)) return void 0;
   throw error62;
 });
 async function configDirectory(root) {
-  const path3 = join4(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 = join4(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"));
-  const bytes = await readFile3(path3);
+  const bytes = await readFile4(path3);
   const after = await fileInfo(path3);
   await configDirectory(root);
   if (!after || after.ino !== info5.ino || after.dev !== info5.dev || after.mtimeMs !== info5.mtimeMs || bytes.length > 65536) {
@@ -27276,7 +27807,7 @@ async function readConfigFile(root) {
   }
 }
 async function publishConfig(root, text4, recheck, beforePublish, replace = false) {
-  const directory = join4(root, ".gitifact");
+  const directory = join6(root, ".gitifact");
   await configDirectory(root);
   await mkdir2(directory).catch((error62) => {
     if (error62.code !== "EEXIST") throw error62;
@@ -27289,7 +27820,7 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
       throw new InitError("INPUT_CHANGED", t2("config.directoryChanged"));
     }
   };
-  const temporary = join4(directory, ".init-" + randomUUID2() + ".tmp");
+  const temporary = join6(directory, ".init-" + randomUUID2() + ".tmp");
   const handle = await open2(temporary, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -27303,11 +27834,11 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
     await unchanged();
     await recheck();
     await unchanged();
-    const bytes = await readFile3(temporary, "utf8");
+    const bytes = await readFile4(temporary, "utf8");
     if (bytes !== text4) throw new InitError("INPUT_CHANGED", t2("config.temporaryChanged"));
     parseManagedConfig(bytes);
-    if (replace) await rename(temporary, join4(directory, "config.json"));
-    else await link(temporary, join4(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);
@@ -27316,42 +27847,64 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
 }
 
 // src/adapters/filesystem/instruction-folder.ts
-import { lstat as lstat4, readdir as readdir3, readFile as readFile4 } from "node:fs/promises";
-import { join as join5 } 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) => join5(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;
   async function visit2(folder, prefix, depth) {
     if (depth > 10) return;
-    const entries = await readdir3(folder, { withFileTypes: true }).catch(() => []);
+    const entries = await readdir4(folder, { withFileTypes: true }).catch(() => []);
     for (const entry2 of entries.sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
       if (files.length >= INSTRUCTION_FILE_LIMIT) {
         limited = true;
         return;
       }
       const path3 = prefix + entry2.name;
-      if (entry2.isDirectory()) await visit2(join5(folder, entry2.name), path3 + "/", depth + 1);
-      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat4(join5(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 = folderOf3(root, instructionPath);
+  return Promise.all(files.map(async (file2) => {
+    if (!isInstructionReference(file2.path)) return file2;
+    let handle;
+    try {
+      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")) };
+    } catch {
+      return file2;
+    } finally {
+      await handle?.close();
+    }
+  }));
+}
+async function readInstructionFiles(root, instructionPath) {
+  const { files, limited } = await listInstructionFiles(root, instructionPath);
+  return { files: await describeFiles(root, instructionPath, files), limited };
+}
 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 = join5(full, part);
-    const info5 = await lstat4(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 lstat4(full)).size;
+  const size = (await lstat6(full)).size;
   if (size > INSTRUCTION_TEXT_LIMIT) return { text: null, size, binary: false, tooLarge: true };
-  const bytes = await readFile4(full);
+  const bytes = await readFile5(full);
   try {
     if (bytes.includes(0)) throw new TypeError("binary");
     return { text: new TextDecoder("utf-8", { fatal: true }).decode(bytes), size, binary: false, tooLarge: false };
@@ -27361,34 +27914,122 @@ async function readInstructionFile(root, instructionPath, path3) {
 }
 
 // src/adapters/filesystem/agents-file.ts
-import { lstat as lstat5, readFile as readFile5 } from "node:fs/promises";
-import { join as join6 } 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 = join6(root, "AGENTS.md");
-  const info5 = await lstat5(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 readFile5(file2));
+    return new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(await readFile6(file2));
   } catch {
     return null;
   }
 }
 
-// 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 });
+// src/queries/document-states.ts
+var isDocument = (path3) => {
+  try {
+    return classifyDocPath(path3).type === "doc";
+  } catch {
+    return false;
+  }
 };
-async function settled(reads) {
-  const results = await Promise.allSettled(reads);
-  const failure2 = results.find((r) => r.status === "rejected");
+async function documentStates(project, working2) {
+  const head = await project.head();
+  const states = /* @__PURE__ */ new Map();
+  const previous = /* @__PURE__ */ new Map();
+  const result = (documents) => ({ documents, state: (id) => states.get(id) ?? "committed", previousPath: (id) => previous.get(id) });
+  if (!head) {
+    for (const doc of working2) states.set(doc.id, "added");
+    return result(working2);
+  }
+  const status = project.reader.decode(await project.reader.run(["status", "--porcelain=v1", "-z", "--untracked-files=all", "--no-renames", "--", ...[SPEC_ROOT, INSTRUCTIONS_ROOT, WIKI_ROOT].map((root) => ":(top)" + root)])).split("\0").filter(Boolean);
+  const byPath2 = new Map(working2.map((d) => [d.path, d]));
+  const added = [];
+  const deletedPaths = [];
+  for (const entry2 of status) {
+    const [x, y] = [entry2[0], entry2[1]];
+    const path3 = entry2.slice(3);
+    if (!isDocument(path3)) continue;
+    const doc = byPath2.get(path3);
+    const atHead = x !== "?" && x !== "A";
+    if (!doc) {
+      if (atHead && (x === "D" || y === "D")) deletedPaths.push(path3);
+      continue;
+    }
+    if (!atHead) {
+      added.push(doc);
+      continue;
+    }
+    if (x !== " " || y !== " ") states.set(doc.id, "modified");
+  }
+  const gone = await documentsAtHead(project, head, deletedPaths);
+  const goneById = new Map(gone.map((d) => [d.id, d]));
+  for (const doc of added) {
+    const before = goneById.get(doc.id);
+    if (before) {
+      states.set(doc.id, "modified");
+      previous.set(doc.id, before.path);
+      goneById.delete(doc.id);
+    } else states.set(doc.id, "added");
+  }
+  const ids = new Set(working2.map((d) => d.id));
+  const deleted = [...goneById.values()].filter((d) => !ids.has(d.id));
+  for (const doc of deleted) states.set(doc.id, "deleted");
+  return result([...working2, ...deleted]);
+}
+async function documentsAtHead(project, head, paths2) {
+  if (!paths2.length) return [];
+  const listing = project.reader.decode(await project.reader.run(["ls-tree", "--full-tree", "-z", head, "--", ...paths2])).split("\0").filter(Boolean).map((row) => /^\d+ blob ([a-f0-9]+)\t([\s\S]+)$/.exec(row)).filter((m) => !!m).map((m) => ({ blob: m[1], path: m[2] }));
+  const blobs = await project.reader.blobs([...new Set(listing.map((l) => l.blob))]).catch(() => /* @__PURE__ */ new Map());
+  return listing.flatMap(({ blob, path: path3 }) => {
+    const text4 = blobs.get(blob);
+    try {
+      return text4 === void 0 ? [] : [parseDocumentFile(path3, text4)];
+    } catch {
+      return [];
+    }
+  });
+}
+
+// src/server/checkout/stamp.ts
+import { createHash as createHash2 } from "node:crypto";
+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" };
+  const git = async (args, acceptedExitCodes = [0]) => (await runner(["--no-optional-locks", "-c", "core.fsmonitor=false", ...args], { cwd: root, env, timeoutMs: 15e3, maxBytes: 16 * 1024 * 1024, acceptedExitCodes })).toString("utf8");
+  return async () => {
+    const [head, status] = await Promise.all([
+      git(["rev-parse", "--verify", "--quiet", "HEAD"], [0, 1]),
+      git(["status", "--porcelain=v1", "-z", "--untracked-files=all", "--no-renames", "--", ":(top).gitifact", ":(top)AGENTS.md"])
+    ]);
+    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 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);
+  };
+}
+
+// src/server/checkout/checkout-reader.ts
+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(documents) {
+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);
+    return { state: states.state(id), ...previousPath ? { previousPath } : {} };
+  };
   const byId = new Map(documents.map((d) => [d.id, d]));
   const source2 = (s) => {
     if (!("id" in s)) return { title: s.title, url: s.url, ...s.note ? { note: s.note } : {} };
@@ -27396,28 +28037,45 @@ function checkoutDocuments(documents) {
     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,
-    requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, body: r.body })),
-    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)
-    }))
+  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 }));
   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" };
@@ -27429,84 +28087,37 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
     return head || null;
   };
   const pending = /* @__PURE__ */ new Map();
-  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 };
-  }
+  const readStamp = createStampReader(root, inherited);
   async function read() {
     const raw = await readConfigFile(root);
     if (!raw) throw new StoreError(t2("specReader.schemaRequired"));
     parseManagedConfig(raw);
     const head = await readHead();
-    const [current2, dirty, authors, everyone] = await settled([
+    const stamp = await readStamp();
+    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 arranged = checkoutDocuments(current2.documents);
-    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 } = await listInstructionFiles(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 states = await documentStates({ head: async () => head, reader }, current2.documents);
+    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 = browserSpecsV6.parse({
-      contract: "browser-specs",
-      version: 6,
-      sessionId,
+    return {
       head,
+      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) {
@@ -27515,10 +28126,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";
@@ -27574,10 +28212,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) {
@@ -27606,42 +28249,297 @@ function isUtf8(bytes) {
   }
 }
 
+// src/queries/working-changes.ts
+async function workingChanges(source2, known) {
+  const head = known !== void 0 ? known : await source2.head();
+  const headFiles = head ? await source2.cache.history.filesAt(head) : /* @__PURE__ */ new Map();
+  const [working2, records2] = await Promise.all([source2.cache.documents.files(), source2.pendingRecords()]);
+  return { head, headFiles, working: working2, records: records2, ...compareDocumentSets(headFiles, working2.files) };
+}
+var uncovered = (changes2, records2) => {
+  const covered = new Set(records2.flatMap((r) => r.docs));
+  return changes2.filter((c) => c.types.some((type) => type !== "created") && !covered.has(c.id)).map((c) => c.id);
+};
+async function workingOverview(source2) {
+  const found = await workingChanges(source2);
+  const records2 = checkDocuments(new Map([...found.working.files, ...found.records.files])).records;
+  return {
+    head: found.head,
+    records: records2.map((r) => ({ id: r.id, title: r.title, docs: r.docs, sections: r.sections.map((s) => ({ key: s.key, body: s.body })), draft: !!r.draft })),
+    changes: found.changes.map((c) => ({ id: c.id, kind: c.kind, title: c.title, path: c.path, ...c.previousPath ? { previousPath: c.previousPath } : {}, types: c.types })),
+    withoutRecord: uncovered(found.changes, records2)
+  };
+}
+function snapshot4(doc, docs) {
+  const folder = doc.path.split("/").slice(0, 3).join("/");
+  const specId = doc.kind === "wiki" || doc.kind === "instruction" ? doc.kind : docs.find((d) => d.kind === "feature" && d.path === folder + "/index.md")?.id ?? "";
+  const base = { id: doc.id, kind: doc.kind, title: doc.title, description: doc.description, body: doc.body, specId, path: doc.path };
+  if (doc.kind === "requirement") return { ...base, order: doc.order };
+  if (doc.kind === "design") return { ...base, order: doc.order, requirements: doc.requirements, sources: doc.sources };
+  return base;
+}
+var parsed = (files) => [...files].flatMap(([path3, text4]) => {
+  try {
+    return classifyDocPath(path3).type === "doc" ? [parseDocumentFile(path3, text4)] : [];
+  } catch {
+    return [];
+  }
+});
+async function workingChange2(source2, id) {
+  const found = await workingChanges(source2);
+  const change2 = found.changes.find((c) => c.id === id);
+  if (!change2) return void 0;
+  const before = parsed(found.headFiles);
+  const after = parsed(found.working.files);
+  const side = (docs) => {
+    const doc = docs.find((d) => d.id === id);
+    return doc ? snapshot4(doc, docs) : null;
+  };
+  return {
+    change: { id: change2.id, kind: change2.kind, title: change2.title, path: change2.path, ...change2.previousPath ? { previousPath: change2.previousPath } : {}, types: change2.types },
+    before: side(before),
+    after: side(after)
+  };
+}
+
+// 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 = 50;
+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 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) }),
-    route({ method: "GET", path: "/api/v1/history", session: true, query: browserHistoryQueryV3, unreadable: unreadable2, handle: async ({ query }) => {
-      const offset = query.offset ?? 0;
-      const page = await cache.history.page(query.head, { kind: query.kind, document: query.document, feature: query.feature, author: query.author, q: query.q }, offset, query.limit ?? PAGE);
-      return ok(browserHistoryV5.parse({ contract: "browser-history", version: 5, sessionId, head: query.head, offset, ...page }));
+    // 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/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) })) }),
-    // One commit as its page reads it: its documents with both sides, and who made it even when it changed none.
-    route({ method: "GET", path: "/api/v1/commit", session: true, query: browserCommitQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
-      const changes2 = await cache.history.ofCommit(query.commit);
-      const first = changes2[0]?.event;
+    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 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(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: 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"));
       const [author, email3, committer, date5, message] = first ? [first.author, first.email, first.committer, first.date, first.message] : [line2[0] ?? "", line2[1] ?? "", line2[2] ?? "", line2[3] ?? "", (line2[4] ?? "").replace(/\n$/, "")];
-      return ok(browserCommitV3.parse({ contract: "browser-commit", version: 3, sessionId, commit: query.commit, author, email: email3, committer, date: date5, message, changes: changes2 }));
+      return ok(browserCommitV4.parse({
+        contract: "browser-commit",
+        version: 4,
+        sessionId,
+        commit: query.commit,
+        author,
+        email: email3,
+        committer,
+        date: date5,
+        message,
+        total: page.total,
+        next: page.next,
+        changes: page.events
+      }));
+    } }),
+    // The text on both sides of one change, read from Git when the reader opens that document.
+    route({ method: "GET", path: "/api/v1/commit/change", session: true, query: browserCommitChangeQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const change2 = await cache.history.commitChange(query.commit, query.id);
+      if (!change2) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
+      return ok(browserCommitChangeV1.parse({ contract: "browser-commit-change", version: 1, sessionId, commit: query.commit, event: change2.event, before: change2.before, after: change2.after }));
     } }),
     // 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) })) }),
+    route({ method: "GET", path: "/api/v1/working/change", session: true, query: browserWorkingChangeQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const change2 = await workingChange2(working2, query.id);
+      if (!change2) throw new HttpError(404, "NOT_FOUND", t2("server.workingChangeNotFound"));
+      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);
@@ -27655,23 +28553,28 @@ 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 lstat6, readFile as readFile6 } from "node:fs/promises";
-import { join as join7 } 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 = join7(root, ...assetPath.split("/"));
-      const stat3 = await lstat6(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 readFile6(file2);
+      const bytes = await readFile7(file2);
       const extension = assetExtension(relative);
       const inline = ["png", "jpg", "jpeg", "gif", "webp", "svg"].includes(extension);
       response.writeHead(200, {
@@ -27688,7 +28591,7 @@ function assetRoutes(root) {
 }
 
 // src/server/browser-server.ts
-var readBundledChangelog = (language) => readFile7(new URL("./i18n/" + language + "/changelog.md", import.meta.url), "utf8").catch((error62) => {
+var readBundledChangelog = (language) => readFile8(new URL("./i18n/" + language + "/changelog.md", import.meta.url), "utf8").catch((error62) => {
   if (error62.code === "ENOENT") return null;
   throw error62;
 });
@@ -27818,14 +28721,14 @@ async function runBrowser(options, version2) {
 }
 
 // src/commands/spec-init.ts
-import { readdir as readdir4 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { readdir as readdir5 } from "node:fs/promises";
+import { join as join14 } from "node:path";
 
 // src/adapters/git/init-repository.ts
-import { createHash as createHash2 } from "node:crypto";
-import { lstat as lstat7, readFile as readFile8 } from "node:fs/promises";
-import { join as join8 } from "node:path";
-var markerPresent = (path3) => lstat7(path3).then(() => true, (error62) => {
+import { createHash as createHash3 } from "node:crypto";
+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;
 });
@@ -27842,27 +28745,27 @@ function initRepository(cwd, inherited = process.env) {
   });
   return {
     async inspect(observedState, includeTrackedConfig = true) {
-      const state = observedState ?? await createRepositoryReader(cwd, { env }).read();
-      const root = state.repository.rootPath;
+      const state2 = observedState ?? await createRepositoryReader(cwd, { env }).read();
+      const root = state2.repository.rootPath;
       const locations = decodeGitLine(await git(["rev-parse", "--path-format=absolute", "--absolute-git-dir", "--git-path", "index"], root)).split("\n");
       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(join8(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 (state.changes.some((change2) => change2.kind === "unmerged")) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
-      const index = await readFile8(indexPath).catch((error62) => {
+      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) => {
         if (error62.code === "ENOENT") return Buffer.alloc(0);
         throw error62;
       });
       const [staged, committed2] = includeTrackedConfig ? await Promise.all([
         git(["ls-files", "--stage", "-z", "--", ".gitifact/config.json"], root),
-        state.head.commit ? git(["ls-tree", "-z", state.head.commit, "--", ".gitifact/config.json"], root) : Buffer.alloc(0)
+        state2.head.commit ? git(["ls-tree", "-z", state2.head.commit, "--", ".gitifact/config.json"], root) : Buffer.alloc(0)
       ]) : [Buffer.alloc(0), Buffer.alloc(0)];
       return {
-        state,
+        state: state2,
         trackedConfig: staged.length > 0 || committed2.length > 0,
-        stamp: JSON.stringify({ repository: state.repository, head: state.head, index: createHash2("sha256").update(index).digest("hex") })
+        stamp: JSON.stringify({ repository: state2.repository, head: state2.head, index: createHash3("sha256").update(index).digest("hex") })
       };
     },
     async checkIgnore(root, path3 = ".gitifact/config.json") {
@@ -27884,19 +28787,52 @@ function initRepository(cwd, inherited = process.env) {
   };
 }
 
+// src/adapters/filesystem/document-file.ts
+import { randomBytes } from "node:crypto";
+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 = join12(root, ...parts.slice(0, i));
+    const info5 = await lstat11(folder).catch((error62) => {
+      if (error62.code === "ENOENT") return void 0;
+      throw error62;
+    });
+    if (!info5) {
+      await mkdir3(folder);
+      continue;
+    }
+    if (!info5.isDirectory() || info5.isSymbolicLink()) throw Object.assign(new Error(folder), { code: "ENOTDIR" });
+  }
+  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";
+async function writeLineEndings(root) {
+  try {
+    await createDocumentFile(root, LINE_ENDINGS_PATH, LINE_ENDINGS);
+    return true;
+  } catch (error62) {
+    if (error62.code === "EEXIST") return false;
+    throw error62;
+  }
+}
+
 // src/adapters/filesystem/managed-file.ts
-import { open as open3, readFile as readFile9, mkdir as mkdir3, realpath as realpath2, rename as rename2, link as link2, unlink as unlink2 } from "node:fs/promises";
-import { join as join9, dirname } from "node:path";
+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 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 = join9(full, parts[i]);
+    full = join13(full, parts[i]);
     let info5 = await fileInfo(full);
     if (!info5 && create && i < parts.length - 1) {
-      await mkdir3(full).catch((error62) => {
+      await mkdir4(full).catch((error62) => {
         if (error62.code !== "EEXIST") throw error62;
       });
       info5 = await fileInfo(full);
@@ -27912,7 +28848,7 @@ async function managedRead(root, path3, limit = DEFAULT_LIMIT) {
   const before = await fileInfo(full);
   if (!before) return null;
   if (before.size > limit) throw new InitError("FILE_TOO_LARGE", t2("managedFile.tooLarge", { kib: limit / 1024, path: path3 }));
-  const bytes = await readFile9(full);
+  const bytes = await readFile10(full);
   await managedPath(root, path3);
   const after = await fileInfo(full);
   if (!after || before.ino !== after.ino || before.dev !== after.dev || before.mtimeMs !== after.mtimeMs || bytes.length > limit) {
@@ -27941,8 +28877,8 @@ async function managedWrite(root, path3, previous, next, recheck) {
     if (previous !== null) await unlink2(full);
     return;
   }
-  const temp = join9(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
-  const handle = await open3(temp, "wx", 384);
+  const temp = join13(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
+  const handle = await open4(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
     try {
@@ -27953,7 +28889,7 @@ async function managedWrite(root, path3, previous, next, recheck) {
     }
     await recheck();
     await unchanged();
-    if (await managedRead(root, path3) !== previous || await readFile9(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", t2("managedFile.publishTargetChanged", { path: path3 }));
+    if (await managedRead(root, path3) !== previous || await readFile10(temp, "utf8") !== next) throw new InitError("INPUT_CHANGED", t2("managedFile.publishTargetChanged", { path: path3 }));
     if (previous === null) await link2(temp, full);
     else await rename2(temp, full);
   } finally {
@@ -27964,10 +28900,10 @@ async function managedWrite(root, path3, previous, next, recheck) {
 }
 
 // src/commands/agent-block.ts
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 
 // src/commands/guide.ts
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 
 // src/commands/output.ts
 var formats = ["text", "json"];
@@ -28004,7 +28940,7 @@ var text2 = (lines) => lines.join("\n") + "\n";
 // src/commands/guide.ts
 var guideTopics = ["workflow", "spec", "design", "instructions", "records", "writing", "commit", "migrate"];
 var isGuideTopic = (value) => guideTopics.includes(value);
-var readBundledGuide = (name2, lang) => readFile10(new URL("./i18n/" + lang + "/docs/" + name2 + ".md", import.meta.url), "utf8");
+var readBundledGuide = (name2, lang) => readFile11(new URL("./i18n/" + lang + "/docs/" + name2 + ".md", import.meta.url), "utf8");
 function guideSummary(source2) {
   const { fields: fields2 } = parseFrontmatterBlock(source2.replace(/\r\n/g, "\n"), "guide");
   const value = (key) => {
@@ -28045,7 +28981,7 @@ function boilerplateFor(path3) {
   const name2 = path3 === "AGENTS.md" ? path3 : path3.split("/").pop().replace(/^\./, "").replace(/\.md$/, "");
   return "# " + name2 + "\n\nProject-specific guidance for AI coding agents.\n";
 }
-var readBundledBlock = (lang) => readFile11(new URL("./i18n/" + lang + "/block.md", import.meta.url), "utf8");
+var readBundledBlock = (lang) => readFile12(new URL("./i18n/" + lang + "/block.md", import.meta.url), "utf8");
 async function renderAgentBlock(version2, 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(", "));
@@ -28226,11 +29162,11 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   const first = await repo.inspect();
   const root = first.state.repository.rootPath;
   const docsPlan = agentDocs ? await planAgentDocs(root, agentDocs) : skippedAgentDocs;
-  const result = async (config3, outcome) => {
+  const result = async (config3, outcome, lineEndings = false) => {
     const checked = await update;
-    return projectInitV7.parse({
+    return projectInitV8.parse({
       contract: "project-init",
-      version: 7,
+      version: 8,
       ok: true,
       outcome,
       rootPath: root,
@@ -28238,6 +29174,7 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
       schemaVersion: config3.schemaVersion,
       baseline: config3.baseline,
       agentDocs: { mode: docsPlan.mode, paths: docsPlan.paths },
+      lineEndings: { path: LINE_ENDINGS_PATH, created: lineEndings },
       update: checked,
       install: checked.status === "available" ? { npx: npxUpdate(checked.latestVersion), npmGlobal: npmGlobalInstall(checked.latestVersion) } : null
     });
@@ -28249,8 +29186,9 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
       if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== text5) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
     };
     await unchanged();
-    if (!dryRun) await applyAgentDocs(root, docsPlan, unchanged);
-    return result(config3, "already-initialized");
+    if (dryRun) return result(config3, "already-initialized");
+    await applyAgentDocs(root, docsPlan, unchanged);
+    return result(config3, "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";
@@ -28260,13 +29198,13 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
     };
     await published();
     await applyAgentDocs(root, docsPlan, published);
-    return result(config2, outcome);
+    return result(config2, outcome, await writeLineEndings(root));
   };
   const old = await readConfigFile(root);
   if (old !== void 0) return existing(old);
   if (first.trackedConfig) throw new InitError("CONFIG_DELETED", t2("init.configDeleted"));
   const checkRecords = async () => {
-    const entries = await readdir4(join10(root, ".gitifact")).catch((e) => {
+    const entries = await readdir5(join14(root, ".gitifact")).catch((e) => {
       if (e.code === "ENOENT") return [];
       throw e;
     });
@@ -28318,117 +29256,33 @@ async function runInit(options, version2) {
     );
     if (!dto.ok) throw new Error("unreachable");
     const docs = dto.agentDocs.mode === "skip" ? t2("init.text.skipped") : dto.agentDocs.paths.join(", ") + (dto.agentDocs.mode === "remove" ? " (" + t2("init.text.blockRemoved") + ")" : dto.outcome === "planned" ? " (" + t2("init.text.blockPlanned") + ")" : " (" + t2("init.text.blockUpdated") + ")");
+    const 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" : "";
     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}
-${newer}` : JSON.stringify(dto) + "\n");
+${lineEndings}${newer}` : JSON.stringify(dto) + "\n");
   } catch (error62) {
     cancel.abort();
     const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
     const failure2 = { code: known ? error62.code : "INIT_FAILED", message: known ? error62.message : t2("init.failed") };
-    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(projectInitV7.parse({ contract: "project-init", version: 7, ok: false, error: failure2 })) + "\n");
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(projectInitV8.parse({ contract: "project-init", version: 8, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
 
 // src/commands/documents.ts
 import { readFile as readFile13 } from "node:fs/promises";
-import { join as join14 } from "node:path";
-
-// src/adapters/filesystem/document-file.ts
-import { randomBytes } from "node:crypto";
-import { lstat as lstat8, mkdir as mkdir4, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join11 } 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 lstat8(folder).catch((error62) => {
-      if (error62.code === "ENOENT") return void 0;
-      throw error62;
-    });
-    if (!info5) {
-      await mkdir4(folder);
-      continue;
-    }
-    if (!info5.isDirectory() || info5.isSymbolicLink()) throw Object.assign(new Error(folder), { code: "ENOTDIR" });
-  }
-  await writeFile2(join11(root, ...parts), text4, { flag: "wx" });
-}
-
-// src/commands/project.ts
-import { join as join13 } from "node:path";
-
-// src/adapters/git/pending-records.ts
-import { lstat as lstat9, readdir as readdir5, readFile as readFile12 } from "node:fs/promises";
-import { join as join12 } from "node:path";
-var decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
-var info = (path3) => lstat9(path3).catch((error62) => {
-  if (error62.code === "ENOENT") return void 0;
-  throw error62;
-});
-async function recordFolders(root) {
-  return (await readdir5(join12(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
-    if (error62.code === "ENOENT") return [];
-    throw error62;
-  })).filter(isRecordFolder);
-}
-async function findRecord(root, id) {
-  for (const folder of await recordFolders(root)) {
-    const path3 = `${RECORDS_ROOT}/${folder}/${id}.md`;
-    if ((await info(join12(root, ...path3.split("/"))))?.isFile()) return path3;
-  }
-  return void 0;
-}
-async function readPendingRecords(root, run) {
-  const status = (await run(["status", "--porcelain=v1", "-z", "--untracked-files=all", "--no-renames", "--", RECORDS_ROOT])).toString("utf8").split("\0").filter(Boolean);
-  const files = /* @__PURE__ */ new Map();
-  const altered = [];
-  const problems = [];
-  for (const entry2 of status) {
-    const state = entry2.slice(0, 2);
-    const path3 = entry2.slice(3);
-    if (state !== "??" && !state.includes("A")) {
-      altered.push(path3);
-      continue;
-    }
-    const file2 = join12(root, ...path3.split("/"));
-    const stat3 = await info(file2);
-    if (!stat3?.isFile() || stat3.isSymbolicLink()) {
-      problems.push(docProblem("PATH_UNSUPPORTED", path3));
-      continue;
-    }
-    if (stat3.size > 1024 * 1024) {
-      problems.push(docProblem("FILE_TOO_LARGE", path3));
-      continue;
-    }
-    try {
-      files.set(path3, decoder.decode(await readFile12(file2)));
-    } catch {
-      problems.push(docProblem("INVALID_CHARACTERS", path3));
-    }
-  }
-  const folders = await recordFolders(root);
-  for (const path3 of files.keys()) {
-    const id = recordIdOf(path3);
-    if (!id) continue;
-    for (const folder of folders) {
-      const other = `${RECORDS_ROOT}/${folder}/${id}.md`;
-      if (other !== path3 && !files.has(other) && (await info(join12(root, ...other.split("/"))))?.isFile()) problems.push(docProblem("DUPLICATE_RECORD_ID", path3, { id, other }));
-    }
-  }
-  return { files, altered: altered.sort(), problems };
-}
+import { join as join16 } from "node:path";
 
 // src/commands/project.ts
+import { join as join15 } 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(join13(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join15(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);
@@ -28459,15 +29313,140 @@ 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 = {
+  added: () => t2("docs.state.added"),
+  modified: () => t2("docs.state.modified"),
+  deleted: () => t2("docs.state.deleted")
+};
+var stateMark = (state2) => state2 === "committed" ? "" : " (" + stateLabel[state2]() + ")";
 var line = (doc) => `${doc.id} ${doc.title}${draftMark(doc)} \u2014 ${doc.description}`;
-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);
+var fileLine = (f) => f.title ? `${f.path} ${f.title} \u2014 ${f.description}` : f.path;
 async function working(project) {
   const { documents } = await project.cache.documents.list();
   return {
     byId: new Map(documents.map((d) => [d.id, d])),
-    read: (path3) => readFile13(join14(project.root, ...path3.split("/")), "utf8"),
+    read: (path3) => readFile13(join16(project.root, ...path3.split("/")), "utf8"),
     referencing: async (id) => [...new Set((await project.cache.documents.referencing(id)).map((r) => r.from))]
   };
 }
@@ -28493,7 +29472,7 @@ async function showDocuments(project, ids, at, kinds, otherResource) {
       ...doc.sources.map((s) => "id" in s ? { id: s.id, title: view.byId.get(s.id)?.title ?? null } : { title: s.title, url: s.url })
     ] : [];
     const referencedBy = (await view.referencing(id)).map((from) => ({ id: from, title: view.byId.get(from)?.title ?? null }));
-    const files = doc.kind === "instruction" && at === void 0 ? { files: (await listInstructionFiles(project.root, doc.path)).files.map((f) => f.path) } : {};
+    const files = doc.kind === "instruction" && at === void 0 ? { files: (await readInstructionFiles(project.root, doc.path)).files } : {};
     return { id, kind: doc.kind, path: doc.path, title: doc.title, text: await view.read(doc.path), references, referencedBy, ...files };
   }));
   const named = (r) => r.id ? r.id + " " + (r.title ?? "(" + t2("docs.missing") + ")") : r.title + " <" + r.url + ">";
@@ -28502,7 +29481,7 @@ async function showDocuments(project, ids, at, kinds, otherResource) {
     d.text.replace(/\n$/, ""),
     ...section("-- " + t2("docs.references"), d.references.map(named)),
     ...section("-- " + t2("docs.referencedBy"), d.referencedBy.map(named)),
-    ...section("-- " + t2("docs.files"), d.files ?? [])
+    ...section("-- " + t2("docs.files"), (d.files ?? []).map(fileLine))
   ].join("\n"));
   return { json: { ...at ? { commit: at } : {}, documents: shown }, text: blocks.join("\n\n") + "\n" };
 }
@@ -28576,32 +29555,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);
-}
-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(",");
@@ -28620,69 +29573,36 @@ function selected(rows, fields2) {
     text: rows.length ? text2(rows.map((row) => fields2.map((f) => cell(row[f])).join("	"))) : ""
   };
 }
+function paginate(rows, keyOf, options) {
+  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) {
+  if (format2 === "text" && lines.length) process.stderr.write(lines.join("\n") + "\n");
+  return "";
+}
 
 // src/commands/specs.ts
 var specKinds = ["feature", "requirement", "design"];
 var specSorts = ["order", "title", "updated"];
-var columns = ["id", "kind", "feature", "path", "title", "description", "order", "draft", "requirements", "sources", "designs", "updated", "line"];
+var columns = ["id", "kind", "feature", "path", "title", "description", "order", "draft", "state", "previousPath", "requirements", "sources", "designs", "updated", "line"];
 var kindLabel = { feature: () => t2("docs.feature"), requirement: () => t2("docs.requirement"), design: () => t2("docs.design") };
 var runSpecsList = (options) => runCommand("specs", options.format, async () => {
   const fields2 = checkFields(options.fields, columns);
   const project = await openProject(process.cwd());
-  const { documents, problems } = await project.cache.documents.list();
-  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 } : {},
-    ...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 shown = options.limit === void 0 ? rows : rows.slice(0, options.limit);
-  const orphans = options.feature === void 0 ? arranged.orphans : [];
+  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: listed3.unit };
   if (fields2) {
     const picked = selected(shown, fields2);
-    return { json: { documents: picked.json, orphans, problems }, text: picked.text };
+    return { json: { documents: picked.json, orphans, problems, page: paging }, text: picked.text + aside(options.format, more) };
   }
   const refName = (r) => r.id + " " + (r.title ?? "(" + t2("docs.missing") + ")");
   const excerpt = (row) => row.line ? ["  " + row.line] : [];
@@ -28691,29 +29611,30 @@ var runSpecsList = (options) => runCommand("specs", options.format, async () =>
     for (const f of features) {
       const own2 = shown.filter((r) => r.feature === f.index.feature);
       if (!own2.length) continue;
-      out.push(`[${t2("docs.feature")}] ${f.index.id} ${f.index.title}${draftMark(f.index)} (${f.index.feature}) \u2014 ${f.index.description}`);
+      out.push(`[${t2("docs.feature")}] ${f.index.id} ${f.index.title}${draftMark(f.index)}${stateMark(states.state(f.index.id))} (${f.index.feature}) \u2014 ${f.index.description}`);
       const index = own2.find((r) => r.kind === "feature");
       if (index) out.push(...excerpt(index));
-      const requirement2 = (r) => [`${r.order} ${line(byId.get(r.id))}`, ...excerpt(r)];
+      const requirement2 = (r) => [`${r.order} ${line(byId.get(r.id))}${stateMark(r.state)}`, ...excerpt(r)];
       out.push(...section("  " + t2("docs.requirements"), own2.filter((r) => r.kind === "requirement").flatMap(requirement2), "    "));
       const designs = own2.filter((r) => r.kind === "design").flatMap((r) => {
         const refs = r.requirements.length ? " [" + r.requirements.map(refName).join(", ") + "]" : "";
         const notes = r.sources.map((s) => "id" in s ? refName(s) : s.title);
-        return [`${r.order} ${line(byId.get(r.id))}${refs}`, ...notes.length ? [" ".repeat(String(r.order).length + 1) + t2("docs.sources") + ": " + notes.join(", ")] : [], ...excerpt(r)];
+        return [`${r.order} ${line(byId.get(r.id))}${stateMark(r.state)}${refs}`, ...notes.length ? [" ".repeat(String(r.order).length + 1) + t2("docs.sources") + ": " + notes.join(", ")] : [], ...excerpt(r)];
       });
       out.push(...section("  " + t2("docs.designs"), designs, "    "));
     }
   } else {
     for (const r of shown) {
       const when = r.updated ? ` \xB7 ${r.updated.date.slice(0, 10)} ${r.updated.author}` : "";
-      out.push(`${r.id} ${r.title}${draftMark(r)} (${kindLabel[r.kind]()} \xB7 ${r.feature}) \u2014 ${r.description}${when}`, ...excerpt(r));
+      out.push(`${r.id} ${r.title}${draftMark(r)}${stateMark(r.state)} (${kindLabel[r.kind]()} \xB7 ${r.feature}) \u2014 ${r.description}${when}`, ...excerpt(r));
     }
   }
   const filtered = options.type !== void 0 || options.feature !== void 0 || options.withoutDesign || options.uncovered || options.draft || options.changedSince !== void 0 || options.author !== void 0 || options.q !== void 0;
   if (!out.length) out.push(filtered ? t2("docs.noMatch") : t2("docs.empty"));
+  out.push(...more);
   if (orphans.length) out.push(t2("docs.orphans", { folders: orphans.join(", ") }));
   if (problems.length) out.push(t2("docs.unreadable", { count: problems.length }));
-  return { json: { documents: shown, orphans, problems }, text: text2(out) };
+  return { json: { documents: shown, orphans, problems, page: paging }, text: text2(out) };
 });
 var runSpecsShow = (ids, options) => runCommand("specs", options.format, async () => {
   const project = await openProject(process.cwd());
@@ -28722,24 +29643,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 lstat10 } from "node:fs/promises";
-import { join as join15 } from "node:path";
-var instructionSorts = ["name", "updated"];
-var columns2 = ["id", "name", "path", "title", "description", "draft", "files", "updated", "line"];
+// src/queries/instructions.ts
+import { lstat as lstat12 } from "node:fs/promises";
+import { join as join17 } 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 { documents, problems } = await project.cache.documents.list();
-  const agents2 = { path: AGENTS, exists: !!(await lstat10(join15(project.root, AGENTS)).catch(() => void 0))?.isFile() };
-  const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!fields2?.includes("updated");
+async function listInstructions(source2, options, request) {
+  const listed3 = await source2.cache.documents.list();
+  const problems = listed3.problems;
+  const states = await documentStates(source2, listed3.documents);
+  const documents = states.documents;
+  const agents2 = { path: AGENTS, exists: !!(await lstat12(join17(source2.root, AGENTS)).catch(() => void 0))?.isFile() };
+  const 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 });
@@ -28751,35 +29671,60 @@ 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) => ({
-    id: d.id,
-    name: d.name,
-    path: d.path,
-    title: d.title,
-    description: d.description,
-    ...d.draft ? { draft: true } : {},
-    files: (await listInstructionFiles(project.root, d.path)).files.length,
-    ...historyNeeded ? { updated: latest.get(d.id) ?? null } : {},
-    ...matched ? { line: matched.get(d.id) } : {}
-  })));
+  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(source2.root, d.path);
+    return {
+      id: d.id,
+      name: d.name,
+      path: d.path,
+      title: d.title,
+      description: d.description,
+      ...d.draft ? { draft: true } : {},
+      state: state2,
+      ...states.previousPath(d.id) ? { previousPath: states.previousPath(d.id) } : {},
+      files,
+      ...limited ? { filesLimited: true } : {},
+      ...historyNeeded ? { updated: latest.get(d.id) ?? null } : {},
+      ...matched ? { line: matched.get(d.id) } : {}
+    };
+  }));
   if (options.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
-  const shown = options.limit === void 0 ? rows : rows.slice(0, options.limit);
+  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 + "/"));
   if (fields2) {
     const picked = selected(shown, fields2);
-    return { json: { agents: agents2, instructions: picked.json, problems: unreadable2 }, text: picked.text };
+    return {
+      json: { agents: agents2, instructions: picked.json, problems: unreadable2, page: paging },
+      text: selected(shown.map((r) => ({ ...r, files: r.files.map((f) => f.path) })), fields2).text + aside(options.format, pageLine(page))
+    };
   }
   const out = [agents2.exists ? t2("instructions.agents") : t2("instructions.noAgents")];
   for (const r of shown) {
-    const files = r.files ? " \xB7 " + t2("instructions.files", { count: r.files }) : "";
     const when = r.updated ? ` \xB7 ${r.updated.date.slice(0, 10)} ${r.updated.author}` : "";
-    out.push(`${r.id} ${r.title}${draftMark(r)} (${r.name}) \u2014 ${r.description}${files}${when}`, ...r.line ? ["  " + r.line] : []);
+    out.push(`${r.id} ${r.title}${draftMark(r)}${stateMark(r.state)} (${r.name}) \u2014 ${r.description}${when}`, ...r.line ? ["  " + r.line] : []);
+    out.push(...r.files.map((f) => "  " + fileLine(f)), ...r.filesLimited ? ["  " + t2("instructions.filesLimited", { count: r.files.length })] : []);
   }
   if (!shown.length) out.push(options.q !== void 0 || options.author !== void 0 ? t2("docs.noMatch") : t2("instructions.empty"));
+  out.push(...pageLine(page));
   if (unreadable2.length) out.push(t2("docs.unreadable", { count: unreadable2.length }));
-  return { json: { agents: agents2, instructions: shown, problems: unreadable2 }, text: text2(out) };
+  return { json: { agents: agents2, instructions: shown, problems: unreadable2, page: paging }, text: text2(out) };
 });
 async function resolveInstructions(project, targets, at) {
   const view = at === void 0 ? await working(project) : await committed(project, at);
@@ -28805,9 +29750,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 lstat11, readdir as readdir6 } from "node:fs/promises";
-import { join as join16 } from "node:path";
-var info2 = async (path3) => lstat11(path3).catch((e) => {
+import { lstat as lstat13, readdir as readdir6 } from "node:fs/promises";
+import { join as join18 } from "node:path";
+var info2 = async (path3) => lstat13(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -28815,11 +29760,11 @@ var posix = (path3) => path3.split("\\").join("/");
 async function listAssets(root) {
   const out = [];
   async function visit2(relative, depth) {
-    const stat3 = await info2(join16(root, relative));
+    const stat3 = await info2(join18(root, relative));
     if (!stat3 || stat3.isSymbolicLink()) return;
     if (stat3.isDirectory()) {
       if (depth > 8 || out.length > 4e3) return;
-      for (const name2 of (await readdir6(join16(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
+      for (const name2 of (await readdir6(join18(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);
@@ -28828,7 +29773,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(join16(root, ...target.split("/"))))?.isFile()) existing.add(target);
+  for (const target of outside) if ((await info2(join18(root, ...target.split("/"))))?.isFile()) existing.add(target);
   return documentWarnings(documents, await listAssets(root), existing);
 }
 
@@ -28852,30 +29797,30 @@ 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 open4, readFile as readFile16, rename as rename3, rmdir, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { mkdir as mkdir6, open as open5, readFile as readFile16, rename as rename3, rmdir, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 
 // src/adapters/filesystem/agent-inputs.ts
-import { createHash as createHash3, randomBytes as randomBytes2 } from "node:crypto";
-import { lstat as lstat12, mkdir as mkdir5, readdir as readdir7, realpath as realpath3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { createHash as createHash4, randomBytes as randomBytes2 } from "node:crypto";
+import { lstat as lstat14, mkdir as mkdir5, readdir as readdir7, realpath as realpath3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, dirname as dirname2, join as join17 } from "node:path";
+import { basename, dirname as dirname2, join as join19 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
-var info3 = (path3) => lstat12(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 = createHash3("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
-  return { system: join17((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join17(root, ".gitifact", "tmp") };
+  const key = createHash4("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
+  return { system: join19((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join19(root, ".gitifact", "tmp") };
 }
 async function writable(directory) {
   try {
     await mkdir5(directory, { recursive: true });
     const stat3 = await info3(directory);
     if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
-    const probe = join17(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    const probe = join19(directory, ".probe-" + randomBytes2(8).toString("hex"));
     await writeFile3(probe, "", { flag: "wx" });
     await unlink3(probe);
     return true;
@@ -28889,7 +29834,7 @@ async function prepareAgentInputs(root, controls = {}) {
   if (await writable(system)) directory = system;
   else if (await writable(project)) {
     directory = project;
-    await writeFile3(join17(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+    await writeFile3(join19(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
@@ -28897,10 +29842,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(join17(directory, name2)).catch(() => void 0);
-    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join17(directory, name2)).catch(() => void 0);
+    const stat3 = await info3(join19(directory, name2)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join19(directory, name2)).catch(() => void 0);
   }
-  return { commit: join17(directory, "commit.json") };
+  return { commit: join19(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
@@ -28921,18 +29866,18 @@ async function discardAgentInput(root, file2, controls = {}) {
 }
 
 // src/commands/commit-files.ts
-import { createHash as createHash4 } from "node:crypto";
-import { lstat as lstat13, readFile as readFile14 } from "node:fs/promises";
-import { join as join18 } from "node:path";
+import { createHash as createHash5 } from "node:crypto";
+import { lstat as lstat15, readFile as readFile14 } from "node:fs/promises";
+import { join as join20 } from "node:path";
 var fail3 = (message) => {
   throw new CommandError("INVALID_COMMIT", message);
 };
-var hash2 = (value) => createHash4("sha256").update(value).digest("hex");
+var hash2 = (value) => createHash5("sha256").update(value).digest("hex");
 var optional2 = (path3) => readFile14(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info4 = (path3) => lstat13(path3).catch((e) => {
+var info4 = (path3) => lstat15(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -28958,11 +29903,11 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join18(root, ...parts.slice(0, i));
+    const target = join20(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(join18(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info4(join20(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)]));
@@ -29029,18 +29974,12 @@ async function readStdin(stream) {
 var fields = ["paths", "message", "authorization", "migration"];
 var integration = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"];
 var MIGRATION_TARGET = "0.8.0";
+var PATH_LIMIT = 128;
+var MIGRATION_PATH_LIMIT = 5e3;
 var same2 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 var problemLines2 = (problems) => problems.map((p) => "  " + p.code + " " + p.message);
 var underDocuments = (path3) => path3.startsWith(SPEC_ROOT + "/") || path3.startsWith(WIKI_ROOT + "/") || path3 === HISTORY_PATH;
-async function pendingChanges(project, head) {
-  const headFiles = head ? await project.cache.history.filesAt(head) : /* @__PURE__ */ new Map();
-  const [working2, records2] = await Promise.all([project.cache.documents.files(), project.pendingRecords()]);
-  return { headFiles, working: working2, records: records2, ...compareDocumentSets(headFiles, working2.files) };
-}
-var uncovered = (changes2, records2) => {
-  const covered = new Set(records2.flatMap((r) => r.docs));
-  return changes2.filter((c) => c.types.some((type) => type !== "created") && !covered.has(c.id)).map((c) => c.id);
-};
+var pendingChanges = (project, head) => workingChanges(project, head);
 var shared = (changes2, records2) => changes2.map((c) => c.id).filter((id) => records2.filter((r) => r.docs.includes(id)).length > 1);
 var changeLine = (c) => `${c.types.join(",").padEnd(9)} ${c.id} ${c.title} \u2014 ${c.path}${c.previousPath ? " (\u2190 " + c.previousPath + ")" : ""}`;
 var recordLine = (r, changes2) => {
@@ -29087,7 +30026,7 @@ var runChangesCommit = (options, controls = {}) => runCommand("changes", options
 async function commitChanges(cwd, input2, dryRun) {
   const request = object3(input2);
   if (Object.keys(request).some((k) => !fields.includes(k))) fail3(t2("commit.unknownField"));
-  const selected2 = paths(request.paths);
+  const selected2 = paths(request.paths, request.migration === true ? MIGRATION_PATH_LIMIT : PATH_LIMIT);
   const authorization = object3(request.authorization);
   if (Object.keys(authorization).sort().join(",") !== "basis,evidence" || !["user-request", "project-policy"].includes(String(authorization.basis))) fail3(t2("commit.authorizationRequired"));
   text3(authorization.evidence, 2e3);
@@ -29118,7 +30057,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 = join19(gitDir, "gitifact-changes-commit.lock");
+  const busy = join21(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));
@@ -29157,7 +30096,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 = join19(gitDir, "gitifact-commit-index-" + randomUUID5());
+  const temporary = join21(gitDir, "gitifact-commit-index-" + randomUUID5());
   let owned = false;
   let uncertain = false;
   let commitStarted = false;
@@ -29171,16 +30110,16 @@ async function commitChanges(cwd, input2, dryRun) {
       if (e.code === "EEXIST") fail3(t2("commit.busy", { path: busy }));
       throw e;
     }
-    const lock = indexLock = await open4(indexPath + ".lock", "wx", 384);
+    const lock = indexLock = await open5(indexPath + ".lock", "wx", 384);
     const original = await optional2(indexPath);
     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(join19(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
+    await writeFile4(join21(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" });
     else await git(["read-tree", "--empty"], temporary);
-    await git(["add", "--", ...stageable], 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);
@@ -29193,18 +30132,18 @@ async function commitChanges(cwd, input2, dryRun) {
         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(join19(root, path3));
+        const file2 = await readFile16(join21(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(join19(gitDir, name2))) fail3(t2("commit.integrationStarted"));
+    for (const name2 of integration) if (await info4(join21(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;
-    await git(["commit", "-m", message.trim() + (trailers.length ? "\n\n" + trailers.join("\n") : "")], temporary);
+    await git(["commit", "-F", "-"], temporary, Buffer.from(message.trim() + (trailers.length ? "\n\n" + trailers.join("\n") : "") + "\n"));
     const after = await project.reader.baseline();
     if (!after.head) return fail3(t2("commit.resultUnknown"));
     const raw = (await git(["cat-file", "commit", after.head])).toString("utf8");
@@ -29240,7 +30179,7 @@ async function commitChanges(cwd, input2, dryRun) {
       await unlink4(temporary).catch(() => {
       });
       if (owned) {
-        await unlink4(join19(busy, "recovery.json")).catch(() => {
+        await unlink4(join21(busy, "recovery.json")).catch(() => {
         });
         await rmdir(busy);
       }
@@ -29251,7 +30190,7 @@ async function commitChanges(cwd, input2, dryRun) {
 
 // src/commands/records.ts
 import { readFile as readFile17 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { join as join22 } 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))];
@@ -29287,7 +30226,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(join20(project.root, ...path3.split("/")), "utf8");
+    const source2 = await readFile17(join22(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 };
@@ -29312,18 +30251,17 @@ var runRecordsList = (options) => runCommand("records", options.format, async ()
   const fields2 = checkFields(options.fields, options.doc === void 0 ? recordColumns : eventColumns);
   const project = await openProject(process.cwd());
   const head = await project.head();
-  const after = await since(project, options.since, head);
-  const by = byAuthor(options.author);
-  const has = contains(options.q);
-  const limit = (rows2) => options.limit === void 0 ? rows2 : rows2.slice(0, options.limit);
   const sectionText = (sections2) => sections2.map((s) => s.body);
   if (options.doc !== void 0) {
+    const after = await since(project, options.since, head);
+    const by = byAuthor(options.author);
+    const has2 = contains(options.q);
     const id = options.doc;
     const events = head ? await project.cache.history.ofDocument(head, id) : [];
     const { documents } = await project.cache.documents.list();
     const title = documents.find((d) => d.id === id)?.title ?? events.map((e) => (e.after ?? e.before)?.title).find(Boolean) ?? null;
     if (!title && !events.length) throw new CommandError("UNKNOWN_DOCUMENT", t2("docs.unknownDocument", { ids: id }));
-    const rows2 = limit(events.filter((e) => after(e) && by(e) && has(e.message, ...e.records.flatMap((r) => [r.title, ...sectionText(r.sections)]))).map((e) => ({
+    const page = paginate(events.filter((e) => after(e) && by(e) && has2(e.message, ...e.records.flatMap((r) => [r.title, ...sectionText(r.sections)]))).map((e) => ({
       commit: e.commit,
       date: e.date,
       author: e.author,
@@ -29332,10 +30270,13 @@ var runRecordsList = (options) => runCommand("records", options.format, async ()
       types: e.types,
       path: (e.after ?? e.before)?.path ?? null,
       records: e.records
-    })));
+    })), (e) => e.commit, options);
+    const rows2 = page.rows;
+    const paging2 = { total: page.total, next: page.next, unit: "commit" };
+    const more2 = pageLine(page, 0, t2("list.commits"));
     if (fields2) {
       const picked = selected(rows2, fields2);
-      return { json: { doc: { id, title }, events: picked.json }, text: picked.text };
+      return { json: { doc: { id, title }, events: picked.json, page: paging2 }, text: picked.text + aside(options.format, more2) };
     }
     const out2 = [`${id} ${title ?? ""}`.trimEnd()];
     for (const e of rows2) {
@@ -29348,20 +30289,35 @@ var runRecordsList = (options) => runCommand("records", options.format, async ()
       out2.push("  " + t2("docs.commit") + ": " + e.message);
     }
     if (!rows2.length) out2.push(events.length ? t2("docs.noMatch") : t2("docs.noHistory"));
-    return { json: { doc: { id, title }, events: rows2 }, text: text2(out2) };
+    if (more2.length) out2.push("", ...more2);
+    return { json: { doc: { id, title }, events: rows2, page: paging2 }, text: text2(out2) };
   }
-  const pending = options.author !== void 0 ? [] : [...(await project.pendingRecords()).files].flatMap(([path3, source2]) => {
+  const has = contains(options.q);
+  const pending = (options.author !== void 0 ? [] : [...(await project.pendingRecords()).files].flatMap(([path3, source2]) => {
     try {
       return [parseRecordFile(path3, source2)];
     } catch {
       return [];
     }
-  }).map((r) => ({ id: r.id, title: r.title, commit: null, date: null, author: null, docs: r.docs, sections: r.sections.map((s) => ({ key: s.key, body: s.body })) }));
-  const committed2 = (head ? await project.cache.history.recordsOf(head) : []).filter((r) => after(r) && by(r) && has(r.title, r.message, ...sectionText(r.sections))).map((r) => ({ id: r.id, title: r.title, commit: r.commit, date: r.date, author: r.author, docs: r.docs, sections: r.sections }));
-  const rows = limit([...pending.filter((r) => has(r.title, ...sectionText(r.sections))).sort((a, b) => a.id < b.id ? -1 : 1), ...committed2]);
+  }).map((r) => ({ id: r.id, title: r.title, commit: null, date: null, author: null, docs: r.docs, sections: r.sections.map((s) => ({ key: s.key, body: s.body })) }))).filter((r) => has(r.title, ...sectionText(r.sections))).sort((a, b) => a.id < b.id ? -1 : 1);
+  const size = options.all ? void 0 : options.limit ?? PAGE_SIZE;
+  const inPending = options.after === void 0 ? 0 : pending.findIndex((r) => r.id === options.after) + 1;
+  const afterCommitted = options.after !== void 0 && !inPending ? options.after : void 0;
+  const pendingShown = afterCommitted !== void 0 ? [] : pending.slice(inPending, size === void 0 ? void 0 : inPending + size);
+  const filter = { author: options.author, q: options.q, ...await sinceRange(project, options.since, head) };
+  const room = size === void 0 ? void 0 : size - pendingShown.length;
+  const found = head ? await project.cache.history.records(head, filter, afterCommitted, room) : { records: [], total: 0 };
+  if (!found) throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after }));
+  const committed2 = found.records.map((r) => ({ id: r.id, title: r.title, commit: r.commit, date: r.date, author: r.author, docs: r.docs, sections: r.sections }));
+  const rows = [...pendingShown, ...committed2];
+  const total = pending.length + found.total;
+  const before = afterCommitted === void 0 ? inPending : pending.length + await readThrough(project, head, filter, afterCommitted);
+  const next = before + rows.length < total && rows.length ? rows[rows.length - 1].id : null;
+  const paging = { total, next, unit: "record" };
+  const more = pageLine({ rows, total, next }, before, t2("list.records"));
   if (fields2) {
     const picked = selected(rows, fields2);
-    return { json: { records: picked.json }, text: picked.text };
+    return { json: { records: picked.json, page: paging }, text: picked.text + aside(options.format, more) };
   }
   const docs = (ids) => ids.slice(0, 5).join(", ") + (ids.length > 5 ? " " + t2("records.moreDocs", { count: ids.length - 5 }) : "");
   const out = rows.flatMap((r) => [
@@ -29369,13 +30325,18 @@ var runRecordsList = (options) => runCommand("records", options.format, async ()
     `  ${r.commit ? `${r.date.slice(0, 10)} ${r.commit.slice(0, 7)} ${r.author}` : t2("records.uncommitted")} \xB7 ${docs(r.docs)}`
   ]);
   const filtered = options.since !== void 0 || options.author !== void 0 || options.q !== void 0;
-  return { json: { records: rows }, text: text2(out.length ? out : [filtered ? t2("docs.noMatch") : t2("records.empty")]) };
+  return { json: { records: rows, page: paging }, text: text2(out.length ? [...out, ...more] : [filtered ? t2("docs.noMatch") : t2("records.empty")]) };
 });
+async function readThrough(project, head, filter, id) {
+  if (!head) return 0;
+  const all = await project.cache.history.records(head, filter, void 0, void 0);
+  return (all?.records.findIndex((r) => r.id === id) ?? -1) + 1;
+}
 
 // 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 join21 } from "node:path";
+import { dirname as dirname3, join as join23 } from "node:path";
 
 // src/adapters/github/issue.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -29442,7 +30403,7 @@ function parseFeedback(input2) {
 }
 async function schemaVersion(from) {
   for (let folder = from; ; folder = dirname3(folder)) {
-    const config2 = await readFile18(join21(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
+    const config2 = await readFile18(join23(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
     if (config2 !== void 0) {
       try {
         const value = JSON.parse(config2).schemaVersion;
@@ -29520,7 +30481,7 @@ function agentDocsGit(root, inherited = process.env) {
 
 // src/commands/update.ts
 var blockCommitMessage = (version2) => "chore(gitifact): refresh GITIFACT block to v" + version2;
-var commitState = (state, extra = {}) => ({ state, commit: null, paths: [], message: null, reason: null, detail: null, ...extra });
+var commitState = (state2, extra = {}) => ({ state: state2, commit: null, paths: [], message: null, reason: null, detail: null, ...extra });
 async function refreshBlocks(cwd, version2, env, controls) {
   const repo = initRepository(cwd, env);
   let first;
@@ -29650,10 +30611,10 @@ async function runUpdateCheck(format2, version2) {
     process.stdout.write(JSON.stringify(dto) + "\n");
     return;
   }
-  const state = dto.update;
+  const state2 = dto.update;
   const lines = [
     t2("update.text.current", { version: dto.cliVersion }),
-    state.status === "available" ? t2("update.text.available", { version: state.latestVersion }) : state.status === "up-to-date" ? t2("update.text.upToDate") : state.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable")
+    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 }));
   process.stdout.write(lines.join("\n") + "\n");
@@ -29668,15 +30629,15 @@ 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.0").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.2").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 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.0"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.0"));
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).action((options) => options.check ? runUpdateCheck(options.format, "0.8.0") : runUpdate(options, "0.8.0"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.2"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.2"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).action((options) => options.check ? runUpdateCheck(options.format, "0.8.2") : runUpdate(options, "0.8.2"));
 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]));
-  return command.option("--limit <n>", t2("help.listLimit"), parseLimit).option("--fields <names>", t2("help.listFields"), parseFields).addOption(format());
+  return command.addOption(new Option("--limit <n>", t2("help.listLimit")).argParser(parseLimit).conflicts("all")).option("--all", t2("help.listAll")).option("--after <cursor>", t2("help.listAfter")).option("--fields <names>", t2("help.listFields"), parseFields).addOption(format());
 };
 var specs = program2.command("specs").description(t2("help.specs"));
 listed2(specs.command("list").description(t2("help.specsList")).addOption(new Option("--type <kind>", t2("help.specsListType")).choices([...specKinds])).option("--feature <folder>", t2("help.specsListFeature")).option("--without-design", t2("help.specsListWithoutDesign")).option("--uncovered", t2("help.specsListUncovered")).option("--draft", t2("help.specsListDraft")).option("--changed-since <date|commit>", t2("help.specsListChangedSince")), specSorts).action((o) => runSpecsList(o));
@@ -29694,7 +30655,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.0"));
+program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.2"));
 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));