gitifact 0.8.0 → 0.8.1

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,11 +10402,11 @@ 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;
 }
@@ -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;
         }
@@ -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,13 +25064,14 @@ 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({
+var browserSpecsV7 = external_exports.strictObject({
   contract: external_exports.literal("browser-specs"),
-  version: external_exports.literal(6),
+  version: external_exports.literal(7),
   sessionId: external_exports.string(),
   head: oid2.nullable(),
   observedAt: external_exports.string(),
   working: external_exports.boolean(),
+  stamp: external_exports.string(),
   features: external_exports.array(feature),
   instructions: external_exports.array(instruction),
   agents: agents.nullable(),
@@ -25090,14 +25111,15 @@ 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({
@@ -25131,10 +25153,10 @@ var browserSearchV2 = external_exports.strictObject({
 });
 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(),
@@ -25176,9 +25198,9 @@ var browserCommitFileV1 = external_exports.strictObject({
 });
 var browserCommitFilesQueryV1 = external_exports.strictObject({ commit: oid2 });
 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,9 +25208,21 @@ 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 browserCommitQueryV2 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(200).optional(), limit: count(500).pipe(external_exports.number().min(1)).optional() });
+var 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 browserCommitQueryV1 = external_exports.strictObject({ commit: oid2 });
+var browserCommitChangeQueryV1 = external_exports.strictObject({ commit: oid2, id: external_exports.string().min(1).max(100) });
 var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
 var browserRecordV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-record"),
@@ -25210,6 +25244,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 +25298,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 +25313,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 +25505,8 @@ var messages_default3 = {
   "server.sessionChanged": "\uC11C\uBC84 \uC138\uC158\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC5F0\uACB0\uD558\uC138\uC694.",
   "server.badRange": "\uC870\uD68C \uBC94\uC704\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "server.commitNotFound": "\uC774 \uC800\uC7A5\uC18C\uC5D0 \uADF8 \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "server.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 +25550,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.",
@@ -25534,7 +25594,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 +25621,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 +25707,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 +25720,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 +25809,8 @@ var messages_default4 = {
   "server.sessionChanged": "The server session changed. Reconnect to continue.",
   "server.badRange": "Check the requested range.",
   "server.commitNotFound": "This repository has no such commit.",
+  "server.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 +25854,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.",
@@ -25824,7 +25898,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 +25925,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 +26011,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 +26024,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 +26154,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 +26414,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 = 9;
 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,13 +26429,17 @@ 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);
@@ -26377,6 +26466,10 @@ function prepare(db) {
     db.exec("ROLLBACK");
     throw error62;
   }
+  try {
+    db.exec("VACUUM");
+  } catch {
+  }
 }
 function createCacheDatabase(root) {
   let path3;
@@ -26472,24 +26565,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 +26605,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 +26622,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 +26681,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 };
     },
@@ -26866,7 +26953,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 +27039,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,8 +27092,10 @@ 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 sideOf3 = (snapshot5, rev) => !snapshot5 ? null : rev ? { rev, path: snapshot5.path } : snapshot5;
 var titleOf = (e) => (e.after ?? e.before)?.title ?? e.id;
 var DAY = 864e5;
 var KEPT_HEADS = 4;
@@ -27003,11 +27108,15 @@ function createHistory(database, git) {
   function insert(db, commits, readers) {
     const commit = db.prepare("INSERT OR IGNORE INTO commits (oid, reader) VALUES (?, ?)");
     const change2 = db.prepare("INSERT OR IGNORE INTO changes (key, oid, ord, id, kind, types, email, date, before_spec, after_spec, needle, row, detail) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)");
+    const record4 = db.prepare("INSERT OR IGNORE INTO records (oid, id, title, sections) VALUES (?, ?, ?, ?)");
     const search = db.prepare("INSERT INTO search (scope, kind, ref, oid, payload, title, place, body) VALUES (?,?,?,?,?,?,?,?)");
     transaction(db, () => {
       for (const c of commits) {
         if (!Number(commit.run(c.commit, readers.get(c.commit) ?? "current").changes)) continue;
         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,8 +27129,8 @@ 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 })
+            JSON.stringify(row),
+            JSON.stringify(detail)
           );
           const line2 = e.records.length ? e.records.map((r) => [r.title, ...r.sections.map((s) => s.body)].join(" ")).join(" \xB7 ") : e.message;
           const where2 = e.commit.slice(0, 7) + " \xB7 " + e.author;
@@ -27048,6 +27157,7 @@ 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 records WHERE oid = ?").run(oid3);
         db.prepare("DELETE FROM search WHERE scope = 'history' AND oid = ?").run(oid3);
       }
     }));
@@ -27078,6 +27188,39 @@ 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 read = await changes2.of([commit]).catch(() => void 0);
+    if (read) await database.with((db) => insert(db, read, /* @__PURE__ */ new Map()));
+  }
+  function hydrate(db, rows) {
+    const events = rows.map((row) => JSON.parse(row));
+    const read = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?");
+    const byCommit = /* @__PURE__ */ new Map();
+    for (const e of events) if (e.records.length && !byCommit.has(e.commit)) {
+      byCommit.set(e.commit, new Map(read.all(e.commit).map((r) => [r.id, { id: r.id, title: r.title, sections: JSON.parse(r.sections) }])));
+    }
+    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 read = places.length ? await changes2.sides(places) : [];
+    const text4 = new Map(places.map((p, i) => [p.rev + ":" + p.path, read[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 = [];
@@ -27107,21 +27250,55 @@ function createHistory(database, git) {
     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) {
+    /**
+     * 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. */
+    async commitChanges(commit, after, limit) {
+      await readCommit(commit);
+      return database.with((db) => {
+        const all = db.prepare("SELECT key, row FROM changes WHERE oid = ? ORDER BY ord").all(commit);
+        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 +27307,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) {
@@ -27163,7 +27375,7 @@ function createHistory(database, git) {
         const recent = 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 };
       });
@@ -27171,19 +27383,7 @@ function createHistory(database, git) {
     /** The commit of `head`'s history that added a record, found through the records its changes carry. */
     async commitOfRecord(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) => db.prepare("SELECT l.oid AS oid FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = ? AND r.id = ? ORDER BY l.pos LIMIT 1").get(head, id)?.oid);
     },
     /**
      * Documents whose title, place or text holds the query — a title match before a place match before a text match —
@@ -27242,28 +27442,89 @@ function openCache(root, git) {
   };
 }
 
-// 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";
+// src/adapters/git/pending-records.ts
+import { lstat as lstat3, readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
 import { join as join4 } from "node:path";
+var decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+var info = (path3) => lstat3(path3).catch((error62) => {
+  if (error62.code === "ENOENT") return void 0;
+  throw error62;
+});
+async function recordFolders(root) {
+  return (await readdir3(join4(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
+    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(join4(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 = join4(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(join4(root, ...other.split("/"))))?.isFile()) problems.push(docProblem("DUPLICATE_RECORD_ID", path3, { id, other }));
+    }
+  }
+  return { files, altered: altered.sort(), problems };
+}
+
+// src/adapters/filesystem/config-file.ts
+import { lstat as lstat4, readFile as readFile4, realpath, mkdir as mkdir2, open as open2, link, rename, unlink } from "node:fs/promises";
+import { join as join5 } from "node:path";
 import { randomUUID as randomUUID2 } from "node:crypto";
 var missing = (error62) => error62.code === "ENOENT";
-var fileInfo = (path3) => lstat3(path3).catch((error62) => {
+var fileInfo = (path3) => lstat4(path3).catch((error62) => {
   if (missing(error62)) return void 0;
   throw error62;
 });
 async function configDirectory(root) {
-  const path3 = join4(root, ".gitifact");
+  const path3 = join5(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 = join5(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 +27537,7 @@ async function readConfigFile(root) {
   }
 }
 async function publishConfig(root, text4, recheck, beforePublish, replace = false) {
-  const directory = join4(root, ".gitifact");
+  const directory = join5(root, ".gitifact");
   await configDirectory(root);
   await mkdir2(directory).catch((error62) => {
     if (error62.code !== "EEXIST") throw error62;
@@ -27289,7 +27550,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 = join5(directory, ".init-" + randomUUID2() + ".tmp");
   const handle = await open2(temporary, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -27303,11 +27564,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, join5(directory, "config.json"));
+    else await link(temporary, join5(directory, "config.json"));
   } finally {
     await unchanged();
     const current2 = await fileInfo(temporary);
@@ -27316,42 +27577,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 lstat5, open as open3, readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
+import { join as join6 } 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 folderOf2 = (root, instructionPath) => join6(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(join6(folder, entry2.name), path3 + "/", depth + 1);
+      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat5(join6(folder, entry2.name))).size });
     }
   }
   await visit2(folderOf2(root, instructionPath), "", 0);
   return { files, limited };
 }
+var FRONTMATTER_WINDOW = 8 * 1024;
+async function describeFiles(root, instructionPath, files) {
+  const folder = folderOf2(root, instructionPath);
+  return Promise.all(files.map(async (file2) => {
+    if (!isInstructionReference(file2.path)) return file2;
+    let handle;
+    try {
+      handle = await open3(join6(folder, ...file2.path.split("/")), "r");
+      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);
   for (const [index, part] of parts.entries()) {
-    full = join5(full, part);
-    const info5 = await lstat4(full).catch(() => void 0);
+    full = join6(full, part);
+    const info5 = await lstat5(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 lstat5(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,20 +27644,108 @@ 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 lstat6, readFile as readFile6 } from "node:fs/promises";
+import { join as join7 } 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 = join7(root, "AGENTS.md");
+  const info5 = await lstat6(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/queries/document-states.ts
+var isDocument = (path3) => {
+  try {
+    return classifyDocPath(path3).type === "doc";
+  } catch {
+    return false;
+  }
+};
+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 lstat7 } from "node:fs/promises";
+import { join as join8 } 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 lstat7(join8(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
 var tally = (people, name2, email3, latest) => {
   const person = people.get(email3);
@@ -27388,7 +27759,12 @@ async function settled(reads) {
   return results.map((r) => r.value);
 }
 var folderOf3 = (path3) => path3.split("/").slice(0, 3).join("/");
-function checkoutDocuments(documents) {
+function checkoutDocuments(states) {
+  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 } : {} };
@@ -27402,7 +27778,8 @@ function checkoutDocuments(documents) {
     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 })),
+    ...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,
@@ -27411,10 +27788,11 @@ function checkoutDocuments(documents) {
       order: d.order,
       body: d.body,
       requirements: d.requirements,
-      sources: d.sources.map(source2)
+      sources: d.sources.map(source2),
+      ...standing2(d.id)
     }))
   }));
-  const instructions2 = arranged.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title, description: k.description, body: k.body }));
+  const instructions2 = arranged.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title, description: k.description, body: k.body, ...standing2(k.id) }));
   return { features, instructions: instructions2, orphans: arranged.orphans };
 }
 function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
@@ -27429,6 +27807,7 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
     return head || null;
   };
   const pending = /* @__PURE__ */ new Map();
+  const readStamp = createStampReader(root, inherited);
   const notMigration = ["-E", "--invert-grep", `--grep=^${MIGRATION_TRAILER}: `];
   async function storeAuthors(head) {
     const text4 = await git(["log", ...notMigration, "--format=%x1e%aN%x00%aE%x00%aI", "-z", "--name-only", "--no-renames", "--max-count=20000", head, "--", ".gitifact/spec", INSTRUCTIONS_ROOT, "AGENTS.md"]);
@@ -27463,6 +27842,7 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
     if (!raw) throw new StoreError(t2("specReader.schemaRequired"));
     parseManagedConfig(raw);
     const head = await readHead();
+    const stamp = await readStamp();
     const [current2, dirty, authors, everyone] = await settled([
       cache.documents.list(),
       head ? git(["status", "--porcelain=v1", "--", ".gitifact/spec", INSTRUCTIONS_ROOT]) : Promise.resolve(""),
@@ -27477,25 +27857,27 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
       if (!name2 || !email3 || !latest) throw new StoreError(t2("specReader.authorUnreadable"));
       tally(people, name2, email3, latest);
     }
-    const arranged = checkoutDocuments(current2.documents);
+    const states = await documentStates({ head: async () => head, reader }, current2.documents);
+    const arranged = checkoutDocuments(states);
     const features = arranged.features.map((feature2) => {
       const entry2 = authors?.folders.get(folderOf3(feature2.path));
       return { ...feature2, contributors: entry2 ? [...entry2.people.values()].sort((a, b) => b.commits - a.commits) : [], updatedAt: entry2?.latest ?? null };
     });
     const instructions2 = await Promise.all(arranged.instructions.map(async (instruction2) => {
-      const { files, limited } = await listInstructionFiles(root, instruction2.path);
+      const { files, limited } = instruction2.state === "deleted" ? { files: [], limited: false } : await readInstructionFiles(root, instruction2.path);
       return { ...instruction2, files, filesLimited: limited, updatedAt: authors?.instructions.get(instruction2.path.split("/").slice(0, 3).join("/")) ?? null };
     }));
     const agentsText = await readAgentsFile(root);
     const agents2 = agentsText === null ? null : { path: "AGENTS.md", body: agentsText, updatedAt: authors?.instructions.get("AGENTS.md") ?? null };
     const problems = [...current2.problems, ...arranged.orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
     if (await readHead() !== head) throw new StoreError(t2("specReader.projectChanged"));
-    const checkout = browserSpecsV6.parse({
+    const checkout = browserSpecsV7.parse({
       contract: "browser-specs",
-      version: 6,
+      version: 7,
       sessionId,
       head,
       observedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      stamp,
       working: head ? !!dirty.trim() : features.length > 0 || instructions2.length > 0,
       features,
       instructions: instructions2,
@@ -27606,30 +27988,108 @@ 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/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 readStamp = createStampReader(root, env);
   const commitFiles = createCommitFiles(git);
+  const working2 = { head: async () => (await git.baseline()).head, cache, pendingRecords: () => readPendingRecords(root, (args) => git.run(args)) };
   const unreadable2 = () => t2("server.specsUnreadable");
+  const cursorGone = () => new HttpError(404, "NOT_FOUND", t2("server.cursorNotFound"));
   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 }));
+    // Whether the screen is behind, asked when the reader comes back to the tab; cheap enough to ask every time.
+    route({ method: "GET", path: "/api/v1/stamp", session: true, unreadable: unreadable2, handle: async () => ok(browserStampV1.parse({ contract: "browser-stamp", version: 1, sessionId, stamp: await readStamp() })) }),
+    route({ method: "GET", path: "/api/v1/history", session: true, query: browserHistoryQueryV4, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = await cache.history.commits(query.head, { kind: query.kind, document: query.document, feature: query.feature, author: query.author, q: query.q }, query.after, query.limit ?? PAGE);
+      if (!page) throw cursorGone();
+      return ok(browserHistoryV6.parse({ contract: "browser-history", version: 6, sessionId, head: query.head, ...page }));
     } }),
     route({ method: "GET", path: "/api/v1/history/summary", session: true, query: browserHistorySummaryQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserHistorySummaryV4.parse({ contract: "browser-history-summary", version: 4, sessionId, head: query.head, ...await cache.history.summary(query.head) })) }),
-    // 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;
+    // One commit as its page reads it: who made it and a page of the documents it changed, even when it changed none.
+    route({ method: "GET", path: "/api/v1/commit", session: true, query: browserCommitQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = await cache.history.commitChanges(query.commit, query.after, query.limit ?? PAGE);
+      if (!page) throw cursorGone();
+      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 }) => {
@@ -27637,6 +28097,13 @@ function recordRoutes(root, sessionId, env) {
       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 }));
     } }),
+    // 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);
@@ -27660,18 +28127,18 @@ function recordRoutes(root, sessionId, env) {
 }
 
 // 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 lstat8, readFile as readFile7 } from "node:fs/promises";
+import { join as join9 } 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 = join9(root, ...assetPath.split("/"));
+      const stat3 = await lstat8(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 +28155,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 +28285,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 join13 } 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 lstat9, readFile as readFile9 } from "node:fs/promises";
+import { join as join10 } from "node:path";
+var markerPresent = (path3) => lstat9(path3).then(() => true, (error62) => {
   if (error62.code === "ENOENT") return false;
   throw error62;
 });
@@ -27842,27 +28309,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(join10(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 +28351,52 @@ function initRepository(cwd, inherited = process.env) {
   };
 }
 
+// src/adapters/filesystem/document-file.ts
+import { randomBytes } from "node:crypto";
+import { lstat as lstat10, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join11 } from "node:path";
+var generateId = (prefix) => prefix + "-" + [...randomBytes(10)].map((n) => "abcdefghijklmnopqrstuvwxyz234567"[n & 31]).join("");
+async function createDocumentFile(root, path3, text4) {
+  const parts = path3.split("/");
+  for (let i = 1; i < parts.length; i++) {
+    const folder = join11(root, ...parts.slice(0, i));
+    const info5 = await lstat10(folder).catch((error62) => {
+      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(join11(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 join12, 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 = join12(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 +28412,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 +28441,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 = join12(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
+  const handle = await open4(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
     try {
@@ -27953,7 +28453,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 +28464,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 +28504,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 +28545,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 +28726,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 +28738,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 +28750,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 +28762,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(join13(root, ".gitifact")).catch((e) => {
       if (e.code === "ENOENT") return [];
       throw e;
     });
@@ -28318,117 +28820,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 join15 } from "node:path";
 
 // src/commands/project.ts
+import { join as join14 } 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(join14(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);
@@ -28461,13 +28879,20 @@ function documentsOf(files) {
 
 // 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 fileLine = (f) => f.title ? `${f.path} ${f.title} \u2014 ${f.description}` : f.path;
 var titledSources = (d, byId) => d.sources.map((s) => "id" in s ? { id: s.id, title: byId.get(s.id)?.title ?? null, ...s.note ? { note: s.note } : {} } : s);
 async function working(project) {
   const { documents } = await project.cache.documents.list();
   return {
     byId: new Map(documents.map((d) => [d.id, d])),
-    read: (path3) => readFile13(join14(project.root, ...path3.split("/")), "utf8"),
+    read: (path3) => readFile13(join15(project.root, ...path3.split("/")), "utf8"),
     referencing: async (id) => [...new Set((await project.cache.documents.referencing(id)).map((r) => r.from))]
   };
 }
@@ -28493,7 +28918,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 +28927,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" };
 }
@@ -28598,6 +29023,22 @@ async function since(project, value, head) {
   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));
@@ -28620,16 +29061,37 @@ function selected(rows, fields2) {
     text: rows.length ? text2(rows.map((row) => fields2.map((f) => cell(row[f])).join("	"))) : ""
   };
 }
+var PAGE_SIZE = 20;
+function paginate(rows, keyOf, options) {
+  let start = 0;
+  if (options.after !== void 0) {
+    const at = rows.findIndex((row) => keyOf(row) === options.after);
+    if (at < 0) throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after }));
+    start = at + 1;
+  }
+  const size = options.all ? rows.length : options.limit ?? PAGE_SIZE;
+  const shown = rows.slice(start, start + size);
+  const more = start + shown.length < rows.length && shown.length > 0;
+  return { rows: shown, total: rows.length, next: more ? keyOf(shown[shown.length - 1]) : null };
+}
+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 listed3 = await project.cache.documents.list();
+  const problems = listed3.problems;
+  const states = await documentStates(project, listed3.documents);
+  const documents = states.documents;
   const byId = new Map(documents.map((d) => [d.id, d]));
   const arranged = arrangeDocuments(documents);
   let features = arranged.features;
@@ -28671,6 +29133,8 @@ var runSpecsList = (options) => runCommand("specs", options.format, async () =>
     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 } : {},
@@ -28678,11 +29142,16 @@ var runSpecsList = (options) => runCommand("specs", options.format, async () =>
   })));
   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 grouped = options.sort === "order";
+  const groups = features.map((f) => ({ id: f.index.id, rows: rows.filter((r) => r.feature === f.index.feature) })).filter((g) => g.rows.length);
+  const page = grouped ? paginate(groups, (g) => g.id, options) : paginate(rows, (r) => r.id, options);
+  const shown = grouped ? page.rows.flatMap((g) => g.rows) : page.rows;
+  const more = pageLine(page, 0, grouped ? t2("list.features") : t2("list.items"));
+  const paging = { total: page.total, next: page.next, unit: grouped ? "feature" : "document" };
   const orphans = options.feature === void 0 ? arranged.orphans : [];
   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 +29160,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());
@@ -28723,16 +29193,19 @@ 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";
+import { lstat as lstat11 } from "node:fs/promises";
+import { join as join16 } from "node:path";
 var instructionSorts = ["name", "updated"];
-var columns2 = ["id", "name", "path", "title", "description", "draft", "files", "updated", "line"];
+var columns2 = ["id", "name", "path", "title", "description", "draft", "state", "previousPath", "files", "updated", "line"];
 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 listed3 = await project.cache.documents.list();
+  const problems = listed3.problems;
+  const states = await documentStates(project, listed3.documents);
+  const documents = states.documents;
+  const agents2 = { path: AGENTS, exists: !!(await lstat11(join16(project.root, AGENTS)).catch(() => void 0))?.isFile() };
   const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!fields2?.includes("updated");
   const latest = /* @__PURE__ */ new Map();
   const newest = /* @__PURE__ */ new Map();
@@ -28753,33 +29226,46 @@ var runInstructionsList = (options) => runCommand("instructions", options.format
   }
   const matched = options.q !== void 0 ? await project.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(project.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 = paginate(rows, (r) => r.id, options);
+  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 +29291,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 lstat12, readdir as readdir6 } from "node:fs/promises";
+import { join as join17 } from "node:path";
+var info2 = async (path3) => lstat12(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -28815,11 +29301,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(join17(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(join17(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 +29314,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(join17(root, ...target.split("/"))))?.isFile()) existing.add(target);
   return documentWarnings(documents, await listAssets(root), existing);
 }
 
@@ -28852,30 +29338,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 join20 } 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 lstat13, 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 join18 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
-var info3 = (path3) => lstat12(path3).catch((e) => {
+var info3 = (path3) => lstat13(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: join18((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join18(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 = join18(directory, ".probe-" + randomBytes2(8).toString("hex"));
     await writeFile3(probe, "", { flag: "wx" });
     await unlink3(probe);
     return true;
@@ -28889,7 +29375,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(join18(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
@@ -28897,10 +29383,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(join18(directory, name2)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join18(directory, name2)).catch(() => void 0);
   }
-  return { commit: join17(directory, "commit.json") };
+  return { commit: join18(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
@@ -28921,18 +29407,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 lstat14, readFile as readFile14 } from "node:fs/promises";
+import { join as join19 } 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) => lstat14(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -28958,11 +29444,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 = join19(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(join19(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 +29515,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 +29567,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 +29598,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 = join20(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 +29637,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 = join20(gitDir, "gitifact-commit-index-" + randomUUID5());
   let owned = false;
   let uncertain = false;
   let commitStarted = false;
@@ -29171,16 +29651,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(join20(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 +29673,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(join20(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(join20(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 +29720,7 @@ async function commitChanges(cwd, input2, dryRun) {
       await unlink4(temporary).catch(() => {
       });
       if (owned) {
-        await unlink4(join19(busy, "recovery.json")).catch(() => {
+        await unlink4(join20(busy, "recovery.json")).catch(() => {
         });
         await rmdir(busy);
       }
@@ -29251,7 +29731,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 join21 } 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 +29767,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(join21(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 +29792,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 +29811,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 +29830,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 +29866,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 join22 } from "node:path";
 
 // src/adapters/github/issue.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -29442,7 +29944,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(join22(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
     if (config2 !== void 0) {
       try {
         const value = JSON.parse(config2).schemaVersion;
@@ -29520,7 +30022,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 +30152,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 +30170,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.1").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.1"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.1"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).action((options) => options.check ? runUpdateCheck(options.format, "0.8.1") : runUpdate(options, "0.8.1"));
 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 +30196,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.1"));
 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));